
Conta Azul для WooCommerce — заказы как продажи Conta Azul, клиенты по CPF/CNPJ (Бразилия)
Conta Azul для WooCommerce (Бразилия): заказы как продажи, клиент по CPF/CNPJ; Pro — отправка по статусу, товары по SKU, отмена, PDF, остатки.
- Совместимость
- WordPress 6.4+ · WooCommerce 8.6+ (HPOS, блочная касса) · PHP 7.4+ · языки: English, Português (Brasil)
- Лицензия
- сайт + тестовая копия, годовая
- Триал
- 7 дней, без карты, один на сайт
- Обновлено
- 16.11.2026
Что есть во Free,
а что даёт Pro
Бесплатная версия работает без ограничения по времени. Pro добавляет остальные функции из таблицы.
Главное о модуле
Настройки
WooCommerce → Conta Azul: создайте приложение в портале разработчиков Conta Azul, впишите в него адрес возврата, который показывает модуль, скопируйте Client ID и Client secret в модуль и нажмите «Connect to Conta Azul».
Что происходит с заказом
В заказе появляется блок «Conta Azul» с CPF или CNPJ покупателя.
Что добавляет Pro
Отправка по статусу. Выберите статус заказа (например, «Processing»): продажа создаётся автоматически, один раз для заказа.

Триал стартует, когда вы попросите
Свежая установка — бесплатная версия, ничего не включается само. Кнопка «Попробовать Pro 7 дней» → e-mail → ключ сразу в окне и письмом.

Один ключ — сайт и тестовая копия
Переносите сайт — отвяжите лицензию на старом домене и активируйте на новом сами. Тестовая копия (staging., dev.) работает с тем же ключом и места сайта не занимает. Для студий — ключи на 5, 25 сайтов или без ограничений.
Технические требования
WordPress 6.4+, WooCommerce 8.6+ (HPOS, блочная касса), PHP 7.4+.
Аккаунт Conta Azul и собственное приложение в портале разработчиков Conta Azul.
Адрес возврата модуля (/wp-json/catcode-conta-azul/v1/oauth) должен быть доступен из интернета по https.
Для CPF/CNPJ на кассе — плагин вроде Brazilian Market on WooCommerce или собственные поля заказа, названия которых указаны в настройках.
Язык интерфейса: English и Português (Brasil).
История версий
Первый выпуск: подключение собственным приложением Conta Azul, отправка заказа кнопкой, клиент по CPF/CNPJ или e-mail, нумерация, доставка, скидка и способ оплаты, защита от второй продажи…
Вместе с Conta Azul покупают


Ploomes для WooCommerce — клиенты и сделки из заказов в вашей CRM

Brazilian Checkout Fields для WooCommerce — CPF, CNPJ, номер дома, район, CEP

