Pruebas
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.
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: NIF españoles, validación síncrona de facturas, resultados VERI*FACTU y sus webhooks.
Consulta Recepción de eventos con webhooks para verificar firmas, gestionar reintentos y eliminar duplicados.