---
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`

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.net/vindi/apis/001-vindi-pagamentos-agost.md) · [All operations](https://skmtc.net/vindi/apis/001-vindi-pagamentos-agost/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vindi/001-vindi-pagamentos-agost/revisions/9d11e5de9308/schema)