Pular para o conteúdo principal

Empresas

Vários serviços na Nuvem Fiscal exigem que você cadastre previamente uma ou mais empresas em nome das quais os serviços serão efetuados. Por exemplo, para emitir um documento fiscal, realizar consultas, etc.

O processo completo envolve:

tip

Você pode cadastrar quantas empresas quiser. Se você é uma software house, em geral para cada um dos seus clientes você cadastrará uma empresa na Nuvem Fiscal, e isso pode ser feito de forma 100% automatizada pela nossa API.

Cadastro da empresa​

A API fornece vários endpoints para as operações com empresas, sendo o principal o endpoint Cadastrar empresa. Basicamente você precisa fazer uma requisição POST enviando os dados da empresa via JSON:

POST https://api.nuvemfiscal.com.br/empresas
Content-Type: application/json

{
    "cpf_cnpj": "72645363000112",
    "inscricao_estadual": "12345",
    "inscricao_municipal": "12345",
    "nome_razao_social": "Empresa Ficticia Ltda.",
    "email": "[email protected]",
    "endereco": {
       "logradouro": "Rua Existente",
       "numero": "1234",
    ...
{}
info

A requisição acima é um exemplo resumido para efeito de ilustração. Consulte a documentação do endpoint Cadastrar empresa para saber todos os detalhes.

Cadastro do certificado digital​

Uma vez cadastrada a empresa, você deve atualizar seu certificado digital. Use o endpoint Cadastrar certificado para essa operação. Basta fazer uma requisição PUT para o endpoint do certificado da empresa enviando os dados via JSON:

PUT https://api.nuvemfiscal.com.br/empresas/72645363000112/certificado
Content-Type: application/json

{
    "certificado": "Q29udGXDumRvIGZpY3TDrWNpbyBkbyBjZXJ0aWZpY2Fkbw==",
    "password": "12345"
}
info

O campo certificado deve conter o certificado digital codificado em Base64.

Configuração do serviço​

Além do cadastro da empresa e do certificado, alguns serviços da API também exigem que você forneça os dados de configuração para aquele serviço, para uma empresa específica. Por exemplo, para uso do serviço de nota fiscal de serviços eletrônica você precisa informar números iniciais como série e lote, etc.

PUT https://api.nuvemfiscal.com.br/empresas/72645363000112/nfse
Content-Type: application/json

{
    "rps": {
        "lote": 512,
        "serie": "NF",
        "numero": 10
    },
    "ambiente": "producao"
}
info

O exemplo acima é meramente ilustrativo. Cada serviço possui sua forma específica de configuração.

Listamos abaixo os serviços que possuem configuração. Clique em cada um deles para visualizar detalhes do endpoint e como realizar efetivamente a configuração.