nfelib: electronic invoicing library for Brazil


Keywords
e-invoicing, NFe, ERP, Odoo, NFSe, CTe, MDFe, BPe, brasil, nota-fiscal-eletronica, python, sped
License
MIT
Install
pip install nfelib==2.0.4

Documentation

nfelib - bindings Python para e ler e gerir XML de NF-e, NFS-e nacional, CT-e, MDF-e, BP-e

PyPI Downloads

Porque escolher a nfelib

  • Simples e confi√°vel. As outras bibliotecas costumam ter dezenas de milhares de linhas de c√≥digo feito tudo manualmente para fazer o que o nfelib faz tudo automaticamente com algumas linhas para gerir c√≥digo com o¬†xsdata¬†a partir dos √ļltimos pacotes xsd da Fazenda. O xsdata √© uma biblioteca de databinding extremamente bem escrita e bem testada. A pr√≥pria nfelib tem testes para ler e gerir todos documentos fiscais.
  • Completa: j√° que gerir os bindings ficou trivial, a nfelib mant√©m atualizada todos os bindings para interagir com todos os servi√ßos e eventos de NF-e, NFS-e nacional, CT-e, MDF-e, BP-e. Os testes detetam tamb√©m quando sai uma nova vers√£o de algum esquema.

Instalação

pip install nfelib

Como usar

NF-e

