---
title: "Endpoint para reemplazar/ajustar una nómina electrónica"
method: POST
path: "/payrolls/{id}/replace"
tags: ["Nóminas electrónicas"]
---

# Endpoint para reemplazar/ajustar una nómina electrónica

`POST /payrolls/{id}/replace`

## Request

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

Este endpoint permite reemplazar/ajustar la nómina electrónica enviada como parámetro. Sólo se puede reemplazar una nómina aceptada por la DIAN (`legalStatus` `ACCEPTED` o `ACCEPTED_WITH_OBSERVATIONS`): una nómina rechazada no se reemplaza, 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.

## Path parameters

- `id` string, required

## Parameters

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

## Request body

- object
  - `prefix` string, required: Prefijo de la nómina electrónica
  - `number` number, double, required: Número de la nómina electrónica
  - `governmentData` GovernmentData, required (unresolved $ref)

## Other responses

- `200` (unresolved $ref)
- `400`: Objeto que representa una respuesta de error por validaciones
- `404`: Objeto que representa una respuesta de error por qué no se ha encontrado el recurso al que se intenta acceder
- `409` (unresolved $ref)
- `422`: Objeto que representa una respuesta de error por reutilizar una `Idempotency-Key` con un cuerpo de petición diferente al de la petición original. Código `IDEMPOTENCY_KEY_REUSED_WITH_DIFFERENT_PAYLOAD`. La operación no se ejecuta: usa una llave nueva si realmente se trata de una operación distinta
- `500`: Objeto que representa una respuesta de error por qué ha ocurrido un error interno en el sistema

## Changes

- **2026-11-03** `2bc52ab55c2b`: 3 info
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the non-success response with the status `409`
  - added the non-success response with the status `422`

[Operation history](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia/changes/payrolls/:id/replace/post.md)

---

[API](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia.md) - [All operations](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia/revisions/2bc52ab55c2b?raw)