As principais informações do documento são:
1) Cada cidade brasileira possui seu próprio sistema e regras para emissão de NFS-e, tornando o processo complexo e diferente em cada localidade.
2) Integrar com várias prefeituras é um desafio devido às diferentes estruturas, validações, instabilidades e mudanças repentinas nos sistemas.
3) A solução eNotas Gateway oferece uma API REST unificada que permite emitir NFS-e em qualquer cidade de forma automatizada, contornando os problemas causados pela diversidade
NFS-e: 7 Pontos Cruciais que Você Precisa Saber Para Implementar a Nota Fiscal Eletrônica de Serviço em Nível Nacional
1. eNotas Gateway
NFS-e na
Prática
7 Pontos Cruciais Que
Você Precisa Saber Para
Emitir Nota Fiscal
Eletrônica de Serviço
(NFS-e) em Nível Nacional
2. Uma prefeitura... um sistema diferente
As cidades do Rio de Janeiro e Niterói são separadas fisicamente apenas por
uma ponte mas no quesito nota fiscal eletrônica a única (ou quase)
semelhança é que ambas as cidades oferecem webservice para integrar.
ABRASF... o falso oásis no deserto
Um modelo conceitual foi elaborado como sugestão de padrão único pela
ABRASF mas nenhuma cidade é obrigada a utilizar.
Apesar de facilitar a vida de todos os envolvidos no processo as cidades que o
adotaram fizeram inúmeras adequações de acordo com suas próprias
vontades, tanto estruturais quanto de regras de preenchimento, validação e
funcionamento.
Só quem vive a NFS-e na prática entende o desafio e custo de atender mais de
3-4 prefeituras, mesmo as que usam o ABRASF adaptado.
RPS... depende...uma prefeitura... uma regra
O Recibo Provisório de Serviço é um documento que tem por objetivo permitir a
entrega de um documento ao comprador caso ele não possa aguardar a
geração de sua nota fiscal eletrônica pela prefeitura.
Ok, eu já sabia, e aí?
Várias prefeituras não permitem o uso de RPS, outras exigem o uso de um
modelo próprio municipal e outras nem sabem o que é isso.
A NFS-e é municipal, logo...
3. Digitação manual
Algumas prefeituras menores não
oferecem nenhuma forma de emissão
de nota fiscal em lote, nem via
importação de arquivo. Só sobrou a
digitação manual no site da cidade.
Importação de
arquivos (TXT / XML)
Várias prefeituras só permitem a
geração em lote através da
importação de arquivos,
manualmente, no site da prefeitura,
ou pior, através de um sistema
desktop próprio (sim, só funciona no
Windows).
Importação de
arquivos + aplicação
desktop
Algumas prefeituras exigem que você
baixe um aplicativo desktop (sim, só
funciona no Windows) para importar
os arquivos TXT ou XML,
manualmente, que por sua vez gerará
as notas fiscais.
Ex: Florianópolis e Indaiatuba.
Webservice...mas elas
nem sabem
Algumas prefeituras alegarão não
oferecer webservice para integração
mas quem faz testes na prática
consegue encontrar em alguns casos.
Documentação? Esqueça. Sua
experiência servirá como bola de
cristal.
Muitas prefeituras não
permitem integração...
Integrar com todas com 1 API REST? Só com o eNotas Gateway.
4. Não há uma relação nacional
Cada cidade utiliza o código que bem entender. Uma bela mistura entre
códigos nacionais e municipais.
CNAE / Item da lista de serviço... as vezes
Algumas prefeituras vinculam o código de serviço com o CNAE e/ou
item da lista de serviço ou simplesmente usam algo 100% próprio.
A formatação dessa identificação varia
Não basta os códigos de serviços variarem, a forma como devem ser
informados na nota fiscal muda completamente. Esqueceu um ponto,
tracinho ou espaço onde não deve? Sem formatar o código
corretamente, nada de nota fiscal!
Rio de Janeiro utiliza 3 códigos para identificar o serviço, Belo Horizonte
2, São Paulo 1, Campinas 2, Florianópolis faz um de-para com o CNAE...
Identificação do serviço
prestado... é municipal
Você não achou que ia poder usar simplesmente o CNAE ou
item da lista de serviço, não é?
5. Vamos
automatizar?
O eNotas Gateway é a única
solução a realmente unificar e
automatizar 100% da emissão de
NFS-e em qualquer prefeitura do
Brasil - até em Florianópolis.
QUERO CONHECER
6. Opcional no site, obrigatório via integração
Algumas prefeituras permitem a emissão manual sem certificado ao
usar o próprio site. Em alguns casos somente para empresas do Simples
Usuário e senha
Certas prefeituras que não exigem uso de certificado solicitam usuário e
senha para autenticar a empresa emissora.
Token / Frase secreta
Em alguns casos será necessário informar uma frase secreta ou um
token composto por uma sequência de caracteres alfanuméricos.
Mistura de tudo
Em algumas cidades é utilizada uma mistura de várias formas:
certificado + usuário/senha ou usuário/senha + frase secreta, etc.
Certificado digital não é o
padrão...
O padrão é: cada prefeitura sua forma de autenticação.
7. Horas e horas para processar 1 lote
Em certos momentos lotes demoram horas para serem processados.
Fora do ar por horas... ou dias
Prepare-se para tratar sistemas fora do ar ou demorando muito mais
que o normal para responder, geralmente final ou início de mês quando
o volume de emissão aumenta.
Recentemente (09/2016) Florianópolis ficou fora por uns 6 dias.
Erros em mensagens de sucesso
Algumas prefeituras podem passar a retornar mensagens de erro
dentro de mensagens de suposto sucesso, ou seja, a "a operação foi
bem sucedido mas... erro!"
Paralelizar para emitir mais rápido?
Não tente paralelizar os envios pois a grande maioria das prefeituras
irá dar problema. São Paulo/SP retorna até erro do banco de dados.
Instabilidade é rotina em
muitas prefeituras...
8. Mudanças estruturais repentinas
Não é raro alterarem a estrutura de arquivos XMLs ou das mensagens
trocadas.
Logicamente sem aviso prévio.
Troca completa dos sistemas
Em alguns casos mais raros a prefeitura opta por substituir totalmente
o sistema, logo, você precisa integrar novamente do zero.
(Colombo/PR, Nova Lima/MG, Fortaleza/CE...)
Erros em mensagens de sucesso
Algumas prefeituras retornam mensagens de erro dentro de mensagens
de suposto sucesso, ou seja, a "a operação foi bem sucedido mas...
erro!"
Prepare-se à mudanças
inesperadas...
9. Cada cidade... seu processo de habilitação
O processo para começar a emitir NF-e municipal muda por prefeitura e
é bem variado. Listei apenas alguns exemplos mas variam muito mais.
São Paulo/SP: Habilite no cadastro
Basta habilitar a emissão via integração no cadastro do contribuinte no
site da prefeitura.
Curitiba/PR: Vincule o certificado no site
Depois de autorizado a emitir NFSe, você precisa vincular o certificado
digital da empresa no seu cadastro no site da prefeitura.
Londrina/PR: Validação presencial
Você precisará imprimir um modelo de RPS específico, validá-lo
presencialmente e atualizá-lo com informações geradas pela prefeitura.
Ok, e para começar a
emitir?
Tudo pronto para começar a emitir? Então você precisa ficar
ciente de mais algumas coisas...
10. 1 API REST simples e única atende todo o Brasil
Com 1 simples integração você emite NFS-e automaticamente até em
prefeitura sem webservice, como Florianópolis/SC.
Dê adeus às instabilidades das prefeituras
O Gateway detecta as falhas da prefeitura e faz retentativas automáticas
até conseguir emitir sua nota fiscal.
O serviço municipal... unificado*
A plataforma disponibiliza um código nacional de serviço para você exibir
ao seu usuário e utilizar nas emissões.
Exiba o PDF da nota fiscal sempre que quiser
Geramos um link público para o PDF e XML da nota fiscal para você ter a
flexibilidade que quiser na sua solução.
QUERO CONHECER
* Em beta. Disponível apenas para algumas cidades por enquanto, consulte-nos.
eNotas Gateway
A NFS-e em nível nacional da forma inteligente e simples.
11. Baixe Agora Um Mapa Mental Com Mais 6
Dicas Práticas sobre NFS-e:
--> BAIXAR MAPA MENTAL <--
* Não sei por quanto tempo esse mapa ficará disponível então recomendo que o baixe agora.
Quer Mais? Bônus!
eNotasGateway.com.br