Exemplo de requisições

Este documento apresenta exemplos de requisições válidas para emissão de cada tipo de nota fiscal suportado pela API, com dados reais prontos para uso em produção.

Simples Nacional vs. Regime Normal — Qual a diferença?

A principal diferença na emissão de NF-e entre empresas optantes e não optantes pelo Simples Nacional está na forma como o ICMS é informado:

Campo	Simples Nacional	Regime Normal (Lucro Real/Presumido)
Campo ICMS usado	`situacaoTributariaSimplesNacional`	`situacaoTributaria`
Base de cálculo / Alíquota / Valor ICMS	Geralmente zerados (recolhido via DAS)	Calculados conforme a alíquota do estado
PIS e COFINS	Zerados (incluídos no DAS)	Calculados com alíquota e base de cálculo
IBS/CBS (Reforma Tributária)	Não se aplica	Informado em `ibscbs` nos itens e no total
Campo `modalidadeBaseCalculo`	Não utilizado	Obrigatório

Resumo prático: empresas do Simples Nacional recolhem ICMS, PIS e COFINS de forma unificada no DAS, por isso esses campos vêm zerados na nota. Empresas fora do Simples calculam e destacam cada tributo individualmente na NF-e, e a partir da Reforma Tributária também devem informar o IBS e o CBS.

1. NF-e — Nota Fiscal Eletrônica de Produto

Endpoint:
Emitir nota de produto

Ambiente: o campo "ambiente": "1" indica produção. Use "ambiente": "2" para homologação (testes).

1.1 NF-e — Optante pelo Simples Nacional

{
  "ambiente": "1",
  "idExterno": "{{uuid_v4}}",
  "naturezaOperacao": "Venda",
  "emitente": {
    "cnpj": "03610650000147"
  },
  "destinatario": {
    "nome": "DIGISAN TECNOLOGIA",
    "cpfCnpj": "03610650000147",
    "inscricaoEstadual": "0747368200125",
    "indicadorInscricaoEstadual": "1",
    "tipoPessoa": "JURIDICA",
    "endereco": {
      "uf": "DF",
      "municipio": {
        "codigoIbge": "5300108",
        "nome": "Brasília"
      },
      "logradouro": "SCS QUADRA 06 BLOCO A Nº 141 SALA",
      "complemento": "ASA SUL",
      "numero": "106",
      "bairro": "Vicente Pires",
      "cep": "70327900"
    }
  },
  "itens": [
    {
      "codigo": "123",
      "cfop": "5102",
      "descricao": "Produto de Teste",
      "icms": {
        "situacaoTributariaSimplesNacional": "102",
        "origem": "0",
        "baseCalculo": 0,
        "aliquota": 0,
        "valor": 0
      },
      "pis": {
        "situacaoTributaria": "07",
        "baseCalculo": 0,
        "aliquota": 0,
        "valor": 0
      },
      "cofins": {
        "situacaoTributaria": "07",
        "baseCalculo": 0,
        "aliquota": 0,
        "valor": 0
      },
      "ipi": {
        "situacaoTributaria": "53",
        "baseCalculo": 0,
        "aliquota": 0,
        "valor": 0,
        "codigoEnquadramento": "999"
      },
      "ncm": "85432000",
      "unidadeComercial": "un",
      "valorUnitario": 10.00,
      "quantidade": 1,
      "valorBruto": 10.00,
      "valorLiquido": 10.00
    }
  ],
  "pagamentos": [
    {
      "forma": "15",
      "valor": 10.00
    }
  ],
  "total": {
    "baseCalculoICMS": 0,
    "valorICMS": 0,
    "valorProdutos": 10.00,
    "valorPIS": 0,
    "valorCOFINS": 0,
    "valorTotalNfe": 10.00
  },
  "informacoesAdicionais": "NF AUTOMATICA DE TESTE"
}

Observações Simples Nacional:
O campo situacaoTributariaSimplesNacional substitui o situacaoTributaria no bloco icms
Código 102 indica CSOSN — tributado pelo Simples, sem permissão de crédito
PIS/COFINS e ICMS ficam zerados — o recolhimento ocorre via DAS
O bloco ipi com CST 53 e codigoEnquadramento: "999" indica IPI não tributável

1.2 NF-e — Não Optante pelo Simples Nacional

