Solicitar recomendação de um cliente

Publica um pedido de recomendação de um cliente (pessoa física ou jurídica) para que usuários de outras empresas da rede o avaliem. Não é permitido pedir recomendação do CPF de um usuário ativo da própria empresa nem do CNPJ da própria empresa. A mesma empresa só pode pedir recomendação do mesmo CPF/CNPJ uma vez a cada 24 horas. O tipo de pessoa é definido pelo tamanho do documento: 11 dígitos = CPF (natural), 14 = CNPJ (legal). O CPF/CNPJ volta mascarado na resposta. 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

🟢201

application/json

Pedido de recomendação criado

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠422Campos inválidos

🟠400Recomendação não permitida para este documento

🟠409Recomendação já solicitada nas últimas 24 horas

curl --location '/v2/recommendations/' \ --header 'x-api-key: SUA_CHAVE_DE_API' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "taxId": "12345678000190", "informedName": "Agropecuária Boa Safra Ltda", "state": "MT", "city": "Sorriso" }'

{ "message": "Recomendação solicitada com sucesso.", "recommendation": { "_id": "3d6f0a9e-2b7c-4e51-9a8d-0c4b7e2f1a63", "taxId": "12.***.***/0001-90", "kind": "legal", "informedName": "Agropecuária Boa Safra Ltda", "state": "MT", "city": "Sorriso", "createdAt": "2026-09-25T13:20:05.412Z", "new": true, "requestedByThisCompany": true, "alreadyReplied": false, "totalReplies": 0, "totalApprovals": 0, "totalDisapprovals": 0 } }

Solicitar recomendação de um cliente

Requisição

Respostas