
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. Розкажіть про задачу — підготуємо оцінку.
Замовити кастомний модуль
Купівля модуля
—




















