Saltar al contenido principal
OrigoID nunca devuelve errores opacos. Cada error incluye:
  • Un código type estable que no cambia entre versiones
  • Un message humano describiendo qué pasó
  • Una ruta accionable hacia la solución

​
Tipos comunes de error

​
Códigos de resultado específicos por endpoint

Cada endpoint puede devolver códigos type adicionales que representan resultados de negocio válidos (no errores per se). Por ejemplo:
  • Endpoints CURP pueden devolver CURP_NOT_FOUND, CURP_APOCRYPHAL, CURP_DECEASED
  • Endpoints SAT pueden devolver CFDI_CANCELED, TAX_PROFILE_NOT_FOUND
  • Endpoints Voter ID pueden devolver INE_NOT_FOUND, INE_NOT_VALID
  • Endpoints biométricos pueden devolver FACE_MISMATCH, MASK_ATTACK
La lista completa de códigos type para cada endpoint está documentada en su página de la referencia API. Maneja los resultados de negocio según tu lógica de dominio.

​
Códigos de validación

Cuando type es INVALID_REQUEST, el array errors[] lista los fallos a nivel campo (ver ErrorDetail). Cada entrada tiene un code sobre el que puedes branchear. Estos códigos son transversales — pueden aparecer en cualquier endpoint cuando la validación correspondiente falla:

​
Códigos específicos de endpoint

Algunos endpoints agregan códigos adicionales que capturan validación de dominio. Por ejemplo:
  • INVALID_RFC_FORMAT (/mex/fiscal/v1/rfc-validations, búsquedas SAT 69 / 69-B)
  • NAME_TOO_SHORT, NAME_ONLY_STOPWORDS (búsquedas SAT 69 / 69-B)
  • QR_NOT_FOUND (/mex/fiscal/v1/csf-extractions, /mex/fiscal/v1/cfdi-validations)
  • IMAGE_UNREADABLE (endpoints OCR)
Consulta la página de cada operación en la referencia API para la lista completa.

​
Cómo se agregan los errores

Múltiples fallos de validación de campos en un mismo request pueden venir juntos en errors[]. El tamaño del array depende del tipo de validación que falló:
  • Los fallos de validación de estructura del request (campos requeridos faltantes, tipos incorrectos, patterns malos, mismatches de enum / length / range) se agregan — todas las violaciones de este tipo regresan en una sola respuesta.
  • Los fallos detectados por checks de dominio (ej. INVALID_RFC_FORMAT, NAME_TOO_SHORT, QR_NOT_FOUND) pueden devolver sólo el primer error encontrado, aunque otros campos también hubieran fallado.
Siempre itera errors[] en lugar de asumir una sola entrada. Si tu código recibe un error, lo corrige y reenvía, la siguiente respuesta puede mostrar errores adicionales que estaban latentes.

​
Reportar un problema

Si encuentras un error inesperado, escribe a support@origoid.com con:
  • El transactionId de la respuesta
  • Breve descripción de qué intentabas hacer
  • El endpoint que llamaste
No almacenamos request bodies ni response bodies, por lo que no podemos recuperar tu llamada automáticamente. Cuando reportes, incluye el transactionId y el path que llamaste, y trabajaremos contigo en los siguientes pasos.