---
title: "Criar pedido de liquidação de recebiveis"
method: POST
path: "/v1/scf/settlements"
tags: ["Settlement"]
---

# Criar pedido de liquidação de recebiveis

`POST /v1/scf/settlements`

O objetivo dessa rota é cadastrar um pedido de liquidação de recebiveis.

## Request body

- object
  - `payerTaxId` string — Identificação do pagador
  - `payment` object
    - `method` string — Método de pagamento para a transferência, Pix ou Ted
  - `contracts` object[]
    - `contractId` string — Idenfiticador do contrato
    - `installments` object[]
      - `InstallmentNumber` number — Número da parcela
      - `Amount` number — Valor

## Response `201`

Pedido de liquidação cadastrado com sucesso.

- SettlementSchema
  - `id` string — Identificador da liquidação
  - `payment` object
    - `method` 'pix' | 'ted'
    - `maturityDate` string — Timestamp (ISO 8601) da data e hora limite para expiração do pagamento. O pagamento deve ser realizado até essa hora, caso contrário, a liquidação será cancelada.
    - `amount` string — Valor de pagamento da transação
  - `contracts` object[]
    - `contractId` string — Identificador do contrato
    - `installments` number[]
    - `status` 'PROCESSING' | 'PROCESSED' | 'CANCELLED' | 'INVALID' — Status do contrato
  - `status` 'CREATED' | 'VALIDATING' | 'INVALID' | 'WAITING_FOR_PAYMENT' | 'PROCESSED' | 'EXPIRED' — Status da liquidação

## Other responses

- `400` — Erro de validação
- `401` — Não autorizado
- `default` — Erro

---

[API](https://skmtc.net/btgpactual/apis/folha-de-pagamentos.md) · [All operations](https://skmtc.net/btgpactual/apis/folha-de-pagamentos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/btgpactual/folha-de-pagamentos/revisions/2a24d3da114c/schema)