Collmex для WooCommerce — заказы, счета и остатки

Collmex for WooCommerce кладёт заказ магазина в Collmex одним нажатием: как Kundenauftrag (заказ покупателя) или как Rechnung (счёт), вместе с клиентом. Никто не вводит заказ второй раз, а склад, счета и бухгалтерия в Collmex работают с теми же данными, что и магазин. Модуль обращается к Collmex напрямую, через ваш отдельный API-доступ.

Что делает бесплатная версия

В карточке заказа появляется блок Collmex: кнопка «Send to Collmex» создаёт Kundenauftrag или Rechnung. Для Kundenauftrag Collmex сам находит или создаёт клиента по адресу, для Rechnung модуль ищет клиента по e-mail или номеру клиента. Цены идут нетто или брутто в зависимости от ценовой группы клиента в Collmex; позиции передаются текстом или по артикулу (Produktnummer = SKU). Номер документа можно брать из нумерации Collmex или из номера заказа WooCommerce со сдвигом. После создания Kundenauftrag модуль сверяет сумму документа с суммой заказа. Второго документа не будет: повторное нажатие меняет тот же документ, а после попытки без ответа модуль сначала ищет документ по номеру заказа. Проверка соединения, пароль хранится зашифрованным. Витрина магазина не меняется.

Что добавляет Pro

Заказы уходят в Collmex сами, когда достигают выбранного статуса: в фоне, с пятью повторами (через 5, 15, 60, 180 и 720 минут) и паузой на время обслуживания Collmex (3:30–5:00 по Берлину). Налоговые классы WooCommerce сопоставляются с Steuerklassifikation, способы оплаты с Zahlungsbedingung, способы доставки с Versandart. Остатки (STOCK_AVAILABLE_GET) и цены (PRODUCT_GET) подтягиваются по артикулу: только изменённые, а раз в сутки всё; Collmex может сам сообщать магазину об изменениях через адрес с ключом. Подтверждение оплаты (PAYMENT_CONFIRMATION) для выбранных способов оплаты. Трек-номер из поставки Collmex попадает в заказ, по желанию с письмом покупателю и завершением заказа. Массовая отправка из списка заказов, журнал с кнопкой повторной отправки неудавшихся.

Что стоит знать заранее

• Счета выручки (Erlöskonten) модуль не сопоставляет: в записях Kundenauftrag и Rechnung такого поля нет, счёт определяет Collmex по Steuerklassifikation и клиенту.
• Возвраты и кредит-ноты (Gutschrift) не передаются.
• Суммы считает Collmex. Если нетто/брутто или налоговая классификация не совпадают с магазином, сумма документа будет отличаться; для Kundenauftrag модуль покажет предупреждение о расхождении. В режиме Rechnung документ сразу проводится в бухгалтерии, и сверки суммы для него нет.
• В режиме «артикул = SKU» неизвестный в Collmex артикул останавливает весь заказ: Collmex отклоняет весь запрос.
• Подтверждение оплаты проводится как Anzahlung. Если тот же платёж затем проводят ещё и из банковской выписки, получается двойной учёт, поэтому способы оплаты выбираются вручную, по умолчанию ни один.
• Синхронизация цен записывает цену Collmex как есть: если «цены с налогом» в WooCommerce настроены иначе, цены на витрине будут неверными. По умолчанию выключена.
• Collmex ограничивает API: 10 000 вызовов в сутки и до 5 одновременных. Массовая отправка идёт по одному заказу каждые 10 секунд.
• Подтверждение оплаты, трек-номера и уведомления Collmex доступны не во всех редакциях Collmex: уточните в Collmex для вашего тарифа.

Как это работает, шаг за шагом

1. В Collmex создайте пользователя «Nur für API» и запишите номер клиента, имя и пароль.
2. В WooCommerce → Collmex введите эти данные и нажмите «Save and test the connection».
3. На вкладке Documents выберите Kundenauftrag или Rechnung, цены и позиции.
4. Откройте заказ, нажмите «Send to Collmex» и посмотрите документ в Collmex.

Под капотом

• Пароль хранится зашифрованным ключами вашего сайта и не выводится обратно на страницу.
• Номер документа записывается в заказ: повторная отправка меняет тот же документ.
• Автопередача, повторы и синхронизация работают в очереди Action Scheduler.
• Совместимо с HPOS и блочным чекаутом; языки: English, Deutsch (de_DE, de_DE_formal, de_AT, de_CH).

Как установить

1. Плагины → Добавить новый → Загрузить плагин: выберите zip и активируйте.
2. WooCommerce → Collmex: введите данные API-пользователя и нажмите «Save and test the connection».
3. На вкладке Documents выберите тип документа.
4. Попробуйте на одном заказе.

Модуля пока нет на wordpress.org: бесплатная версия и Pro — один архив с этой страницы. Без ключа он работает как бесплатная версия.