{"openapi":"3.1.0","info":{"title":"Facturación Electrónica DIAN — Damaju","version":"1.0.0","description":"API de facturación electrónica para Colombia conforme al Anexo Técnico v1.9, Resolución DIAN 000085/2022. Genera, firma (XAdES-EPES) y transmite documentos UBL 2.1 a la DIAN.","contact":{"name":"Damaju","url":"https://damaju.com.co","email":"soporte@damaju.com.co"}},"servers":[{"url":"https://fe.damaju.com.co","description":"Producción"}],"security":[{"ApiKeyAuth":[],"ApiSecretAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"},"ApiSecretAuth":{"type":"apiKey","in":"header","name":"X-API-Secret"}}},"paths":{"/health":{"get":{"summary":"Health check básico","tags":["Health"],"security":[],"responses":{"200":{"description":"Servicio activo"}}}},"/ready":{"get":{"summary":"Readiness check (DB + Redis)","tags":["Health"],"security":[],"responses":{"200":{"description":"Todos los servicios listos"}}}},"/v1/invoices":{"post":{"summary":"Crear factura electrónica","tags":["Facturas"],"description":"Valida, construye UBL 2.1, firma XAdES-EPES, comprime ZIP y envía a DIAN vía SendBillAsync/SendTestSetAsync. Procesamiento asíncrono vía BullMQ.","responses":{"201":{"description":"Factura encolada"},"400":{"description":"Error de validación"}}}},"/v1/credit-notes":{"post":{"summary":"Crear nota crédito electrónica","tags":["Notas"],"responses":{"201":{"description":"Nota crédito encolada"}}}},"/v1/debit-notes":{"post":{"summary":"Crear nota débito electrónica","tags":["Notas"],"responses":{"201":{"description":"Nota débito encolada"}}}},"/v1/documents/{id}":{"get":{"summary":"Consultar documento por ID","tags":["Documentos"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Datos del documento"},"404":{"description":"No encontrado"}}}},"/v1/documents/{id}/xml":{"get":{"summary":"Descargar XML firmado","tags":["Documentos"],"responses":{"200":{"description":"XML UBL 2.1 con firma XAdES-EPES"}}}},"/v1/documents/{id}/pdf":{"get":{"summary":"Descargar PDF representación gráfica","tags":["Documentos"],"responses":{"200":{"description":"PDF generado con Puppeteer"}}}},"/v1/dian/status/{trackId}":{"get":{"summary":"Consultar estado en DIAN por TrackId","tags":["DIAN"],"parameters":[{"name":"trackId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Estado DIAN"}}}},"/v1/dian/numbering-range/sync":{"post":{"summary":"Sincronizar resoluciones desde DIAN (GetNumberingRange)","tags":["DIAN"],"responses":{"200":{"description":"Resoluciones sincronizadas"}}}},"/v1/webhooks/order-paid":{"post":{"summary":"Webhook: orden pagada → crear factura","tags":["Webhooks"],"responses":{"201":{"description":"Factura encolada"}}}},"/v1/webhooks/order-cancelled":{"post":{"summary":"Webhook: orden cancelada → crear nota crédito","tags":["Webhooks"],"responses":{"201":{"description":"Nota crédito encolada"}}}},"/v1/webhooks/return-accepted":{"post":{"summary":"Webhook: devolución aceptada → crear nota crédito","tags":["Webhooks"],"responses":{"201":{"description":"Nota crédito encolada"}}}}}}