Baixe o documento contendo as instruções básicas de uso.
Contents
1. es e crit rios t cnicos necess rios para utiliza o do Web Service do Sistema de Nota Fiscal de Servi os Eletr nica NFS e disponibilizado pela Prefeitura para as empresas prestadoras e ou tomadoras de servi os Atrav s do Web Service disponibilizado as empresas podem integrar seus pr prios sistemas de informa es com o Sistema de NFS e da Prefeitura Desta forma consegue se automatizar o processo de emiss o consulta e cancelamento de NFS e O Web Service e todos os seus servi os referenciados nesse documento s o baseados no modelo nacional de NFS e definido pela Associa o Brasileira de Secret rios e Dirigentes das Finan as dos Munic pios das Capitais ABRASF e pela Receita Federal do Brasil RFB Revisado em 27 11 2013 P gina 4 de 14 NOTA FISCAL DE SERVI O ELETR NICA NFS e Manual de Utiliza o do Web Service Modelo Nacional 2 Servi os Dispon veis 2 1 Servi os do Modelo Nacional A seguir est o resumidos os servi os disponibilizados pelo WebService visando automatizar o processo de emiss o consulta e cancelamento de Notas Fiscais de Servi os Eletr nicas NFS e ATEN O A descri o completa destes m todos pode ser obtida diretamente do Manual de Integra o da ABRASF https n se recife pe gov br arquivos nfse abrasf integracao pdf Todos os servi os a seguir exigem o uso de certificados digitais ICP Brasil para autentica o 2 1 1 Recep o e Processamento2. n o pode ser alterada O status atual desta nota n o permite A NFS e n o pode ser alterada altera o A NFS e informada n o est apta para a A compet ncia da NFS e n o pode ser alterada troca de compet ncia A data para nova compet ncia n o deve Utilize uma compet ncia v lida ser superior compet ncia atual O CPF CNPJ do usu rio autorizado a Somente CPF CNPJ autorizados poder o enviar arquivos XML enviar a mensagem XML n o confere com o CPF CNPJ usado na comunica o Revisado em 27 11 2013 RECIFE P gina 13 de 14 NOTA FISCAL DE SERVI O ELETR NICA NFS e Manual de Utiliza o do Web Service Modelo Nacional C D MENSAGEM SOLU O 971 Tamanho da mensagem XML ultrapassou o limite m ximo permitido de Kbytes Divida a quantidade de NFS e em dois ou mais arquivos para diminuir o tamanho do XML 972 973 974 Mensagem XML de Pedido do servico sem conte do Rejei o Certificado Inv lido O lote informado n o pertence a este prestador Verifique o conte do do arquivo XML Utilize um certificado v lido Informe o lote correto 975 Esse lote n o possui informa es de retorno Verifique o lote enviado 976 O lote informado n o possui nenhuma NFS e Verifique o n mero do lote 977 J existe uma solicita o de cancelamento para essa NFS e Uma N
3. preencha o desconto condicionado desconto condicionado com O zero C digo do Servi o da NFS e n o permite Altere o c digo de servi o ou preencha o desconto desconto incondicionado incondicionado com O zero C digo do Servi o da NFS e n o aceita Altere o c digo de servi o ou n o preencha as informa es de informa es de constru o civil constru o civil C digo do Servi o da NFS e n o aceita Altere o c digo de servi o ou n o preencha as informa es de informa es de intermedi rio de servi o intermedi rio de servi o O RPS X j foi substitu do pela NFS e Y O RPS n o pode ser convertido mais de uma vez Remova este RPS do arquivo XML O valor da soma das dedu es e Verifique o valor das dedu es e descontos descontos dever ser inferior ao valor dos servi os Erro informando o motivo da n o Esta NFS e n o poder ser cancelada devido ao motivo permiss o de cancelamento de uma especificado NFS e N o permitido a emiss o de notas com Altere a op o do Regime Especial Regime Especial de Estimativa N o permitido a emiss o de notas com Altere a op o do Regime Especial Regime Especial de Cooperativa A data da nova compet ncia n o deve Altere a data da compet ncia ser inferior compet ncia de cria o da NFS e A NFS e informada n o consta como A NFS e dever ser retida retida A NFS e informada consta na guia XXX A NFS e informada j foi incluida na guia XXX e
4. processamento do RPS Esse servi o ser executado atrav s da chamada ao m todo GerarNfse passando a mensagem XML como par metro com a estrutura definida na tabela que segue GerarNfseEnvio Nome Tipp Pai Ocorr ncia Observa o 1 GerarNfseEnvio 1 11 poros 0 tros 0 1 11 5 Em resposta a chamada do servi o ser devolvida a estrutura definida na tabela a seguir GerarNfseResposta E Home To Psi Ocorr ncia Observa o 1 GerarN seResposta O CompNse CompNfse DEE ES ListaMensagemRetorno ListaMensagemRetorno mm E IE SEE Choice OBS O elemento CompN se retornado caso o RPS seja processado com sucesso Em caso de alertas o RPS processado sendo retornado a s mensagen s de alerta tipo ListaMensagemRetorno e a NFS e gerada tipo CompNfse Em caso de erro a NFS e n o gerada sendo retornado apenas a s mensagen s de erro s ocorridos tipo ListaMensagemRetorno Revisado em 27 11 2013 P gina 6 de 14 NOTA FISCAL DE SERVI O ELETR NICA NFS e Manual de Utiliza o do Web Service Modelo Nacional 3 Especifica es T cnicas 3 1 Modelo Nacional O Modelo Nacional de NFS e elaborado pela ABRASF em conjunto com a Receita Federal descreve a arquitetura de comunica o com o contribuinte e a estrutura de dados utilizada pelo WebService detalhando os conceitos prem
5. FS e s pode uma solicita o de cancelamento Aguarde a aprova o rejei o do fiscal 979 O n mero do lote do contribuinte informado j existe Utilize outro n mero para o lote 980 Erro ao processar lote do webservice Re envie o lote para que ele seja processado novamente 981 Inscri o do Prestador especificada no Arquivo n o confere com o Prestador selecionado Preencha a inscri o do prestador corretamente 982 Item da lista de servi o informado incompat vel com o c digo de tributa o no munic pio Preencha o item da lista de servi o corretamente 984 985 Contribuinte n o autorizado a emitir nota isenta Contribuinte n o autorizado a emitir nota imune Altere o Tipo de Tributa o dos Servi os Altere o Tipo de Tributa o dos Servi os 986 Contribuinte n o autorizado a emitir nota Altere o Tipo de Tributa o dos Servi os com suspens o judicial 4 3 Rela o de Alertas Munic pio do Recife C D MENSAGEM SOLU O 941 Alerta informando o motivo da solicita o manual de substitui o de NFS e Esta NFS e necessita de aprova o de um fiscal para ser substituida cancelada Aguarde a resposta do fiscal 942 Cidade UF informada n o foi encontrada na base de dados Preencher os campos Cidade UF com os dados corretos Em caso de cidades do exterior fora do pa s deixar campos Cidade UF em
6. PREFEITURA DO RECIFE NOTA FISCAL DE SERVI OS ELETR NICA NFS e Manual de Utiliza o do Web Service Modelo Nacional Vers o 1 1 P gina 2 de 14 NOTA FISCAL DE SERVI O RECIFE ELETR NICA NFS e Manual de Utiliza o do Web Service Modelo Nacional ndice 1 INTRODU O 2 SERVI OS DISPON VEIS 2 1 SERVI OS DO MODELO NACIONAL 2 1 1 Recep o e Processamento de Lote de RPS ass ncrono 2 1 2 Consulta de Situa o de Lote de RPS 2 1 8 Consulta de Lote de RPS 2 1 4 Consulta de NFS e 2 1 5 Cancelamento de NFS e 2 2 SERVI OS EXCLUSIVOS DE RECIFE 2 2 1 Gera o de NFS e individual online e s ncrono 3 ESPECIFICA ES T CNICAS 3 1 MODELO NACIONAL 3 2 ENDERE O DO WEBSERVICE 3 3 INTERFACES DO WEBSERVICE WSDL 3 4 TAMANHO M XIMO DAS MENSAGENS XML 3 5 ScHEMAS XML 3 6 EXEMPLOS 3 7 EXEMPLO DE ASSINATURA DIGITAL DA MENSAGEM XML 3 8 EXEMPLO DE ASSINATURA DIGITAL DE ELEMENTOS XML 4 C DIGOS DE CANCELAMENTO ERROS E ALERTAS 4 1 C DIGOS DE CANCELAMENTO DE NFS E MUNIC PIO DO RECIFE 4 2 RELA O DE ERROS MUNIC PIO DO RECIFE 4 3 RELA O DE ALERTAS MUNIC PIO DO RECIFE 5 CRIANDO UM LINK PARA A NFS E EMITIDA Revisado em 27 11 2013 P gina 3 de 14 NOTA FISCAL DE SERVI O RECIFE ELETR NICA NFS e Manual de Utiliza o do Web Service Modelo Nacional Introdu o Este manual tem como objetivo apresentar a defini o das especifica
7. ado Obs Por padr o o NOME do atributo possui a mesma identifica o AtributeName Id lt param gt Public Sub AssinarElementos ByVal Document As XmlDocument ByVal x509 As X509Certificate2 ByVal ParentElementName As String ByVal ElementName As String ByVal AttributeName As String el As XmlElement elInf As XmlElement elInfID As String elSigned As SignedXml Key As RSACryptoServiceProvider keyInfo As New KeyInfo Retira chave privada ligada ao certificado Key CType x509 PrivateKey RSACryptoServiceProvider Adiciona Certificado ao Key Info keyInfo AddClause New KeyInfoX509Data x509 For Each el In Document GetElementsByTagName ParentElementName SIBI CType el GetElementsByTagName ElementName el GetElementsByTagName ElementName Count 1 XmlElement lInfID elInf Attributes GetNamedItem AttributeName Value lSigned New SignedXml elInf Revisado em 27 11 2013 P gina 10 de 14 NOTA FISCAL DE SERVI O RECIFE ELETR NICA NFS e Manual de Utiliza o do Web Service Modelo Nacional Seta chaves elSigned Signingkey Key elSigned KeyInfo keyInfo Cria referencia Dim reference As New Reference reference Uri p Ee TTD Adiciona tranformacao a referencia reference AddTransform New XmlDsigEnvelopedSignatureTransform reference AddTransform New XmlDsigCl4NTransform False Adiciona referencia ao xml elSigned AddReference reference Calcula Assinatura e
8. branco Sigla da UF do tomador n o corresponde ao CEP informado Corrija a sigla da UF ou o CEP do tomador do servi o Revisado em 27 11 2013 P gina 14 de 14 NOTA FISCAL DE SERVI O RECIFE ELETR NICA NFS e Manual de Utiliza o do Web Service Modelo Nacional 5 Criando um link para a NFS e Emitida O sistema de NFS e da Prefeitura pode enviar um email padr o autom tico com o link que permite a visualiza o da NFS e emitida para todos os tomadores de servi os Os contribuintes que possuem sistema informatizado e que quiserem enviar atrav s de seu pr prio sistema um email personalizado para seus clientes com um link de acesso para visualizar imprimir a NFS e emitida podem faz lo utilizando a estrutura abaixo https nfse recife pe gov br nfse aspx ccm 99999999 amp nf 999999999 amp cod XXXXXXXX cem Inscricao do Prestador de Servicos sem formato nf Numero da NFS e sem formato cod C digo de Verificacao da NFS e sem tra o Este mesmo link pode ser utilizado diretamente no sistema do pr prio contribuinte como uma forma r pida de visualiza o impress o da NFS e sem necessidade de se logar no sistema Revisado em 27 11 2013
9. chemas XML Todos os schemas XML utilizados pelo WebService podem ser obtidos no endereco eletr nico https nfse recife pe gov br WSNacional schemas zip Revisado em 27 11 2013 P gina 7 de 14 NOTA FISCAL DE SERVI O RECIFE ELETR NICA NFS e Manual de Utiliza o do Web Service Modelo Nacional 3 6 Exemplos Diversos exemplos de mensagens XML pedido e retorno de cada um dos m todos disponibilizados podem ser obtidos no endere o eletr nico https nfse recife pe gov br WSNacional exemplos zip 3 7 Exemplo de assinatura digital da mensagem XML As mensagens enviadas ao Sistema de Nota Fiscal de Servi o Eletr nica da Prefeitura deste Munic pio s o documentos eletr nicos elaborados no padr o XML e podem opcionalmente ser assinados digitalmente utilizando certificado digital Veja abaixo um exemplo de assinatura digital da mensagem XML lt summary gt Exemplo de como assinar uma mensagem XML com um certificado digital Linguagem VB NET Eramework 3 5 lt summary gt lt param name mensagemXML gt String contendo a pr pria mensagem XML lt param gt param name certificado gt 0 certificado que ser usado para assinar a mensagam XML lt param gt lt returns gt Um objeto do tipo XmlDocument j assinado lt returns gt lt remarks gt lt remarks gt Private Function Assinar ByVal mensagemXML As String ByVal certificado As System Security Cryptography x509Certificates x509Certificate2 As X
10. de Lote de RPS ass ncrono Esse servi o compreende a recep o do Lote de RPS a resposta com o n mero do protocolo gerado para esta transa o e o processamento do lote ass ncronamente 2 1 2 Consulta de Situa o de Lote de RPS Esse servi o efetua a consulta da situa o de um Lote de RPS j enviado 2 1 3 Consulta de Lote de RPS Esse servi o permite ao contribuinte obter as NFS e que foram geradas a partir do Lote de RPS enviado quando o processamento ocorrer sem problemas ou obter a lista de erros e ou inconsist ncias encontradas no Lode de RPS enviado Na valida o do lote s o retornados todos os erros verificados Excepcionalmente havendo uma excessiva quantidade de erros poder ser definido um limitador para a quantidade de erros retornados 2 1 4 Consulta de NFS e Esse servi o permite a obten o de determinada NFS e j gerada 2 1 5 Cancelamento de NFS e Esse servi o permite o cancelamento direto de uma NFS e sem substitui o da mesma por outra Veja no item 4 1 os c digos de cancelamento dispon veis Revisado em 27 11 2013 P gina 5 de 14 ens NOTA FISCAL DE SERVICO RECIFE ELETR NICA NFS e Manual de Utilizac o do Web Service Modelo Nacional Servicos exclusivos de Recife 2 2 1 Gera o de NFS e individual online e s ncrono Esse servico compreende o envio s ncrono de um nico RPS e o retorno da respectiva NFS e gerada e ou mensagens de erros e alerta no
11. issas e regras de neg cios envolvidas as funcionalidades e os servi os disponibilizados os padr es t cnicos de comunica o certifica o e assinatura digital a estrutura esquema e valida o das mensagens XML o modelo conceitual e operacional de uso dos WebServices os formatos e padr es adotados e os tipos simples e complexos utilizados Os documentos descritivos do modelo nacional Modelo de Integra o podem ser obtidos atrav s do endere o eletr nico https n se recife pe gov br arquivos nfse abrasf integracao pdf 3 2 Endere o do WebService O endere o eletr nico de PRODU O do WebService disponibilizado pela Prefeitura https nfse recife pe gov brAWSNacional nfse v01 asmx ATEN O Para acessar este endere o e utilizar o WebService necess rio se autenticar usando certificado digital ICP Brasil conforme explicado no Manual Nacional do Modelo de Integra o As assinaturas digitais do RPS do Lote de RPS e ou do Cancelamento da NFS e s o OPCIONAIS ficando a crit rio do contribuinte sua assinatura ou n o 3 3 Interfaces do WebService WSDL As especifica es de interface do WebService WSDL podem ser obtidas mediante o uso de certificados digitais ICP Brasil atrav s do endere o eletr nico https nfse recife pe gov br WSNacional nfse v01 asmx wsdl 3 4 Tamanho M ximo das Mensagens XML O tamanho m ximo permitido para o envio de mensagem XML pelo webservice de 512 KB 3 5 S
12. lSigned ComputeSignature Adiciona assinatura el AppendChild Document ImportNode elSigned GetXml True End Class Revisado em 27 11 2013 P gina 11 de 14 aM NOTA FISCAL DE SERVICO RECIFE ELETR NICA NFS e Manual de Utiliza o do Web Service Modelo Nacional C digos de Cancelamento Erros e Alertas As tabelas a seguir relacionam os erros alertas e procedimentos espec ficos do munic pio do Recife na substitui o do Recibo Provis rio de Servi os RPS por NFS e atrav s de arquivo XML Consulte o manual da Abrasf para obter os demais c digos de erros e alertas utilizados https nfse recife pe gov br arquivos nfse abrasf integracao pdf 4 1 C digos de Cancelamento de NFS e Munic pio do Recife C digos de Cancelamento Erro na emiss o Servi o n o prestado Duplicidade da nota Outros 4 2 Rela o de Erros Munic pio do Recife C D MENSAGEM SOLU O CPF CNPJ do Tomador de Servi os Os d gitos verificadores do CPF CNPJ informado dois ltimos 902 inv lido d gitos verificadores n o algarismos n o conferem Acerte o CPF CNPJ do tomador e conferem reenvie o arquivo O Valor dos servi os dever ser superior N o permitido envio de RPS com valor de servi os inferior a ou igual a R 0 00 zero zero negativos C digo do Servi o c digo enviado da Consulte a legisla o vigente para saber o c digo do Servi o NFS e n o est di
13. mlDocument Dim xmlDoc As New System Xml XmiDocument Dim Key As New System Security Cryptography RSACryptoServiceProvider Dim SignedDocument As System Security Cryptography Xml SignedXml Dim keyInfo As New System Security Cryptography Xml KeyInfo xmlDoc LoadXml mensagemXML Retira chave privada ligada ao certificado Key CType certificado PrivateKey System Security Cryptography RSACryptoServiceProvider Adiciona Certificado ao Key Info keyInfo AddClause New _ System Security Cryptography Xml KeyInfoX509Data certificado SignedDocument New System Security Cryptography Xml SignedXml xmlDoc Seta chaves SignedDocument Signingkey Key SignedDocument KeyInfo keyInfo Revisado em 27 11 2013 P gina 8 de 14 NOTA FISCAL DE SERVI O RECIFE ELETR NICA NFS e Manual de Utiliza o do Web Service Modelo Nacional Cria referencia Dim reference As New System Security Cryptography Xml Reference reference Uri String Empty Adiciona transformacao a referencia reference AddTransform New System Security Cryptography Xml XmlDsigEnvelopedSignatureTransform reference AddTransform New System Security Cryptography Xml XmlDsigCl4NTransform False Adiciona referencia ao xml SignedDocument AddReference reference Calcula Assinatura SignedDocument ComputeSignature Pega representa o da assinatura Dim xmlDigitalSignature As System Xml XmlElement SignedDocument GetXml Adiciona a
14. o doc XML xmlDoc DocumentElement AppendChild xmlDoc ImportNode xmlDigitalSignature True Return xmlDoc End Function 3 8 Exemplo de assinatura digital de elementos XML Alguns dos elementos no documento xml podem opcionalmente ser assinados individualmente Veja abaixo um exemplo de como assinar digitalmente esses elementos Imports System Xml Imports System Security Cryptography Imports System Security Cryptography Xml Imports System Security Cryptography x509Certificates lt summary gt Exemplo de como assinar elementos de um documento XML com um certificado digital Linguagem VB NET Framework 3 5 lt summary gt lt param name Document gt O documento que contem os elementos que devem ser assinados lt param gt param name ParentElementName gt 0 elemento que contem as tags a serem assinadas Ex Para assinar o rps em um lote o ParentElementName Rps Revisado em 27 11 2013 P gina 9 de 14 NOTA FISCAL DE SERVI O RECIFE ELETR NICA NFS e Manual de Utiliza o do Web Service Modelo Nacional Para assinar o pedido do lote de rps o ParentElementName EnviarLoteRpsEnvio lt param gt lt param name ElementName gt 0 elemento tag que ser assinado BIS Para assinar o rps em um lote o ElementName InfRps Para assinar o pedido do lote de rps o ElementName LoteRps lt param gt lt param name AttributeName O nome do atributo do elemento que ser assin
15. spon vel para emiss o que dever ser informado neste campo C digo do Servi o c digo enviado da Consulte a legisla o vigente para saber se o c digo do Servi o 908 NFS e n o permite dedu o na base de informado permite dedu o da base de c lculo c lculo C digo do Servi o c digo enviado da Consulte a legisla o vigente para saber se o c digo do Servi o 909 NFS e n o permite tributa o fora do informado permite a tributa o fora do munic pio munic pio C digo do Servi o c digo enviado n o Informe o c digo do Servi o relativo ao RPS informado Informado Reten es de Tributos Federais s Preencher os campos de reten es federais com zeros 916 podem ser efetuados por Tomadores pessoa jur dica CNPJ Campo Endere o n o preenchido O preenchimento do endere o logradouro obrigat rio para obrigat rio para tomador com CNPJ tomadores Pessoas Jur dicas com CNPJ Campo Cidade UF n o preenchido O preenchimento da Cidade e da UF do endere o do tomador obrigat rio para tomador com CNPJ obrigat rio para tomadores Pessoas Jur dicas com CNPJ Inscri o Municipal do Tomador de Preencher o campo com a inscri o correta ou preencher o 919 Servi os n o cadastrada na base de campo com zeros dados de Prefeitura O valor da al quota informada para o Altere o valor da al quota conforme especificado c digo do Servi o prestada lt c digo do Servi o gt deve ser ig
16. ual a lt valor da al quota do Servi o gt 903 906 910 917 918 Revisado em 27 11 2013 P gina 12 de 14 aM NOTA FISCAL DE SERVICO RECIFE ELETRONICA NFS e Manual de Utilizac o do Web Service Modelo Nacional MENSAGEM SOLU O O valor da al quota informada para o o Altere o valor da al quota conforme especificado c digo do Servi o prestada lt c digo do Servi o gt deve ser superior ou igual a valor da al quota m nima do Servi o gt ou inferior ou igual a lt valor da al quota m xima do Servi o gt Reten o de ISS n o permitida pois o Alterar o campo ISS Retido para 2 Nota Fiscal sem ISS tomador de servi os informado o Retido pr prio prestador Esta NFS e dever ter o ISS Retido pelo Selecione ISS Retido 1 SIM Tomador dos Servi os Esta NFS e n o dever ter o ISS Retido Selecione ISS Retido 2 NAO pelo Tomador dos Servi os O campo discrimina o dos servi os Diminua o tamanho do campo Discrimina o dos Servi os possui mais de 4 000 caracteres Erro informando o motivo da n o A NFS e n o poder ser substituida devido ao motivo permiss o de substitui o de uma NFS e especificado na mensagem C digo do Servi o da NFS e n o um Verifique se o c digo de servi o foi digitado corretamente servi o emitente de NFS e C digo do Servi o da NFS e n o permite Altere o c digo de servi o ou
Download Pdf Manuals
Related Search