Pular para o conteúdo principal
Ver como MarkdownDocs para agentes

Integração da Nota Fiscal Eletronica (NF-e / NFC-e)

A Nota fiscal eletrônica é o documento digital fiscal usada para a documentação de operaçóes de circulação de mercadorias ou prestação de serviço, seja transporte no mesmo estado, quanto entre estados.

Saiba mais: O que é nota fiscal eletrônica?

Ao final desse tutorial, você será capaz de:​

1. Emitir uma nota fiscal de produto

Próximos passos​

  1. Emitir uma nota fiscal eletrônica (NF-e/NFC-e) utilizando Motor de Cálculo de Tributos
  2. Consultar uma nota fiscal
  3. Consultar o XML de uma nota fiscal emitida
  4. Consultar o PDF (danfe) de uma nota fiscal emitida

Requisitos​

Tutorial​

A partir desse momento faremos uma breve explicação de como realizar a integração de Nota fiscal de Produto com a API oferecida pela NFE.io.

Veja mais sobre a Documentação da API

Você pode realizar a importação da url no Postman para ter todos os seguintes exemplos através do link:

https://api.postman.com/collections/13456751-f3769b82-5291-445b-b7bf-8fc0ffcab9b2?access_key=SEU_ACCESS_KEY_DO_POSTMAN

Tutorial de como importar a url no postman Clique aqui

Primeiros passos​

1. Emitir primeira nota fiscal​

Pronto, todos os passos antecessores de emissão de suas notas fiscais eletrônicas estão concluídos.

Colocamos um exemplo do mínimo de dados para serem informados à nossa API, caso precise ou queira verificar o restante da documentação, estará disponível em: Documentação completa.

Os campos mínimos para serem enviados são os dados do comprador (buyer) e os produtos (items).

Observação: Neste momento, caso você não tenha os dados de impostos:

  • NCM
  • CST/CSOSN - ICMS/PIS/COFINS
  • CFOP
  • CEST
  • GTIN
    Sugerimos que você avalie com seu contador como deverão ser preenchidos no contexto da sua empresa.
    Outra opção seria utilizar o motor de cálculo de imposto da NFE.io, que preenche automaticamente o grupo "tax". O motor é um serviço cobrado à parte da emissão — veja Motor de Cálculo de Tributos.

Caso você já tenha as informaçôes, preenchê-las corretamente e realizar a requisição de emissão de nota.

Atenção: Nosso processamento é realizado de forma assíncrona, portanto, o sucesso da requisição não significa que a nota fiscal já foi emitida. Realizamos uma breve validação no momento do envio e outras verificações no decorrer do processamento.

Abaixo, a url e um json de exemplo contendo os dados mínimos para a emissão de uma nota fiscal sem a utilização do motor de cálculo de imposto.

Observação: Substitua {companyId} pela ID gerada no passo de criação da empresa.

O método HTTP utilizada no envio da nota fiscal é o "POST", então verifique no seu postman se está preenchido corretamente.

POST: https://api.nfse.io/v2/companies/{companyId}/productinvoices

{
    "buyer": {
        "name": "teste",
        "address": {
            "city": {
                "code": "3550308",
                "name": "jundiai"
            },
            "state": "SP",
            "district": "centro",
            "street": "rua petronilha antunes",
            "postalCode": "13207760",
            "number": "204",
            "country": "BRA"
        },
        "federalTaxNumber": 8662968678
    },
    "items": [{
        "code": "2617",
        "unitAmount": 9.98,
        "quantity": 5,
        "cfop": 5102,
        "ncm": "47079000",
        "codeGTIN": "SEM GTIN",
        "codeTaxGTIN": "SEM GTIN",
        "tax": {
            "totalTax": 6,
            "icms": {
                "amount": 6,
                "rate": 18,
                "baseTax": 33.25,
                "baseTaxSTReduction": "33.33",
                "baseTaxModality": "3",
                "cst": "20",
                "origin": "0"
            },
            "pis": {
                "amount": 0,
                "rate": 0,
                "baseTax": 0,
                "cst": "06"
            },
            "cofins": {
                "amount": 0,
                "rate": 0,
                "baseTax": 0,
                "cst": "06"
            }
        },
        "cest": "",
        "description": "FEIJAO BOLINHA CAMIL 500G NF ENTRADA 1030099 14\/05\/2018"
    }]
}
  1. Você deverá enviar os dados preenchidos corretamente com as informações da sua nota fiscal e clicar no botão "Send" (Enviar).

  1. Ao sucesso da requisição, será fornecido uma ID da nota fiscal utilizada no processamento da emissão.

Importação da url do postman​

Novamente, fornecemos uma URL de importação no POSTMAN com todas essas requisiçôes já inclusas. Basta inserir sua Autorização em cada requisição e alterar os dados fornecidos.

https://api.postman.com/collections/13456751-f3769b82-5291-445b-b7bf-8fc0ffcab9b2?access_key=SEU_ACCESS_KEY_DO_POSTMAN

Próximos passos​

  1. Emitir uma nota fiscal de produto utilizando o Motor de Cálculo de Triutos
  2. Consultar o XML de uma nota fiscal emitida
  3. Consultar o PDF (danfe) de uma nota fiscal emitida

Veja também:​

NFE.io

A NFE.io é uma empresa de tecnologia que fornece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas. Com suas ferramentas, as empresas podem economizar tempo e reduzir erros, aumentando a eficiência e precisão do processo de emissão de notas fiscais.

Um dos principais cases de sucesso da NFE.io é a implementação da solução na empresa de transporte Rodonaves. Com a automatização da emissão e gestão de notas fiscais eletrônicas, a Rodonaves conseguiu reduzir em até 80% o tempo gasto nesse processo, o que se traduziu em uma significativa melhoria na eficiência operacional. Além disso, a empresa também conseguiu eliminar erros e atrasos na emissão de notas fiscais, o que melhorou a relação com seus clientes e aumentou a confiança dos órgãos fiscais.

Outro exemplo é a implementação da NFE.io na empresa de comércio eletrônico, a Loja Integrada. Com a automatização da emissão de notas fiscais, a Loja Integrada conseguiu aumentar a velocidade de emissão de notas em até 10 vezes, o que permitiu que a empresa atendesse a uma maior quantidade de clientes e, consequentemente, aumentar as suas vendas.

Além desses exemplos, a NFE.io também tem outros cases de sucesso com empresas de setores como indústria, construção, varejo e serviços, mostrando a versatilidade e eficácia da sua solução.

Em resumo, a NFE.io é uma empresa de tecnologia que oferece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas, ajudando as empresas a economizar tempo e reduzir erros, melhorando a eficiência e precisão do processo. Com cases de sucesso em diferentes setores, a NFE.io tem se destacado como uma empresa líder em automação fiscal.