NF-e (Nota Fiscal Eletrnica)

Artigo que contm informaes sobre integrao de softwares com a nota fiscal eletrnica
24/05/2008 Unimake Softwares Wandrey Mundin Ferreira

Integrando aplicativos a NF-e

Contedo
Agradecimentos ............................................................................................................................ 3 Prefcio ......................................................................................................................................... 4 Certificados digitais ....................................................................................................................... 5 WebServices dos Estados - Ambiente de homologao ............................................................... 6 WebServices dos Estados - Ambiente de produo...................................................................... 9 Tabela de cdigos das Unidades Federativas/Estados ............................................................... 12 Alguns obstculos enfrentados ................................................................................................... 13 Testar o certificado digital para a NF-e ....................................................................................... 14 Contatos e endereos importantes............................................................................................. 15 Erros e solues........................................................................................................................... 18 Padronizao dos Nomes dos XML ............................................................................................. 20 Assinatura Digital dos Arquivos XML........................................................................................... 21 Validao dos Arquivos XML (Schemas)...................................................................................... 22 Verses dos dados dos arquivos XML ......................................................................................... 23 Dicas Diversas .............................................................................................................................. 24 Concluso .................................................................................................................................... 25

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

Agradecimentos
Gostaria aqui de agradecer aos companheiros citados abaixo pelas dicas que me foram dadas aos problemas e dvidas enfrentados ao longo do desenvolvimento da rotina da nota fiscal eletrnica. Muito obrigado. Deus - que nos forneceu a inspirao necessria Equipe Unimake Cunhado Diesel Dimebras Distribuidora de Medicamentos do Brasil Patrcia Pedroso Programadora C# Luciano Vale Frum MSDN Mrcio Fbio Althmann - Frum MSDN Vinigfer - Frum MSDN

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

Prefcio
Diante da necessidade de desenvolvermos um aplicativo para integrar nossos sistemas a NFE Nota Fiscal Eletrnica do Brasil, eu e a equipe de Unimake Softwares nos deparamos com diversas dificuldades, dentre elas a falta de informao tcnica para o correto desenvolvimento desta rotina. Tentamos buscar informaes em diversos setores da Receita Estadual de vrios Estados por telefone, sites, mas a dificuldade em se conseguir falar com a pessoa correta para obter informaes foram enormes. Os manuais que baixamos dos sites oficiais da NFe no eram claros com relao a muitas coisas. No sei se as demais empresas enfrentaram as mesmas dificuldades, mas esta foi nossa realidade, ter um prazo para entregar o produto e no conseguir as informaes de forma concreta e chegar ao ponto de redigir um cdigo sem a mnima certeza se iria dar certo ou no (um verdadeiro tiro no escuro). horrvel ter que fazer algo sem termos um suporte adequado. Sabemos que no podemos culpar o Governo por isso, pois o processo de adaptao a Nota Fiscal Eletrnica tambm est ocorrendo em seus diversos departamentos. Bom! Tentamos buscar tecnologias prontas, mas todas elas teriam um custo alto. Alm de ficarmos restritos a uma DLL que no podemos modificar quando necessitamos, e por se tratar de um aplicativo que tem ligao com o Governo e a legislao, a qual muda com muita freqncia, e todas s vezes teramos que comprar novamente tecnologia. Mas chega de derramar lgrimas e vamos ao que interessa... Diante deste dilema eu e nossa equipe resolvemos redigir este artigo com as idias necessrias de como desenvolver a integrao de aplicativos com a NF-e, e muito alm de explicar, disponibilizar aos interessados o cdigo fonte (completo) de cada uma das etapas para que seja analisado e utilizado na integrao, pois queremos colaborar com o projeto da NF-e de nosso Pas e facilitar aos companheiros de profisso, para que no precisem passar pelo que passamos. Lembramos que os cdigos fontes foram criados em C# utilizando a Microsoft Visual Studio Express.

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

Certificados digitais
Os tipos de certificados mais utilizados para a NFe so os A1 e A3 e abaixo seguem algumas consideraes sobre estes tipos. Certificados digitais A3 so certificados digitais portveis, que so armazenados em carto inteligente e utilizados por meio de uma leitora que permite o acesso ao certificado em vrios computadores diferentes. Apresentam nvel de segurana superior. O certificado digital A3 oferece maior segurana, pois o par de chaves gerado em hardware (carto inteligente ou token) que no permite a exportao ou qualquer outro tipo de reproduo ou cpia da chave privada. A chave pblica enviada para a Autoridade Certificadora (AC), com a solicitao de emisso do certificado, enquanto a chave privada ficar armazenada no carto ou token protegida por senha de acesso, impedindo tentativas de acesso de terceiros. Com o carto inteligente ou o token, voc pode transportar a sua chave privada de maneira segura, podendo utiliz-la onde voc desejar. Certificados digitais A1 so certificados digitais vlidos por 1 (um) ano, que ficam armazenados no prprio computador do cliente, por isso, no so portveis. Recomendamos ao cliente que esse tipo de certificado tenha uma cpia de segurana (backup) em qualquer mdia portvel (CD, DVD, pen-drive, etc). O certificado digital A1 tem o par de chaves pblica/privada gerado em seu computador no momento da emisso do certificado. A chave pblica enviada para a Autoridade Certificadora (AC), com a solicitao de emisso do certificado, enquanto a chave privada fica armazenada no seu computador, devendo, obrigatoriamente, ser protegida por senha de acesso. Este certificado s poder ser instalado no mesmo computador em que foi efetuada a solicitao. O certificado tipo A1 tem validade de 1 (um) ano. Tecnicamente analisando os tipos de certificados, o A3 sempre que acessado solicita uma senha, assim sendo, para cada envio de nota fiscal se o carto estiver ocioso por muito tempo, o usurio dever digitar uma senha para conseguir assinar a nota fiscal digitalmente e enviar o arquivo. Imagine isso em empresas que emitem mais de 300 notas fiscais por dia. J com o certificado do tipo A1 isso no acontece.

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

WebServices dos Estados - Ambiente de homologao

Segue abaixo a lista dos WebServices do ambiente de homologao das notas fiscais eletrnicas dos Estados.
UF AC Servio Endereo Utiliza os mesmos do ambiente VR

AL NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro

