Variantes de factura

Factura estándar

La ruta principal sigue siendo:

POST /api/ubl2.1/invoice
POST /api/ubl2.1/invoice/{testSetId}

Guía: Crear factura · Ejemplo JSON.

Sector salud

Misma ruta /invoice, con bloque health_fields (usuarios, coberturas, MIPRES).
→ Guía dedicada: Factura sector salud.

No confundir con RIPS / SISPRO.

Otras facturas

Todas requieren Bearer y, en Sandbox/habilitación, pueden usar /{testSetId}.

Tipo	Ruta
Exportación	POST /api/ubl2.1/invoice-export
Contingencia (tipo 3)	POST /api/ubl2.1/invoice-contingency
Contingencia (tipo 4)	POST /api/ubl2.1/invoice-contingency-4
Enviar pendientes tipo 4	POST /api/ubl2.1/invoice-contingency-4/send_pendings/{prefix?}/{number?}
AIU	POST /api/ubl2.1/invoice-aiu
Mandato	POST /api/ubl2.1/invoice-mandate
Transporte	POST /api/ubl2.1/invoice-transport

Cada una tiene campos adicionales (incoterms, AIU, datos de transporte, etc.). Usa los ejemplos de Postman carpeta 09 / Otros tipos.

Vista previa

POST /api/ubl2.1/invoice/preeliminar-view

Genera representación gráfica sin enviar a DIAN.

Lotes (batch)

Puedes acumular documentos y enviarlos juntos:

POST /api/ubl2.1/add-to-batch/invoice/{batch}
POST /api/ubl2.1/add-to-batch/credit-note/{batch}
POST /api/ubl2.1/add-to-batch/debit-note/{batch}
# … aiu, mandate, export, contingency
POST /api/ubl2.1/send-batch/{batch}

{batch} es un identificador que tú defines para agrupar.

Email al adquirente

POST /api/ubl2.1/send-email

Tras una emisión exitosa (o reenvío).

Consejo

Empieza siempre con la factura estándar. Solo migra a variantes cuando el caso de negocio lo exija (exportación, AIU, etc.).