Pular para o conteúdo principal

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
TagDescriçãoObrig.Obs
Empresa.Tipo Passar fixo 2 (CNPJ)Sim
Empresa.CNPJCPFCNPJ do emissorSim
Empresa.NomeFantasiaNome FantasiaSim
Empresa.RazaoSocialNomeRazão SocialSim
Empresa.InscricaoEstadualInscrição EstadualSim
Empresa.InscricaoMunicipalInscrição MunicipalNão*Campo obrigatório quando Produtos. Id = 3 NFS-e
Empresa.CodigoRegimeTributarioCódigo do Regime Tributário. Opções:

1 - Simples Nacional

2 - Simples Nacional - Excesso de sublimite de receita bruta

3 - Regime Normal
Sim
Empresa.CNAEClassificação Nacional das Atividades EconômicasSim
Empresa.CNPJFaturamentoCNPJ pagadorSim
Empresa.CNPJMatrizCNPJ Matriz. Poderá ser o mesmo CNPJ do emissor que está sendo cadastradoSim
Empresa.GrupoEconomicoDescrição do Grupo Econômico. Caso já exista Grupo Econômico vinculado a Raiz do CNPJ será mantido o existente.Sim
Empresa.Endereco.TipoLogradouroTipo de logradouro. Opções:

4 - Avenida

23 – Rua
Sim
Empresa.Endereco.LogradouroLogradouroSim
Empresa.Endereco.NumeroNúmero do LogradouroSim
Empresa.Endereco.BairroBairro do LogradouroSim
Empresa.Endereco.CepCEP do LogradouroSim
Empresa.Endereco.CodigoIBGEMunicipioCódigo IBGE do Município do LogradouroSim
Empresa.Endereco.ComplementoComplemento do LogradouroNão
Empresa.Contato.EmailE-mail de contatoSim
Empresa.Contato.CodigoAreaCódigo de área do telefone de contatoSim
Empresa.Contato.TelefoneTelefone de contato sem código de áreaSim
Empresa.ResponsavelLegalArray de Responsáveis Legais da EmpresaSim
Empresa.ResponsavelLegal.NomeNome do Responsável LegalSim
Empresa.ResponsavelLegal.EmailE-mail do Responsável LegalSim
E-mail do Responsável LegalxTelefone do Responsável LegalNão
Empresa.LogoEnviar a logo em base64Não
ProdutosListagem de produtos ativados para o emissor.Sim
Produtos. IdCó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ê?