Cadastro Emissor / Empresa
Esta API é responsável por realizar o cadastro/atualização de uma novo CNPJ emissor.
Aceleradores
A Solução Fiscal disponibiliza APIs para captura de dados cadastrais para auxiliar e acelerar o onboarding dos emissores. Consulte: Captura de Dados Cadastrais
Autenticação
Para realizar o cadastro de um novo emissor é preciso autenticar a nível de Solução. Ou seja, apenas a autenticação com chave master permite a inclusão de novos emissores na Solução Fiscal. Para saber como realizar a autenticação da solução, acesse Autenticação da Solução.
Cadastro de Emissor
- Endpoint: /company/create
- Método: POST
- Header:
- Authorization: Token de autorização
- Content-Type: application/json
| Tag | Descrição | Obrig. | Obs |
| Empresa.Tipo | Passar fixo 2 (CNPJ) | Sim | |
| Empresa.CNPJCPF | CNPJ do emissor | Sim | |
| Empresa.NomeFantasia | Nome Fantasia | Sim | |
| Empresa.RazaoSocialNome | Razão Social | Sim | |
| Empresa.InscricaoEstadual | Inscrição Estadual | Sim | |
| Empresa.InscricaoMunicipal | Inscrição Municipal | Não* | Campo obrigatório quando Produtos. Id = 3 NFS-e |
| Empresa.CodigoRegimeTributario | Código do Regime Tributário. Opções: 1 - Simples Nacional 2 - Simples Nacional - Excesso de sublimite de receita bruta 3 - Regime Normal | Sim | |
| Empresa.CNAE | Classificação Nacional das Atividades Econômicas | Sim | |
| Empresa.CNPJFaturamento | CNPJ pagador | Sim | |
| Empresa.CNPJMatriz | CNPJ Matriz. Poderá ser o mesmo CNPJ do emissor que está sendo cadastrado | Sim | |
| Empresa.GrupoEconomico | Descrição do Grupo Econômico. Caso já exista Grupo Econômico vinculado a Raiz do CNPJ será mantido o existente. | Sim | |
| Empresa.Endereco.TipoLogradouro | Tipo de logradouro. Opções: 4 - Avenida 23 – Rua | Sim | |
| Empresa.Endereco.Logradouro | Logradouro | Sim | |
| Empresa.Endereco.Numero | Número do Logradouro | Sim | |
| Empresa.Endereco.Bairro | Bairro do Logradouro | Sim | |
| Empresa.Endereco.Cep | CEP do Logradouro | Sim | |
| Empresa.Endereco.CodigoIBGEMunicipio | Código IBGE do Município do Logradouro | Sim | |
| Empresa.Endereco.Complemento | Complemento do Logradouro | Não | |
| Empresa.Contato.Email | E-mail de contato | Sim | |
| Empresa.Contato.CodigoArea | Código de área do telefone de contato | Sim | |
| Empresa.Contato.Telefone | Telefone de contato sem código de área | Sim | |
| Empresa.ResponsavelLegal | Array de Responsáveis Legais da Empresa | Sim | |
| Empresa.ResponsavelLegal.Nome | Nome do Responsável Legal | Sim | |
| Empresa.ResponsavelLegal.Email | E-mail do Responsável Legal | Sim | |
| E-mail do Responsável Legal | xTelefone do Responsável Legal | Não | |
| Empresa.Logo | Enviar a logo em base64 | Não | |
| Produtos | Listagem de produtos ativados para o emissor. | Sim | |
| Produtos. Id | Código do produto. Opções: 1 - NF-e 2 – NFC-e 3 - NFS-e | Sim |
Sobre a Inscrição Estadual
A Inscrição Estadual é pré-requisito para a emissão de notas ficais e é necessário que o emissor se credencie junto a SEFAZ que está estabelecido para obter a Inscrição Estadual.
Exemplo Json de Envio
{
"Empresa":
{
"Tipo": 2,
"NomeFantasia": "EQUALS SISTEMAS E CONSULTORIA LTDA",
"CNPJCPF": "{{CnpjFake}}",
"RazaoSocialNome": "EQUALS SISTEMAS E CONSULTORIA LTDA",
"InscricaoMunicipal": "",
"InscricaoEstadual": "0963580736",
"CodigoRegimeTributario": 3,
"CNAE": "6202300",
"CNPJFaturamento": "{{CnpjFaturamentoFake}}",
"CNPJMatriz": "{{CnpjFake}}",
"GrupoEconomico": "01 GRUPO_ECONOMICO_EQUALS",
"Endereco":
{
"TipoLogradouro": 23,
"Logradouro": "R OLAVO BARRETO VIANA",
"Numero": "1400",
"Bairro": "MOINHOS DE VENTO",
"Cep": "90570070",
"CodigoIBGEMunicipio": 4314902,
"Complemento": "Piso L2, Sala 09"
},
"Contato":
{
"Email": "suporte.mid@equals.com.br",
"CodigoArea": "51",
"Telefone": "99347-7032"
},
"ResponsavelLegal":
[{
"Nome" : "suporte",
"Email": "suporte.mid@equals.com.br",
"Telefone": "(22)99347-7032"
}],
"Logo": "{{Logo}}"
},
"Produtos": [{ "Id": 2 } ]
}
Possíveis Retornos HTTP:
- 200 - Sucesso
- 400 - BadRequest
- Caso tenha algum problema nas informações enviadas, causando falha na Solução Fiscal
- 401 - Unauthorized
- 404 – NotFound
- 429 - TooManyRequests
- 500 - InternalServerError
- 503 - Service Unavailable
Este conteúdo foi útil para você?