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 público y de solo lectura: no pide credencial. Son las listas oficiales de la DIAN, y sus valores son lo que el resto de la API espera recibir. GET /api/catalogos/ las enumera, y cada campo que recibe una lleva x-catalogo (su nombre) y x-catalogo-valor (id o codigo).

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-30

Credenciales

• LlaveApi — Llave de API de una integración. El valor completo es Api-Key <prefijo>.<secreto>, tal como lo imprime manage.py crear_llave_api. La llave alcanza exactamente los mismos emisores que la persona a cuyo nombre se creó.

Operaciones

catalogos

• GET /api/catalogos/ — Listar los catálogos
• GET /api/catalogos/departamento/ — Listar departamentos
• GET /api/catalogos/departamento/{id}/ — Consultar departamento
• GET /api/catalogos/departamento/exportar/ — Exportar departamentos
• GET /api/catalogos/forma-pago/ — Listar formas de pago
• GET /api/catalogos/forma-pago/{id}/ — Consultar forma de pago
• GET /api/catalogos/forma-pago/exportar/ — Exportar formas de pago
• GET /api/catalogos/medio-pago/ — Listar medios de pago
• GET /api/catalogos/medio-pago/{id}/ — Consultar medio de pago
• GET /api/catalogos/medio-pago/exportar/ — Exportar medios de pago
• GET /api/catalogos/moneda/ — Listar monedas
• GET /api/catalogos/moneda/{id}/ — Consultar moneda
• GET /api/catalogos/moneda/exportar/ — Exportar monedas
• GET /api/catalogos/municipio/ — Listar municipios
• GET /api/catalogos/municipio/{id}/ — Consultar municipio
• GET /api/catalogos/municipio/exportar/ — Exportar municipios
• GET /api/catalogos/pais/ — Listar países
• GET /api/catalogos/pais/{id}/ — Consultar país
• GET /api/catalogos/pais/exportar/ — Exportar países
• GET /api/catalogos/periodo-nomina/ — Listar periodos de nómina
• GET /api/catalogos/periodo-nomina/{id}/ — Consultar periodo de nómina
• GET /api/catalogos/periodo-nomina/exportar/ — Exportar periodos de nómina
• GET /api/catalogos/responsabilidad-fiscal/ — Listar responsabilidades fiscales
• GET /api/catalogos/responsabilidad-fiscal/{id}/ — Consultar responsabilidad fiscal
• GET /api/catalogos/responsabilidad-fiscal/exportar/ — Exportar responsabilidades fiscales
• GET /api/catalogos/subtipo-trabajador/ — Listar subtipos de trabajador
• GET /api/catalogos/subtipo-trabajador/{id}/ — Consultar subtipo de trabajador
• GET /api/catalogos/subtipo-trabajador/exportar/ — Exportar subtipos de trabajador
• GET /api/catalogos/tipo-contrato/ — Listar tipos de contrato
• GET /api/catalogos/tipo-contrato/{id}/ — Consultar tipo de contrato
• GET /api/catalogos/tipo-contrato/exportar/ — Exportar tipos de contrato
• GET /api/catalogos/tipo-factura/ — Listar tipos de factura
• GET /api/catalogos/tipo-factura/{id}/ — Consultar tipo de factura
• GET /api/catalogos/tipo-factura/exportar/ — Exportar tipos de factura
• GET /api/catalogos/tipo-identificacion/ — Listar tipos de identificación
• GET /api/catalogos/tipo-identificacion/{id}/ — Consultar tipo de identificación
• GET /api/catalogos/tipo-identificacion/exportar/ — Exportar tipos de identificación
• GET /api/catalogos/tipo-organizacion/ — Listar tipos de organización
• GET /api/catalogos/tipo-organizacion/{id}/ — Consultar tipo de organización
• GET /api/catalogos/tipo-organizacion/exportar/ — Exportar tipos de organización
• GET /api/catalogos/tipo-trabajador/ — Listar tipos de trabajador
• GET /api/catalogos/tipo-trabajador/{id}/ — Consultar tipo de trabajador
• GET /api/catalogos/tipo-trabajador/exportar/ — Exportar tipos de trabajador
• GET /api/catalogos/tributo/ — Listar tributos
• GET /api/catalogos/tributo/{id}/ — Consultar tributo
• GET /api/catalogos/tributo/exportar/ — Exportar tributos
• GET /api/catalogos/unidad-medida/ — Listar unidades de medida
• GET /api/catalogos/unidad-medida/{id}/ — Consultar unidad de medida
• GET /api/catalogos/unidad-medida/exportar/ — Exportar unidades de medida

documentos

• GET /api/documentos/documento/ —
• POST /api/documentos/documento/ —
• GET /api/documentos/documento-evento/ —
• GET /api/documentos/documento-evento/{id}/ —
• GET /api/documentos/documento-notificacion/ —
• GET /api/documentos/documento-notificacion/{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/ —
• POST /api/documentos/documento/{id}/respuesta-validado/ —
• GET /api/documentos/documento/{id}/xml/ —

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-aviso/ —
• GET /api/emisores/webhook-aviso/{id}/ —
• GET /api/emisores/webhook/{id}/ —
• PUT /api/emisores/webhook/{id}/ —
• PATCH /api/emisores/webhook/{id}/ —
• DELETE /api/emisores/webhook/{id}/ —
• POST /api/emisores/webhook/{id}/probar/ —

nomina

• 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/ —