API DIAN — Facturación Electrónica
REST API para emisión, consulta y gestión de documentos electrónicos ante la DIAN.
Autenticación Bearer Token (Sanctum) con scopes por recurso.
Header requerido: Authorization: Bearer {token}.
Base URL
http://biaifeb.ggiab.com/api/v1
Sistema
GET
/api/v1/health
Health check
público
GET
/api/v1/scopes
Listar scopes disponibles
público
GET
/api/v1/webhook-events
Listar eventos de webhook disponibles
público
Lookups públicos
GET
/api/v1/lookup/cufe/{cufe}
Verificar CUFE en la DIAN
público
GET
/api/v1/lookup/nit/{nit}
Calcular dígito de verificación NIT
público
Catálogos DIAN
GET
/api/v1/catalogs
Listar todos los catálogos
público
GET
/api/v1/catalogs/{type}
Catálogo por tipo
público
Facturas electrónicas
POST
/api/v1/invoices
Factura estándar
invoices:createidempotent
POST
/api/v1/invoices/validate
Validar payload sin emitir
invoices:create
POST
/api/v1/invoices/health
Factura de salud (FES)
invoices:createidempotent
POST
/api/v1/invoices/aiu
Factura AIU
invoices:createidempotent
POST
/api/v1/invoices/export
Factura de exportación
invoices:createidempotent
POST
/api/v1/invoices/contingency
Factura por contingencia
invoices:createidempotent
POST
/api/v1/invoices/mandate
Factura por mandato
invoices:createidempotent
POST
/api/v1/invoices/transport
Factura de transporte
invoices:createidempotent
POST
/api/v1/invoices/hotel
Factura hotelera
invoices:createidempotent
POST
/api/v1/invoices/exchange
Factura de cambio
invoices:createidempotent
POST
/api/v1/credit-notes
Nota crédito
invoices:createidempotent
POST
/api/v1/debit-notes
Nota débito
invoices:createidempotent
POST
/api/v1/payrolls
Nómina electrónica
invoices:createidempotent
POST
/api/v1/support-documents
Documento soporte
invoices:createidempotent
Eventos RADIAN
POST
/api/v1/events
Emitir evento DIAN (acuse, rechazo, aval…)
events:createidempotent
Consulta de documentos
GET
/api/v1/documents
Listar documentos emitidos
invoices:read
GET
/api/v1/documents/{id}
Detalle de un documento
invoices:read
GET
/api/v1/documents/{id}/xml
XML UBL firmado
invoices:read
GET
/api/v1/documents/{id}/pdf
PDF del documento
invoices:read
POST
/api/v1/documents/{id}/email
Enviar documento por email
invoices:read
POST
/api/v1/documents/{id}/dispatch
Re-enviar a la DIAN
invoices:read
GET
/api/v1/track/{trackId}/status
Estado DIAN por trackId
status:read
Documentos recibidos (inbound)
POST
/api/v1/inbound-documents
Registrar documento de proveedor
auth · tenantidempotent
GET
/api/v1/inbound-documents
Listar documentos recibidos
auth · tenant
GET
/api/v1/inbound-documents/{id}
Detalle de documento recibido
auth · tenant
POST
/api/v1/inbound-documents/{id}/acknowledge
Acusar recibo
auth · tenantidempotent
Empresa
GET
/api/v1/company
Datos de la empresa
company:read
POST
/api/v1/verify-nit
Verificar NIT ante la DIAN
company:read
PATCH
/api/v1/company
Actualizar datos de la empresa
company:write
POST
/api/v1/company/logo
Subir logo de la empresa
company:write
DELETE
/api/v1/company/logo
Eliminar logo
company:write
Certificados digitales
GET
/api/v1/certificates
Listar certificados
certificates:manage
POST
/api/v1/certificates
Cargar certificado digital (.p12)
certificates:manage
DELETE
/api/v1/certificates/{id}
Eliminar certificado
certificates:manage
Resoluciones de numeración
GET
/api/v1/numbering-resolutions
Listar resoluciones
resolutions:manage
POST
/api/v1/numbering-resolutions
Registrar resolución
resolutions:manage
PATCH
/api/v1/numbering-resolutions/{id}
Actualizar resolución
resolutions:manage
DELETE
/api/v1/numbering-resolutions/{id}
Eliminar resolución
resolutions:manage
Tokens de acceso
GET
/api/v1/tokens
Listar tokens del usuario
auth
POST
/api/v1/tokens
Crear token con scopes
auth
DELETE
/api/v1/tokens/{id}
Revocar token
auth
Webhooks
GET
/api/v1/webhooks
Listar webhooks
auth · tenant
POST
/api/v1/webhooks
Crear webhook
auth · tenant
PATCH
/api/v1/webhooks/{id}
Actualizar webhook
auth · tenant
DELETE
/api/v1/webhooks/{id}
Eliminar webhook
auth · tenant
POST
/api/v1/webhooks/{id}/rotate-secret
Rotar secret del webhook
auth · tenant
Estadísticas y uso
GET
/api/v1/stats/dashboard
Dashboard de facturación
auth · tenant
GET
/api/v1/stats/top-suppliers
Top compradores/proveedores
auth · tenant
GET
/api/v1/usage
Consumo del plan actual
auth · tenant
Sandbox (solo desarrollo)
POST
/api/v1/sandbox/bootstrap
Inicializar empresa, resolución y certificado de prueba
authdev only