{
  "ambiente": "1",
  "idExterno": "3da8b9fa-1cb5-45eb-a2c0-44444121",
  "naturezaOperacao": "Venda",
  "emitente": {
    "cnpj": "03610650000147"
  },
  "destinatario": {
    "nome": "DIGISAN TECNOLOGIA",
    "cpfCnpj": "03610650000147",
    "inscricaoEstadual": "0747368200125",
    "indicadorInscricaoEstadual": "1",
    "tipoPessoa": "JURIDICA",
    "endereco": {
      "uf": "DF",
      "municipio": {
        "codigoIbge": "5300108",
        "nome": "Brasília"
      },
      "logradouro": "SCS QUADRA 06 BLOCO A Nº 141 SALA",
      "complemento": "ASA SUL",
      "numero": "106",
      "bairro": "Vicente Pires",
      "cep": "70327900"
    }
  },
  "itens": [
    {
      "codigo": "123",
      "cfop": "5102",
      "descricao": "Produto de Teste",
      "icms": {
        "situacaoTributaria": "00",
        "origem": "0",
        "modalidadeBaseCalculo": "0",
        "baseCalculo": 10.00,
        "aliquota": 18.00,
        "valor": 1.80
      },
      "pis": {
        "situacaoTributaria": "01",
        "baseCalculo": 10.00,
        "aliquota": 0.65,
        "valor": 0.065
      },
      "cofins": {
        "situacaoTributaria": "01",
        "baseCalculo": 10.00,
        "aliquota": 3.00,
        "valor": 0.30
      },
      "ibscbs": {
        "cst": "000",
        "codigoClassificacaoTributaria": "000001",
        "baseCalculo": 10.00,
        "uf": {
          "aliquota": 0.1,
          "valor": 0.01
        },
        "valorIbs": 0.01,
        "cbs": {
          "aliquota": 0.9,
          "valor": 0.09
        }
      },
      "ncm": "85432000",
      "unidadeComercial": "un",
      "valorUnitario": 10.00,
      "quantidade": 1,
      "valorBruto": 10.00,
      "valorLiquido": 10.00
    }
  ],
  "pagamentos": [
    {
      "forma": "15",
      "valor": 10.00
    }
  ],
  "total": {
    "baseCalculoICMS": 10.00,
    "valorICMS": 1.80,
    "valorProdutos": 10.00,
    "valorPIS": 0.065,
    "valorCOFINS": 0.30,
    "valorTotalNfe": 10.00,
    "ibscbs": {
      "baseCalculo": 10.00,
      "ibs": {
        "valorIbsUf": 0.01,
        "valorIbs": 0.01
      },
      "cbs": {
        "valorCbs": 0.09
      }
    }
  },
  "informacoesAdicionais": "NF AUTOMATICA DE TESTE"
}

Observações Regime Normal:
O campo situacaoTributaria: "00" indica ICMS tributado integralmente
modalidadeBaseCalculo: "0" indica base de cálculo por valor da operação
PIS (0,65%) e COFINS (3,00%) são destacados com base e alíquota reais
O bloco ibscbs é exigido pela Reforma Tributária — deve ser informado nos itens e no total da nota
IBS = Imposto sobre Bens e Serviços (substituirá ICMS e ISS); CBS = Contribuição sobre Bens e Serviços (substituirá PIS e COFINS)

2. NFC-e — Nota Fiscal de Consumidor Eletrônica

A NFC-e é destinada a vendas diretas ao consumidor final (varejo). Diferente da NF-e, não possui bloco de destinatário — a venda é anônima ao consumidor.

Endpoint:
Emitir nota de consumidor

2.1 NFC-e — Optante pelo Simples Nacional

