GravamenexAPI
Obtener API key
Firmados con HMAC SHA-256

Webhooks & eventos

Disponible

Registras una URL por consumidor y recibes eventos cuando un documento cambia de estado o se genera un artefacto. Cada envío lleva firma y timestamp para verificar origen e integridad.

Tipos de evento
EventoCuándo
document.acceptedDIAN validó el documento; CUFE definitivo disponible
document.rejectedRechazo con lista de reglas
document.manual_reviewSin respuesta concluyente; requiere conciliación
document.artifactXML, PDF o AttachedDocument disponible
Verificar la firma
X-Gravamenex-Signature: t=1738850530,v1=9e8bf28a8d11ca726f1c4dfa8…
X-Gravamenex-Event: document.accepted

expected = HMAC_SHA256(secret, `${t}.${event_id}.${rawBody}`)
valid = timingSafeEqual(expected, v1) && now - t < 300s
Entrega
  • Reintentos con backoff exponencial hasta 24 h.
  • Reenvío manual desde el portal sin reemitir a la DIAN.
  • Un secreto por consumidor, rotación desde el perfil.
  • Respuesta 2xx en menos de 5 s para considerar entregado.