Facturación
POST
Historial de envíos de una factura
POST /api/invoicing/list-invoice-transmissions
Descripción
Devuelve el historial paginado de los intentos de envío de una factura electrónica para su validación fiscal.
Detalles
Retorna cada intento de envío de una factura electrónica, del más reciente al más antiguo, con su estado, su fecha y el mensaje de respuesta recibido. Sirve como referencia para dar seguimiento a un documento o resolver un problema con su validación. Un documento sin envíos previos devuelve un historial vacío.
Permisos requeridos
cash.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| invoiceUuid | string | Sí |
max:36
|
Paginación
| defaultLimit | 20 |
| maxLimit | 100 |
| allowedSorts | createdAt, id |
| defaultSort | createdAt |
| defaultDir | desc |
Ejemplo de request
curl -X POST https://app.restofy.co/api/invoicing/list-invoice-transmissions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"invoiceUuid": "string"
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
{
"invoiceUuid": "a946c8a8-7eb3-11f1-ac02-f2368af4d8ac"
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"transmissions": [
{
"id": 3,
"status": "transmitted",
"responseCode": "00",
"responseMessage": "Documento en proceso de validación (proveedor de pruebas)",
"providerCode": "pruebas",
"requestBody": "{\"documentTypeCode\":\"doc.co.invoice.electronic\",\"documentKind\":\"invoice\",\"prefix\":\"SETPC\",\"number\":1,\"resolutionNumber\":\"18760000001\",\"issueDate\":\"2026-07-15T13:19:33.000Z\",\"orderCode\":\"45F-X67\",\"recipient\":{\"name\":null,\"documentTypeCode\":null,\"documentNumber\":null,\"organizationTypeCode\":null,\"taxRegimeCode\":null,\"fiscalAddress\":null,\"email\":null},\"lines\":[{\"description\":\"Cazuela de Mariscos\",\"quantity\":1,\"unitPriceCents\":2300000,\"baseCents\":1652879,\"taxCents\":647121,\"priceCents\":2300000,\"productCode\":\"9\",\"taxes\":[{\"taxId\":3,\"taxName\":\"INC 8%\",\"taxAuthority\":\"DIAN\",\"rateBasisPoints\":800,\"taxableAmountCents\":2129630,\"taxAmountCents\":170370},{\"taxId\":1,\"taxName\":\"IVA 19%\",\"taxAuthority\":\"DIAN\",\"rateBasisPoints\":1900,\"taxableAmountCents\":1932773,\"taxAmountCents\":367227},{\"taxId\":2,\"taxName\":\"IVA 5%\",\"taxAuthority\":\"DIAN\",\"rateBasisPoints\":500,\"taxableAmountCents\":2190476,\"taxAmountCents\":109524}]},{\"description\":\"Cazuela de Mariscos\",\"quantity\":1,\"unitPriceCents\":2300000,\"baseCents\":1652879,\"taxCents\":647121,\"priceCents\":2300000,\"productCode\":\"10\",\"taxes\":[{\"taxId\":3,\"taxName\":\"INC 8%\",\"taxAuthority\":\"DIAN\",\"rateBasisPoints\":800,\"taxableAmountCents\":2129630,\"taxAmountCents\":170370},{\"taxId\":1,\"taxName\":\"IVA 19%\",\"taxAuthority\":\"DIAN\",\"rateBasisPoints\":1900,\"taxableAmountCents\":1932773,\"taxAmountCents\":367227},{\"taxId\":2,\"taxName\":\"IVA 5%\",\"taxAuthority\":\"DIAN\",\"rateBasisPoints\":500,\"taxableAmountCents\":2190476,\"taxAmountCents\":109524}]}],\"payments\":[{\"typeCode\":\"cash\",\"amountCents\":4600000}],\"totals\":{\"baseCents\":3305758,\"discountCents\":0,\"taxCents\":1294242,\"priceCents\":4600000,\"tipCents\":0,\"deliveryCents\":0,\"grandTotalCents\":4600000}}",
"responseBody": "{\"status\":\"transmitted\",\"cufe\":null,\"externalUrl\":null,\"metadata\":null,\"providerReference\":\"SBX:1784121573\",\"responseCode\":\"00\",\"responseMessage\":\"Documento en proceso de validación (proveedor de pruebas)\",\"requestBody\":\"{\\\"documentTypeCode\\\":\\\"doc.co.invoice.electronic\\\",\\\"documentKind\\\":\\\"invoice\\\",\\\"prefix\\\":\\\"SETPC\\\",\\\"number\\\":1,\\\"resolutionNumber\\\":\\\"18760000001\\\",\\\"issueDate\\\":\\\"2026-07-15T13:19:33.000Z\\\",\\\"orderCode\\\":\\\"45F-X67\\\",\\\"recipient\\\":{\\\"name\\\":null,\\\"documentTypeCode\\\":null,\\\"documentNumber\\\":null,\\\"organizationTypeCode\\\":null,\\\"taxRegimeCode\\\":null,\\\"fiscalAddress\\\":null,\\\"email\\\":null},\\\"lines\\\":[{\\\"description\\\":\\\"Cazuela de Mariscos\\\",\\\"quantity\\\":1,\\\"unitPriceCents\\\":2300000,\\\"baseCents\\\":1652879,\\\"taxCents\\\":647121,\\\"priceCents\\\":2300000,\\\"productCode\\\":\\\"9\\\",\\\"taxes\\\":[{\\\"taxId\\\":3,\\\"taxName\\\":\\\"INC 8%\\\",\\\"taxAuthority\\\":\\\"DIAN\\\",\\\"rateBasisPoints\\\":800,\\\"taxableAmountCents\\\":2129630,\\\"taxAmountCents\\\":170370},{\\\"taxId\\\":1,\\\"taxName\\\":\\\"IVA 19%\\\",\\\"taxAuthority\\\":\\\"DIAN\\\",\\\"rateBasisPoints\\\":1900,\\\"taxableAmountCents\\\":1932773,\\\"taxAmountCents\\\":367227},{\\\"taxId\\\":2,\\\"taxName\\\":\\\"IVA 5%\\\",\\\"taxAuthority\\\":\\\"DIAN\\\",\\\"rateBasisPoints\\\":500,\\\"taxableAmountCents\\\":2190476,\\\"taxAmountCents\\\":109524}]},{\\\"description\\\":\\\"Cazuela de Mariscos\\\",\\\"quantity\\\":1,\\\"unitPriceCents\\\":2300000,\\\"baseCents\\\":1652879,\\\"taxCents\\\":647121,\\\"priceCents\\\":2300000,\\\"productCode\\\":\\\"10\\\",\\\"taxes\\\":[{\\\"taxId\\\":3,\\\"taxName\\\":\\\"INC 8%\\\",\\\"taxAuthority\\\":\\\"DIAN\\\",\\\"rateBasisPoints\\\":800,\\\"taxableAmountCents\\\":2129630,\\\"taxAmountCents\\\":170370},{\\\"taxId\\\":1,\\\"taxName\\\":\\\"IVA 19%\\\",\\\"taxAuthority\\\":\\\"DIAN\\\",\\\"rateBasisPoints\\\":1900,\\\"taxableAmountCents\\\":1932773,\\\"taxAmountCents\\\":367227},{\\\"taxId\\\":2,\\\"taxName\\\":\\\"IVA 5%\\\",\\\"taxAuthority\\\":\\\"DIAN\\\",\\\"rateBasisPoints\\\":500,\\\"taxableAmountCents\\\":2190476,\\\"taxAmountCents\\\":109524}]}],\\\"payments\\\":[{\\\"typeCode\\\":\\\"cash\\\",\\\"amountCents\\\":4600000}],\\\"totals\\\":{\\\"baseCents\\\":3305758,\\\"discountCents\\\":0,\\\"taxCents\\\":1294242,\\\"priceCents\\\":4600000,\\\"tipCents\\\":0,\\\"deliveryCents\\\":0,\\\"grandTotalCents\\\":4600000}}\"}",
"createdAt": "2026-07-15T13:19:33.000Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"totalPages": 1,
"hasNext": false,
"hasPrev": false
}
}
}