Api para comunicação com webservices do Provedor Tinus
Utilize o forum NFePHP iniciar discussões especificas sobre o desenvolvimento deste pacote.
Este pacote é aderente com os PSR-1, PSR-2 e PSR-4. Se você observar negligências de conformidade, por favor envie um patch via pull request.
Não deixe de se cadastrar no grupo de discussão do NFePHP para acompanhar o desenvolvimento e participar das discussões e tirar duvidas!
| n | Município | UF | IBGE |
|---|---|---|---|
| 1 | Cabedelo | PB | 2503209 |
| 2 | Cabo de Santo Agostinho | PE | 2602902 |
| 3 | Camaragibe | PE | 2603454 |
| 4 | Jaboatão dos Guararapes | PE | 2607901 |
| 5 | Macaiba | PE | 2407104 |
| 6 | Olinda | PE | 2609600 |
| 7 | Mossoró | RN | 2408003 |
| 8 | Parnamirim | RN | 2403251 |
| 9 | São Goncalo | RN | 2412005 |
| 10 | Garanhuns | PE | 2606002 |
- PHP >= 7.1
- ext-curl
- ext-soap
- ext-zlib
- ext-dom
- ext-openssl
- ext-json
- ext-simplexml
- ext-libxml
- nfephp-org/sped-common
- justinrainbow/json-schema
Este é um projeto totalmente OpenSource, para usa-lo e modifica-lo você não paga absolutamente nada. Porém para continuarmos a mante-lo é necessário qua alguma contribuição seja feita, seja auxiliando na codificação, na documentação ou na realização de testes e identificação de falhas e BUGs.
Este pacote esta listado no Packgist foi desenvolvido para uso do Composer, portanto não será explicitada nenhuma alternativa de instalação.
Durante a fase de desenvolvimento e testes este pacote deve ser instalado com:
composer require nfephp-org/sped-nfse-tinus:dev-masterOu ainda,
composer require nfephp-org/sped-nfse-tinus:dev-master --prefer-distOu ainda alterando o composer.json do seu aplicativo inserindo:
"require": {
"nfephp-org/sped-nfse-tinus" : "dev-master"
}NOTA: Ao utilizar este pacote ainda na fase de desenvolvimento não se esqueça de alterar o composer.json da sua aplicação para aceitar pacotes em desenvolvimento, alterando a propriedade "minimum-stability" de "stable" para "dev".
"minimum-stability": "dev", "prefer-stable": true
Após os stable realeases estarem disponíveis, este pacote poderá ser instalado com:
composer require nfephp-org/sped-nfse-tinusOu ainda alterando o composer.json do seu aplicativo inserindo:
"require": {
"nfephp-org/sped-nfse-tinus" : "^1.0"
}O mesmo segue a definição sugerida pela Abrasf, modelo 1.0, no entanto apresenta algumas particularidades:
– Não permite Substituição de RPS.
– O número do RPS deverá ser sequencial independente da série.
– É obrigatório informar dados para o Tomador.
- Cancelamento NFS-e
Notas Fiscais de Serviço Eletrônica canceladas não retornam o arquivo de xml de NFS-e com as informações que a mesma foi cancelada. O padrão Tinus não permite consultar documentos cancelados.
- Considerações
Observação 1: “Para o Município de Jaboatão dos Guararapes/PE, é necessário realizar o pedido de liberação de uso para o ambiente de Produção e homologação. Sem esta liberação, o RPS enviado ficará com status pendente no InvoiCy.
Para que a liberação seja realizada, o Município exige que seja enviado ao menos um RPS em homologação. Após envio deste RPS em homologação, o ERP receberá no retorno uma mensagem contendo o número do lote e o número do protocolo que aquele envio originou. Ex: Lote 12 enviado para processamento na prefeitura retornou protocolo 20131085123.
Este número de lote e protocolo, deve ser enviado ao e-mail jneilton@gmail.com, com o Assunto “Liberação de emissão de NFS-e em Homologação– Município X, CNPJ xx.xxx.xxx/xxxx-xx”. O Sr. Neilton, fará então a validação do lote, e a liberação do RPS enviado.
Após a validação do RPS enviado em homologação, será liberada a emissão em produção, pelo próprio Sr. Neilton.”
Observação 2: “O município de Jaboatão dos Guararapes/PE, possui processamento assíncrono, ou seja, recebe os RPS e os processa posteriormente. O tempo médio para retorno do processamento de um RPS é de até 30 minutos. Neste tempo, o ERP deverá disparar algumas consultas, até obter o status final do RPS.”. Todos os Lotes carregados são processados a cada meia-hora do relógio Ex. 16:30, 17:00, 17:30, 18:00, 18:30, etc.
vide a pasta Examples
Acompanhe o CHANGELOG para maiores informações sobre as alterações recentes.
Todos os testes são desenvolvidos para operar com o PHPUNIT
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.
Cleiton Perin (owner and developer)
Agradecemos o suporte oferecido pelo provedor TINUS para os ajustes nesta biblioteca. É um caso muito raro de colaboração dentre todos os provedores de serviços para as prefeituras que habitualmente não fornecem qualquer tipo de auxilio para a integração com pacotes OpenSource.
Este pacote está diponibilizado sob LGPLv3 ou MIT License (MIT). Leia Arquivo de Licença para maiores informações.