Manual de Utilização do Web Service
Contents
1. NFSE Nota Fiscal de Servi os Eletr nica 4 5 Consulta Seqiiencial RPS M todo consultarSequencialRps Tipo Servi o S ncrono Funcionamento O m todo de consulta sequencial Rps retorna um XML com o n mero sequencial do ltimo RPS do prestador convertido em nota O sequencial utilizado para controle de numera o de RPS o servi o deve ser acessado sempre que necess rio obter o n mero do ltimo RPS processado N o necess rio acessar o servi o em cada convers o de lote Na tabela seguinte apresenta se a defini o dos campos do XML de consulta ao sequencial de RPS Exemplos encontram se no Anexo 06 deste manual A numera o sequencial dos RPS por Serie de Presta o ou seja cada serie tera seu controle sequencial Par metros passado para o m todo Requisi o da Fun o de Consulta Sequencial RPS CAMPO TIPO CONTE DO OBRIG CodCidade C digo da Cidade padr o SIAFI CPF ou CNPJ do remetente IMPrestador N 11 Inscri o Municipal do Prestador Verificar regra de preenchimento do campo no Anexo 03 SeriePrestacao N 2 N mero do equipamento emissor do RPS ou s rie de presta o Por padr o informe o valor 99 para modelo nico Caso esteja autorizado pela prefei tura pode se passar um valor de 01 a 99 para indi car o n mero do equipamento Informe a vers o do SChema XML Padr o 1 Retorno do m todo Exemplos de retorno no Anexo 06 deste maual 4 6 Cancelamento de2. o deve se informar o CPF CNPJ do Inter medi rio 1439 CPF CNPJ do Intermedi rio Inv lido Tipo de Recolhimento inv lido O Tipo de recolhimento deve ser A A Recolher para local de incidencia do imposto no mu nic pio e tomador n o sendo substituto tribut rio Tipo de Recolhimento inv lido O Tipo de recolhimento deve ser R Retido para local de incidencia do imposto no munic pio e tomador substituto tribut rio A atividade n o aceita itens de servi o n o tribut vel 1440 1441 1442 Verifique o correto preenchimento do Campo Opera o do RPS Nos itens de servi o do RPS o campo Tribut vel deve estar com o valor S Item tribut vel Pois a atividade n o aceita itens n o tribut veis Veri fique o anexo 08 para identificar quais atividades s o permitidas no munic pio NFSE Nota Fiscal de Servi os Eletr nica pode ultrapassar o limite m ximo de da nota permitido para esta atividade dedu o permitido para a cidade 1444 Tributacao invalida para contribuinte Para contribuintes enquadrados como MEI os ti enquadrado como Microempreendedor pos de tributacao possiveis sao C Isenta de ISS 1443 O valor total das dedu es do RPS n o Verifique o percentual m ximo sobre o valor total Individual MEI F Imune K Exigibilidade M Tributacao MEI N Nao Tributavel 1445 A operacao informada nao permite inter mediacao Quando informado um interme diario dev
3. N punsooos 0 WMO go eo coa00000 777774 A INTELIG NCIA TRIBUT RIA MUNICIPAL Pe 0 WEBSERVICES Vers o Schema XML 1 E 1 Introdu o 2 Interfaces Dispon veis 3 Arquitetura de Comunica o 4 Servi os e M todos 5 Anexos 1 Introdu o Nota Fiscal de Servi os Eletr nica NFS e o documento emitido e armazenado eletronicamente em siste ma pr prio da Prefeitura com o objetivo de registrar as opera es relativas presta o de servi os Para os contribuintes que emitem uma grande quantidade de notas foi criado o Regime Especial de en trega em lote no qual o contribuinte pode emitir Registros Provis rios de Servi os RPS atrav s de seus pr prios sistemas e estes em um determinado momento ser o convertidos em notas fiscais Para conver ter estes RPS em NFS e o sistema do contribuinte deve se conectar ao Web Service da prefeitura e enviar as informa es de RPS gerados no formato XML gerando um lote de entrega O Recibo Provis rio de Servi os RPS um documento que dever ser usado por emitentes da NFS e no eventual impedimento da emiss o on line da Nota Tamb m poder ser utilizado pelos prestadores sujeitos emiss o de grande quantidade de NFS e exemplo estacionamentos Nesse caso o prestador emitir o RPS para cada transa o e providenciar sua convers o em NFS e mediante o envio de lotes pro cessamento em lote No anexo 7 deste manual pode
4. fique a regra de preenchimento deste campo no est inv lido 1207 Prestador de Servi os n o autorizado a Verifique a situa o junto a prefeitura emitir NFS e Somente permitido o cancelamento de No lote de cancelamento de NFSe permitido NFS e emitidas por um nico Prestador de apenas notas do mesmo prestador Servi os mesma inscri o municipal 1304 Erro ao cancelar NFS e Erro interno a cancelar a NFSe contacte o suporte 1305 Assinatura de cancelamento da NFS e in correta 1306 A NFS e n o pode ser cancelada pois est vinculada a uma guia de pagamento Somente permitido consultar NFS E emi tidas por um nico Prestador de Servi os mesma inscri o municipal O CPF CNPJ da assinatura da mensagem XML n o tem acesso ao Tomador de Ser vi os informado As datas informadas compreendem um per odo maior que o permitido O per odo n o pode abranger mais que 31 dias 1404 A Inscri o Municipal do Prestador de Ser Verifique se o prestador esta credenciado correta vi os n o consta na base de dados mente 1405 Assinatura Digital Inv lida Verifique se o lote foi assinado corretamente e com um certificado digital v lido Verifique se n o existem caracteres especiais que est o inv li dando o XML assinado O padr o de codifica o utilizado o UTF 8 caracteres fora desse padr o podem invalidar o XML 1406 Munic pio do tomador n o encontrado Informe corretamente o
5. 1102 Mensagem XML de pedido do servi o sem Foi enviado um conte do vazio conte do O CPF CNPJ do Remetente n o possui per O CPF CNPJ do Remetente indicado no cabe alho miss o para o servi o solicitado do lote n o o respons vel legal do prestador e n o esta vinculado como sub usu rio autorizado pelo mesmo Verifique se esta credenciado no ambiente utilizado Se estiver utilizando o ambi ente de produ o deve estar credenciado para este ambiente ou se estiver utilizando o ambiente de homologa o deve estar credenciado para este ambiente O CPF CNPJ do remetende do lote deve ser o mesmo indicado como respons vel legal no momento do credenciamento ou caso seja outro deve estar vinculado como sub usu rio autorizado pelo prestador 1105 Lote n o encontrado Verifique se o n mero do lote esta correto 1106 NF e n o encontrada Verifique corretamente o n mero da Nota 1107 O CPF CNPJ da assinatura da mensagem XML n o corresponde ao CPF CNPJ do Prestador de Servi os 1108 O CPF CNPJ vinculado a inscri o do toma Verique a Inscri o Municipal correta do tomador dor n o corresponde ao CPF CNPJ informa ou seu CNPJ do no campo CPF CNPJ Tomador 1109 CPF CNPJ inv lido Verifique se o CPF CNPJ est o corretos 1201 Somente permitido o envio de RPS emiti No lote de envio n o s o permitidos RPS de dos por um nico Prestador de Servi os prestadores diferentes mesma inscri o muni
6. http www dsfnet com br nfse lote modelorps zip Grupo de Discuss o sobre NFSe Caso queira participar do grupo sobre NFSe abaixo segue link para acessar a p gina e participar Um local onde desenvolvedores de sistemas contribuintes e usu rios podem trocar informa es com ou tros que est o em processo ou j se integraram O grupo destina se apenas a discuss o sobre Nota Fiscal de Servi os Eletr nica e assuntos que envolvem P gina inicial do grupo http br groups yahoo com group nfse E mail do grupo nfseoyahoogrupos com br Para ingressar no grupo envie um email para nfse subscribeoyahoogrupos com br Anexo 8 LINK PARA DOWNLOADS Tabela de atividades que aceitam Itens de Servi o N o Tribut veis http www dsfnet com br nfse lote Anexo8 xIs ES NFSE Nota Fiscal de Servi os Eletr nica 32 NFSE Nota Fiscal de Servi os Eletr nica N ETA TUA eooooth t A INTELIG NCIA TRIBUT RIA MUNICIPAL 0 0 o 0000000 DSF Desenvolvimento de Sistemas Fiscais Alameda Santos 1787 8 e 9 Andar S o Paulo SP www dsfnet com br
7. o deve ser utilizada Quando informado o tipo de opera o J Intermedia odeve se informar o CPF CNPJ do Intermedi rio Caso o tomador for um consumidor n o identificado informar no campo CPFCNPJTomador o valor 77777777777 no campo RazaoSocialTomador informar Consumidor e nos campos TipoLogradouroTo mador LogradouroTomador TipoBairroTomador BairroTomador EmailTomador informar o valor quando n o possuir essa informa o No campo NumeroEnderecoTomador informar valor zero e no campo CEP Tomador informar 00000000 Caso o tomador for estrangeiro informar no campo CidadeTomador o valor 0009999 e no campo Cida deTomadorDescricao informar o nome do pa s de origem do tomador no campo CepTomador informar 99999999 no campo DocTomadorEstrangeiro informar o documento de identifica o do tomador estran geiro Nos campos TipoLogradouroTomador LogradouroTomador TipoBairroTomador BairroTomador deve se informar quando n o possuir essas informa es Caso o munic pio de presta o for no exterior informar no campo MunicipioPrestacao informar o valor 0009999 e no campo MunicipioPrestacaoDescricao informar o nome do pa s Quando a situa o do RPS for cancelada deve se informar o motivo do cancelamento no campo MotCan celamento No campo SeriePresta o deve ser informado por padr o o valor 99 Modelo nico por m quando libera do pela prefeitura o contribuinte pode utilizar este campo para indicar o n
8. o for subtituto n o preencher NumeroRPSSubstituido N 10 N mero do RPS a ser substitu do N Se n o for substituto n o preencher DataEmissaoNFSeSubstituida Data de emiss o da NFSe Formato AAAA MM DD Se N n o for substituto preencher com 01 01 1900 SeriePrestacao InscricaoMunicipalTomador CPFCNPJTomador DocTomadorEstrangeiro TipoLogradouroTomador N mero do equipamento emissor do RPS ou s rie de S presta o Caso n o utilize a s rie preencha o campo com o valor 99 que indica modelo nico Caso queira utilizar o campo s rie para indicar o n mero do equi pamento emissor do RPS deve se solicitar libera o da prefeitura Inscri o Municipal do Tomador Caso o tomador n o for do municipio n o preencher caso o tomador for do munic pio preencher com a Inscri o Municipal forma tada Seguindo Anexo 03 CPF ou CNPJ do Tomador Ex 00000000000191 Documento de Identifica o de Tomador Estrangeiro Caso o tomador n o for estrangeiro ou n o possuir o documento deixar o campo vazio Tipo de Logradouro do Tomador Campo de preenchimento livre Verificar exemplos no anexo 04 RazaoSocialTomador E Raz o Social do Tomador o LogradouroTomador Logradouro do Tomador oo NumeroEnderecoTomador A j Numero de Endere o do Tomador ComplementoEnderecoTomador Complemento do Endere o do Tomador NFSE Nota Fiscal de Servi os Eletr nica TipoBairroTomador EmailTomador Co
9. o resumidas interfaces dispon veis no WebService da NFS e bem como suas funcionalidades e Envio de Lote Nesta interface os prestadores de servi os atrav s de seus sistemas poder o enviar lotes de RPS para que sejam susbstitu dos por NFS e Este um servi o ass ncrono ou seja o prestador envia um lote de RPS e recebe o n mero de lote como protocolo de registro do lote o lote n o processado no mesmo instante de envio O sistema da prefeitura ira processar esse lote se o lote apresentar criticas de erros n o ser o geradas as NFSe se n o apresentar cr ticas cada RPS ir gerar uma NFSe O sistema do prestador devera consultar as informa es de processamento deste lote atrav s da interface de Consulta de Lote e Consulta de Lote Permite consulta as NFS e emititadas pelo prestador pelo n mero de lote informado Neste m todo o Web Service retorna diversas informa es entre elas o n mero do lote processado NFS e geradas neste lote ou poss veis erros de processamento Esta um servi o s ncrono ou seja assim que o sistema do presta o envia a solicita o para consultar um lote e o WebService retorna na mesma conex o a informa o deste lote se o lote foi processado retorna as informa es de processamento e se o lote ainda n o foi processado o servi o retorna lote n o processado ainda ent o o sistema do prestador deve aguardar um tempo at o processamento deste lote antes de consultar novamente e Consulta
10. os ser menores que a soma dos valores de itens de servi o 305 O Valor das dedu es dever ser superior A soma dos itens de dedu es do RPS deve ser ou igual a R 0 00 zero maior ou igual a zero C digo da Atividade do RPS inexistente O c digo da atividade informada no RPS n o foi encontrada ou n o esta vinculada ao contribuinte Verifique junto a prefeitura qual o c digo CNAE correto para sua atividade de presta o Verifique quais s o as atividades vinculadas ao prestador NFSE Nota Fiscal de Servi os Eletr nica C digo da Atividade do RPS n o permite Foram informados itens de dedu o no RPS dedu o na base de c lculo por m a atividade n o permite dedu o na base de c lculo 09 C digo da Atividade do RPS n o permite Foi informada uma al quota de ISS para uma tributa o fora do municipio atividade que n o permite tributa o fora do munic pio O C digo da Atividade n o permitida para o A atividade informada n o esta vinculado ao Prestador prestador Verfique o CNAE correto da atividade junto a prefeitura Al quota ISS informada no RPS difere do Verifique o valor correto da al quota de ISS para valor da al quota para a atividade informa esta atividade de presta o junto a prefeitura a 1 1 12 A data da emiss o do RPS n o foi preenchi Verifique a data de emiss o do RPS da corretamente 1 1 3 3 3 3 3 d 313 A data da emiss o do RPS n o
11. A mensagem XML de envio de lote deve ser assinada com certificado digital no ambiente de produ o Na tabela seguinte apresenta se a defini o dos campos do XML de remessa de Lote RPS exemplos de arquivos XML encontram se no link presente no Anexo 06 deste manual Estrutura definida no schema XML CAMPO CONTE DO RazaoSocialRemetente A 120 CodCidade CPFCNPJRemetente Transacao true Se os RPS fazem parte de uma mesma transa o Padr o true Data de in cio do per odo transmitido Data do primeiro RPS contido no lote Formato YYYY MM DD Dtinicio E o e Formato YYYY MM DD E Informe a vers o do SChema XML Padr o 1 Padr o WS ValorTotalDeducoes Vers o MetodoEnvio NFSE Nota Fiscal de Servi os Eletr nica Registros de RPS Assinatura 2000 C digo hash de valida o do conte do detalhado S mais a frente InscricaoMunicipalPrestador Inscri o Municipal do Prestador Verificar regra de preenchimento do campo no Anexo 03 RazaoSocialPrestador A fue Raz o Social do Prestador FR Tipo de RPS Padr o RPS Gs A qsedoresmonD E rr Cr DataEmissaoRPS Data e Hora de Emiss o Formato AAAA MM DDTHH MM SS SituacaoRPS Po SerieRPSSubstituido PE Situa o da RPS N Normal C Cancelada S rie do RPS a ser substitu do Padr o NF Se n o for substituto n o preencher NumeroNFSeSubstituida N 10 N mero da NFSe Substituida N Se n
12. Dedu o Por Valor Nas dedu o do RPS n o permitido dedu o por Valor A atividade informada n o permitite esse tipo de dedu o 1422 Atividade n o aceita Dedu o Por Percen Nas dedu o do RPS n o permitido dedu o por tual Percentual A atividade informada n o permitite esse tipo de dedu o 1423 Existem RPS j convertidos com numera A numera o do RPS deve ser maior que a nume o superior e data de emiss o inferior ao ra o do ltimo RPS convertido RPS enviado para convers o 1424 Existem RPS j convertidos com numera A data de emiss o do RPS deve ser maior que a o inferior e data de emiss o superior ao data do ltimo RPS convertido RPS enviado para convers o 1425 M todo de Envio Inv lido Adicione a tag MetodoEnvio com valor WS ao cabe alho do XML ap s o campo Versao ou atualize a vers o da sua DLL de convers o de RPS no site da prefeitura 1426 Vers o da DLL de convers o de RPS de satualizada Baixe o instalador da ltima vers o no site da prefeitura 1427 Vers o da DMS desatualizada 8 1428 Certificado Digital utilizado na assinatura Verfique se o Certificado Digital esta registrado do lote deve ser o mesmo do remetente para o remetente do lote do lote CPF CNPJ do Certificado diferente do remetente Certificado Inv lido Es NFSE Nota Fiscal de Servi os Eletr nica 26 Erro interno ao tentar gravar lote Entre em
13. RPS e depois essa linha de texto codificada utilizando o padr o SHA 1 big BONF 000000000006200907217T NN0000000001200000000000000400000863050400000351 EL 7 E 04 Data de Emiss o do RPS fomato mad O 00S CET a o7 Mpo Recolhimento setor A peene conos 1 Ap s gerar a linha de assinatura gerado um c digo hash utilizando o padr o SHA 1 e o c digo e passado no campo Assinatura Segue abaixo um exemplo de gera o da Assinatura do RPS 04 Data de Emiss o do RPS formato yyyymmaa Je aooo NFSE Nota Fiscal de Servi os Eletr nica 08 Valor do servi o subtraindo a dedu o 000000000001686 09 Valor da Dedu o 000000000000000 10 C digo da atividade 0829979900 11 CPF CNPJ do tomador 08764130000102 TEXTOO 00000317330NF 00000003866320090905T NN000000000001686000000000000000082997990008764130000102 SHA1 6bcbb93fd7e6d7f0417656f4931ba9f92a7ac1da TEXTOO2 00000720097NF 00000000000120091207T NN000000000009000000000000000000045200030001902994000102 CODIGO HASH a6dd79664dd34d6bec80c781aef3c2b291c56dac O valor do gerado no padr o SHA1 deve ser enviado no campo Assinatura do RPS Certificado Digital Os certificados digitais utilizados no sistema de Notas Fiscais de Servi o Eletr nicas ser o emitidos por Autoridade Certificadora Brasileira no padr o ICP Brasil pode ser do tipo A1 ou A3 devendo conter o CNP da entidade propriet ria do certificado O certificado digital ser exigid
14. de Notas Permite a consulta das NFS e emitidas pelo prestador Este um servi o s ncrono onde o sistema do pres tador envia uma solicita o de consulta de notas ao web service informando o per odo a ser consultado e o WebService retorna na mesma conex o as notas encontradas naquele per odo Cancelamento de Notas Permite o cancelamento das NFS e O servi o de cancelamento de notas um servi o s ncrono ou seja o sistema do prestador envia um solicita o de cancelamento contendo uma ou mais notas e na mesma conex o o WebService processa este cancelamento e retorna as informa es de cancelamento Consulta de NFS e ou RPS Permite recuperar as informa es de uma NFS e ou RPS convertido Este um servi o s ncrono ou seja o sistema do prestador envia uma solicita o de consulta passando a informa o de uma ou mais NFS e ou RPS a serem consultados e na mesma conex o o web service retorna todos os dados destas NFS e Envio Sincrono Esta interface de servi o possui a mesma estrutura do Envio lote ass ncrono os prestadores de servi os atrav s de seus sistemas poder o enviar lotes de RPS para que sejam susbstitu dos por NFS e O prestador envia um lote de RPS este lote ser processado e na mesma conex o retornado o numero de lote como protocolo de registro do lote bem como as informa es de processamento do lote Se o lote apresentar criticas de erros n o ser o geradas as NFSe se n o apresentar cr tic
15. municipio do tomador Verifique se o c digo SIAFI da cidade do tomador esta correto 1407 Munic pio de presta o n o encontrado Verifique o munic pio de presta o Verifique se o c digo SIAFI da cidade de presta o esta correto 1408 Munic pio do prestador n o encontrado Do 1409 C digo de cidade n o encontrado Verifique se o c digo SIAFI da cidade esta correto 1410 N o possivel substituir NFSe 1411 Dados da NFSe a ser substitu da est o incompletos Valor informado para o valor do PIS n o est v lido ou n o confere com a al quota informada Tipo de Dedu o n o encontrado ou inv Verifique nos itens de dedu o do RPS quais s o os tipos de dedu o validos No manual est o descritos os tipos v lidos 1415 Campo Dedu o Por dos registros de A atividade informada no RPS n o permitido o dedu o do RPS diferente do tipo de tipo de dedu o lan ada nos itens de dedu o dedu o permitida na atividade 1416 Valor informado para COFINS n o est v lido ou n o confere com a aliquota infor mada ou n o confere com a aliquota informada n o confere com a aliquota informada ou n o confere com a aliquota informada Campo Dedu o Por dos registros de Nos itens de dedu o do RPS verifique o campo dedu o do RPS com valor n o encontra Dedu o Por deve ser informado se a dedu o do ou inv lido for por Percentual ou por Valor 1421 Atividade n o aceita
16. poder ser N o podem ser emitidos RPS com data futura superior a data de hoje rigat rio para tomador com CNPJ preenchimento do endere o rigat rio para tomador com CNPJ mador para pessoa jur dica vi os consta como cancelada Apenas Notas com tributa o no municipio Verfique o correto preenchimento para o campo ou fora do municipio podem sofrer reten Al quota de ISS do RPS 322 O campo discrimina o dos servi os n o Nos itens de servi o do RPS devem ser preenchi foi preenchido dos a discrimina o dos mesmos 324 A tributa o do Rps n o confere com a trib uta o do Prestador Opera o de tributa o permitida apenas A Opera o G permitida apenas para servi os para servi o de constru o de contru o Verifique a Opera o correta de acordo com o servi o contido no RPS 326 Opera o de tributa o n o condiz com o c digo do regime de tributa o Tributa o do Prestador 327 Municipio do Prestador inv lido prestador 28 Municipio do Tomador inv lido Verifique o c digo SIAFI para o munic pio do to mador Nota Fiscal para ser substituida n o lo calizada Verifique o n mero e a data de emiss o 330 Nota Fiscal n o pode ser substituida pois j foi cancelada ou substituida anteriormente 314 A data da emiss o do RPS n o poder ser Verifique a data de emiss o do RPS inferior a 01 06 2006 331 Nota Fiscal para ser substituida encontra se em uma gui
17. 14 10 10 NFSE Nota Fiscal de Servi os Eletr nica Assincrono Tipo do Servi o S Assincrono N Sincrono Chave ChaveNFe CAMPO TIPO CONTE DO InscricaoPrestador Inscri o municipal do contribuinte NumeroNFe CodigoVerificacao N mero da NFS e RazaoSocialPrestador Raz o Social do Contribuinte prestador de servi os Chave ChaveRPS CAMPO CONTE DO NumeroRPS N mero da RPS DataEmissaoRPS PN Data e Hora de Emiss o da RPS Formato AAAA MM DDTHH MM SS RazaoSocialPrestador Raz o Social do Contribuinte Prestador de Servi os Caso o servi o apresente erro no processamento dos RPS enviados ser retornado uma mensagem XML com a Tag Erros com os erros de processamento No Anexo 06 deste manual encontra se um exemplo Caso o servi o apre sente erro no processamento dos RPS enviados ser retornado uma mensagem XML com a Tag Erros com os erros de processamento Segue abaixo um exemplo de retorno com erro no processamento No Anexo 06 deste manual encontra se um exemplo 4 2 Consulta de Lote M todo consultarLote Tipo Servi o Sincrono Funcionamento O sistema do prestador envia para o web service da prefeitura uma requisi o no formato XML de consulta de lote para o m todo consultarLote contendo o numero do lote a ser consultado Permite consulta as NFS e emitidas pelo prestador pelo n mero de lote informado Ap s o envio bem su cedido de um Lote de RPS o Web Service retorna diversas inf
18. GUA U http www issmaisfacil com br WsNFe2 LoteRps jws TERESINA http www issdigitalthe com br WsNFe2 LoteRps jws S O LU S http www issdigitalslz com br WsNFe2 LoteRps jws SOROCABA http issdigital sorocaba sp gov br WsNFe2 LoteRps jws Site do Ambiente de Produ o CAMPINAS http nfse ccampinas sp gov br BEL M http www issdigitalbel com br nfse CAMPO GRANDE http nfse pmcg ms gov br UBERL NDIA http udigital uberlandia mg gov br nfse TERESINA http www issdigitalthe com br nfse NOVA IGUA U http www issmaisfacil com br nfse S O LUIS http www issdigitalsiz com br nfse SOROCABA http issdigital sorocaba sp gov br nfse Anexo 03 Defini es para a formata o do campo Inscri o Municipail do Prestador de acordo com a cidade de declara o Campinas 09 Tfoooooomos O Campo Grande qm TJoooo2738007 _ _ Uberl ndia fos oza A Novalgua u foe oooi S O S o Luis mo 00061994000 O Sorocaba Too Jooos i O Obs Preencher sempre com zeros a esquerda para completar o tamanho do campo ANEXO 04 TIPOS DE LOGRADOURO E NFSE Nota Fiscal de Servi os Eletr nica 30 ANEXO 05 TIPOS DE BAIRROS Anexo 06 Arquivos XML de exemplo de utiliza o e XSD XML Schema Definition do Web Service http nww dsfnet com br nfse lote exemplosws zip NFSE Nota Fiscal de Servi os Eletr nica Anexo 07 Modelo de Recibo Provis rio de Servi os RPS
19. Notas Fiscais M todo Cancelar Tipo Servi o Sincrono Funcionamento Para cancelar um Nota Fiscal deve ser um enviado uma requisi o de cancelamento para o m todo Cancelar do web service esse m todo recebe um lote contend as notas fiscais a serem cancel adas As notas que n o foram emitidas Guias de Recolhimento ser o canceladas Exemplos deste m todo encontram se no anexo 06 deste manual A requisi o de cancelamento de notas deve ser assinada com certificado digital no ambiente de produ o A tag lt Lote Id lote 1ABCDZ gt que deve ser referenciada na URI da assinatura Exemplo lt Reference URI glote 1ABCDZ gt Estrutura definida no Schema XML CAMPO TIPO CONTE DO OBRIG CodCidade C digo da cidade da declara o padr o SIAFI CPF CNP do remetente autorizado a transmitir E mo fume Em Registro de Notas Es NFSE Nota Fiscal de Servi os Eletr nica InscricaoMunicipalPrestador N 11 Inscri o Municipal do Prestador formatado seguindo S anexo 03 deste manual CodigoVerificacao 255 C digo de verifica o da nota e 5 Retorno do M todo A tabela a seguir cont m definici es do XML de retorno Exemplos de retorno deste m todo encon tram se no anexo 03 deste manual Estrutura definida no Schema XML E Registro de Notas InscricaoMunicipalPrestador N 11 Inscri o Municipal do Prestador formatado seguindo S anexo 03 deste manual Cod
20. SS SituacaoRPS A 1 Situa o do RPS N Normal C Cancelada NFSE Nota Fiscal de Servi os Eletr nica UI z gt DataEmissaoNFSeSubsttuida D Data de Emiss o da NrSe Substtuida Formato WMM Serierestacao N 2 N mero do equipamento emissor do RPS ou s rie de presta o InsericaoMunicipalTomador a 11 Inscri o Municipaldo Tomador ercweromador a a crroucnidotomadr TT RersoSociafomador a 120 _ Raz o Social doTomaaor ocTomadorstangeiro a 20 Documento de identifica o de Tomador Estrangera MTipologradourotomador a 10 Tipo ao Logradouro doTomador Logradourotomador a 50 logedowodotomaar NumeroEnderecoromador JA 9 N mero de Endere o do Tomador possmoromador fa fro mpodemnotmado Eeincfomador a so bawodotoma Cidsderomado n fro c igo da cidade do Tomadorpaaso sa CidaderomadorDescieo a 50 Cadeo O O O OOOO omad Ja e femore TT Emaom Ja 60 emandotome O O O OOOO Cocigommdndo a fo c dgodanmdndo E Cr TipoRecolhimento Tipo de Recolhimento A A recolher R Retido na fonte MunicipioPrestacao N 10 C digo do Munic pio de Presta o Padr o SIAFI MunicipioPrestacaoDescricao Munic pio de Presta o Operacao A 1 Opera o A Sem Dedu o B Com Dedu o Materiais C Imune Isenta de ISSQN D Devolu o Simples Remessa J Intermedia o Tributacao Tributa o C Isenta de ISS E N o Inc
21. Se n o existem caracteres especiais nos dados que n o est o no padr o UTF 8 e est o invalidando o XML 1051 Rejei o Certificado Assinatura Data Vali Verifique se o certificado digital utilizado na as dade sinatura do lote esta v lido 1052 Rejei o Assinatura Digital sem CNPJ Rejei o Assinatura Digital Erro na Cadeia de Certifica o Rejei o Assinatura Digital difere do pa dr o ICP Brasil 1054 Verifique se o certificado digital utilizado na as sinatura do lote esta v lido Verifique se o certificado digital utilizado na as sinatura do lote esta v lido Verifique se o certificado digital utilizado na as sinatura do lote esta v lido NFSE Nota Fiscal de Servi os Eletr nica 1056 Rejei o Assinatura Digest difere do cal Verifique se o certificado digital utilizado na as culado sinatura do lote esta v lido 1057 Rejei o Assinatura difere do calculado Verifique se o certificado digital utilizado na as sinatura do lote esta v lido 1100 O campo discrimina o dos servi os n o Nos itens de servi o do RPS deve se preencher a foi preenchido discrimina o do servi o Tamanho da mensagem XML ultrapassou o Reduza o n mero de RPS enviados no lote de limite m ximo permitido de 500 kbytes forma a n o ultrapassar o limite Recomendamos que cada lote tenha no m ximo 100 RPS para n o ultrapassar o limite de 500Kb e n o demandar muito tempo para processamento
22. XML s o id nticos as mesmas rotinas do item 4 1 Envio de Lote de RPS Estrutura da mensagem XML de retorno Registro de Cabe alho CAMPO TIPO CONTE DO CodCidade Codigo da Cidade Padr o SIAFI Sucesso A 5 true Consulta realizada com sucesso false Erro na consulta NumeroLote N mero do Lote CPFCNPJRemetente CPF ou CNPJ do Remetente RazaoSocialRemetente Raz o Social Remetente n Formato AAAA MM DDTHH MM SS araNoiasProcessadas n is Quantidade de Notas Processadasno Lore Registro de NFSe SerierPS JA ha O Serie da RPS Padr o NF Nota Fiscal de Servi os DataEmissaoRPS Data de Emiss o do RPS Formato AAAA MM DDTHH MM SS RazaoSocialPrestador Raz o Social do Contribuinte TipoRecolhimento A 1 Tipo de Recolhimento A A Receber R Retido na Fonte ValorDeduzir Valor a Deduzir ValorToa NFSE Nota Fiscal de Servi os Eletr nica 4 4 Consulta de Notas M todo ConsultarNota Tipo Servi o Sincrono Funcionamento O sistema do prestador envia para o web service da prefeitura uma requisi o no formato XML de para o m todo ConsultaNota contendo o per odo que deseja consultar e na mesma conex o o web service ir retornar todas as informa es das NFSe geradas no per odo Na tabela seguinte apresenta se a defini o dos campos do XML de consulta de notas Atrav s deste m todo ser o retornadas as notas geradas a partir de RPS convertidos entre a datas i
23. a Emitida ou Paga a NFSE Nota Fiscal de Servi os Eletr nica 22 332 Nota Fiscal n o pode ser substituida pois os tomadores s o diferentes Cidade do Exterior n o informada N mero do Rps n o est presente no con trole de AIDF N mero do RPS deve ser subsequ nte ao anterior enviado Imune ou Natureza de Opera o com al quota zero Al quota inv lida para contribuinte en quadrado como Microempreendedor Individual MEI Al quota inv lida para contribuinte en quadrado como Simples Nacional Estima fique se o certificado digital utilizado na as sinatura est v lido Quando o tomador for do exterior deve ser in formar o codigo da cidade do tomador como 0009999 e na descri o da cidade deve se infor mar o pais de origem Solicite junto a prefeitura uma Autoriza o de Im press o de Documento Fiscal AIDF para emiss o de RPS o n mero do RPS deve estar entre a nume ra o inicial e final desde controle O n mero do primeiro RPS do lote deve ser sub sequente n mero do ltimo RPS convertido em nota Os n meros dos demais RPS do lote devem estar subsequentes a este A situa o do RPS esta marcada como CANCEL ADA por m n o foi informado o motivo do cancel amento Verifique o correto preenchimento para o campo al quota de ISS Verifique o correto preenchimento para o campo al quota de ISS se o certificado digital utilizado na assinatura esta v lido
24. alho do lote ltimo RPS do lote 209 O c digo do servi o prestado n o permite Verifique a tributa o para a atividade informada reten o de ISS no RPS RPS em duplicidade na mensagem XML en N o s o permitidos RPS com numera o duplica do no lote A numera o de RPS deve ser seguen cial em ordem ascendente e sem duplicidade 218 RPS j processado O RPS n o poder ser O RPS enviado no lote j foi convertido em nota enviado novamente em outro lote enviado anteriormente O campo Inscri o Municipal do tomador Deve se passar um valor vazio para o campo In somente dever ser preenchido para toma scri o Municipal do Tomador quando o tomador dores estabelecidos no municipio n o for do munic pio CPF CNPJ do Tomador possui mais de uma O tomador do munic pio e possui mais de uma inscri o municipal sendo obrigat rio o inscri o municipal deve se informar a inscri o preenchimento do campo Inscri o Munic municipal do tomador ipal do Tomador 301 O tomador de servi os informado o O prestador e o tomador do servi o n o pode ser pr prio prestador os mesmos Verifique esta informa o no RPS tos verificadores n o conferem 303 O Valor dos servi os dever ser superior a A soma dos valores dos itens de servi o do RPS R 0 00 zero devem ser maiores que zero O Valor das dedu es dever ser inferior ao A soma do valor das dedu es do RPS devem valor dos servi
25. as cada RPS ir gerar uma NFS e O sistema do prestador tamb m poder consultar as informa es de processamento deste lote atrav s da interface de Consulta de Lote NFSE Nota Fiscal de Servi os Eletr nica 3 Arquitetura de Comunica o 3 1 Servi os A mensagem XML ser recebida pelo Web Service LoteRps para valida o de seu respectivo Schema XML arquivo XSD Ao realizar o processamento o servi o ir retornar uma mensagem XML com os dados de re torno de processamento Caso ocorram erros de valida o do Schema XML ser retornada na mensagem XML na Tag lt Erros gt contendo o erro de processamento conforme tabela Erros de Retorno apresentada no Anexo 01 deste manual Processamento Sincrono O resultado do processamento e retornado na mesma conex o ou seja no momento de chamada da fun o Enviar realizado o processamento do lote e as notas geradas ou erros s o retornados Processamento Assincrono O lote gravado numa fila de espera para processamento para obter o resultado do processamento necess rio uma segunda conex o ao web service fazendo chamada a consulta de lote Etapas do processo ideal 1 O sistema do contribuinte inicia a conex o enviando uma mensagem XML de pedido do servi o para o Web Service 2 O Web Service recebe a mensagem XML de pedido do servi o e encaminha ao sistema da NFS e 3 O sistema da NFS e recebe a mensagem XML de pedido do servi o e realiza o processamento devo
26. cipal Prestador de Servi os n o encontrado no A inscri o municipal do prestador n o foi encon Cadastro Municipal CCM trada no cadastro da prefeitura Verifique se foi re alizado o credenciamento no ambiente utilizado Se esta utilizando o ambiente de homologa o deve se realizar o credenciamento neste ambiente que segue o mesmo processo de credenciamento do ambiente de produ o Caso esteja utilizando o ambiente de produ o o contribuinte deve estar credenciado no ambiente de produ o Caso ja tenha feito o credenciamento verifique se a in scri o municipal do prestador esta sendo infor mada corretamente no RPS ES NFSE Nota Fiscal de Servi os Eletr nica 24 fere com o enviado total de RPS enviados no lote 1204 Valor Total de Servi os indicado no cabe Verifique o valor dos servi os do RPS deve ser alho do lote n o confere com o soma dos igual ao valor indicado no cabe alho do lote valores de servi os do RPS 1205 Valor Total de Dedu o n o confere com o O valor total das dedu es no cabe alho do lote 1203 Total de RPS do cabe alho do Lote n o con Verifique o total de RPS do cabe alho do lote enviado somat rio do valor das dedu es esta diferente da soma das dedu es dos RPS presentes no lote contidos no lote 1206 Assinatura do RPS incorreta C digo Hash O campo Assinatura do RPS n o esta correto veri gerado para o campo assinatura do RPS
27. contato com suporte atrav z do site da 1429 NFSe 1430 Contribuinte n o credenciado Fa a o cre denciamento no site da NFSe 1431 Al quota inv lida para contribuintes en quadrados no regime de tributa o com al quota zero A al quota de ISS n o pode ser diferente de zero Caso esteja utilizando o ambiente de produ o deve se acessar o site da NFSe e realizar o pro cesso de credenciamento Caso esteja utilizando o ambiente de homologa o deve se acessar o site de homologa o e realizar o mesmo processo de credenciamento para produ o 1432 Valor do servi o difere do valor unit rio Verifique se n o existe algum erro de arrendonda multiplicado pela quantidade informada mento que esta provocando esse erro Contribuinte n o credenciado para o m todo de integra o com a NFSe utilizado O contribuinte de estar credenciado para emitir nota pelo regime especial O contribuinte esta credenciado por m habilitado para emitir nota ap enas pelo site da NFSe Verifique com a prefeitura solicitando a libera o para emiss por lote 1434 Razao Social do Tomador n o informado Po 435 Opera o n o permitida Atividade com dedu o tipo Intermedia o deve se informar o valor da dedu o igual ao valor da nota de dedu o Atividade com dedu o tipo Intermedia o Deve se informar as dedu es por intermedia o nos itens de dedu o do RPS Para o tipo de Opera o Intermedia
28. digoAtividade AliquotaAtividade TipoRecolhimento MunicipioPrestacao MunicipioPrestacaoDescricao MotCancelamento A A 1 Tipo de Bairro do Tomador Campo de preenchimen S to livre Verificar exemplos no Anexo 05 CEP do Tomador Ex 37900000 Email do Tomador Caso o Tomador n o possua email informar o valor Caso queira informar mais de um email colocar separando os emails e no final Exemplo nomeobol com br outroobol com br C digo da Atividade da RPS Al quota de ISS da Atividade 1 Tipo de Recolhimento A A Receber R Retido na Fonte C digo do Munic pio de Presta o Padr o SIAFI Munic pio de Presta o do Servi o Opera o A Sem Dedu o B Com Dedu o Materiais C Imune Isenta de ISSQN D Devolu o Simples Remessa J Intemedia o Tributa o C Isenta de ISS E N o Incid ncia no Munic pio F Imune K Exigibilidd Susp Dec J Proc A N N o Tribut vel 1 1 T Tribut vel G Tribut vel Fixo H Tribut vel S N M Micro Empreendedor Individual MEI 5 ikoredorresador TT 8 Telefone do Tomador a Motivo do Cancelamento r r r r r Obs Obrigat rio caso o RPS for cancelado NFSE Nota Fiscal de Servi os Eletr nica CpfCnpjlntermediario CPF CNPJ Intemedi rio A opera o J Intermedia o utilizada apenas para as prefeituras de Campo Grande e Sorocaba nas demais prefeituras n
29. e se informar no campo opera cao o tipo J Intermediacao 1446 Valor do item do RPS n o valido O valor unitario e quantidade do Item do RPS de vem ter um valor maior que zero 1447 A al quota deve estar entre 1 e 6 Verifique a al quota de ISS correta para este CNAE de atividade 1448 Tributa o inv lida para contribuinte en Para contribuintes enquadrados como Simples quadrado como Simples Nacional Nacional no campo Tributa o deve ser informado H Tribut vel S N 1449 Al quota de ISS n o cadastrada na tela de Informar a al quota de ISS na tela de configura o configura o de prestador do site da NFS de prestador no site da NFS e para a empresa do e para a empresa do Simples Nacional Simples Nacional e obrigat rio cadastrar a al quo ta de ISS no site 1450 A al quota informada no RPS diverge da Realize a corre o da diverg ncia entre a al quota al quota cadastrada no site da NFS e na cadastrada no site da NFS e e a al quota informada tela de configura o do prestador no RPS Ou altere a al quota cadastrada no site da NFS e para a al quota informada no RPS ou no RPS informe a mesma al quota cadastrada no site Modelo Unico em contato com a prefeitura e solicite autoriza o A libera o de utiliza o do campo SeriePrestacao para informar o n mero do equipamento emissor do RPS esta condicionado a autoriza o da prefei tura 1452 Vers o do XML de envio invalida Verifique se o val
30. id ncia no Munic pio F Inune K Exigibilidd Susp Dec J Proc A N N o Tribut vel T Tribut vel G Tribut vel Fixo H Tribut vel S N M Micro Empreendedor Individual MEI NFSE Nota Fiscal de Servi os Eletr nica gt Z gt gt gt gt j z gt DescricaoRPS 1500 Descri o Dados Complementares DDDPrestador DDD do telefone do Prestador TelefonePrestador A fje Telefone do Prestador eiefoneTomador JA e reciomedofomadr MotCanceiameno a eo mctvodocanceimeno OOOO i Registro de itens da Nota Discrmminacsosenico a eo Discrimina o dosen Registro de Dedu es da Nota CAMPO TIPO CONTE DO DeducaoPor A 20 Percentual Valor TipoDeducao A 255 Caso a dedu o for por Valor os valores poss veis s o Despesas com Materiais ou Despesas com Sub empreitada Caso a dedu o for por Percentual informar este campo com valor vazio 4 8 Envio de Lote Sincrono M todo enviarSincrono Tipo Servi o S ncrono Funcionamento O prestador atrav s do seu sistema ir gerar os RPS da mesma forma que gerado no servi o ass ncrono de envio de Lote em seguida deve estabelecer uma conex o com o web service da prefeitura e enviar o lote para o servi o EnviarSincrono do WebService Como este um servi o s ncrono o lote ser processado no mesmo momento ou na mesma conex o O WebService ir receber este lote processar e em seguida ir retornar o n mero de
31. igoVerificacao 255 C digo de verifica o da nota 4 7 Consulta NFSe ou RPS M todo ConsultarNFSeRps Tipo Servi o Sincrono Funcionamento A Consulta de NFSe ou RPS retorna as mesma informa es que a Consulta de Notas por m os par metros da requisi o s o diferentes Na Consulta de NFSe ou RPS deve ser enviando um XML de requisi o pas sando o numero de uma ou mais NFSe ou o n mero de um ou mais RPS a serem consultados Para consultar uma Nota Fiscal ou um RPS deve ser um enviado ao WebService uma requisi o de consulta para o m todo ConsultarNFSeRps do Webservice contendo as Notas Fiscais ou RPS a serem consultados Exemplos deste m todo encontram se no anexo 08 deste manual A requisi o de consulta de NFS e ou RPS deve ser assinada com certificado digital no ambiente de produ o Par metros passado para o m todo CAMPO TIPO CONTE DO OBRIG oaa n fio codigo aa idade Paarasan O fs CPFCNPJRemetente CPF CNPJ do remetente ou respons vel legal FR Registro de Notas InscricaoMunicipalPrestador N 11 Inscri o Municipal do Prestador formatado seguindo S anexo 03 deste manual NFSE Nota Fiscal de Servi os Eletr nica CodigoVerificacao C digo de verifica o da nota Registro de RPS S InscricaoMunicipalPrestador N 11 Inscri o Municipal do Prestador formatado se guindo anexo 03 deste manual NumeroRPS N mero do RPS a ser consultado S SeriePrestacao N 2 N mero do equipamen
32. iquotaAtividade TipoRecolhimento 30 lm In mi s SIN o as NJN N O N Q a MunicipioPrestacao MunicipioPrestacaoDescricao Operacao eo NFSE Nota Fiscal de Servi os Eletr nica Tributacao Tributa o C Isenta de ISS E N o Incid ncia no Munic pio F Inune K Exigibilidd Susp Dec J Proc A N N o Tribut vel T Tribut vel G Tribut vel Fixo H Tribut vel S N M Micro Empreendedor Individual MEI Was CO eos Waiorcorns n s2 varcs OOOO S Waos a se vans or QN a orcs JN se fue ZiZiZ iZ Z Zz moes JN ea Aiquaats AiquoaCOFNS n sa Aiquotacomns OOOO iguan fn ea woan TT migo fn ea faio O migues fn ea wios TT Descrcaohes fa 1500 Descricao Dados Complementares Dobrrestador a s oobdoteicionedoPrestador OOOO Taefoneprestador a e reeiomedoPestador OOOO Dbbfomador fa s obbdofomad OoOO Telefonema a e reetonedotoma OOO OOOO y O perconcemmento fa feo vooder ooo Registro de itens da Nota Discriminacaoservio a eo Diserimina o dosen Registro de Dedu es da Nota CAMPO TIPO CONTE DO DeducaoPor A 20 Percentual Valor TipoDeducao A 255 Caso a dedu o for por Valor os valores poss veis s o Despesas com Materiais ou Despesas com Sub empreitada Caso a dedu o for por Percentual informar este campo com valor vazio D r l gt r gt gt r gt Z Z Zz z TE
33. lote e as informa es de NFS e geradas ou cr ticas e erros ocorridos no lote O prestador tamb m poder consultar a situa o de processamento destes lotes no WebService da pre feitura atrav s do m todo ConsultarLote passando o numero de lote como par metro A estrutura do XML de lote igual para o m todo Enviar quando para o m todo EnviarSincrono e em ambos os m todos obrigat rio a assinatura digital do XML de envio com certificado digital do prestador NFSE Nota Fiscal de Servi os Eletr nica 5 Anexos Anexo 01 Erros de Retorno Abaixo seguem as mensagens de erro de processamento que podem ser retornadas pelo servi o enviadas n o pode ser inferior a 01 06 2006 a 01 06 2006 viadas n o pode ser inferior a 01 06 2006 rior 01 06 2006 A Data Final de emiss o das Notas Fiscais A Data Final no cabe alho deve ser igual a data do enviadas n o pode ser Superior a Data At ltimo RPS contido no lote e esta data n o pode ual ser superior a data atual 108 A Data Final de emiss o das Notas Fiscais Verifique a Data Final no cabe alho do lote enviadas devera ser superior a Data Inicial Data de Emiss o do RPS n o est com A data inicial do cabe alho do lote deve ser igual preendia entre data in cio da emiss o do a data do primeiro RPS contido no lote e a data lote e data fim da emiss o do lote conforme final do cabe alho do lote deve ser igual a data do especificado no cabec
34. lvendo uma mensagem XML de retorno ao Web Service 4 O Web Service recebe a mensagem XML de retorno e a encaminha ao sistema do contribuinte 5 O sistema do contribuinte recebe a mensagem XML de retorno e encerra a conex o 3 2 Regras de preenchimento dos campos Campos que representam CPF e CNPJ respectivamente 11 e 14 caracteres devem ser informados com o tamanho fixo previsto sem formata o e com o preenchimento dos zeros n o significativos Campos num ricos que representam valores e quantidades s o de tamanho vari vel respeitando o tamanho m ximo previsto para o campo e a quantidade de casas decimais quando houver O preenchimento de zeros n o significativos causa erro de valida o do Schema XML Os campos num ricos devem ser informados sem o separador de milhar com uso do ponto decimal para indicar a parte fracion ria quando houver respeitando se a quantidade de d gitos prevista no layout As datas devem ser informadas no formato AAAA MM DD Para reduzir o tamanho final das mensagens XML alguns cuidados de programa o dever o ser assumidos N o incluir espa os no in cio e ou no final de campos alfanum ricos N o incluir coment rios na mensagem XML N o incluir anota o e documenta o na mensagem XML TAG annotation e TAG documentation N o incluir caracteres de formata o na mensagem XML LF Line Feed ou salto de linha caractere ASCII 10 CR Carriage Return ou retorno do carro ca
35. mero do equipamento emissor do RPS podendo ser utilizado a numera o de 01 a 99 A numera o sequencial do RPS por S rie de Presta o sendo assim cada s rie t m uma numera o sequencial Registros de Itens da RPS CAMPO TIPO CONTE DO OBRIG DiscriminacaoServico Discrimina o do Servi o Quantidade Quantidade do servi o tomado ValorTotal Tributavel A 1 Tribut vel S Item tribut vel N N o tribut vel Verifique o anexo 08 para identificar quais ativi dades s o permitidas no munic pio Obs S o pemitidos no m ximo 25 itens por RPS Registro de Dedu o TIPO CONTE DO DeducaoPor A 20 Percentual S Valor NFSE Nota Fiscal de Servi os Eletr nica CPFCNPJReferencia ValorTotalReferencia 15 2 TipoDeducao A 255 Caso a dedu o for por Valor os valores poss veis S s o Despesas com Materiais ou Despesas com Sub empreitada Caso a dedu o for por Percentual informar o campo com valor vazio 52 Obs Cada RPS pode ter no m ximo 200 registros de dedu o Os campos CPFCNPJReferencia NumeroNFReferencia e ValorTotalReferencia devem ser preenchidos quando a atividade permite dedu o por material e houver dedu o pela compra de mat rias quando n o for este caso n o preencher estes campos Assinatura Campo utilizado para verifica o do conte do da mensagem recebida formado pela conca tena o dos principais campos do
36. nicial e final informadas como par metro O Web service pode retornar apenas uma quantidade limitada de no m ximo 100 notas por requisi o Com isso necess rio realizar mais de uma consulta para obter todas as notas Por exemplo se o web service retorna no m ximo 100 notas e no per odo a ser consultado existem mais de 100 notas na primeira consulta deve se passar a nota inicial como sendo a de n mero O zero assim o web service ir retornar as notas do per odo onde o n mero da nota for maior ou igual a O zero sendo retornado at 100 notas no m ximo ent o pega se o n mero da ltima nota retornada acrescentando mais 1 um e deve se realizar novamente a consulta o web service ir retornar as pr ximas 100 notas a partir desta A consulta deve ser repetida at que n o retorne mais nenhuma nota Indican do que j foram retornados todos as notas do per odo segue exemplo no Anexo 06 deste manual A requisi o de consulta de notas deve ser assinada com certificado digital no ambiente de produ o Par metros passado para o m todo EL Inscri o Municipal do Prestador Data de in cio do per odo transmitido Data da primeira RPS contida InscricaoMunicipalPrestador dtinicio no lote Formato YYYY MM DD n dtFim Data Final do per odo transmitido Data da ltima RPS contida no S lote Formato YYYY MM DD Notalnicial N 10 Informe o n mero da primeira nota ser o retornados as notas onde s o numero seja mai
37. o para assinar o XML dos m todos de envio de lote consulta de notas consulta de NFS e ou RPS e cancelamento de Notas O certificado digital utilizado para essa fun o dever conter o CNPJ do estabelecimento emissor da NFS e ou CPF do respons vel legal O campo de assinatura digital Signature deve vir logo ap s a tag de Lote contendo o certificado digital do remetente da mensagem o CNPJ CPF do emissor do certificado deve ser o mesmo do remetente da mensagem As assinaturas digitais das mensagens ser o verificadas considerando a lista de cadeia confi vel de certificados da NFSe No ambiente de produ o obrigat rio a assinar o XML com um certificado v lido Apresentamos um exemplo de Envio com assinatura digital no Anexo 06 deste manual Retorno do Servi o e Caso a mensagem XML enviada tenha sido processada com sucesso no cabe alho do retorno a Tag lt Su cesso gt estar com valor true em seguida estar as demais informa es do lote processado Na tabela a seguir temos a defini o dos tipos de dados do XML de retorno com exemplo Anexo 6 deste manual Caso a TAG lt Assincrono gt conter o valor S siginifica que o processamento do lote ser ass ncrono ent o deve se se chamar o m todo ConsultarLote para obter o resultado Cabe alho do Retorno do Servi o Codcidade N Sucesso true se processado com sucerro false se ocorreram erros E E IC Formato AAAA MM DDTHH MM SS 5 12
38. or do campo Vers o no cabe alho 1451 Contribuinte n o autorizado a emitir RPS Altere a serie de presta o do RPS para 99 Modelo com serie de prestacao diferente de 99 nico ou caso queira utilizar outras series entre do XML de envio esta valido Verifique a ultima vers o no manual no site da NFS e 1453 Tributa o Inv lida Quando a incid ncia No campo Tributa o informe o valor E N o Inci for fora do munic pio deve ser informado dente no Munic pio no campo Tributa o o valor E N o Inci dente no Munic pio 1454 Tributa o Inv lida Verifique o valor correto que deve ser informado no campo Tributa o de acordo com sue CNAE de atividade e enquadramento da tributa o da presta o de servi os Intermedi rio n o encontrado no Cadastro Verifique se o CPF CNPJ do intermedi rio esta Municipal CCM v lido O intermedi rio deve ser uma empresa do munic pio ES NFSE Nota Fiscal de Servi os Eletr nica 28 1456 Dedu o Inv lida Para tributa o E N o Nos itens de Dedu o do RPS informe uma Incidente no Munic pio deve ser infor dedu o por percentual com valor entre 0 e mado dedu o por Percentual com valor 99 99 entre O e 99 99 Tipo de recolhimento inv lido Para contri Informe A Receber no campo Tipo de Recolhi buinte enquadrado com Micro Empreend mento edor Individual MEI o tipo de recolhimen to deve ser A Recolher 1458 N o
39. or ou igual ao valor informado neste campo Versao Informe a vers o do SChema XML Padr o 1 Retorno do m todo Na tabela seguinte apresenta se a defini o dos campos do XML de retorno da fun o de consulta de no tas Exemplos presentes no Anexo 06 deste manual Estrutura definida no schema XML Registro Cabe alho CAMPO IPO TAM CONTE DO CodCidade C digo da Cidade Padr o SIAFI CPFCNPJRemetente CPF ou CNP do remetente autorizado a transmitir o RPS InscricaoMunicipalPrestador Inscri o Municipal do Prestador Dtinicio Data de in cio do per odo transmitido Data do primeiro RPS contido no lote Formato YYYY MMYY DtFim Data Final do per odo transmitido Data do ltimo RPS contido no lote Formato YYYY MM YY Vers o Informe a vers o do SChema XML Padr o 1 NFSE Nota Fiscal de Servi os Eletr nica Registro de Notas CAMPO TIPO CONTE DO NumeroNota N mero da Nota Fiscal DataProcessamento Data do Processamento Formato AAAA MM DDTHH MM SS NumeroLote N mero do Lote 255 CodigoVerificacao C digo de Verifica o Indentificador da NFSe Assinatura do RPS Inscri o Municipal do Prestador Assinatura InscricaoMunicipalPrestador Razao Social do Prestador Tipo de RPS Padr o RPS S rie do RPS Padr o NF N mero do RPS Data de Emiss o do RPS Formato AAAA MM DDTHH MM SS Situa o do RPS N Normal C Cancelada N mero do RPS S
40. orma es entre elas o n mero do lote NFS e geradas neste lote Caso o lote contenha informa es incorretas ser o geradas cr ticas de processamento essas cr ticas ser o retorndas como erros e o lote ser recusado Caso n o contenha erros este m todo ir retornar as notas geradas Par metros passados para o m todo Registro de Cabe alho CAMPO TIPO CONTE DO CodCidade Codigo da Cidade Padr o SIAFI CPFCNPJRemetente CPF ou CNPJ do Contribuinte Versao Vers o do Layout do Schema XML Padr o 1 NumeroLote NO N mero do Lote a ser consultado NFSE Nota Fiscal de Servi os Eletr nica Ap s o envio da mensagem XML que faz chamada ao m todo ReqConsultaLote o WebService ir retornar os dados de processamento do Lote e as NFSe s do m todo conforme defini es abaixo exemplos de retorno no Anexo 06 4 3 Teste de Envio de Lote de RPS M todo TesteEnviar Este m todo respons vel por atender aos pedidos de Teste de Envio de Lote de RPS para substitui o por NFSe importante considerar que o sistema n o grava o lote enviado e por esse motivo n o gerado o n mero do lote Este m todo dever ser usado apenas na fase de adapta o dos sistemas dos contribuintes Nos casos dos sistemas j adaptados seu uso resulta em duplicidade de esfor os desnecess rios pois as verifica es fei tas no M todo TesteEnviar s o as mesmas realizadas pelo m todo Enviar Tanto o envio quanto o retorno do
41. permitida a gera o de NFS e so Nos itens de servi o do RPS voc deve informar mente com itens de servi o n o tribut vel pelo menos um item tribut vel ALERTAS RETORNADOS CAMPO a MEaR gt Lote n o Lote n o processado ainda 00 ainda 211 A inscri o municipal do tomador n o foi encontrada na base de dados de CMM Cidade UF informada n o foi encontrada na base de dados RPS j foi convertido individualmente em NF E atrav s do site e n o ser processado novamente RPS reenviado A NFS E referente ao RPS foi cancelada e uma nova NFS e foi emitida O CNPJ informado possui inscri o municipal dentro do munic pio porem foi informado endere o fora do munic pio 1301 NFSe j cancelada 1302 NFSe em duplicidade na mensagem XML enviada 1304 NFSe n o localizada na base de dados para cancelamento 1405 N o existe nenhuma inscri o municipal vinculada ao CPF CNPJ informado 1406 Versao da DLL de conversao de RPS desatualizada Baixe a ultima versao no site da NFSe NFSE Nota Fiscal de Servi os Eletr nica Anexo 02 URL do WebService para produ o O WebService de produ o encontra se dispon vel no link CAMPINAS SP http issdigital campinas sp gov br WsNFe2 LoteRps jws UBERLANDIA MG http udigital uberlandia mg gov br WsNFe2 LoteRps jws BELEM PA http www issdigitalbel com br WsNFe2 LoteRps jws CAMPO GRANDE MS http issdigital pmcg ms gov br WsNFe2 LoteRps jws NOVA I
42. ractere ASCII 13 tal caractere de espa o entre as TAGs ES NFSE Nota Fiscal de Servi os Eletr nica 4 Servi os e M todos 4 1 Envio de Lote de RPS M todo Enviar Tipo de Servi o Ass ncrono Funcionamento O prestador atrav s do seu sistema ir gerar os RPS o primeiro RPS ser o 01 o sistema do prestador respons vel por gerar e controlar esses RPS com numera o sequencial e depois em um determinado momento que por exemplo pode ser ao final do expediente gerar um pacote de informa es com estes RPS no formato XML o que chamamos de Lote em seguida estabelecer uma conex o com o web service da prefeitura e enviar o lote para o servi o Enviar do WebService Como este um servi o ass ncrono o lote n o ser processado no mesmo momento ou na mesma conex o O WebService ir re ceber este lote e gerar um n mero de protocolo que o numero do lote e retornar este n mero de lote gerado ao sistema do contribuinte Num outro momento que pode ser por exemplo no inicio do expe diente seguinte o sistema do prestador dever consultar a situa o de processamento destes lotes no WebService da prefeitura atrav s do m todo ConsultarLote passando o numero de lote como par metro Esta funcionalidade tem por finalidade receber a mensagem XML enviada pelo sistema do contribuinte validar a estrutura do XML que deve estar de acordo com os Schemas definidos e gravar e processar as informa es
43. se obter o modelo de RPS a ser seguido O contribuinte que esta no Regime Especial de entrega em lote deve se credenciar no site da NFSe para liberar a entrega em lote atrav s do Web Service da prefeitura O endere o para acessar o ambiente de produ o est no anexo 2 deste manual Neste manual encontram se instru es para a integra o de sistemas de informa o de emissores de RPS e o Sistema de Nota Fiscal de Servi os Eletr nica NFS e baseado no servi o WebService do portal da NFS e O servi o webservice foi desenvolvido para possibilitar a troca de dados entre os Sistemas de Informa o dos contribuintes e o Sistema de NFS e Atrav s do Web Service as empresas poder o integrar seus pr prios sistemas de informa es com o Sistema de NFS e para automatizar o processo de emiss o con sulta e processamento Atrav s do servi o o Sistema de NFS e disponibiliza uma s rie de funcionalidades que poder o ser acessa das pelos sistemas dos contribuintes A seguir est o resumidas as interfaces dispon veis e suas respectivas funcionalidades b sicas Como utilizar o WebService A aplica o cliente deve enviar um pacote XML criado conforme as defini es deste manual Este pacote entregue ao Web Service que o analisa e aciona a Aplica o usada para implementar o servi o e devolve outro pacote XML como resposta ES NFSE Nota Fiscal de Servi os Eletr nica 2 2 Interfaces Dispon veis A seguir est
44. to emissor do RPS ou s rie de presta o Por padr o informe o valor 99 para modelo nico Caso esteja autorizado pela prefeitura pode se passar um valor de 01 a 99 para indicar o n mero do equipamento Retorno do m todo Na tabela seguinte apresenta se a defini o dos campos do XML de retorno da fun o de consulta de NFSe ou RPS Exemplos presentes no Anexo 06 deste manual Estrutura definida no schema XML Registro Cabe alho C digo da Cidade Padr o SIAFI CPF ou CNPJ do remetente autorizado a transmitir o RPS Dtinicio Data de in cio do per odo transmitido Data do primeiro RPS contido no lote Formato YYYY MM YY DtFim Data Final do per odo transmitido Data do ltimo RPS contido no lote Formato YYYY MM YY Informe a vers o do SChema XML Padr o 1 Registro de Notas CONTE DO N mero da Nota Fiscal CAMPO NumeroNota TIPO TAM Data do Processamento Formato AAAA MM DDTHH MM SS N mero do Lote DataProcessamento NumeroLote No Ia N N CodigoVerificacao C digo de Verifica o Indentificador da NFSe Assinatura do RPS Inscri o Municipal do Prestador Assinatura 0 N O Oui InscricaoMunicipalPrestador RazaoSocialPrestador 120 Razao Social do Prestador TipoRPS 20 Tipo de RPS Padr o RPS SerieRPS ja 2 S rie do RPS Padr o NF NumeroRPS No fn N mero do RPS DataEmissaoRPS Data de Emiss o do RPS Formato AAAA MM DDTHH MM
45. ubstitu do Numero da NFSe Substitu da Data de Emiss o da NFSe Substitu da Formato YYYY MM YY N mero do equipamento emissor do RPS ou s rie de presta o RazaoSocialPrestador TipoRPS SerieRPS NumeroRPS DataEmissaoRPS SituacaoRPS SerieRPSSubstituido NumeroRPSSubstituido NumeroNFSeSubstituida DataEmissaoNFSeSubstituida SeriePrestacao InscricaoMunicipalTomador CPFCNPJTomador RazaoSocialTomador Inscri o Municipal do Tomador CPF ou CNPJ do Tomador Raz o Social do Tomador D 20 DocTomadorEstrangeiro 20 TipoLogradouroTomador Documento de Identifica o do Tomador Estrangeiro Tipo do Logradouro do Tomador LogradouroTomador 50 Logradouro do Tomador NumeroEnderecoTomador N mero de Endere o do Tomador ComplementoEnderecoTomador 30 Complemento Endere o do Tomador TipoBairroTomador Tipo de Bairro Tomador 50 Bairro do Tomador C digo da Cidade do Tomador padr o SIAFI Cidade do Tomador CEP do Tomador 60 Email do Tomador 9 C digo da Atividade 6 4 Al quota da Atividade Tipo de Recolhimento A A recolher R Retido na fonte C digo do Munic pio de Presta o Padr o SIAFI Munic pio de Presta o Opera o A Sem Dedu o B Com Dedu o Materiais C Imune Isenta de ISSQN D Devolu o Simples Remessa J Intermedia o BairroTomador CidadeTomador CidadeTomadorDescricao CEPTomador EmailTomador CodigoAtividade Al
Download Pdf Manuals
Related Search