PATCH Atualizar Movimentação

Atualiza os dados de uma movimentação existente (valor, método de pagamento, bandeira e parcelas).

Autenticação necessária

Esta rota requer o header Authorization: Bearer {accessToken}

ID da movimentação

O id pode ser obtido na rota de Listar Movimentações, no campo data[].id de cada movimentação.

Caixa aberto

O cashManagementId informado deve pertencer à conta e estar com status OPEN. Caso contrário a atualização não encontra a movimentação e retorna erro.

---

Endpoint

PATCH https://api-dev.imagemais.com.br/api/movements/{id}

---

Path Parameter

Campo	Tipo	Obrigatório	Descrição
id	number	✅	ID da movimentação

---

Corpo da Requisição

Campo	Tipo	Obrigatório	Descrição
cashManagementId	number	✅	ID do caixa (inteiro positivo)
paymentMethod	string (enum)	✅	Método de pagamento. Ver Métodos de pagamento
value	number	✅	Valor da movimentação (mínimo 0.01)
flag	string (enum)	❌	Bandeira do cartão: Visa, Mastercard, Elo, American Express, Hipercard
installments	number	❌	Quantidade de parcelas (1 a 12). Padrão: 1
editReason	string	❌	Motivo da edição (máx. 500 caracteres)

---

Requisição

curl -X 'PATCH' \
  'https://api-dev.imagemais.com.br/api/movements/44' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'Content-Type: application/json' \
  -d '{
  "cashManagementId": 12,
  "paymentMethod": "CARTAO_CREDITO",
  "value": 150.00,
  "flag": "Visa",
  "installments": 3,
  "editReason": "Correção de valor informado pelo cliente"
}'

---

Respostas

200 Sucesso

{
  "data": {
    "id": 44,
    "cashManagementId": 12,
    "paymentMethodId": 2,
    "value": "150",
    "createdAt": "2025-12-22T11:44:19.893Z",
    "updatedAt": "2026-01-15T09:12:41.552Z",
    "statusId": 2,
    "protocolContaAzul": null,
    "movementsOptionsId": 7,
    "cancellationReason": null,
    "editReason": "Correção de valor informado pelo cliente"
  }
}

statusId, paymentMethodId e movementsOptionsId não são fixos

Esses IDs são gerados via connectOrCreate na primeira vez que cada valor (nome do status, método de pagamento, bandeira, etc.) é usado naquela conta. Não existe um mapeamento fixo entre ambientes/contas — não trate esses números como constantes.

500 Erro ao atualizar

{
  "message": "Erro ao atualizar movimentação",
  "error": "Internal Server Error",
  "statusCode": 500
}