Visão Geral
-----------

Biblioteca de interface com o webservice de Nota Fiscal Eletronica,
(NF-e/NFC-e) da SEFAZ, oficializada pelo Ministerio da Fazendo do 
Governo do Brasil.  
Desenvolvido e testado com Python 3 no GNU/Linux.

A NF-e visa substituir as notas fiscais séries 1 e 1A.  
A NFC-e visa substituir as notas fiscais modelo 2 e
cupom fiscal emitido por ECF.


Dependências
------------

- Java 8u51
  - para a geração da DANFE
- lxml
  - biblioteca de leitura e gravação de arquivos XML, de alta
    performance e fácil de implementar.
- xmlsec1 e openssl
  - assinatura e validação do XML
- requests
  - biblioteca para a comunicação com os webservices da SEFAZ

Referências
-----------

- Site oficial da Nota Fiscal eletrônica
  - http://www.nfe.fazenda.gov.br/portal/

- lxml
  - http://lxml.de/

- Tutorial de lxml
 - http://codespeak.net/lxml/tutorial.html

- requests
  - http://docs.python-requests.org/en/latest/
  - https://github.com/kennethreitz/requests
  - https://pypi.python.org/pypi/requests

- Exemplos de arquivos XML
  - http://www.javac.com.br/jc/downloads.javac?cat=3

- Schemas para validação dos arquivos
  - http://www.nfe.fazenda.gov.br/portal/schemas.aspx

- Validao de XML via XSD no lxml
 - http://codespeak.net/lxml/validation.html#xmlschema

- Lista de codigos para campo EX TIPI
 - http://www.fisconet.com.br/ipi/tipi/04.htm

- Certificado para testes
 - http://nf-eletronica.com/blog/?p=133

Instalação
-----------
```
 sudo pip3 install https://github.com/leotada/PyNFe/archive/master.zip
```

- Exemplos de uso

- Consulta Status

```python
from pynfe.processamento.comunicacao import ComunicacaoSefaz

certificado = "/home/user/certificado.pfx"
senha = 'senha'
uf = 'pr'
homologacao = True

con = ComunicacaoSefaz(uf, certificado, senha, homologacao)
xml = con.status_servico('nfe')
print (xml.text)
```

Documentação 
-----------
- https://github.com/leotada/PyNFe/wiki
- http://pynfe.readthedocs.org/pt/latest/