> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Números de identificación fiscal

> Da formato a los números de IVA, GST y otros números de registro fiscal para que Whop los acepte y los aplique a los impuestos.

Un número de identificación fiscal es el número de registro que una autoridad tributaria asigna a una empresa. Lo envías como un `tax_id_type`, como `eu_vat` o `gb_vat`, junto con el propio número. Envías números de identificación fiscal en dos lugares. En una cuenta, el número de identificación fiscal también registra que la empresa está dada de alta a efectos fiscales en ese país. En un presupuesto de pago, el número de identificación fiscal del comprador fija el precio de una compra empresarial. Esta página cubre el formato que espera cada tipo, lo que Whop cambia en un número que envías y lo que rechaza. Para saber quién recauda e ingresa los impuestos de las ventas en Whop, consulta [Impuestos](https://docs.whop.com/es/payments-and-billing/fees/taxes.md).

> [!NOTE]
>
> Todos los Estados miembros de la UE comparten el tipo `eu_vat`. Whop determina el país a partir de las dos primeras letras del número, así que un número de IVA de un país de la UE debe empezar por su código de país.

| | Números de identificación fiscal de la cuenta | Número de identificación fiscal del comprador |
| - | - | - |
| **Campo** | `tax_identifiers` en [Update Account](https://docs.whop.com/es/api-reference/accounts/update-account.md) | `tax_ids` en [Create Payment Quote](https://docs.whop.com/es/api-reference/payment-quotes/create-payment-quote.md) |
| **Qué hace** | Registra dónde está dada de alta la empresa a efectos fiscales. Cuando la empresa ingresa sus propios impuestos, Whop recauda impuestos fuera de EE. UU. solo en los países donde la cuenta tiene un número de identificación fiscal. La recaudación en EE. UU. sigue `tax_collection_enabled_states`. | Fija el precio de la compra como empresa a empresa cuando corresponde, como en la inversión del sujeto pasivo de la UE. |
| **Cuántos** | Uno por `tax_id_type`. | Uno por presupuesto. |
| **Formato** | `eu_vat`: se eliminan los espacios, puntos y guiones, las letras pasan a mayúsculas y un `GR` inicial se cambia por `EL`. Otros tipos: se almacenan tal como los envías. | `eu_vat`: se eliminan los espacios, puntos y guiones. Whop conserva las mayúsculas y minúsculas y el prefijo que envías. Otros tipos: se eliminan los espacios. |

## Añadir un número de identificación fiscal a una cuenta

Envía cada número de identificación fiscal como un `tax_id_type` y un `tax_id_value`. Whop almacena el `DE 123.456.789` del ejemplo como `DE123456789`.

```typescript TypeScript theme={null}
import { WhopClient } from "@whop/sdk";

const client = new WhopClient({ token: process.env.WHOP_API_KEY });

await client.accounts.update({
  id: "biz_xxxxxxxxxxxxx",
  tax_identifiers: [{ tax_id_type: "eu_vat", tax_id_value: "DE 123.456.789" }],
});
```

```python Python theme={null}
import os
from whop_sdk import Whop

client = Whop(token=os.environ["WHOP_API_KEY"])

client.accounts.update(
    "biz_xxxxxxxxxxxxx",
    tax_identifiers=[{"tax_id_type": "eu_vat", "tax_id_value": "DE 123.456.789"}],
)
```

Una cuenta tiene un número de identificación fiscal por `tax_id_type`. Enviar un tipo que la cuenta ya tiene sustituye su valor en lugar de añadir un segundo número. Todos los países de la UE comparten `eu_vat`, así que una cuenta tiene un único número de IVA para toda la UE.

## El tipo `eu_vat`

Un número `eu_vat` empieza por el código de dos letras del Estado miembro que lo emitió, seguido del número nacional.

* **Grecia usa `EL`**, no `GR`: `EL123456789`. En una cuenta, un número enviado con `GR` se almacena con `EL`. En un presupuesto de pago, envía `EL` tú mismo.
* **Irlanda del Norte usa `XI`** con el tipo `eu_vat`: `XI123456789`. En una cuenta, un número `XI` cuenta como el registro de la empresa en el Reino Unido, pero el checkout no lo usa para los impuestos del Reino Unido. Añade un número `gb_vat` para ello.
* **Se eliminan los espacios, puntos y guiones.** En una cuenta, las letras también pasan a mayúsculas, así que tanto `de 123.456.789` como `DE-123-456-789` se convierten en `DE123456789`.

Una empresa de fuera de la UE registrada en el régimen exterior de la Unión de la ventanilla única (One Stop Shop, OSS) envía su número OSS como `eu_oss_vat`, por ejemplo `EU123456789`. En una cuenta, un número `eu_oss_vat` cuenta como registro en todos los países de la UE.

En una cuenta, Whop comprueba un número `eu_vat` con el formato de su país. El número tiene que empezar por el prefijo de IVA de un Estado miembro de la UE o por `XI`, y el resto tiene que tener la longitud y los caracteres que emite ese país. Por ejemplo, un número belga es `BE` seguido de 10 dígitos que empiezan por `0` o `1`, así que `BE123456789` se rechaza. Whop no añade un prefijo que falte, porque un número `eu_vat` no indica de qué país es.

En un presupuesto de pago, Whop solo rechaza un número que no empiece por dos letras seguidas de al menos dos letras o dígitos.

Ambos endpoints responden con un `400`. En una cuenta, el error tiene un `code` que puedes comprobar:

```json theme={null}
{
  "error": {
    "type": "bad_request",
    "message": "Enter your EU VAT number with its two-letter country code, for example DE123456789.",
    "code": "eu_vat_number_invalid"
  }
}
```

En un presupuesto de pago, el mensaje es `tax_ids.value is not a valid eu_vat registration`.

## Otros tipos de identificación fiscal

Todos los demás tipos conservan la puntuación y las mayúsculas y minúsculas de su formato publicado. Un UID suizo se mantiene como `CHE-123.456.789` y un CNPJ brasileño como `12.345.678/0001-00`. Envía el número tal como lo imprime la autoridad tributaria. En un presupuesto de pago, los espacios se siguen eliminando, así que `CHE-123.456.789 MWST` se convierte en `CHE-123.456.789MWST`.

En Canadá, un número `ca_gst_hst` cuenta como registro en todas las provincias. Un número provincial, como `ca_qst` o `ca_pst_bc`, solo cuenta en su provincia, y un número de empresa `ca_bn` por sí solo no cuenta en ningún lugar.

## Ejemplos por país

Coinciden con los ejemplos que se muestran en el panel de Whop, que usa `eu_vat` para Polonia e Irlanda del Norte. La referencia de [Update Account](https://docs.whop.com/es/api-reference/accounts/update-account.md) enumera los demás valores de `tax_id_type` aceptados. Un presupuesto de pago también acepta `pl_nip` y `xi_vat`.

| País | `tax_id_type` | Ejemplo |
| - | - | - |
| Albania | `al_tin` | `J12345678N` |
| Andorra | `ad_nrt` | `A-123456-B` |
| Angola | `ao_tin` | `1234567890` |
| Argentina | `ar_cuit` | `20-12345678-9` |
| Armenia | `am_tin` | `12345678` |
| Aruba | `aw_tin` | `1234567` |
| Australia | `au_abn` | `12345678901` |
| Australia | `au_arn` | `12345678901` |
| Austria | `eu_vat` | `ATU12345678` |
| Azerbaiyán | `az_tin` | `1234567890` |
| Bahamas | `bs_tin` | `123456789` |
| Baréin | `bh_vat` | `123456789012345` |
| Bangladés | `bd_bin` | `123456789` |
| Barbados | `bb_tin` | `1234567890` |
| Bielorrusia | `by_tin` | `123456789` |
| Bélgica | `eu_vat` | `BE0123456789` |
| Benín | `bj_ifu` | `1234567890123` |
| Bolivia | `bo_tin` | `1234567` |
| Bosnia y Herzegovina | `ba_tin` | `1234567890123` |
| Brasil | `br_cnpj` | `12.345.678/0001-00` |
| Brasil | `br_cpf` | `123.456.789-00` |
| Bulgaria | `bg_uic` | `123456789` |
| Bulgaria | `eu_vat` | `BG123456789` |
| Burkina Faso | `bf_ifu` | `12345678901234` |
| Camboya | `kh_tin` | `K001-234567890` |
| Camerún | `cm_niu` | `M012345678901A` |
| Canadá | `ca_bn` | `123456789` |
| Canadá | `ca_gst_hst` | `123456789RT0001` |
| Canadá | `ca_pst_bc` | `PST-1234-5678` |
| Canadá | `ca_pst_mb` | `123456-7` |
| Canadá | `ca_pst_sk` | `1234567` |
| Canadá | `ca_qst` | `1234567890TQ1234` |
| Cabo Verde | `cv_nif` | `123456789` |
| Chile | `cl_tin` | `12.345.678-9` |
| China | `cn_tin` | `123456789012345678` |
| Colombia | `co_nit` | `123.456.789-0` |
| Costa Rica | `cr_tin` | `1-234-567890` |
| Croacia | `eu_vat` | `HR12345678901` |
| Croacia | `hr_oib` | `12345678901` |
| Chipre | `eu_vat` | `CY12345678A` |
| Chequia | `eu_vat` | `CZ12345678` |
| República Democrática del Congo | `cd_nif` | `A1234567B` |
| Dinamarca | `eu_vat` | `DK12345678` |
| República Dominicana | `do_rcn` | `123-4567890-1` |
| Ecuador | `ec_ruc` | `1234567890001` |
| Egipto | `eg_tin` | `123456789` |
| El Salvador | `sv_nit` | `0614-123456-123-4` |
| Estonia | `eu_vat` | `EE123456789` |
| Etiopía | `et_tin` | `1234567890` |
| Unión Europea (OSS exterior de la Unión) | `eu_oss_vat` | `EU123456789` |
| Finlandia | `eu_vat` | `FI12345678` |
| Francia | `eu_vat` | `FR12345678901` |
| Georgia | `ge_vat` | `123456789` |
| Alemania | `de_stn` | `12/345/67890` |
| Alemania | `eu_vat` | `DE123456789` |
| Ghana | `gh_tin` | `C0001234567` |
| Grecia | `eu_vat` | `EL123456789` |
| Guinea | `gn_nif` | `123456789` |
| Hong Kong | `hk_br` | `12345678` |
| Hungría | `eu_vat` | `HU12345678` |
| Hungría | `hu_tin` | `12345678` |
| Islandia | `is_vat` | `123456` |
| India | `in_gst` | `22AAAAA0000A1Z5` |
| Indonesia | `id_npwp` | `12.345.678.9-012.345` |
| Irlanda | `eu_vat` | `IE1234567A` |
| Israel | `il_vat` | `123456789` |
| Italia | `eu_vat` | `IT12345678901` |
| Japón | `jp_cn` | `1234-56-7890` |
| Japón | `jp_rn` | `12345` |
| Japón | `jp_trn` | `T1234567890123` |
| Kazajistán | `kz_bin` | `123456789012` |
| Kenia | `ke_pin` | `P000123456A` |
| Kirguistán | `kg_tin` | `12345678` |
| Laos | `la_tin` | `1234567890` |
| Letonia | `eu_vat` | `LV12345678901` |
| Liechtenstein | `li_uid` | `CHE-123.456.789` |
| Liechtenstein | `li_vat` | `12345` |
| Lituania | `eu_vat` | `LT123456789012` |
| Luxemburgo | `eu_vat` | `LU12345678` |
| Malasia | `my_frp` | `12345678` |
| Malasia | `my_itn` | `C1234567890` |
| Malasia | `my_sst` | `A12-3456-78901234` |
| Malta | `eu_vat` | `MT12345678` |
| Mauritania | `mr_nif` | `12345678` |
| México | `mx_rfc` | `XAXX010101000` |
| Moldavia | `md_vat` | `1234567` |
| Montenegro | `me_pib` | `12345678` |
| Marruecos | `ma_vat` | `12345678` |
| Nepal | `np_pan` | `123456789` |
| Países Bajos | `eu_vat` | `NL123456789B01` |
| Nueva Zelanda | `nz_gst` | `123456789` |
| Nigeria | `ng_tin` | `12345678-0001` |
| Macedonia del Norte | `mk_vat` | `MK1234567890123` |
| Irlanda del Norte | `eu_vat` | `XI123456789` |
| Noruega | `no_vat` | `123456789MVA` |
| Noruega | `no_voec` | `1234567` |
| Omán | `om_vat` | `OM1234567890` |
| Perú | `pe_ruc` | `12345678901` |
| Filipinas | `ph_tin` | `123-456-789-000` |
| Polonia | `eu_vat` | `PL1234567890` |
| Portugal | `eu_vat` | `PT123456789` |
| Rumanía | `eu_vat` | `RO1234567890` |
| Rumanía | `ro_tin` | `1234567890` |
| Rusia | `ru_inn` | `1234567890` |
| Rusia | `ru_kpp` | `123456789` |
| Arabia Saudí | `sa_vat` | `123456789012345` |
| Senegal | `sn_ninea` | `12345678901` |
| Serbia | `rs_pib` | `123456789` |
| Singapur | `sg_gst` | `M12345678X` |
| Singapur | `sg_uen` | `123456789A` |
| Eslovaquia | `eu_vat` | `SK1234567890` |
| Eslovenia | `eu_vat` | `SI12345678` |
| Eslovenia | `si_tin` | `12345678` |
| Sudáfrica | `za_vat` | `4123456789` |
| Corea del Sur | `kr_brn` | `123-45-67890` |
| España | `es_cif` | `A12345678` |
| España | `eu_vat` | `ESA12345678` |
| Surinam | `sr_fin` | `12345678` |
| Suecia | `eu_vat` | `SE123456789012` |
| Suiza | `ch_uid` | `CHE-123.456.789` |
| Suiza | `ch_vat` | `CHE-123.456.789 MWST` |
| Taiwán | `tw_vat` | `12345678` |
| Tayikistán | `tj_tin` | `123456789` |
| Tanzania | `tz_vat` | `12-345-6789` |
| Tailandia | `th_vat` | `1234567890123` |
| Türkiye | `tr_tin` | `1234567890` |
| Uganda | `ug_tin` | `1234567890` |
| Ucrania | `ua_vat` | `1234567890` |
| Emiratos Árabes Unidos | `ae_trn` | `123456789012345` |
| Reino Unido | `gb_vat` | `GB123456789` |
| Estados Unidos | `us_ein` | `12-3456789` |
| Uruguay | `uy_ruc` | `123456789012` |
| Uzbekistán | `uz_tin` | `123456789` |
| Uzbekistán | `uz_vat` | `123456789012` |
| Venezuela | `ve_rif` | `J-12345678-9` |
| Vietnam | `vn_tin` | `1234567890` |
| Zambia | `zm_tin` | `1234567890` |
| Zimbabue | `zw_tin` | `1234567890` |

## Próximos pasos

> [card] [Actualizar una cuenta](https://docs.whop.com/es/api-reference/accounts/update-account.md)
>
> Configura los números de identificación fiscal de una cuenta y cómo ingresa los impuestos.

> [card] [Presupuestar una compra empresarial](https://docs.whop.com/es/api-reference/payment-quotes/create-payment-quote.md)
>
> Calcula el precio de una compra con el número de identificación fiscal del comprador antes de cobrarla.


## Related topics

- [Gestionar las RFI de verificación](https://docs.whop.com/es/developer/verification/rfis.md)
- [Verifica la identidad de los usuarios con KYC](https://docs.whop.com/es/developer/verification/overview.md)
- [API de Search](https://docs.whop.com/es/api-reference/search/search.md)
