Pull your hoadondientu.gdt.gov.vn invoices into your systems

What you can build on the e-invoice portal

• Get purchase invoices

  Build this

  Reads Tra cứu hóa đơn điện tử mua vào (purchase invoices) under Tra cứu > Tra cứu hóa đơn for a range of Ngày lập hóa đơn (issue date).

  Takes

  From date, to date, seller tax code (optional), status (optional)

  Returns

  Form symbol, invoice symbol, invoice number, issue date, seller tax code, seller name, total payment, status

• Get sales invoices

  Build this

  Reads Tra cứu hóa đơn điện tử bán ra (sales invoices) for a range of issue dates: the invoices your company issued, with each buyer and total.

  Takes

  From date, to date, buyer tax code (optional)

  Returns

  Form symbol, invoice symbol, invoice number, issue date, buyer tax code, buyer name, total payment, status

• Read one invoice's XML data

  Build this

  Finds one invoice by seller tax code, symbol and number, uses Xuất XML and returns what the XML holds: the parties, the lines and the totals.

  Takes

  Seller tax code, invoice symbol, invoice number, issue date

  Returns

  Seller, buyer, invoice lines with quantity, unit price and VAT rate, total before tax, VAT amount, total payment

Automate the e-invoice portal with a workflow

A workflow runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

• Last week's purchase invoices, handed to accounting

  Build this

  Starts

  Every Monday at 7:00 (Asia/Ho_Chi_Minh)

  Step 1

  Get the purchase invoices issued in the last 7 days, from both result tabs.

  Step 2

  Keep the invoices that were not there on the last run.

  Step 3

  Post each one, with seller tax code, symbol, number, issue date and total payment, to your accounting system's webhook.

• Purchase invoices whose status changed

  Build this

  Starts

  Every weekday at 8:00 (Asia/Ho_Chi_Minh)

  Step 1

  Get the purchase invoices issued in the last 31 days.

  Step 2

  Keep the invoices whose status changed since the last run.

  Step 3

  Email you the list with the old and new status of each.

• Monthly sales invoice summary by buyer

  Build this

  Starts

  On the 1st of every month at 9:00 (Asia/Ho_Chi_Minh)

  Step 1

  Get the sales invoices issued in the previous month.

  Step 2

  Group them by buyer tax code with the count and the sum of total payment.

  Step 3

  Email you the summary and post the invoice list to your webhook.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

Once built, one call from your code

Once you have built a method, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get purchase invoices” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "hoadondientu.gdt.gov.vn/get_purchase_invoices",
    "input": {
      "from_date": "2026-11-01",
      "to_date": "2026-11-11"
    }
  }'

{
  "status": "completed",
  "data": {
    "invoices": [
      {
        "form_symbol": "1",
        "invoice_symbol": "C26TAA",
        "invoice_number": "128",
        "issue_date": "2026-11-03",
        "seller_tax_code": "0109999901",
        "seller_name": "Công ty TNHH Northwind Việt Nam",
        "total_payment": 16500000,
        "currency": "VND",
        "tab": "Hóa đơn điện tử",
        "status": "Đã cấp mã hóa đơn"
      }
    ],
    "count": 1
  }
}

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

The e-invoice portal’s own options

The portal is where a company registered for e-invoices under Thông tư 78 looks up the invoices it issued and received. The guides describe searching on screen, Xuất excel for a list and Xuất XML for each invoice. None of the guides we read describes an API for companies to download their own invoices.

Read on November 12, 2026: MISA: getting purchase invoices from the tax authority's e-invoice site, ACC: looking up e-invoices on the portal, GIZ: instruction for checking invoices.

Signing in to the e-invoice portal

You sign in to the e-invoice portal with your company's tax code (mã số thuế) and the password of the account the tax authority issued to it. With Fous you sign in once through the portal's own sign-in with that account: the login is sealed with AES-256, never returned by the API, and an expired session is signed back in.

Worth knowing

31 days per search

A search on Ngày lập hóa đơn covers at most 31 days, so a quarter or a year takes several searches. Build the method to take a date range and search it 31 days at a time.

Two result tabs

Results come in two tabs, Hóa đơn điện tử and Hóa đơn có mã khởi tạo từ máy tính tiền (invoices from cash registers). A complete purchase list reads both.

Only accounts under Thông tư 78

Accounts go to taxpayers whose e-invoice registration under Thông tư 78/2021/TT-BTC the tax authority has accepted with a Chấp nhận notice. Without one, the public lookup checks one invoice at a time.

The XML is the original invoice

Xuất excel gives you the list. The file from Xuất XML is the invoice's original data, so read line items and VAT from the XML, one invoice at a time.

More in Government: East and South-East Asia, Oceania

• 登記情報提供サービス
• SIPP Online
• Edabu
• PhilHealth EPRS
• Virtual Pag-IBIG for Employers
• KWSP i-Akaun (Majikan)
• 自然人电子税务局（扣缴端）
• eMPF Platform
• My.SSS Employer Portal
• SSO e-Service
• BIR eFPS
• RD e-Filing
• 全国统一规范电子税务局
• Coretax DJP
• myIR
• MyTax

Other industries: Income Tax e-Filing Portal, My ARC, Facturación Electrónica DIAN, CIPC eServices, EUDR Information System, Companies House WebFiling.