Corregir la nómina de un mes
Si cambió un valor después de validar, el 103 Reemplazar lleva la nómina corregida y apunta al 102 anterior.
- Nota
- 103
- Tipo
- Reemplazar
102 · 103
Tú o tu software liquidan la nómina. Trevol arma el documento soporte de pago de nómina de cada trabajador, calcula sus totales, lo firma y lo envía a la DIAN, y te deja la nota de ajuste para reemplazarlo o eliminarlo.
Al crear tu cuenta recibes $ 2.000 de saldo de bienvenida.
Ejemplo con datos ficticios: el documento de nómina 102 de una trabajadora en octubre de 2026, con un salario de $ 4.000.000, salud y pensión del 4 % cada una y un pago neto de $ 3.680.000, validado por la DIAN. Al lado, la nota de ajuste 103 que lo reemplaza.
La nómina electrónica es el documento soporte de pago de nómina: lo que devengó y lo que se le dedujo a cada trabajador. En producción hay un solo 102 por trabajador y por mes; para cambiarlo se emite la nota de ajuste 103, que lo reemplaza o lo elimina. La DIAN valida cada uno con su código único, el CUNE.
Trevol revisa el periodo, el trabajador, los devengados y las deducciones antes de reservar el número, y calcula los totales.
La nota de ajuste 103 corrige un 102 validado, o lo elimina si se emitió por error.
Los webhooks avisan sin el trabajador ni los montos; el detalle solo lo consulta quien tiene la llave.
En la app, la nómina del mes se llena desde las anteriores del trabajador o subiendo el XML de otro programa. Las novedades del periodo no se copian.
payroll.* y payroll_adjustment.*Sin PDF ni correo: la nómina no se le envía al trabajador.
| Aspecto | Nómina (102) | Nota de ajuste (103) |
|---|---|---|
| Para qué | Reporta lo que devengó y lo que se le dedujo al trabajador en el mes. | Reemplaza un 102 validado, o lo elimina. |
| Qué lleva | Trabajador, devengados, deducciones y totales. | Reemplazar: la nómina corregida y el 102 anterior. Eliminar: solo el 102 que se anula, sin los datos del trabajador. |
| Cuántos | Uno por trabajador y por mes, en producción. | Es la forma de cambiarlo: no se emite un segundo 102. |
| Webhook | payroll.accepted | payroll_adjustment.accepted |
| Lo que queda | El XML, el ZIP, la respuesta de la DIAN y el CUNE. Sin PDF ni correo. | Lo mismo: sin PDF ni correo. |
La nómina tiene su propia habilitación ante la DIAN. Mientras la DIAN valida el set de pruebas, la API responde 202 validating y reintentar no lo reenvía.
POST /v1/payrolls, un trabajador por documento.409 duplicate_document con el id del que ya existe.GET /v1/company te dice si la nómina está habilitada (capabilities.payroll).Idempotency-Key durante 7 días devuelve el mismo documento.curl https://api.trevol.si/v1/payrolls \
-H "Authorization: Bearer $TREVOL_LLAVE" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"external_id": "NOM-2026-09-001",
"period": {
"hire_date": "2024-03-01",
"start": "2026-09-01",
"end": "2026-09-30"
},
"pay_period": "5",
"notes": ["Nómina de septiembre de 2026"],
"employee": {
"type": "01",
"subtype": "00",
"high_risk_pension": false,
"document_type": "13",
"document_number": "1000000101",
"first_surname": "PRUEBA",
"second_surname": "NOMINA01",
"first_name": "TRABAJADOR",
"other_names": "DE PRUEBA",
"workplace": {
"country": "CO",
"municipality_code": "76001",
"address": "Calle 1 # 1-1"
},
"integral_salary": false,
"contract_type": "2",
"salary": "1423500",
"code": "TRAB-01"
},
"payment": {
"form": "1",
"method": "42",
"bank": "Banco de Pruebas",
"account_type": "Ahorros",
"account_number": "0001234501"
},
"payment_dates": ["2026-09-30"],
"earnings": {
"basic": {"days": 30, "amount": "1423500"},
"transport": [{"allowance": "200000"}]
},
"deductions": {
"health": {"percent": "4", "amount": "56940"},
"pension": {"percent": "4", "amount": "56940"}
}
}'curl https://api.trevol.si/v1/payroll_adjustments \
-H "Authorization: Bearer $TREVOL_LLAVE" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"external_id": "NOM-2026-09-001-R",
"period": {
"hire_date": "2024-03-01",
"start": "2026-09-01",
"end": "2026-09-30"
},
"pay_period": "5",
"notes": ["Nómina de septiembre de 2026"],
"employee": {
"type": "01",
"subtype": "00",
"high_risk_pension": false,
"document_type": "13",
"document_number": "1000000101",
"first_surname": "PRUEBA",
"second_surname": "NOMINA01",
"first_name": "TRABAJADOR",
"other_names": "DE PRUEBA",
"workplace": {
"country": "CO",
"municipality_code": "76001",
"address": "Calle 1 # 1-1"
},
"integral_salary": false,
"contract_type": "2",
"salary": "1423500",
"code": "TRAB-01"
},
"payment": {
"form": "1",
"method": "42",
"bank": "Banco de Pruebas",
"account_type": "Ahorros",
"account_number": "0001234501"
},
"payment_dates": ["2026-09-30"],
"earnings": {
"basic": {"days": 30, "amount": "1423500"},
"transport": [{"allowance": "210000"}]
},
"deductions": {
"health": {"percent": "4", "amount": "56940"},
"pension": {"percent": "4", "amount": "56940"}
},
"type": "replace",
"predecessor": {"id": "pr_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b"}
}'Datos de prueba del ejemplo de la documentación.
POST /v1/payrollsNómina en la guía
Si cambió un valor después de validar, el 103 Reemplazar lleva la nómina corregida y apunta al 102 anterior.
El 103 Eliminar lo anula ante la DIAN, sin los datos del trabajador.
En producción, Trevol no deja emitir dos veces la nómina del mismo trabajador en el mismo mes: para cambiarla está el 103.
La sincronización con la DIAN trae las nóminas que emitiste con otro programa, y la app las usa para llenar la siguiente de cada trabajador: el sueldo y los conceptos de siempre, con salud y pensión recalculadas. También puedes subir el XML de una nómina y el formulario queda igual.
Cada documento de nómina se cobra cuando la DIAN lo valida, con su propio conteo. Cada nota de ajuste cuenta como un empleado más.
$ 2.000 → $ 50
por empleado, según los empleados de tu cuenta en el mes
Del 1 al 2: $ 2.000 c/u
Las pruebas de habilitación no se cobran. Si la DIAN rechaza un documento, no pagas: lo apartado vuelve a tu saldo.
No. La liquidación la haces tú o tu software; Trevol emite el documento ante la DIAN.
No por Trevol: la nómina electrónica no lleva PDF ni correo. Quedan el XML, el ZIP y la respuesta de la DIAN.
En producción, no: hay un solo 102 por trabajador y por mes. Para cambiarlo se emite la nota de ajuste 103.
No. El conector emite la factura de venta y la nota crédito; la nómina se emite desde la app o la API.
05 · 95
Para lo que compras a quienes no están obligados a facturar.
01 · 02
Nacional y de exportación, con el Anexo Técnico 1.9.
030 a 034
La aceptación tácita de tus facturas a crédito y los eventos de las que recibes.
Sin plan, sin mensualidad y con precios publicados. Empiezas con $ 2.000 de saldo y las pruebas de habilitación no se cobran.