>>> # Ler o XML de uma NF-e:
>>> from nfelib.nfe.bindings.v4_0.proc_nfe_v4_00 import NfeProc
>>> nfe_proc = NfeProc.from_path("nfelib/nfe/samples/v4_0/leiauteNFe/NFe35200159594315000157550010000000012062777161.xml")
>>> # (pode ser usado também o metodo from_xml(xml) )
>>>
>>> nfe_proc.NFe.infNFe.emit.CNPJ
'59594315000157'
>>> nfe_proc.NFe.infNFe.emit
Tnfe.InfNfe.Emit(CNPJ='59594315000157', CPF=None, xNome='Akretion LTDA', xFant='Akretion', enderEmit=TenderEmi(xLgr='Rua Paulo Dias', nro='586', xCpl=None, xBairro=None, cMun='3501152', xMun='Alumínio', UF=<TufEmi.SP: 'SP'>, CEP='18125000', cPais=<TenderEmiCPais.VALUE_1058: '1058'>, xPais=<TenderEmiXPais.BRASIL: 'Brasil'>, fone='2130109965'), IE='755338250133', IEST=None, IM=None, CNAE=None, CRT=<EmitCrt.VALUE_1: '1'>)
>>> nfe_proc.NFe.infNFe.emit.enderEmit.UF.value
'SP'
>>>
>>> # Serializar uma NF-e:
>>> nfe_proc.to_xml()
'<?xml version="1.0" encoding="UTF-8"?>\n<nfeProc xmlns="http://www.portalfiscal.inf.br/nfe" versao="4.00">\n  <NFe>\n    <infNFe versao="4.00" Id="35200159594315000157550010000000012062777161">\n      <ide>\n        <cUF>35</cUF>\n        <cNF>06277716</cNF>\n        <natOp>Venda</natOp>\n        <mod>55</mod>\n        <serie>1</serie>\n        <nNF>1</nNF>\n        <dhEmi>2020-01-01T12:00:00+01:00</dhEmi>\n        <dhSaiEnt>2020-01-01T12:00:00+01:00</dhSaiEnt>\n        <tpNF>1</tpNF>\n        <idDest>1</idDest>\n [...]
>>>
>>> # Montar uma NFe do zero:
>>> from nfelib.nfe.bindings.v4_0.nfe_v4_00 import Nfe
>>> nfe=Nfe(infNFe=Nfe.InfNfe(emit=Nfe.InfNfe.Emit(xNome="Minha Empresa", CNPJ='59594315000157')))
>>> nfe
Nfe(infNFe=Tnfe.InfNfe(ide=None, emit=Tnfe.InfNfe.Emit(CNPJ='59594315000157', CPF=None, xNome='Minha Empresa', xFant=None, enderEmit=None, IE=None, IEST=None, IM=None, CNAE=None, CRT=None), avulsa=None, dest=None, retirada=None, entrega=None, autXML=[], det=[], total=None, transp=None, cobr=None, pag=None, infIntermed=None, infAdic=None, exporta=None, compra=None, cana=None, infRespTec=None, infSolicNFF=None, versao=None, Id=None), infNFeSupl=None, signature=None)
>>> 
>>> # Validar o XML de uma nota:
>>> nfe.validate_xml()
["Element '{http://www.portalfiscal.inf.br/nfe}infNFe': The attribute 'versao' is required but missing.", "Element '{http://www.portalfiscal.inf.br/nfe}infNFe': The attribute 'Id' is required but missing." [...]

NFS-e padr√£o nacional

>>> # Ler uma NFS-e:
>>>> from nfelib.nfse.bindings.v1_0.nfse_v1_00 import Nfse
>>> nfse = Nfse.from_path("alguma_nfse.xml")
>>>
>>> # Serializar uma NFS-e:
>>> nfse.to_xml()
>>> # Ler uma DPS:
>>>> from nfelib.nfse.bindings.v1_0.dps_v1_00 import Dps
>>> dps = Nfse.from_path("nfelib/nfse/samples/v1_0/GerarNFSeEnvio-env-loterps.xml")
>>>
>>> # Serializar uma DPS:
>>> dps.to_xml()

MDF-e

>>> # Ler um MDF-e:
>>>> from nfelib.mdfe.bindings.v3_0.mdfe_v3_00 import Mdfe
>>> mdfe = Mdfe.from_path("nfelib/mdfe/samples/v3_0/ComPagtoPIX_41210780568835000181580010402005751006005791-procMDFe.xml")
>>>
>>> # Serializar um MDF-e:
>>> mdfe.to_xml()

CT-e

>>> # Ler um CT-e:
>>>> from nfelib.cte.bindings.v4_0.cte_v4_00 import Cte
>>> cte = Cte.from_path("nfelib/cte/samples/v4_0/43120178408960000182570010000000041000000047-cte.xml")
>>>
>>> # Serializar um CT-e:
>>> cte.to_xml()

BP-e

>>> # Ler um BP-e:
>>>> from nfelib.bpe.bindings.v1_0.bpe_v1_00 import Bpe
>>> bpe = Bpe.from_path("algum_bpe.xml")
>>>
>>> # Serializar um BP-e:
>>> bpe.to_xml()

Desenvolvimento / testes

Para rodar os testes:

pytest

Para atualizar os bindings:

  1. baixar o novo zip dos esquemas e atualizar a pasta nfelib/<nfe|nfse|cte|mdfe|bpe>/schemas/<versao>/

  2. gerir os bindings de um pacote de esquemas xsd, por examplo da NF-e:

    xsdata generate nfelib/nfe/schemas/v4_0 --package nfelib.nfe.bindings.v4_0

Para gerir todos bindings com xsdata:

./script.sh

Vers√Ķes dos esquemas e pastas

A nfelib usa apenas 2 d√≠gitos para caracterizar a vers√£o. Isso foi decidido observando que a Fazenda nunca usa o terceiro d√≠gito da vers√£o e que a mudan√ßa do segundo d√≠gito j√° caracteriza uma mudan√ßa maior. Nisso qualquer altera√ß√£o de esquema que n√£o mudar o primeiro nem o segundo d√≠gito da vers√£o do esquema vai na mesma pasta e se sobreponha a antiga vers√£o, assumindo que √© poss√≠vel usar o mais novo esquema no lugar do antigo (por exemplo √© poss√≠vel ler uma NFe 4.00 pacote n¬ļ 9j (NT 2022.003 v.1.00b) com os bindings da vers√£o nfe pacote n¬ļ 9k (NT 2023.001 v.1.20).

Pelo contr√°rio, caso houver uma mudan√ßa maior afetando os 2 primeiros d√≠gitos como NFe 3.0 e NFe 3.1 ou NFe 3.1 e NFe 4.0, ser√° poss√≠vel tamb√©m suportar as v√°rias vers√Ķes ao mesmo tempo usando pastas diferentes. Assim seria poss√≠vel por exemplo emitir a futura NFe 5.0 e ainda importar uma NFe 4.0.