Diferente da maioria dos municípios, cujo envio de nota é feito por comunicação via WebService, algumas cidades adotaram o método UPLOAD, que consiste em pegar um arquivo formatado de acordo com as regras da prefeitura e fazer o upload desse arquivo diretamente no portal da própria prefeitura.
No PlugNotas, implementamos o suporte a municípios UPLOAD de forma que este processo seja o mais transparente possível.
O JSON enviado, cadastro de empresa, e envio da nota, é exatamente o mesmo dos demais municípios. Recomendo apenas que para municípios UPLOAD, altere a sua regra de geração de notas, onde ao invés de enviar nota a nota (fazendo com que seu cliente tenha que acessar o portal várias vezes), envie um lote de notas. Temos um exemplo aqui.
Todo o ID enviado será automaticamente marcado com o status CONCLUIDO, onde você terá de ler o nó UPLOAD, da consulta, ou webhook, seguindo o link da mesma forma como já faz para uma impressão de PDF. Este é o arquivo que você fará upload no portal da prefeitura.
Esse aqui é o passo a passo do fluxo completo de envio:
1. Você envia um JSON com 10 notas, recebe 10 IDs.
2. As 10 nota serão marcadas como o status CONCLUIDO.
3. Você receberá 10 WEBHOOKs, ou poderá consultar os IDs.
4. Cada ID conterá o nó UPLOAD, no entanto, os 10 IDs apontarão para o mesmo arquivo, sendo assim, você pode ler esse nó de apenas um dos IDs do lote.
5. Salve este arquivo, e disponibilize para seu cliente. (análogo ao processo de PDF ou XML)
6. Logue no portal da prefeitura, com as credenciais de seu cliente, e faça o UPLOAD deste arquivo.
As notas devem ser enviadas no endpoint abaixo:
POST https://api.plugnotas.com.br/nfse
Será retornado um protocolo depois do envio, no qual deve ser gravado para recuperar o arquivo de upload posteriormente:
Depois disso, basta recuperar o arquivo para fazer upload no portal da prefeitura, através do endpoint abaixo:
GET https://api.plugnotas.com.br/nfse/upload/{protocolo}
Exemplo:
Comentários
0 comentário
Por favor, entre para comentar.