
Conta Azul ERP for OpenCart — orders as sales, customers by CPF/CNPJ (Brazil)
Conta Azul ERP for OpenCart 4.x, 3.x, 2.3 (Brazil): orders as sales, customer by CPF/CNPJ; Pro adds sending by status, cancelling, products by SKU, PDF, stock. Licence for life.
- Compatibility
- OpenCart 4.0.2.0–4.1.x, 3.0.x, 2.3.0.2 · module languages: English, Português (Brasil)
- PHP
- 7.0 or newer
- Version
-
v1.0.0 (OpenCart 4)
v1.0.0 (OpenCart 3.x)
v1.0.0 (OpenCart 2.3) - Licence
- a site + a staging copy, lifetime
- Trial
- 7 days, no card, one per site
- Updated
- 15.11.2026
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.
Key points
What the seller gets
The manager opens an order and sees the “Conta Azul” block: the buyer’s CPF/CNPJ, the customer name and address, a table of lines with the Conta Azul item they go as, freight, discount and “Sale total”.
What is in the admin
Extensions → Extensions → Modules → Conta Azul ERP: the tabs “Connection”, “Customer”, “Sale”, “Automation”, “Products and stock”, “Payment methods” and “Licence”.

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
OpenCart 4.0.2.0–4.1.x, 3.0.x or 2.3.0.2; PHP 7.0+ for 2.3, the cURL extension.
A Conta Azul account and your own app at developers-portal.contaazul.com (Production) with the return address the module shows.
The return address of the module must be reachable from the internet over https: if the hosting blocks direct access to that file, the returned address is pasted by hand into the “The browser did not come back to the shop?” box.
Every sale line in Conta Azul must point to a product or service: in the free version it is one chosen item, in Pro the product by SKU.
Freight in the sale = order total − (products − discount): delivery taxes and OpenCart fees go into freight, product taxes into the line price. The module does not issue NF-e.
Cancelling a sale (Pro) rewrites the sale in Conta Azul: the items are taken from the sale itself and the payment terms from the data sent. The stock sync (Pro) changes the quantity of OpenCart products by matching SKU or model, so check that the codes match before turning it on.
On OpenCart 3.x and 2.3 the regular tasks run when pages are opened; a server cron on the address from the “Automation” tab every 10–15 minutes does it more reliably. OpenCart 4 uses its built-in scheduler.
Version history
For OpenCart 4.x, 3.x and 2.3: orders as Conta Azul sales, preview, customer by CPF/CNPJ or e-mail, numbering, payment term, lookup of a sale by its number without duplicates, journal with…
Frequently bought with Conta Azul ERP


Cart Discounts (Amount-Based and N+1) for OpenCart

Brazilian Checkout Fields for OpenCart 2.3, 3.x and 4.x — CPF, CNPJ, address from the CEP

