Home
Baixe o texto em PDF - Nota Fiscal Paulistana
Contents
1. C digo Descri o Onde Ocorre 1402 O CPF CNPJ da assinatura da mensagem XML n o tem acesso ao Tomador de Servi os GH informado As datas informadas compreendem um per odo maior que o permitido O per odo n o pode 1403 i j G H abranger mais que 31 dias 1404 A Inscri o Municipal do Prestador de Servi os n o consta na base de dados J O preenchimento do ISSRetidolntermedi rio implica a obrigatoriedade do preenchimento do C D E 1418 CNPJ ou do CCM do Intermedi rio 4 4 2 Alertas Tabela de Alertas C digo Descri o Onde Ocorre Al quota informada lt valor da al quota gt difere da al quota vigente lt valor da al quota vigente gt 208 para o c digo de servi o informado lt c digo de atividade gt O sistema ir adotar a al quota C D E vigente 211 A inscri o municipal do tomador lt Inscri o Municipal do Tomador gt n o foi encontrada na CDE base de dados de CCM ea Cidade UF informada lt cidade do Tomador gt lt UF do Tomador gt n o foi encontrada na base 214 C D E de dados 26 RPS j foi convertido individualmente em NF e atrav s do site e n o ser processado CDE novamente o 217 RPS reenviado A NF e lt n mero da NF e gt referente ao RPS N mero lt n mero do RPS gt CDE S rie lt s ria do RPS gt foi cancelada e uma nova NF e foi emitida do 291 O CNPJ informado lt CNPJ gt possui inscri o municipal em S o Paul
2. Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 17 DESCRI O TIPO NOME DO TIPO tipo utilizado para BASE TAMANHO DEC OBSERVA O informar tpLogradouro Endere o C 0 50 Tipo utilizado para informar n mero de NF e n mero de tpNumero Numero N tais RPS n mero de Guia n mero de Lote n mero de p gina tpNumeroEndereco N mero do Endere o C 0 10 Op o pelo Simples 0 N o optante pelo Simples Federal nem Municipal 1 Optante pelo Simples Federal Al quota de 1 0 tpOpcaoSimples Op o pelo Simples C 1 2 Optante pelo Simples Federal Al quota de 0 5 3 Optante pelo Simples Municipal 4 Optante pelo Simples Nacional tpQuantidade Tipo Quantidade N 1 15 tpRazaoSocial Tipo Raz o Social C 0 75 Nome Raz o Social tpSerieRPS Tipo S rie do RPS C 1 5 S rie do RPS Status da NF e tpStatusNFe Status da NF e C 1 N Normal C Cancelada O conte do deste campo indica ips cesso se o pedido do servi o obteve B P sucesso ou n o conforme descrito no item 4 3 1 Tempo de processamento T tpTempoProcessamento segundos N 1 15 tpTipoLogradouro Tipo de endere o C 0 3 Rua Av Tipo do RPS RPS Recibo Provis rio de Servi os tpTipoRPS Tipo do RPS C 1 RPS M Recibo Provis rio de Servi os proveniente de Nota Fiscal Conjugada Mista RPS C Cupom Manual de Utiliza o Web Service
3. Tipo de Tributa o do RPS Tipo de Tributa o do RPS com 1 posi o caractere a NFS e emitidas at 22 02 2015 T Tributa o no municipio de S o Paulo F Tributa o fora do municipio de S o Paulo Isento J ISS Suspenso por Decis o Judicial a NFS e emitidas a partir 23 02 2015 T Tributado em S o Paulo F Tributado Fora de S o Paulo A Tributado em S o Paulo por m Isento B Tributado Fora de S o Paulo por m Isento M Tributado em S o Paulo por m Imune N Tributado Fora de S o Paulo por m Imune Manual de Utiliza o Web Service Vers o do Manual 2 4 1 X Tributado em S o Paulo por m Exigibilidade Suspensa V Tributado Fora de S o Paulo por m Exigibilidade Suspensa P Exporta o de Servi os Status do RPS Status do RPS com 1 posi o caractere N Normal C Cancelado ISS Retido Valor S SIM para ISS Retido caractere Valor N N O para Nota Fiscal sem ISS Retido Valor dos Servi os Valor dos Servi os do RPS incluindo os centavos sem ponto decimal e sem R com 15 posi es d gitos Exemplo R 500 85 000000000050085 R 500 00 000000000050000 Valor das Dedu es Valor das Dedu es do RPS incluindo os centavos sem ponto decimal e sem R com 15 posi es d gitos Exemplo R 500 85 000000000050085 R 500 00 0000000000
4. lt xml version 1 0 encoding utf 8 2 gt lt soap Envelope xmlns xsi http www w3 0rg 2001 XMLSchema instance xmins xsd http www w3 org 2001 XMLSchema xmins soap http schemas xmlsoap org soap envelope gt lt soap Body gt lt ConsultaInformacoesLoteRequest xmins http www prefeitura sp gov br nfe gt lt VersaoSchema gt 1 lt VersaoSchema gt lt MensagemXML gt INCLUIR AQUI A MENSAGEM XML CONFORME ITEM III lt MensagemXML gt lt ConsultaInformacoesLoteRequest gt lt soap Body gt lt soap Envelope gt Retorno lt xml version 1 0 encoding utf 8 2 gt lt soap Envelope xmlns xsi http www w3 0rg 2001 XMLSchema instance xmins xsd http www w3 org 2001 XMLSchema xmins soap http schemas xmlsoap org soap envelope gt lt soap Body gt lt ConsultaInformacoesLoteResponse xmlns http www prefeitura sp gov br nfe gt lt RetornoXML gt MENSAGEM XML DE RETORNO CONFORME ITEM IV lt RetornoXML gt lt ConsultaInformacoesLoteResponse gt lt soap Body gt lt soap Envelope gt 4 3 10 Pedido de Cancelamento de NF e CancelamentoNFe Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 42 guos Secretaria Municipal de Finan as jareerrerwe ari emrrrrrerreerrreeecrreeeerrrreo er onribumwe 4Prefeitura de S o Paulo e Web Services LoteNFe CancelamentoNF ea k Proc ra D s assassinas COTTET ve do Pedido Sistema de NF e Cancelamento de NF
5. A seguir s o descritos cada um dos servi os disponibilizados pelo Web Service LoteNFe bem como seus respectivos m todos e schemas XML de pedido e de retorno do servi o 4 3 1 Regras Gerais Par metros Todos os m todos de pedido de servi o dispon veis recebem dois par metros conforme o exemplo lt Nome do M todo gt lt Par metro VersaoSchema gt lt Par metro MensagemXML gt Onde Par metro VersaoSchema Vers o do Schema XML utilizado para montar a mensagem XML de pedido do servi o tipo de dado Integer Par metro MensagemXML Mensagem XML de pedido do servi o tipo de dado String Todos os m todos retornam uma mensagem XML de retorno no respectivo Schema XML de retorno do servi o pedido string Todos os Schemas XML de retorno contem uma TAG chamada Sucesso no cabe alho Esta TAG indica se o pedido foi atendido com sucesso true ou n o false conforme descrito a seguir Sucesso True Caso todo o pedido do servi o tenha sido processado sem que ocorram eventos de erro Sendo assim o Web Service transmitir uma mensagem XML de retorno do respectivo servi o informando o sucesso da opera o TAG sucesso true e as demais informa es pertinentes ao respectivo Schema de Retorno Caso ocorram eventos de alerta durante o processamento os alertas gerados ser o apresentados na mensagem XML de retorno Eventos de alerta n o impedem que o pedido seja atendido com sucesso Sucesso False Caso
6. Vers o do Manual 2 4 1 p g 18 NOME DO TIPO DESCRI O tipo utilizado para informar TIPO BASE TAMANHO DEC OBSERVA O tpTributacaoNFe Tipo de Tributa o a NFS e emitidas at 22 02 2015 poder ser preenchido com T Tributa o no munic pio de S o Paulo F Tributa o fora do munic pio de S o Paulo Isento Imune J ISS Suspenso por Decis o Judicial b NFS e emitidas a partir de 23 02 2015 poder ser preenchido com T Tributado em S o Paulo F Tributado Fora de S o Paulo A Tributado em S o Paulo por m Isento B Tributado Fora de S o Paulo por m Isento M Tributado em S o Paulo por m Imune N Tributado Fora de S o Paulo por m Imune X Tributado em S o Paulo por m Exigibilidade Suspensa V Tributado Fora de S o Paulo por m Exigibilidade Suspensa P Exporta o de Servi os tpUF Sigla da UF do endere o Sigla da UF do endere o tpValor Valores Tipo utilizado para valores com 15 d gitos sendo 13 de corpo e 2 decimais Exemplo R 500 85 500 85 R 826 00 826 tpVersao Vers o 1 3 O conte do deste campo indica a vers o do Schema XML utilizado Exemplo Vers o 1 1 Vers o 10 10 Vers o 100 100 tpPercentualCargaTributari a Percentual da carga tribut ria Exemplo 5 0 05 2 5 0 025 1 75 0 0175
7. true para NF e com ISS Retido pelo Intermedi rio false para NF e sem reten o pelo Intermedi rio Emailintermediario tpEmail 0 1 E mail do intermedi rio ValorCargaTributaria tpValor 0 1 Valor da carga tribut ria total em R PercentualCargaTributaria tpPercentualCargaTributaria 0 1 Valor percentual da carga tribut ria FonteCargaTributaria tpFonteCargaTributaria 0 1 Fonte de informa o da carga tribut ria CodigoCEI tpNumero 0 1 C digo do CEI Cadastro espec fico do INSS MatriculaObra tpNumero 0 1 No momento n o deve ser informado Aguarde previs o de obrigatoriedade na legisla o municipal MunicipioPrestacao tpCidade 0 1 C digo do munic pio onde ocorreu a presta o do servi o conforme tabela de C digos de Munic pios elaborada pelo IBGE Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 22 Discriminacao Tipo que representa RPS tpDiscriminacao Discrimina o dos servi os Nome do Elemento Tipo do Elemento Ocorr ncia Descri o Assinatura tpAssinatura 1 1 Assinatura do RPS emitido conforme especificado no Item 4 3 2 ChaveRPS tpChaveRPS 1 1 Chave de identifica o do RPS ver detalhes na tabela toChaveRPS TipoRPS tpTipoRPS 1 1 Tipo do RPS DataEmissao date 1 1 Data da emiss o do RPS StatusRPS tpStatusNFe 1 1 Status do RPS TributacaoRPS tpTributacao
8. G Fun o de message digest SHA 1 http www w3c org 2000 09 xmldsigtshal H Codifica o Base64 http www w3c org 2000 09 xmlidsigfbase64 l Transforma es exigidas Util para realizar a canonicaliza o do XML enviado para realizar a valida o correta da Assinatura Digital S o elas 1 Enveloped http Avww w3c org 2000 09 xmldsigfenveloped signature 2 C14N http Avww w3c org TR 2001 REC xml c14n 20010315 3 2 4 Valida o de Assinatura Digital pelo Sistema de NF e Para a valida o da assinatura digital seguem as regras que ser o adotadas pelo Sistema de Notas Fiscais de Servi os Eletr nicas da Prefeitura de S o Paulo A Extrair a chave p blica do certificado digital e n o utilizar a chave indicada na TAG XML ds KeyValue Verificar o prazo de validade do certificado utilizado Montar e validar a cadeia de confian a dos certificados validando tamb m a LCR Lista de Certificados Revogados de cada certificado da cadeia Validar o uso da chave utilizada Assinatura Digital de tal forma a aceitar certificados somente do tipo A n o ser o aceitos certificados do tipo S Garantir que o certificado utilizado de um usu rio final e n o de uma Autoridade Certificadora o OD m Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 9 F Adotar as regras definidas pelo RFC 3280 para LCRs e cadeia de confian a G Validar a integridade de todas as LCR utilizadas p
9. PREFEITURA DE SAO PAULO FINAN AS E DESENVOLVIMENTO ECON MICO Nota Fiscal Eletr nica de Servi os Manual de Utiliza o Web Service Vers o 2 4 2 Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 2 Manual de Utiliza o Web Service NDICE IS INTRODU O E EEA E E E E A E Cita donesan irado E seda Sis esmasas ans ponce A 4 2 INTERFACES DISPON VEIS cceeeeeeeresereereeereseeserenereeeesareeeaaeaeseesaeaaeaasaesae sas aae rasa e ane aae ses aeae ane aassesarsas ane scsaesneaas 4 ZALENVIO DERPS es isa ER TOSTES CEL E Sa SIDES a e Ee a E an 4 22 ENVIO DELOTE DE RPS a a a Ras ESC DAL INAC adia a HAS Inu la ie EAD Ia ondas en Aa EKE Sa 4 2 3 TESTE DE ENVIO DE LOTE DE RPS cas sp iss saem otro pancada cede doa MR as DESC eae E aE aE EA ELISA SECA aaa aa ESA SS 4 24 CONSULTA DE NF E scores ese e danse Lapa N Ta RAS dE SEO IaRoca a LORI Rda SCANS IT aa Ta Raa GE CCEL Isa a Ron er ali quant ada ai dana 4 2 5 CONSULTA DE NF ERECEBIDAS scas ssciemssseneene niara anean Eaa ain ada ai RCA re aona E Ee Eaa EEEE ae Rare a 4 2 60 CONSULTA DE NF EEMITIDAS as aa a a as onsa COL a ORLA Son SE a a a aaa R He n eDane LANSER aE EDIR 4 2 CONSULTA DE LOTE a a Pe RR E CAPOTE A Aeh 4 2 8 CONSULTA INFORMA ES DO LOTE terem reereeeeererereererareeere re tnts tn etsene re ceeeeeeeere re ereearareere recanto 5 2 9 CANCELAMENTO DE NF E a oragesiittaro Tereduenfo eia E aae Ti Seen OSS eae VU pe ua SENDA Deuce fiS
10. o de imunidades SDI para a data do fato C D E gerador informada 1222 Obrigat rio informar o munic pio onde o servi o foi prestado C D E 1223 Para servi o tributado em S o Paulo ou exporta o de servi os n o informe o munic pio onde o CDE servi o foi prestado edi 1225 Munic pio onde o servi o foi prestado inexistente C D E 1227 O prestador de servi os dever registrar a solicita o de imunidade por meio do sistema de CDE declara o de imunidades Instru o Normativa no XX 2014 ay 1228 Exporta o de servi os n o permite a indica o de reten o pelo tomador ou pelo CDE intermedi rio U 1232 O munic pio de S o Paulo foi informado como Munic pio da Presta o mas o servi o E C D E tributado fora de S o Paulo 1233 NFS e n o permite indica o de imunidade ou isen o para profissional aut nomo C D E 1234 C digo do Servi o Prestado 0 n o permite indica o do numero do Cadastro Espec fico do C D E INSS CEI 1303 S permitido o cancelamento de NF e emitidas por um nico Prestador de Servi os mesma J inscri o municipal 1304 Erro ao cancelar NF e J 1305 Assinatura de cancelamento da NF e incorreta J 1306 A NF e que se deseja cancelar n o foi gerada via Web Service J 1401 S permitido consultar NF e emitidas por um nico Prestador de Servi os mesma inscri o F municipal Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 50
11. xmins xsd http www w3 0org 2001 XMLSchema xmins soap http schemas xmlsoap org soap envelope gt lt soap Body gt lt CancelamentoNFeResponse xmlns http www prefeitura sp gov br nfe gt lt RetornoXML gt MENSAGEM XML DE RETORNO CONFORME ITEM IV lt RetornoXML gt lt CancelamentoNFeResponse gt lt soap Body gt lt soap Envelope gt 4 3 11 Pedido de Consulta de CNPJ ConsultaCNPJ Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 45 gas nn E TT Prefeitura de S o Paulo TTT Ti Web Services LoteNFe nanansanna eeeseemas CNPJ do contribuinte 4 Sistema de que se deseja consular NF e Retorno e e a Araaannaraasaccnanasonnrsaas A OT e e rem neem nestes Cad dy PRETO 4 ps a Cenasnasnannannassnnnasnansannasa sas I Descri o Este m todo respons vel por atender aos pedidos de consulta de CNPJ Este m todo possibilita aos tomadores e ou prestadores de servi os consultarem quais Inscri es Municipais CCM est o vinculadas a um determinado CNPJ e se estes CCM emitem NF e ou n o Il M todo ConsultaCNPJ ll O par metro MensagemXML ver item 4 3 1 dever ser preenchido conforme tabela a seguir PedidoConsultaCNPJ xsd TAG de grupo das P1 Cabecalho informa es do G 1 1 cabe alho Vers o do XML Versao A P1 tpVersao 1 1 Schema Utilizado P CNPJ do Remetente CNPJRemetente autorizado a enviar a E P1 tpCPFCNPJ 1 1 me
12. tpFonteCargaTributaria Fonte de informa o da carga tribut ria 0 10 Exemplo IBPT 4 2 2 Tipos Complexos Layout da tabela utilizada para representar a estrutura XML dos Tipos Complexos Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 19 lt Nome do Tipo Complexo gt lt Descri o do Tipo Complexo gt Nome do Elemento Tipo do Elemento Ocorr ncia Descri o lt Nome do Elemento 1 gt lt Tipo do Elemento 1 gt Descri o do elemento 1 gt lt Nome do Elemento gt lt Tipo do Elemento gt lt Descri o do elemento 1 gt x y x y Elemento que lt Nome do Elemento de Escolha a gt lt Tipo do Elemento a gt lt Descri o do elemento a gt x y x y deriva de uma lt Nome do Elemento de Escolha b gt lt Tipo do Elemento b gt lt Descri o do elemento b gt escolha Choice lt Nome do Elemento de Escolha c gt lt Tipo do Elemento c gt lt Descri o do elemento c gt lt Nome do Elemento N gt lt Tipo do Elemento N gt Descri o do elemento N gt Ocorr ncia x y onde x indica a ocorr ncia m nima e y a ocorr ncia m xima Tipo que representa a ocorr ncia de eventos de erro alerta durante o processamento da mensagem XML Nome do Elemento Descri o Codigo tpCodigoEvento 1 1 C digo do evento ocorrido Descricao tpDescricaoEvento 0 1 Descri o do evento ocorrido Choice Chave de identific
13. 11 3 4 4 Regras de preenchimento dos campos essessssssssesssrrssssessreretstssrreretssssrerrtesessesrrernessesrreretsessrerreesesseseeee 13 3 4 5 Tratamento de caracteres especiais no texto de XML ssssssssssssesssrssssesrsressssesrrersnsresreerersesseerreeressesrree 13 4 WEB SERVICE LOTE NFE c sis asse ssessnacoses ess tee seostes sans cEsTado posar acoa Tasca sa GUNS PULO serioase a naa Gan as TUE siasa casas ace isis SSSss 14 CA BO S D ERON RT URI RE NR ADD TRE RS RR VA RS EAR RSA ENREDO RR SR OCR RS ER OR RR 14 Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 3 42 TIPOS UTILIZADOS sicagasennasnsesa agir sonata SIE ARE DELE CAL EEEa e US DERA CEO UEL APS DGE CURE RELER CATA E SL ECOS ASR RACE AU RR SAE 15 42 18 Tipos Sim les ess ort seres incas A TA Ganda CR GRSA LILA NCADA A Grana Rta OG aa OUR Da LOL AN EAR Ta E AAS Ana near cad Rs 15 U 22808 BT o SEA 70 Ja 0 5 0 PEPINO DNS OR ARO SR SR SR SN RR AR NR RR 18 4 3 SERVI OS E M TODOS eterna arena ERRO INDICADOR N O DEFINIDO ASA Regras Gerai Siennine DeNada da T Edo TETE Add o DITA O a SD a E A O E E da 23 43 2 Envio de RPS a iss comics e e A E Dra Cabe o eE T E EE eA Sia 24 4 3 3 Envio de Lote de RPS EnvioLoteRPS sesssssesensssseessssssnsrrsserirssssenssrreassrrssnriissrretssrresnsrrssnreessrreessrreene 28 4 3 4 Teste de Envio de Lote de RPS TesteEnvioLoteRPS ssssssessessssesssssssssrrsseriissrrens
14. 2 4 1 p g 30 Representa o da estrutura definida no schema XML PedidoEnvioLoteRPS xsd Observa o 1 Assinatura Adicional Cada RPS enviado no lote dever ser assinado digitalmente conforme especificado no item 4 3 2 Envio de RPS Observa o 2 Transa o Se ocorrerem eventos de erro de valida o dos dados do cabe alho do pedido de envio de lote de RPS independente da op o informada no campo Transa o nenhum RPS ser substitu do por NF e IV Schema da Mensagem XML do Retorno RetornoEnvioLoteRPS xsd RetornoEnvioLoteRPS xsd ER A ar sa DA E RR e Pirai a Cabecalho TAG de grupo das informa es do cabe alho Versao Vers o do XML Schema Utilizado tpVersao 1 1 Sucesso Status do Pedido de Envio de Lote tpSucesso 1 1 de RPS InformacoesLote Informa es sobre o Lote SG PM tpInformacoesLote Informa es sobre a ocorr ncia de tpEvento eventos geradores de alertas durante o processamento da mensagem XML Informa es sobre a ocorr ncia de tpEvento eventos geradores de erros durante o processamento da mensagem XML ChaveRPSNFe Chave do RPS e Chave da NF e tpChaveNFeRPS gerada Representa o da estrutura definida no schema XML RetornoEnvioLoteRPS xsd Observa o Transa o Para pedidos de envio de lote de RPS com transa o Transacao True o campo InformacoesLote retornar dentre outras informa es o total dos servi os o total das dedu e
15. 500 KB Primeiramente cada mensagem XML de pedido de servi o ser recebida pelo Web Service LoteNFe para valida o de seu respectivo Schema XML arquivo XSD Caso ocorram erros de valida o do Schema XML o conte do da mensagem XML n o ser processado e ser retornada uma mensagem XML contendo o s erro s ocorrido s 4 1 WSDL Para que os sistemas de informa o dos contribuintes saibam quais par metros enviar ao Web Service LoteNFe e quais par metros ser o retornados os contribuintes dever o utilizar o arquivo WSDL Web Service Description Language linguagem de descri o de servi o Web Trata se de um arquivo XML que configura como ocorrer a intera o entre um Web Service e seus consumidores sistemas de informa o dos contribuintes O WSDL uma linguagem baseada em XML com a finalidade de documentar as mensagens XML que o Web service aceita pedidos de servi o e gera retornos Esse mecanismo padr o facilita a interpreta o dos contratos pelos desenvolvedores e ferramentas de desenvolvimento Para enxergar o valor do WSDL imagine que um contribuinte quer invocar um dos m todos que fornecido pelo Web Service LoteNFe O contribuinte pode pedir alguns exemplos de mensagens XML de pedido e de retorno e escrever sua aplica o para produzir e consumir mensagens XML que se parecem com os exemplos mas isso pode gerar muitos erros Por exemplo o contribuinte pode assumir que um campo um inteiro quando
16. Cuenaananaanasinanss sd erteemerer Pd Prefeitura de S o Paulo r Web Services LoteNFe ConsultaNFe Consulta NF e Retorno Coganannana das RS Secretaria Municipal de Finan as werevwersrevraveerzrveeg gt do Pedido Sistema de NF e e aasssss252555552959559555555535535 ve 2 s a COLBELLCEGOLLGEDLLDACLACOSCLCCESLESLDCLDSnACanacennncanancennaranansad Descri o Este m todo respons vel por atender aos pedidos de consulta de NF e RPS Seu acesso permitido apenas pela chave de identifica o da NF e ou pela chave de identifica o do RPS M todo ConsultaNFe PedidoConsultaNFe xsd Cabecalho TAG de grupo das informa es do cabe alho O par metro MensagemXML ver item 4 3 1 dever ser preenchido conforme tabela a seguir Versao Vers o do XML Schema Utilizado tpVersao CNPJ do Remetente autorizado a tpCPFCNPJ CNPJRemetente enviar a mensagem XML Detalhe TAG de grupo das informa es do detalhe Chave do RPS Chave da NF e ChaveRPS ChaveNFe tpChaveRPS tpChaveNFe Representa o da estrutura definida no schema XML PedidoConsultaNFe xsd IV Assinatura digital da mensagem SignatureType XML Signature Schema da Mensagem XML do Retorno RetornoConsulta xsd Signature o elemento raiz de uma assinatura
17. Elemento Ocorr ncia Descri o InscricaoPrestador tpInscricaoMunicipal 1 1 Inscri o Municipal do Prestador que emitiu o RPS SerieRPS tpSerieRPS 0 1 S rie do RPS NumeroRPS tpNumero 1 1 N mero do RPS tpEndereco Tipo que representa um Endere o Nome do Elemento Tipo do Elemento l Ocorr ncia Descri o TipoLogradouro tpTipoLogradouro 0 1 Tipo do endere o Logradouro tpLogradouro 0 1 Endere o NumeroEndereco tpNumeroEndereco 0 1 N mero do endere o ComplementoEndereco tpComplementoEndereco 0 1 Complemento do endere o Bairro tpBairro 0 1 Bairro do endere o Cidade tpCidade 0 1 C digo da cidade do endere o UF tpUF 0 1 Sigla da UF do endere o CEP tpCEP 0 1 CEP do endere o tpInformacoesLote Tipo que representa as informa es do lote processado Nome do Elemento Tipo do Elemento Ocorr ncia Descri o NumeroLote tpNumero 041 N mero do lote InscricaoPrestador tpInscricaoMunicipal 1 1 Inscri o Municipal do prestador dos RPS contidos no lote CPFCNPJRemetente tpCPFCNPJ 1 1 CPF CNPJ do remetente autorizado a transmitir a mensagem XML DataEnvioLote dateTime 1 1 Data Hora do envio do lote AAAA MM DDThh mm ss QtdNotas tpQuantidade 1 1 Quantidade de RPS contidos no lote TempoProcessamento tpTempoProcessamento 1 1 Tempo de processamento do lote ValorTotalServicos tpValor 1 1 Valor total dos servi os dos RPS contidos na mensagem XML ValorTot
18. Envelope xmlns xsi http www w3 org 2001 XMLSchema instance xmins xsd http www w3 org 2001 XMLSchema xmins soap http schemas xmlsoap org soap envelope gt lt soap Body gt lt ConsultaNFeEmitidasResponse xmlns http www prefeitura sp gov br nfe gt lt RetornoXML gt MENSAGEM XML DE RETORNO CONFORME ITEM IV lt RetornoXML gt lt ConsultaNFeEmitidasResponse gt lt soap Body gt lt soap Envelope gt 4 3 8 Pedido de Consulta de Lote ConsultaLote er5trnmsssusussuuuusuuuunuuuusuuu uru muy gt Secretaria Municipal de Finan as pr Eontibinten mt e TTT Prefeitura de S o Paulo werrwerezreerzeeeeseemea Web Services i LoteNFe Consulta Lote ConsultaLote do Pedido N mero Lote Sistema de NF e Retorno Anos ss sons sssass nas ass ns san snas aa mu a e e a q t a ta Cossnnnnesmennenannan s CiesanenenannenneneannarnannansancannascanneanancannancanneenansennasE I Descri o Este m todo respons vel por atender aos pedidos de Consulta de Lote de NF e geradas a partir do m todo EnvioLoteRPS II M todo ConsultaLote ll O par metro MensagemXML ver item 4 3 1 dever ser preenchido conforme tabela a seguir PedidoConsultaLote xsd Ele Pai Tipo TAG de grupo das P1 Cabecalho informa es do G 1 1 cabe alho Vers o do XML Versao A P1 tpVersao 1 1 Schema Utilizado CNPJ do Remetente CNPJRemetente autorizado a env
19. P1 toNumero 0 1 lote ser o retornadas i informa es do ltimo lote gerador de NF e Inscri o municipal do prestador de InscricaoPrestador servi os que gerou E P1 tpInscricaoMunicipal 141 o lote a ser consultado Signature o Assinatura digital elemento raiz de uma P2 Signature da mensagem G SignatureType 1 1 ASSInatur aPMEE SIS XML elemento descrito no arquivo xmldsig coreschema_v01 xsd Representa o da estrutura definida no schema XML PedidolnformacoesLote xsd IV Schema da Mensagem XML do Retorno RetornolnformacoesLote xsd Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 41 Retornolnforma esLote xsd Campo Descri o Ele Pai Tipo Ocorr Observa o TAG de grupo das E N pi Cabecalho informa es do cabe alho G LA Vers o do XML Versao A P1 tpVersao 1 1 Schema Utilizado k Sucesso Status do Envio de Lote E P1 tpSucesso 1 1 InformacoesLote Informa es sobre o Lote G P1 tpInformacoesLote 0 1 Informa es sobre a ocorr ncia de eventos P2 Alerta geradores de alertas durante G tpEvento O N o processamento da mensagem XML Informa es sobre a ocorr ncia de eventos P3 Erro geradores de erros durante o G tpEvento O N processamento da mensagem XML Representa o da estrutura definida no schema XML RetornolnformacoesLote xsd V Formato das Mensagens SOAP Pedido
20. Remetente autorizado a enviar a mensagem XML P1 tpCPFCNPJ 1 1 CPFCNPJ Para consulta de NF e Recebidas Informe o CPF CNPJ do tomador da NF e Para consulta de NF e Emitidas Informe o CNPJ do emissor da NF e P1 tpCPFCNPJ 1 1 Inscricao Para consulta de NF e Recebidas Informe a Inscri o Municipal do Tomador Para consulta de NF e Emitidas Informe a Inscri o Municipal do Prestador Neste tipo de consulta o preenchimento deste campo se torna obrigat rio P1 tpInscricaoMunicipal ATEN O 1 Este campo s dever ser preenchido com a inscri o de contribuintes estabelecidos no munic pio de S o Paulo CCM Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 35 PedidoConsultaNFePeriodo xsd Campo Descri o Ele Pai Tipo Ocorr Observa o Data in cio da anna consulta E PI D 1 1 dtFim Data fim da consulta E P1 D 1 1 NumeroPagina N mero da p gina E P1 toNumero 1 1 Default 1 consultada Signature o elemento raiz de uma assinatura XML Este elemento descrito no arquivo xmldsig coreschema_v01 xsd Assinatura digital da G P2 Signature mensagem XML SignatureType 1 1 Representa o da estrutura definida no schema XML PedidoConsultaNFePeriodo xsd Os m todos ConsultaNFeRecebidas e ConsultaNFeEmitidasidas utilizam o mesmo
21. XML Este elemento descrito no arquivo xmldsig core schema v0l xsd Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 33 RetornoConsulta xsd TAG de grupo das informa es do cabe alho Vers o do XML Schema Utilizado tpVersao Status do Envio de Lote asas E Informa es sobre a ocorr ncia a tpEvento eventos geradores de alertas durante o processamento da mensagem XML Informa es sobre a ocorr ncia de tpEvento eventos geradores de erros durante o processamento da mensagem XML Elemento NFe pode se repetir quantas tpNFe vezes for necess rio respeitando o limite de m mimo estabelecido Cada item ser um NF e Representa o da estrutura definida no schema XML RetornoConsulta xsd V Formato das Mensagens SOAP Pedido lt xml version 1 0 encoding utf 8 gt lt soap Envelope xmlns xsi http www w3 0org 2001 XMLSchema instance xmins xsd http www w3 org 2001 XxMLSchema xmins soap http schemas xmlsoap org soap envelope gt lt soap Body gt lt ConsultaNFeRequest xmlns http www prefeitura sp gov br nfe gt lt VersaoSchema gt 1 lt VersaoSchema gt lt MensagemXML gt INCLUIR AQUI A MENSAGEM XML CONFORME ITEM III lt MensagemXML gt lt ConsultaNFeRequest gt lt soap Body gt lt soap Envelope gt Retorno lt xml version 1 0 encoding utf 8 gt lt soap Envelope xmlns xsi http www w3 0org 2001 XMLSchema ins
22. a utiliza o do Web Service do Sistema de Notas Fiscais de Servi os Eletr nicas da Prefeitura de S o Paulo utiliza as defini es de tipos simples ou tipos complexos que est o definidos em outros Schemas XML ex TiposNFe xsd e xmldsig core schema xsd nestes casos a modifica o de vers o do Schema b sico ser repercutida no Schema principal Por exemplo o tipo RPS tpRPS utilizado no Schema PedidoEnvioLoteRPS V04 xsd est definido no Schema TiposNFe VO1 xsd caso ocorra alguma modifica o na defini o deste tipo e um consequente incremento da vers o do Schema TiposNFe V0t xsd para TiposNFe V02 xsd o Schema PedidoEnvioLoteRPS V04 xsd bem como todos os Schemas que utilizam o tipo RPS deve ter a declara o import atualizada com o nome do Schema TiposNFe V02 xsd e a vers o atualizada para PedidoEnvioLoteRPS VO5 xsd Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 12 Exemplo de Schema XML de Pedido de Envio de Lote de RPS arquivo PedidoEnvioLoteRPS v01 xsd lt xml version 1 0 encoding utf 8 gt lt xs schema targetNamespace http www prefeitura sp gov br nfe xmins tipos http www prefeitura sp gov br nfe tipos xmins xs http www w3 0org 2001 XMLSchema xmins ds http www w3 org 2000 09 xmldsigf gt lt xs import namespace http www prefeitura sp gov br nfe tipos schemaLocation TiposNFe v0l xsd gt lt xs import namespace http www w3 0rg 2000 09 xmldsigf schemaL
23. assinatura XML Este elemento descrito no arquivo xmldsig core schema_v01 xsd Representa o da estrutura definida no schema XML PedidoEnvioRPS xsd Observa o Assinatura Adicional O RPS dever ter uma assinatura digital Esta assinatura utilizar o mesmo certificado digital usado na assinatura da mensagem XML item 3 2 2A com os mesmos padr es de criptografia assim trica RSA e algoritmo message digest SHA 1 Para criar a assinatura dever ser gerado um Hash utilizando SHA1 de uma cadeia de caracteres ASCII com informa es do RPS emitido Este Hash dever ser assinado utilizando RSA A assinatura do Hash ser informada na TAG Assinatura tipo RPS apresentado no item 4 2 1 A cadeia de caracteres a ser assinada dever conter 86 posi es com as informa es apresentadas na tabela a seguir Informa o Conte do 1 Inscri o Municipal do Inscri o Municipal do Prestador com 8 posi es d gitos Completar com zeros Prestador esquerda caso seja necess rio 2 S rie do RPS S rie do RPS com 5 posi es caracteres Completar com espa os em branco direita caso seja necess rio Aten o N o utilize espa os esquerda O conte do dever estar alinhado a esquerda 3 N mero do RPS N mero do RPS com 12 posi es d gitos Completar com zeros esquerda caso seja necess rio 4 Data de Emiss o do RPS Data de emiss o do RPS no formato AAAAMMDD caracteres
24. de informa o de um Contribuinte envia uma mensagem XML de Pedido Consulta de NF e Recebidas para o per odo de 01 09 2006 30 09 2006 e requerendo a p gina 1 Para este pedido s o encontradas 137 NF e recebidas As 137 NF e s o agrupadas em tr s p ginas P gina 1 com as primeiras 50 NF e 1 50 p gina 2 com as pr ximas 50 NF e 51 100 e p gina 3 com as 37 NFe restantes 101 1372 O Web Service retorna uma mensagem XML com a p gina requerida p gina 1 Ao receber a mensagem XML de retorno o sistema de informa o do Contribuinte verifica que foram retornadas 50 NF e para a p gina 1 O sistema de informa o do Contribuinte envia outra mensagem XML de Pedido Consulta de NF e Recebidas para o mesmo per odo mas desta vez requerendo a pr xima p gina p gina 2 O Web Service retorna uma mensagem XML com a p gina requerida p gina 2 Ao receber a mensagem XML de retorno o sistema de informa o do Contribuinte verifica que foram retornadas 50 NF e para a p gina 2 O sistema de informa o do Contribuinte envia outra mensagem XML de Pedido Consulta de NF e Recebidas para o mesmo per odo mas desta vez requerendo a pr xima p gina p gina 3 O Web Service retorna uma mensagem XML com a p gina requerida p gina 3 Ao receber a mensagem XML de retorno o sistema de informa o do Contribuinte verifica que foram retornadas 37 NF e para a p gina 3 e por tanto n o existem mais NF e recebidas para o per odo co
25. dever ser inferior ao valor dos servi os C D E 305 O Valor das dedu es dever ser superior ou igual a R 0 00 zero C D E 306 C digo do Servi o Prestado lt c digo enviado gt do RPS inexistente C D E 308 C digo do Servi o Prestado lt c digo enviado gt do RPS n o permite dedu o na base de CDE c lculo D 309 C digo do Servi o Prestado lt c digo enviado gt do RPS n o permite tributa o fora do CDE munic pio 310 C digo do Servi o Prestado lt c digo enviado gt n o Informado C D E 311 Apenas empresas tomadoras de servi os inscritas no munic pio ou rg os P blicos podem CDE efetuar reten o de ISS CPF CNPJ lt CPF CNPJ do Tomador gt ves 312 A data da emiss o do RPS n o foi preenchida Corretamente C D E 313 A data da emiss o do RPS n o poder ser superior a data de hoje C D E 314 A data da emiss o do RPS n o poder ser inferior a 01 06 2006 C D E 315 N mero do RPS n o informado C D E 317 Campo Endere o n o preenchido obrigat rio para tomador com CNPJ C D E 318 Campo Cidade UF n o preenchido obrigat rio para tomador com CNPJ C D E 320 Inscri o Municipal do Tomador de Servi os consta como cancelada C D E 321 Apenas Notas com tributa o no munic pio ou fora do munic pio podem sofrer reten o de ISS C D E 322 O campo discrimina o dos servi os n o foi Preenchido C D E 323 Nota n o pode ser cancelada Ver detalhes no Manual C D E 324 Opera o n o autorizada por meio
26. digitais eliminando a necessidade de identifica o do usu rio atrav s de nome ou c digo de usu rio e senha O modelo de comunica o segue o padr o de Web Services definido pelo WS I Basic Profile A troca de mensagens entre o Web Service do Sistema de Notas Fiscais de Servi os Eletr nicas da Prefeitura de S o Paulo e o sistema do contribuinte ser realizada no padr o SOAP com troca de mensagens XML no padr o Style Enconding Document Literal wrapped A op o wrapped representa a chamada aos m todos dispon veis com a passagem de mais de um par metro 3 2 2 Padr o de Certificado Digital Os certificados digitais utilizados no Sistema de Notas Fiscais de Servi os Eletr nicas da Prefeitura de S o Paulo ser o emitidos por Autoridade Certificadora credenciada pela Infraestrutura de Chaves P blicas Brasileira ICP Brasil tipo A1 A3 ou A4 devendo conter o CNPJ do propriet rio do certificado digital Os certificados digitais ser o exigidos no m nimo em dois 2 momentos distintos A Assinatura de Mensagens XML Quem pode assinar a Mensagem XML Todas as Mensagens XML podem ser assinadas pelo pr prio contribuinte Neste caso o certificado digital utilizado dever conter o CNPJ do contribuinte que gerou a mensagem XML As Mensagens XML de consulta de NF e Emitidas NF e Recebidas e Informa es de lote podem ser assinadas pelo contador desde que cadastrado na tela de Configura es do Perfil do Co
27. e de retorno Estes tipos est o definidos no Schema XML de TiposNF e arquivo TiposNFe VO1 xsd Para obter a vers o mais recente do Schema XML de TiposNF e bem como os demais Schemas XML acesse o link a NFS e emitidas at 22 02 2015 https nfe prefeitura sp gov br ws schemas zip b NFS e emitidas a partir de 23 02 2015 https nfe prefeitura sp gov br ws schemasV02 zip 4 2 1 Tipos Simples Descri o dos nomes e abrevia es utilizadas nas colunas de cabe alho do layout da tabela de Tipos Simples DESCRI O TIPO NOME DO TIPO tipo utilizado para BASE TAMANHO DEC OBSERVA O informar O c digo informado dever ertencer Tabela de Munic pios tpCidade C digo da cidade de endere o N 7 fdo IBGE disponibilizada a Prefeitura de S o Paulo Coluna Nome do Tipo Nome do tipo simples Coluna Descri o Descri o do tipo simples Coluna Tipo Base tipo base utilizado na cria o do tipo simples B boolean Base64Binary C campo alfanum rico D campo data N campo num rico D Coluna Tamanho x y onde x indica o tamanho m nimo e y o tamanho m ximo a exist ncia de um nico valor indica que o campo tem tamanho fixo devendo se informar a quantidade de caracteres exigidos preenchendo se os zeros n o significativos tamanhos separados por v rgula indicam que o campo deve ter um dos tamanhos fixos da lista E Coluna Dec indica a quantidade m xima
28. em branco direita para preencher as 5 posi es Z Observa o n o necess rio informar os dados de intermedi rio na assinatura se n o houver intermedi rio Como exemplo sem intermedi rio a string montada seria dessa forma 310000000L03 00000000000120070103TNN00000000205000000000000050000002658100013167474254 2 Converta a cadeia de caracteres ASCII para bytes 3 Gere o HASH array de bytes utilizando SHA1 e Assine o HASH array de bytes utilizando RSA SHA1 ATEN O Na maioria das linguagens de programa o os passos 3 e 4 s o feitos atrav s de uma nica fun o Verifique a documenta o de sua linguagem para evitar assinar um hash de um hash IV Schema da Mensagem XML do Retorno RetornoEnvioRPS xsd Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 28 RetornoEnvioRPS xsd TT TAG de grupo das informa es do cabe alho Vers o do XML Schema Utilizado A PM Versao Sucesso Status do Pedido de Envio de Lote RE ie de RPS Informa es sobre a ocorr ncia de tpEvento eventos geradores de erros durante o processamento da mensagem XML ChaveNFeRPS Chave do RPS e Chave da NF e tpChaveNFeRPS E E Representa o da estrutura definida no schema XML RetornoEnvioRPS xsd Oo Alerta Informa es sobre a ocorr ncia de tpEvento eventos geradores de alertas durante o processamento da mensagem XML V Formato das Mensagens SOAP Pedido lt xml ver
29. enviadas dever ser superior a Data Inicial D E 206 Tipo de tributa o inv lido Para mais informa es consulte o item 14 20 da se o de CDE perguntas e respostas Ee 207 Data de Emiss o do RPS n o est compreendida entre lt data inicio de emiss o do lote gt e DE lt data fim de emiss o do lote gt conforme especificado no cabe alho da mensagem XML A 209 O c digo de servi o prestado n o permite reten o de ISS C D E Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 48 C digo Descri o Onde Ocorre 25 eo duplicidade na mensagem XML enviada RPS lt N mero do RPS gt S rie lt S rie do D E 218 RPS n o poder ser enviado novamente pois est inclu do em Guia de Recolhimento C D E 219 O campo Inscri o Municipal do Tomador Inscri o Municipal Tomador gt s dever ser CDE preenchido para tomadores estabelecidos no munic pio de S o Paulo o e 220 CPF CNPJ do Tomador CPF CNPJ do Tomador gt possui mais de uma inscri o municipal CDE sendo obrigat rio o preenchimento do campo Inscri o Municipal do Tomador ai 301 O tomador de servi os informado o pr prio prestador C D E 302 CNPJ do Tomador de Servi os inv lido d gitos verificadores n o conferem C D E 303 O Valor dos servi os dever ser superior a R 0 00 zero C D E 304 O Valor das dedu es
30. lise do parser espec fico da linguagem Alguns caracteres afetam o funcionamento deste parser n o podendo aparecer no texto de uma forma n o controlada Estes caracteres devem ser substitu dos conforme a tabela a seguir CARACTERES QUE AFETAM O PARSER DESCRI O SUBSTITUIR POR gt Sinal de maior amp gt lt Sinal de menor amp lt amp E comercial amp amp a Aspas amp quot E Sinal de ap strofe amp apos Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 14 4 Web Service Lote NFe O Web Service LoteNFe do Sistema de Notas Fiscais de Servi os Eletr nicas da Prefeitura de S o Paulo disponibiliza os servi os que ser o utilizados pelos sistemas de informa o dos contribuintes O mecanismo de utiliza o do Web Service LoteNFe segue as seguintes premissas Ser disponibilizado um Web Service LoteNFe para todos os servi os existindo um m todo Web para cada tipo de servi o Os servi os disponibilizados ser o s ncronos por tanto o envio da mensagem XML de pedido do servi o e a obten o da mensagem XML de retorno ser o realizados na mesma conex o atrav s de um nico m todo As mensagens XML de pedido de servi o que excederem o tamanho limite previsto 500 KB obter o como retorno uma mensagem XML de erro Por tanto os sistemas de informa o dos contribuintes n o poder o permitir a gera o de mensagens XML com tamanho superior a
31. lt xs element gt lt xs element name dtInicio type xs date minOccurs 1 maxOccurs 1 gt lt xs annotation gt lt xs documentation gt Informe a data de in cio do per odo transmitido AAAA MM DD lt xs documentation gt lt xs annotation gt lt xs element gt lt xs element name dtFim type xs date min0Occurs 1 maxOccurs 1 gt lt xs annotation gt lt xs documentation gt Informe a data final do per odo transmitido AAAA MM DD lt xs documentation gt lt xs annotation gt lt xs element gt lt xs element name QtdRPS type tipos tpQuantidade min0Occurs 1 maxOccurs 1 gt lt xs annotation gt lt xs documentation gt Informe o total de RPS contidos na mensagem XML lt xs documentation gt lt xs annotation gt lt xs element gt lt xs element name ValorTotalServicos type tipos tpValor min0ccurs 1 maxOccurs 1 gt lt xs annotation gt lt xs documentation gt Informe o valor total dos servi os prestados dos RPS contidos na mensagem XML lt xs documentation gt lt xs annotation gt lt xs element gt lt xs element name ValorTotalDeducoes type tipos tpValor min0ccurs 0 maxOccurs 1 gt lt xs annotation gt lt xs documentation gt Informe o valor total das dedu es dos RPS contidos na mensagem XML lt xs documentation gt lt xs annotation gt lt xs element gt lt xs sequence gt lt xs attribute name Versao type tipos tpVersao use required fixed 1 gt lt xs anno
32. ocorra algum evento de erro durante o processamento do pedido do servi o Sendo assim o Web Service transmitir uma mensagem XML de retorno do respectivo servi o informando o n o sucesso da opera o TAG sucesso false e as demais Informa es sobre os eventos de erro alerta ocorridos Observa es Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 24 Descri o dos nomes e abrevia es utilizadas no cabe alho das tabelas que representam estrutura definida nos schemas XML lt nome do arquivo xsd gt Cabecalho TAG de grupo das informa es do cabe alho Versao Vers o do XML Schema Utilizado Data de in cio do per odo transmitido E P1 D 1 1 AAAA MM DD dtinicio A Coluna amp C digo de identifica o do campo Este c digo utilizado por um elemento filho identificar seu elemento pai na coluna Pai B Coluna Descri o Descri o do campo C Coluna Ele A indica que o campo um atributo do Elemento anterior E indica que o campo um Elemento CE indica que o campo um Elemento que deriva de uma Escolha Choice G indica que o campo um Elemento de Grupo CG indica que o campo um Elemento de Grupo que deriva de uma Escolha Choice D Coluna Pai Indica qual o elemento pai E Coluna Tipo Tipos Base N campo num rico C campo alfanum rico D campo data Tipos Simples e Tipos Complexos F Coluna O
33. schema XML para o pedido do servi o Conforme especificado no Schema XML RetornoConsulta xsd utilizado no retorno dos pedidos de Consulta de NF e Consulta de NF e Recebidas Consulta de NF e Emitidas e Consulta de Lote s ser o retornadas at 50 NF e por consulta Porem a Consulta de NF e Recebidas assim como a Consulta de NF e Emitidas pode encontrar uma quantidade maior de NF e do que o limite especificado Sendo assim as NF e encontradas ser o agrupadas em p ginas com at 50 NF e Para consultar as NF e de cada uma das p ginas o contribuinte dever transmitir uma mensagem XML de pedido de Consulta de NF e Recebidas indicando qual p gina deseja consultar Desta forma caso um pedido de consulta de NF e Recebidas para p gina X retorne 50 NF e o sistema de informa o do Contribuinte deve efetuar novo pedido de Consulta de NF e Recebidas para p gina X 1 para verificar se existem mais NF e Recebidas no per odo consultado Quando o sistema de informa o do Contribuinte efetuar um pedido de Consulta de NF e Recebidas para uma determinada p gina e est consulta retornar menos que 50 NF e o sistema de informa o do contribuinte saber que estas s o as ltimas NF e recebidas para o per odo consultado e que por tanto est a ltima p gina Se o Web Service retornar uma mensagem XML informando sucesso tag sucesso true e sem nenhuma NF e por que a p gina consultada n o existe Exemplo O sistema
34. 50000 10 C digo do Prestado Servi o C digo do Servi o do RPS com 5 posi es d gitos Completar com zeros esquerda caso seja necess rio 11 Indicador de CPF CNPJ do Tomador Indicador de CPF CNPJ com 1 posi o d gito Valor 1 para CPF Valor 2 para CNPJ Valor 3 para N o informado 12 CPF CNPJ do Tomador CPF CNPJ do tomador com 14 posi es d gitos Sem formata o ponto tra o barra Completar com zeros esquerda caso seja necess rio Se o Indicador do CPF CNPJ for 3 n o informado preencher com 14 zeros 13 Indicador de CPF CNPJ do Intermedi rio Indicador de CPF CNPJ com 1 posi o d gito Valor 1 para CPF Valor 2 para CNPJ Valor 3 para N o informado o CPF CNPJ do Intermedi rio 14 CPF CNPJ do Intermedi rio CPF CNPJ do intermedi rio com 14 posi es d gitos Sem formata o ponto tra o barra Completar com zeros esquerda caso seja necess rio Se o Indicador do CPF CNPJ for 3 n o informado preencher com 14 zeros 15 ISS Retido Intermedi rio Valor S SIM para ISS Retido pelo Intermedi rio Valor N N O para ISS n o retido pelo Intermedi rio Passos b sicos para assinatura de um RPS Monte a string de caracteres conforme a tabela a apresentada anteriormente A seguir apresentamos o exemplo de parte de uma mensagem XML de pedido de envio de RPS os campos utiliza
35. DO CERTIFICADO ASSINATURA Envio de RPS Envio de Lote de RPS Teste de Envio de Lote de RPS Consulta de NF e Consulta de NF e Recebidas Consulta de NF e Emitidas Consulta de Lote Consulta de Informa es de Lote Cancelamento de NF e Consulta de CNPJ 4 4 1 Erros Tabela de Erros de Schema C digo Descri o Onde Ocorre 1001 XML n o compat vel com Schema A 1002 Vers o do Schema XML Incorreto 1050 Rejei o Certificado Assinatura Inv lido 1051 Rejei o Certificado Assinatura Data Validade 1052 Rejei o Certificado Assinatura sem CNPJ 1053 Rejei o Certificado Assinatura Erro Cadeia de Certifica o 1054 Rejei o Certificado Assinatura revogado 1055 Rejei o Certificado Assinatura difere ICP Brasil 1056 Rejei o Assinatura Digest difere do calculado 1057 Rejei o Assinatura difere do calculado VIVIDO voj ovo vj vj j gt gt Tabela de Erros de Pedido de Servi o C digo Descri o Onde Ocorre 104 A Data Inicial de emiss o das Notas Fiscais enviadas n o pode ser inferior a 01 06 2006 D E 106 A Data Final de emiss o das Notas Fiscais enviadas n o pode ser inferior a 01 06 2006 D E 107 A Data Final de emiss o das Notas Fiscais enviadas n o pode ser Superior a lt data atual gt D E 108 A Data Final de emiss o das Notas Fiscais
36. L RetornoConsultaCNPJ xsd V Formato das Mensagens SOAP Pedido lt xml version 1 0 encoding utf 8 gt lt soap Envelope xmlns xsi http www w3 o0org 2001 XMLSchema instance xmins xsd http www w3 org 2001 XMLSchema xmins soap http schemas xmlsoap org soap envelope gt lt soap Body gt lt ConsultaCNPJRequest xmlns http www prefeitura sp gov br nfe gt lt VersaoSchema gt 1 lt VersaoSchema gt lt MensagemXML gt INCLUIR AQUI A MENSAGEM XML CONFORME ITEM III lt MensagemXML gt lt ConsultaCNPJRequest gt lt soap Body gt lt soap Envelope gt Retorno lt xml version 1 0 encoding utf 8 gt lt soap Envelope xmlns xsi http www w3 org 2001 XMLSchema instance xmins xsd http www w3 0rg 2001 XxMLSchema xmins soap http schemas xmlsoap org soap envelope gt lt soap Body gt lt ConsultaCNPJResponse xmlns http www prefeitura sp gov br nfe gt lt RetornoXML gt MENSAGEM XML DE RETORNO CONFORME ITEM IV lt RetornoXML gt lt ConsultaCNPJResponse gt lt soap Body gt lt soap Envelope gt 4 4 TABELA DE ERROS E ALERTAS As tabelas a seguir apresentam os erros e alertas relacionados ao Web Service do Sistema de Notas Fiscais Eletr nicas da Prefeitura de S o Paulo Manua I de Utiliza o Web Service Vers o do Manual 2 4 1 p g 47 Legenda da coluna Onde Ocorre A FrAcC IQMNMDOOU VALIDA O DO SCHEMA VERIFICA O
37. NFe 1 1 Tipo de tributa o do RPS ValorServicos tpValor 1 1 Valor dos servi os em R ValorDeducoes tpValor 1 1 Valor das dedu es em R ValorPIS tpValor 0 1 Valor da reten o do PIS em R ValorCOFINS tpValor 0 1 Valor da reten o do COFINS em R ValorINSS tpValor 0 1 Valor da reten o do INSS em R ValorlR tpValor 0 1 Valor da reten o do IR em R ValorCSLL tpValor 0 1 Valor da reten o do CSLL em R CodigoServico tpCodigo 1 1 C digo do servi o prestado AliquotaServicos tpAliquota 1 1 Al quota do servi o prestado ISSRetido Boolean 1 1 Reten o do ISS Preencher com true para NF e com ISS Retido false para NF e sem ISS Retido CPFCNPJTomador tpCPFCNPJ 0 1 CPF CNPJ do tomador do servi o InscricaoMunicipalTomador tpInscricaoMunicipa 0 1 Inscri o Municipal do tomador I ATEN O 1 Este elemento s dever ser preenchido para tomadores estabelecidos no munic pio de S o Paulo CCM ATEN O 2 O preenchimento deste elemento implica na obrigatoriedade do preenchimento do elemento CPFCNPJTomador Ser verificado se o CNPJ vinculado ao CCM corresponde ao CNPJ informado no elemento CPFCNPJTomador InscricaoEstadualTomador tpInscricaoEstadual 0 1 Inscri o Estadual do tomador RazaoSocialTomador tpRazaoSocial 0 1 Nome Raz o Social do tomador EnderecoTomador tpEndereco 0 1 Endere o do tomador EmailTomador tpEmail 0 1 E mail do tomador CPFCNPJIntermediario tpCPFCNPJ 0 1 CPF CNPJ do intermedi rio do
38. UNID Same EE ae aos 5 2 10 CONSULTA DE CNP Issa o Te caio sn o Sessions sas paira 5 3 ARQUITETURA DE COMUNICA O anrai ER AE A A E A i a AA a A Ai 6 3 41 MODELO CONCEITUAL a a a PES T RRE 6 SE PADRDES TECNICOS mrret neetna Eden E 7 3271 Padr o de COMUNICA O Sis smines cu pena anio ade Co a SEI QUE va Eur MNT ENTE OR Ene a a Ent Sa Ed En EG a ca e gi 7 3 2 2 Padrao de Certificado Digital a a aa aa anca EE Crane nan Dea cabe da ma rakaa AEEA PIRRE etniei 7 3 2 3 Padr o de Assinatura Digitalis seen sumo e EI Eno Saes fundir Dado Dior SERA SO eo do ESA a da Ce aa rela Cb GU a 8 3 2 4 Valida o de Assinatura Digital pelo Sistema de NF e ereereeeeeeeerearereeeeeeaeerarereraenea 8 3 2 5 Resumo dos Padr es T CNICOS terenie is ssndasoo sua poe neon FENDAS co sab sau EEE A EEEE S SEE 9 3 3 MODELO OPERACIONAL ss es e e as ns a E UA a A DRAGON a al U nda Sagas ea ta aaaea iaa 10 s Pis PM AR 87 6 0 Je VSNPEA PRIDE RSRS a a SR U RN a a E aia aa PONTO PONTO 10 3 4 PADR O DAS MENSAGENS XM brni meai eannan e e rece a a a a a E h 10 3 4 1 Valida o da estrutura das Mensagens XML sesssssssssesssersssessssererssssssrrerssssesrrererssssrereesessrerrersesseseret 10 3 4 2 Schemas XML arquivos XSD ss sssseassssisssisseriisssressssseassrrssnrirssrreissrrasssrisseriissrritssrreassrrsnerressrreessrreesrt 11 3 4 3 Vers o dos Schemas XML isssemisritssspisace salinas tone innsa iere iesea EaR E aai T S a era dE Lda SEEE Eas
39. a o da NF e que gerou Caso o evento tenha sido gerado ChaveNFe tpChaveNFe o evento ver detalhes na tabela durante o processamento de uma di tpChaveNFe NF e ou RPS o tpEvento Chave de identifica o do RPS que gerou tamb m retorna a chave da NF e ChaveRPS tpChaveRPS o evento ver detalhes na tabela ou RPS que o gerou tpChaveRPS tpCPFCNPJ Tipo que representa um CPF CNPJ Nome do Elemento Tipo do Elemento Choice Descri o N mero no Cadastro de Pessoas F sicas N mero no Cadastro Nacional da Pessoa Jur dica tpChaveNFeRPS Tipo que representa a Chave de uma NF e e a Chave do RPS que a mesma substitui Nome do Elemento Tipo do Elemento ChaveNFe tpChaveNFe Descri o Chave de identifica o da NF e que substitui o RPS ver detalhes na tabela tpChaveNFe Chave de identifica o do RPS substitu do ver detalhes na tabela tpChaveRPS ChaveRPS tpChaveRPS tpChaveNFe Tipo que representa a chave que um NF e Nome do Elemento Tipo do Elemento Ocorr ncia Descri o InscricaoPrestador tpInscricaoMunicipal 1 1 Inscri o Municipal do Prestador que emitiu a NF e CodigoVerificacao tpCodigoVerificacao 0 1 C digo de Verifica o da NF e Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 20 tpChaveRPS Tipo que define a chave identificadora de um RPS Nome do Elemento Tipo do
40. a Tabela de Alertas disponibilizada pela Prefeitura de S o Paulo tpCodigoVerificacao C digo de Verifica o da NF e C digo de verifica o da NF e gerado pelo Sistema de Notas Fiscais Eletr nicas tpComplementoEndereco Complemento do Endere o 0 30 tpCPF N mero no Cadastro de Pessoas F sicas tpDescricaoEvento Descri o do Evento 0 300 Descri o correspondente ao c digo do evento ocorrido tpDiscriminacao Discrimina o dos Servi os 0 2000 Texto cont nuo descritivo dos servi os O conjunto de caracteres correspondentes ao c digo ASCII 13 e ASCII 10 dever ser substitu do pelo caracter pipe ou barra vertical ASCII 124 Exemplo Digitado na NF Lavagem de carro com lavagem de motor Preenchimento do arquivo Lavagem de carrojcom lavagem de motor N o devem ser colocados espa os neste campo para completar seu tamanho m ximo devendo o campo ser preenchido apenas com conte do a ser processado armazenado Este campo impresso num ret ngulo com 95 caracteres largura e 24 linhas altura E permitido n o recomend vel o uso de mais de 2000 caracteres Caso seja ultrapassado o limite de 24 linhas o conte do ser truncado durante a impress o da Nota tpEmail E mail 0 75 tpInscricaoEstadual Inscri o Estadual 1 19 tplnscricaoMunicipal Inscri o Municipal
41. a mensagem XML ao Web Service com o pedido do servi o desejado O pedido de servi o ser atendido na mesma conex o todos os servi os ser o s ncronos O processamento do pedido do servi o conclu do na mesma conex o com a devolu o de uma mensagem XML contendo o retorno do processamento do servi o pedido O diagrama a seguir ilustra o fluxo conceitual de comunica o entre o sistema do contribuinte e o Sistema de Notas Fiscais Eletr nicas da Prefeitura de S o Paulo s Contribuintesssuuuuuunuunm mamy Secretaria Municipal de FiNangaS assar snnn nenn E k Prefeitura de S o Paulo e e Sistema de Emiss o de Web Service E a E RPS e Transa es E Sistema de transmiss o i i E da mensagem XML E 4 r 5 e af a O e a CETTE EEE TERRE Ed t Css nos O Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 7 3 2 PADR ES T CNICOS 3 2 1 Padr o de Comunica o A comunica o entre os sistemas de informa es dos contribuintes e o Sistema de Notas Fiscais de Servi os Eletr nicas da Prefeitura de S o Paulo ser baseada em um Web Service disponibilizado no Sistema de Notas Fiscais de Servi os Eletr nicas O meio f sico de comunica o utilizado ser a Internet com o uso do protocolo SSL que al m de garantir um duto de comunica o seguro na Internet permite a identifica o do servidor e do cliente atrav s de certificados
42. ador Opcionalmente as Mensagens XML de consulta de NF e Emitidas NF e Padr o de certificado digital Recebidas e Informa es de lote podem ser assinadas pelo contador desde que cadastrado na tela de Configura es do Perfil do Contribuinte ou por um terceiro ex funcion rio da empresa contribuinte desde que o contribuinte tenha concedido a este permiss o de acesso a consultas atrav s do menu Gerenciamento de Usu rios do Sistema de Notas Fiscais Eletr nicas Neste caso o certificado digital utilizado dever conter o CPF CNPJ do contador usu rio autorizado Para autentica o utilizar o certificado digital do respons vel pela transmiss o XML Digital Signature Enveloped com certificado digital X 509 vers o 3 com chave privada de 1024 bits A1 A3 ou 2048 bits A4 com padr es de criptografia assim trica RSA algoritmo message digest SHA 1 e utiliza o das transforma es Enveloped e C14N Padr o de assinatura digital Ser validado al m da integridade e autoria a cadeia de confian a com a Valida o de assinatura digital valida o das LCRs Campos n o obrigat rios do Schema que n o possuam conte do ter o suas tags suprimidas na mensagem XML i M scara de n meros decimais e datas est o definidas no Schema XML Padr es de preenchimento XML a HE PRN i Nos campos num ricos inteiro n o incluir a v rgula ou ponto decimal Nos campos num ricos com ca
43. alDeducoes tpValor 0 1 Valor total das dedu es dos RPS contidos na mensagem XML Tipo que representa uma NF e Nome do Elemento Tipo do Elemento Ocorr ncia Descri o Assinatura tpAssinatura 0 1 Assinatura do RPS que gerou a NF e conforme especificado no Item 4 3 2 ChaveNFe tpChaveNFe 1 1 Chave de identifica o da NF e ver detalhes na tabela tpChaveNFe DataEmissaoNFe dateTime 1 1 Data Hora da emiss o da NF e AAAA MM DDThh mm ss NumeroLote tpNumero 0 1 N mero do lote que gerou a NF e ChaveRPS tpChaveRPS 0 1 Chave de identifica o do RPS ver detalhes na tabela tpChaveRPS TipoRPS tpTipoRPS 0 1 Tipo do RPS DataEmissaoRPS date 0 1 Data da emiss o do RPS CPFCNPJPrestador tpCPFCNPJ 1 1 CPF CNPJ do prestador RazaoSocialPrestador tpRazaoSocial 1 1 Nome Raz o Social do prestador EnderecoPrestador tpEndereco 1 1 Endere o do prestador Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 21 EmailPrestador tpEmail 0 1 E mail do prestador StatusNFe tpStatusNFe 1 1 Status da NF e DataCancelamento date 0 1 Se a NF e tiver sido cancelada este campo ser preenchido com a data de cancelamento da NF e AAAA MM DDThh mm ss TributacaoNFe tpTributacaoNFe 1 1 Tipo de tributa o da NF e OpcaoSimples tpOpcaoSimples 1 1 Tipo d
44. corr x y onde x indica a ocorr ncia m nima e y a ocorr ncia m xima Para obter a vers o mais recente dos Schemas XML acesse o link a NFS e emitidas at 22 02 2015 https nfe prefeitura sp gov br ws schemas zip b NFS e emitidas a partir de 23 02 2015 https nfe prefeitura sp gov br ws schemasV02 zip 4 3 2 Envio de RPS Secretaria Municipal de Finan as P LLLI 7 habbo bebendo LLELLE ILERE 7 Ea Ci Prefeitura de S o Paulo k naContribuintos2s E E a Web Service H 5 LoteNFe x Processamento eni i Envio do RPS EnvioRPS Proc do Pedido RPS E Sistema de Reto des preron CENODEO TEU a TILL LILI LILI LILI tem Qapsnnansansansanpsrsanna t I Descri o Este m todo respons vel por atender aos pedidos de Envio Individual de RPS para substitui o por NF e Il M todo EnvioRPS HI Mensagem XML O par metro MensagemXML ver item 4 3 1 dever ser preenchido conforme tabela a seguir Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 25 PedidoEnvioRPS xsd o TAG de grupo das G informa es do cabe alho Vers o do XML Schema Utilizado CNPJ do autorizado a Cabecalho Versao tpVersao CNPJRemetente Remetente tpCPFCNPJ transmitir a mensagem XML P2 Recibo Provis rio de Servi o Signature Assinatura digital da SignatureType Signature o elemento raiz de mensagem XML uma
45. de casas decimais do campo owp Tabelas de tipos simples DESCRI O TIPO NOME DO TIPO tipo utilizado para BASE TAMANHO DEC OBSERVA O informar Exemplo 5 0 05 Ali Val l i N 4 tpAliquota alor da al quota do servi o 3 5 2 5 0 025 1 75 0 0175 Cadeia de caracteres com ib s inat ra Assinatura digital de NF e Base64 informa es do RPS emitido P RPS Binary assinada conforme descrito no item 4 3 2 f A Cadeia de caracteres com infssnaniaCencalam iia Assinatura Digital de Base64 informa es do RPS emitido P Cancelamento de NF e Binary assinada conforme descrito no item 4 3 10 Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 16 NOME DO TIPO DESCRI O tipo utilizado para informar TIPO BASE TAMANHO DEC OBSERVA O tpBairro Bairro do endere o 0 30 Bairro tpoCEP CEP do endere o 7 8 CEP tpCidade C digo da cidade do endere o O c digo informado dever pertencer Tabela de Munic pios do IBGE disponibilizada pela Prefeitura de S o Paulo tpoCNPJ N mero no Cadastro Nacional da Pessoa Jur dica tpCodigoServico C digos de Servi o O c digo informado dever pertencer Tabela de Servi os disponibilizada pela Prefeitura de S o Paulo tpCodigoEvento C digo do Evento 3 4 O c digo informado dever pertencer a Tabela de Erros ou
46. de fato uma string O WSDL especifica o que a mensagem XML de pedido deve conter e como vai ser a mensagem XML de retorno em uma nota o n o amb gua A nota o que o arquivo WSDL usa para descrever o formato das mensagens baseada no padr o XML o que significa que uma linguagem de programa o neutra e baseada em padr es o que a torna adequada para descrever as interfaces dos Web services que s o acess veis por uma grande variedade de plataformas e linguagens de programa o Al m de descrever o conte do das mensagens o WSDL define onde o servi o est dispon vel e quais protocolos de comunica o s o usados para conversar com o servi o Isso significa que o arquivo WSDL define tudo que necess rio para escrever um programa que utilize o XML Web service H v rias ferramentas dispon veis para ler o arquivo WSDL e gerar o c digo para comunicar com o XML Web service A documenta o do WSDL pode ser obtida na internet acessando o endere o do Web Service do Sistema de Notas Fiscais de Servi os Eletr nicas da Prefeitura de S o Paulo Para obter o WSDL do Web Service da NF e acione o navegador Web Firefox Internet Explorer por exemplo e digite o endere o a seguir https nfe prefeitura sp gov br ws lotenfe asmx WSDL Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 15 4 2 TIPOS UTILIZADOS A seguir s o apresentados os tipos Simples e Complexos utilizados nos Schemas XML de pedido
47. dos na montagem da cadeia de caracteres est o em negrito lt ChaveRPS gt lt InscricaoPrestador gt 31000000 lt InscricaoPrestador gt lt SerieRPS gt 0L03 lt SerieRPS gt lt NumeroRPS gt 1 lt NumeroRPS gt p g 26 Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 27 lt ChaveRPS gt lt TipoRPS gt RPS M lt TipoRPS gt lt DataEmissao gt 2007 01 03 lt DataEmissao gt lt StatusRPS gt N lt StatusRPS gt lt TributacaoRPS gt T lt TributacaoRPS gt lt ValorServicos gt 20500 lt ValorServicos gt lt ValorDeducoes gt 5000 lt ValorDeducoes gt lt CodigoServico gt 2658 lt CodigoServico gt lt AliquotaServicos gt 0 05 lt AliquotaServicos gt lt ISSRetido gt false lt ISSRetido gt lt CPFCNPJTomador gt lt CPF gt 13167474254 lt CPF gt lt CPFCNPJTomador gt lt CPFCNPJIntermediario gt lt CNPJ gt 09999999000106 lt CNPJ gt lt CPFCNPJIntermediario gt lt InscricaoMunicipalIntermediario gt 99999999 lt InscricaoMunicipalIntermediario gt lt ISSRetidoIntermediario gt true lt ISSRetidoIntermediario gt Com base no trecho da mensagem XML apresentada montamos a seguinte string de caracteres 310000000L03 00000000000120070103TNN000000002050000000000000500000026581000131674742542099999990001065 Note que o valor dos servi os R 20 500 00 foi transformado em 2050000 o valor de dedu es R 5 000 00 foi transformado em 500000 Tamb m foi acrescentado s rie do RPS um espa o
48. e Chave da NF e e Assinatura de Cancelamento refeito etetele ot teleao y s asssss 553 33555533335355553335355533 assanssssan eee te s Eesssetsssastsssessssta SS e t CAGOELEDSLESBLLLLSBACLSSDOLCESLLSSELLSCEGLLSLSCCSSLLLCESDECSSSEACLaSnaR l Descri o Este m todo respons vel por atender aos pedidos referentes ao cancelamento de NF e geradas a partir do m todo EnvioLoteRPS II M todo CancelamentoNFe III O par metro MensagemXML ver item 4 3 1 dever ser preenchido conforme tabela a seguir PedidoCancelamentoNFe xsd Campo Descri o Ele Pai Tipo Ocorr Observa o TAG de grupo das P1 Cabecalho informa es do G 1 1 cabe alho Vers o do XML Versao A P1 tpVersao 1 1 Schema Utilizado P CNPJ do Remetente AE RIRI autorizado a enviar a E P1 tpoCPFCNPJ 1 1 mensagem XML True As NF e s ser o canceladas se n o ocorrer nenhum evento de erro durante o processamento de todo o lote l False As NF e spas a Transacao far o parte de uma E P1 Boolean 0 1 serem canceladas ser o Z canceladas mesmo que mesma transa ag ocorram eventos de erro durante processamento do cancelamento de outras NF e deste lote Default true Tag de grupo das P2 Detalhe informa es de G 1 50 detalhe ChaveNFe Chave da NF e E P2 tpChaveNFe 1 1 Assinatura de AssinaturaCanc tpAssinaturaCa elamento RR E
49. e op o pelo Simples NumeroGuia tpNumero 0 1 N mero da guia vinculada a NF e DataQuitacaoGuia Date 0 1 Data de quita o da guia vinculada a NF e ValorServicos tpValor 1 1 Valor dos servi os em R ValorDeducoes tpValor 0 1 Valor das dedu es em R ValorPIS tpValor 0 1 Valor da reten o do PIS em R ValorCOFINS tpValor 0 1 Valor da reten o do COFINS em R ValorINSS tpValor 0 1 Valor da reten o do INSS em R ValorlR tpValor 0 1 Valor da reten o do IR em R ValorCSLL tpValor 0 1 Valor da reten o do CSLL em R CodigoServico tpCodigo 1 1 C digo do servi o prestado AliquotaServicos tpAliquota 1 1 Al quota do servi o prestado ValoriSS tpValor 1 1 Valor do ISS em R ValorCredito tpValor 1 1 Valor do cr dito gerado ISSRetido Boolean 1 1 Reten o do ISS Preencher com true para NF e com ISS Retido false para NF e sem ISS Retido CPFCNPJTomador tpoCPFCNPJ 0 1 CPF CNPJ do tomador InscricaoMunicipalTomador tplnscricaoMunicipal 0 1 Inscri o Municipal do tomador InscricaoEstadualTomador tplnscricaoEstadual 0 1 Inscri o Estadual do tomador RazaoSocialTomador tpRazaoSocial 0 1 Nome Raz o Social do tomador EnderecoTomador tpEndereco 0 1 Endere o do tomador EmailTomador tpEmail 0 1 E mail do tomador CPFCNPJlIntermediario toCPFCNPJ 0 1 CPF CNPJ do intermedi rio InscricaoMunicipalintermediari tpInscricaoMunicipal 0 1 Ra no i a 5 Inscri o Municipal do intermedi rio ISSRetidolntermediario Boolean 0 1
50. eletr nico em raz o de ultrapassado o prazo permitido C D E 338 RPS n o poder ser enviado novamente A NFS e 0 n o p de ser cancelada C D E 342 Campo CEP inv lido C D E CNPJ do Tomador de Servi os inv lido d gitos verificadores n o conferem 343 C D E 505 CNPJ do Intermedi rio de Servi os inv lido d gitos verificadores n o conferem C D E 506 E mail do intermedi rio do servi o inv lido C D E 508 O c digo de servi o 0 n o permite que o ISS seja retido pelo Intermedi rio C D E 509 Intermedi rio n o possui inscri o municipal C D E Inscri o Municipal do Intermedi rio especificada no arquivo n o confere com o CNPJ 511 informado GDE Inscri o do Intermedi rio de Servi os n o encontrada na base de dados de CCM do CDE 513 munic pio D 514 CNPJ do Intermedi rio 0 possui mais de uma inscri o municipal C D E Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 49 C digo Descri o Onde Ocorre 516 C digo de Servi o Prestado 0 n o permite a identifica o do intermedi rio do servi o C D E Para NFS e sem identifica o do intermedi rio a NFS e dever ser emitida sem reten o ou CDE 519 com reten o pelo tomador per 1100 O CNPJ do usu rio autorizado a enviar a mensagem XML n o confere com o CNPJ usado na CDEFGHIJKL comunica o 1101 Tama
51. elo sistema H Prazo de validade de cada LCR utilizada verificar data inicial e final A forma de confer ncia da LCR pelo Sistema de Notas Fiscais de Servi os Eletr nicas da Prefeitura de S o Paulo pode ser feita de 2 duas maneiras On line ou Download peri dico As assinaturas digitais das mensagens ser o verificadas considerando o hor rio fornecido pelo Observat rio Nacional 3 2 5 Resumo dos Padr es T cnicos A tabela a seguir resume os principais padr es de tecnologia utilizados CARACTER STICA DESCRI O Padr o definido pelo WS I Basic Profile 1 1 VED Services http www wsi org Profiles BasicProfile 1 1 2004 08 24 html TEER aa Web Service disponibilizados pelo Sistema de NF e da Prefeitura de S o Meio l gico de comunica o Paulo Meio f sico de comunica o Internet Protocolo Internet SSL vers o 3 0 com autentica o m tua atrav s de certificados digitais Padr o de troca de mensagens SOAP vers o 1 2 Padr o da mensagem XML XML no padr o Style Encoding Document Literal wrapped X 509 vers o 3 emitido por Autoridade Certificadora credenciada pela Infra estrutura de Chaves P blicas Brasileira ICP Brasil do tipo A1 A3 ou A4 devendo conter o CNPJ do propriet rio do certificado digital Para assinatura de mensagens utilizar o certificado digital do estabelecimento emissor da NF e no caso de Consulta de NF e Recebidas utilizar o certificado digital do tom
52. forma es G do cabe alho Vers o do XML Versao o A P1 tpVersao 1 1 Schema Utilizado P1 Cabecalho Sucesso Status do cancelamento E P1 tpSucesso 1 1 Informa es sobre a ocorr ncia de eventos geradores de P2 Alerta alertas durante o G tpEvento 0 N processamento da mensagem XML Informa es sobre a ocorr ncia de eventos geradores de erros G durante o processamento da mensagem XML P3 Erro tpEvento O N Representa o da estrutura definida no schema XML RetornoCancelamentoNFe xsd O Sistema da NF e verificar se a NF e existe e se n o h nenhum impedimento para o cancelamento O cancelamento poder ser realizado para v rias notas numa mesma mensagem XML Obedecendo ao limite de 50 V Formato das Mensagens SOAP Pedido lt xml version 1 0 encoding utf 8 gt lt soap Envelope xmlns xsi http www w3 org 2001 XMLSchema instance xmins xsd http www w3 org 2001 XMLSchema xmins soap http schemas xmlsoap org soap envelope gt lt soap Body gt lt Cance lamentoNFeRequest xmlns http www prefeitura sp gov br nfe gt lt VersaoSchema gt 1 lt VersaoSchema gt lt MensagemXML gt INCLUIR AQUI A MENSAGEM XML CONFORME ITEM III lt MensagemXML gt lt CancelamentoNFeRequest gt lt soap Body gt lt soap Envelope gt Retorno lt xml version 1 0 encoding utf 8 gt lt soap Envelope xmlns xsi http www w3 0rg 2001 XMLSchema instance
53. himento 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 Na gera o das mensagens XML excetuados os campos identificados como obrigat rios no respectivo Schema XML n o incluir as TAGs de campos zerados para campos tipo num rico ou vazios para campos tipo caractere 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 caractere ASCII 13 tab caractere de espa o entre as TAGs 3 4 5 Tratamento de caracteres especiais no texto de XML Todos os textos de uma mensagem XML passam por uma an
54. iara E P1 tpCPFCNPJ 1 1 mensagem XML N mero do Lote a ser NumeroLote consultado E P1 tpNumero 141 Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 39 PedidoConsultaLote xsd Signature o elemento raiz de uma assinatura XML Este elemento descrito no arquivo xmldsig coreschema _v01 xsd Assinatura digital da P2 Signature mensagem XML G SignatureType 1 1 Representa o da estrutura definida no schema XML PedidoConsultaLote xsd IV Schema da Mensagem XML do Retorno RetornoConsulta xsd Id ntico ao do item 4 3 5 V Formato das Mensagens SOAP Pedido lt xml version 1 0 encoding utf 8 gt lt soap Envelope xmlns xsi http www w3 0org 2001 XMLSchema instance xmins xsd http www w3 org 2001 XMLSchema xmins soap http schemas xmlsoap org soap envelope gt lt soap Body gt lt ConsultaLoteRequest xmlns http www prefeitura sp gov br nfe gt lt VersaoSchema gt 1 lt VersaoSchema gt lt MensagemXML gt INCLUIR AQUI A MENSAGEM XML CONFORME ITEM III lt MensagemXML gt lt ConsultaLoteRequest gt lt soap Body gt lt soap Envelope gt Retorno lt xml version 1 0 encoding utf 8 2 gt lt soap Envelope xmlns xsi http www w3 org 2001 XMLSchema instance xmins xsd http www w3 org 2001 XMLSchema xmins soap http schemas xmlsoap org soap envelope gt lt soap Body gt lt ConsultaLoteResponse xm
55. ibuinte 5 O sistema do contribuinte recebe a mensagem XML de retorno e encerra a conex o 3 4 PADR O DAS MENSAGENS XML A especifica o adotada para as mensagens XML a recomenda o W3C para XML 1 0 dispon vel em www w3 org TR REC xml e a codifica o dos caracteres ser em UTF 8 3 4 1 Valida o da estrutura das Mensagens XML Para garantir minimamente a integridade das informa es prestadas e a correta forma o das mensagens XML o contribuinte dever submeter cada uma das mensagens XML de pedido de servi o para valida o pelo seu respectivo arquivo XSD XML Schema Definition defini o de esquemas XML antes de seu envio Neste manual utilizaremos a nomenclatura Schema XML para nos referir a arquivo XSD Um Schema XML define o conte do de uma mensagem XML descrevendo os seus atributos elementos e a sua organiza o al m de estabelecer regras de preenchimento de conte do e de obrigatoriedade de cada elemento ou grupo de informa o A valida o da estrutura da mensagem XML realizada por um analisador sint tico parser que verifica se a mensagem XML atende as defini es e regras de seu respectivo Schema XML Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 11 Qualquer diverg ncia da estrutura da mensagem XML em rela o ao seu respectivo Schema XML provoca um erro de valida o do Schema XML Neste caso o conte do da mensagem XML de pedido do servi o n o poder ser
56. io de Lote de RPS TesteEnvioLoteRPS vem Secretaria Municipal de Finan as a emmnesemeerenmeromemy s Prefeitura de S o Paulo e l esteemnLote RPS Proc Ez pose Contriiginta nu mea nem mn a LLET Processamento do Pedido Sistema de m e PR spuer ouou sounsouomosuouusu0psoonsusnsupuppononsnsnnB Envio de lote de RPS Lote de RPS pAUNVENUVANUNEPENINN Inennennennantentartanmas ai 4 Stinmnnns emn EEE a 4 l Descri o Este m todo respons vel por atender aos pedidos de Teste de Envio de Lote de RPS para substitui o por NF e Este m todo n o substitui os RPS por NF e Observa o Conforme informado no item 2 3 este m todo dever ser usado apenas na fase de adapta o dos sistemas dos contribuintes Nos casos de sistemas j adaptados seu uso resulta em duplicidade de esfor os desnecess rios pois as verifica es feitas no m todo TesteEnvioLoteRPS s o as mesmas realizadas pelo m todo EnvioLoteRPS II M todo TesteEnvioLoteRPS Ill O par metro MensagemXML ver item 4 3 1 dever ser preenchido conforme tabela apresentada no item V IV Schema da Mensagem XML do Retorno RetornoEnvioLoteRPS xsd Id ntico ao Schema da Mensagem XML do Retorno do item V 4 3 5 Pedido de Consulta de NF e ConsultaNFe Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 32 Contribuinte erre PE toe te eo a Chave Nf e ou RPS t
57. iversas informa es entre elas o n mero do lote processado Com esta interface basta informar o n mero do lote desejado para receber informa es resumidas data hora de envio do lote quantidade de notas processadas tempo de processamento etc Para ter informa es das notas processadas deve se usar a interface de Consulta de Lote 2 9 CANCELAMENTO DE NF E Com esta interface os prestadores de servi os poder o cancelar as NF e emitidas por ele informando apenas os n meros da NF e que dever o ser cancelados 2 10 CONSULTA DE CNPJ Esta interface possibilita aos tomadores e ou prestadores de servi os consultarem quais Inscri es Municipais CCM est o vinculadas a um determinado CNPJ e se estes Contribuintes j emitem NF e Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 6 3 ARQUITETURA DE COMUNICA O 3 1 MODELO CONCEITUAL O Web Service do Sistema de Notas Fiscais Eletr nicas da Prefeitura de S o Paulo ir disponibilizar as seguintes funcionalidades Envio de RPS Envio de Lote de RPS Teste de Envio de Lote de RPS Consulta de NF e Consulta de NF e Recebidas Consulta de NF e Emitidas Consulta de Lote TIommo ou gt Consulta de Informa es de Lote Cancelamento de NF e Consulta de CNPJ Existir um nico Web Service com todos os servi os apresentados acima O fluxo de comunica o sempre iniciado pelo sistema do contribuinte atrav s do envio de um
58. lns http www prefeitura sp gov br nfe gt lt RetornoXML gt MENSAGEM XML DE RETORNO CONFORME ITEM IV lt RetornoXML gt lt ConsultaLoteResponse gt lt soap Body gt lt soap Envelope gt 4 3 9 Pedido de Informa es do Lote ConsultalnformacoesLote Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 40 Secretaria Municipal de Finan as Pi TT Prefeitura de S o Paulo EAR SE EEE SEA e i Web Services X E LoteNFe P Consulta Informa es Lote ConsultalnformacoesLote roc do Pedido N mero Sistema de do Lote A NF e eee e e ne a una Dnsmasnssnananasasnssnanansnas nana a a assasssraana E trenunnansenanasannanaif Mtnaaanaranansansanacnsaasannansanncnnannanncancnnannanensnanncnnannasaf Descri o Este m todo respons vel por atender aos pedidos de Consulta de Informa es de Lote de NF e geradas a partir do m todo EnvioLoteRPS M todo ConsultalnformacoesLote O par metro MensagemXML ver item 4 3 1 dever ser preenchido conforme tabela a seguir Pedidolnforma esLote xsd Campo Descri o Ele Pai Tipo Ocorr Observa o TAG de grupo das P1 Cabecalho informa es do G 1 1 cabe alho Vers o do XML Versao A P1 tpVersao 1 1 Schema Utilizado P CNPJ do Remetente CNPJRemetente Jutorizado a enviar E P1 tpCPFCNPJ 1 1 a mensagem XML Caso n o seja A informado o n mero do NumeroLote dba E a E
59. memto Prefeitura de S o Paulo e CPF CNPJ f Web Services LoteNFe Inscri o Consulta NF e Emitidas ConsultaNFeEmitidas do Pedido do Prestador Sistema de NF e Per odo e AE Retorno P gina CTTU gt DR eae a s Cigsnnansnssnnanssnanan sans nn nas O A t h onnassrnsanieasarnanat ETETETT TETTETETT TETT TETTETETT a l Descri o Este m todo respons vel por atender aos pedidos de consulta de NF e Emitidas Il M todo ConsultaNFeEmitidas Ill O par metro MensagemXML id ntico ao Schema da Mensagem XML de pedido apresentado no item 4 3 6 III IV Schema da Mensagem XML do Retorno RetornoConsulta xsd Id ntico ao do item 4 3 5 V Formato das Mensagens SOAP Pedido lt xml version 1 0 encoding utf 8 gt lt soap Envelope xmlns xsi http www w3 0org 2001 XMLSchema instance xmins xsd http www w3 0org 2001 XMLSchema xmins soap http schemas xmlsoap org soap envelope gt lt soap Body gt lt ConsultaNFeEmitidasRequest xmlns http www prefeitura sp gov br nfe gt lt VersaoSchema gt 1 lt VersaoSchema gt lt MensagemXML gt INCLUIR AQUI A MENSAGEM XML CONFORME ITEM III lt MensagemkXML gt lt ConsultaNFeEmitidasRequest gt lt soap Body gt lt soap Envelope gt Retorno Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 38 lt xml version 1 0 encoding utf 8 gt lt soap
60. ne da E Ra ncelamento ig e Signature o elemento raiz E o de uma assinatura XML Este Assinatura digital da E P3 Signature mensagem XML G SignatureType 1 1 elemento descrito no arquivo xmldsigcore schema _v01 xsd Representa o da estrutura definida no schema XML PedidoCancelamentoNFe xsd Observa o 1 Transa o Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 43 Se ocorrerem eventos de erro de valida o dos dados do cabe alho do pedido de cancelamento de NF e independente da op o informada no campo Transa o nenhuma NF e ser cancelada Observa o 2 Assinatura Adicional Cada NF e a ser cancelada representada pela TAG ChaveNFe dever ter sua respectiva assinatura de cancelamento Esta assinatura utilizar o mesmo certificado digital usado na assinatura da mensagem XML item 3 2 2A com os mesmos padr es de criptografia assim trica RSA e algoritmo message digest SHA Para criar a assinatura dever ser gerado um Hash utilizando SHA1 de uma cadeia de caracteres ASCII com informa es da NF e a ser cancelada Este Hash dever ser assinado utilizando RSA A assinatura do Hash ser informada na TAG AssinaturaCancelamento A cadeia de caracteres a ser assinada dever conter 20 posi es com as informa es apresentadas na tabela a seguir Informa o Conte do Inscri o Municipal do Prestador com 8 posi es d gitos Comple
61. nho da mensagem XML ultrapassou o limite m ximo permitido de 500 Kbytes C D E F G H LJ K L 1102 Mensagem XML de Pedido do servi o sem conte do C D E F G H LJ KL 1105 Lote n o encontrado IJ 1106 NF e n o encontrada F O CPF CNPJ da assinatura da mensagem XML n o corresponde ao CPF CNPJ do Prestador 1107 C D E H J de Servi os 1108 O CPF CNPJ vinculado ao Inscricao do Tomador n o corresponde ao CPF CNPJ informado no CDE campo CPFCNPJTomador 2 1109 CPF CNPJ inv lido C D E G H L 1201 S permitido o envio de RPS emitidos por um nico Prestador de Servi os mesma inscri o DE municipal 1202 Prestador de Servi os n o encontrado no Cadastro Municipal CCM D E 1203 Total de RPS n o confere com o enviado lt total de RPS enviados no arquivo gt D E 1204 Valor Total de Servi os n o confere com o enviado lt somat rio do valor dos servi os DE presentes no arquivo gt 1205 Valor Total de Dedu o n o confere com o enviado lt somat rio do valor das dedu es DE presentes no arquivo gt 3 1206 Assinatura Digital do RPS incorreta C D E 1207 Prestador de Servi os n o autorizado a emitir NF e C D E 1212 NFS e n o permite indica o de imunidade CCM do prestador n o cadastrado por meio do CDE sistema de declara o de imunidades SDI para a data do fato gerador informada o 1213 NFS e n o permite indica o de imunidade C digo de servi o informado na NFS e n o cadastrado por meio do sistema de declara
62. nsagem XML CNPJ do contribuinte P2 CNPJContribuinte que se deseja E tpCPFCNPJ 1 1 consultar Signature o elemento raiz de uma assinatura XML Este elemento descrito no arquivo xmldsigcore schema_v01 xsd Assinatura digital da G P3 Signature mensagem XML SignatureType l Representa o da estrutura definida no schema XML PedidoConsultaCNPJ xsd IV Schema da Mensagem XML do Retorno RetornoConsultaCNPJ xsd RetornoConsultaCNPJ xsd Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 46 RetornoConsultaCNPJ xsd Campo Descri o Ele Pai Tipo Ocorr Observa o TAG de grupo das informa es _ E R P1 Cabecalho do cabe alho G 1 1 Vers o do XML Versao GiS A P1 tpVersao 1 1 Schema Utilizado Sucesso Status do cancelamento E P1 tpSucesso 1 1 Informa es sobre a ocorr ncia de eventos geradores de P2 Alerta alertas durante o G tpEvento 0 N processamento da mensagem XML Informa es sobre a ocorr ncia ven rador rr P3 EMO de eventos geradores de erros G durante o processamento da tpEvento ON mensagem XML P4 Detalhe TAG de grupo das informa es G _ ON do detalhe InscricaoMunici Inscri o Municipal vinculada E P4 tpInscricaoMuni 1 1 pal ao CNPJ consultado cipal EmiteNFe Campo que indica se o E P4 Boolean 1 1 contribuinte emite NF e Representa o da estrutura definida no schema XM
63. nsultado Obs As NF e encontradas s o ordenadas por data de emiss o da nota ou data do cancelamento caso a NF e tenha sido cancelada e pela inscri o municipal CCM do prestador que emitiu a nota Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 36 Abaixo fluxo de funcionamento baseado no exemplo descrito di pf ah UGNNNES EEGGS EGUNNES ENGNESS DOCE GENES ESSE Web Bernice LotoNFa ERR E E Retoma P g 2 49 NF e Retoma P g 3 37 NF e TANDO E DUROS FONABPONTRSL sonans sosanson sess sonanson snasos senna nan J IV Schema da Mensagem XML do Retorno RetornoConsulta xsd Id ntico ao do item 4 3 5 i ETTET V Formato das Mensagens SOAP Pedido Retorno Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 37 lt xml version 1 0 encoding utf 8 gt lt soap Envelope xmlns xsi http www w3 0org 2001 XMLSchema instance xmins xsd http www w3 org 2001 XMLSchema xmins soap http schemas xmlscap org soap envelope gt lt soap Body gt lt ConsultaNFeRecebidasResponse xmlns http www prefeitura sp gov br nfe gt lt RetornoXML gt MENSAGEM XML DE RETORNO CONFORME ITEM IV lt RetornoXML gt lt ConsultaNFeRecebidasResponse gt lt soap Body gt lt soap Envelope gt 4 3 7 Pedido de Consulta de NF e Emitidas ConsultaNFeEmitidas Secretaria Municipal de Finan as Contribuintes re P idiaal ecreereereecereere
64. ntos abaixo est o presentes dentro do Certificado do contribuinte tornando desnecess ria a sua representa o individualizada na mensagem XML Portanto a mensagem XML n o deve conter os elementos lt X509SubjeciName gt lt X509IssuerSerial gt lt X509lIssuerName gt lt X509SerialNumber gt lt X509SKI gt Analogamente as TAGs abaixo n o dever o ser informadas pois as informa es ser o obtidas a partir do Certificado do emitente lt KeyValue gt lt RSAKeyValue gt lt Modulus gt lt Exponent gt Para o processo de assinatura o contribuinte n o deve fornecer a Lista de Certificados Revogados j que a mesma ser montada e validada pelo Sistema de Notas Fiscais de Servi os Eletr nicas da Prefeitura de S o Paulo A assinatura digital do documento eletr nico dever atender aos seguintes padr es adotados A Padr o de assinatura XML Digital Signature utilizando o formato Enveloped http www w3c org TR xmldsig core B Certificado digital Emitido por AC credenciada no ICP Brasil http Avww w3c org 2000 09 xmldsigtX509Data C Cadeia de Certifica o EndCertOnly Incluir na assinatura apenas o certificado do usu rio final D Tipo do certificado A1 A3 ou A4 o uso de HSM recomendado E Tamanho da Chave Criptogr fica Compat vel com os certificados A1 e A3 1024bits ou A4 2048 bits F Fun o criptogr fica assim trica RSA http www w3c org 2000 09 xmldsig rsa sha1
65. ntribuinte ou por um terceiro ex funcion rio da empresa contribuinte desde que o contribuinte tenha concedido a este permiss o de acesso a consultas atrav s do menu Gerenciamento de Usu rios do Sistema de Notas Fiscais Eletr nicas Neste caso o certificado digital utilizado dever conter o CPF CNPJ do contador usu rio autorizado Todas as mensagens XML dever o conter o CPF CNPJ de quem estar autorizado a efetuar a sua transmiss o TAG CPFCNPJRemetente No caso de as Mensagens XML serem transmitidas por quem as gerou o CPF CNPJ informado dever ser o do pr prio B Autentica o na transmiss o das mensagens entre os servidores do contribuinte e da Prefeitura de S o Paulo O certificado digital utilizado para identificar essa fun o dever conter o CPF CNPJ do respons vel pela transmiss o das mensagens Este CPF CNPJ dever ser o mesmo que consta na TAG CPFCNPJRemetente da mensagem XML Adicionalmente os certificados digitais tamb m poder o ser exigidos conforme a necessidade espec fica de cada servi o exemplo itens 4 3 2 e 4 3 10 Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 8 3 2 3 Padr o de Assinatura Digital As mensagens enviadas ao Sistema de Notas Fiscais de Servi os Eletr nicas da Prefeitura de S o Paulo s o documentos eletr nicos elaborados no padr o XML e devem ser assinados digitalmente utilizando certificado digital descrito no item 3 2 2 Os eleme
66. o por m foi informado CDE endere o de fora do munic pio lt cidade UF gt Re 1301 NF e j cancelada em lt data de cancelamento gt K 1302 NF e em duplicidade na mensagem XML enviada K 1405 N o h nenhuma Inscri o Municipal vinculada ao CPF CNPJ informado L 5 Arquivos de Exemplos Para obter exemplos das mensagens XML para todos os pedidos e retornos acesse a NFS e emitidas at 22 02 2015 https nfe prefeitura sp gov br ws exemplos zip b NFS e emitidas a partir de 23 02 2015 https nfe prefeitura sp gov briws exemplosVO2 zip Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 51 Anexo TABELA DE MUNIC PIOS Os campos de c digos de munic pios devem ser informados com a utiliza o da Tabela de Munic pios mantida pelo IBGE
67. ocation xmldsig core schema v0l xsd gt lt xs element name PedidoEnviocLoteRPS gt lt xs annotation gt lt xs documentation gt Schema utilizado para PEDIDO de envio de lote de RPS lt xs documentation gt lt xs documentation gt Este Schema XML utilizado pelos prestadores de servi os para substitui o em lote de RPS por NF e lt xs documentation gt lt xs annotation gt lt xs complexType gt lt xSs sequence gt lt xs element name Cabecalho min0ccurs 1 maxOccurs 1 gt lt xs annotation gt lt xs documentation gt Cabe alho do pedido lt xs documentation gt lt xs annotation gt lt xs complexType gt lt xs sequence gt lt xs element name CPFCNPJRemetente type tipos tpCPFCNPJ min0ccurs 1 maxOccurs 1 gt lt xs annotation gt lt xs documentation gt Informe o CPF CNPJ do Remetente autorizado a transmitir a mensagem XML lt xs documentation gt lt xs annotation gt lt xs element gt lt xs element name transacao type xs boclean minOccurs 1 maxOccurs 1 gt lt xs annotation gt lt xs documentation gt Informe se os RPS a serem substitu dos por NF e far o parte de uma mesma transa o True Os RPS s ser o substitu dos por NF e se n o ocorrer nenhum evento de erro durante o processamento de todo o lote False Os RPS v lidos ser o substitu dos por NF e mesmo que ocorram eventos de erro durante processamento de outros RPS deste lote lt xs documentation gt lt xs annotation gt
68. pons vel por atender aos pedidos de Envio de Lote de RPS para substitui o por NF e Il M todo EnvioLoteRPS HI O par metro MensagemXML ver item 4 3 1 dever ser preenchido conforme tabela a seguir PedidoEnvioLoteRPS xsd P1 Cabecalho TAG de grupo das informa es do cabe alho Versao Vers o do XML Schema Utilizado CNPJRemetente CNPJ do Remetente autorizado a transmitir a tpCPFCNPJ boolean 0 1 True Os RPS s ser o substitu dos por NF e se n o ocorrer nenhum evento de erro mensagem XML Transacao Informe se os RPS a serem substitu dos por NF e far o parte de uma mesma transa o dtinicio Data de in cio do per odo O fumo CT dtFim Data final do per odo PO transmitido QtdRPS Quantidade de RPS contidos o um ValorTotalServicos Valor total dos servi os dos O premio ValorTotalDeducoes Valor total das dedu es dos RR RPS Cupom contidos no lote P2 PPS Recibo Provis rio de Servi o P3 Signature Assinatura digital da mensagem XML durante o processamento de todo o lote False Os RPS v lidos ser o substitu dos por NF e mesmo que ocorram eventos de erro durante processamento de outros RPS deste lote Default true ER sc A DS SignatureType Signature o elemento raiz de uma assinatura XML Este elemento descrito no arquivo xmldsig core schema v01 xsd tpQuantidade tpValor tpValor Manual de Utiliza o Web Service Vers o do Manual
69. processado A primeira condi o para que a mensagem XML seja validada com sucesso que ela seja submetida ao Schema XML correto Assim os sistemas de informa o dos contribuintes devem estar preparados para gerar mensagens XML em seus respectivos Schemas XML em vigor 3 4 2 Schemas XML arquivos XSD O Schema XML arquivo XSD correspondente a cada uma das mensagens XML de pedido e de retorno utilizadas pelo Web Service LoteNFe pode ser obtido na internet acessando o Portal do Sistema de Notas Fiscais Eletr nicas da Prefeitura de S o Paulo Para obter os Schemas XML do Web Service da NF e acione o navegador Web Firefox Internet Explorer por exemplo e digite o endere o a seguir a NFS e emitidas at 22 02 2015 https nfe prefeitura sp gov br ws schemas zip b NFS e emitidas a partir de 23 02 2015 https nfe prefeitura sp gov br ws schemasVO2 zip 3 4 3 Vers o dos Schemas XML Toda mudan a de layout das mensagens XML do Web Service implica na atualiza o do seu respectivo Schema XML A identifica o da vers o dos Schemas XML ser realizada com o acr scimo do n mero da vers o no nome do arquivo XSD precedida da literal v como segue PedidoEnvioLoteRPS v02 xsd Schema XML de Envio de Lote de RPS vers o 2 RetornoEnvioLoteRPS v0S xsd Schema XML do Retorno de Envio de Lote de RPS vers o 3 TiposNFe v01 xsd Schema XML dos tipos b sicos da NF e vers o 1 A maioria dos Schemas XML definidos para
70. s e a quantidade de RPS enviados na mensagem XML de pedido do servi o Para pedidos de envio de lote de RPS sem transa o Transacao False o campo InformacoesLote retornar dentre outras informa es o total dos servi os o total das dedu es e a quantidade de RPS que efetivamente foram substitu dos por NF e V Formato das Mensagens SOAP Pedido Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 31 lt xml version 1 0 encoding utf 8 gt lt soap Envelope xmlns xsi http www w3 0org 2001 XMLSchema instance xmins xsd http www w3 org 2001 xXMLSchema xmins socap http schemas xmlscap org soap envelope gt lt soap Body gt lt EnvioLoteRPSRequest xmins http www prefeitura sp gov br nfe gt lt VersaoSchema gt 1 lt VersaoSchema gt lt MensagemXML gt INCLUIR AQUI A MENSAGEM XML CONFORME ITEM III lt MensagemXML gt lt EnvioLoteRPSRequest gt lt soap Body gt lt soap Envelope gt Retorno lt xml version 1 0 encoding utf 8 gt lt soap Envelope xmlns xsi http www w3 org 2001 XMLSchema instance xmins xsd http www w3 org 2001 XMLSchema xmins soap http schemas xmlsocap org soap envelope gt lt soap Body gt lt EnvioLoteRPSResponse xmlns http www prefeitura sp gov br nfe gt lt RetornoXML gt MENSAGEM XML DE RETORNO CONFORME ITEM IV lt RetornoXML gt lt EnvioLoteRPSResponse gt lt soap Body gt lt soap Envelope gt 4 3 4 Teste de Env
71. sas decimais utilizar o ponto decimal na separa o da parte inteira Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 10 3 3 MODELO OPERACIONAL Como dito anteriormente a forma de processamento dos pedidos de servi os do Web Service do Sistema de Notas Fiscais de Servi os Eletr nicas da Prefeitura de S o Paulo ser s ncrona atendo ao pedido de servi o na mesma conex o 3 3 1 Servi os Os pedidos de servi os s o processados imediatamente e o resultado do processamento obtido em uma nica conex o Abaixo o fluxo simplificado de funcionamento Secretaria Municipal de Finan as 3 Retomo de Processamento see Contribuinte e ge Profeitura de S o Paulo Ai E F H o Po do Son mtesoden o Sistema Transmissor a i Processamento E daMensagens XML 5 H do Servi o i OEA OAGENCAADRARHA COS CRNGRAS NARGAGEECOADRADHA LOGBENCHADNADHA EABENCOGDNANNANHA tan Po i E i i E i EM 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 NFe 3 O sistema da NF e recebe a mensagem XML de pedido do servi o e realiza o processamento devolvendo uma mensagem XML de retorno ao Web Service 4 O Web Service recebe a mensagem XML de retorno e a encaminha ao sistema do contr
72. servi o InscricaoMunicipalintermediari tpInscricaoMunicipa 0 1 Inscri o Municipal do intermedi rio o I ATEN O 1 Este elemento s dever ser preenchido para intermedi rios estabelecidos no munic pio de S o Paulo CCM Ser verificado se o CNPJ vinculado ao CCM corresponde ao CNPJ informado no elemento CPFCNPJIntermediario ISSRetidolIntermediario Boolean 0 1 true para NF e com ISS Retido pelo Intermedi rio false para NF e sem reten o pelo Intermedi rio Caso o Intermedi rio n o seja identificado essa tag n o Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 23 dever ocorrer Emailntermediario tpEmail 0 1 E mail do intermedi rio Discriminacao tpDiscriminacao 141 Discrimina o dos servi os ValorCargaTributaria tpValor 0 1 Valor da carga tribut ria total em R PercentualCargaTributaria tpPercentualCargaT 0 1 Valor percentual da carga tribut ria ributaria FonteCargaTributaria tpFonteCargaTribut 0 1 Fonte de informa o da carga tribut ria aria CodigoCEI tpNumero 0 1 C digo do CEI Cadastro espec fico do INSS MatriculaObra tpNumero 0 1 No momento n o deve ser informado Aguarde previs o de obrigatoriedade na legisla o municipal MunicipioPrestacao tpCidade 0 1 C digo do munic pio onde ocorreu a presta o do servi o conforme tabela de C digos de Munic pios elaborada pelo IBGE 4 3 SERVI OS E M TODOS
73. sion 1 0 encoding utf 8 gt lt soap Envelope xmlns xsi http www w3 org 2001 XMLSchema instance xmins xsd http www w3 org 2001 XMLSchema xmins soap http schemas xmlsocap org soap envelope gt lt soap Body gt lt EnvioRPSRequest xmins http www prefeitura sp gov br nfe gt lt VersaoSchema gt 1 lt VersaoSchema gt lt MensagemXML gt INCLUIR AQUI A MENSAGEM XML CONFORME ITEM III lt MensagemXML gt lt EnvioRPSRequest gt lt soap Body gt lt soap Envelope gt Retorno lt xml version 1 0 encoding utf 8 gt lt soap Envelope xmins xsi http www w3 0rg 2001 XMLSchema instance xmins xsd http www w3 org 2001 XMLSchema xmins soap http schemas xmlsoap org soap envelope gt lt soap Body gt lt EnvioRPSResponse xmlins http www prefeitura sp gov br nfe gt lt RetornoXML gt MENSAGEM XML DE RETORNO CONFORME ITEM IV lt RetornoXML gt lt EnvioRPSResponse gt lt soap Body gt lt soap Envelope gt 4 3 3 Envio de Lote de RPS EnvioLoteRPS Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 29 E Sccrctaria Municipal de Finan as quina s ci smsesnsnsnnnsnnnsunnnnnnnnnnnnn nnp am Pa PDA s Prefeitura de S o Paulo ssemContribuinte ma Web Service 3 f H H e L Fa Processamento Envio de lote de RPS ESS Enviol ERES Proc do Pedido H Lots de RPS H H Sistema de aa a D j P R a J4 I Descri o Este m todo res
74. srsesssrisserressrreessrreene 31 4 3 5 Pedido de Consulta de NF e ConsultaNFe sss sssssnsssssansnssesinssrrensssrasssrrssnrirssrrenssrreansrrsserressrrenssreenne 31 4 3 6 Pedido de Consulta de NF e Recebidas ConsultaNFeRecebidas ciiiieeeerreeeenreees 33 4 3 7 Pedido de Consulta de NF e Emitidas ConsultaNFeEmitidas s assssnnessnsoesnnsssrenssssesssrrssnrressrreesssseene 37 4 3 8 Pedido de Consulta de Lote ConsultaLote cc is ieeerreeeeerreeeraaeeeaearere ae aerea na aeeenaareraea 38 4 3 9 Pedido de Informa es do Lote ConsultalnformacoesLote cciiirieeeereeeereeeeeenreraes 39 4 3 10 Pedido de Cancelamento de NF e CancelamentoNFe ccc ii iiieeereeeeeerreeeeereeeareraes 41 4 3 11 Pedido de Consulta de CNPJ ConsultaCNP J sseee ie rrreeeereeeee ee ere ae ereeeenareeenenteraea 44 4 4 TABE A DE ERROS E ALERTAS assis aerea pesam a nar upa sera e DA Sena Nat na E eae A DES S 46 GARRA A POR C O Esp PR RO RR RP O ROTA RI PERNA E DEPARO URI Re RE RARA E RUA RR RA 47 VADE N a E ssa EEA EAE TA du TU eos NaN pd DUO E EA US nd Eh 50 53 ARQUIVOS DE EXEMPLOS essas sa oscssasotete ssa cons aasie Cazes tacar e iT ad c da Danado du ira c clans advir Cosac dana a RSS 50 ANEXO Va ER E E ERREI R RR PR DES IR ER SRA ER RR ED DAR RR SER ER 51 TABELA DE MUNIC PIOS ssa aso pisa a GO E E da pd TA 51 Manual de Utiliza o Web Service Vers o do Man
75. ta interface destina se aos prestadores que desejam emitir NF e ofline e em grandes volumes 2 3 TESTE DE ENVIO DE LOTE DE RPS O uso desta interface opcional A interface de Envio de Lote de RPS faz exatamente as mesmas verifica es entretanto na interface de Teste nenhuma NF e gerada Esta interface dever ser usada apenas na fase de adapta o dos sistemas dos contribuintes Nos casos de sistemas j adaptados seu uso resulta em duplicidade de esfor os desnecess rios 2 4 CONSULTA DE NF E Esta interface permite os prestadores de servi os consultarem as NF e emitidas por ele 2 5 CONSULTA DE NF E RECEBIDAS Esta interface possibilita aos tomadores e ou prestadores de servi os consultarem as NF e que tiverem sido emitidas para ele possibilitando por exemplo a alimenta o autom tica de seu m dulo de contas a pagar 2 6 CONSULTA DE NF E EMITIDAS Esta interface possibilita aos prestadores de servi os consultarem as NF e que tiverem sido emitidas por ele 2 7 CONSULTA DE LOTE Ap s o envio bem sucedido de um Lote de RPS o Web Service retorna diversas informa es entre elas o n mero do lote processado Com esta interface basta informar o n mero do lote desejado para receber as informa es de todas as NF e geradas neste lote Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 5 2 8 CONSULTA INFORMA ES DO LOTE Ap s o envio bem sucedido de um Lote de RPS o Web Service retorna d
76. tance xmins xsd http www w3 org 2001 XMLSchema xmins soap http schemas xmlsoap org soap envelope gt lt soap Body gt lt ConsultaNFeResponse xmlns http www prefeitura sp gov br nfe gt lt RetornoXML gt MENSAGEM XML DE RETORNO CONFORME ITEM IV lt RetornoXML gt lt ConsultaNFeResponse gt lt soap Body gt lt soap Envelope gt 4 3 6 Pedido de Consulta de NF e Recebidas ConsultaNFeRecebidas Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 34 Contribuinte ree artrnnensusussusunuuseuuuunsuuuusuununuy CPF CNPJ do Tomador Per oda e P gina L e s Consulta NF e Recebidas Retorno qe cf Prefeitura de S o Paulo Web Services LoteNFe ConsultaNFeRecebidas Secretaria Municipal de Finan as querer rece nenrenena gt D Proc do Pedido Sistema de D NF e 4 Descri o Este m todo respons vel por atender aos pedidos de consulta de NF e Recebidas M todo ConsultaNFeRecebidas O par metro MensagemXML ver item 4 3 1 dever ser preenchido conforme tabela a seguir PedidoConsultaNFePeriodo xsd Campo Descri o Ele Pai Tipo Ocorr Observa o P1 Cabecalho TAG de grupo das informa es do cabe alho G 1 1 Versao Vers o do XML Schema Utilizado P1 tpVersao 1 1 CPFCNPJRemet ente CPF CNPJ do
77. tar com 1 Inscri o Municipal do Pr r A E se scri o Municipal do Prestado zeros esquerda caso seja necess rio N mero da NF e com 12 posi es d gitos Completar com zeros 2 N mer NF Sa mero da e esquerda caso seja necess rio Passos b sicos para assinatura de cancelamento de uma NF e e Monte a string de caracteres conforme a tabela a apresentada anteriormente A seguir apresentamos o exemplo de um trecho de uma mensagem XML de pedido de cancelamento de NF e os campos utilizados na montagem da cadeia de caracteres est o em negrito lt ChaveNFe gt lt InscricaoPrestador gt 31000000 lt InscricaoPrestador gt lt NumeroNFe gt 9 lt NumeroNFe gt lt ChaveNFe gt Com base no trecho da mensagem XML apresentada montamos a seguinte String de caracteres 31000000000000000009 2 Converta a cadeia de caracteres ASCII para bytes 3 Gere o HASH array de bytes utilizando SHA1 e Assine o HASH array de bytes utilizando RSA SHA1 ATEN O Na maioria das linguagens de programa o os passos 3 e 4 s o feitos atrav s de uma nica fun o Verifique a documenta o de sua linguagem para evitar assinar um hash de um hash IV Schema da Mensagem XML do Retorno RetornoCancelamentoNFe xsd RetornoCancelamentoNFe xsd Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 44 Campo Descri o Ele Pai Tipo Ocorr Observa o TAG de grupo das in
78. tation gt lt xs documentation gt Informe a Vers o do Schema XML utilizado lt xs documentation gt lt xs annotation gt lt xs attribute gt lt xs complexType gt lt xs element gt lt xs element name RPS type tipos tpRPS min0ccurs 1 maxOccurs 50 gt lt xs annotation gt lt xs documentation gt Informe os RPS a serem substituidos por NF e lt xs documentation gt lt xs annotation gt lt xs element gt lt xs element ref ds Signature min0Occurs 1 maxOccurs 1 gt lt xs annotation gt lt xs documentation gt Assinatura digital emissor dos RPS lt xs documentation gt lt xs annotation gt lt xs element gt lt xs sequence gt lt xs complexType gt lt xs element gt lt xs schema gt Manual de Utiliza o Web Service Vers o do Manual 2 4 1 p g 13 As modifica es de layout das mensagens XML do Web Service podem ser causadas por necessidades t cnicas ou em raz o da modifica o de alguma legisla o As modifica es decorrentes de altera o da legisla o dever o ser implementadas nos prazos previstos no ato normativo que introduziu a altera o As modifica es de ordem t cnica ser o divulgadas pela Prefeitura de S o Paulo e poder o ocorrer sempre que se fizerem necess rias 3 4 4 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 preenc
79. ual 2 4 1 p g 4 1 INTRODU O Este manual tem como objetivo apresentar a defini o das especifica es e crit rios t cnicos necess rios para utiliza o do Web Service disponibilizado pela Prefeitura de S o Paulo para as empresas prestadoras e ou tomadoras de servi os Por meio do Web Service as empresas poder o integrar seus pr prios sistemas de informa es com o Sistema de Notas Fiscais de Servi os Eletr nicas da Prefeitura de S o Paulo Desta forma consegue se automatizar o processo de emiss o consulta e cancelamento de NF e 2 INTERFACES DISPON VEIS Por meio do Web Service o Sistema de Notas Fiscais de Servi os Eletr nicas da Prefeitura de S o Paulo disponibiliza uma s rie de interfaces que poder o ser acessadas pelos sistemas dos contribuintes A seguir est o resumidas as interfaces dispon veis e suas respectivas funcionalidades b sicas 2 1 ENVIO DE RPS Atrav s desta interface os prestadores de servi os poder o enviar um RPS emitido por seu sistema para que seja substitu do por uma Nota Fiscal Eletr nica Esta interface destinasse aos prestadores que desejam emitir NF e online e individualmente Para emiss es de grandes volumes recomendamos a utiliza o da interface Envio de Lote de RPS 2 2 ENVIO DE LOTE DE RPS Atrav s desta interface os prestadores de servi os poder o enviar lotes de RPS emitidos por seus sistemas para que sejam substitu dos por Notas Fiscais Eletr nicas Es
Download Pdf Manuals
Related Search
Related Contents
Genesis GAPCS203 Use and Care Manual カタログ - 昭和電線ホールディングス Nokia 5800 XpressMusic Bedienungsanleitung manual de instrucciones manual de instruções INSTRUTHERM - Criffer Instrumentos de Medição optimis ide Breadman TR888 Bread Maker User Manual ASSEMBLING AND OPERATING INSTRUCTIONS WWW.FAST-TRADE.BIZ FRSKY TFR6 FUTABA 2.4GHz FASST互換 Copyright © All rights reserved.
Failed to retrieve file