---
title: "Vincular uma movimentação do extrato bancário a uma ou mais contas a pagar ou a receber, baixando as contas"
method: POST
path: "/extratos-bancarios/{idExtratoBancario}/movimentacoes/{idMovimentacao}/vinculo-conta"
tags: ["Extrato Bancário"]
---

# Vincular uma movimentação do extrato bancário a uma ou mais contas a pagar ou a receber, baixando as contas

`POST /extratos-bancarios/{idExtratoBancario}/movimentacoes/{idMovimentacao}/vinculo-conta`

## Request

- Base URL: `https://api.tiny.com.br/public-api/v3`
- URL: `https://api.tiny.com.br/public-api/v3/extratos-bancarios/{idExtratoBancario}/movimentacoes/{idMovimentacao}/vinculo-conta`
- Auth: HTTP bearer

## Path parameters

- `idExtratoBancario` integer, required
- `idMovimentacao` integer, required

## Request body

- VincularContaMovimentacaoExtratoBancarioRequestModel: 
  - `contas` ContaPagarReceberRequestModel[], nullable, required: Contas a pagar ou a receber que serão conciliadas com a movimentação, podendo ser mais de uma. O tipo é definido pelo tipo da própria movimentação: movimentações de entrada (crédito) vinculam contas a receber e movimentações de saída (débito) vinculam contas a pagar
    - `id` integer, nullable: Identificador da conta a pagar ou a receber que será conciliada com a movimentação
    - `valor` number, float, nullable: Valor pago da conta, permitindo baixa parcial. Quando não informado (e nenhum campo de ajuste for informado), usa o valor total da movimentação. A soma do valor pago de todas as contas — valor somado a juros e acréscimo, menos desconto e taxa — deve ser igual ao valor da movimentação
    - `juros` number, float, nullable: Juros pagos na conta
    - `desconto` number, float, nullable: Desconto concedido na conta
    - `acrescimo` number, float, nullable: Acréscimo cobrado na conta
    - `taxa` number, float, nullable: Taxa cobrada na conta
    - `categoria` CategoriaRequestModel: 
      - `id` integer, nullable
  - `contato` ContatoRequestModel: 
    - `id` integer, nullable
  - `historico` string, nullable: Quando não informado, usa as observações da primeira conta (uma conta) ou o histórico padrão de baixa de contas (mais de uma). Obrigatório quando mais de uma conta for informada
  - `categoria` CategoriaRequestModel: 
    - `id` integer, nullable

## Response `200`

OK

- VincularContaMovimentacaoExtratoBancarioResponseModel: 
  - `situacao` 0 | 1 | 2 | 3, nullable: Situação do tratamento da movimentação - 0 - Pendente - 1 - Ignorado - 2 - Adicionado Ao Caixa - 3 - Vinculado A Duplicata
  - `bordero` BorderoResponseModel: 
    - `id` integer: Identificador do borderô de recebimento ou pagamento vinculado à movimentação

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-11-03** `107f8d039de2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/olist/apis/olist-erp-api-v3/changes/extratos-bancarios/:idExtratoBancario/movimentacoes/:idMovimentacao/vinculo-conta/post.md)

---

[API](https://skmtc.dev/olist/apis/olist-erp-api-v3.md) - [All operations](https://skmtc.dev/olist/apis/olist-erp-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/olist/apis/olist-erp-api-v3/revisions/107f8d039de2?raw)