Primer documento
Objetivo
Sección titulada «Objetivo»Enviar una factura de una línea con IVA 19% y recibir respuesta DIAN + CUFE.
Tip: En Sandbox usa el endpoint con
{testSetId}hasta completar la habilitación DIAN.
Request
Sección titulada «Request»POST /api/ubl2.1/invoiceContent-Type: application/jsonAuthorization: Bearer <token_de_acceso>Accept: application/jsonBase URL según ambiente:
| Ambiente | Ejemplo |
|---|---|
| Sandbox | https://sandbox-api.gridbilling.gridsoft.co/api/ubl2.1/invoice/{testSetId} |
| Producción | https://api.gridbilling.gridsoft.co/api/ubl2.1/invoice |
Body mínimo
Sección titulada «Body mínimo»Descarga: invoice-ubl21.example.json
| Campo | Significado |
|---|---|
number / prefix / resolution_number | Consecutivo y resolución |
type_document_id: 1 | Factura de venta |
customer | Adquiriente |
invoice_lines | Ítems |
legal_monetary_totals | Totales |
tax_totals | IVA |
| Modo | URL | Notas |
|---|---|---|
| Set de pruebas | /api/ubl2.1/invoice/{testSetId} | Habilitación DIAN (Sandbox) |
| Síncrono | /api/ubl2.1/invoice | Validación inmediata (Producción) |
Siguiente
Sección titulada «Siguiente»- Crear factura — guía del endpoint
- Ejemplo JSON — campos explicados
- Consultar estado — si el envío fue asíncrono