Utiliza os mesmos do ambiente VR https://homnfe.sefaz.am.gov.br/ws/services/NfeRecepcao?wsdl https://homnfe.sefaz.am.gov.br/ws/services/NfeRetRecepcao?wsdl https://homnfe.sefaz.am.gov.br/ws/services/NfeCancelamento?wsdl https://homnfe.sefaz.am.gov.br/ws/services/NfeInutilizacao?wsdl https://homnfe.sefaz.am.gov.br/ws/services/NfeConsulta?wsdl https://homnfe.sefaz.am.gov.br/ws/services/NfeStatusServico?wsdl No tem este servio disponvel Utiliza os mesmos do ambiente VR NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro https://hnfe.sefaz.ba.gov.br/webservices/nfe/NfeRecepcao.asmx?WSDL https://hnfe.sefaz.ba.gov.br/webservices/nfe/NfeRetRecepcao.asmx?WSDL https://hnfe.sefaz.ba.gov.br/webservices/nfe/NfeCancelamento.asmx?WSDL https://hnfe.sefaz.ba.gov.br/webservices/nfe/NfeInutilizacao.asmx?WSDL https://hnfe.sefaz.ba.gov.br/webservices/nfe/NfeConsulta.asmx?WSDL https://hnfe.sefaz.ba.gov.br/webservices/nfe/NfeStatusServico.asmx?WSDL No tem este servio disponvel https://nfeh.sefaz.ce.gov.br/nfe/services/NfeRecepcao?WSDL https://nfeh.sefaz.ce.gov.br/nfe/services/NfeRetRecepcao?WSDL https://nfeh.sefaz.ce.gov.br/nfe/services/NfeCancelamento?WSDL https://nfeh.sefaz.ce.gov.br/nfe/services/NfeInutilizacao?WSDL https://nfeh.sefaz.ce.gov.br/nfe/services/NfeConsulta?WSDL https://nfeh.sefaz.ce.gov.br/nfe/services/NfeStatusServico?WSDL https://nfeh.sefaz.ce.gov.br/nfe/services/CadConsultaCadastro?WSDL Endereos do SCAN (Envio das notas em contigncia): https://hom.nfe.fazenda.gov.br/SCAN/NfeRecepcao/NfeRecepcao.asmx?WSDL https://hom.nfe.fazenda.gov.br/SCAN/NfeRetRecepcao/NfeRetRecepcao.asmx?WSDL https://hom.nfe.fazenda.gov.br/SCAN/NfeCancelamento/NfeCancelamento.asmx?WSDL https://hom.nfe.fazenda.gov.br/SCAN/NfeInutilizacao/NfeInutilizacao.asmx?WSDL https://hom.nfe.fazenda.gov.br/SCAN/NfeConsulta/NfeConsulta.asmx?WSDL https://hom.nfe.fazenda.gov.br/SCAN/NfeStatusServico/NfeStatusServico.asmx?WSDL No tem este servio disponvel https://homolog.nfe.fazenda.df.gov.br/nfe/services/NfeRecepcao?WSDL https://homolog.nfe.fazenda.df.gov.br/nfe/services/NfeRetRecepcao?WSDL https://homolog.nfe.fazenda.df.gov.br/nfe/services/NfeCancelamento?WSDL https://homolog.nfe.fazenda.df.gov.br/nfe/services/NfeInutilizacao?WSDL https://homolog.nfe.fazenda.df.gov.br/nfe/services/NfeConsulta?WSDL https://homolog.nfe.fazenda.df.gov.br/nfe/services/NfeStatusServico?WSDL https://homolog.nfe.fazenda.df.gov.br/nfe/Services/ConsultaCadastro?WSDL

AM

AP

BA

CE

CO

DF

ES

GO

NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro

No tem este servio disponvel https://homolog.sefaz.go.gov.br/nfe/services/NfeRecepcao?WSDL https://homolog.sefaz.go.gov.br/nfe/services/NfeRetRecepcao?WSDL https://homolog.sefaz.go.gov.br/nfe/services/NfeCancelamento?WSDL https://homolog.sefaz.go.gov.br/nfe/services/NfeInutilizacao?WSDL https://homolog.sefaz.go.gov.br/nfe/services/NfeConsulta?WSDL https://homolog.sefaz.go.gov.br/nfe/services/NfeStatusServico?WSDL https://homolog.sefaz.go.gov.br/nfe/services/CadConsultaCadastro?WSDL Utiliza os mesmos do ambiente VN

MA NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico

MG

https://hnfe.fazenda.mg.gov.br/nfe/services/NfeRecepcao?WSDL https://hnfe.fazenda.mg.gov.br/nfe/services/NfeRetRecepcao?WSDL https://hnfe.fazenda.mg.gov.br/nfe/services/NfeCancelamento?WSDL https://hnfe.fazenda.mg.gov.br/nfe/services/NfeInutilizacao?WSDL https://hnfe.fazenda.mg.gov.br/nfe/services/NfeConsulta?WSDL https://hnfe.fazenda.mg.gov.br/nfe/services/NfeStatusServico?WSDL

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

CadConsultaCadastro NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro https://hnfe.fazenda.mg.gov.br/nfe/services/CadConsultaCadastro?WSDL https://homologacao.nfe.ms.gov.br/homologacao/services/NfeRecepcao?WSDL https://homologacao.nfe.ms.gov.br/homologacao/services/NfeRetRecepcao?WSDL https://homologacao.nfe.ms.gov.br/homologacao/services/NfeCancelamento?WSDL https://homologacao.nfe.ms.gov.br/homologacao/services/NfeInutilizacao?WSDL https://homologacao.nfe.ms.gov.br/homologacao/services/NfeConsulta?WSDL https://homologacao.nfe.ms.gov.br/homologacao/services/NfeStatusServico?WSDL No tem este servio disponvel https://homologacao.sefaz.mt.gov.br/nfews/NfeRecepcao?WSDL https://homologacao.sefaz.mt.gov.br/nfews/NfeRetRecepcao?WSDL https://homologacao.sefaz.mt.gov.br/nfews/NfeCancelamento?WSDL https://homologacao.sefaz.mt.gov.br/nfews/NfeInutilizacao?WSDL https://homologacao.sefaz.mt.gov.br/nfews/NfeConsulta?WSDL https://homologacao.sefaz.mt.gov.br/nfews/NfeStatusServico?WSDL https://homologacao.sefaz.mt.gov.br/nfews/CadConsultaCadastro?WSDL Utiliza os mesmos do ambiente VN

