PyNFe/tests/01-basico.txt

TESTES BASICOS
==============

    >>> try:
    ...     set
    ... except:
    ...     from sets import Set as set
    <type 'set'>

A biblioteca deve fornecer uma colecao de utilitarios para consumir
o webservice da NF-e.

Componentes
-----------

A separacao entre os componentes da biblioteca deve seguir o seguinte
modelo:

  ---------------------------------------------------------------------
  |                         MODELO DE ENTIDADES                       |
  ---------------------------------------------------------------------
  |                                                                   |
  |                          ------------         --------------      |
  |                          | Entidade |-------<>| FonteDados |      |
  |                          ------------         --------------      |
  |                               A                                   |
  |                               |                                   |
  |           ----especializacao--------------------------            |
  |           |            |            |                |            |
  |     ------------  -----------  -----------  ------------------    |
  |     | Emitente |  | Produto |  | Cliente |  | Transportadora |    |
  |     ------------  -----------  -----------  ------------------    |
  |          *|           *|           *|               *|            |
  |           ------------------------------associacao----            |
  |                    |                                              |
  |                    V*                                             |
  |             ---------------        ----------------               |
  |             | Nota Fiscal |------<>| Lote de NF-e |               |
  |             --------------- 1    * ----------------               |
  |                                                                   |
  ---------------------------------------------------------------------


  ----------------------------------------------------------------------------
  |                               PROCESSAMENTO                              |
  ----------------------------------------------------------------------------
  |                                                                          |
  | -------------------   --------------    -------------------------------- |
  | | SerializacaoXML |   | Assinatura |    | Comunicacao                  | |
  | -------------------   --------------    -------------------------------- |
  | | exportar()      |   | assinar()  |    | transmitir()                 | |
  | | importar()      |   --------------    | cancelar()                   | |
  | -------------------                     | situacao_nfe()               | |
  |                 ----------------------  | status_servico()             | |
  | --------------  | Validacao          |  | consultar_cadastro()         | |
  | | DANFE      |  ----------------------  | inutilizar_faixa_numeracao() | |
  | --------------  | validar_arquivos() |  -------------------------------- |
  | | imprimir() |  | validar_xml()      |                                   |
  | --------------  | validar_etree()    |                                   |
  |                 | validar_objetos()  |                                   |
  |                 ----------------------                                   |
  |                                                                          |
  ----------------------------------------------------------------------------

Os pacotes da biblioteca sao:

- utils (contem todas as funcionalidades utilitarias dentro da 
  biblioteca, incluindo flags e funcoes genericas)

    >>> from pynfe import utils
    >>> set([attr for attr in dir(utils) if not attr.startswith('__')]) >= set(['flags'])
    True

- entidades (contem todas as entidades da biblioteca)

    >>> from pynfe import entidades
    >>> set([attr for attr in dir(entidades) if not attr.startswith('__')]) == set([
    ...     'Cliente', 'Emitente', 'LoteNotaFiscal', 'NotaFiscal', 'Produto',
    ...     'Transportadora', 'base', 'cliente', 'emitente', 'lotes', 'notafiscal',
    ...     'produto', 'transportadora', 'fonte_dados', '_fonte_dados','certificado',
    ...     'CertificadoA1'])
    True

- processamento (contem todas as funcionalidades de processamento da
  biblioteca

    >>> from pynfe import processamento
    >>> set([attr for attr in dir(processamento) if not attr.startswith('__')]) == set([
    ...     'Assinatura', 'Comunicacao', 'DANFE', 'InterfaceXML', 'Validacao',
    ...     'assinatura', 'comunicacao', 'danfe', 'interfaces', 'validacao'])
    True

Ha ainda uma pasta dentro da pasta 'pynfe', chamada 'data', que deve
armazenar listas longas de municipios, CNAEs, situacoes tributarias,
XSD's, etc.

    >>> import os
    >>> DATA = os.path.join(os.curdir, 'pynfe', 'data')
    >>> DATA
    './pynfe/data'

    >>> os.path.isdir(DATA)
    True

Geracao e importacao de XML
---------------------------

As objetos Python devem ser traduzidos para arquivos XML e o caminho
inverso, de introspecao, tambem deve ser feito, atraves de uma fabrica.

    >>> from pynfe.processamento.interfaces import Interface

    >>> bool(Interface.exportar)
    True

    >>> bool(Interface.importar)
    True

A classe basica de Interface eh abstrata, ou seja, nao pode ser
instanciada diretamente.

    >>> lista_de_nfs = []

    >>> try:
    ...     Interface(lista_de_nfs)
    ... except Exception, e:
    ...     print e.message
    Esta classe nao pode ser instanciada diretamente!

Classe de interface especifica para XML, usando lxml

    >>> from pynfe.processamento.interfaces import InterfaceXML

Esse procedimento sera feito por padrao atraves da lxml, devido ao seu
desempenho, mas pode ser extendido para outros formatos, dependendo do
objetivo pretendido.

    >>> try:
    ...   from lxml import etree
    ... except ImportError:
    ...   try:
    ...     # Python 2.5
    ...     import xml.etree.cElementTree as etree
    ...   except ImportError:
    ...     try:
    ...       # Python 2.5
    ...       import xml.etree.ElementTree as etree
    ...     except ImportError:
    ...       try:
    ...         # normal cElementTree install
    ...         import cElementTree as etree
    ...       except ImportError:
    ...         try:
    ...           # normal ElementTree install
    ...           import elementtree.ElementTree as etree
    ...         except ImportError:
    ...           print("A importacao do lxml falhou")

Consumacao de WebService
------------------------

O webservice a ser consumido esta no padrao SOAP, que no Python sera
interpretado pela biblioteca SUDS.

    >>> import suds

Para executar estes testes é preciso instalar a soaplib, para servir
WSDL via SOAP, num servidor falso (mock).

    >>> import soaplib

Certificados Digitais
---------------------

A biblioteca deve suportar certificados digitais X.509 v.3 do tipo
A1. O tipo A3 é certificado por hardware e provavelmente bem mais
complexo de colocar em prática.

eCNPJ A1

A3 depende de configurar seu numero de serie. No Windows
usa-se a DLL CAPICOM. Ao que tudo indica, o OpenSSL nao suporta esse
tipo.

A transmissao utiliza SSL3.

No Windows o arquivo é usado como .pfx (pkcs12)

No Linux o arquivo deve ser convertido para .pem

Impressao do DANFE
------------------

Alem disso, deve gerar PDFs da DANFE, utilizando a engine Geraldo
Reports.

    >>> import geraldo
    >>> import PIL
    >>> from pynfe.utils import bar_code_128