{"id":8899,"date":"2020-01-20T11:00:17","date_gmt":"2020-01-20T13:00:17","guid":{"rendered":"https:\/\/enotas.com.br\/blog\/?p=8899"},"modified":"2023-10-26T15:12:17","modified_gmt":"2023-10-26T18:12:17","slug":"nfse-em-php","status":"publish","type":"post","link":"https:\/\/enotas.com.br\/blog\/nfse-em-php\/","title":{"rendered":"Desafios na emiss\u00e3o de NFS-e em PHP"},"content":{"rendered":"

Acompanhe o nosso passo a passo e entenda as dificuldades por tr\u00e1s da emiss\u00e3o de uma Nota Fiscal de Servi\u00e7o Eletr\u00f4nica (NFS-e) em PHP.<\/strong><\/p>\n

A emiss\u00e3o de NFS-e em PHP \u00e9 muito importante para quem deseja oferecer a melhor experi\u00eancia aos seus clientes e, claro, respeitar as legisla\u00e7\u00f5es tribut\u00e1rias.<\/p>\n

Entretanto, integrar uma prefeitura n\u00e3o \u00e9 t\u00e3o simples quanto parece. Cada munic\u00edpio t\u00eam exig\u00eancias diferentes, ent\u00e3o \u00e9 comum surgirem d\u00favidas e n\u00e3o saber como agir.<\/p>\n

Os procedimentos para integra\u00e7\u00e3o costumam envolver muitas burocracias e desafios t\u00e9cnicos que precisam ser contornados, como <\/strong>a falta de webservice<\/strong>.<\/p>\n

Neste post, voc\u00ea descobrir\u00e1 o passo a passo<\/strong> para <\/strong>emitir NFS-e em PHP<\/strong>, os desafios de cada etapa e como se preparar para super\u00e1-los!<\/p>\n

(Clique no player para o ouvir a narra\u00e7\u00e3o do nosso post!)<\/em><\/p>\n

Outros conte\u00fados que voc\u00ea tamb\u00e9m poder\u00e1 curtir:<\/strong><\/p><\/blockquote>\n

<\/a>18 principais perguntas sobre Nota Fiscal Eletr\u00f4nica<\/a><\/p><\/blockquote>\n

Gloss\u00e1rio NFS-e: 9 termos que todo empreendedor deve conhecer<\/a><\/p><\/blockquote>\n

<\/a>Como emitir NFS-e sem certificado digital?<\/a><\/p><\/blockquote>\n

Qual o passo a passo e os desafios para emitir NFS-e em PHP?<\/h2>\n

Emitir NFS-e em PHP pode trazer, para al\u00e9m de desafios, muita dor de cabe\u00e7a e complica\u00e7\u00f5es. Isto, pois a legisla\u00e7\u00e3o tribut\u00e1ria brasileira \u00e9 complexa e as exig\u00eancias para a integra\u00e7\u00e3o das prefeituras s\u00e3o de fato burocr\u00e1ticas.<\/p>\n

Pensando nisso, elaboramos um passo a passo<\/strong> para mostrar os principais processos para esse tipo de emiss\u00e3o de nota fiscal, como tamb\u00e9m, as dificuldades que voc\u00ea poder\u00e1 encontrar em cada um deles. Veja!<\/p>\n

1\u00ba Passo: <\/strong>Identificar qual o provedor e o layout da emiss\u00e3o da nota usado pela prefeitura<\/h3>\n

Nesta primeira etapa, caber\u00e1 ao desenvolvedor verificar junto \u00e0 prefeitura \u2014 a que ficar\u00e1 respons\u00e1vel pela emiss\u00e3o da nota fiscal \u2014 qual o provedor e layout que ela utiliza.<\/p>\n

Isso \u00e9 necess\u00e1rio pois n\u00e3o h\u00e1 um padr\u00e3o nacional obrigat\u00f3rio \u2014 por mais que exista a NFS-e Nacional<\/a> \u2014 e cada munic\u00edpio pode contratar um provedor diferente. <\/p>\n

2\u00ba Passo:<\/strong> Estudar o Manual de Integra\u00e7\u00e3o da prefeitura<\/h3>\n

Sabe a hist\u00f3ria do provedor? Ent\u00e3o\u2026 cada um possui um manual que explica como realizar a integra\u00e7\u00e3o.<\/p>\n

Isso significa dizer que cada prefeitura poder\u00e1 exigir componentes espec\u00edficos e apresentar c\u00f3digos diferentes \u2014  at\u00e9 mesmo para fazer refer\u00eancia a uma mesma informa\u00e7\u00e3o!<\/p>\n

\"nfs-e-em-php-estudar-manual-de-integra\u00e7\u00e3o-da-prefeitura\"<\/span><\/p>\n

\u00c9 nessa parte do processo que o desenvolvedor entender\u00e1 como funciona o sistema daquela localidade, para ent\u00e3o, poder construir o arquivo XML <\/a>com os dados no formato correto.<\/p>\n

Para ficar mais claro, repare no exemplo abaixo: A imagem representa os c\u00f3digos e refer\u00eancias que precisam conter no XML para a prefeitura de S\u00e3o Paulo-SP.<\/p>\n

\"nfs-e-em-php-sao-paulo\"<\/span><\/p>\n

Note que ela possui um tipo de descri\u00e7\u00e3o pr\u00f3prio e atente-se para o termo “tpCidade<\/strong>“. <\/p>\n

Agora observe a figura seguinte. Esta tamb\u00e9m representa os c\u00f3digos que devem ser inseridos no XML, mas estes, para a prefeitura de Barueri-SP<\/p>\n

\"nfs-e-em-php-barueri\"<\/span><\/p>\n

Como voc\u00ea p\u00f4de ver, n\u00e3o h\u00e1 um padr\u00e3o de identifica\u00e7\u00e3o de cada t\u00f3pico, nesse caso, o item que traz a assimila\u00e7\u00e3o da cidade possui uma descri\u00e7\u00e3o de c\u00f3digo bem diferente, “tsCodigoMunicipioIbge<\/strong>“.<\/p>\n

Percebeu a complica\u00e7\u00e3o burocr\u00e1tica? Mesmo com prefeituras pr\u00f3ximas, os formatos podem variar. Por causa disso, essa \u00e9 uma fase que mistura aten\u00e7\u00e3o com aprendizado, e todo cuidado \u00e9 necess\u00e1rio para que nada passe batido.<\/p>\n

\u00c9 por causa de situa\u00e7\u00f5es como essa que \u00e9 t\u00e3o comum se confundir ao integrar diferentes prefeituras.<\/p>\n

Vale dizer, que esse \u00e9 apenas um exemplo simples de identifica\u00e7\u00e3o. Imagine ter de interpretar todos os outros itens e, dentre eles, campos mais cr\u00edticos, como \u00e9 caso de al\u00edquotas, impostos e taxas.<\/p>\n

aten\u00e7\u00e3o<\/strong><\/p>\n

Ainda, pode ocorrer do Manual de Integra\u00e7\u00e3o n\u00e3o estar dispon\u00edvel no site. Nessa situa\u00e7\u00e3o, voc\u00ea ter\u00e1 de entrar em contato com o \u00f3rg\u00e3o oficial para solicit\u00e1-lo… e torcer para algu\u00e9m responder<\/strong>!<\/p>\n

Impasses como esse, geralmente, causam desgaste e estresse, pois a resolu\u00e7\u00e3o do problema nem sempre acontece imediatamente e o contato tamb\u00e9m nem sempre \u00e9 eficaz.<\/p>\n

Algumas vezes, \u00e9 preciso abordar a prefeitura por meio de emails, liga\u00e7\u00f5es e, em alguns casos, at\u00e9 mesmo ir l\u00e1 pessoalmente!<\/p>\n

Com isso, o prazo para o processo de integra\u00e7\u00e3o vai sendo dilatado e, por consequ\u00eancia, o in\u00edcio das emiss\u00f5es das notas vai ficando cada vez mais distante.  <\/p>\n

<\/strong>3\u00ba Passo:<\/strong> Analisar os m\u00e9todos de certifica\u00e7\u00e3o digital<\/h3>\n

Para que seja feita a emiss\u00e3o da NFS-e, algumas prefeituras pedem o certificado digital<\/strong><\/a>, enquanto outras  apenas solicitam que seja criado um login e senha.<\/p>\n

O problema dessa etapa \u00e9 a exig\u00eancia do desenvolvedor conhecer a respeito dos tipos de assinatura digital \u2014  suas particularidades t\u00e9cnicas e funcionalidades \u2014  ou seja, mais estudo e aprendizado.<\/p>\n

4\u00ba Passo: Comunica\u00e7\u00e3o com o web service<\/h3>\n

Para que o fluxo de emiss\u00e3o de NFS-e em PHP acompanhe a demanda de pedidos, \u00e9 preciso que seja implementada a comunica\u00e7\u00e3o com o web service<\/em> local do munic\u00edpio.<\/p>\n

Uma vez feito isso e com a ajuda de uma API para nota fiscal inteligente<\/strong>, pronta para realizar essa comunica\u00e7\u00e3o, tudo fica mais simples.<\/p>\n

Caso contr\u00e1rio, voc\u00ea teria de ficar por conta de consultar os status<\/em> das notas fiscais para descobrir se foram aceitas ou n\u00e3o, al\u00e9m de se preocupar com a comunica\u00e7\u00e3o entre os servidores e com poss\u00edveis erros no envio de dados.<\/p>\n

Um deslize e a nota pode ter sua emiss\u00e3o impedida e ser bloqueada. Alocar tempo e energia para ficar identificando erro de cada uma \u00e9 algo comprometedor para o crescimento de uma empresa, n\u00e9?<\/strong><\/p>\n

\"E-book_Banner-2_7-Pontos-Cruciais-Que-Voc\u00ea-Precisa-Saber-Para-Emitir-NFS-e-em-N\u00edvel-Nacional\"<\/a><\/span><\/p>\n

E quando o munic\u00edpio n\u00e3o tem webservice, o que \u00e9 poss\u00edvel fazer?<\/strong><\/p>\n

Ent\u00e3o, existem algumas possibilidades.<\/p>\n

Em Barueri, por exemplo, a prefeitura n\u00e3o disponibiliza webservice. Isso significa que \u00e9 necess\u00e1rio upar um arquivo com as notas manualmente \u2014 algo nada escal\u00e1vel, certo?<\/p>\n

Por outro lado, quem utiliza o eNotas Gateway<\/a> n\u00e3o precisa se preocupar com isso. Com uma API \u00fanica e poderosa, o eNotas Gateway emite NFS-e em Barueri e v\u00e1rias outras cidades sem webservice (Valinhos, Santana de Parna\u00edba, I\u00e7ara e etc).<\/p>\n

Quais os desafios p\u00f3s integra\u00e7\u00e3o?<\/h2>\n

Muito se engana quem pensa que, ap\u00f3s a integra\u00e7\u00e3o, os desafios acabaram.<\/p>\n

\"nfs-e-em-php-desafios-pos-integra\u00e7ao\"<\/span><\/p>\n

Na verdade, trabalhar com a emiss\u00e3o de notas fiscais de servi\u00e7o, seja em qualquer formato, \u00e9 uma tarefa que n\u00e3o permite que voc\u00ea baixe a guarda. Trata-se de um campo aberto suscet\u00edvel a muitas vari\u00e1veis.<\/p>\n

Dentre as dificuldades e os trabalhos ap\u00f3s a integra\u00e7\u00e3o, podemos citar:<\/p>\n