GET /v1/dgii/registry/status

Retorna el estado y frescura del registro DGII local. Útil para validar que los datos están actualizados antes de operaciones masivas.

Headers requeridos

Header	Descripción
x-api-key	API key sandbox/producción

Respuesta

200 — Estado del registro

{
  "last_ingest": "2026-05-05T04:15:00Z",
  "record_count": 762341,
  "source_etag": "\"abc123def456\"",
  "source_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "age_seconds": 57600,
  "stale": false
}

Campos de respuesta

Campo	Tipo	Descripción
last_ingest	string (ISO 8601)	Timestamp de la última ejecución exitosa
record_count	integer	Total de registros en el padrón
source_etag	string	ETag del CSV de DGII
source_sha256	string	SHA-256 del archivo descargado
age_seconds	integer	Segundos desde la última ingest exitosa
stale	boolean	true si age_seconds > 129600 (36 horas)

Ejemplo

curl -s https://api.erply.pro/v1/dgii/registry/status \
  -H "x-api-key: $ERPLYPRO_API_KEY" | jq .

Uso recomendado

Antes de ejecutar validaciones masivas (e.g., importar una cartera de clientes), consulte este endpoint. Si stale: true, considere esperar hasta la próxima ingest diaria (programada a las 04:00 UTC).

Ejemplos de código

Ver ejemplos multi-lenguaje (Python, JavaScript, C#, PHP, Go) y la colección Postman.

SLA de frescura

• Ingest diaria programada: 04:00 UTC
• Alarma de obsolescencia: se activa si age_seconds > 129600 (36h)
• Objetivo: datos ≤ 24h de antigüedad bajo operación normal