Errores de Identidad
Códigos de error específicos del módulo de Validación de Identidad (/v1/dgii/document/* y /v1/dgii/registry/*).
Errores de validación
invalid-document-format
| Campo | Valor |
|---|---|
| HTTP | 400 |
type | https://api.erply.pro/errors/invalid-document-format |
El parámetro document no es un RNC (9 u 11 dígitos) ni una Cédula válida. Verifique que no incluya caracteres no numéricos (excepto guiones en Cédula).
Solución: Use solo dígitos. Para Cédula puede incluir guiones: 001-0000001-1.
query-too-short
| Campo | Valor |
|---|---|
| HTTP | 400 |
type | https://api.erply.pro/errors/validation-error |
El parámetro q en búsqueda tiene menos de 3 caracteres.
Solución: Proporcione al menos 3 caracteres en el término de búsqueda.
invalid-search-field
| Campo | Valor |
|---|---|
| HTTP | 400 |
type | https://api.erply.pro/errors/validation-error |
El parámetro field no es uno de los valores permitidos.
Solución: Use name, trade_name, economic_activity o document.
Errores de recurso
document-not-found
| Campo | Valor |
|---|---|
| HTTP | 404 |
type | https://api.erply.pro/errors/document-not-found |
El RNC/Cédula no existe en el padrón DGII (o fue purgado por solicitud ARCO).
Solución: Verifique el número; si cree que es un error, consulte directamente en dgii.gov.do.
Errores de sistema
registry-stale
| Campo | Valor |
|---|---|
| HTTP | 503 |
type | https://api.erply.pro/errors/registry-stale |
El registro local tiene más de 36 horas de antigüedad. La ingest diaria puede haber fallado.
Solución: Reintente después de unos minutos. Si persiste, contacte soporte.
Patrones comunes
| Escenario | Error | Acción |
|---|---|---|
| RNC con letras | invalid-document-format | Limpie a solo dígitos |
| Búsqueda de 2 chars | query-too-short | Use al menos 3 caracteres |
| Contribuyente eliminado | document-not-found | Verifique en DGII directamente |
| Ingest fallida | registry-stale | Espere la próxima ejecución o contacte soporte |