Модуль управления бухгалтерским учетом MP Smart
MP Accounting Manager — это независимый модуль учета, работающий внутри админ-панели WordPress; он управляет заказами WooCommerce, ручными записями счетов GİB/e-Arşiv, экспортными пакетами для бухгалтера и историей операций через архитектуру custom table.
1. Общая цель
MP Accounting Manager — это модуль предварительного учета и отслеживания счетов, ориентированный на админ-панель и разработанный для компаний, работающих на инфраструктуре WordPress и WooCommerce. Цель модуля — не выставлять счета, а упорядочить процесс отслеживания, записи, контроля, экспорта и передачи бухгалтеру данных между заказами WooCommerce и счетами, созданными через GİB/e-Arşiv.
Особенно для компаний, которые вручную создают счета через портал GİB/e-Arşiv, со временем становится трудно отслеживать связь заказ-счет. Вопросы вроде «какой заказ был выставлен в счет», «какой счет отправлен бухгалтеру», «какая запись ожидает проверки», «какой счет уже был экспортирован» обычно отслеживаются через Excel, заметки в папках или ручные архивы. MP Accounting Manager переносит этот процесс в централизованную и отслеживаемую структуру внутри WordPress admin.
Краткое ценностное предложение
Управляемый модуль, который отслеживает заказы WooCommerce и процессы счетов GİB/e-Arşiv в одной панели, быстро работает благодаря custom table архитектуре, снижает риск duplicate номера счета и создает единый export-пакет для бухгалтера.
2. Проблема и потребность
В магазинах WooCommerce процесс заказа цифровой; однако во многих компаниях выставление счетов все еще ведется вручную через портал GİB/e-Arşiv. Это приводит к тому, что данные заказа и счета возникают в двух разных местах. Заказ находится в WooCommerce, счет — на стороне GİB, а PDF-архив может храниться на компьютере, в облаке или на внешнем хранилище.
С операционной точки зрения это создает следующие проблемы:
- Один и тот же заказ может быть ошибочно выставлен повторно или принят за невыставленный.
- Номер счета GİB невозможно связать с заказами WooCommerce.
- Ежемесячные данные для бухгалтера собираются из разрозненных файлов.
- Невозможно отследить, где хранятся PDF-файлы счетов.
- Номер счета, клиент, НДС и итоговая сумма вручную отслеживаются в Excel-файлах.
- Ранее экспортированные счета могут снова попасть в бухгалтерский пакет.
- Ошибки, duplicate-записи или записи, требующие проверки, не отслеживаются централизованно.
MP Accounting Manager объединяет эти потребности под одним admin-only модулем и систематизирует ежедневную операцию по счетам для администратора сайта.
3. Видение продукта и позиционирование
Модуль не является классическим e-invoice интегратором. Его цель на первом этапе — не выставлять счета, а сделать операцию отслеживания счетов надежной. Это позиционирование выбрано сознательно, потому что процессы выставления счетов могут различаться в зависимости от страны, законодательства, специального интегратора, портала GİB и сценария компании. Однако сопоставление заказ-счет, duplicate-контроль, архив записей, export-пакет и логирование являются общими потребностями для всех компаний.
4. Основной архитектурный подход модуля
MP Accounting Manager задуман не как plugin, а как активируемый/деактивируемый модуль, подключаемый к существующей системе MP module loader. Поэтому при активации он загружает собственные admin-меню, таблицы, export и log-систему; а в пассивном состоянии не создает лишней нагрузки на WooCommerce, frontend или ядро WordPress.
Основные принципы архитектуры:
- Не раздувать core-таблицы WordPress лишними post/meta данными.
- Хранить счета и бухгалтерские записи нормализованно в custom table.
- Читать заказы WooCommerce не напрямую через SQL, а по логике WooCommerce API.
- Предлагать в админ-панели понятные, простые и операционно ориентированные экраны.
- Хранить историю export и сведения о том, какие счета вошли в какой пакет.
- Предотвращать риск duplicate номера счета особенно для активных/утвержденных записей.
- Создавать log-запись для каждой критической операции.
5. Основные функции
| Функция | Описание |
| Ручная запись счета | Данные счета, выставленного через GİB/e-Arşiv, можно сохранить через admin-форму. |
| Создание счета из Woo-заказа | Клиент, товар, НДС и итоговые данные из заказа WooCommerce автоматически переносятся в форму «Новый счет». |
| Список и детали счетов | Счета можно фильтровать, просматривать их детали и позиции. |
| Редактирование счета | Ошибочно введенные ручные данные можно безопасно обновлять; если редактируется экспортированная запись, в log добавляется предупреждение. |
| Duplicate-защита | Для утвержденных активных счетов и счетов, требующих проверки, один и тот же номер счета нельзя сохранить повторно. |
| CSV Export | Счета, которые будут отправлены бухгалтеру, можно экспортировать в формате CSV. |
| ZIP Export-пакет | invoices.csv, invoice_items.csv, customers.csv и manifest.json можно скачать одним ZIP-файлом. |
| История export | При каждой операции export сохраняется, какие счета были включены в пакет. |
| Dashboard | Ежемесячные итоги, НДС, ожидающие export, отсутствующие Woo-заказы и последние logs отслеживаются в одной панели. |
| Logs | Отслеживаются история операций, duplicate-блокировки, ошибки, warnings и export-записи. |
| Настройки | Управляются данные продавца, НДС по умолчанию, валюта, статус счета и export-настройки. |
6. Интеграция WooCommerce
Интеграция WooCommerce — одна из самых критичных частей модуля. Заказы отображаются внутри MP Accounting Manager; однако источником заказа остается WooCommerce. Преобразуя заказ WooCommerce в бухгалтерскую запись, модуль берет данные клиента, товара, НДС, оплаты и итогов по snapshot-логике.
- Заказ WooCommerce создается, а статус оплаты/заказа становится подходящим.
- Заказ отображается на экране MP Accounting > Woo Заказы.
- Для заказов без счета отображается кнопка «Создать счет».
- При нажатии кнопки форма «Новый счет» заполняется данными заказа.
- Администратор вводит номер счета GİB/e-Arşiv и недостающие налоговые данные.
- Счет сохраняется и сопоставляется с Woo order ID.
Благодаря этой интеграции связь заказа и счета отслеживается в отдельной mapping-таблице. Если для того же заказа уже есть активный счет, на экране Woo Заказы вместо кнопки создания нового счета отображается существующий счет.
7. Управление счетами и Duplicate-защита
Управление счетами — центр модуля. Счета не просто сохраняются; они отслеживаются вместе со статусами, данными клиента, Woo-сопоставлениями, позициями, export-статусом и log-историей. В системе вместо физического удаления используется управление статусами.
| Статус | Значение | Роль в Duplicate-контроле |
| approved | Утвержденный, активный счет | Один и тот же номер счета нельзя сохранить повторно |
| needs_review | Запись, требующая проверки, но считающаяся активной | Один и тот же номер счета нельзя сохранить повторно |
| imported | Импортированная запись | Может быть утверждена или отправлена на проверку по рабочему процессу |
| draft | Черновик или незавершенная запись | Тот же номер счета можно ввести повторно |
| archived | Архивированная/пассивная запись | Исключена из export и duplicate |
| cancelled | Отмененная запись | Исключена из export и duplicate |
Duplicate-система особенно проверяет следующие поля: номер счета, ETTN/UUID, PDF hash, order ID, налоговый номер клиента, дата счета и итоговая сумма. На экране обновления текущий invoice ID исключается из duplicate-контроля; так счет не конфликтует сам с собой, но если он конфликтует с другим активным счетом, обновление блокируется.
8. Export и пакет для бухгалтера
Самая важная потребность для бухгалтера — получить данные за период регулярно и в одном пакете. MP Accounting Manager закрывает эту потребность как через отдельный CSV, так и через ZIP export-пакет. ZIP-пакет делает бухгалтерскую операцию намного более организованной.
| Файл | Содержимое |
| invoices.csv | Заголовочные данные счета, клиент, налоговый номер, дата, итоги, связь с Woo-заказом |
| invoice_items.csv | Позиции счета, название товара/услуги, SKU, количество, цена за единицу, НДС, сумма строки |
| customers.csv | Клиенты в рамках export, налоговые данные, контактная информация и итоги по счетам |
| manifest.json | Машиночитаемая сводка о дате export, фильтрах, количестве записей и содержимом пакета |
Каждая операция export сохраняется в таблице истории. Кроме того, благодаря таблице export_items фиксированно отслеживается, какие счета вошли в какой export-пакет. Так на вопрос «отправлялся ли этот счет бухгалтеру раньше?» можно ответить прямо из системы.
9. Dashboard, Logs и отслеживаемость
Dashboard — ежедневная контрольная панель модуля. Цель — не просто показать статистику, а помочь администратору сайта быстро увидеть задачи. На dashboard отображаются активные счета за текущий месяц, сумма НДС, счета, ожидающие export, записи, требующие проверки, и Woo-заказы без счета.
- Ежемесячное количество активных счетов и итоговая сумма
- Ежемесячная сумма НДС
- Счета, ожидающие export
- Счета, требующие проверки
- WooCommerce-заказы без счета
- Последние export-записи
- Последние warning/error logs
Экран Logs является контрольным слоем модуля. Здесь можно отслеживать установку, создание счета, обновление счета, duplicate-блокировку, скачивание export, создание записи истории export и ошибки.
10. Настройки и управляемость
Экран настроек позволяет конфигурировать модуль под компанию. Здесь управляются данные компании, валюта по умолчанию, ставка НДС, статус нового счета, статус export, активность ZIP export и лимиты export. Настройки хранятся в структуре WordPress options.
| Группа настроек | Примеры настроек |
| Компания-продавец | Название компании, налоговый номер, налоговая инспекция, e-mail, телефон, адрес |
| Счет | Валюта по умолчанию, ставка НДС по умолчанию, статус нового счета по умолчанию |
| Export | Статус export по умолчанию, максимальный лимит счетов/позиций/клиентов, ZIP активно/пассивно |
| Безопасность/мониторинг | Отметка exported_at после export, log-записи, контроль прав |
11. Подход к безопасности
MP Accounting Manager проектируется как admin-only модуль. Тем не менее данные счетов и клиентов считаются чувствительными. Поэтому базовый подход к безопасности строится на контроле прав, nonce-проверке, контроле доступа к файлам/export, отказе от публичного обмена файлами и логировании.
- Контроль прав на основе current_user_can
- Nonce-проверка в формах и export-операциях
- Экраны, доступные только admin/разрешенным пользователям
- История export и логи операций
- Управление статусами вместо физического удаления
- Принцип не передавать чувствительные файлы через Public URL
- Архитектура, подходящая для будущего доступа бухгалтера через ограниченный по времени token и download logging
12. Пользовательские сценарии
Сценарий 1: Запись счета из Woo-заказа
Заказ поступает в WooCommerce. Администратор нажимает «Создать счет» на экране Woo Заказы. Форма заполняется данными заказа. Вводится номер счета GİB, и счет сохраняется.
Сценарий 2: Ручной ввод счета
Счет без Woo-связи или счет, отслеживаемый вручную, сохраняется напрямую с экрана «Новый счет».
Сценарий 3: Duplicate-блокировка
Если тот же номер счета уже есть в другой записи со статусом approved или needs_review, система не разрешает создание новой записи или обновление.
Сценарий 4: Экспорт периода для бухгалтера
В конце месяца применяется фильтр, выбирается «Скачать ZIP пакет». Счета, позиции и клиенты экспортируются одним пакетом.
Сценарий 5: Просмотр истории export
Открывается ранее скачанная запись export, и отображаются счета, вошедшие в этот пакет.
Сценарий 6: Исправление ошибочно введенного счета
На экране редактирования счета обновляются данные клиента, сумма, номер счета или позиции; операция логируется.
13. Маркетинговая ценность и выгоды
MP Accounting Manager упрощает процесс подготовки бухгалтерии для малых и средних WooCommerce-компаний. Модуль усиливает слой отслеживания заказ-счет, не меняя операцию выставления счета. Поэтому он легко адаптируется к текущему рабочему процессу.
| Выгода | Описание |
| Экономия времени | При ежемесячной подготовке бухгалтерии данные счетов, клиентов и позиций берутся из одного пакета. |
| Снижение ошибок | Снижает риск duplicate номера счета, отсутствующих счетов и повторного попадания экспортированных записей в пакет. |
| Операционная прозрачность | Благодаря dashboard, logs и истории export процесс становится отслеживаемым. |
| Производительность | Custom table архитектура не нагружает структуру WordPress post/meta при больших наборах данных. |
| Адаптируемость | Это не plugin, а module loader архитектура, поэтому его можно активировать/деактивировать при необходимости. |
| Потенциал роста | Предлагает ядро, готовое к фазам текущих счетов, расходов, поступлений, PDF import и интеграций. |
14. Конкурентные преимущества
Многие решения на рынке либо пытаются стать полноценным e-invoice интегратором, либо хранят ограниченные meta-записи внутри WooCommerce. Отличие MP Accounting Manager — он рассматривает бухгалтерскую операцию как независимый и модульный tracking engine внутри WordPress admin.
- Архитектура, зависимая от WooCommerce, но не встроенная в таблицы WooCommerce
- Более контролируемая структура данных для отчетности и export через custom table
- Сильная отслеживаемость через историю export и связь export_items
- Duplicate-контроль различает активные/пассивные счета по бухгалтерской логике
- Подход с заметкой/архивом расположения PDF без обязательного постоянного хранения GİB PDF-файла
- Простая структура на первом этапе, способная вырасти в мини-систему предварительного учета на следующих этапах
15. План фаз и дорожная карта развития
| Фаза | Объем | Цель |
| Фаза 1 | Custom table, ручной счет, Woo-сопоставление, duplicate, список/деталь/редактирование, CSV/ZIP export, история export, dashboard, logs, настройки | Надежное ядро и инфраструктура ежедневной операции |
| Фаза 2 | PDF import, PDF parse, массовый import, PDF-отчет export, безопасная ссылка скачивания | Автоматизация GİB PDF-процессов |
| Фаза 3 | Текущий счет, отслеживание поступлений, учет расходов, отчеты НДС, анализ способов оплаты | Расширение функций предварительного учета |
| Фаза 4 | Сервисы e-fatura/e-arşiv, export, совместимый с Logo/Mikro/Paraşüt, API, портал бухгалтера | Интеграция и продвинутая продуктовая зрелость |
16. Краткая техническая сводка таблиц
| Таблица | Назначение |
| wp_mpam_invoices | Заголовочные записи счетов, статус, клиент, итоги, связь с Woo-заказом, exported_at |
| wp_mpam_invoice_items | Позиции счета, товар/услуга, количество, цена за единицу, НДС и итоги строк |
| wp_mpam_customers | Данные клиентов, налоговый номер, адрес и контактные поля |
| wp_mpam_woo_map | Сопоставление счета с заказом WooCommerce и snapshot-данные заказа |
| wp_mpam_exports | Записи истории export, фильтры, имя файла, hash, итоги и количества |
| wp_mpam_export_items | ID счетов и сводные сведения, включенные в каждый export-пакет |
| wp_mpam_logs | Операции внутри модуля, предупреждения и ошибки |
| wp_options / mpam_settings | Настройки модуля: компания, НДС, export, лимиты и настройки безопасности |
17. Подход к тестированию и контролю качества
Для надежности модуля тесты должны выполняться не только по принципу «открывается ли экран», а по тому, правильно ли ведут себя рабочие процессы. Особенно duplicate, история export и сценарии редактирования должны считаться критическими.
- Открывается ли список Woo-заказов и заполняется ли форма счета из заказа?
- Блокируется ли повторный ввод того же номера счета в статусе approved/needs_review?
- Остаются ли отмененные или архивированные записи вне duplicate?
- Можно ли сохранить существующую запись на экране редактирования без конфликта с самой собой?
- Создают ли CSV и ZIP export правильные файлы?
- Формируются ли записи истории export и export_items?
- Правильно ли dashboard показывает ожидающие export и требующие проверки записи?
- Показывает ли экран Log warning/error записи и context-данные?
- Сохраняются ли настройки и отражаются ли они на экранах «Новый счет» и Export?
MP Accounting Manager — сильный операционный модуль для компаний на базе WordPress + WooCommerce, который упорядочивает ручные процессы счетов GİB/e-Arşiv. Его главная ценность — собрать отслеживание заказ-счет, duplicate-контроль, export-пакеты и подготовку бухгалтерии в одной панели без изменения процесса выставления счетов.
Благодаря custom table архитектуре он масштабируем, благодаря module loader совместимости — контролируем, благодаря dashboard и log структуре — отслеживаем, а благодаря истории export — проверяем. Когда ядро Фазы 1 завершено, система достигает уровня, пригодного для ежедневной операции; во Фазе 2 и далее она может превратиться в более комплексную систему предварительного учета с PDF import, безопасным доступом бухгалтера, текущими счетами, управлением расходами и подключениями специальных интеграторов.
Финальное сообщение
MP Accounting Manager объединяет заказы WooCommerce, записи счетов GİB/e-Arşiv и бухгалтерские export-процессы в одном центре, предлагая компаниям более безопасный, быстрый и отслеживаемый опыт подготовки бухгалтерии.
