✏️ Atualizar Transação
Permite a edição manual de campos administrativos de uma transação. Campos financeiros críticos (valor, data, contas) não são editáveis por este endpoint para garantir a integridade do ledger.
Endpoint: PUT /backoffice/transactions/\{id\}
📥 Parâmetros de Entrada (Body JSON)
| Campo | Tipo | Descrição |
|---|---|---|
status | integer | Novo status da transação. |
description | string | Alterar a descrição original. |
type_id | integer | Corrigir a categoria do tipo de transação. |
metadata | object | Dados técnicos adicionais em formato JSON. |
details | object | Detalhes complementares da operação. |
📤 Retorno de Sucesso (200 OK)
json
{
"message": "Transaction updated successfully",
"transaction": {
"id": 1,
"txid": "E123456789...",
"endtoendid": "E123456789...",
"value": 1500.00,
"status": 1,
"description": "Nova descrição atualizada",
"datetime": "2024-04-20 12:00:00",
"balance": 5000.00,
"bank_details": {
"bank": "001",
"agency": "1234",
"account": "567890"
},
"account": { "id": 10, "name": "Conta Exemplo" },
"type": { "id": 1, "name": "PIX_IN", "description": "Entrada de Pix" },
"payer": {
"name": "Empresa A",
"document": "00000000000191",
"bank": "Banco Teste",
"agency": "0001",
"account": "112233"
},
"receiver": {
"name": "Usuario B",
"document": "11111111111",
"bank": "FastGiveMoney",
"agency": "0001",
"account": "445566"
},
"created_by": { "id": 5, "name": "Admin" },
"created_at": "2024-04-20 12:00:00",
"updated_at": "2024-04-20 12:10:00",
"currency": "BRL",
"metadata": { "info": "updated" }
}
}❌ Erros Comuns
| Código | Descrição |
|---|---|
401 | Não Autorizado: Token ausente ou inválido. |
422 | Erro de Validação: Dados enviados estão fora do formato esperado (ex: type_id inexistente). |
404 | Não Encontrado: Transação inexistente. |