Manage Tax IDs
Learn which Tax IDs Monite supports and how to manage them.
Overview
A Tax ID is an identification number for businesses used for tax purposes. By associating the related Tax IDs to customers, it is possible to display the customer’s Tax ID on the receivables.
Businesses can have one, multiple, or no Tax IDs depending on the country and regulatory requirements.
Tax IDs names and formats vary from country to country. In the EU, for example, it is referred to as “VAT identification number” or VATIN, whereas Canadian businesses have a BN (Business Number) and sales tax numbers.
Supported Tax ID types
Currently, Monite supports the following Tax ID types:
Country | Type | Description | Example |
---|---|---|---|
Australia | au_abn | Australian Business Number (AU ABN) | 51824753556 |
Australia | au_arn | Australian Taxation Office Reference Number | 518247535567 |
Austria | eu_vat | European VAT number | ATU12345678 |
Belgium | eu_vat | European VAT number | BE0123456789 |
Brazil | br_cnpj | Brazilian CNPJ number | 28.271.211/0001-88 |
Brazil | br_cpf | Brazilian CPF number | 137.609.391-04 |
Bulgaria | bg_uic | Bulgaria Unified Identification Code | 123456789 |
Bulgaria | eu_vat | European VAT number | BG0123456789 |
Canada | ca_bn | Canadian BN | 123456789 |
Canada | ca_gst_hst | Canadian GST/HST number | 123456789RT0002 |
Canada | ca_pst_bc | Canadian PST number (British Columbia) | PST-1234-5678 |
Canada | ca_pst_mb | Canadian PST number (Manitoba) | 123456-7 |
Canada | ca_pst_sk | Canadian PST number (Saskatchewan) | 1234567 |
Canada | ca_qst | Canadian QST number (Québec) | 1234567890TQ1234 |
Chile | cl_tin | Chilean TIN | 12.345.678-K |
Croatia | eu_vat | European VAT number | HR12345678912 |
Cyprus | eu_vat | European VAT number | CY12345678Z |
Czech Republic | eu_vat | European VAT number | CZ1234567890 |
Denmark | eu_vat | European VAT number | DK12345678 |
Estonia | eu_vat | European VAT number | EE123456789 |
European Union | eu_oss_vat | European One Stop Shop VAT number for non-Union scheme | EU123456789 |
Finland | eu_vat | European VAT number | FI12345678 |
France | eu_vat | European VAT number | FRAB123456789 |
Georgia | ge_vat | Georgian VAT | 123456789 |
Germany | eu_vat | European VAT number | DE123456789 |
Greece | eu_vat | European VAT number | EL123456789 |
Hong Kong | hk_br | Hong Kong BR number | 12345678 |
Hungary | hu_tin | Hungary tax number (adószám) | 12345678-1-23 |
Hungary | eu_vat | European VAT number | HU12345678912 |
Iceland | is_vat | Icelandic VAT | 123456 |
India | in_gst | Indian GST number | 12ABCDE3456FGZH |
Indonesia | id_npwp | Indonesian NPWP number | 12.345.678.9-012.345 |
Ireland | eu_vat | European VAT number | IE1234567AB |
Israel | il_vat | Israel VAT | 12345 |
Italy | eu_vat | European VAT number | IT12345678912 |
Japan | jp_cn | Japanese Corporate Number (Hōjin Bangō) | 1234567891234 |
Japan | jp_rn | Japanese Registered Foreign Businesses' Registration Number (Tōroku Kokugai Jigyōsha no Tōroku Bangō) | 12345 |
Japan | jp_trn | Japanese Tax Registration Number (Tōroku Bangō) | T1234567891234 |
Kenya | ke_pin | Kenya Revenue Authority Personal Identification Number | P000111111A |
Latvia | eu_vat | European VAT number | LV12345678912 |
Liechtenstein | li_uid | Liechtensteinian UID number | CHE123456789 |
Lithuania | eu_vat | European VAT number | LT123456789123 |
Luxembourg | eu_vat | European VAT number | LU12345678 |
Malaysia | my_frp | Malaysian FRP number | 12345678 |
Malaysia | my_itn | Malaysian ITN | C 1234567890 |
Malaysia | my_sst | Malaysian SST number | A12-3456-78912345 |
Malta | eu_vat | European VAT number | MT12345678 |
Mexico | mx_rfc | Mexican RFC number | ABC010203AB9 |
Netherlands | eu_vat | European VAT number | NL123456789B12 |
New Zealand | nz_gst | New Zealand GST number | 123456789 |
Norway | no_vat | Norwegian VAT number | 123456789MVA |
Poland | eu_vat | European VAT number | PL1234567890 |
Portugal | eu_vat | European VAT number | PT123456789 |
Romania | eu_vat | European VAT number | RO1234567891 |
Russia | ru_inn | Russian INN | 1234567891 |
Russia | ru_kpp | Russian KPP | 123456789 |
Saudi Arabia | sa_vat | Saudi Arabia VAT | 123456789012345 |
Singapore | sg_gst | Singaporean GST | M12345678X |
Singapore | sg_uen | Singaporean UEN | 123456789F |
Slovakia | eu_vat | European VAT number | SK1234567891 |
Slovenia | si_tin | Slovenia tax number (davčna številka) | 12345678 |
Slovenia | eu_vat | European VAT number | SI12345678 |
South Africa | za_vat | South African VAT number | 4123456789 |
South Korea | kr_brn | Korean BRN | 123-45-67890 |
Spain | es_cif | Spanish NIF number (previously Spanish CIF number) | A12345678 |
Spain | eu_vat | European VAT number | ESA1234567Z |
Sweden | eu_vat | European VAT number | SE123456789123 |
Switzerland | ch_vat | Switzerland VAT number | CHE-123.456.789 MWST |
Taiwan | tw_vat | Taiwanese VAT | 12345678 |
Thailand | th_vat | Thai VAT | 1234567891234 |
Ukraine | ua_vat | Ukrainian VAT | 123456789 |
United Arab Emirates | ae_trn | United Arab Emirates TRN | 123456789012345 |
United Kingdom | gb_vat | United Kingdom VAT number | GB123456789 |
United Kingdom | eu_vat | Northern Ireland VAT number | XI123456789 |
United States | us_ein | United States EIN | 12-3456789 |
Need another Tax ID type?
You can request additional Tax ID types by sending an email to [email protected].
Add new Tax ID
To associate a new Tax ID to a specific counterpart, call POST /counterparts/{counterpart_id}/tax_ids
, passing the Tax ID type
and value
in the request body:
curl -X POST 'https://api.sandbox.monite.com/v1/counterparts/411dcb...289b3/tax_ids' \
-H 'X-Monite-Version: 2023-03-14' \
-H 'accept: application/json' \
-H 'X-Monite-Entity-Id: ENTITY_ID' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-d '{
"type": "eu_vat",
"value": "DE12345678"
}'
The successful response contains the information about the newly added Tax ID:
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"counterpart_id": "411dcb68-dad8-46c2-92b9-f6ae445289b3",
"type": "eu_vat",
"value": "DE12345678"
}
List all Tax IDs
To get all Tax IDs of a specific counterpart, call GET /counterparts/{counterpart_id}/tax_ids
:
curl -X GET 'https://api.sandbox.monite.com/v1/counterparts/411dcb...289b3/tax_ids' \
-H 'X-Monite-Version: 2023-03-14' \
-H 'accept: application/json' \
-H 'X-Monite-Entity-Id: ENTITY_ID' \
-H 'Authorization: Bearer ACCESS_TOKEN'
The successful response contains a list of Tax IDs of the specified counterpart:
{
"data": [
{
"type": "eu_vat",
"value": "DE12345678",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"counterpart_id": "411dcb68-dad8-46c2-92b9-f6ae445289b3"
}
]
}
Edit a Tax ID
To edit an existing Tax ID of the specified counterpart, call PATCH /counterparts/{counterpart_id}/tax_ids/{tax_id}
. You can update the tax ID type
, value
, or both.
Delete a Tax ID
To delete an existing Tax ID from the list of Tax IDs associated to the specified counterpart, call DELETE /counterparts/{counterpart_id}/tax_ids/{tax_id}
.
Updated about 1 month ago