Black November: −35% on all modules until 30 November Black November: −35% until 30 November Choose a module

Get in touch
WooCommerce

Conta Azul for WooCommerce — orders as Conta Azul sales, customers by CPF/CNPJ (Brazil)

Conta Azul for WooCommerce (Brazil): orders as sales, customer by CPF/CNPJ; Pro adds sending at a status, products by SKU, cancelling, PDF, stock.

Download Free
Pro · one-year licence Staging copies are included. The more sites, the cheaper each one
Compatibility
WordPress 6.4+ · WooCommerce 8.6+ (HPOS, block checkout) · PHP 7.4+ · languages: English, Português (Brasil)
Licence
a site + a staging copy, annual
Trial
7 days, no card, one per site
Updated
16.11.2026
Or all 509 Pro modules with All Access — 3 244 UAH / year ≈ €66

What Free has,
and what Pro adds

The free version works with no time limit. Pro adds the rest of the features in the table.

Feature Free Pro
Connection with your own Conta Azul app (OAuth 2.0), disconnect with the access revoked ✔ ✔
"Send to Conta Azul" button in the order: a sale with the next number, the lines, shipping, discount and total ✔ ✔
Customer by CPF/CNPJ (check digits) or e-mail, a customer created with address, CEP and phones ✔ ✔
Lines under one chosen Conta Azul product or service, the WooCommerce product name as the description ✔ ✔
Payment kind from the payment method of the shop (Pix, boleto, card and others) ✔ ✔
One sale per order: a lock, a stored number, a lookup by number after a lost answer ✔ ✔
"Check the sale" button and the sale state "Approved" or "In progress" ✔ ✔
CPF/CNPJ fields from Brazilian Market on WooCommerce or your own; order notes and the WooCommerce log ✔ ✔
Sending at an order status with hourly retries — ✔
Products by SKU, variations included, and creating missing ones — ✔
Cancelling a sale for a cancelled or refunded order and with a button — ✔
Revenue category and financial account by default and for every payment method — ✔
Payment kind for every payment method — ✔
Bulk action "Send to Conta Azul" in the orders list — ✔
Sale PDF from Conta Azul — ✔
Hourly stock update from Conta Azul — ✔
"Conta Azul journal" page with the reasons of refusals — ✔
Updates from catcode.com.ua — ✔

What it looks like

Connection and sale settings
WooCommerce → Conta Azul: Client ID and Client secret of your own app, the Redirect URL, the state of the new sale, the product or service for the lines, the CPF/CNPJ fields.
The Conta Azul box in a WooCommerce order
The order screen: the buyer’s CPF and the “Send to Conta Azul” button in the Conta Azul box.
The order after sending
The box keeps the sale number and state; in Pro the “Sale PDF” and “Cancel the sale in Conta Azul” buttons sit next to them.

Key points

Settings

WooCommerce → Conta Azul: create an app in the Conta Azul developer portal, enter in it the Redirect URL the module shows, copy the Client ID and Client secret into the module and press “Connect to Conta Azul”.

What happens to an order

The order gets a “Conta Azul” box with the CPF or CNPJ of the buyer.

What Pro adds

Sending at a status. Choose an order status (for example “Processing”): the sale is created automatically, once per order.

The trial starts when you ask

A fresh install is the free version, nothing switches on by itself. The “Try Pro for 7 days” button → e-mail → the key right in the window and by e-mail.

One key — a site and a staging copy

Moving the site? Unlink the licence on the old domain and activate it on the new one yourself. A staging copy (staging., dev.) works with the same key and does not take a site slot. For studios — keys for 5 or 25 sites, or unlimited.

Technical requirements

  • WordPress 6.4+, WooCommerce 8.6+ (HPOS, block checkout), PHP 7.4+.
  • A Conta Azul account and your own app in the Conta Azul developer portal.
  • The Redirect URL of the module (/wp-json/catcode-conta-azul/v1/oauth) must be reachable from the internet over https.
  • For the CPF/CNPJ at the checkout: a plugin such as Brazilian Market on WooCommerce, or your own order fields whose names are set in the settings.
  • Interface languages: English and Português (Brasil).