MS

MT

PA

PB NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro

Utiliza os mesmos do ambiente VR https://nfehomolog.sefaz.pe.gov.br/nfe-service/services/NfeRecepcao?WSDL https://nfehomolog.sefaz.pe.gov.br/nfe-service/services/NfeRetRecepcao?WSDL https://nfehomolog.sefaz.pe.gov.br/nfe-service/services/NfeCancelamento?WSDL https://nfehomolog.sefaz.pe.gov.br/nfe-service/services/NfeInutilizacao?WSDL https://nfehomolog.sefaz.pe.gov.br/nfe-service/services/NfeConsulta?WSDL https://nfehomolog.sefaz.pe.gov.br/nfe-service/services/NfeStatusServico?WSDL https://nfehomolog.sefaz.pe.gov.br/nfe-service/services/CadConsultaCadastro?WSDL Utiliza os mesmos do ambiente VN NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro https://homologacao.nfe.fazenda.pr.gov.br/NFENWebServices/services/nfeRecepcao?WSDL https://homologacao.nfe.fazenda.pr.gov.br/NFENWebServices/services/nfeRetRecepcao?WSDL https://homologacao.nfe.fazenda.pr.gov.br/NFENWebServices/services/nfeCancelamentoNF?WSDL https://homologacao.nfe.fazenda.pr.gov.br/NFENWebServices/services/nfeInutilizacaoNF?WSDL https://homologacao.nfe.fazenda.pr.gov.br/NFENWebServices/services/nfeConsultaNF?WSDL https://homologacao.nfe.fazenda.pr.gov.br/NFENWebServices/services/nfeStatusServicoNF?WSDL No tem este servio disponvel Utiliza os mesmos do ambiente VR

PE

PI

PR

RJ

RN NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro

Utiliza os mesmos do ambiente VN https://ws.nfe.sefin.ro.gov.br/ws/NfeRecepcao?wsdl https://ws.nfe.sefin.ro.gov.br/ws/NfeRetRecepcao?wsdl https://ws.nfe.sefin.ro.gov.br/ws/NfeCancelamento?wsdl https://ws.nfe.sefin.ro.gov.br/ws/NfeInutilizacao?wsdl https://ws.nfe.sefin.ro.gov.br/ws/NfeConsulta?wsdl https://ws.nfe.sefin.ro.gov.br/ws/NfeStatusServico?wsdl https://ws.nfe.sefin.ro.gov.br/ws/CadConsultaCadastro?wsdl Utiliza os mesmos do ambiente VR NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro https://homologacao.nfe.sefaz.rs.gov.br/ws/nferecepcao/NfeRecepcao.asmx?WSDL https://homologacao.nfe.sefaz.rs.gov.br/ws/nferetrecepcao/NfeRetRecepcao.asmx?WSDL https://homologacao.nfe.sefaz.rs.gov.br/ws/nfecancelamento/NfeCancelamento.asmx?WSDL https://homologacao.nfe.sefaz.rs.gov.br/ws/nfeinutilizacao/NfeInutilizacao.asmx?WSDL https://homologacao.nfe.sefaz.rs.gov.br/ws/nfeconsulta/NfeConsulta.asmx?WSDL https://homologacao.nfe.sefaz.rs.gov.br/ws/nfestatusservico/NfeStatusServico.asmx?WSDL No tem este servio disponvel Utiliza os mesmos do ambiente VR

RO

RR

RS

SC

SE NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro

Utiliza os mesmos do ambiente VR https://homologacao.nfe.fazenda.sp.gov.br/nfeweb/services/nferecepcao.asmx?WSDL https://homologacao.nfe.fazenda.sp.gov.br/nfeweb/services/nferetrecepcao.asmx?WSDL https://homologacao.nfe.fazenda.sp.gov.br/nfeweb/services/nfecancelamento.asmx?WSDL https://homologacao.nfe.fazenda.sp.gov.br/nfeweb/services/nfeinutilizacao.asmx?WSDL https://homologacao.nfe.fazenda.sp.gov.br/nfeweb/services/nfeconsulta.asmx?WSDL https://homologacao.nfe.fazenda.sp.gov.br/nfeweb/services/nfestatusservico.asmx?WSDL https://homologacao.nfe.fazenda.sp.gov.br/nfeWEB/services/cadconsultacadastro.asmx?WSDL Utiliza os mesmos do ambiente VR NfeRecepcao https://hom.nfe.fazenda.gov.br/NfeRecepcao/NfeRecepcao.asmx?WSDL

SP

TO VN

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro https://hom.nfe.fazenda.gov.br/NFeRetRecepcao/NFeRetRecepcao.asmx?WSDL https://hom.nfe.fazenda.gov.br/NFeCancelamento/NFeCancelamento.asmx?WSDL https://hom.nfe.fazenda.gov.br/NFeInutilizacao/NFeInutilizacao.asmx?WSDL https://hom.nfe.fazenda.gov.br/nfeconsulta/nfeconsulta.asmx?WSDL https://hom.nfe.fazenda.gov.br/NFeStatusServico/NFeStatusServico.asmx?WSDL No tem este servio disponvel https://homologacao.nfe.sefazvirtual.rs.gov.br/ws/nferecepcao/NfeRecepcao.asmx?WSDL https://homologacao.nfe.sefazvirtual.rs.gov.br/ws/nferetrecepcao/NfeRetRecepcao.asmx?WSDL https://homologacao.nfe.sefazvirtual.rs.gov.br/ws/nfecancelamento/NfeCancelamento.asmx?WSDL https://homologacao.nfe.sefazvirtual.rs.gov.br/ws/nfeinutilizacao/NfeInutilizacao.asmx?WSDL https://homologacao.nfe.sefazvirtual.rs.gov.br/ws/nfeconsulta/NfeConsulta.asmx?WSDL https://homologacao.nfe.sefazvirtual.rs.gov.br/ws/nfestatusservico/NfeStatusServico.asmx?WSDL No tem este servio disponvel

VR

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

WebServices dos Estados - Ambiente de produo

Segue abaixo a lista dos WebServices do ambiente de produo das notas fiscais eletrnicas dos Estados.
UF AC Servio Endereo Utiliza os mesmos do ambiente VR

AL NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro

