Para cadastrar uma pessoa jurídica precisaremos primeiramente de seu CNPJ.
Este valor de documento será o "doc" que iremos enviar para a API
Nossa API só irá aceitar valores de "doc" possuindo 11 ou 14 números, representando CPF e CNPJ respectivamente.
Caso seja enviado um valor com um valor diferente de 11 ou 14 números a API não irá realizar o cadastro.
Campos obrigatórios
“nome”
“status”
“data_nascimento”
“doc”
“estado_civil”
“grau_instrucao”
“nome_fantasia”
“forma_juridica”
“armazem_gerenciado”
“classificacao”
“tipo_endereco”
“tipo_logradouro”
“cep_endereco”
“endereco”
“num_endereco”
“bairro_endereco”
“cidade_endereco”
“estado_endereco”
“pais_endereco”
“tipo_telefone”
“ddd_telefone”
“telefone”
“nome_contato”
“grau_relacionamento”
Com o CNPJ e os dados cadastrais obrigatórios podemos enviar estas informações para a API para que seja realizado o cadastro desta pessoa no GTI Plug.
Quando o campo “doc” possuir 14 caracteres válidos (ou seja, é um CNPJ), os campos abaixo não precisam ser enviados e serão ignorados, pois este são relativos à Pessoas Físicas.
“data_nascimento”
“estado_civil”
“num_identidade”
“grau_instrucao”
“orgao_expedidor”
“nome_pai”
“nome_mae”
Cadastrar uma Pessoa Jurídica
http://host_name:port/v1/{tenant_id}/pessoa/cadastro/doc/{id}
O "doc" será o valor do documento da pessoa a ser cadastrada.
{
“dados_pessoa”: [
{
“doc”: “integer”,
“idExterno” : "string",
“status”: "integer",
“nome”: "string",
“data_nascimento”: "string",
“num_identidade”: “string”,
“orgao_expedidor” : “integer”,
“estado_civil”: "integer",
“grau_instrucao”: "integer",
“nome_fantasia”: "string",
“forma_juridica”: "integer",
“classificacao”: "integer",
“nome_pai” : "string",
“nome_mae” : "string",
“email” : "string",
“site” : "string",
“porte_empresa” : "integer",
“data_constituicao” : "string",
“data_registro” : "string",
“inscricao_municipal” : "string",
“data_alteracao_contratual” : "string",
“capital_social” : "integer",
“capital_integralizado” : "integer",
“patrimonio_liquido” : "integer",
“receita_bruta” : "integer",
“numero_filiais” : "integer",
“crc_responsavel” : "string",
“armazem_gerenciado”: “boolean”,
}
]
“dados_endereco”: [
{
“tipo_endereco” : "integer",
“cep_endereco” : "string",
“tipo_logradouro” : "integer",
“endereco” : "string",
“num_endereco” : "integer",
“complemento_endereço” : "string",
“bairro_endereco” : "string",
“cidade_endereco” : "string",
“estado_endereco” : "string",
“pais_endereco” : "string",
“zona_urbana” : "boolean",
“modalidade_ocupacao” : "iteger",
}
]
“dados_telefone”: [
{
“tipo_telefone” : "integer",
“ddd_telefone” : "integer",
“telefone” : "integer",
}
]
“dados_contato”: [
{
“nome_contato” : "string",
“grau_relacionamento” : "string",
}
]
}
{
"dados_pessoa": [
{
"doc": 39789102000173,
"idExterno": "000385",
"status": 2,
"nome": "Teste Especificacao LTDA",
"nome_fantasia": "Teste Especificação",
"forma_juridica": 1,
"porte_empresa": 2,
"classificacao": 2,
"data_constituicao": "2010-09-30",
"data_registro": "2020-09-30",
"data_alteracao_contratual": "2015-09-30",
"inscricao_municipal": 99999999,
"capital_social": 100000,
"capital_integralizado": 800000,
"patrimonio_liquido": 200000,
"receita_bruta": 450000,
"numero_filiais": 1,
"crc_responsavel": "MG/1972/20",
"email": "rmferreira@cabtec.com.br",
"site": "www.cabtec.com.br",
"armazem_gerenciado": 1
}
],
"dados_endereco": [
{
"tipo_endereco": 2,
"tipo_logradouro": 34,
"cep_endereco": 30140061,
"endereco": "dos Timbiras",
"num_endereco": 1754,
"complemento_endereco": "10 Andar",
"bairro_endereco": "Funcionários",
"cidade_endereco": "Belo Horioznte",
"estado_endereco": "MINAS GERAIS",
"pais_endereco": "Brasil",
"zona_urbana": 1,
"modalidade_ocupacao": 2
}
],
"dados_telefone": [
{
"tipo_telefone": 2,
"ddd_telefone": 31,
"telefone": 21259047
}
],
"dados_contato": [
{
"nome_contato": "Fulano da Silva",
"grau_relacionamento": "Diretor de TI"
}
]
}
O retorno será:
{
"dados_pessoa": [
{
"doc": 39789102000173,
"idExterno": "000385",
"status": "Ativo",
"nome": "Teste Especificacao LTDA",
"nome_fantasia": "Teste Especificação",
"forma_juridica": "Sociedade de Quotas Limitadas ("Ltda.")",
"porte_empresa": "Pequena Empresa”,
"classificacao": "Cliente”,
"data_constituicao": "2010-09-30",
"data_registro": "2020-09-30",
"data_alteracao_contratual": "2015-09-30",
"inscricao_municipal": 99999999,
"capital_social": 100000,
"capital_integralizado": 800000,
"patrimonio_liquido": 200000,
"receita_bruta": 450000,
"numero_filiais": 1,
"crc_responsavel": "MG/1972/20",
"email": "rmferreira@cabtec.com.br",
"site": "www.cabtec.com.br",
"armazem_gerenciado": "Sim”
}
],
"dados_endereco": [
{
"tipo_endereco": "Comercial”,
"tipo_logradouro": "Rua”,
"cep_endereco": 30140061,
"endereco": "dos Timbiras",
"num_endereco": 1754,
"complemento_endereco": "10 Andar",
"bairro_endereco": "Funcionários",
"cidade_endereco": "Belo Horioznte",
"estado_endereco": "MINAS GERAIS",
"pais_endereco": "Brasil",
"zona_urbana": "Sim”,
"modalidade_ocupacao": "Alugada”
}
],
"dados_telefone": [
{
"tipo_telefone": "Fixo Comercial”,
"ddd_telefone": 31,
"telefone": 21259047
}
],
"dados_contato": [
{
"nome_contato": "Fulano da Silva",
"grau_relacionamento": "Diretor de TI"}
]
}
Alterar o cadastro de uma Pessoa Jurídica
http://host_name:port/v1/{tenant_id}/pessoa/alteracao/doc/{id}
Para realizarmos uma alteração em uma pessoa já cadastrada precisaremos de seu número de documento e informar quais campos devem ser alterados.
Diferente do cadastro, ao atualizarmos um cadastro não existe a necessidade de enviar todos os campos obrigatórios.
Devemos apenas informar quais informações da pessoa desejamos alterar.
{
"dados_pessoa": [
{
"forma_juridica": 7,
"porte_empresa": 3,
}
],
"dados_endereco": [],
"dados_telefone": [
{
"tipo_telefone": 1,
"ddd_telefone": 31,
"telefone": 21259000
}
],
"dados_contato": []
}
O retorno será:
{
"dados_pessoa": [
{
"doc": 39789102000173,
"idExterno": "000385",
"status": "Ativo",
"nome": "Teste Especificacao LTDA",
"nome_fantasia": "Teste Especificação",
"forma_juridica": "Empresário (individual) - EI",
"porte_empresa": "Média Empresa”,
"classificacao": "Cliente”,
"data_constituicao": "2010-09-30",
"data_registro": "2020-09-30",
"data_alteracao_contratual": "2015-09-30",
"inscricao_municipal": 99999999,
"capital_social": 100000,
"capital_integralizado": 800000,
"patrimonio_liquido": 200000,
"receita_bruta": 450000,
"numero_filiais": 1,
"crc_responsavel": "MG/1972/20",
"email": "rmferreira@cabtec.com.br",
"site": "www.cabtec.com.br",
"armazem_gerenciado": "Sim”
}
],
"dados_endereco": [
{
"tipo_endereco": "Comercial”,
"tipo_logradouro": "Rua”,
"cep_endereco": 30140061,
"endereco": "dos Timbiras",
"num_endereco": 1754,
"complemento_endereco": "10 Andar",
"bairro_endereco": "Funcionários",
"cidade_endereco": "Belo Horioznte",
"estado_endereco": "MINAS GERAIS",
"pais_endereco": "Brasil",
"zona_urbana": "Sim”,
"modalidade_ocupacao": "Alugada”
}
],
"dados_telefone": [
{
"tipo_telefone": "Fixo Residencial”,
"ddd_telefone": 31,
"telefone": 21259047
}
],
"dados_contato": [
{
"nome_contato": "Fulano da Silva",
"grau_relacionamento": "Diretor de TI"}
]
}