API PHP para integração com o Sistema de Fiscalização Integrada de Gestão (e-Sfinge) do Tribunal de Contas do Estado de Santa Catarina
sped-esfinge é um framework que permite a integração de um aplicativo com os serviços do projeto e-Sfinge do TCE/SC, realizando a montagem das mensagens SOAP usando Web Services Security (especificação publicada pela OASIS), com username e password fornecidos pelo TCE/SC.
O Sistema de Fiscalização Integrada de Gestão (e-Sfinge) é um conjunto de aplicativos integrados, relacionados à atividade-fim do TCE/SC. O e-Sfinge recebe as informações sobre as contas públicas enviadas pelos agentes públicos e consolida os dados de gestão em remessas unificadas, emite relatórios automáticos de avaliação, analisa a gestão de cada município e do Estado, ampliando a publicidade das informações. O acesso ao e-Sfinge — incluindo módulos Aposentadoria e Pensão, Instrução Normativa 21/2015, Instrução Normativa 22/2015, e-Sfinge Web, Obras e Sala Virtual — é restrito às unidades jurisdicionadas.
Esse sistema abrange mais de 60 serviços, porém serão implementados apenas em função da necessidade.
Implementação dos serviços
- Token (obter, iniciar a transferência, finalizar a tranferência, cancelar a tranferência e obter situação do token)
- Servidor (enviar e listar)
- SituacaoServidorFolhaPagamento (enviar e listar)
- ComponentesFolhaPagamento (enviar e listar)
- FolhaPagamento (enviar e listar)
A fase dois com a implementação de outros serviços, será feita apenas quando surgir essa necessidade.
Via Composer
$ composer require nfephp-org/sped-esfinge
Estes serviços são fornecidos todos pela classe Tools, sem a necessidade de utilização de outras classes. Para instaciar a classe Tools é necessária a criação de um arquivo (ou string) de configuração no formato json, com a seguinte estrutura:
config.json
{
"tpAmb": 2,
"username": "fulano",
"password": "senha",
"codigoUnidadeGestora": "12345",
"pathFiles": "\/var\/esfinge",
"aProxyConf": {
"proxyIp": "",
"proxyPort": "",
"proxyUser": "",
"proxyPass": ""
}
}
NOTA: o pathFiles é um diretório, com permissões de acesso, onde serão gravados os LOGS da comunicação SOAP, para posterior analise e verificação de falhas e correção de BUGS, e também permite que em caso de falha na gravação das informações em uma base de dados essas informações possam ser recuperadas.
IMPORTANTE: periódicamente esses arquivos devem ser eliminados para evitar o excesso de arquivos no espaço de disco.
Para instanciar a classe Tools:
use NFePHP\Esfinge\Tools;
$tools = new Tools('../config/config.json');
Acompanhe o CHANGELOG para maiores informações sobre as alterações recentes.
$ composer test
Para contribuir por favor observe o CONTRIBUTING e o Código de Conduta parea detalhes.
Caso você encontre algum problema relativo a segurança, por favor envie um email diretamente aos mantenedores do pacote ao invés de abrir um ISSUE.
- Rodrigo Traleski rodrigo@actuary.com.br
- Luiz Eduardo Godoy Bueno luizeduardogodoy@gmail.com
- Roberto L. Machado linux.rlm@gmail.com
O desenvolvimento desse pacote somente foi possivel devido a contribuição e colaboração da ACTUARY Ltda
Este patote está diponibilizado sob LGPLv3, GPLv3 ou MIT License (MIT). Leia Arquivo de Licença para maiores informações.