Utiliza os mesmos do ambiente VR https://nfe.sefaz.am.gov.br/ws/services/NfeRecepcao?wsdl https://nfe.sefaz.am.gov.br/ws/services/NfeRetRecepcao?wsdl https://nfe.sefaz.am.gov.br/ws/services/NfeCancelamento?wsdl https://nfe.sefaz.am.gov.br/ws/services/NfeInutilizacao?wsdl https://nfe.sefaz.am.gov.br/ws/services/NfeConsulta?wsdl https://nfe.sefaz.am.gov.br/ws/services/NfeStatusServico?wsdl No tem este servio disponvel Utiliza os mesmos do ambiente VR NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro https://nfe.sefaz.ba.gov.br/webservices/nfe/NfeRecepcao.asmx?WSDL https://nfe.sefaz.ba.gov.br/webservices/nfe/NfeRetRecepcao.asmx?WSDL https://nfe.sefaz.ba.gov.br/webservices/nfe/NfeCancelamento.asmx?WSDL https://nfe.sefaz.ba.gov.br/webservices/nfe/NfeInutilizacao.asmx?WSDL https://nfe.sefaz.ba.gov.br/webservices/nfe/NfeConsulta.asmx?WSDL https://nfe.sefaz.ba.gov.br/webservices/nfe/NfeStatusServico.asmx?WSDL https://nfe.sefaz.ba.gov.br/webservices/nfe/CadConsultaCadastro.asmx?WSDL https://nfe.sefaz.ce.gov.br/nfe/services/NfeRecepcao?WSDL https://nfe.sefaz.ce.gov.br/nfe/services/NfeRetRecepcao?WSDL https://nfe.sefaz.ce.gov.br/nfe/services/NfeCancelamento?WSDL https://nfe.sefaz.ce.gov.br/nfe/services/NfeInutilizacao?WSDL https://nfe.sefaz.ce.gov.br/nfe/services/NfeConsulta?WSDL https://nfe.sefaz.ce.gov.br/nfe/services/NfeStatusServico?WSDL https://nfe.sefaz.ce.gov.br/nfe/services/CadConsultaCadastro?WSDL Endereos do SCAN (Envio das notas em contigncia): https://www.scan.fazenda.gov.br/NfeRecepcao/NfeRecepcao.asmx?WSDL https://www.scan.fazenda.gov.br/NfeRetRecepcao/NfeRetRecepcao.asmx?WSDL https://www.scan.fazenda.gov.br/NfeCancelamento/NfeCancelamento.asmx?WSDL https://www.scan.fazenda.gov.br/NfeInutilizacao/NfeInutilizacao.asmx?WSDL https://www.scan.fazenda.gov.br/NfeConsulta/NfeConsulta.asmx?WSDL https://www.scan.fazenda.gov.br/NfeStatusServico/NfeStatusServico.asmx?WSDL No tem este servio disponvel https://nfe.fazenda.df.gov.br/nfe/services/NfeRecepcao?WSDL https://nfe.fazenda.df.gov.br/nfe/services/NfeRetRecepcao?WSDL https://nfe.fazenda.df.gov.br/nfe/services/NfeCancelamento?WSDL https://nfe.fazenda.df.gov.br/nfe/services/NfeInutilizacao?WSDL https://nfe.fazenda.df.gov.br/nfe/services/NfeConsulta?WSDL https://nfe.fazenda.df.gov.br/nfe/services/NfeStatusServico?WSDL https://nfe.fazenda.df.gov.br/nfe/services/CadConsultaCadastro?WSDL

AM

AP

BA

CE

CO

DF

ES

GO

NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro

https://nfe.sefaz.es.gov.br/Nfe/services/CadConsultaCadastro https://nfe.sefaz.go.gov.br/nfe/services/NfeRecepcao?WSDL https://nfe.sefaz.go.gov.br/nfe/services/NfeRetRecepcao?WSDL https://nfe.sefaz.go.gov.br/nfe/services/NfeCancelamento?WSDL https://nfe.sefaz.go.gov.br/nfe/services/NfeInutilizacao?WSDL https://nfe.sefaz.go.gov.br/nfe/services/NfeConsulta?WSDL https://nfe.sefaz.go.gov.br/nfe/services/NfeStatusServico?WSDL https://nfe.sefaz.go.gov.br/nfe/services/CadConsultaCadastro?WSDL Utiliza os mesmos do ambiente VN

MA NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico

MG

https://nfe.fazenda.mg.gov.br/nfe/services/NfeRecepcao?WSDL https://nfe.fazenda.mg.gov.br/nfe/services/NfeRetRecepcao?WSDL https://nfe.fazenda.mg.gov.br/nfe/services/NfeCancelamento?WSDL https://nfe.fazenda.mg.gov.br/nfe/services/NfeInutilizacao?WSDL https://nfe.fazenda.mg.gov.br/nfe/services/NfeConsulta?WSDL https://nfe.fazenda.mg.gov.br/nfe/services/NfeStatusServico?WSDL

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

CadConsultaCadastro NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro No tem este servio disponvel https://producao.nfe.ms.gov.br/producao/services/NfeRecepcao?WSDL https://producao.nfe.ms.gov.br/producao/services/NfeRetRecepcao?WSDL https://producao.nfe.ms.gov.br/producao/services/NfeCancelamento?WSDL https://producao.nfe.ms.gov.br/producao/services/NfeInutilizacao?WSDL https://producao.nfe.ms.gov.br/producao/services/NfeConsulta?WSDL https://producao.nfe.ms.gov.br/producao/services/NfeStatusServico?WSDL No tem este servio disponvel https://nfe.sefaz.mt.gov.br/nfews/NfeRecepcao?WSDL https://nfe.sefaz.mt.gov.br/nfews/NfeRetRecepcao?WSDL https://nfe.sefaz.mt.gov.br/nfews/NfeCancelamento?WSDL https://nfe.sefaz.mt.gov.br/nfews/NfeInutilizacao?WSDL https://nfe.sefaz.mt.gov.br/nfews/NfeConsulta?WSDL https://nfe.sefaz.mt.gov.br/nfews/NfeStatusServico?WSDL https://nfe.sefaz.mt.gov.br/nfews/CadConsultaCadastro?WSDL Utiliza os mesmos do ambiente VN

MS

MT

PA

PB NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro

