---
title: "Criar movimento de receita"
method: POST
path: "/api/financeiro/movements/profit"
tags: ["Financeiro (Protected)"]
---

# Criar movimento de receita

`POST /api/financeiro/movements/profit`

Criar um movimento de receita.

O campo lucro é definido como 1 por defeito.

## Headers

- `x-api-token` string, nullable

## Request body

- MovimentoCreate — User-provided fields for movement creation. System-managed fields (Pago, main, DataPagamento) are set by backend. ATCUD is allowed to link an existing invoice to the movement. lucro is optional - if provided, it overrides backend auto-calculation.
  - `ValorTotal` number, required — Can be negative (cost) or positive (profit)
  - `ValorIva` number, nullable
  - `Descrição` string, required
  - `Matrícula` integer, nullable
  - `Fornecedor` integer, nullable
  - `MétodoPagamento` integer, nullable
  - `NrFatura` string, nullable
  - `DataFatura` string, date-time, nullable
  - `Rubrica` integer, required
  - `ATCUD` integer, nullable — Invoice ID (Faturas.ID) to link to this movement
  - `lucro` integer, nullable — Override lucro value (0 or 1). If None, backend auto-calculates based on vehicle status.

## Response `200`

Successful Response

- MovimentoDetailedResponse
  - `ID` integer, required
  - `ValorTotal` number, required
  - `ValorIva` number, nullable, required
  - `Descrição` string, required
  - `Matrícula` integer, nullable, required
  - `Fornecedor` integer, nullable, required
  - `MétodoPagamento` integer, nullable, required
  - `Pago` boolean, required
  - `DataPagamento` string, date-time, nullable, required
  - `NrFatura` string, nullable, required
  - `DataFatura` string, date-time, nullable, required
  - `Rubrica` integer, required
  - `ATCUD` integer, nullable, required
  - `IgnoraAtcud` boolean, nullable, required
  - `main` integer, nullable, required
  - `lucro` boolean, nullable, required
  - `DataRegisto` string, date-time, nullable, required
  - `RubricaDescricao` string, nullable, required
  - `ViaturaMatricula` string, nullable, required
  - `ViaturaID` integer, nullable, required
  - `MetodoPagamentoDescricao` string, nullable, required
  - `FaturaG` string, nullable, required
  - `ClienteNome` string, nullable, required
  - `ClienteID` integer, nullable, required
  - `DocumentoID` integer, nullable, required
  - `DocumentoNome` string, nullable
  - `invoice_split_sync` object, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/multigest/apis/multigest-protected-api.md) · [All operations](https://skmtc.dev/multigest/apis/multigest-protected-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/multigest/multigest-protected-api/revisions/4b44eb76b3ee/schema)