Realizar a inclusão de Pessoa.
Atenção antes de realizar um cadastro de pessoa através da API é necessário que o endereço completo esteja cadastrado, ou seja, cidade, bairro, logradouro devem estar previamente cadastrados no banco.
POST [URLAPI]/CadastrosEstruturaisAPI/api/v1/Pessoa
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
Para saber mais sobre permissionamentos acesse Permissões - Segurança Web.
Não há.
Nome (Name) | Descrição (Description) | Tipo (Type) | Informações Adicionais (Adittional Information) |
---|---|---|---|
Versao | Versão da pessoa | Integer($int64) | Não há |
NomeRazaoSocial | Razão Social | String | Obrigatório. |
Fantasia | Nome fantasia | String | Não há |
Tipo | Física ou Jurídica (Opções: F - Física / J - Jurídica) | String | Valores permitidos F, J ou nulo. |
Sexo | Sexo (Opções: M - Masculino / F - Feminino) | String | Não há |
Status | Status da pessoa (Opções: A - Ativo / I - Inativo / P - Prospect / O - Outros) | String | Obrigatório, valores permitidos A, I, P, O. |
NomeCidade | Nome da cidade | String | Será usado o menor Identificador(SEQCIDADE), caso hajam cidades com nomes iguais na mesma UF. |
UFCidade | Estado | String | Não há |
PaisCidade | País | String | Não há |
CodigoMunicipio | Código do município | Integer($int64) | Não há |
CodigoPais | Código do país. | Integer($int64) | Não há |
NomeBairro | Nome do bairro | String | Não há |
TipoLogradouro | Tipo do logradouro. (Rua, avenida, etc.) | String | Não há |
DescricaoLogradouro | Nome do logradouro | String | Não há |
NumeroLogradouro | Número do logradouro | String | Não há |
ComplementoLogradouro | Complemento do logradouro | String | Não há |
CEP | Código postal | String | Não há |
TelefoneDDD1 | DDD do primeiro telefone | String | Não há |
TelefoneNumero1 | Numero do primeiro telefone | String | Não há |
TelefoneComplemento1 | Complemento do primeiro telefone | String | Não há |
TelefoneDDD2 | DDD do segundo telefone | String | Não há |
TelefoneNumero2 | Numero do segundo telefone | String | Não há |
TelefoneComplemento2 | Complemento do segundo telefone | String | Não há |
TelefoneDDD3 | DDD do terceiro telefone | String | Não há |
TelefoneNumero3 | Numero do terceiro telefone | String | Não há |
TelefoneComplemento3 | Complemento do terceiro telefone | String | Não há |
NumeroCPFCNPJ | Número do CPF ou CNPJ sem dígito | Integer($int64) | Não há |
DigitoCPFCNPJ | Dígito do CPF ou CNPJ | Integer($int64) | Não há |
InscricaoEstadualRG | Numero da inscrição estadual | String | Não há |
String | Não há | ||
HomePage | Site | String | Não há |
EstadoCivil | Estado Civil | String | Não há |
ContribuinteIcms | Identificador de Contribuinte ICMS (Opções: S - Sim / N - Não) | String | Valores permitidos S, N ou nulo. |
ProdutorRural | Identificador de Produtor Rural (Opções: S - Sim / N - Não) | String | Valores permitidos S, N ou nulo. |
MicroEmpresa | Identificador de Micro Empresa (Opções: S - Sim / N - Não) | String | Valores permitidos S, N ou nulo. |
InscricaoProdutorRural | Inscrição de produtor rural | String | Não há |
NumeroCNPJProdutorRural | Número do CNPJ de produtor rural sem dígito | Integer($int64) | Não há |
DigitoCNPJProdutorRural | Dígito do CNPJ | Integer($int64) | Não há |
ProdutorRuralComCPF | Identificador de Produtor Rural Com CPF (Opções: S - Sim / N - Não) | String | Valores permitidos S, N ou nulo. |
NumeroCPFProdutorRural | Número do CPF de produtor rural sem dígito | Integer($int64) | Não há |
DigitoCPFProdutorRural | Dígito do CPF | Integer($int64) | Não há |
CODE 200 - SUCCESS
{ "status": "string", "nomeRazaoSocial": "string", "versao": 0, "fantasia": "string", "tipo": "string", "sexo": "string", "idCidade": 0, "nomeCidade": "string", "ufCidade": "string", "paisCidade": "string", "idBairro": 0, "nomeBairro": "string", "idLogradouro": 0, "descricaoLogradouro": "string", "numeroLogradouro": "string", "complementoLogradouro": "string", "cep": "string", "telefoneDDD1": "string", "telefoneNumero1": "string", "telefoneComplemento1": "string", "numeroCPFCNPJ": "string", "digitoCPFCNPJ": "string", "email": "string", "homePage": "string", "contribuinteICMS": "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 } ] }