Utiliza os mesmos do ambiente VR https://nfe.sefaz.pe.gov.br/nfe-service/services/NfeRecepcao?WSDL https://nfe.sefaz.pe.gov.br/nfe-service/services/NfeRetRecepcao?WSDL https://nfe.sefaz.pe.gov.br/nfe-service/services/NfeCancelamento?WSDL https://nfe.sefaz.pe.gov.br/nfe-service/services/NfeInutilizacao?WSDL https://nfe.sefaz.pe.gov.br/nfe-service/services/NfeConsulta?WSDL https://nfe.sefaz.pe.gov.br/nfe-service/services/NfeStatusServico?WSDL https://nfe.sefaz.pe.gov.br/nfe-service/services/CadConsultaCadastro?WSDL Utiliza os mesmos do ambiente VN NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro https://nfe.fazenda.pr.gov.br/NFENWebServices/services/nfeRecepcao?WSDL https://nfe.fazenda.pr.gov.br/NFENWebServices/services/nfeRetRecepcao?WSDL https://nfe.fazenda.pr.gov.br/NFENWebServices/services/nfeCancelamentoNF?WSDL https://nfe.fazenda.pr.gov.br/NFENWebServices/services/nfeInutilizacaoNF?WSDL https://nfe.fazenda.pr.gov.br/NFENWebServices/services/nfeConsultaNF?WSDL https://nfe.fazenda.pr.gov.br/NFENWebServices/services/nfeStatusServicoNF?WSDL No tem este servio disponvel Utiliza os mesmos do ambiente VR

PE

PI

PR

RJ

RN NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro

Utiliza os mesmos do ambiente VN https://ws.nfe.sefin.ro.gov.br/wsprod/NfeRecepcao?wsdl https://ws.nfe.sefin.ro.gov.br/wsprod/NfeRetRecepcao?wsdl https://ws.nfe.sefin.ro.gov.br/wsprod/NfeCancelamento?wsdl https://ws.nfe.sefin.ro.gov.br/wsprod/NfeInutilizacao?wsdl https://ws.nfe.sefin.ro.gov.br/wsprod/NfeConsulta?wsdl https://ws.nfe.sefin.ro.gov.br/wsprod/NfeStatusServico?wsdl https://ws.nfe.sefin.ro.gov.br/wsprod/CadConsultaCadastro?wsdl Utiliza os mesmos do ambiente VR NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro https://nfe.sefaz.rs.gov.br/ws/nferecepcao/NfeRecepcao.asmx?WSDL https://nfe.sefaz.rs.gov.br/ws/nferetrecepcao/NfeRetRecepcao.asmx?WSDL https://nfe.sefaz.rs.gov.br/ws/nfecancelamento/NfeCancelamento.asmx?WSDL https://nfe.sefaz.rs.gov.br/ws/nfeinutilizacao/NfeInutilizacao.asmx?WSDL https://nfe.sefaz.rs.gov.br/ws/nfeconsulta/NfeConsulta.asmx?WSDL https://nfe.sefaz.rs.gov.br/ws/nfestatusservico/NfeStatusServico.asmx?WSDL https://sef.sefaz.rs.gov.br/ws/CadConsultaCadastro/CadConsultaCadastro.asmx?WSDL Utiliza os mesmos do ambiente VR

RO

RR

RS

SC

SE NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro

Utiliza os mesmos do ambiente VR https://nfe.fazenda.sp.gov.br/nfeweb/services/nferecepcao.asmx?WSDL https://nfe.fazenda.sp.gov.br/nfeweb/services/nferetrecepcao.asmx?WSDL https://nfe.fazenda.sp.gov.br/nfeweb/services/nfecancelamento.asmx?WSDL https://nfe.fazenda.sp.gov.br/nfeweb/services/nfeinutilizacao.asmx?WSDL https://nfe.fazenda.sp.gov.br/nfeweb/services/nfeconsulta.asmx?WSDL https://nfe.fazenda.sp.gov.br/nfeweb/services/nfestatusservico.asmx?WSDL https://nfe.fazenda.sp.gov.br/nfeweb/services/cadconsultacadastro.asmx?WSDL Utiliza os mesmos do ambiente VR NfeRecepcao https://www.sefazvirtual.fazenda.gov.br/NfeRecepcao/NfeRecepcao.asmx?WSDL

SP

TO VN

10

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro NfeRecepcao NfeRetRecepcao NfeCancelamento NfeInutilizacao NfeConsultaNF NfeStatusServico CadConsultaCadastro https://www.sefazvirtual.fazenda.gov.br/NFeRetRecepcao/NFeRetRecepcao.asmx?WSDL https://www.sefazvirtual.fazenda.gov.br/NFeCancelamento/NFeCancelamento.asmx?WSDL https://www.sefazvirtual.fazenda.gov.br/NFeInutilizacao/NFeInutilizacao.asmx?WSDL https://www.sefazvirtual.fazenda.gov.br/nfeconsulta/nfeconsulta.asmx?WSDL https://www.sefazvirtual.fazenda.gov.br/NFeStatusServico/NFeStatusServico.asmx?WSDL No tem este servio disponvel https://nfe.sefazvirtual.rs.gov.br/ws/nferecepcao/NfeRecepcao.asmx?WSDL https://nfe.sefazvirtual.rs.gov.br/ws/nferetrecepcao/NfeRetRecepcao.asmx?WSDL https://nfe.sefazvirtual.rs.gov.br/ws/nfecancelamento/NfeCancelamento.asmx?WSDL https://nfe.sefazvirtual.rs.gov.br/ws/nfeinutilizacao/NfeInutilizacao.asmx?WSDL https://nfe.sefazvirtual.rs.gov.br/ws/nfeconsulta/NfeConsulta.asmx?WSDL https://nfe.sefazvirtual.rs.gov.br/ws/nfestatusservico/NfeStatusServico.asmx?WSDL No tem este servio disponvel

VR

11

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

Tabela de cdigos das Unidades Federativas/Estados

Nome do Estado Acre Alagoas Amap Amazonas Bahia Cear Distrito Federal Esprito Santo Gois Maranho Mato Grosso Mato Grosso do Sul Minas Gerais Par Paraba Paran Pernambuco Piau Rio de Janeiro Rio Grande do Norte Rio Grande do Sul Rondnia Roraima Santa Catarina So Paulo Sergipe Tocantins Cdigo 12 27 16 13 29 23 53 32 52 21 51 50 31 15 25 41 26 22 33 24 43 11 14 42 35 28 17

