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

Get in touch
OpenCart

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.

Pro · lifetime licence Staging copies are included. The more sites, the cheaper each one
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
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), check and disconnect ✔ ✔
The "Send to Conta Azul" button in the order with a preview of customer, lines, freight and total ✔ ✔
Customer by CPF/CNPJ or e-mail, customer created with address and phone ✔ ✔
Sale lines as one chosen Conta Azul product or service ✔ ✔
Numbering: next Conta Azul number or the order number ✔ ✔
Way of payment and term for paid-later methods ✔ ✔
Lookup of a sale by its number when the answer is lost: no duplicates ✔ ✔
Journal with reasons of refusals, retry and removal ✔ ✔
CPF/CNPJ typed into the order by hand ✔ ✔
Sending by order status — ✔
Cancelling a sale by status or button — ✔
Products by SKU or model, creating missing ones — ✔
Way of payment, financial account and category for every payment method — ✔
Bulk sending of old orders and "retry all" — ✔
PDF of the sale from the admin — ✔
Period totals and CSV of the journal — ✔
Stock from Conta Azul into the store — ✔

What it looks like

The Conta Azul block in the order
The order page: CPF/CNPJ, customer, table of lines with the Conta Azul item, freight, discount, total and the “Send to Conta Azul” button.
Connecting Conta Azul
The “Connection” tab: return address, Client ID and Client secret of your own app, buttons to connect, check and disconnect.
Sale settings
The “Sale” tab: the item for the lines, status of a new sale, numbering, way of payment, term and note.

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

v1.0.0 Current 15.11.2026

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

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 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

  1. Install the archive for your OpenCart version and install the module in “Modules”.
  2. 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.
  3. Paste them into the “Connection” tab, press “Connect Conta Azul” and allow access; the page shows the name of your company.
  4. 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.
  5. Open an order, check the preview and press “Send to Conta Azul”: the sale number appears in the order.
  6. In Pro turn on sending by status, matching of products by SKU, and the payment methods and accounts.
  7. 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

  1. OpenCart 4: Extensions → Installer, upload cc_contaazul.ocmod.zip without renaming it.
  2. OpenCart 3.x: Extensions → Installer, upload cc_contaazul-oc3.ocmod.zip, then Extensions → Modifications → Refresh.
  3. 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.
  4. Extensions → Modules → Conta Azul ERP: install it and open the settings.
  5. Paste the Client ID and Client secret of your app and press “Connect Conta Azul”.
  6. 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.

@catcode_support Setup, compatibility, activation
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.

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