Giter Club home page Giter Club logo

node-dfe's Introduction

Quality Gate Status

node-dfe

Biblioteca para geração/integração de NF-e/NFC-e em aplicações node.js

HELP WANTED!!

OSS no Brasil é incrivelmente dificil, especialmente com o volume de trabalho e as cargas horarias que o mercado de trabalho brasileiro acaba impondo sob nossas vidas. Isso faz com que o tempo que tenhamos para investir em manutençao de projetos OS como esse acabe sendo bem reduzido (especialmente pela natureza "non profit" deste projeto). Portanto, se voce gostou da lib, ou se tem interesse em contribuir para algum projeto OS e ganhar alguma experiencia, sinta-se livre para enviar uma PR, ou apenas ajudar com as discussoes nos Issues abertos.

Entre no grupo do Discord https://discord.gg/P8WthxdtNy

Instalação

A instalação pode ser feita diretamente via npm/yarn. Nao é requerido nenhum passo adicional.

npm install node-dfe

Requisitos

NodeJs v8+, e um certificado A1 válido. Certificados tipo A3 nao sao suportados (mas fica ai uma PR bem interessante ;) )

Exemplo

const { NFeProcessor } = require('node-dfe')
const dadosEmpresa = {...}
const dadosNFe = {...}
const nfeProcessor = new NFeProcessor(dadosEmpresa)
const docEmitido = await nfeProcessor.processarDocumento(dadosNFe)

if (!docEmitido.success) {
    throw new Exception(docEmitido.error)
} else {
    const env = docEmitido.envioNF
    console.log(env.xml_recebido)
    console.log(env.data.retEnviNFe.protNFe.infProt.nProt)
}

Exemplos completos da estrutura podem ser vistos em test.js

Releases

As releases do node-dfe seguem as liberações de versao/NT da SEFAZ, no formato [MAJOR].[MINOR].[FIX], sendo que:

  • Major: Atualização do formato geral da NFe: Atualmente com a NFe 4.0, a node-dfe segue na versão '0'.
  • Minor: Atualização de Nota Tecnica da NFe: a node-dfe contempla a partir da NT2018.005 v1.20 como versao '0'
  • Fix: Correções e implementações internas da node-dfe.

Estado Atual e Proximos Passos

Atualmente a biblioteca suporta eventos de emissao de DF-es modelo 55 e 65 (NF-e e NFC-e) para todos os estados, nos modelos sincrono e assincrono. Rotinas como: Cancelamento, Carta de Correção e Inutilização, devem ser testadas em outras UF, foram feitos testes apenas em SP.

node-dfe's People

Contributors

lhfioravanso avatar lealhugui avatar tfiliano avatar hugofialho avatar dmux avatar samuelnovaes avatar fnunezzz avatar gestefane avatar vagnergon avatar jeffersoncbd avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.