Saltar al contenido

102 · 103

Nómina electrónica. Un 102 por trabajador y mes, y su nota de ajuste 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 que pagaste, reportada a la DIAN. Un documento por trabajador y por mes.

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.

  • Los totales, calculados.

    Trevol revisa el periodo, el trabajador, los devengados y las deducciones antes de reservar el número, y calcula los totales.

  • Reemplazar o eliminar.

    La nota de ajuste 103 corrige un 102 validado, o lo elimina si se emitió por error.

  • Los datos del trabajador, protegidos.

    Los webhooks avisan sin el trabajador ni los montos; el detalle solo lo consulta quien tiene la llave.

  • El formulario, ya lleno.

    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.

Lo que lleva cada 102. Y cómo se corrige.

Trabajador

  • Tipo y subtipo de trabajador
  • Documento y nombres
  • Lugar de trabajo y contrato
  • Salario y fechas de pago

Devengados y deducciones

  • Salario básico por días
  • Auxilio de transporte
  • Los demás devengados del Anexo de nómina
  • Salud y pensión, y las demás deducciones

Nota de ajuste (103)

  • Reemplazar
  • Eliminar

Lo que queda

  • El XML y el ZIP
  • La respuesta de la DIAN
  • El CUNE
  • Webhooks payroll.* y payroll_adjustment.*

Sin PDF ni correo: la nómina no se le envía al trabajador.

Dos documentos por trabajador. El 102 reporta; el 103 lo corrige.

La nómina 102 y su nota de ajuste 103, lado a lado
AspectoNó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é llevaTrabajador, 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ántosUno por trabajador y por mes, en producción.Es la forma de cambiarlo: no se emite un segundo 102.
Webhookpayroll.acceptedpayroll_adjustment.accepted
Lo que quedaEl 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.

Reporta la nómina desde tu software. POST /v1/payrolls, un trabajador por documento.

  • En producción, un segundo 102 del mismo trabajador y mes es 409 duplicate_document con el id del que ya existe.
  • GET /v1/company te dice si la nómina está habilitada (capabilities.payroll).
  • La misma Idempotency-Key durante 7 días devuelve el mismo documento.
Ejemplo
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

Un valor cambió, salió dos veces o vienes de otro programa. Qué pasa con una nómina ya validada, y cómo empezar sin volver a digitarla.

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
Un 102 emitido por error

El 103 Eliminar lo anula ante la DIAN, sin los datos del trabajador.

Nota
103
Tipo
Eliminar
Un 102 por trabajador y mes

En producción, Trevol no deja emitir dos veces la nómina del mismo trabajador en el mismo mes: para cambiarla está el 103.

Por trabajador
1 al mes
Repetido
409
Vienes de otro programa de nómina

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.

Llenar desde
Nóminas anteriores
O
Subir XML

Se cobra por empleado. Con su propio conteo, sin mensualidad.

Nómina electrónica

Ver la tabla completa

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.

Preguntas sobre la nómina electrónica. Y sobre quién hace qué.

¿Trevol liquida la nómina?

No. La liquidación la haces tú o tu software; Trevol emite el documento ante la DIAN.

¿La nómina electrónica le llega al trabajador?

No por Trevol: la nómina electrónica no lleva PDF ni correo. Quedan el XML, el ZIP y la respuesta de la DIAN.

¿Puedo emitir dos veces la nómina de un trabajador en el mismo mes?

En producción, no: hay un solo 102 por trabajador y por mes. Para cambiarlo se emite la nota de ajuste 103.

¿Puedo emitir la nómina desde ContaPyme?

No. El conector emite la factura de venta y la nota crédito; la nómina se emite desde la app o la API.

Todas las preguntas

Lo que se reporta junto a la nómina. O reporta la nómina desde la app o la API.

Emítela desde: App web · API

  • Documento soporte

    05 · 95

    Para lo que compras a quienes no están obligados a facturar.

  • Factura electrónica

    01 · 02

    Nacional y de exportación, con el Anexo Técnico 1.9.

  • Eventos RADIAN

    030 a 034

    La aceptación tácita de tus facturas a crédito y los eventos de las que recibes.

Reporta tu próxima nómina electrónica.

Sin plan, sin mensualidad y con precios publicados. Empiezas con $ 2.000 de saldo y las pruebas de habilitación no se cobran.

Cómo empezar

Cuenta, empresa y habilitación ante la DIAN, en tres pasos.

Ver los pasos

Documentación

La guía y la referencia de la API v1.

Leer la documentación