Download the PHP package potelo/nfse-ssa without Composer
On this page you can find all versions of the php package potelo/nfse-ssa. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download potelo/nfse-ssa
More information about potelo/nfse-ssa
Files in potelo/nfse-ssa
Package nfse-ssa
Short Description Emissão de Nota Fiscal de Serviços Eletrônica (NFS-e) em Salvador-BA
License MIT
Informations about the package nfse-ssa
NfseSsa
Introdução
NfseSsa é um pacote para laravel que fornece uma interface para emissão de Nota Fiscal de Serviços Eletrônica (NFS-e) em Salvador - BA.
Instalação Laravel 5.x
Instale esse pacote pelo composer:
Se você não utiliza o auto-discovery, Adicione o ServiceProvider em config/app.php
Geração dos arquivos do certificado
Você deve ter recebido um certificado com a extensão pfx, ele serve para o ambiente de produção e homologação. Vamos precisar converter esse arquivo para a extensão pem e também extrair a chave pública. Para extrair as duas chaves vamos utilizar os comandos no terminal (cmd no Windows) e inserir a senha quando solicitado:
Você deve guardar os dois arquivos gerados, priv.pem e public.pem.
Configuração
Copie o arquivo de configuração do pacote para seu ambiente local, usando o comando publish:
Um arquivo nfse-ssa.php será criado na pasta config, você deve editar ele e colocar os caminhos para os dois arquivos que foram gerados.
No seu env adicione a variável:
Só mude para false quando for colocar em produção.
Quando tiver desenvolvendo, é essencial que utilize o painel web do ambiente de homologação para liberar o cadastro e a emissão de notas fiscais: https://notahml.salvador.ba.gov.br/
Utilize esse painel também para acompanhar se as notas fiscais estão sendo geradas corretamente. O cadastro nesse painel precisa ser aprovado, entrando em contato por telefone com a prefeitura é possível ativar o cadastro.
Perguntas e respostas: https://nfse.sefaz.salvador.ba.gov.br/OnLine/Institucional/FaqTecnologia.aspx
Emissão do Recibo Provisório de Serviços (RPS)
Para gerar a nota fiscal, precisamos enviar um RPS para a API da Prefeitura, que uma Nota Fiscal será gerada automaticamente a partir dele. Instanciamos o objeto NfseSsa por injeção de dependência no método do Controller e enviamos o RPS através do método enviarLoteRps:
Caso seja gerado com sucesso, no método $result->getData() vai ter o número do protocolo, que será utilizado em outras consultas.
Exemplo de retorno com sucesso:
Exemplo de retorno com erro:
Obs: No pacote é enviado apenas 1 RPS por Lote.
Consultas
Consultar situação do Lote RPS enviado
Consulta através do método consultarSituacaoLoteRps
Exemplo de retorno com sucesso:
Consultar Nota Fiscal pelo RPS
Consulta uma Nota Fiscal gerada a partir de um RPS através do método consultarNfseRps