---
title: "Cria um novo movimento financeiro de ajuste."
method: POST
path: "/v1/movements"
tags: ["movements"]
---

# Cria um novo movimento financeiro de ajuste.

`POST /v1/movements`

## Request

- Base URL: `//app.vindi.com.br/api` (relative, and the document’s source URL is not known)
- URL: `//app.vindi.com.br/api/v1/movements`
- Auth: HTTP basic

Utilize este método para criar um movimento financeiro de ajuste (crédito).

## Request body

- PostV1Movements: Cria um novo movimento financeiro de ajuste.
  - `body` string: JSON com atributos do movimento financeiro.
  - `amount` number, required: Valor do movimento
  - `movement_type` 'credit', required: Tipo do movimento
  - `origin` 'bill_credit' | 'invoice_withhold': Origem do movimento
  - `bill_id` integer, required: ID da fatura
  - `description` string: Descrição opcional

## Response `201`

Movimento financeiro criado com sucesso.

- Movement: Utilize este método para criar um movimento financeiro de ajuste (crédito).
  - `id` integer, required: ID do movimento
  - `status` 'active' | 'inactive' | 'deleted': Status do movimento
  - `amount` number, required: Valor do movimento
  - `movement_type` 'credit' | 'debit', required: Tipo do movimento
  - `description` string: Descrição opcional
  - `bill` BillSummary, required
    - `id` integer, required: ID da fatura
    - `code` string: Código externo para referência via API

## Other responses

- `400`: Erro de sintaxe JSON no corpo do request.
- `422`: Parâmetros inválidos. Verificar erro na resposta.

---

[API](https://skmtc.dev/vindi/apis/api-vindi.md) - [All operations](https://skmtc.dev/vindi/apis/api-vindi/llms.txt) - [OpenAPI document](https://skmtc.dev/vindi/apis/api-vindi/revisions/3e857e1cdd03?raw)