Consultar pessoa - GET

Objetivo

Método de consulta que retorna informações de uma lista de pessoas.

Chamada

GET [URLAPI]/CadastrosEstruturaisAPI/api/v1/Pessoa

Permissionamento

Antes de prosseguir, certifique-se de que o usuário, utilizado para autenticação de uso na API, está com as devidas permissões no Sistema/Módulo/Aplicações e na empresa desejada.

Para isso, acesse o módulo SegurançaWeb > Permissões > Associação de Permissão Usuário / Grupo > Sistemas/Módulo/Aplicações > Comercial Web> API Cadastros Estruturais > API Cadastros Estruturais

Imagem 01 - Configurações de Sistemas/Módulos/Aplicações

Informações para Requisição (Request Information)

Parâmetros URI (URI Parameters)

Nome (Name)	Descrição (Description)	Tipo (Type)	Informações Adicionais (Adittional Information)
Id	Identificador da pessoa	integer($int32)	Não há.
Status	Status da pessoa	string	A - Ativo I - Inativo.
NomeRazaoSocial	Nome razão social	string	Não há.
NomeFantasia	Nome fantasia	string	Não há.
NumeroCPFCNPJ	Número do CFP/CNPJ sem dígito	string	Não há.
DigitoCPFCNPJ	Digito do CFP/CNPJ	integer($int32)	Somente números.
Tipo	Tipo de cadastro	string	F - Física J - Jurídica.
indVinculadaEmpresa	Empresa vinculada a Pessoa	string	S - Sim N - Não
Page	Páginas	integer($int32)	Não há.
PageSize	Tamanho das páginas	integer($int32)	Não há.

Parâmetros do Corpo (Body Parameters)

Não há.

Informações para Resposta (Response Information)

Códigos do Recurso (Response Codes)

OK (200)
BadRequest (400)

Formatos de Resposta (Response Formats)

application/json, text/json

CODE 200 - SUCCESS

{
  "hasNext": true,
  "items": [
    {
      "expandables": [
        "string"
      ],
      "idPessoa": 0,
      "numeroCPFCNPJ": 0,
      "digitoCPFCNPJ": 0,
      "cpfcnpj": "string",
      "status": "string",
      "nomeRazaoSocial": "string",
      "fantasia": "string",
      "tipo": "string",
      "nomeCidade": "string",
      "ufCidade": "string",
      "paisCidade": "string",
      "nomeBairro": "string",
      "descricaoLogradouro": "string",
      "numeroLogradouro": "string",
      "complementoLogradouro": "string",
      "cep": "string",
      "telefoneDDD1": "string",
      "telefoneNumero1": "string",
      "telefoneComplemento1": "string",
      "telefoneDDD2": "string",
      "telefoneNumero2": "string",
      "telefoneComplemento2": "string",
      "inscricaoEstadualRG": "string",
      "contribuinteICMS": "string",
      "email": "string",
      "homePage": "string",
      "sexo": "string",
      "estadoCivil": "string",
      "inscricaoProdutorRural": "string",
      "microEmpresa": "string",
      "cnae": "string",
      "indVinculadaEmpresa": "string"
    }
  ]
}

application/json, text/json

CODE 400 - BAD

{
  "code": "string",
  "message": "string",
  "detailedMessage": "string",
  "helpUrl": "string",
  "details": [
    {
      "guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "notificationType": 0,
      "code": "string",
      "message": "string",
      "detailedMessage": "string",
      "status": 0
    }
  ]
}

Árvore de páginas