{
  "ambiente": "1",
  "idExterno": "1231231321312",
  "naturezaOperacao": "Venda",
  "emitente": {
    "cnpj": "03610650000147"
  },
  "itens": [
    {
      "codigo": "123",
      "cfop": "5102",
      "descricao": "Produto de Teste",
      "icms": {
        "situacaoTributariaSimplesNacional": "102",
        "origem": "0",
        "baseCalculo": 0,
        "aliquota": 0,
        "valor": 0
      },
      "pis": {
        "situacaoTributaria": "07",
        "baseCalculo": 0,
        "aliquota": 0,
        "valor": 0
      },
      "cofins": {
        "situacaoTributaria": "07",
        "baseCalculo": 0,
        "aliquota": 0,
        "valor": 0
      },
      "ncm": "85432000",
      "unidadeComercial": "un",
      "valorUnitario": 10.00,
      "quantidade": 1,
      "valorBruto": 10.00,
      "valorLiquido": 10.00
    }
  ],
  "pagamentos": [
    {
      "forma": "15",
      "valor": 10.00
    }
  ],
  "total": {
    "baseCalculoICMS": 0,
    "valorICMS": 0,
    "valorProdutos": 10.00,
    "valorPIS": 0,
    "valorCOFINS": 0,
    "valorTotalNfe": 10.00
  },
  "informacoesAdicionais": "NF AUTOMATICA DE TESTE"
}

Observações NFC-e:
Sem bloco destinatario — venda ao consumidor final anônimo
A NFC-e não possui bloco de IPI
O CFOP 5102 indica venda de mercadoria adquirida de terceiros
Forma de pagamento 15 = boleto bancário; 01 = dinheiro; 03 = cartão de crédito; 04 = cartão de débito

3. NFS-e Nacional — Nota Fiscal de Serviços Eletrônica

A NFS-e Nacional segue o padrão da Receita Federal e é válida para municípios que aderiram ao sistema nacional. Diferente dos sistemas municipais próprios, ela usa campos padronizados federais como cnae, codigoNbs e o bloco ibscbs da Reforma Tributária.

Endpoint:
Emitir nota de serviço

3.1 NFS-e Nacional

{
  "idExterno": "10140",
  "competencia": "2026-03-25",
  "enviarPorEmail": false,
  "prestador": {
    "cnpj": "51504295000174"
  },
  "tomador": {
    "nome": "DIGISAN TECNOLOGIA",
    "cpfCnpj": "03610650000147",
    "inscricaoMunicipal": "0747368200125",
    "tipoPessoa": "JURIDICA",
    "endereco": {
      "uf": "DF",
      "municipio": {
        "codigoIbge": "5300108",
        "nome": "Brasília"
      },
      "logradouro": "SCS QUADRA 06 BLOCO A Nº 141 SALA",
      "complemento": "ASA SUL",
      "numero": "106",
      "bairro": "Vicente Pires",
      "cep": "70327900"
    }
  },
  "servico": {
    "descricao": "Meu serviço de teste",
    "cnae": "8599603",
    "codigoMunicipio": "5002704",
    "codigoMunicipioIncidencia": "5002704",
    "itemListaServicoLC116": "080201",
    "codigoTributacaoMunicipio": "001",
    "indicadorExigibilidade": "1",
    "issRetido": false,
    "valorServicos": 1500.00,
    "aliquotaIss": 0,
    "valorIss": 0,
    "ibscbs": {
      "cst": "000",
      "codigoClassificacaoTributaria": "000001",
      "codigoIndicadorOperacao": "100301"
    },
    "codigoNbs": "114061900"
  },
  "informacoesAdicionais": "Teste"
}

Observações NFS-e Nacional:
competencia define o mês de referência do serviço prestado (formato YYYY-MM-DD)
cnae identifica a atividade econômica do serviço
itemListaServicoLC116 é o código do serviço conforme a Lei Complementar 116/2003
codigoNbs é o código da Nomenclatura Brasileira de Serviços, exigido pela NFS-e Nacional
O bloco ibscbs é parte da Reforma Tributária e já deve ser informado mesmo com alíquotas em transição
codigoIndicadorOperacao: "100301" indica operação de serviço sujeita ao IBS/CBS
indicadorExigibilidade: "1" = ISS exigível; issRetido: false = ISS não retido na fonte

Exemplo de requisições

Simples Nacional vs. Regime Normal — Qual a diferença?#

1. NF-e — Nota Fiscal Eletrônica de Produto#

1.1 NF-e — Optante pelo Simples Nacional#

1.2 NF-e — Não Optante pelo Simples Nacional#

2. NFC-e — Nota Fiscal de Consumidor Eletrônica#

2.1 NFC-e — Optante pelo Simples Nacional#

3. NFS-e Nacional — Nota Fiscal de Serviços Eletrônica#

3.1 NFS-e Nacional#