GravamenexAPI
Obtener API key
OpenAPI 3.1 · v1

Referencia API REST

Disponible

Todos los recursos viven bajo /v1 y se autentican con Authorization: Bearer dfi_… . Las respuestas de error son JSON tipado con código, mensaje y regla DIAN cuando aplica.

Endpoints
MétodoRutaDescripción
POST/v1/invoicesCrear factura electrónica de venta (202)
POST/v1/credit-notesCrear nota crédito referenciando una factura aceptada
POST/v1/debit-notesCrear nota débito
GET/v1/documentsListar documentos por empresa, estado y fecha
GET/v1/documents/{id}Estado, CUFE y respuesta DIAN
GET/v1/documents/{id}/artifactsXML firmado, PDF y AttachedDocument
GET/v1/documents/{id}/auditIntentos de transmisión y latencias
POST/v1/documents/{id}/retryReintentar sin duplicar CUFE
POST/v1/documents/{id}/resend-emailReenviar correo al comprador
POST/v1/documents/{id}/pdfRegenerar PDF con la plantilla activa
GET/POST/v1/pdf-templatesPlantillas HTML por empresa
GET/POST/v1/email-templatesPlantillas de correo por empresa
GET/v1/billing-profilesPerfiles fiscales autorizados para la key
GET/v1/usage/summaryConsumo del periodo: facturas, notas, webhooks
Error 422 tipado
{
  "error": {
    "code": "DIAN_REJECTION_422",
    "rule_code": "FAD09",
    "message": "Diferencia en cálculo de totales vs sumatoria de líneas",
    "documentation_url": "https://docs.gravamenex.co/dian-errors#FAD09"
  }
}