12

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

Alguns obstculos enfrentados

Comeamos a estudar as classes do .NET para alm de fazer a assinatura digital dos arquivos XML, mas tambm para fazer o envio dos XMLs para os diversos servios da NFe. Encontramos um cdigo escrito em C# em um manual de credenciamento do SEFAZ do Rio Grande do Sul, que faria todo o trabalho. Tentamos utilizar este cdigo, mas no conseguimos xito na primeira tentativa, visto que ao criarmos a referncia do WebService no Visual C#, a herana que a classe dos servios fazia estava diferente da sugerida no manual do SEFAZ-RS. Iniciamos ento uma busca de informaes para saber o que poderia estar errado, e descobrimos que o .NET 3.5 utiliza outras classes para atingir o fim que necessitvamos. Ento teramos que decidir, ou aprenderamos esta nova classe ou voltaramos para o .NET 2.0 para fazer testes. Optamos por esta ltima e o cdigo compilou normalmente, apesar de no funcionar totalmente. Tivemos que fazer algumas adaptaes para que o mesmo atingisse o objetivo (no vamos fazer referncia a todos os problemas, pois o cdigo disponvel j est adaptado para funcionar 100%).

13

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

Testar o certificado digital para a NF-e

Para testar o seu certificado para a emisso da NF-e, siga os seguintes passos: Acesse o site: http://www.receita.fazenda.gov.br/AtendVirtual/entradaCAV.htm Clique no boto continuar Ser apresentada uma tela com o CNPJ e o nome do titular do certificado, indicando que seu certificado est funcionando corretamente. Se isso no ocorrer, existe algum problema no certificado.

Abaixo segue algumas dicas para tentar resolver problemas com o certificado digital: 1. Para limpar o cache do seu navegador, siga o procedimento abaixo: o Abra o navegador de Internet e clique no menu Ferramentas; o Clique em Opes da Internet; o Na aba Geral, Clique em 'Excluir... ' depois em 'Excluir Tudo... '; o Aps Clique em Sim; o V aba Avanadas e clique no boto 'Restaurar Configuraes Avanadas'; o Acesse a Aba Contedo e Clique em 'Limpar estado SSL'; o V aba Segurana e clique em 'Nvel padro', caso esteja habilitado; o Feche todas as Janelas de navegao;

14

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

Contatos e endereos importantes

Abaixo segue uma relao de contatos e sites importantes que facilitam a busca de informaes, testes das rotinas da NF-e, etc... 1. Site do SEFAZ do Rio Grande do Sul: Contm muita informao sobre a NFe e links interessantes, dentre ele um site que testa o seu XML para ver se tem algo de errado no formato, inclusive testa as tags de assinatura digital. Contedo sobre NF-e: http://www.sefaz.rs.gov.br/SEF_ROOT/inf/SEF-NFE.htm Validador de mensagens XML: http://www.sefaz.rs.gov.br/AAE_ROOT/NFE/SAT-WEB-NFE-VAL_1.asp 2. O portal da nota fiscal eletrnica tambm tem muita informao importante, vale a pena analisar todo seu contedo. Portal do ambiente de produo: http://www.nfe.fazenda.gov.br/portal/ Portal do ambiente de homologao: http://hom.nfe.fazenda.gov.br/PORTAL/ A principal diferena entre o portal de homologao para o de produo que na hora de consultar a lista de WebServices, o mesmo vai demonstrar os servios para testes (no ambiente de homologao) e o outro para produo. 3. O site do SERASA tem muita informao sobre Certificao Digital, vale a pela ler e entender os tipos de certificados, etc... http://www.certificadosdigitais.com.br/compras/Conteudo/Conteudo.aspx?Categoria =FAQ 4. O site abaixo possui alguns exemplos de cdigos e vrias explicaes sobre certificao digital, nota fiscal eletrnica, schemas de XML (XSD), etc... http://nf-eletronica.com/ 5. Suporte on-line da Certisign na parte de Certificados Digitais. Eles tiram muitas dvidas e ajudam a solucionar problemas com a certificao digital. http://www10.directtalk.com.br/clientes/custom/certisign/index_sac.htm 6. Repositrio de Certificados - Arquivo nico Compactado. Instale todas as cadeias de certificados existentes para fazer os web-services funcionarem. http://www.iti.gov.br/twiki/bin/view/Certificacao/RepoZipCert

15

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e Leia mais sobre este certificados no link abaixo para entender melhor o funcionamento: http://nf-eletronica.com/blog/?p=86#more-86 7. Caso for enviar e-mail, utilize o seguinte modelo para facilitar a identificao e o entendimento do contedo: a. No ttulo coloque [NFe] b. Como texto utilize o seguinte:
Contribuinte: NOME DO CLIENTE QUE VAI EMITIR A NOTA FISCAL ELETRNICA CNPJ: CNPJ DO CLIENTE QUE VAI EMITIR A NOTA FISCAL ELETRNICA MUNICIPIO/UF: MUNICIPIO E ESTADO DO CLIENTE QUE VAI EMITIR A NOTA FISCAL ELETRNICA Tipo de emissor: Prprio Ambiente: Homologao ou Produo Descrio da Ocorrncia: Descrever a ocorrncia conforme exemplo abaixo: Quando tento consumir o webservice NfeStatusServico, sempre obtenho como resposta um erro relecionado a verso do XML, e gostaria de saber qual a verso correta. O erro est no item Mensagem de erro e Detalhamento Mensagem de erro e Detalhamento: Detalhar o problema conforme o exemplo abaixo (colocar modelos de XMLs utilizados se for o caso). 1. cabecMSG.XML enviado: <?xml version="1.0" encoding="UTF-8" ?> <cabecMsg xmlns="http://www.portalfiscal.inf.br/nfe" versao="1.00"> <versaoDados>1.07</versaoDados> </cabecMsg> ped-sta.xml enviado: <?xml version="1.0" encoding="UTF-8"?> <consStatServ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" versao="1.02" xmlns="http://www.portalfiscal.inf.br/nfe"> <tpAmb>2</tpAmb> <cUF>41</cUF> <xServ>STATUS</xServ> </consStatServ> XML de retorno obtido <retConsStatServ versao="" xmlns="http://www.portalfiscal.inf.br/nfe"><tpAmb>1</tpAmb><verAplic>2.00</verAplic><cStat >238</cStat><xMotivo>Rejeicao: Cabecalho - Versao do arquivo XML superior a Versao vigente</xMotivo><cUF>99</cUF><dhRecbto>2008-0603T10:58:31</dhRecbto></retConsStatServ>

