Registrar cessão de CPR de um cliente

POST

/cpr/cession/{clientId}

Solicita o registro da cessão de uma CPR do cliente a um novo credor. Informe em cprId a CPR cedida, em cpfCnpjNewCreditor o CPF ou CNPJ do novo credor (cessionário), em registrationAgent se a cessão tem agente de registro e, nesse caso, o CNPJ dele em cpfCnpjRegistrationAgent; os dois documentos precisam ter dígitos verificadores válidos. Informe também em urlDocument o endereço do documento da cessão já enviado e em type o valor cession. A cessão é gravada e segue para processamento; a resposta 201 indica que a solicitação foi aceita, não que a cessão já foi registrada. Esta rota trata a cessão de uma CPR individual da empresa e não se confunde com as rotas de cessão em lote. Documento do novo credor ou do agente ausente ou inválido devolve 400, com a mensagem dentro de um array a mais; registrationAgent ou urlDocument ausentes também devolvem 400. CPR inexistente e type ausente ou inválido devolvem 500. Só aceita clientes vinculados à empresa do usuário autenticado: cliente inexistente devolve 404, e cliente de outra empresa devolve 401. Requer autenticação via Bearer JWT ou header x-api-key.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

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

Parâmetros de Caminho

Parâmetros Header

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢201

application/json

Cessão solicitada

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠400Dados da cessão inválidos

🟠404Registro de CPR indisponível

🔴500CPR não encontrada ou tipo inválido

Request Example

Shell

JavaScript

Java

Swift

curl --location '/cpr/cession/7c9e6679-7425-40de-944b-e07fc1f90ae7' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "type": "cession",
    "cprId": "3f2b8c1e-0000-4000-8000-00000000c001",
    "taxId": "11222333000181",
    "cpfCnpjNewCreditor": "11444777000161",
    "registrationAgent": true,
    "cpfCnpjRegistrationAgent": "12345678000195",
    "urlDocument": "https://files.example.com/cpr/cessao-fazenda-exemplo.pdf"
}'

Response Example

201 - Sucesso

{
    "message": "Cession registered successfully"
}

Modificado em 2026-10-21 19:11:22

Página anterior

Registrar endosso de CPR Ag de um cliente

Próxima página

Registrar aditivo de CPR de um cliente