Generación Factura Electrónica
POST
/arqOrchestratorController/v1/process-invoice
TransmisiónFactura ElectronicaFENDNCNota CréditoNota Débito
Última modificación:2026-09-16 15:03:34
partir de una estructura JSON genérica. Si la DIAN acepta el documento, se envía la
representación gráfica (PDF) por correo al cliente.
x-api-key y el x-company-id de la compañía en los headers.El endpoint responde HTTP 200 en todos los casos de negocio y el resultado real viaja en
el cuerpo (ResultCode= 200 / 401 / 500 eIsValid). Solo un error no controlado devuelve
HTTP 500.
Método y ruta
POST /arqOrchestratorController/v1/process-invoiceHeaders
| Header | Tipo | Requerido | Descripción |
|---|---|---|---|
x-api-key | string | Sí | Clave de acceso (API Key) de tu compañía. |
x-company-id | integer | Sí | Identificador de la compañía emisora. |
Content-Type | string | Sí | application/json |
Cómo se infiere el tipo de documento
1.
ReasonCredit con valor → Nota Crédito2.
ReasonDebit con valor → Nota Débito3.
Respuesta
| Campo | Tipo | Descripción |
|---|---|---|
Errors | array<string> | Errores o motivos de rechazo de la DIAN. |
IsValid | boolean | true si la DIAN aceptó el documento. |
ResultCode | integer | Código de resultado (ver tabla). |
Warning | array<string> | Notificaciones no bloqueantes de la DIAN. |
ResultData | string | Mensaje descriptivo del resultado. |
Códigos de resultado
| ResultCode | HTTP | IsValid | Significado |
|---|---|---|---|
| 200 | 200 | true | Documento aceptado por la DIAN. |
| 200 | 200 | false | Documento rechazado por la DIAN (ver Errors). |
| 401 | 200 | false | Credenciales inválidas. |
| 500 | 200 / 500 | false | Error al procesar el documento. |
Solicitud
Parámetros de Header
Parámetros del Body application/jsonRequerido
Respuestas
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
cURL
curl --location --globoff 'https://{{url_basel}}/arqOrchestratorController/v1/process-invoice' \
--header 'x-api-key: {{api_key}}' \
--header 'x-company-id: {{company_id}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"Currency": "COP",
"SeriePrefix": "NC",
"SerieNumber": "5",
"IssueDate": "2025-08-04T12:12:12",
"DueDate": "2023-07-01T12:12:12",
"DeliveryDate": "2025-07-09T12:12:12",
"CorrelationDocumentId": "",
"SerieExternalKey": "",
"ReasonCredit": "5",
"OperationType": "20",
"IssuerParty": {
"Identification": {
"DocumentNumber": "211",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "string"
}
},
"PaymentMeans": [
{
"Code": "20",
"Mean": "1",
"DueDate": "2023-07-01"
}
],
"CustomerParty": {
"LegalType": "Legal",
"Email": "ejemplo@gmail.co",
"Identification": {
"DocumentNumber": "222222222222",
"DocumentType": "CC",
"CountryCode": "CO",
"CheckDigit": ""
},
"Name": "OFUS NAME Pyme pr"
},
"Lines": [
{
"Number": "1",
"Quantity": "1",
"QuantityUnitOfMeasure": "NAR",
"TaxSubTotals": [
{
"TaxCategory": "01",
"TaxPercentage": "19.00",
"TaxableAmount": "115000.00",
"TaxAmount": "21850.00"
}
],
"TaxTotals": [
{
"TaxCategory": "01",
"TaxAmount": "21850.00"
}
],
"UnitPrice": "115000.00",
"GrossAmount": "115000.00",
"NetAmount": "115000.00",
"Item": {
"Gtin": "987654321",
"Description": "Descripcion del producto o servicio"
}
}
],
"TaxSubTotals": [
{
"TaxCategory": "01",
"TaxPercentage": "19.00",
"TaxableAmount": "115000.00",
"TaxAmount": "21850.00"
}
],
"TaxTotals": [
{
"TaxCategory": "01",
"TaxAmount": "21850.00"
}
],
"Total": {
"GrossAmount": "115000.00",
"TotalBillableAmount": "136850.00",
"PayableAmount": "136850.00",
"TaxableAmount": "115000.00"
},
"DocumentReferences": [
{
"DocumentReferred": "SETT56670",
"IssueDate": "2026-08-04T12:12:12",
"Type": "InvoiceReference",
"DocumentReferredCUFE": "f3dd38185c886bd3b95ef1aa1186ec0e90e761549aa5f955c743fb58f07d6f93c90b1cf68d9a463e46b699aab5aad4b7"
}
]
}'Respuesta Ejemplo de Respuesta
Ejemplo Procesamiento Exitoso
{
"Errors": [],
"IsValid": true,
"ResultCode": 200,
"Warning": [],
"ResultData": "Procesado Correctamente."
}Modificado en 2026-09-16 15:03:34