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

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

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=PMAT-01JKDTXTXB7DN8645BWG6K7C7K

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".

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"
    }]
}

Você deverá enviar os dados preenchidos corretamente com as informações da sua nota fiscal e clicar no botão "Send" (Enviar).

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=PMAT-01JKDTXTXB7DN8645BWG6K7C7K

Próximos passos

Veja também:

Our Score

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

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

Próximos passos

Requisitos

Tutorial

Primeiros passos

1. Emitir primeira nota fiscal

Importação da url do postman

Próximos passos

Veja também:

Não encontrou o que procura?