Nómina vigente del período por concepto

GET/api/v1/reports/payroll

Documentos de nómina aceptados (por fecha de emisión) que ninguna nota de ajuste aceptada reemplazó ni eliminó. Base para conciliar con la PILA y la retención en la fuente.

Parámetros de consulta

fromstring · dateobligatorio
Ejemplo: 2026-11-01
tostring · dateobligatorio
Ejemplo: 2026-11-30

Respuestas

200OK

fromstring · date
tostring · date
currencystring
Ejemplo: COP
documentsinteger
employeesinteger
earningsstring
Ejemplo: 5000.00
deductionsstring
Ejemplo: 5000.00
payablestring
Ejemplo: 5000.00
conceptsarray<object>
+ Ver 4 campos− Ocultar 4 campos
- sectionstring
  Valores: earning · deduction
- conceptstring
  basic_salary, transport_allowance, overtime_hed, vacation, health, pension, withholding_tax, loan...
  Ejemplo: health
- documentsinteger
- amountstring
  Ejemplo: 5000.00

400Datos inválidos (details trae los campos)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring

401Falta la key o es inválida, está deshabilitada, vencida o revocada (error.missing_api_key, error.invalid_api_key, error.api_key.disabled, error.api_key.expired, error.api_key.revoked)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring