# Pruebas

Usa valores deterministas en Test para probar validaciones, registros fiscales y webhooks.

Cada cuenta Live tiene una cuenta Test aislada, con claves API, recursos y eventos separados. Test acepta las mismas solicitudes que Live, pero no contacta con las administraciones tributarias externas. Usa los valores siguientes para obtener resultados asíncronos deterministas sin añadir parámetros exclusivos de prueba a tu integración.

Los valores de prueba solo tienen un comportamiento especial en una cuenta Test. No los uses en Live: FiscalRail los trata como identificadores ordinarios y los registros externos pueden rechazarlos.

## Números de identificación fiscal de prueba

Un identificador fiscal puede fallar en dos momentos distintos:

| Valor enviado | Resultado de la API | Verificación | Evento |
| --- | --- | --- | --- |
| Formato local no válido | La solicitud del cliente devuelve `422 invalid_customer` | No se crea el identificador ni su verificación | Ninguno |
| Formato válido y valor válido en el registro | La solicitud devuelve `201` | Pasa de `pending` a `completed` con `valid: true` | `tax_id.verification.completed` |
| Formato válido y valor no válido en el registro | La solicitud devuelve `201` | Pasa de `pending` a `completed` con `valid: false` | `tax_id.verification.completed` |

Un resultado negativo del registro no es un fallo operativo. `tax_id.verification.failed` se reserva para una consulta que no puede completarse después de los reintentos.

### IVA intracomunitario (`eu_vat`)

Para cualquier país de la UE admitido salvo España, combina el prefijo VIES con uno de estos sufijos:

| Resultado | Valor |
| --- | --- |
| Formato válido; VIES `valid: true` | `<prefijo>000000000` |
| Formato válido; VIES `valid: false` | `<prefijo>000000001` |
| Rechazo inmediato por formato no válido | `<prefijo>!` |

Normalmente el prefijo coincide con `country`: por ejemplo, usa `country: "PT"` con `PT000000000` o `PT000000001`. Grecia es la excepción: usa `country: "GR"` con el prefijo `EL`, como `EL000000001`.

España aplica las reglas de control del NIF antes de consultar VIES. Usa los valores de [Pruebas del régimen de España](/es/tax-regimes/spain/testing).

### Identificadores locales (`local`)

Los identificadores locales nunca se verifican contra un registro. En cualquier país, `TEST-VALID` supera la comprobación básica de formato e `INVALID VALUE!` se rechaza de inmediato. Este tipo no tiene valores para simular resultados registrales.

## Prueba los webhooks

Crea el cliente en la cuenta Test, conserva el ID del identificador fiscal devuelto y suscribe un destino Test a `tax_id.verification.completed`. La verificación es asíncrona: la respuesta de creación normalmente contiene `verification.status: "pending"`; recupera `/v1/tax_ids/{id}` o procesa el evento para observar el valor final.

Las validaciones y resultados específicos de cada régimen están en su propia guía:

- [Pruebas del régimen de España](/es/tax-regimes/spain/testing): NIF españoles, validación síncrona de facturas, resultados VERI*FACTU y sus webhooks.

Consulta [Recepción de eventos con webhooks](/es/webhooks) para verificar firmas, gestionar reintentos y eliminar duplicados.
