Metadata-Version: 1.1
Name: satextrato
Version: 0.1
Summary: Impressão dos Extratos do CF-e-SAT
Home-page: http://github.com/base4sistemas/satextrato/
Author: Daniel Gonçalves
Author-email: daniel@base4.com.br
License: Apache Software License
Description: 
        Projeto Extratos CF-e-SAT
        =========================
        
        .. image:: https://img.shields.io/pypi/status/satextrato.svg
            :target: https://pypi.python.org/pypi/satextrato/
            :alt: Development status
        
        .. image:: https://img.shields.io/badge/python%20version-2.7-blue.svg
            :target: https://pypi.python.org/pypi/satextrato/
            :alt: Supported Python versions
        
        .. image:: https://img.shields.io/pypi/l/satextrato.svg
            :target: https://pypi.python.org/pypi/satextrato/
            :alt: License
        
        .. image:: https://img.shields.io/pypi/v/satextrato.svg
            :target: https://pypi.python.org/pypi/satextrato/
            :alt: Latest version
        
        .. image:: https://badges.gitter.im/Join%20Chat.svg
           :alt: Join the chat at https://gitter.im/base4sistemas/satcfe
           :target: https://gitter.im/base4sistemas/satcfe?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
        
        -------
        
            This project is about printing receipts from eletronic fiscal documents
            related to `SAT-CF-e`_ which is a system for autorization and transmission
            of fiscal documents, developed by Finance Secretary of state of São Paulo,
            Brazil. This entire project, variables, methods and class names, as well as
            documentation, are written in brazilian portuguese.
        
            Refer to the `oficial web site <http://www.fazenda.sp.gov.br/sat/>`_ for
            more information (in brazilian portuguese only).
        
        
        Emissão de extratos do `CF-e-SAT`_ diretamente a partir dos documentos
        eletrônicos que representam o CF-e de venda e/ou de cancelamento, na forma
        de arquivos em formato `XML`_.
        
        Esta implementação é baseada na emissão dos extratos para mini-impressoras,
        normalmente térmicas (mas não limitado à elas), através da abstração
        `PyESCPOS`_ para o sistema de comandos de impressão ESC/POS |reg| e derivações.
        
        Para comunicar-se com equipamentos SAT veja o `Projeto SATCFe`_.
        
        
        Exemplos de Uso
        ===============
        
        
        Extratos do CF-e de Venda
        -------------------------
        
        Para emitir um extrato de um CF-e de venda, você irá precisar do XML do CF-e-SAT
        de venda, que é o documento fiscal, e uma impressora ESC/POS |reg| (veja as
        implementações disponíveis no projeto `PyESCPOS`_):
        
        .. sourcecode:: python
        
            from escpos.serial import SerialConnection
            from escpos.impl.daruma import DR700
            from satextrato import ExtratoCFeVenda
        
            conn = SerialConnection.create('COM1:9600,8,1,N')
            impressora = DR700(conn)
            impressora.init()
        
            with open(r'C:\CFe351702.xml', 'r') as fp:
                extrato = ExtratoCFeVenda(fp, impressora)
                extrato.imprimir()
        
        
        Extratos do CF-e de Cancelamento
        --------------------------------
        
        Para emitir um extrato do CF-e-SAT de cancelamento, além do documento de
        cancelamento você também irá precisar do documento da venda, ao qual o documento
        de cancelamento se refere. Seguindo a mesma linha do exemplo anterior:
        
        .. sourcecode:: python
        
            with open('CFe_1.xml', 'r') as fvenda, open('CFeCanc_1.xml', 'r') as fcanc:
                extrato = ExtratoCFeCancelamento(fvenda, fcanc, impressora)
                extrato.imprimir()
        
        
        Mais Exemplos
        -------------
        
        Eventualmente, você poderá encontrar mais exemplos no `Wiki`_ do projeto.
        
        
        Executando Testes
        -----------------
        
        Para executar os testes de emissão dos extratos em impressoras conectadas
        à portas seriais, ou em impressoras USB a partir de virtualizadores de portas
        seriais:
        
        .. sourcecode:: shell
        
            $ python setup.py test -a \
                    "--escpos-impl=escpos.impl.daruma.DR700 "\
                    "--escpos-if=serial "\
                    "--serial-port=/dev/ttyS7"
        
        Para executar os testes em uma impressora conectada à rede, via TCP/IP no
        endereço ``192.168.1.200`` porta ``9100``:
        
        .. sourcecode:: shell
        
            $ python setup.py test -a \
                    "--escpos-impl=escpos.impl.epson.TMT20 "\
                    "--escpos-if=network "\
                    "--network-host=192.168.1.200 "\
                    "--network-port=9100 "
        
        ..
            Sphinx Documentation: Substitutions at
            http://sphinx-doc.org/rest.html#substitutions
            Codes copied from reStructuredText Standard Definition Files at
            http://docutils.sourceforge.net/docutils/parsers/rst/include/isonum.txt
        
        
        .. |reg|  unicode:: U+00AE .. REGISTERED SIGN
            :ltrim:
        
        
        .. _`CF-e-SAT`: http://www.fazenda.sp.gov.br/sat/
        .. _`SAT-CF-e`: http://www.fazenda.sp.gov.br/sat/
        .. _`PyESCPOS`: https://github.com/base4sistemas/pyescpos
        .. _`Projeto SATCFe`: https://github.com/base4sistemas/satcfe
        .. _`XML`: http://www.w3.org/XML/
        .. _`Wiki`: https://github.com/base4sistemas/satextrato/wiki
        
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Other Environment
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: Portuguese (Brazilian)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Office/Business :: Financial :: Point-Of-Sale
Classifier: Topic :: Printing
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
