satcfe 0.0.6

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

É possível executar os testes contra qualquer equipamento SAT, em qualquer plataforma ou arquitetura, desde que você possua um kit de desenvolvimento, contendo o equipamento SAT e as bibliotecas do fabricante.

Warning

Embora seja bastante óbvio, não custa avisar: não execute estes testes contra um equipamento SAT em produção!

Para executar os testes em um ambiente Linux é preciso definir duas variáveis de ambiente para configurar o acesso à biblioteca SAT fornecida pelo fabricante do equipamento.

$ export SATCFE_TEST_DLL=/home/user/fabricante/linux/libsat.so
$ export SATCFE_TEST_DLLCONV=1

Antes de executar os testes propriamente, é conveniente revisar a parametrização no script runtests.sh. Dependendo do seu equipamento SAT, os valores para configuração dos dados do emitente e outros dados podem variar.

$ ./runtests.sh

Parametrização

As opções de parametrização dos testes são:

--codigo-ativacao

Código de ativação configurado no equipamento SAT.

--numero-caixa

Número do caixa de origem.

--assinatura-ac

Conteúdo da assinatura da AC.

--cnpj-ac

CNPJ da empresa desenvolvedora da AC (apenas dígitos).

--emitente-cnpj

CNPJ do estabelecimento emitente (apenas dígitos).

--emitente-ie

Inscrição estadual do emitente (apenas dígitos).

--emitente-im

Inscrição municipal do emitente (apenas dígitos).

--emitente-uf

Sigla da unidade federativa do estabelecimento emitente.

--emitente-issqn-regime

Regime especial de tributação do ISSQN do emitente, em casos de

testes de emissão de venda e/ou cancelamento.

--emitente-issqn-rateio

Indicador de rateio do desconto sobre o subtotal para produtos

tributados no ISSQN do emitente, em casos de testes de emissão de

venda e/ou cancelamento.

--dll-caminho

Caminho para a DLL/SO (shared library) SAT.

--dll-convencao

Convenção de chamada para a DLL/SO (shared library) SAT.

--skip-funcoes-sat

Ignora testes de todas as funções SAT evitando qualquer acesso ao

equipamento. Mesmo assim, nunca execute os testes contra um

equipamento em produção.

--skip-[funcao]

Permite evitar a execução de testes para uma função em particular,

substituindo [funcao] pelo nome da função SAT em letras minúsculas,

por exemplo, para evitar a execução da função ConsultarSAT use

--skip-consultarsat.

Executando Testes Manualmente

Se não quiser usar o script runtests.sh ou se estiver usando um ambiente Windows, poderá invocar a execução dos testes manualmente, por exemplo:

C> python setup.py test -a "--cnpj-ac=01234567000199 ..."