Bem-vindo ao Projeto SATHub¶
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 official web site for more information (in brazilian portuguese only).
Nota
This documentation is a work in progress
Nota
Esta documentação é um trabalho em andamento
Este projeto está relacionado à tecnologia SAT-CF-e para autorização e transmissão de documentos CF-e (Cupons Fiscais eletrônicos).
SATHub é um projeto open-source baseado em Flask e Flask-RESTful para prover uma API que possibilita que múltiplos pontos-de-venda (PDV) possam compartilhar um único equipamento SAT. Por se tratar de uma API RESTful, qualquer aplicação de ponto-de-venda pode invocar funções SAT, desde que seja capaz de fazer requisições HTTP simples.
Também fornece um frontend web leve para tornar possível o acesso às funções do equipamento SAT a partir de um navegador com suporte à HTML5.
Este projeto integra os projetos SATCFe e SATcomum para fornecer uma API
RESTful. Se o seu projeto já for baseado no projeto SATCFe, basta configurar
o acesso ao servidor SATHub e instanciar satcfe.ClienteSATHub ao
invés de instanciar satcfe.ClienteSATLocal.
Projetos Relacionados¶
Este projeto é apenas uma parte de um total de cinco projetos que compõem uma solução compreensível para a tecnologia SAT-CF-e em linguagem Python, disponíveis para integração nas aplicações de ponto-de-venda. São eles:
- Projeto SATComum
Mantém o código que é compartilhado pelos outros projetos relacionados, tais como validação, formatação e valores constantes.
- Projeto SATCFe
Fornece acesso ao equipamento SAT diretamente ou através de uma API RESTful, quando o equipamento SAT é compartilhado com mais de um ponto-de-venda.
- Projeto SATExtrato
Impressão dos extratos do CF-e-SAT. Este projeto é capaz de imprimir extratos de documentos de venda ou de cancelamento diretamente a partir dos documentos XML que os representam. A impressão tem um alto grau de compatibilidade com mini-impressoras (conhecidas como impressoras não-fiscais) já que é baseada na tecnologia Epson© ESC/POS® através do projeto PyESCPOS.
- Projeto PyESCPOS
Implementa o suporte à tecnologia Epson© ESC/POS® compatível com a imensa maioria das mini-impressoras disponíveis no mercado.
Participe¶
Participe deste projeto ou de qualquer um dos projetos relacionados. Se você for capaz de contribuir com código, excelente! Faça um clone do repositório, modifique o que acha que deve e faça o pull-request. Teremos prazer em aceitar o seu código.
Se você não quer (ou não pode) programar, também pode contribuir com documentação. Ou ainda, se você vir algo errado ou achar que algo não está certo, conte pra gente.