Version history

v1.0.0 Current 16.11.2026

Connection with your own Conta Azul app, sending an order with a button, customer by CPF/CNPJ or e-mail, numbering, shipping, discount and payment kind, protection against a second sale…

Frequently bought with Conta Azul

All Access Need more? All modules (509) under one licence, new ones are added automatically. 3 244 UAH≈ €66 Learn more →

Full module description

Conta Azul for WooCommerce sends the orders of your shop to the Brazilian cloud ERP Conta Azul as sales. The “Send to Conta Azul” button in the order creates a sale with the next number, the lines, shipping, discount and total, and the buyer becomes a Conta Azul customer by CPF or CNPJ. The module is for Brazilian shops that keep their books in Conta Azul; module languages: English and Português (Brasil).

What you need in Conta Azul. Your own Conta Azul account and an app in the Conta Azul developer portal: you paste its Client ID and Client secret into the module and enter the Redirect URL of the module in the app. The secret stays on your site in encrypted form; there is no CatCode server in between. The module does not issue NF-e: tax documents are made in your Conta Azul account.

Settings

WooCommerce → Conta Azul: create an app in the Conta Azul developer portal, enter in it the Redirect URL the module shows, copy the Client ID and Client secret into the module and press “Connect to Conta Azul”. The secret is stored encrypted and never shown in the form. The token is renewed by itself; if the access is revoked, the admin says so and offers to connect again.

Then choose the state of a new sale (“Approved” or “In progress”), the product or service for the lines (search by name or code in your Conta Azul catalogue) and the CPF/CNPJ fields of the order. For a “Development” app of the portal, which always returns to https://www.contaazul.com, there is a mode where you paste the address with code= after the login.

What happens to an order

The order gets a “Conta Azul” box with the CPF or CNPJ of the buyer. The “Send to Conta Azul” button creates the sale once: every order is locked while it is sent, the sale number is stored, and a lost answer from Conta Azul is checked by looking up the reserved number before any new try. A double click or a second tab never makes a second sale.

The customer in Conta Azul is looked up by CPF or CNPJ (the check digits are verified), and without a document by e-mail; when there is no such customer the module creates one: a person or a company, e-mail, phones, an address with CEP, number and neighbourhood. The document fields come from the Brazilian Market on WooCommerce plugin; other field names are set in the settings. After sending, the order keeps the sale number and state, and the “Check the sale” button reads the state of the sale back from Conta Azul.

The order lines go into the sale under one chosen Conta Azul product or service (the API needs an item for every line), and the WooCommerce product name becomes the description of the line. Shipping is a separate part, coupons and negative fees go in as a discount, and the total matches the order to the cent. The payment kind (Pix, boleto, card and others) is chosen from the payment method of the order, and the order notes and the WooCommerce log show the result and the reason of a refusal.

What Pro adds

Sending at a status. Choose an order status (for example “Processing”): the sale is created automatically, once per order. If Conta Azul cannot be reached, the try is repeated every hour, up to 6 times.

Products by SKU. A line goes to the Conta Azul product with the same SKU (variations too); a missing product can be created automatically (name, SKU up to 20 characters, price). Lines without a SKU go to the chosen item.

Cancelling. A cancelled or fully refunded order cancels its sale in Conta Azul, and there is a “Cancel the sale in Conta Azul” button. A cancelled sale is never brought back.

Category, account, payment kind. The revenue category and the financial account by default and separately for every payment method of the shop, and the payment kind for every method.

Bulk action, PDF, stock. “Send to Conta Azul” in the orders list (up to 50 orders at a time), the “Sale PDF” button in the order, and an hourly update of the stock of products with the same SKU from Conta Azul (off by default).

Journal and updates. The “Conta Azul journal” page keeps the last 300 entries with the reasons of refusals; updates of the module come from catcode.com.ua.

