$ curl -X POST https://fiscalgrid.io/api/check -H "Content-Type: application/json" -d '{"id":"500077568"}'{"ok_to_send":false,"issues":[{"code":"FOREIGN_WITHOUT_PREFIX","severity":"error"}]}$ curl -X POST https://fiscalgrid.io/api/check -H "Content-Type: application/json" -d '{"id":"PT500077568"}'{"ok_to_send":true,"issues":[{"code":"SEND_AS_IDOTRO_02","severity":"info","params":{"country":"PT","id":"PT500077568"}}]}
REGISTRO F-2027-0743 · IDDestinatario
NIF 500077568Bloqueado antes de enviar: nueve cifras sin letra no son un NIF español.
IDOtro 02 · PT · PT500077568Listo para enviar.
Qué hace
| Momento | Qué comprueba | Estado |
|---|---|---|
| Antes · Comprobar | El destinatario: NIF español (forma y dígito de control), NIF-IVA europeo en VIES y la regla de identificación: NIF o IDOtro tipo 02 con país. | DISPONIBLE |
| Durante · Vigilar | Cada respuesta de la AEAT leída y traducida a su arreglo: rechazado, aceptado con errores, duplicado. | ACCESO ANTICIPADO |
| Después · Auditar | La cadena de huellas recalculada registro a registro y los huecos localizados. | ACCESO ANTICIPADO |
Lo que puedes usar hoy
La comprobación del destinatario es pública y gratuita: POST /api/check, sin clave, con un límite de 10 consultas por minuto. Devuelve ok_to_send y una lista de códigos con su corrección.
curl -X POST https://fiscalgrid.io/api/check -H "Content-Type: application/json" -d '{"id":"500077568"}'# {"ok_to_send":false,"issues":[{"code":"FOREIGN_WITHOUT_PREFIX","severity":"error"}], ...}ok_to_send: true: va al registro tal como dice el código (SEND_AS_NIFoSEND_AS_IDOTRO_02).ok_to_send: false: no lo envíes; el código dice qué corregir.ok_to_send: null: el VIES de ese país no responde. No significa que el número no sea válido: vuelve a probar más tarde.
Todos los códigos, en Desarrolladores.
REGISTRO · F-2027-0743ES → PT
- NIF cliente
- 500077568
- !
- Enviar como
- IDOtro 02 · PT
- ✓
- Comprobado
- VIES
- ✓
Nueve cifras sin letra: no es un NIF español.
Sentinel: añade el país PT y envíalo como IDOtro 02.
Sentinel: añade el país PT y envíalo como IDOtro 02.
LISTO PARA ENVIARdemostración
Cómo se integra
- Copia el prompt para tu agente de código (Claude Code, Cursor, GitHub Copilot, Codex). Lee nuestro llms.txt.
- El agente localiza el punto donde se envía cada registro y añade la comprobación justo antes.
- Si algo no cuadra, el registro no sale. Si todo cuadra, sale igual que hoy.
MCP disponible · CLI: próximamente.
Por qué un guardián y no otro emisor
Cambiar de sistema de envío a pocos meses de una obligación es caro. Sentinel no te pide cambiarlo: se pone delante y detrás de lo que ya tienes. Si mañana cambias de proveedor, Sentinel sigue en su sitio.
Lo que no hace: Sentinel no envía registros a la AEAT. Para eso está Relay, en lista de espera.
La AEAT no certifica ni homologa software. Ver «Software homologado Verifactu»: lo que dice la norma.