VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
API atual/Referência completa/Login por CNPJ

GETCNPJs duplicados

Encontra clientes que compartilham o mesmo CNPJ e atrapalham o login por CNPJ.

Procura clientes diferentes que tenham o mesmo CNPJ e devolve os grupos. Quando o login por CNPJ está ligado, o cliente entra digitando o CNPJ; se dois usuários o compartilham, a plataforma não sabe quem está entrando. Esta lista aponta esses casos para o administrador resolver.

GET/api/v1/admin/cnpj-login/duplicatesAdmin

Lista CNPJs cadastrados em mais de um cliente

Autenticação: Authorization: Bearer <token> de um administrador com manage_users. Requer o módulo cnpj-login ativo.

Sem parâmetros.

Exemplo de requisição

bash
curl "$BASE_URL/api/v1/admin/cnpj-login/duplicates" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Grupos devolvidos
json
{
  "groups": [
    {
      "cnpj": "11222333000181",
      "count": 2,
      "users": [
        {
          "id": "220b672c-90fe-4841-ae86-bd4f1ace982e",
          "first_name": "Priscila",
          "last_name": "Gomes",
          "email": "priscila.gomes@example.com",
          "cpf": "12345678909",
          "status": "A",
          "last_login": "2026-07-21T23:20:04.792452Z"
        },
        {
          "id": "d5ccd9e1-dd21-458c-90a5-4a7f3c2b9e10",
          "first_name": "Marcos",
          "last_name": "Lima",
          "email": "marcos.lima@example.com",
          "status": "A",
          "last_login": "2026-08-02T14:10:00Z"
        }
      ]
    }
  ],
  "total_duplicates": 1
}

Campos da resposta

groupsarray
Um grupo por CNPJ repetido.
groups[].cnpjstring
CNPJ só com os 14 dígitos, sem pontuação.
groups[].countinteger
Quantos clientes usam esse CNPJ.
groups[].usersarray
Os clientes do grupo.
groups[].users[].iduuid
Identificador do cliente.
groups[].users[].first_namestring
Nome.
groups[].users[].last_namestring
Sobrenome.
groups[].users[].emailstring
E-mail.
groups[].users[].cpfstring
CPF, só dígitos. Omitido se não houver.
groups[].users[].statusstring
Letra do estado do cliente (A ativo).
groups[].users[].last_loginstring
Último login, RFC 3339. Omitido se nunca entrou.
total_duplicatesinteger
Quantidade de grupos.

Erros

StatusQuandoCorpo
401Sem token ou token inválido{"error":"missing authorization header"}
403Sem o privilégio exigido, ou módulo desligado{"error":"module_disabled","module":"cnpj-login"} / {"error":"insufficient privileges","required":"manage_users"}
500Falha na consulta{"error":"failed to fetch CNPJ duplicates","detail":"..."}
Dados pessoais na resposta

A resposta traz nome, e-mail e CPF dos clientes. Não registre o corpo em logs nem o repasse a quem não administra clientes.

Onde o CNPJ é procurado

O CNPJ é lido tanto do cadastro do cliente quanto dos campos de perfil da loja cujo nome indica CNPJ. Pontuação diferente (11.222.333/0001-81 e 11222333000181) conta como o mesmo CNPJ. Sem duplicados, groups vem vazio e total_duplicates é 0.

Veja também

  • Login por CNPJ
Anterior
Login por CNPJ
Próxima
Plano e documentos
Nesta página
  • Exemplo de requisição
  • Resposta
  • Erros
  • Veja também