---
title: "Void settlement"
method: POST
path: "/api/v1/settlements/{settlement_id}/void"
tags: ["API"]
---

# Void settlement

`POST /api/v1/settlements/{settlement_id}/void`

## Request

- Base URL: `https://api.lapyme.com.ar`
- URL: `https://api.lapyme.com.ar/api/v1/settlements/{settlement_id}/void`
- Auth: HTTP bearer

Reverse the settlement and release its coupons, preserving accounting history. Requires Idempotency-Key. Same request replays; changed requests conflict with HTTP 409.

## Path parameters

- `settlement_id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- object

## Response `201`

Committed resource or replay

- ApiSharedObjecta9a56f8ba3
  - `request_id` string, required
  - `data` ApiSharedObjectf0953ff270, required
    - `object` 'settlement', required
    - `id` string, uuid, required
    - `bank_account_id` string, uuid, required
    - `settlement_date` string, date, required
    - `status` string, required
    - `gross_amount` integer, required
    - `deductions_amount` integer, required
    - `net_amount` integer, required
    - `created_at` string, date-time, required

## Other responses

- `400`: Request could not be completed
- `401`: Request could not be completed
- `403`: Request could not be completed
- `404`: Request could not be completed
- `409`: Idempotency or state conflict
- `422`: Request could not be completed
- `429`: Request could not be completed
- `503`: Request could not be completed Verificación de credenciales temporalmente ocupada; reintentá sin cambiar la operación ni su Idempotency-Key.

## Changes

- **2026-11-03** `ed0d46e68fbe`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lapyme/apis/la-pyme-api/changes/api/v1/settlements/:settlement_id/void/post.md)

---

[API](https://skmtc.dev/lapyme/apis/la-pyme-api.md) - [All operations](https://skmtc.dev/lapyme/apis/la-pyme-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lapyme/apis/la-pyme-api/revisions/067bbb55f421?raw)