Zenvia SMS & WhatsApp Notifications for OpenCart
Full module description
Conta Azul ERP for OpenCart 4.x, 3.x and 2.3 sends store orders to the Conta Azul cloud ERP as sales: the “Send to Conta Azul” button on the order page shows the customer, the lines, freight, discount and total, and one click creates a sale in Conta Azul with the customer found or created by CPF/CNPJ.
What the seller gets
The manager opens an order and sees the “Conta Azul” block: the buyer’s CPF/CNPJ, the customer name and address, a table of lines with the Conta Azul item they go as, freight, discount and “Sale total”. One click on “Send to Conta Azul” turns the order into a sale; the order keeps the sale number, the status and a “PDF” button (Pro).
The customer in Conta Azul is looked up by the CPF or CNPJ from the checkout fields; with no document the lookup goes by e-mail. If there is no such customer, the module creates one with the address and phone of the order. The module finds the CPF/CNPJ checkout fields itself or you pick them in the settings, and the number can also be typed into the order by hand.
The sale number is the next number of Conta Azul or the OpenCart order number, as you choose. For payment methods paid after the order (cash on delivery, bank transfer) a term in days is set. If the answer of Conta Azul is lost, the module looks the sale up by its number before any new try, so there is no duplicate. The journal shows the reason of every refusal, and a sending can be retried or removed from the queue.
What is in the admin
Extensions → Extensions → Modules → Conta Azul ERP: the tabs “Connection”, “Customer”, “Sale”, “Automation”, “Products and stock”, “Payment methods” and “Licence”. Every store connects with its own app: create an app (Production) at developers-portal.contaazul.com, enter the return address the module shows, copy the Client ID and Client secret into “Connection” and press “Connect Conta Azul”. The secret is kept in your store database in encrypted form and is never shown in the form.
The “Sale” tab: the Conta Azul product or service all order lines go as (found by its SKU code), the status of a new sale (“In progress” or “Approved”), numbering, the way of payment, the term for paid-later methods and a note added to every sale. The lines keep the name, quantity and price of the store.
The order page: a preview of the sale before sending, the CPF/CNPJ field with “Save for this order”, and after sending the sale number, the status and the action buttons.
In Pro the “Products and stock” tab matches products by SKU or model (variations included) and can create missing products in Conta Azul, and can copy stock from Conta Azul into the store in the background; both options are off by default. The “Automation” tab sends orders at the chosen statuses and cancels the sale at the cancellation or refund statuses.
The “Payment methods” tab (Pro) sets, for every payment method of the store, the Conta Azul way of payment, the financial account and the category. In the journal Pro shows period totals, the list of orders not sent yet, a CSV export and the “Retry all stopped” button.
How it works, step by step
- Install the archive for your OpenCart version and install the module in “Modules”.
- At developers-portal.contaazul.com create an app, enter the return address from the module page exactly as written and copy the Client ID and the Client secret.
- Paste them into the “Connection” tab, press “Connect Conta Azul” and allow access; the page shows the name of your company.
- In the “Sale” tab find by SKU the Conta Azul product or service for the order lines and choose the status, numbering and way of payment.
- Open an order, check the preview and press “Send to Conta Azul”: the sale number appears in the order.
- In Pro turn on sending by status, matching of products by SKU, and the payment methods and accounts.
- Watch the journal: reasons of refusals, retry, period totals and CSV.
Under the hood
- Conta Azul API v2: OAuth 2.0 (Authorization Code), customers, products and services, sales, the next number, PDF printing.
- The token is renewed under a database lock: the refresh token changes on every renewal, so two pages cannot burn the pair at once. If Conta Azul revokes the access, the admin says the connection is lost and offers to connect again.
- The client secret and the tokens are encrypted (AES-256 with HMAC) and never returned to the form.
- Sending does not block checkout: when Conta Azul is slow or down, the sale goes into a queue and is retried.
- Parallel clicks and cron passes give one sale.
- When the trial ends, Pro jobs in the queue stop with an explanation; the free send button keeps working.
- The Conta Azul limit is 600 calls a minute and 10 a second per account; the module works within it.
- The interface is in English and Brazilian Portuguese.
Installation
- OpenCart 4: Extensions → Installer, upload cc_contaazul.ocmod.zip without renaming it.
- OpenCart 3.x: Extensions → Installer, upload cc_contaazul-oc3.ocmod.zip, then Extensions → Modifications → Refresh.
- OpenCart 2.3: Extensions → Installer, upload cc_contaazul-oc23.ocmod.zip (FTP must be set in System → Settings → FTP; otherwise unpack the archive and copy the contents of the upload/ folder into the store root by hand), then Extensions → Modifications → Refresh.
- Extensions → Modules → Conta Azul ERP: install it and open the settings.
- Paste the Client ID and Client secret of your app and press “Connect Conta Azul”.
- For Pro: paste the licence key or start the trial in the “Licence” tab.
Questions
about the module
Didn't find the answer? Message us on Telegram and we'll reply within a business day.
Is this the official Conta Azul module?
No, it is an independent integration through the public API. Conta Azul is a trademark of its owner.
Why do I need my own app in the developer portal?
Conta Azul lets a store in through an app with its own Client ID and Client secret. The secret stays in your store database in encrypted form; there is no intermediate server of ours.
Does the module create new products in Conta Azul?
In the free version all lines go as one product or service that you choose. In Pro the lines are matched by SKU or model, 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. The CPF or CNPJ can be typed into the order by hand.
Does the module issue NF-e?
No. The module passes the sale to Conta Azul; tax documents are made in your Conta Azul account.
Can a sale be cancelled?
Yes, in Pro: at the cancellation or refund statuses of the order, or with a button. The sale in Conta Azul gets the status "Cancelled".
Does the free version work without Pro?
Yes: the connection, the preview, the send button, the customer by CPF/CNPJ, numbering, the way of payment and the journal with retry work in the free version.
Which OpenCart versions are supported?
OpenCart 4.0.2.0–4.1.x, 3.0.x and 2.3.0.2: three separate archives in one product.
Is the licence for life?
Yes, for OpenCart it is one payment and a licence for life, for two sites.
What happens after the trial?
Pro switches off, Pro jobs in the queue stop with a reason, and the free part keeps working.
No reviews yet. Be the first.
No questions yet. Ask one — we answer within 24 hours.
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
Buying the module
—
Charged in UAH; your bank converts it to your currency. EUR price is approximate.




















