nfephp-org/sped-esfinge

API para geração e comunicação com TCE SC.

dev-master / 0.0.1.x-dev 2023-08-24 17:48 UTC

This package is auto-updated.

Last update: 2024-04-24 19:35:19 UTC


README

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.

Build Status Coverage Status Quality Score Latest Version on Packagist License Total Downloads

Issues Forks Stars

TCE Santa Catarina

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.

Fase 1:

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)

Fase 2:

A fase dois com a implementação de outros serviços, será feita apenas quando surgir essa necessidade.

Install

Via Composer

$ composer require nfephp-org/sped-esfinge

Usage

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');

Change log

Acompanhe o CHANGELOG para maiores informações sobre as alterações recentes.

Testing

$ composer test

Contributing

Para contribuir por favor observe o CONTRIBUTING e o Código de Conduta parea detalhes.

Security

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.

Credits

O desenvolvimento desse pacote somente foi possivel devido a contribuição e colaboração da ACTUARY Ltda

License

Este patote está diponibilizado sob LGPLv3, GPLv3 ou MIT License (MIT). Leia Arquivo de Licença para maiores informações.