Referencia de la API
Esta referencia se genera en tiempo de compilación a partir del esquema OpenAPI del servicio. No se escribe a mano: para corregir algo de esta sección hay que corregirlo en el esquema. Emisión de documentos electrónicos ante la DIAN (Colombia): factura, notas, documento soporte, documento equivalente P.O.S. y nómina.
Autenticación. Una sola credencial, en cabecera:
Authorization: Api-Key <prefijo>.<secreto>La entrega quien administra la plataforma y se muestra una sola vez. Alcanza los emisores de la persona a cuyo nombre se creó: lo ajeno no aparece en los listados y responde 404. No hay Bearer.
Errores. Todos comparten cuerpo: detail con el mensaje y errores con los fallos por campo cuando los hay.
Límites de peticiones. Hay un tope por credencial. Al superarlo la respuesta es 429 con la cabecera Retry-After.
Catálogos. /api/catalogos/… es de solo lectura y pide la misma llave que el resto, aunque no depende de sus emisores: son las listas oficiales de la DIAN, y sus códigos son lo que el resto de la API espera recibir.
Versión del esquema
Sección titulada «Versión del esquema»| Dato | Valor |
|---|---|
| Título | RedEDoc — API de facturación electrónica DIAN |
| Versión | 1.0.0 |
| OpenAPI | 3.0.3 |
| Generada | 2026-09-21 |
Credenciales
Sección titulada «Credenciales»- LlaveApi — Llave de API de una integración. El valor completo es
Api-Key <prefijo>.<secreto>, tal como lo imprimemanage.py crear_llave_api. La llave alcanza exactamente los mismos emisores que la persona a cuyo nombre se creó.
Operaciones
Sección titulada «Operaciones»catalogos
Sección titulada «catalogos»GET /api/catalogos/departamento/—GET /api/catalogos/departamento/{id}/—GET /api/catalogos/forma-pago/—GET /api/catalogos/forma-pago/{id}/—GET /api/catalogos/medio-pago/—GET /api/catalogos/medio-pago/{id}/—GET /api/catalogos/moneda/—GET /api/catalogos/moneda/{id}/—GET /api/catalogos/municipio/—GET /api/catalogos/municipio/{id}/—GET /api/catalogos/pais/—GET /api/catalogos/pais/{id}/—GET /api/catalogos/periodo-nomina/—GET /api/catalogos/periodo-nomina/{id}/—GET /api/catalogos/responsabilidad-fiscal/—GET /api/catalogos/responsabilidad-fiscal/{id}/—GET /api/catalogos/subtipo-trabajador/—GET /api/catalogos/subtipo-trabajador/{id}/—GET /api/catalogos/tipo-contrato/—GET /api/catalogos/tipo-contrato/{id}/—GET /api/catalogos/tipo-factura/—GET /api/catalogos/tipo-factura/{id}/—GET /api/catalogos/tipo-identificacion/—GET /api/catalogos/tipo-identificacion/{id}/—GET /api/catalogos/tipo-organizacion/—GET /api/catalogos/tipo-organizacion/{id}/—GET /api/catalogos/tipo-trabajador/—GET /api/catalogos/tipo-trabajador/{id}/—GET /api/catalogos/tributo/—GET /api/catalogos/tributo/{id}/—GET /api/catalogos/unidad-medida/—GET /api/catalogos/unidad-medida/{id}/—
documentos
Sección titulada «documentos»GET /api/documentos/documento/—POST /api/documentos/documento/—GET /api/documentos/documento-evento/—GET /api/documentos/documento-evento/{id}/—GET /api/documentos/documento/{id}/—DELETE /api/documentos/documento/{id}/—GET /api/documentos/documento/{id}/attached/—GET /api/documentos/documento/{id}/consultar/—POST /api/documentos/documento/{id}/emitir/—POST /api/documentos/documento/{id}/notificar/—GET /api/documentos/documento/{id}/pdf/—GET /api/documentos/documento/{id}/xml/—
emisores
Sección titulada «emisores»GET /api/emisores/certificado/—GET /api/emisores/certificado/{id}/—DELETE /api/emisores/certificado/{id}/—POST /api/emisores/certificado/cargar/—GET /api/emisores/emisor/—POST /api/emisores/emisor/—GET /api/emisores/emisor/{id}/—PUT /api/emisores/emisor/{id}/—PATCH /api/emisores/emisor/{id}/—DELETE /api/emisores/emisor/{id}/—GET /api/emisores/emisor/validar-nit/—GET /api/emisores/resolucion/—POST /api/emisores/resolucion/—GET /api/emisores/resolucion/{id}/—PUT /api/emisores/resolucion/{id}/—PATCH /api/emisores/resolucion/{id}/—DELETE /api/emisores/resolucion/{id}/—POST /api/emisores/resolucion/{id}/crear-documento-prueba/—GET /api/emisores/resolucion/consulta-dian/—POST /api/emisores/resolucion/importar-dian/—GET /api/emisores/software/—POST /api/emisores/software/—GET /api/emisores/software/{id}/—PUT /api/emisores/software/{id}/—PATCH /api/emisores/software/{id}/—DELETE /api/emisores/software/{id}/—POST /api/emisores/software/{id}/crear-nomina-prueba/—POST /api/emisores/software/{id}/crear-nota-ajuste-prueba/—GET /api/emisores/webhook/—POST /api/emisores/webhook/—GET /api/emisores/webhook/{id}/—PUT /api/emisores/webhook/{id}/—PATCH /api/emisores/webhook/{id}/—DELETE /api/emisores/webhook/{id}/—
GET /api/nomina/empleado/—POST /api/nomina/empleado/—GET /api/nomina/empleado/{id}/—PUT /api/nomina/empleado/{id}/—PATCH /api/nomina/empleado/{id}/—DELETE /api/nomina/empleado/{id}/—GET /api/nomina/nomina/—POST /api/nomina/nomina/—GET /api/nomina/nomina-evento/—GET /api/nomina/nomina-evento/{id}/—GET /api/nomina/nomina/{id}/—DELETE /api/nomina/nomina/{id}/—GET /api/nomina/nomina/{id}/consultar/—POST /api/nomina/nomina/{id}/emitir/—GET /api/nomina/nomina/{id}/xml/—
RedEDoc es un servicio de Semántica Digital S.A.S.