2.

3.

No item 3 referente ao XML de retorno, o erro diz que a verso do arquivo XML superior a Verso vigente. Qual XML que eu enviei est com a verso errada? Qual a verso correta? J pesquisei os manuais e no consegui qual est sendo utilizada atualmente. No aguardo de uma resposta, Agradeo a ateno, Fulano de TAL

16

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

Programador blabla@blabla.com.br

17

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

Erros e solues
No processo de homologao do nosso sistema ocorreram alguns erros, para os quais pesquisei em busca das respectivas solues e neste tpico vou relatar alguns erros e suas solues: 1. Ao tentar consumir o servio NfeRecepcao, o primeiro retorno que tive foi o seguinte: a. 215 - Rejeicao: Falha no schema XML i. Utilizei o seguinte site para validar o arquivo XML em busca de falhas: http://www.sefaz.rs.gov.br/AAE_ROOT/NFE/SAT-WEB-NFE-VAL_1.asp ii. O primeiro problema que eu encontrei foi com relao a alguns caracteres que no podem ser utilizados no contedo passado para as TAGs do XML, a tabela destes caracteres pode ser consultada no manual de integrao da NFe encontrado no portal http://www.nfe.fazenda.gov.br. Abaixo eu vou relatar os caracteres, mas interessante analisar o manual para ver se algo novo no foi includo. Caractere Seqncia de Escape < &lt; > &gt; & &amp; " &quot; ' &#39; b. Fique esperto com o Windows Vista, at agora no consegui autenticar no estado do Mato Grosso utilizando o Windows Vista. c. Novamente tentando consumir o servio NfeRecepcao obtive um erro bem atpico como retorno:
org.apache.velocity.exception.ResourceNotFoundException: O arquivoTemplate (retornoCancelamento.vm) nao existe no diretorio /usr/appl/nfe/template/ <ns1:hostname xmlns:ns1=\"http://xml.apache.org/axis/\">vermelho.sefaz.mt.gov.br</ns1:hostname>"

Este problema est relacionado com a estrutura do XML que est sendo enviado, assim sendo tem que se analisar para ver se no tem alguma tag, atributo errado no XML, no meu caso vou postar o que ocorreu, mas pode ser que ocorra em outro ponto do arquivo. A primeira linha do meu XML estava com o seguinte contedo:
<?xml version="1.0" encoding="UTF-8" standalone="no"?>

Estando desta forma ocasionava o erro citado, o correto era ser assim: 18 Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

<?xml version="1.0" encoding="UTF-8"?>

Feito este acerto o envio da nota fiscal se deu corretamente. Outro problema que gerou este mesmo erro foi o fato de eu no ter compreendido que ao tentar enviar a nota fiscal utilizando o servio NfeRecepcao, eu deveria gerar um XML de Lote de NFe e no somente o XML da NFe, quando eu tentava enviar gerava o erro. O XML que deve ser passado para o NfeRecepcao o de lote de Nfe. d. Se voc est utilizando .NET para o envio das notas fiscais, procure utilizar a verso 2.0 pois compatvel com os cdigos de exemplo liberados na internet. Se utilizar o 3.0 ou 3.5, os servios referenciados herdam outras classes do .NET que a princpio eu no consegui fazer funcionar, no 2.0 transparente e funciona na hora, sem dificuldades. e. Outro erro que ocorreu foi na hora de gerar e enviar o lote de notas fiscais, pois eu obtinha como retorno que o lote tinha sido processado, mas ao tentar consultar a nota fiscal com o WebService NfeConsulta, tinha como retorno que a nota fiscal no foi localizada na base de dados. O problema que na hora de gerar o nmero do lote que vai ao XML de lotes de NF-e, a numerao j tinha sido utilizada anteriormente em outro teste, assim o sistema do WebService no processava e tambm no retornava um erro, desta forma tem que se ter muita ateno para ver se o nmero do lote j no foi enviado. Abaixo segue um exemplo do XML para que facilitar a identificao do nmero do lote em questo (Observe a parte em amarelo):
<?xml version="1.0" encoding="utf-8" ?> <enviNFe xmlns="http://www.portalfiscal.inf.br/nfe" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" versao="1.10"> <idLote>000000000000301</idLote> <NFe xmlns="http://www.portalfiscal.inf.br/nfe"> <infNFe xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Id="NFe51080676472349000430550010000001041671821888" versao="1.10">

2. Com o Estado do Mato Grosso do Sul o download dos WSDL foi simples, mas ao tentar acessar o servio obtnhamos um erro do prprio C# de conexo, e para resolver o problema tivemos que instalar alguns certificados do SEFAZ MT que podem ser localizados no seguinte endereo: http://www.nfe.ms.gov.br/site/listatexto.do?op=lt&tblCanal_Id=6 Analise tambm o tpico Testar o certificado digital para a NFe que tambm tem algumas dicas para resolver problemas de certificao digital.

19

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

Padronizao dos Nomes dos XML

de fundamental importncia que se tenha uma padronizao dos nomes dos arquivos XML para facilitar o processo de arquivamento e leitura de outros softwares, pois os nomes sero sempre da mesma forma, facilitando assim o B2B. A padronizao abaixo foi retirada do manual de integrao da NFe, ou seja, algo sugerido pelo prprio governo para facilitar as integraes. Analise: TABELA DE PADRONIZAO DOS NOMES DOS ARQUIVOS XML NF-e: O nome do arquivo ser a chave de acesso completa com extenso -nfe.xml; Envio de Lote de NF-e: O nome do arquivo ser o nmero do lote com extenso -envlot.xml; Recibo: O nome do arquivo ser o nmero do lote com extenso -rec.xml; Pedido do Resultado do Processamento do Lote de NF-e: O nome do arquivo ser o nmero do recibo com extenso -ped-rec.xml; Resultado do Processamento do Lote de NF-e: O nome do arquivo ser o nmero do recibo com extenso -pro-rec.xml; Denegao de Uso: O nome do arquivo ser a chave de acesso completa com extenso den.xml; Pedido de Cancelamento de NF-e: O nome do arquivo ser a chave de acesso completa com extenso -ped-can.xml; Cancelamento de NF-e: O nome do arquivo ser a chave de acesso completa com extenso can.xml; Pedido de Inutilizao de Numerao: O nome do arquivo ser composto por: UF + Ano de inutilizao + CNPJ do emitente + Modelo + Srie + Nmero Inicial + Nmero Final com extenso -ped-inu.xml; Inutilizao de Numerao: O nome do arquivo ser composto por: Ano de inutilizao + CNPJ do emitente + Modelo + Srie + Nmero Inicial + Nmero Final com extenso inu.xml; Pedido de Consulta Situao Atual da NF-e: O nome do arquivo ser a chave de acesso completa com extenso -ped-sit.xml; Situao Atual da NF-e: O nome do arquivo ser a chave de acesso completa com extenso sit.xml; Pedido de Consulta do Status do Servio: O nome do arquivo ser: AAAAMMDDTHHMMSS do momento da consulta com extenso -ped-sta.xml; Status do Servio: O nome do arquivo ser: AAAAMMDDTHHMMSS do momento da consulta com extenso -sta.xml;

