Saltar al contenido principal

GET /v1/invoices/{docId}/status

Consulta el estado de un envío. Útil para clientes que no pueden recibir webhooks.

curl https://sandbox.api.erply.pro/v1/invoices/$DOC_ID/status \
-H "Authorization: Bearer $TOKEN"

Respuesta

{
"docId": "01HW9X4G…",
"trackId": "20260501-DGII-9988",
"status": "accepted",
"dgii": {
"approvedAt": "2026-05-01T17:42:11Z",
"trackId": "20260501-DGII-9988"
}
}

Estados posibles

statusDescripción
pendingEn cola o esperando ACK DGII.
acceptedDGII aceptó.
rejectedRechazo (consulta dgii.code).

Errores posibles

HTTPSlug
401unauthorised
404https://errors.api.erply.pro/not-found

Polling vs webhook

  • Webhook (recomendado): ERPly Pro te llama tan pronto DGII responde — no polleas.
  • Polling: llama cada 30 s; los plans Free permiten ≤ 120 polls/h por tenant.