satcfe 0.0.5

Abstração do acesso ao equipamento SAT (SAT-CF-e)

---

This project is about 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 for more information (in brazilian portuguese only).

Este projeto refere-se à tecnologia SAT-CF-e desenvolvida pela Secretaria da Fazenda do Estado de São Paulo e faz parte de um grupo de cinco projetos que resolvem problemas específicos, mas relacionados.

Especificamente, este projeto é uma abstração que fornece acesso às funções da biblioteca SAT, que é fornecida pelos fabricantes de equipamentos SAT. Para maiores informações, consulte a documentação do projeto.

Se estiver procurando meios para emitir um extrato do CF-e-SAT, o Projeto SATExtrato pode ajudar.

Utilização

Este é um exemplo básico de uso, para consultar o equipamento SAT:

>>> from satcomum import constantes
>>> from satcfe import DLLSAT
>>> from satcfe import ClienteSATLocal
>>> from satcfe import conf

>>> conf.codigo_ativacao = '123456789'

>>> cliente = ClienteSATLocal(DLLSAT(
...        caminho='/caminho/para/sat.dll',
...        convencao=constantes.WINDOWS_STDCALL))

>>> resposta = cliente.consultar_sat()
>>> resposta.mensagem
u'SAT em Opera\xe7\xe3o'

Executando os Testes

Para executar os testes faça:

$ python setup.py test

Em ambientes Microsoft® Windows™, é possível executar uma série de testes contra o equipamento SAT. Atualmente estão implementados testes apenas o equipamento SAT D-Sat™ da Dimep®. Como a implementação em si independe do fabricante do equipamento SAT é fácil alterar os testes para executar contra quaisquer outros equipamentos SAT disponíveis.

> python setup.py test -a "--cnpj-ac=01234567000199 --codigo-ativacao=123"