Nómina Electrónica

Consumo de servicios

POST

https://api.datainvoicecolombia.com/api/ubl2.1/payroll

"Content-Type": "application/json",
"accept": "application/json",
"Authorization": "Bearer token"

Nómina Electrónica

{
"type_document_id": 9,
  "novelty":{
      "novelty": false,
      "uuidnov": ""
  },
  "period":{
      "admision_date": "2018-10-10",
      "settlement_start_date": "2021-07-01",
      "settlement_end_date": "2021-07-31",
      "worked_time": "785.00",
      "issue_date": "2021-07-28"
  },
  "sendmail": true,
  "sendmailtome": true,
"worker_code": "41946692",
"prefix": "NI",
"consecutive": 100051,
  "payroll_period_id": 4,
  "notes": "PRUEBA DE ENVIO DE NOMINA ELECTRONICA",
"worker": {
	"type_worker_id": 1,
	"sub_type_worker_id": 1,
	"payroll_type_document_identification_id": 3,
	"municipality_id": 822,
	"type_contract_id": 1,
	"high_risk_pension": false,
	"identification_number": 41946692,
	"surname": "CARDONA",
      "second_surname": "VILLADA",
	"first_name": "ELIZABETH",
      "middle_name": null,
	"address": "BRR LIMONAR MZ 6 CS 3 ET 1",
      "integral_salarary": false,
      "salary": "1500000.00",
      "email": "somemail@somehost.com"
},
"payment": {
	"payment_method_id": 10,
	"bank_name": "BANCO DAVIVIENDA",
	"account_type": "AHORROS",
	"account_number": "126070603280"
},	
  "payment_dates": [
      {
          "payment_date": "2021-03-10"
      }
  ],    
"accrued": {
	"worked_days": 30,
	"salary": "750000.00",
      "transportation_allowance": "115000.00",
      "accrued_total": "859000.00"
},
"deductions": {
	"eps_type_law_deductions_id": 1,
	"eps_deduction": "60000.00",
	"pension_type_law_deductions_id": 5,
	"pension_deduction": "60000.00",
      "deductions_total": "120000.00"
}
}

200 - Respuesta

Note

Si la factura es validada y aceptada por la DIAN, dentro de la propiedad ResponseDian se encontrará la propiedad IsValid en true, de lo contrario si esa misma propiedad es retornada en false y esto indica que hubo un error en la factura y se debe leer la propiedad ErrorMessage para obtener el error.

{
  "success": true,
  "message": "AttachedDocument #SETP990001196 generada con éxito",
  "send_email_success": true,
  "send_email_date_time": true,
  "urlinvoicexml": "FES-SETP990001196.xml",
  "urlinvoicepdf": "FES-SETP990001196.pdf",
  "urlinvoiceattached": "ad00075737720002500000152.xml",
  "cufe": "9bfe029ef9a015ab60155a78be4f70ed6f88d532de4cc661cccc99b7e35dab3faf0a7e2ed55f0c9246362830ea258412",
  "QRStr": "https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=9bfe029ef9a015ab60155a78be4f70ed6f88d532de4cc661cccc99b7e35dab3faf0a7e2ed55f0c9246362830ea258412",
  "certificate_days_left": 310,
  "resolution_days_left": 1621,
  "ResponseDian": {
      "Envelope": {
          "Header": {
              "Action": {
                  "_attributes": {
                      "mustUnderstand": "1"
                  },
                  "_value": "http://wcf.dian.colombia/IWcfDianCustomerServices/SendBillSyncResponse"
              },
              "Security": {
                  "_attributes": {
                      "mustUnderstand": "1"
                  },
                  "Timestamp": {
                      "_attributes": {
                          "Id": "_0"
                      },
                      "Created": "2025-08-12T18:01:07.516Z",
                      "Expires": "2025-08-12T18:06:07.516Z"
                  }
              }
          },
          "Body": {
              "SendBillSyncResponse": {
                  "SendBillSyncResult": {
                      "ErrorMessage": {
                          "string": "Regla: RUT01, Notificación: La validación del estado del RUT próximamente estará disponible."
                      },
                      "IsValid": "true",
                      "StatusCode": "00",
                      "StatusDescription": "Procesado Correctamente.",
                      "StatusMessage": "La Factura electrónica SETP990001196, ha sido autorizada.",
                      "XmlBase64Bytes": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiIHN0YW5jOkRvY3VtZW50UmVzcG9uc2U+DQo8L0FwcGxpY2F0aW9uUmVzcG9uc2U+",
                      "XmlBytes": {
                          "_attributes": {
                              "nil": "true"
                          }
                      },
                      "XmlDocumentKey": "9bfe029ef9a015ab60155a78be4f70ed6f88d532de4cc661cccc99b7e35dab3faf0a7e2ed55f0c9246362830ea258412",
                      "XmlFileName": "fv00075737720002500000152"
                  }
              }
          }
      }
  },
  "invoicexml": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9Im5vIj8+CjgogICAgPC9jYWM6UHJpY2U+CiAgPC9jYWM6SW52b2ljZUxpbmU+CjwvSW52b2ljZT4K",
  "zipinvoicexml": "UEsDBBQAAgAIACOgDFs+2HRL0hYAAHtOAAAdAAAAZnYwMDA3NTczNzcyMDAwMjUwMDAwMDEAAAABAAEASwAAAA0XAAAAAA==",
  "unsignedinvoicexml": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9Im5XVhbnRpdHk+CiAgICA8L2NhYzpQcmljZT4KICA8L2NhYzpJbnZvaWNlTGluZT4KPC9JbnZvaWNlPgo=",
  "reqfe": "PD94bWwgdmVyc2lvbj0iMS4wIj8+Cjxzb2FwOkVudmVsb3BlIHhtbG5zOnNvYXA9Imh0dHA6Ly93d3cudAgICAgPC93Y2Y6U2VuZEJpbGxTeW5jPgogICAgPC9zb2FwOkJvZHk+Cjwvc29hcDpFbnZlbG9wZT4K",
  "rptafe": "PHM6RW52ZWxvcGUgeG1sbnM6cz0iaHR0cDovL3d3dy53My5vcmcvMjAwMy8wNS9zb2FwLWVudmVsb3BlIiB4bWCaWxsU3luY1Jlc3BvbnNlPjwvczpCb2R5PjwvczpFbnZlbG9wZT4=",
  "attacheddocument": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9Im5vIj8+CjxBdHRhY2hlZERvY3VtZZWZlcmVuY2U+CjwvQXR0YWNoZWREb2N1bWVudD4K"
}

