---
title: "Create settlement"
method: POST
path: "/api/v1/settlements"
tags: ["API"]
---

# Create settlement

`POST /api/v1/settlements`

## Request

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

Release selected payment splits into a bank account with typed deductions. Idempotency-Key is required. Matching replays return the original resource; changed payloads conflict with HTTP 409. All writes require organization-wide Treasury visibility.

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `bankAccountId` string, uuid, required
  - `settlementDate` string, date, required
  - `items` object[], required
    - `customerPaymentId` string, uuid, required
    - `paymentSplitId` string, uuid, required
    - `amount` integer, required
  - `deductions` object[], required
    - `deductionType` 'commission' | 'tax_withholding' | 'tax_perception' | 'chargeback' | 'adjustment' | 'other', required
    - `amount` integer, required
    - `description` string
    - `taxKind` 'iibb' | 'vat' | 'income_tax' | 'suss' | 'stamps'
    - `jurisdiction` string
  - `netDepositAmount` integer, required
  - `integrationSource` string
  - `integrationId` string

## 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/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)