Focus NFe для WooCommerce — NF-e из заказов
Полное описание модуля
Conta Azul for WooCommerce передаёт заказы магазина в бразильский облачный ERP Conta Azul как продажи. Кнопка «Send to Conta Azul» в заказе создаёт продажу со следующим номером, строками, доставкой, скидкой и суммой, а покупатель становится клиентом Conta Azul по CPF или CNPJ. Модуль предназначен для бразильских магазинов, которые ведут учёт в Conta Azul; языки модуля: English и Português (Brasil).
Что нужно в Conta Azul. Собственный аккаунт Conta Azul и приложение в портале разработчиков Conta Azul: его Client ID и Client secret вы вставляете в модуль, а адрес возврата из модуля вписываете в приложение. Секрет остаётся на вашем сайте в зашифрованном виде, промежуточного сервера CatCode нет. Модуль не выпускает NF-e: налоговые документы формируются в вашем аккаунте Conta Azul.
Настройки
WooCommerce → Conta Azul: создайте приложение в портале разработчиков Conta Azul, впишите в него адрес возврата, который показывает модуль, скопируйте Client ID и Client secret в модуль и нажмите «Connect to Conta Azul». Секрет хранится зашифрованным и в форме не показывается. Токен обновляется сам; если доступ отозван, админка сообщает об этом и предлагает подключить снова.
Затем выберите статус новой продажи («Approved» или «In progress»), товар или услугу для строк (поиск по названию или коду в вашем каталоге Conta Azul) и поля CPF/CNPJ заказа. Для «Development»-приложения портала, которое всегда возвращается на https://www.contaazul.com, есть режим со вставкой адреса с code= после входа.
Что происходит с заказом
В заказе появляется блок «Conta Azul» с CPF или CNPJ покупателя. Кнопка «Send to Conta Azul» создаёт продажу один раз: для каждого заказа действует блокировка, номер продажи сохраняется, а потерянный ответ Conta Azul проверяется поиском по зарезервированному номеру перед новой попыткой. Двойной клик или вторая вкладка не дают второй продажи.
Клиента в Conta Azul ищут по CPF или CNPJ (контрольные цифры проверяются), а без документа по e-mail; если клиента нет, модуль создаёт его: физическое или юридическое лицо, e-mail, телефоны, адрес с CEP, номером и районом. Поля документа берутся из плагина Brazilian Market on WooCommerce; другие названия полей задаются в настройках. После отправки в заказе остаются номер продажи и статус, а кнопка «Check the sale» читает состояние продажи из Conta Azul.
Строки заказа попадают в продажу под одним выбранным товаром или услугой Conta Azul (API требует товар на каждую строку), а название товара WooCommerce становится описанием строки. Доставка идёт отдельной составляющей, купоны и отрицательные сборы как скидка, а итог совпадает с заказом до копейки. Способ оплаты (Pix, boleto, карта и другие) подбирается по методу оплаты заказа, а заметки заказа и журнал WooCommerce показывают результат и причину отказа.
Что добавляет Pro
Отправка по статусу. Выберите статус заказа (например, «Processing»): продажа создаётся автоматически, один раз для заказа. Если Conta Azul недоступна, попытка повторяется каждый час, до 6 раз.
Товары по SKU. Строка идёт на товар Conta Azul с тем же SKU (вариации тоже); отсутствующий товар можно создавать автоматически (название, SKU до 20 символов, цена). Строки без SKU идут на выбранный товар.
Отмена. Отменённый или полностью возвращённый заказ отменяет продажу в Conta Azul, есть и кнопка «Cancel the sale in Conta Azul». Отменённая продажа не возвращается.
Категория, счёт, способ оплаты. Категория дохода и финансовый счёт по умолчанию и отдельно для каждого метода оплаты магазина, а также вид оплаты для каждого метода.
Массовое действие, PDF, остатки. «Send to Conta Azul» в списке заказов (до 50 заказов за раз), кнопка «Sale PDF» в заказе, ежечасное обновление остатков товаров с тем же SKU из Conta Azul (по умолчанию выключено).
Журнал и обновления. Страница «Conta Azul journal» хранит последние 300 записей с причинами отказов; обновления модуля приходят с catcode.com.ua.
Ограничения
- Каждый магазин подключается собственным приложением из портала разработчиков Conta Azul.
- В бесплатной версии все строки идут под одним выбранным товаром или услугой; остатки в Conta Azul по товарам не двигаются, пока не включено сопоставление по SKU (Pro).
- Проведённая продажа создаёт дебиторку в финансах Conta Azul: состояние новой продажи по умолчанию «Approved»; если вы сверяете вручную, выберите «In progress».
- Синхронизация остатков (Pro) делает Conta Azul главным источником и перезаписывает остатки товаров WooCommerce с тем же SKU; по умолчанию выключена.
- Токен обновления Conta Azul меняется при каждом обновлении: копия сайта (стенд, восстановленная база), использующая те же токены, может разорвать соединение боевого магазина, тогда его подключают снова.
- Лимит Conta Azul — 10 вызовов в секунду на компанию: модуль делает паузы между вызовами, массовое действие обрабатывает до 50 заказов за проход.
- На блочной кассе CPF/CNPJ берутся из полей заказа, которые добавляет ваш плагин; если поля нет, клиента ищут по e-mail, а документ можно вписать в заказе.
- Модуль не выпускает NF-e и не даёт налоговых советов.
Как это работает, шаг за шагом
- Установите плагин и активируйте его (WooCommerce должен быть активен).
- В портале разработчиков Conta Azul создайте приложение и впишите в него адрес возврата со страницы WooCommerce → Conta Azul.
- Скопируйте Client ID и Client secret в модуль, сохраните и нажмите «Connect to Conta Azul»; после входа страница покажет название вашей компании.
- Выберите товар или услугу для строк и статус новой продажи.
- Откройте заказ и нажмите «Send to Conta Azul»: в блоке появится номер продажи.
- В Pro включите отправку по статусу, товары по SKU, отмену и способы оплаты.
Что под капотом
- API Conta Azul v2 (developers.contaazul.com): OAuth 2.0, клиенты, товары и услуги, продажи, следующий номер, PDF. Запросы идут с вашего сервера только после подключения и только для действий, которые вы запускаете или включаете.
- Токен обновляется под блокировкой: refresh token меняется при каждом обновлении, поэтому два параллельных запроса не сжигают пару одновременно.
- В Conta Azul передаются данные, нужные для продажи: имя или компания, CPF или CNPJ, e-mail, телефоны, адрес покупателя, строки с названиями, количеством и ценами, доставка, скидка, номер и дата заказа.
- Client secret и токены хранятся зашифрованными, в форму не возвращаются.
- Автоматическая отправка не блокирует оформление заказа: она идёт после ответа покупателю, а ежечасный проход подхватывает то, что не удалось.
- После окончания пробного периода Pro-задачи в очереди останавливаются с пояснением в заметке заказа, а отправка кнопкой работает.
Как установить
- Плагины → Добавить новый → Загрузить плагин: выберите zip и активируйте.
- WooCommerce → Conta Azul: впишите адрес возврата в приложение Conta Azul, скопируйте Client ID и Client secret, сохраните и нажмите «Connect to Conta Azul».
- Выберите товар или услугу для строк продажи и сохраните настройки.
- Для Pro: вставьте лицензионный ключ или запустите пробный период в разделе «Licence» на той же странице.
Вопросы
о модуле
Не нашли ответ? Напишите в Telegram — ответим в течение рабочего дня.
Это официальный плагин Conta Azul?
Нет, это независимая интеграция от CatCode через публичный API. Conta Azul — торговая марка её владельца; модуль не аффилирован с Conta Azul и не одобрен им.
Зачем собственное приложение в портале разработчиков?
Conta Azul подписывает каждое подключение секретом приложения. Со своим приложением секрет остаётся на вашем сайте, и им пользуется только ваш магазин; промежуточного сервера CatCode нет.
Создаёт ли модуль новые товары в Conta Azul?
В бесплатной версии все строки идут под одним товаром или услугой, которую вы выбираете. В Pro строки сопоставляются по SKU, а отсутствующие товары можно создавать автоматически; эта опция выключена по умолчанию.
Что с покупателями без CPF/CNPJ?
Клиента ищут по e-mail, а если его нет, создают с данными заказа. Невалидный номер не отправляется.
Выпускает ли модуль NF-e?
Нет. Модуль создаёт продажу в Conta Azul; налоговые документы формируются в вашем аккаунте Conta Azul.
Можно ли создать продажу дважды?
Нет. Для заказа действует блокировка и сохранённый номер продажи, а потерянный ответ проверяется поиском по номеру перед новой попыткой.
Можно ли отменить продажу?
Да, в Pro: отменённый или полностью возвращённый заказ отменяет продажу, либо кнопкой «Cancel the sale in Conta Azul».
Что будет после пробного периода?
Pro отключится, бесплатная часть продолжит работать: подключение, отправка кнопкой, клиенты, проверка продажи. Задачи, ожидавшие в очереди, останавливаются с причиной, продажу можно создать вручную кнопкой.
На сколько сайтов ключ?
Один ключ работает на два сайта: магазин и тестовую копию.
Пока нет ни одного отзыва. Будьте первым.
Пока вопросов нет. Спроси — мы ответим в течение 24 часов.
Не тот вариант, что искали?
Делаем кастомные модули под WordPress, WooCommerce, OpenCart и Shopify. Расскажите о задаче — подготовим оценку.
Заказать кастомный модуль
Покупка модуля
—
Оплата списывается в гривне, ваш банк пересчитает её в вашу валюту. Цена в евро ориентировочная.




















