ALalegra
Nóminas electrónicas

Endpoint para anular una nómina electrónica

Changed on

Este endpoint permite anular la nómina electrónica enviada como parámetro. Sólo se puede anular una nómina aceptada por la DIAN (legalStatus ACCEPTED o ACCEPTED_WITH_OBSERVATIONS): una nómina rechazada no se anula, se corrige y se envía de nuevo (AEP2015). Mientras otra anulación o reemplazo de la misma nómina esté en proceso, la solicitud se rechaza con AEP2016; una anulación o un reemplazo rechazado por la DIAN no bloquea un nuevo intento.

post/payrolls/{id}/cancel

Request

  • Base URL
    https://sandbox-api.alegra.com/e-provider/col/v1
  • URL
    https://sandbox-api.alegra.com/e-provider/col/v1/payrolls/{id}/cancel
  • Auth
    HTTP bearer

Path parameters

idstring required

Id de la nómina electrónica que se desea anular

Parameters

#/paths/~1events/post/parameters/0 (unresolved $ref)

Request body

prefixstring required

Prefijo de la anulación de la nómina electrónica

numberstring required

Número consecutivo de la anulación de la nómina electrónica

Response

Objeto que representa la respuesta cuando se anula una nómina electrónica en la DIAN

payrollEmission (unresolved $ref)
cancellationEmission (unresolved $ref)

Changes

  • 2bc52ab55c2bRevision changes
    • info

      added the new optional header request parameter Idempotency-Key

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status