Descripción de los campos de la respuesta

Campos	Descripción
success	Indica si la api procesó la petición correctamente
send_email_success	Indica si el correo electrónico se envio correctamente
urlinvoicexml	Nombre del xml de la factura
urlinvoicepdf	Nombre del pdf de la factura
urlinvoiceattached	Nombre del xml de la factura firmado
cufe	Cufe de la factura
QRStr	Url del portal dian para generar el QR de la factura
certificate_days_left	Dias restantes del certificado
resolution_days_left	Dias restantes de la resolución
ResponseDian	Respuesta del dian
invoicexml	XML de la factura en formato base64
zipinvoicexml	ZIP de la factura en formato base64
unsignedinvoicexml	XML de la factura sin firmar en formato base64
reqfe	request de la petición en formato base64
reqrptafe	Respuesta de la petición en formato base64
attacheddocument	Documento adjuntado en formato base64

422 - Error por campos obligatorios

{
	"message": "The given data was invalid.",
	"errors": {
		"customer.name": [
			"El campo worker_code es obligatorio."
		]
	}
}

Rechazo por documento enviado

{
  "success": true,
  "message": "AttachedDocument #SETP990001192 generada con éxito",
  "send_email_success": false,
  "send_email_date_time": false,
  "urlinvoicexml": "FES-SETP990001192.xml",
  "urlinvoicepdf": "FES-SETP990001192.pdf",
  "urlinvoiceattached": ".xml",
  "cufe": "1393a88b14dfe70b1ec158cff51ecb86b3fed77e31c7a92281b36d8e1f317c1d2e16a95e8236f4f07c4ea2aae1e56f34",
  "QRStr": "https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=1393a88b14dfe70b1ec158cff51ecb86b3fed77e31c7a92281b36d8e1f317c1d2e16a95e8236f4f07c4ea2aae1e56f34",
  "certificate_days_left": 310,
  "resolution_days_left": 1621,
  "ResponseDian": {
      "Envelope": {
          "Header": {
              "Action": {
                  "_attributes": {
                      "mustUnderstand": "1"
                  },
                  "_value": "http://wcf.dian.colombia/IWcfDianCustomerServices/SendBillSyncResponse"
              },
              "Security": {
                  "_attributes": {
                      "mustUnderstand": "1"
                  },
                  "Timestamp": {
                      "_attributes": {
                          "Id": "_0"
                      },
                      "Created": "2025-08-12T17:55:17.329Z",
                      "Expires": "2025-08-12T18:00:17.329Z"
                  }
              }
          },
          "Body": {
              "SendBillSyncResponse": {
                  "SendBillSyncResult": {
                      "ErrorMessage": {
                          "string": "Regla: 90, Rechazo: Documento procesado anteriormente."
                      },
                      "IsValid": "false",
                      "StatusCode": "99",
                      "StatusDescription": "Validación contiene errores en campos mandatorios.",
                      "StatusMessage": "Documento con errores en campos mandatorios.",
                      "XmlBase64Bytes": "PD94bWwgdmVyc2lvbj0iMS4c2U+DQogIDwvY2FjOkRvY3VtZW50UmVzcG9uc2U+DQo8L0FwcGxpY2F0aW9uUmVzcG9uc2U+",
                      "XmlBytes": {
                          "_attributes": {
                              "nil": "true"
                          }
                      },
                      "XmlDocumentKey": "318ac0a063b260ce9eacc78e4e311a40570ce517ec6465282d16d63da03b4207c56d9be92cefac7cd041db8084f2b195",
                      "XmlFileName": "fv00075737720002500000081"
                  }
              }
          }
      }
  },
  "invoicexml": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiI2ljZT4K",
  "zipinvoicexml": "UEsDBBQAAAAA=",
  "unsignedinvoicexml": "PD94bWw2NhYzpQcmljZT4KICA8L2NhYzpJbnZvaWNlTGluZT4KPC9JbnZvaWNlPgo=",
  "reqfe": "PD94bWwgdmVyc2lvbj0iMS4WxvcGU+Cg==",
  "rptafe": "PHM6RW52ZWxvcGUgeG1sbnU+PC9zOkJvZHk+PC9zOkVudmVsb3BlPg==",
  "attacheddocument": ""
}