Criar pedido de acesso

POST/v1/access-requests

Pede ao cliente, pelo CNPJ, acesso às vendas e aos recebimentos dele. O pedido aparece no painel do Concilia+ do cliente, que aprova ou recusa.

Autenticação: Authorization: Bearer <access_token>.

Requisição

Campo do corpo	Tipo	Obrigatório	Descrição
cnpj	string	Sim	CNPJ do cliente, numérico ou alfanumérico (14 posições), com ou sem máscara (12.345.678/0001-95, 12345678000195 ou 12ABC34501DE35). Até 32 caracteres.

curl -X POST "$BASE_URL/v1/access-requests" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"cnpj":"12.345.678/0001-95"}'

Resposta 202

{
  "message": "Pedido recebido",
  "result": true,
  "data": { "status": "RECEIVED" },
  "error": null
}

:::info A resposta é sempre a mesma A API responde 202 RECEIVED para qualquer CNPJ: cliente do Concilia+ ou não, dígito verificador certo ou errado, com pedido já aberto ou não. Assim ela não revela quem é cliente. Para saber como está o pedido, use GET /v1/access-requests/{cnpj}. :::

O que acontece por trás

Situação do CNPJ para a sua software house	Efeito
Nenhum pedido, ou o último ficou EXPIRED ou REVOKED	Cria um pedido PENDING, válido por 7 dias.
Pedido PENDING ainda no prazo, ou acesso APPROVED	Nada. Não abre um segundo pedido.
Recusado (DENIED) há menos de 30 dias	Nada. O cliente não é incomodado de novo.
Recusado há 30 dias ou mais	Cria um pedido PENDING novo.

O cliente não recebe e-mail sobre o pedido: ele aparece em destaque no painel. Combine com o cliente para ele entrar e aprovar.

Erros

Código	Quando
400	cnpj ausente, não é texto, tem mais de 32 caracteres ou o corpo tem outros campos.
401	Token de acesso ausente, vencido ou inválido.
429	Limite por minuto excedido.