SendpayrollNoteReemplazar-TestSetId Sencilla
Método: POST
URL: https://apidian2024.oo/api/ubl2.1/payroll-adjust-note/8a92b8cc-b061-4af4-bc4e-4b63fe24833e
PRIMER ENVIO DE NOMINA DE AJUSTE
- Si se instalo un dominio se debe utilizar de la siguiente manera:
http://midominio.com/api/ubl2.1/invoice
-
Requiere un token de autorizacion el cual fue devuelto al realizar el Paso 1 - Config Company, si este token se extravio, se puede consultar en la tabla de la base de datos de la API en la tabla users, en el campo API_TOKEN.
-
En URL el ultimo parametro corresponde al id del set de pruebas que la dian entrego al momento de registrar el modo de operacion software propio.
.../ubl2.1/invoice/iddelsetdepruebasdeladian
- Este endpoint se puede utilizar de dos modos:
-
Asincrono: .../ubl2.1/invoice/iddelsetdepruebasdeladian
-
Sincrono: .../ubl2.1/invoice
-
El modo sincrono no afecta al set de pruebas, pero la respuesta de la DIAN incluye posibles errores de validacion y estado de la factura, valida o no valida.
-
El modo asincrono, afecta el set de pruebas y en la respuesta no se incluye el resultado de la factura, solo se entrega un ZIP_KEY el cual debe ser consultado mediante el endpoint:
.../ubl2.1/status/zip
- Una vez habilitado el software propio, debera cambiar el entorno a produccion y realizar el envio de la factura sin el id del set de pruebas, es decir modo síncrono.
de la seccion 03 - Consultas de estado para asi poder establecer si la factura fue valida o no y los errores de validacion.
Autenticación
- Tipo: Bearer Token
- Header:
Authorization: Bearer <TOKEN>
Headers
| Key | Value |
|---|---|
Content-Type | application/json |
Accept | application/json |
Body
{
"type_document_id": 10,
"resolution_number": 10,
"establishment_name": "TORRE SOFTWARE",
"establishment_address": "CLL 11 NRO 21-73 BRR LA CABAÑA",
"establishment_phone": "3226563672",
"establishment_municipality": 600,
"establishment_email": "alternate_email@alternate.com",
"head_note": "PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN",
"foot_note": "PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN",
"type_note": 1,
"predecessor": {
"predecessor_number": 30,
"predecessor_cune": "54a01cd43e28a1887ad57f10d3e4f95e3a354cacccded6e000d023a8254fe62a206918b71dddb78dcf8d0172d6630db0",
"predecessor_issue_date": "2025-11-26"
},
"period": {
"admision_date": "2024-11-01",
"settlement_start_date": "2025-10-01",
"settlement_end_date": "2025-10-31",
"worked_time": 26,
"issue_date": "2025-11-26"
},
"worker_code": "41946692",
"prefix": "NA",
"consecutive": 512,
"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": 1,
"municipality_id": 822,
"type_contract_id": 1,
"high_risk_pension": false,
"identification_number": 41946692,
"surname": "CARDONA",
"second_surname": "VILLADA",
"first_name": "ELIZABETH",
"address": "BRR LIMONAR MZ 6 CS 3 ET 1",
"integral_salarary": false,
"salary": "1500000.00"
},
"payment": {
"payment_method_id": 10,
"bank_name": "BANCO DAVIVIENDA",
"account_type": "AHORROS",
"account_number": "126070603280"
},
"payment_dates": [
{
"payment_date": "2021-03-10"
},
{
"payment_date": "2021-03-15"
}
],
"accrued": {
"worked_days": 30,
"salary": "750000.00",
"transportation_allowance": "109000.00",
"HEDs": [
{
"start_time": "2021-03-01T18:00:00",
"end_time": "2021-03-01T19:00:00",
"quantity": 1,
"percentage": 1,
"payment": "7812.50"
},
{
"start_time": "2021-03-02T18:00:00",
"end_time": "2021-03-02T19:00:00",
"quantity": 1,
"percentage": 1,
"payment": "7812.50"
}
],
"HENs": [
{
"start_time": "2021-03-01T21:00:00",
"end_time": "2021-03-01T22:00:00",
"quantity": 1,
"percentage": 2,
"payment": "10937.50"
}
],
"HRNs": [
{
"start_time": "2021-03-01T21:00:00",
"end_time": "2021-03-01T22:00:00",
"quantity": 1,
"percentage": 3,
"payment": "8437.50"
},
{
"start_time": "2021-03-02T21:00:00",
"end_time": "2021-03-02T22:00:00",
"quantity": 1,
"percentage": 3,
"payment": "8437.50"
}
],
"HEDDFs": [
{
"start_time": "2021-03-01T21:00:00",
"end_time": "2021-03-01T22:00:00",
"quantity": 1,
"percentage": 4,
"payment": "12500.00"
}
],
"HRDDFs": [
{
"start_time": "2021-03-01T16:00:00",
"end_time": "2021-03-01T17:00:00",
"quantity": 1,
"percentage": 5,
"payment": "10937.50"
},
{
"start_time": "2021-03-02T16:00:00",
"end_time": "2021-03-02T17:00:00",
"quantity": 1,
"percentage": 5,
"payment": "10937.50"
}
],
"HENDFs": [
{
"start_time": "2021-03-01T21:00:00",
"end_time": "2021-03-01T22:00:00",
"quantity": 1,
"percentage": 6,
"payment": "15625.00"
}
],
"HRNDFs": [
{
"start_time": "2021-03-01T21:00:00",
"end_time": "2021-03-01T22:00:00",
"quantity": 1,
"percentage": 7,
"payment": "13125.00"
}
],
"common_vacation": [
{
"start_date": "2021-03-01",
"end_date": "2021-03-10",
"quantity": 10,
"payment": "500000.00"
}
],
"paid_vacation": [
{
"quantity": 5,
"payment": "250000.00"
}
],
"service_bonus": [
{
"quantity": 365,
"payment": "1500000.00",
"paymentNS": "250000.00"
}
],
"severance": [
{
"payment": "1500000.00",
"percentage": "12",
"interest_payment": "180000.00"
}
],
"work_disabilities": [
{
"start_date": "2021-03-05",
"end_date": "2021-03-10",
"type": 3,
"quantity": 5,
"payment": "250000.00"
},
{
"start_date": "2021-03-11",
"end_date": "2021-03-15",
"type": 3,
"quantity": 5,
"payment": "250000.00"
}
],
"maternity_leave": [
{
"start_date": "2021-03-11",
"end_date": "2021-03-15",
"quantity": 5,
"payment": "250000.00"
}
],
"paid_leave": [
{
"start_date": "2021-03-11",
"end_date": "2021-03-15",
"quantity": 5,
"payment": "250000.00"
}
],
"non_paid_leave": [
{
"start_date": "2021-03-11",
"end_date": "2021-03-15",
"quantity": 5
}
],
"bonuses": [
{
"salary_bonus": "100000.00"
},
{
"salary_bonus": "95000.00",
"non_salary_bonus": "50000.00"
}
],
"aid": [
{
"salary_assistance": "95000.00",
"non_salary_assistance": "50000.00"
}
],
"legal_strike": [
{
"start_date": "2021-03-01",
"end_date": "2021-03-10",
"quantity": 10
}
],
"other_concepts": [
{
"salary_concept": "35000",
"non_salary_concept": "50000",
"description_concept": "INGRESO POR OTROS CONCEPTOS"
}
],
"compensations": [
{
"ordinary_compensation": "135000",
"extraordinary_compensation": "250000"
}
],
"epctv_bonuses": [
{
"paymentS": "135000",
"paymentNS": "250000",
"salary_food_payment": "135000",
"non_salary_food_payment": "250000"
}
],
"commissions": [
{
"commission": "135000"
},
{
"commission": "155000"
}
],
"third_party_payments": [
{
"third_party_payment": "155000"
}
],
"advances": [
{
"advance": "135000"
},
{
"advance": "50000"
}
],
"endowment": "250000.00",
"sustenance_support": "1350000.00",
"telecommuting": "250000.00",
"withdrawal_bonus": "250000.00",
"compensation": "135000.00",
"accrued_total": "5145562.50"
},
"deductions": {
"eps_type_law_deductions_id": 1,
"eps_deduction": "60000.00",
"pension_type_law_deductions_id": 5,
"pension_deduction": "60000.00",
"fondossp_type_law_deductions_id": 3,
"fondosp_deduction_SP": "60000.00",
"fondossp_sub_type_law_deductions_id": 4,
"fondosp_deduction_sub": "30000.00",
"labor_union": [
{
"percentage": "2.00",
"deduction": "30000.00"
}
],
"sanctions": [
{
"public_sanction": "300000.00",
"private_sanction": "130000.00"
}
],
"orders": [
{
"description": "LIBRANZA POR PEDIDO NRO 34256 GRUPO EXITO",
"deduction": "13000.00"
}
],
"third_party_payments": [
{
"third_party_payment": "155000"
},
{
"third_party_payment": "59000"
}
],
"advances": [
{
"advance": "255000"
},
{
"advance": "79000"
}
],
"other_deductions": [
{
"other_deduction": "133000"
}
],
"voluntary_pension": "158000.00",
"withholding_at_source": "65000.00",
"afc": "33500.00",
"cooperative": "25000.00",
"tax_liens": "38500.00",
"supplementary_plan": "65000.00",
"education": "59000.00",
"refund": "47000.00",
"debt": "39000",
"deductions_total": "120000.00"
}
}
Ejemplo cURL
curl -X POST "https://apidian2024.oo/api/ubl2.1/payroll-adjust-note/8a92b8cc-b061-4af4-bc4e-4b63fe24833e" \
-H "Authorization: Bearer <TOKEN>" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
--data-raw '{
"type_document_id": 10,
"resolution_number": 10,
"establishment_name": "TORRE SOFTWARE",
"establishment_address": "CLL 11 NRO 21-73 BRR LA CABAÑA",
"establishment_phone": "3226563672",
"establishment_municipality": 600,
"establishment_email": "alternate_email@alternate.com",
"head_note": "PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN",
"foot_note": "PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN",
"type_note": 1,
"predecessor": {
"predecessor_number": 30,
"predecessor_cune": "54a01cd43e28a1887ad57f10d3e4f95e3a354cacccded6e000d023a8254fe62a206918b71dddb78dcf8d0172d6630db0",
"predecessor_issue_date": "2025-11-26"
},
"period":{
"admision_date": "2024-11-01",
"settlement_start_date": "2025-10-01",
"settlement_end_date": "2025-10-31",
"worked_time": 26,
"issue_date": "2025-11-26"
},
"worker_code": "41946692",
"prefix": "NA",
"consecutive": 512,
"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": 1,
"municipality_id": 822,
"type_contract_id": 1,
"high_risk_pension": false,
"identification_number": 41946692,
"surname": "CARDONA",
"second_surname": "VILLADA",
"first_name": "ELIZABETH",
"address": "BRR LIMONAR MZ 6 CS 3 ET 1",
"integral_salarary": false,
"salary": "1500000.00"
},
"payment": {
"payment_method_id": 10,
"bank_name": "BANCO DAVIVIENDA",
"account_type": "AHORROS",
"account_number": "126070603280"
},
"payment_dates": [
{
"payment_date": "2021-03-10"
},
{
"payment_date": "2021-03-15"
}
],
"accrued": {
"worked_days": 30,
"salary": "750000.00",
"transportation_allowance": "109000.00",
"HEDs": [
{
"start_time": "2021-03-01T18:00:00",
"end_time": "2021-03-01T19:00:00",
"quantity": 1,
"percentage": 1,
"payment": "7812.50"
},
{
"start_time": "2021-03-02T18:00:00",
"end_time": "2021-03-02T19:00:00",
"quantity": 1,
"percentage": 1,
"payment": "7812.50"
}
],
"HENs": [
{
"start_time": "2021-03-01T21:00:00",
"end_time": "2021-03-01T22:00:00",
"quantity": 1,
"percentage": 2,
"payment": "10937.50"
}
],
"HRNs": [
{
"start_time": "2021-03-01T21:00:00",
"end_time": "2021-03-01T22:00:00",
"quantity": 1,
"percentage": 3,
"payment": "8437.50"
},
{
"start_time": "2021-03-02T21:00:00",
"end_time": "2021-03-02T22:00:00",
"quantity": 1,
"percentage": 3,
"payment": "8437.50"
}
],
"HEDDFs": [
{
"start_time": "2021-03-01T21:00:00",
"end_time": "2021-03-01T22:00:00",
"quantity": 1,
"percentage": 4,
"payment": "12500.00"
}
],
"HRDDFs": [
{
"start_time": "2021-03-01T16:00:00",
"end_time": "2021-03-01T17:00:00",
"quantity": 1,
"percentage": 5,
"payment": "10937.50"
},
{
"start_time": "2021-03-02T16:00:00",
"end_time": "2021-03-02T17:00:00",
"quantity": 1,
"percentage": 5,
"payment": "10937.50"
}
],
"HENDFs": [
{
"start_time": "2021-03-01T21:00:00",
"end_time": "2021-03-01T22:00:00",
"quantity": 1,
"percentage": 6,
"payment": "15625.00"
}
],
"HRNDFs": [
{
"start_time": "2021-03-01T21:00:00",
"end_time": "2021-03-01T22:00:00",
"quantity": 1,
"percentage": 7,
"payment": "13125.00"
}
],
"common_vacation": [
{
"start_date": "2021-03-01",
"end_date": "2021-03-10",
"quantity": 10,
"payment": "500000.00"
}
],
"paid_vacation": [
{
"quantity": 5,
"payment": "250000.00"
}
],
"service_bonus": [
{
"quantity": 365,
"payment": "1500000.00",
"paymentNS": "250000.00"
}
],
"severance": [
{
"payment": "1500000.00",
"percentage": "12",
"interest_payment": "180000.00"
}
],
"work_disabilities": [
{
"start_date": "2021-03-05",
"end_date": "2021-03-10",
"type": 3,
"quantity": 5,
"payment": "250000.00"
},
{
"start_date": "2021-03-11",
"end_date": "2021-03-15",
"type": 3,
"quantity": 5,
"payment": "250000.00"
}
],
"maternity_leave": [
{
"start_date": "2021-03-11",
"end_date": "2021-03-15",
"quantity": 5,
"payment": "250000.00"
}
],
"paid_leave": [
{
"start_date": "2021-03-11",
"end_date": "2021-03-15",
"quantity": 5,
"payment": "250000.00"
}
],
"non_paid_leave": [
{
"start_date": "2021-03-11",
"end_date": "2021-03-15",
"quantity": 5
}
],
"bonuses": [
{
"salary_bonus": "100000.00"
},
{
"salary_bonus": "95000.00",
"non_salary_bonus": "50000.00"
}
],
"aid": [
{
"salary_assistance": "95000.00",
"non_salary_assistance": "50000.00"
}
],
"legal_strike": [
{
"start_date": "2021-03-01",
"end_date": "2021-03-10",
"quantity": 10
}
],
"other_concepts": [
{
"salary_concept": "35000",
"non_salary_concept": "50000",
"description_concept": "INGRESO POR OTROS CONCEPTOS"
}
],
"compensations": [
{
"ordinary_compensation": "135000",
"extraordinary_compensation": "250000"
}
],
"epctv_bonuses": [
{
"paymentS": "135000",
"paymentNS": "250000",
"salary_food_payment": "135000",
"non_salary_food_payment": "250000"
}
],
"commissions": [
{
"commission": "135000"
},
{
"commission": "155000"
}
],
"third_party_payments": [
{
"third_party_payment": "155000"
}
],
"advances": [
{
"advance": "135000"
},
{
"advance": "50000"
}
],
"endowment": "250000.00",
"sustenance_support": "1350000.00",
"telecommuting": "250000.00",
"withdrawal_bonus": "250000.00",
"compensation": "135000.00",
"accrued_total": "5145562.50"
},
"deductions": {
"eps_type_law_deductions_id": 1,
"eps_deduction": "60000.00",
"pension_type_law_deductions_id": 5,
"pension_deduction": "60000.00",
"fondossp_type_law_deductions_id": 3,
"fondosp_deduction_SP": "60000.00",
"fondossp_sub_type_law_deductions_id": 4,
"fondosp_deduction_sub": "30000.00",
"labor_union": [
{
"percentage": "2.00",
"deduction": "30000.00"
}
],
"sanctions": [
{
"public_sanction": "300000.00",
"private_sanction": "130000.00"
}
],
"orders": [
{
"description": "LIBRANZA POR PEDIDO NRO 34256 GRUPO EXITO",
"deduction": "13000.00"
}
],
"third_party_payments": [
{
"third_party_payment": "155000"
},
{
"third_party_payment": "59000"
}
],
"advances": [
{
"advance": "255000"
},
{
"advance": "79000"
}
],
"other_deductions": [
{
"other_deduction": "133000"
}
],
"voluntary_pension": "158000.00",
"withholding_at_source": "65000.00",
"afc": "33500.00",
"cooperative": "25000.00",
"tax_liens": "38500.00",
"supplementary_plan": "65000.00",
"education": "59000.00",
"refund": "47000.00",
"debt": "39000",
"deductions_total": "120000.00"
}
}'