20

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

Assinatura Digital dos Arquivos XML

Alguns arquivos XML devem ser assinados digitalmente seguindo alguns critrios que podem ser encontrados no manual de integrao da NFE disponibilizado no portal nacional da nota fiscal eletrnica, mas gostaria de deixar algumas dicas para facilitar: Nem todos os arquivos XMLs tm que ser assinados digitalmente antes de serem enviados para o servio, e para facilitar, segue abaixo a lista dos que tm a necessidade: Arquivo de Nota Fiscal (-nfe.xml) Lembrando que se estiver enviando um lote de nota fiscal, ou seja, mais de uma nota, cada nota deve ser assinada individualmente. aconselhvel assinar os XMLs das notas e depois de assinado gerar o lote (arquivo XML com todas as notas) a ser enviado. Arquivo de Cancelamento de Nota Fiscal (-ped-can.xml) Arquivo de Inutilizao de Nmeros de Notas Fiscais (-ped-inu.xml)

21

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

Validao dos Arquivos XML (Schemas)

Todos os XMLs enviados para os WebServices passam por uma validao que pode ser feita mesmo antes de ser enviado para evitar trfego na internet, pois se for com erro o servio vai rejeitar. Para tanto tem que baixar o pacote de schemas em vigor (digo em vigor pelo fato de ter verses novas sendo preparadas, assim sendo busque no SEFAZ do estado em questo a verso habilitada), estes so responsveis por validar a estrutura do XML e demonstrar os erros encontrados, facilita muito a programao. Para isso ter que desenvolver uma classe para fazer esta validao ou utilizar programas que j fazem isso. Abaixo vo algumas dicas: No site do SEFAZ do Rio Grande do Sul tem uma pgina que faz a validao, basta copiar e colocar o XML na caixa de texto do site e mandar validar. http://www.sefaz.rs.gov.br/AAE_ROOT/NFE/SAT-WEB-NFE-VAL_1.asp Existe tambm o programa chamado Visualizador Nfe que pode ser encontrado no Portal Nacional da Nota Fiscal Eletrnica. (www.nfe.fazenda.gov.br na seo downloads) Existe tambm um programa chamado AssinadorRS que para assinar digitalmente os arquivos XML, ele faz uma validao dos arquivos e aponta as falhas, at mesmo de caracteres invlidos como os de acentuao, dizendo a linha e coluna do XML que est o problema. (www.nfe.fazenda.gov.br na seo downloads)

22

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

Verses dos dados dos arquivos XML

Todos os dados enviados para os servios da Receita o so atravs de dois arquivos XML, um contendo somente a verso dos dados que sero enviados e o outro contendo os dados em questo. Por exemplo: Digamos que iremos enviar um lote de notas fiscais para o servio NfeRecepcao. O envio se d da seguinte forma:
oServico.NfeRecepcao( stringCabecMsg, stringDadosMsg )

stringCabecMsg uma cadeia de caracteres que contm o XML da verso de dados

<?xml version="1.0" encoding="UTF-8" ?> <cabecMsg xmlns="http://www.portalfiscal.inf.br/nfe" versao="1.02"> <versaoDados>1.10</versaoDados> </cabecMsg>

stringDadosMsg uma cadeia de caracteres que contm o XML da nota fiscal

<?xml version="1.0" encoding="utf-8"?> <NFe xmlns="http://www.portalfiscal.inf.br/nfe"> <infNFe xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Id="NFe51080676472349000430550010000001041671821888" versao="1.10"> <ide> <cUF>51</cUF> <cNF>167182188</cNF> ... ... ... </NFe>

Deve-se ter muita ateno nos itens destacados em amarelo, pois a verso deve ser a mesma, ou voc vai ter srios problemas na hora de identificar a falha, pois tem alguns servidores do SEFAZ que no retornam o erro de forma clara e voc no tem a mnima idia do que est acontecendo.

23

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

Dicas Diversas
Utilize o programa do SEFAZ de So Paulo para digitar notas fiscais, validar, assinar e gerar um XML de nota fiscal para voc ter uma idia da estrutura, facilita na hora de fazer testes e comparaes. Utilize o MMC do Windows para gerenciar os certificados digitais, bem mais prtico, para tanto basta seguir os passos seguintes: o o o Clique em Iniciar Clique na opo Executar Digite na caixa de texto MMC.EXE e pressione o boto OK Vai abrir uma tela de Console, selecione o menu Arquivo Selecione a opo Adicionar e remover Snap-ins Selecione na lista de Snap-in disponveis o item Certificados Pressione o boto Adicionar Pressione o boto OK Vai aparecer a tela de gerenciamento dos certificados. Gerencie...

24

Unimake Softwares Wandrey Mundin ferreira

Integrando aplicativos a NF-e

Concluso
Esperamos que este material seja til aos companheiros programadores e tambm s empresas que desejarem utilizar o UniNFe para a integrao da nota fiscal eletrnica. Aos programadores que desejarem colaborar com o crescimento deste produto, procurem fazer contato e enviar sugestes ou cdigos j modificados que iremos adaptando o sistema a fim de melhor-lo cada vez mais. Contatos da Unimake: http://www.unimake.com.br/uninfe nfe@unimake.com.br

25

Unimake Softwares Wandrey Mundin ferreira