Get invoice serial list

GET /<provider>/get-invoice-serials

API used to get the list of registered invoice serials.

Headers

Name	Required	Description
Authorization	✅	Bearer token
Content-Type	✅	application/json
X-Tax-Code	✅	Business tax code.

Query Parameters

Name	Required	Description
inv_type		Not sent: retrieve all. Invoice type 1: VAT invoice, 2: Sales invoice, 3: Public asset sale invoice, 4: National reserve goods sale invoice, 5: Stamps/tickets/cards, 6: Delivery note (cum internal transport, consignment to agent).
stax		Seller tax code (required for Viettel).

Response

Name	Description
data[].year	Current year (last 2 digits)
data[].inv_type	Invoice type
data[].value	Invoice serial value
data[].inv_type_name	Invoice serial description
data[].template_code	Invoice template serial (Viettel)

1Invoice

curl --location 'https://stag-invoice-hub.1invoice.vn/1Invoice/get-invoice-serials?inv_type=1' \
--header 'authorization: Bearer <token>' \
--header 'x-tax-code: 0106026495-998'

one-invoice

curl --location 'https://stag-invoice-hub.1invoice.vn/one-invoice/get-invoice-serials?stax=0106026495-998' \
--header 'accept: application/json, text/plain, */*' \
--header 'authorization: Bearer <token>' \
--header 'x-tax-code: 0106026495-998' \
--data ''

fpt

curl --location 'https://stag-invoice-hub.1invoice.vn/fpt/get-invoice-serials?stax=0104128565-999' \
--header 'authorization: Bearer <token>' \
--header 'x-tax-code: 0104128565-999'

viettel

curl --location 'https://stag-invoice-hub.1invoice.vn/viettel/get-invoice-serials?stax=0100109106-509' \
--header 'authorization: Bearer <token>' \
--header 'x-tax-code: 0100109106-509'

misa

curl --location 'https://stag-invoice-hub.1invoice.vn/misa/get-invoice-serials?stax=2222222222-788' \
--header 'authorization: Bearer <token>' \
--header 'x-tax-code: 2222222222-788'

Response

{
  "data": [
    {
      "year": 25,
      "inv_type": "1",
      "value": "1C25MTS",
      "inv_type_name": "Hóa đơn giá trị gia tăng - Máy tính tiền"
    },
    {
      "year": 25,
      "inv_type": "1",
      "value": "1C25MSH",
      "inv_type_name": "Hóa đơn giá trị gia tăng - Máy tính tiền"
    },
    {
      "year": 25,
      "inv_type": "1",
      "value": "1C25MMP",
      "inv_type_name": "Hóa đơn giá trị gia tăng - Máy tính tiền"
    }
  ],
  "success": true,
  "message": "Thành công"
}