Registrar cessão de operações

Registra no serviço de cessões uma cessão com a lista de operações cedidas em cession, o tipo da cessão em type e o arquivo da cessão em zip_file_url. Cada item de cession identifica a operação (ID e código) e o cliente (ID, nome e CPF ou CNPJ). O corpo é enviado ao serviço de cessões como recebido, e a resposta traz a cessão registrada: identificador, tipo, arquivo, quantidade de operações, número da cessão, situação, valor total e data de criação. A validação dos campos é feita pelo serviço de cessões: quando ele recusa ou não atende a chamada, a rota devolve o mesmo status HTTP devolvido por ele (por exemplo 400, 401, 403, 404 ou 422), ou 500 se não houver resposta, com uma mensagem de falha na comunicação seguida, depois de "Detalhes:", do detalhe da falha. Requer autenticação via Bearer JWT ou header x-api-key.

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Respostas

🟢200

application/json

Cessão registrada

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠400Cessão recusada pelo serviço de cessões

🟠404Falha no serviço de cessões (não encontrado)

🔴500Falha no serviço de cessões ou erro interno

curl --location '/cession/save-cession' \ --header 'x-api-key: SUA_CHAVE_DE_API' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "cession": [ { "_id": "Xb7Qm2Lp9Rt4Vn8Kc3Ws", "operation_code": "A0000001-000", "client_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "name": "Produtor Rural Exemplo", "tax_id": "12345678900", "gross_value": 150000 } ], "type": "tipo-exemplo", "zip_file_url": "cessoes/lote-0001.zip" }'

{ "_id": "Qw3Er5Ty7Ui9Op1As2Df", "type": "tipo-exemplo", "zip_file_url": "cessoes/lote-0001.zip", "operation_counter": 1, "cession_number": 42, "status": "enviada", "total_value": 150000, "created_at": "2026-09-14T13:20:00.000Z" }

Registrar cessão de operações

Requisição

Respostas