# IDs fiscais de clientes

Aprenda a armazenar, validar e processar números de ID fiscal do cliente com o Stripe Billing.

Precisa de outro tipo de ID fiscal? Solicite outros tipos de ID Fiscal entrando em contato com o [suporte da Stripe](https://support.stripe.com/contact).

Exibir o ID fiscal de um cliente em documentos de *fatura* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) é uma exigência comum que você pode cumprir adicionando IDs fiscais a clientes. Os IDs fiscais de um cliente são exibidos no cabeçalho dos PDFs de faturas e notas de crédito.

## Tipos de ID fiscal aceitos

No momento, a Stripe aceita os seguintes tipos de ID fiscal nas seguintes regiões:

| Country | Enum | Description | Example | Impact in Tax Calculation* |
| --- | --- | --- | --- | --- |
| AD | ad_nrt | Andorran NRT number | A-123456-Z | No |
| AE | ae_trn | United Arab Emirates TRN | 123456789012345 | Yes |
| AL | al_tin | Albania Tax Identification Number | J12345678N | Yes |
| AM | am_tin | Armenia Tax Identification Number | 02538904 | Yes |
| AO | ao_tin | Angola Tax Identification Number | 5123456789 | No |
| AR | ar_cuit | Argentinian tax ID number | 12-3456789-01 | No |
| AT | eu_vat | European VAT number | ATU12345678 | Yes |
| AU | au_abn | Australian Business Number (AU ABN) | 12345678912 | Yes |
| AU | au_acn | Australian Company Number | 123456789 | No |
| AU | au_arn | Australian Taxation Office Reference Number | 123456789123 | No |
| AU | au_wpn | Australian Withholding Payer Number | 00123456789 | No |
| AW | aw_tin | Aruba Tax Identification Number | 12345678 | Yes |
| AZ | az_tin | Azerbaijan Tax Identification Number | 0123456789 | Yes |
| BA | ba_tin | Bosnia and Herzegovina Tax Identification Number | 123456789012 | Yes |
| BB | bb_tin | Barbados Tax Identification Number | 1123456789012 | No |
| BD | bd_bin | Bangladesh Business Identification Number | 123456789-0123 | Yes |
| BE | eu_vat | European VAT number | BE0123456789 | Yes |
| BF | bf_ifu | Burkina Faso Tax Identification Number (Numéro d'Identifiant Fiscal Unique) | 12345678A | Yes |
| BG | bg_uic | Bulgaria Unified Identification Code | 123456789 | No |
| BG | eu_vat | European VAT number | BG0123456789 | Yes |
| BH | bh_vat | Bahraini VAT Number | 123456789012345 | Yes |
| BJ | bj_ifu | Benin Tax Identification Number (Identifiant Fiscal Unique) | 1234567890123 | Yes |
| BO | bo_tin | Bolivian tax ID | 123456789 | No |
| BR | br_cnpj | Brazilian CNPJ number | 01.234.456/5432-10 | No |
| BR | br_cpf | Brazilian CPF number | 123.456.789-87 | No |
| BS | bs_tin | Bahamas Tax Identification Number | 123.456.789 | No |
| BW | bw_vat | Botswana Value Added Tax number | BW12345678901004567 | No |
| BY | by_tin | Belarus TIN Number | 123456789 | Yes |
| CA | ca_bn | Canadian BN | 123456789 | No |
| CA | ca_gst_hst | Canadian GST/HST number | 123456789RT0002 | Yes |
| CA | ca_pst_bc | Canadian PST number (British Columbia) | PST-1234-5678 | No |
| CA | ca_pst_mb | Canadian PST number (Manitoba) | 123456-7 | No |
| CA | ca_pst_sk | Canadian PST number (Saskatchewan) | 1234567 | No |
| CA | ca_qst | Canadian QST number (Québec) | 1234567890TQ1234 | Yes |
| CD | cd_nif | Congo (DR) Tax Identification Number (Número de Identificação Fiscal) | A0123456M | No |
| CH | ch_uid | Switzerland UID number | CHE-123.456.789 HR | No |
| CH | ch_vat | Switzerland VAT number | CHE-123.456.789 MWST | Yes |
| CI | ci_vat | Ivory Coast Value Added Tax number | 2100000 L | No |
| CL | cl_tin | Chilean TIN | 12.345.678-K | Yes |
| CM | cm_niu | Cameroon Tax Identification Number (Numéro d'Identifiant fiscal Unique) | M123456789000L | No |
| CN | cn_tin | Chinese tax ID | 123456789012345678 | No |
| CO | co_nit | Colombian NIT number | 123.456.789-0 | No |
| CR | cr_tin | Costa Rican tax ID | 1-234-567890 | No |
| CV | cv_nif | Cape Verde Tax Identification Number (Número de Identificação Fiscal) | 213456789 | No |
| CY | eu_vat | European VAT number | CY12345678Z | Yes |
| CZ | cz_dic | Czechia Daňové identifikační číslo | CZ12345678 | No |
| CZ | eu_vat | European VAT number | CZ1234567890 | Yes |
| DE | de_stn | German Tax Number (Steuernummer) | 1234567890 | No |
| DE | eu_vat | European VAT number | DE123456789 | Yes |
| DK | eu_vat | European VAT number | DK12345678 | Yes |
| DO | do_rcn | Dominican RCN number | 123-4567890-1 | No |
| EC | ec_ruc | Ecuadorian RUC number | 1234567890001 | No |
| EE | eu_vat | European VAT number | EE123456789 | Yes |
| EG | eg_tin | Egyptian Tax Identification Number | 123456789 | Yes |
| ES | es_cif | Spanish NIF number (previously Spanish CIF number) | A12345678 | No |
| ES | eu_vat | European VAT number | ESA1234567Z | Yes |
| ET | et_tin | Ethiopia Tax Identification Number | 1234567890 | Yes |
| EU | eu_oss_vat | European One Stop Shop VAT number for non-Union scheme | EU123456789 | No |
| FI | eu_vat | European VAT number | FI12345678 | Yes |
| FO | fo_vat | Faroe Islands VAT number | FO123456 | No |
| FR | eu_vat | European VAT number | FRAB123456789 | Yes |
| FR | fr_siren | France SIREN number | 123456789 | No |
| FR | fr_siret | France SIRET number | 12345678901234 | No |
| FR | fr_spi | France SPI / NIF | 1234567890123 | No |
| GB | eu_vat | Northern Ireland VAT number | XI123456789 | Yes |
| GB | gb_vat | United Kingdom VAT number | GB123456789 | Yes |
| GE | ge_vat | Georgian VAT | 123456789 | Yes |
| GH | gh_tin | Ghanaian Tax Identification Number | C0001234567 | No |
| GI | gi_tin | Gibraltar Tax Identification number | 12345 | No |
| GN | gn_nif | Guinea Tax Identification Number (Número de Identificação Fiscal) | 123456789 | Yes |
| GR | eu_vat | European VAT number | EL123456789 | Yes |
| HK | hk_br | Hong Kong BR number | 12345678 | No |
| HR | eu_vat | European VAT number | HR12345678912 | Yes |
| HR | hr_oib | Croatian Personal Identification Number | 12345678901 | No |
| HU | eu_vat | European VAT number | HU12345678 | Yes |
| HU | hu_tin | Hungary tax number (adószám) | 12345678-1-23 | No |
| IC | ic_nif | Canary Islands NIF number (Número de Identificación Fiscal) | A12345678 | Yes |
| ID | id_npwp | Indonesian NPWP number | 012.345.678.9-012.345 | No |
| IE | eu_vat | European VAT number | IE1234567AB | Yes |
| IL | il_vat | Israel VAT | 000012345 | No |
| IN | in_gst | Indian GST number | 12ABCDE3456FGZH | Yes |
| IS | is_kt | Iceland Tax Identification Number | 1234567890 | No |
| IS | is_vat | Icelandic VAT | 123456 | Yes |
| IT | eu_vat | European VAT number | IT12345678912 | Yes |
| IT | it_cf | Italian Codice Fiscale number | ABCDEF12A12A123A | No |
| JP | jp_cn | Japanese Corporate Number (*Hōjin Bangō*) | 1234567891234 | No |
| JP | jp_rn | Japanese Registered Foreign Businesses' Registration Number (*Tōroku Kokugai Jigyōsha no Tōroku Bangō*) | 12345 | No |
| JP | jp_trn | Japanese Tax Registration Number (*Tōroku Bangō*) | T1234567891234 | Yes |
| KE | ke_pin | Kenya Revenue Authority Personal Identification Number | P000111111A | No |
| KG | kg_tin | Kyrgyzstan Tax Identification Number | 12345678901234 | No |
| KH | kh_tin | Cambodia Tax Identification Number | 1001-123456789 | Yes |
| KR | kr_brn | Korean BRN | 123-45-67890 | Yes |
| KZ | kz_bin | Kazakhstani Business Identification Number | 123456789012 | Yes |
| LA | la_tin | Laos Tax Identification Number | 123456789-000 | No |
| LI | li_uid | Liechtensteinian UID number | CHE123456789 | No |
| LI | li_vat | Liechtensteinian VAT number | 12345 | Yes |
| LK | lk_vat | Sri Lanka VAT number | 123456789-1234 | Yes |
| LT | eu_vat | European VAT number | LT123456789123 | Yes |
| LU | eu_vat | European VAT number | LU12345678 | Yes |
| LV | eu_vat | European VAT number | LV12345678912 | Yes |
| MA | ma_vat | Morocco VAT Number | 12345678 | Yes |
| MD | md_cf | Moldova Cod Fiscal number | E123456789012 | No |
| MD | md_vat | Moldova VAT Number | 1234567 | Yes |
| ME | me_pib | Montenegro PIB Number | 12345678 | No |
| MK | mk_vat | North Macedonia VAT Number | MK1234567890123 | Yes |
| MR | mr_nif | Mauritania Tax Identification Number (Número de Identificação Fiscal) | 12345678 | No |
| MT | eu_vat | European VAT number | MT12345678 | Yes |
| MU | mu_vat | Mauritius Value Added Tax number | VAT12345678 | No |
| MX | mx_rfc | Mexican RFC number | ABC010203AB9 | No |
| MY | my_frp | Malaysian FRP number | 12345678 | No |
| MY | my_itn | Malaysian ITN | C 1234567890 | No |
| MY | my_sst | Malaysian SST number | A12-3456-78912345 | No |
| MZ | mz_nuit | Mozambique Número de Identificação Tributária | 123456789 | No |
| NG | ng_tin | Nigerian Tax Identification Number | 1234567890123 | No |
| NL | eu_vat | European VAT number | NL123456789B12 | Yes |
| NO | no_vat | Norwegian VAT number | 123456789MVA | Yes |
| NO | no_voec | Norwegian VAT on e-commerce number | 1234567 | No |
| NP | np_pan | Nepal PAN Number | 123456789 | Yes |
| NZ | nz_bn | New Zealand Business Number | 1234567890123 | No |
| NZ | nz_gst | New Zealand GST number | 123456789 | Yes |
| OM | om_vat | Omani VAT Number | OM1234567890 | Yes |
| PE | pe_ruc | Peruvian RUC number | 12345678901 | Yes |
| PH | ph_tin | Philippines Tax Identification Number | 123456789012 | Yes |
| PL | eu_vat | European VAT number | PL1234567890 | Yes |
| PL | pl_nip | Polish NIP number | 1234567890 | No |
| PT | eu_vat | European VAT number | PT123456789 | Yes |
| PT | pt_nif | Portugal Número de Identificação Fiscal | 123456789 | No |
| PY | py_ruc | Paraguayan RUC number | 12345678A | No |
| RO | eu_vat | European VAT number | RO1234567891 | Yes |
| RO | ro_tin | Romanian tax ID number | 1234567890123 | No |
| RS | rs_pib | Serbian PIB number | 123456789 | No |
| RU | ru_inn | Russian INN | 1234567891 | Yes |
| RU | ru_kpp | Russian KPP | 123456789 | Yes |
| SA | sa_vat | Saudi Arabia VAT | 123456789012345 | Yes |
| SE | eu_vat | European VAT number | SE123456789123 | Yes |
| SG | sg_gst | Singaporean GST | M12345678X | Yes |
| SG | sg_uen | Singaporean UEN | 123456789F | No |
| SI | eu_vat | European VAT number | SI12345678 | Yes |
| SI | si_tin | Slovenia tax number (davčna številka) | 12345678 | No |
| SK | eu_vat | European VAT number | SK1234567891 | Yes |
| SM | sm_coe | San Marino COE number | SM12345 | No |
| SN | sn_ninea | Senegal NINEA Number | 12345672A2 | No |
| SR | sr_fin | Suriname FIN Number | 1234567890 | Yes |
| SV | sv_nit | El Salvadorian NIT number | 1234-567890-123-4 | No |
| TH | th_vat | Thai VAT | 1234567891234 | Yes |
| TJ | tj_tin | Tajikistan Tax Identification Number | 123456789 | Yes |
| TR | tr_tin | Turkish Tax Identification Number | 0123456789 | Yes |
| TT | tt_bir | Trinidad and Tobago Board of Inland Revenue | 1234567890 | No |
| TT | tt_vat | Trinidad and Tobago VAT registration number | 123456 | No |
| TW | tw_vat | Taiwanese VAT | 12345678 | Yes |
| TZ | tz_vat | Tanzania VAT Number | 12345678A | Yes |
| UA | ua_vat | Ukrainian VAT | 123456789 | Yes |
| UG | ug_tin | Uganda Tax Identification Number | 1014751879 | Yes |
| US | us_ein | United States EIN | 12-3456789 | No |
| UY | uy_ruc | Uruguayan RUC number | 123456789012 | Yes |
| UZ | uz_tin | Uzbekistan TIN Number | 123456789 | No |
| UZ | uz_vat | Uzbekistan VAT Number | 123456789012 | Yes |
| VE | ve_rif | Venezuelan RIF number | A-12345678-9 | No |
| VN | vn_tin | Vietnamese tax ID number | 1234567890 | No |
| ZA | za_vat | South African VAT number | 4123456789 | Yes |
| ZM | zm_tin | Zambia Tax Identification Number | 1004751879 | No |
| ZW | zw_tin | Zimbabwe Tax Identification Number | 1234567890 | No |

\*Stripe Tax won't apply tax if this tax ID is provided, in line with the relevant laws.

## Validação

A Stripe verifica apenas o formato dos tipos de ID fiscal que não sejam AU ABN, EU VAT e GB VAT, e não os valida em bancos de dados do governo.

Você é responsável pela exatidão dos dados do cliente (incluindo o número de ID fiscal). A fatura inclui o ID fiscal do cliente, independentemente de ser válido ou não.

A Stripe oferece validação automática para ajudar a determinar se a formatação está correta quando você adicionar o ID ao nosso sistema. Os resultados da validação podem ser visualizados no Dashboard junto com outros dados do cliente, incluindo as informações retornadas dos bancos de dados governamentais, além do nome e do endereço registrados. No entanto, não continuamos a validá-los com o tempo.

Compare a validação para os tipos de ID fiscal do cliente:

| País ou região | Valida o formato | Valida em bancos de dados do governo | Documentação |
| --- | --- | --- | --- |
| Austrália (AU ABN) | Sim | Sim | [Validação de ABN](https://docs.stripe.com/billing/customer/tax-ids.md#abn) |
| União Europeia (EU VAT) | Sim | Sim | [Validação de EU VAT](https://docs.stripe.com/billing/customer/tax-ids.md#eu-vat) |
| Reino Unido (GB VAT) | Sim | Sim | [Validação de GB VAT](https://docs.stripe.com/billing/customer/tax-ids.md#gb-vat) |
| Outros tipos de ID fiscal | Sim | Não | [Verificações de formato](https://docs.stripe.com/billing/customer/tax-ids.md#other-tax-id-types) |

### Números comerciais australianos (ABNs)

A Stripe valida automaticamente todos os Australian Business Numbers (ABNs) com o [Australian Business Register (ABR)](https://abr.gov.au/). Este processo apenas verifica a validade do ID fiscal, e não se o nome, o endereço e o status de cadastro de GST do cliente correspondem ao que consta na página de clientes no Dashboard.

### Números de Imposto sobre valor agregado europeu (IVA da UE)

A Stripe também valida automaticamente todos os números do Imposto sobre Valor Agregado Europeu (IVA da UE) com o [Sistema de Intercâmbio de Informações sobre o IVA (VIES) da Comissão Europeia](https://ec.europa.eu/taxation_customs/vies/). Esse processo só valida se o ID fiscal é válido ou não, mas você ainda precisa verificar o nome e o endereço do cliente para garantir que correspondam às informações de cadastro.

A validação VIES costuma demorar alguns segundos mas, dependendo da disponibilidade de vários bancos de dados governamentais, pode demorar mais. A Stripe gerencia automaticamente o tempo de inatividade do VIES e faz novas tentativas.

### Números de Imposto sobre valor agregado do Reino Unido (IVA da GB)

A Stripe valida automaticamente todos os números de imposto sobre valor agregado do Reino Unido (GB IVA) com a [United Kingdom’s Revenue & Customs (HMRC)](https://www.gov.uk/). Esse processo valida apenas se o ID fiscal é válido ou não. Ainda é preciso verificar o nome e o endereço do cliente para assegurar que corresponda às informações do cadastro.

A validação da HMRC costuma demorar alguns segundos mas, dependendo da disponibilidade, pode demorar mais. A Stripe gerencia automaticamente o tempo de inatividade da HMRC e faz novas tentativas.

### Outros tipos de ID fiscal

Para todos os outros tipos de ID fiscal, a Stripe verifica apenas o formato. Uma verificação de formato não confirma se o ID fiscal existe em um banco de dados do governo.

### Testar verificação de ID fiscal do cliente

Use estes IDs fiscais mágicos para acionar determinadas condições de verificação em [áreas restritas](https://docs.stripe.com/sandboxes.md). O tipo de ID fiscal deve ser o Australian Business Number (ABN), o número de IVA da UE ou o número de IVA do Reino Unido (GB VAT).

| Número | Tipo |
| --- | --- |
| `000000000` | Verificação bem-sucedida |
| `111111111` | Verificação malsucedida |
| `222222222` | A verificação permanece pendente indefinidamente |

### Webhooks de validação e exibição do Dashboard

A Stripe envia um evento quando a verificação é concluída para um ID fiscal salvo em qualquer um destes objetos:

- Para um [Cliente](https://docs.stripe.com/api/customers/object.md), monitore o evento de snapshot [customer.tax_id.updated](https://docs.stripe.com/api/events/types.md#event_types-customer.tax_id.updated). Inspecione [data.object.verification.status](https://docs.stripe.com/api/tax_ids/object.md#tax_id_object-verification-status) no evento.
- Para uma [conta configurada pelo cliente](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-configuration-customer), monitore o evento thin [v1.customer.tax_id.updated](https://docs.stripe.com/api/v2/core/events/event-types.md?api-version=preview#v2_event_types-v1.customer.tax_id.updated). Recupere o ID fiscal referenciado por `related_object` e inspecione o [verification.status](https://docs.stripe.com/api/tax_ids/object.md#tax_id_object-verification-status).

O status é `pending`, `verified`, `unverified` ou `unavailable`.

A Stripe relata o resultado da verificação, e você é responsável por determinar como lidar com um ID fiscal `unverified`, com base em seus próprios requisitos de conformidade. Quando a validação automática está `unavailable`, você deve verificar manualmente o ID fiscal.

Se você usa o Stripe Tax, o Stripe Tax aplica a cobrança reversa ou alíquota zero de acordo com a legislação em vigor quando o ID fiscal tem o formato numérico obrigatório, independentemente do resultado da verificação do governo.
![Dica de ferramenta fiscal no Dashboard](https://b.stripecdn.com/docs-statics-srv/assets/validation-tooltip.de17a6f286a786e5643e39f43c02a42e.png)

Passe o cursor do mouse sobre o número de IVA da UE do cliente para exibir as informações da VIES.

O Dashboard exibe os resultados da validação dentro dos dados do cliente, inclusive informações retornadas dos bancos de dados governamentais, o nome e o endereço registrados.

## Gerenciamento

Você pode gerenciar IDs fiscais no Dashboard, com o [portal do cliente](https://docs.stripe.com/customer-management.md) ou a [API Tax ID](https://docs.stripe.com/api/customer_tax_ids.md).

#### Dashboard

Para adicionar um ID fiscal:

1. Acesse a página [Clientes](https://dashboard.stripe.com/customers) e selecione o cliente aplicável.
2. Clique no ícone de lápis ao lado de **Detalhes** à direita.
3. Role até os campos **Status fiscal** e **ID fiscal**.
4. Clique em **Adicionar outro ID** para adicionar uma linha à lista de IDs fiscais, onde é possível selecionar o tipo e o valor do ID.

#### API

O exemplo a seguir mostra como [criar um ID fiscal](https://docs.stripe.com/api/tax_ids/create.md) em um cliente e armazenar o número do IVA:

> Para atualizar um ID fiscal, exclua o ID antigo e crie outro.

#### Accounts v2

```curl
curl https://api.stripe.com/v1/tax_ids \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d type=eu_vat \
  -d value=DE123456789 \
  -d "owner[type]=customer" \
  -d "owner[customer_account]={{CUSTOMERACCOUNT_ID}}"
```

#### Customers v1

```curl
curl https://api.stripe.com/v1/tax_ids \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d type=eu_vat \
  -d value=DE123456789 \
  -d "owner[type]=customer" \
  -d "owner[customer]={{CUSTOMER_ID}}"
```

Para [excluir um ID fiscal](https://docs.stripe.com/api/tax_ids/delete.md):

```curl
curl -X DELETE https://api.stripe.com/v1/tax_ids/{{TAXID_ID}} \
  -u "<<YOUR_SECRET_KEY>>:"
```
