Connect your e-invoice provider

Ha Tang issues e-invoices (hoá đơn điện tử) under your own tax code, through your own account at your e-invoice provider. Your invoices, numbering and signing stay with the provider you already use and declare to the tax office; Ha Tang creates the drafts, sends them for signing and keeps track of each one. Today the supported provider is Mắt Bão.

Connecting a provider needs the Manage level on the Payments module. Do it once per environment: in Development with Mắt Bão's demo sandbox, in Production with your real account.

Before you start

• A Mắt Bão e-invoice account with API access. The tax code, API user and password are under Cấu hình API in the Mắt Bão invoice portal. Ask Mắt Bão to turn on API access if you do not see it.
• At least one template and series (mẫu số and ký hiệu) registered for your business at Mắt Bão.
• In development, the credentials of a Mắt Bão demo account (portal demo.matbao.in). Nothing created there reaches the tax office.

Connect

1. Open Payments → Payments settings, tab Invoice providers.
2. Under Add a provider, choose Mắt Bão as the Provider.
3. Enter the Tax code (MST), the API user and the API password.
4. Click Check connection. Ha Tang signs in and reads the templates of your account: the form says which tax code it signed in as and how many templates it found.
5. Under Template and series, choose the one your invoices are issued on. The list shows how many invoice numbers each has left.
6. Under When a paid order asks for an invoice, choose:
   • create the draft, I send it for approval: Ha Tang stops at the draft and someone on your team checks and sends it, or
   • create the draft and send it for approval: the invoice is signed automatically.
7. Tick Also import invoices created on the provider's site if you also issue invoices directly in the Mắt Bão portal and want to see them in Ha Tang.
8. Click Check and connect.

The password is stored encrypted and never shown again.

Send the callback URL to Mắt Bão

After connecting, the provider card shows a Callback URL. Send it to Mắt Bão support and ask them to set it for your account. Changes made on their side (signing, the tax office's code, cancellations, replacements) then reach Ha Tang at once. Without it, Ha Tang asks Mắt Bão for changes every minute, which also works but is slower; the card shows when it last checked.

Manage the connection

What Ha Tang does with the provider

• It creates drafts at Mắt Bão from your payments or from invoices you create, with the buyer, the items and VAT.
• It sends them for approval (signing), automatically or when you click, depending on the mode.
• It reads back what happens: the invoice number and lookup code, the tax office's code or rejection, and changes made in the Mắt Bão portal.
• It retries by itself when Mắt Bão is slow or unavailable. Payments → Integration health shows calls waiting and failing.

Ha Tang never cancels or deletes an invoice that has been sent to the tax office; that is done in the Mắt Bão portal, or by a replacement invoice.

Troubleshooting

API details and invoice statuses for developers are in E-invoices in the developer hub.