Limits

  • Every shop connects with its own app from the Conta Azul developer portal.
  • In the free version all lines go under one chosen product or service; the stock in Conta Azul is not moved per product until matching by SKU (Pro) is on.
  • An approved sale creates a receivable in the Conta Azul finance: the default state of a new sale is “Approved”; if you reconcile by hand, choose “In progress”.
  • The stock sync (Pro) makes Conta Azul the master and overwrites the stock of WooCommerce products with the same SKU; it is off by default.
  • The Conta Azul refresh token changes on every renewal: a copy of the site (a staging site, a restored database) that uses the same tokens can break the connection of the live shop, which then has to be connected again.
  • The Conta Azul limit is 10 calls per second per company: the module spaces its calls, and the bulk action handles up to 50 orders per pass.
  • On the block checkout the CPF/CNPJ comes from the order fields your plugin adds; with no such field the customer is looked up by e-mail, and the document can be typed into the order.
  • The module does not issue NF-e and gives no tax advice.

How it works, step by step

  1. Install the plugin and activate it (WooCommerce must be active).
  2. In the Conta Azul developer portal create an app and enter in it the Redirect URL from the WooCommerce → Conta Azul page.
  3. Copy the Client ID and Client secret into the module, save and press “Connect to Conta Azul”; after the login the page shows the name of your company.
  4. Choose the product or service for the lines and the state of a new sale.
  5. Open an order and press “Send to Conta Azul”: the sale number appears in the box.
  6. In Pro turn on sending at a status, products by SKU, cancelling and the payment methods.

Under the hood

  • Conta Azul API v2 (developers.contaazul.com): OAuth 2.0, customers, products and services, sales, the next number, PDF. Requests go from your server only after the connection and only for actions you run or turn on.
  • The token is renewed under a lock: the refresh token changes on every renewal, so two parallel requests cannot burn the pair at once.
  • The data sent to Conta Azul is what a sale needs: the name or company, CPF or CNPJ, e-mail, phones and address of the buyer, the lines with names, quantities and prices, shipping, discount, the order number and date.
  • The Client secret and the tokens are stored encrypted and never returned to the form.
  • Automatic sending does not hold the checkout: it runs after the buyer has the answer, and an hourly pass picks up what did not work.
  • When the trial ends, Pro jobs in the queue stop with an explanation in the order note, and sending with the button keeps working.

Installation

  1. Plugins → Add New → Upload Plugin: choose the zip and activate it.
  2. WooCommerce → Conta Azul: enter the Redirect URL in your Conta Azul app, copy the Client ID and Client secret, save and press “Connect to Conta Azul”.
  3. Choose the product or service for the sale lines and save the settings.
  4. For Pro: paste the licence key or start the trial in the “Licence” section on the same page.

Questions
about the module

Didn't find the answer? Message us on Telegram and we'll reply within a business day.

@catcode_support Setup, compatibility, activation
Is this the official Conta Azul plugin?

No, it is an independent integration made by CatCode through the public API. Conta Azul is a trademark of its owner; the module is not affiliated with Conta Azul and not endorsed by it.

Why do I need my own app in the developer portal?

Conta Azul signs every connection with the secret of an app. With your own app the secret stays on your site and only your shop uses it; there is no CatCode server in between.

Does the module create new products in Conta Azul?

In the free version all lines go under one product or service that you choose. In Pro the lines are matched by SKU, and missing products can be created automatically; that option is off by default.

What about buyers without a CPF/CNPJ?

The customer is looked up by e-mail, and if there is none, created from the order data. An invalid number is not sent.

Does the module issue NF-e?

No. The module creates the sale in Conta Azul; tax documents are made in your Conta Azul account.

Can a sale be made twice?

No. An order is locked while it is sent and keeps its sale number, and a lost answer is checked by looking up the number before any new try.

Can a sale be cancelled?

Yes, in Pro: a cancelled or fully refunded order cancels its sale, or use the "Cancel the sale in Conta Azul" button.

What happens after the trial?

Pro switches off, the free part keeps working: the connection, sending with the button, customers, the check of the sale. Jobs that waited in the queue stop with the reason, and a sale can be made by hand with the button.

How many sites does a key cover?

One key covers two sites: the shop and its test copy.

Not quite what you are looking for?

We build custom modules for WordPress, WooCommerce, OpenCart and Shopify. Tell us about the task and we'll prepare an estimate.

Order a custom module