Você está na página 1de 30

NOTA FISCAL DE SERVIO

ELETRNICA (NFS-e)

Manual de Utilizao
WebService

Verso 2.0
Nota Fiscal de Servio
Eletrnica NFS-E

SUMRIO

1. INTRODUO ........................................................................................................ 3

2. CRIANDO UM CERTIFICADO DIGITAL ................................................................ 3

2.1. ATUALIZANDO O CERTIFICADO RAIZ DO COMPUTADOR.......................... 6

3. VINCULANDO UM CERTIFICADO DIGITAL AO ISS CURITIBA ....................... 14

3.1. AMBIENTE PILOTO ......................................................................................... 14

3.2. AMBIENTE DE PRODUO ........................................................................... 15

4. EXPORTANDO O CERTIFICADO PARA UM ARQUIVO .................................... 17

5. INTERFACES DISPONVEIS NO WEBSERVICE ................................................ 22

5.1 RECEPO DE LOTE DE RPS .............................................................................. 22

5.2 CONSULTA A SITUAO DE LOTE DE RPS ....................................................... 22

5.3 CONSULTA DE LOTE DE RPS............................................................................... 22

5.4 CONSULTA NOTA FISCAL DE SERVIOS ELETRNICA POR RPS ......... 22

5.5 CONSULTA NOTA FISCAL DE SERVIOS ELETRNICA ........................... 23

5.6 VALIDAO BSICA DO LOTE DE RPS....................................................... 23

5.7 CANCELAMENTO DE LOTE DE NFS-E ......................................................... 23

5.8 CANCELAMENTO DE LOTE DE RPS ............................................................. 23

6. PADRES TCNICOS ......................................................................................... 23

6.1 PADRO DE CERTIFICADO DIGITAL ............................................................ 23

6.2 ASSINATURA EM UM LOTE DE RPS ................................................................... 24

6.2.1 ASSINANDO UM LOTE DE RPS ......................................................................... 24

6.3. SCHEMAS XML ..................................................................................................... 27

7. WEBSERVICE NFS-E ........................................................................................... 28

7.1. WSDL ................................................................................................................ 28

7.2. TIPOS UTILIZADOS ......................................................................................... 28

7.3. REALIZANDO UMA CHAMADA A UM MTODO DO WEBSERVICE ........... 28

7.4. REALIZANDO A VALIDAO BSICA DO ARQUIVO DE LOTE DE RPS .. 29

8. ARQUIVOS DE EXEMPLO ................................................................................... 29

9. RESUMO LINKS ................................................................................................... 29

Manual de Utilizao WebService Pgina 2 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

1. Introduo
Este manual tem por objetivo explicar como criar e utilizar um certificado digital em ambiente
piloto, a fim de realizar os testes com o WebService e auxiliar na configurao do ambiente para
realizar as operaes em ambiente de produo.

2. Criando um certificado digital


Para dar incio a criao do certificado digital (em ambiente piloto) deve-se:

Caso a verso do navegador Internet Explorer utilizado seja inferior a 10, utilizar o endereo:

http://pilotoisscuritiba.curitiba.pr.gov.br:8080/certsrv/

Caso a verso do navegador Internet Explorer utilizado seja igual ou superior a 10, utilizar o
endereo:
https://pilotoisscuritiba.curitiba.pr.gov.br:8081/certsrv/

Tal endereo ir apresentar a seguinte tela:

Para criarmos o nosso certificado de testes clique em (Request a certificate).


Clicando no link acima o sistema ir apresentar a seguinte tela:

Neste passo necessitamos criar um certificado de browser, ou seja, clique no link (Web
Browser Certificate).
Alguns dados pessoais sero solicitados como mostrado abaixo:

Manual de Utilizao WebService Pgina 3 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

Para que possamos criar um certificado vlido (em ambiente piloto), necessrio clicar no
link (More Options >>) aps, selecionado apresentar a seguinte tela:

Ao carregar a pgina mostrada acima, deveremos clicar no link (use the Advanced Certificate
Request form), pois necessitamos marcar uma opo para tornar a chave pblica exportvel.
Ser apresentada a seguinte tela:

Manual de Utilizao WebService Pgina 4 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

Preencha os dados do formulrio conforme modelo mostrado acima.


Selecione a opo (Mark Keys as exportable), como mostrado abaixo.

Deixe selecionada apenas a opo (Mark Keys as exportable).


A opo (Export Keys to file) no dever ser marcada.
Aps os dados serem preenchidos, clique no boto (submit). Ir aparecer uma tela de
confirmao conforma mostrado abaixo:

Manual de Utilizao WebService Pgina 5 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

Aps confirmar a solicitao do certificado, ir aparecer uma tela para que possamos instalar
o certificado digital em nossa mquina, como mostrado a seguir:

Clicando no link (Install this certificate) ir aparecer a seguinte tela de confirmao:

Confirmando a instalao de nosso certificado digital ir aparecer a seguinte tela:

Pronto, agora temos um certificado digital (vlido em ambiente piloto), mas ainda
necessrio vincular o mesmo ao nosso usurio do sistema ISS Curitiba para que o sistema o
reconhea (Conforme mostrado no Tpico 3 deste manual). Mas, antes, vamos atualizar o certificado
raiz do computador que far as requisies para o WebService do ambiente piloto para que no
ocorra erro na requisio da origem para o destino (WebService).

2.1. Atualizando o certificado raiz do computador


Para que a requisio para o WebService seja aceita, necessrio atualizar o certificado raiz
do computador de onde partir a mesma (seu servidor local). Para tanto, basta executar os seguintes
passos no Windows:
Primeiro executar o Microsoft Management Console:

Manual de Utilizao WebService Pgina 6 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

Na tela que ser exibida, selecionar menu Arquivo > Adicionar/remover snap-in.

* Na janela Adicionar/remover snap-in, clicar no boto Adicionar.

Manual de Utilizao WebService Pgina 7 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

* Na janela Adicionar snap-in autnomo, selecionar Certificado e clicar em Adicionar

*Deixar selecionada a opo Minha conta de usurio e clicar em Concluir

Manual de Utilizao WebService Pgina 8 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

*A janela Adicionar/remover snap-in estar atualizada.

Manual de Utilizao WebService Pgina 9 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

*A janela do MMC estar com o seguinte aspecto:

*Agora abaixo da pasta Autoridades de certificao raiz confiveis clicar o boto direito do
mouse na sub-pasta Certificados, selecionar a opo Todas as tarefas > Importar.
*Na tela do assistente de importao clicar em Avanar

Manual de Utilizao WebService Pgina 10 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

*Faa o download do certificado raiz a partir do link do portal Boa Nota Fiscal:
http://isscuritiba.curitiba.pr.gov.br/portalnfse/manuais.aspx
* Acessar os Itens: CERTIFICADO RAZ - SERVIDOR PILOTO - 08/01/2013
CADEIA DE CERTIFICAO - SERVIDOR PILOTO - 08/01/2013
* Salvar os arquivos raizPiloto.zip e certnew_piloto_renew.zip localmente, e extrair os
contedos raizPiloto.cer e certnew_piloto_renew.p7b

> Realizar o procedimento a seguir para os dois arquivos extrados

*Agora selecione o arquivo extrado raizPiloto.cer clicando no boto Procurar e depois em


Avanar.

*Clicar em Avanar (sem alteraes na tela)

Manual de Utilizao WebService Pgina 11 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

* Clicar em Concluir

*Na tela de aviso confirmar clicando em (SIM).

Manual de Utilizao WebService Pgina 12 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

Pronto agora temos um certificado digital (vlido em ambiente piloto), mas ainda necessrio
vincular o mesmo ao nosso usurio do sistema ISS Curitiba para que o sistema reconhea o mesmo.
(Conforme mostrado no Tpico 3 deste manual).

Manual de Utilizao WebService Pgina 13 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

3. Vinculando um Certificado Digital ao ISS Curitiba

3.1. Ambiente Piloto


Aps realizarmos todos os passos descritos anteriormente precisamos vincular o certificado
digital recm criado ao nosso usurio do ISS Curitiba.
Para isso devemos entrar no ISS Curitiba em ambiente (piloto) utilizando HTTPS, ou seja,
utilizando um canal seguro de comunicao, importante ressaltar que a conexo dever utilizar
https, caso contrrio o certificado digital no ser reconhecido pelo servidor.
https://pilotoisscuritiba.curitiba.pr.gov.br/iss/

Ao carregar o endereo acima no navegador, dever aparecer uma caixa de dilogo,


conforme figura abaixo:

Na caixa de dilogo acima iro aparecer todos os certificados digitais vlidos para nossa
entidade certificadora (para ambiente piloto).
Selecione o certificado digital desejado e clique em OK.
Aps selecionar o certificado digital entre no ISS Curitiba utilizando o usurio e senha de
acesso ao mesmo.

IMPORTANTE: Para acesso ao ambiente Piloto, deve-se CRIAR um usurio,


utilizar o mesmo j existente no sistema ISS Curitiba com a senha = 123456.

Manual de Utilizao WebService Pgina 14 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

Uma vez logado no sistema, entre no menu Contribuinte > Certificado Digital > Vincular. Ir
aparecer uma tela de confirmao perguntando se voc realmente deseja vincular seu certificado
digital ao seu usurio do ISS Curitiba, como mostrado na figura abaixo:

Confirme a vinculao clicando em (Sim). Feito isso, ir aparecer uma tela confirmando a
vinculao do certificado, como descrito abaixo:

Depois de realizados tais passos, poder utilizar o WebService para a empresa a qual o
usurio pertence, pois existe um certificado digital vinculado.

3.2. Ambiente de Produo


Para realizar a vinculao do certificado digital do usurio em ambiente de produo deve
acessar o endereo:
https://isscuritiba.curitiba.pr.gov.br/iss
Ao entrar no endereo citado acima, ir aparecer uma caixa de dilogo como a mostrada
abaixo.

Manual de Utilizao WebService Pgina 15 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

Na caixa de dilogo, ir aparecer todos os certificados digitais vlidos abaixo da entidade


certificadora Raiz ICP Brasil.
importante ressaltar que, certificados digitais criados pelo ambiente piloto no sero aceitos
em ambiente de produo.
Selecione o certificado digital desejado e clique em OK.
Aps selecionar o certificado digital, entre no ISS Curitiba utilizando o usurio e senha de
acesso ao mesmo.
Uma vez logado no sistema, entre no menu Contribuinte > Certificado Digital > Vincular. Ir
aparecer uma tela de confirmao perguntando se voc realmente deseja vincular seu certificado
digital ao seu usurio do ISS Curitiba, como mostrado na figura abaixo:

Confirme a vinculao clicando em (Sim).

Manual de Utilizao WebService Pgina 16 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

Feito isso, ir aparecer uma tela confirmando a vinculao do certificado, como descrito
abaixo:

Aps realizar os passos descritos acima, o usurio j est apto a utilizar o WebService da
Nota Fiscal de Servios Eletrnica (Boa Nota).

4. Exportando o Certificado para um arquivo


A exportao do certificado digital para um arquivo se d pelo seguinte motivo.
Necessidade de integrao de sistemas legados com o sistema de emisso de NFS-e da
Prefeitura Municipal de Curitiba, onde toda requisio ao WebService necessrio anexar o
certificado digital da empresa prestadora do servio.
Na caixa de dilogo com os certificados digitais instalados em sua mquina, selecione um
certificado e clique no boto (Exibir Certificado).

Ser mostrada a seguinte tela:

Manual de Utilizao WebService Pgina 17 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

Clique na aba (Detalhes).

Logo em seguida, clique no boto (Copiar para arquivo). Onde ser apresentada a seguinte
tela:

Manual de Utilizao WebService Pgina 18 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

Clique no boto Avanar, e ser mostrada a tela abaixo, onde deve ser marcada a opo:
(Sim, exportar a chave particular).

Manual de Utilizao WebService Pgina 19 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

Aparecer uma tela solicitando uma senha para o certificado, tal senha no necessria,
portanto deixe-a em branco.

Na prxima tela, selecione o nome do arquivo para qual o certificado ser salvo e clique em
(Avanar), como mostra a figura abaixo:

Manual de Utilizao WebService Pgina 20 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

Aps, feito os passos acima, ir aparecer a seguinte tela, onde deve-se clicar no boto
(Concluir).

Na tela, aparecer uma mensagem dizendo que a importao obteve xito, como descrito
abaixo.

Manual de Utilizao WebService Pgina 21 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

5. Interfaces disponveis no WebService

5.1 Recepo de Lote de RPS


Atravs desta interface, os prestadores de servios podero enviar lotes de RPS emitidos em
seus sistemas, para que os mesmos sejam convertidos em Notas Fiscais de Servios Eletrnica.
Destina-se aos prestadores de servios que desejam emitir NFS-e off-line ou em grandes
volumes.

5.2 Consulta a situao de lote de RPS


Aps o envio bem sucedido de um Lote de RPS, o WebService retorna o nmero do Lote de
RPS e o nmero do protocolo de recebimento do lote. Com esta interface, basta informar o nmero
do protocolo para receber a informao sobre o status de processamento do lote que pode ser um
dos seguintes:
No processado;
Processado com erros;
Processado com sucesso.

5.3 Consulta de Lote de RPS


Aps o processamento de um Lote de RPS, possvel consultar todas as informaes sobre
o lote de RPS, tais informaes como o nmero da NFS-e o valor gerado para crdito de abatimento
no IPTU, entre outras informaes.
Para o recebimento das informaes sobre as notas geradas atravs de um lote de RPS,
basta apenas informar o nmero do protocolo de recebimento do Lote de RPS e o WebService ir
retornar todas as informaes sobre as NFS-e geradas.

5.4 Consulta Nota Fiscal de Servios Eletrnica por RPS


Esta interface permite aos prestadores de servios consultarem as NFS-e emitidas por ele,
atravs das informaes do RPS anteriormente emitido pelo prestador.

Manual de Utilizao WebService Pgina 22 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

5.5 Consulta Nota Fiscal de Servios Eletrnica


Esta interface permite aos prestadores de servios consultarem as NFS-e por ele emitidas.

5.6 Validao bsica do lote de rps


Esta interface fornece um meio para o prestador de servios realizar uma pr-validao do
arquivo XML a ser enviado com um Lote de RPS. Tal validao ir garantir que no iro faltar a
informaes bsicas para a converso dos RPS.

5.7 Cancelamento de lote de NFS-e


Esta interface permite aos prestadores de servios cancelarem um Lote de NFS-e, ou seja,
permite o cancelamento de mais de uma NFS-e por vez. Destina-se a prestadores que desejam
cancelar vrias NFS-e de uma nica vez.
Um exemplo do arquivo XML pode ser encontrado em:
http://isscuritiba.curitiba.pr.gov.br/portalNfse/manuais.aspx
No link EXEMPLO XML PARA CANCELAMENTO DE NFS-e.

5.8 Cancelamento de lote de RPS


Esta interface permite aos prestadores de servios cancelarem um Lote de RPS enviado e
processado com sucesso em um momento anterior ao momento da solicitao de cancelamento do
Lote de RPS. Destina-se a prestadores que desejam invalidar algum lote de RPS enviado de forma
incorreta.

6. Padres Tcnicos
A comunicao entre os sistemas dos prestadores de servios e o Sistema de Notas Fiscais
de Servios Eletrnica da Prefeitura Municipal de Curitiba ser baseada em WebService.
O meio fsico de comunicao utilizado ser a Internet, com o uso do protocolo SSL (Socket
Secure Layer), que alm de garantir a segurana das informaes trafegadas atravs da Internet,
permite a identificao do servidor e do cliente atravs de certificados digitais, eliminando a
necessidade do usurio se identificar atravs de usurio e senha.
O modelo de comunicao segue o padro para WebService definido pelo WS-I Basic Profile.
A troca de mensagens entre o WebService do sistema de NFS-e da Prefeitura Municipal de Curitiba
utilizar o protocolo SOAP, com troca de mensagens XML.

6.1 Padro de Certificado Digital


Os certificados digitais utilizados no Sistema de Notas Fiscais de Servios Eletrnica da
Prefeitura Municipal de Curitiba sero emitidos por Autoridade Certificadora credenciada pela Infra-
estrutura de Chaves Pblicas Brasileira ICP Brasil.
Sero aceitos certificados do tipo A1 ou A3, devendo conter o CNPJ do prestador de
servios.

Manual de Utilizao WebService Pgina 23 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

Exclusivamente em ambiente piloto dever ser utilizado certificados digitais oferecidos pelo
prprio ambiente piloto. Vide captulo 1 e 2.
Tais certificados gerados em ambiente piloto no so vlidos para o ambiente de produo.

6.2 Assinatura em um Lote de RPS


Existem 2 (duas) tags que devero ser transmitidas para o WebService e que devem ser
assinadas digitalmente utilizando um certificado digital vlido emitido por uma entidade certificadora
credenciada a ICP Brasil. As tags a serem assinadas digitalmente so (LoteRps e todas as
ocorrncias de InfRps).

6.2.1 Assinando um Lote de RPS


Para realizar a assinatura de uma tag do lote de XML, deve-se considerar todos os valores
contidos dentro da prpria tag, incluindo tambm suas tags filhas.
Por exemplo: Consideremos o seguinte trecho de um lote de RPS, tal trecho representa as
informaes contidas em um RPS.
<Rps>
<InfRps id="1">
<IdentificacaoRps>
<Numero>5</Numero>
<Serie>PMC</Serie>
<Tipo>1</Tipo>
</IdentificacaoRps>
<DataEmissao>2010-08-02T09:08:47</DataEmissao>
<NaturezaOperacao>1</NaturezaOperacao>
<OptanteSimplesNacional>2</OptanteSimplesNacional>
<IncentivadorCultural>2</IncentivadorCultural>
<Status>1</Status>
<Servico>
<Valores>
<ValorServicos>5000.00</ValorServicos>
<ValorDeducoes>1.00</ValorDeducoes>
<ValorPis>1.00</ValorPis>
<ValorCofins>1.00</ValorCofins>
<ValorInss>1.00</ValorInss>
<ValorIr>1.00</ValorIr>
<ValorCsll>1.00</ValorCsll>
<IssRetido>2</IssRetido>
<ValorIss>500.00</ValorIss>
<BaseCalculo>5000.00</BaseCalculo>

Manual de Utilizao WebService Pgina 24 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

<Aliquota>10.00</Aliquota>
<ValorLiquidoNfse>4500.00</ValorLiquidoNfse>
</Valores>
<ItemListaServico>11.1.</ItemListaServico>
<CodigoCnae>6204010</CodigoCnae>
<CodigoTributacaoMunicipio>620401000</CodigoTributacaoMunicipio>
<Discriminacao>PRODUTO SERVICO</Discriminacao>
<CodigoMunicipio>4106902</CodigoMunicipio>
</Servico>
<Prestador>
<Cnpj>76673904000140</Cnpj>
<InscricaoMunicipal>00504532</InscricaoMunicipal>
</Prestador>
<Tomador>
<IdentificacaoTomador>
<CpfCnpj>
<Cpf>99999999999</Cpf>
</CpfCnpj>
</IdentificacaoTomador>
<RazaoSocial>CLIENTE PESSOA FISICA</RazaoSocial>
<Endereco>
<Endereco>RUA DAS FLORES</Endereco>
<Numero>256</Numero>
<CodigoMunicipio>0292740</CodigoMunicipio>
<Cep>13246464</Cep>
</Endereco>
</Tomador>
</InfRps>
<Rps>

Para assinar digitalmente a tag InfRps devemos submeter a tag e todo o seu contedo para o
mtodo que ir realizar a assinatura do RPS. Que aps a sua assinatura ir ficar da seguinte forma.
<Rps>
<InfRps id="1">
<IdentificacaoRps>
<Numero>5</Numero>
<Serie>PMC</Serie>
<Tipo>1</Tipo>
</IdentificacaoRps>
<DataEmissao>2010-03-02T09:08:47</DataEmissao>

Manual de Utilizao WebService Pgina 25 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

<NaturezaOperacao>1</NaturezaOperacao>
<OptanteSimplesNacional>2</OptanteSimplesNacional>
<IncentivadorCultural>2</IncentivadorCultural>
<Status>1</Status>
<Servico>
<Valores>
<ValorServicos>5000.00</ValorServicos>
<ValorDeducoes>1.00</ValorDeducoes>
<ValorPis>1.00</ValorPis>
<ValorCofins>1.00</ValorCofins>
<ValorInss>1.00</ValorInss>
<ValorIr>1.00</ValorIr>
<ValorCsll>1.00</ValorCsll>
<IssRetido>2</IssRetido>
<ValorIss>500.00</ValorIss>
<BaseCalculo>5000.00</BaseCalculo>
<Aliquota>10.00</Aliquota>
<ValorLiquidoNfse>4500.00</ValorLiquidoNfse>
</Valores>
<ItemListaServico>11.1.</ItemListaServico>
<CodigoCnae>6204010</CodigoCnae>
<CodigoTributacaoMunicipio>620401000</CodigoTributacaoMunicipio>
<Discriminacao>PRODUTO SERVICO</Discriminacao>
<CodigoMunicipio>4106902</CodigoMunicipio>
</Servico>
<Prestador>
<Cnpj>76673904000140</Cnpj>
<InscricaoMunicipal>00504532</InscricaoMunicipal>
</Prestador>
<Tomador>
<IdentificacaoTomador>
<CpfCnpj>
<Cpf>27015444836</Cpf>
</CpfCnpj>
</IdentificacaoTomador>
<RazaoSocial>CLIENTE PESSOA FISICA - ISS CAMPINAS</RazaoSocial>
<Endereco>
<Endereco>RUA DAS FLORES</Endereco>
<Numero>256</Numero>
<CodigoMunicipio>0292740</CodigoMunicipio>

Manual de Utilizao WebService Pgina 26 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

<Cep>13246464</Cep>
</Endereco>
</Tomador>
</InfRps>
<Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
<SignedInfo>
<CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-
20010315"></CanonicalizationMethod>
<SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsasha1"></
SignatureMethod>
<Reference URI="#1">
<Transforms>
<Transform Algorithm="http://www.w3.org/2000/09/xmldsig#envelopedsignature"></
Transform>
</Transforms>
<DigestMethod
Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"></DigestMethod>
<DigestValue>sTaMKAIuPQfnU115u/1YFLm9Yog=</DigestValue>
</Reference>
</SignedInfo>
<KeyInfo>
<X509Data>
<X509SubjectName>E=nfse@curitiba.pr.gov.br, CN=Equipe de Desenvolvimento
NFS-e,, O=Secretaria Municipal da Fazenda (Sefaz), L=Curitiba, S=Paran,
C=BR</X509SubjectName>
<X509Certificate>MIIEqjCNONONONONONONONONOhkiG9w0BAQUFADAZMRcwFQYDVQ
QDEw4yMDAuMTg5LjE5Mi4XXXp8OjbyBkYSBFc2NvbGEgSW50ZXJuYWNpb25hbCBkZSBD
</X509Certificate>
</X509Data>
</KeyInfo>
</Signature>
</Rps>

6.3. Schemas XML


Para garantir minimamente a integridade dos arquivos XML, o prestador de servios dever
submeter cada arquivo XML para validao atravs do arquivo com os schemas XML para validao.
Um Schema XML define o contedo de uma mensagem XML, descrevendo os seus atributos,
elementos e a sua organizao, alm de estabelecer regras de preenchimento de contedo e de
obrigatoriedade de cada elemento ou grupo de informao.

Manual de Utilizao WebService Pgina 27 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

O Schema XML poder ser encontrado em:


http://isscuritiba.curitiba.pr.gov.br/iss/nfse.xsd

7. WebService NFS-e
O WebService do Sistema de Notas Fiscais de Servios Eletrnica da Prefeitura Municipal de
Curitiba disponibiliza os servios que sero utilizados pelos sistemas dos prestadores de servios.
O mecanismo de utilizao do WebService segue as seguintes premissas:
Sero disponibilizados vrios mtodos dentro do mesmo WebService, cada um desses
mtodos executando uma funcionalidade especfica.
Alguns servios disponibilizados sero processados de forma assncrona, ou seja, os dados
sero recebidos e sero processados em um momento mais oportuno.

7.1. WSDL
Para que os sistemas de informao dos prestadores de servios saibam quais parmetros
enviar ao WebService e quais parmetros sero retornados, os prestadores devero utilizar a
definio WSDL (Web Service Description Language, linguagem de descrio do servio Web).

A documentao do WSDL para o ambiente piloto pode ser obtida atravs do endereo:
https://pilotoisscuritiba.curitiba.pr.gov.br/nfse_ws/NfseWs.asmx?WSDL

Para o ambiente de produo, dever ser obtido atravs do endereo:


https://isscuritiba.curitiba.pr.gov.br/Iss.NfseWebService/nfsews.asmx?WSDL

IMPORTANTE: O WSDL gerado tanto em ambiente piloto quanto em produo so


idnticos.

7.2. Tipos Utilizados


Para obter a definio de todos os tipos utilizados pelo Sistema de Emisso de Notas Fiscais
de Servios Eletrnica basta acessar o endereo http://isscuritiba.curitiba.pr.gov.br/iss/nfse.xsd.

7.3. Realizando uma chamada a um mtodo do WebService


Para a utilizao do WebService atravs de um sistema de informao de algum prestador de
servios, necessrio anexar a requisio do servio e o certificado digital do prestador de servios.

Manual de Utilizao WebService Pgina 28 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

IMPORTANTE: importante lembra que, para o certificado ser enviado junto a


requisio ao WebService a conexo dever utilizar HTTPS.
Para que o sistema possa reconhecer a empresa, tal certificado deve estar vinculado a um
usurio dentro do sistema ISS Curitiba.

7.4. Realizando a validao bsica do arquivo de lote de rps


Para garantir que o mnimo das informaes exigidas para a converso do Lote de RPS em
Notas Fiscais de Servios Eletrnica, deve-se realizar uma pr-validao do arquivo XML a ser
enviado para processamento.

O elemento raiz do arquivo de Lote de RPS deve ficar da seguinte maneira:


<EnviarLoteRpsEnvio xmlns=http://isscuritiba.curitiba.pr.gov.br/iss/nfse.xsd
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://isscuritiba.curitiba.pr.gov.br/iss/nfse.xsd">

Desta forma, garantiremos que o arquivo a ser validado pegue todas as informaes dos
schemas de validao dos dados.

disponibilizado um programa que realiza tal pr-validao, sem a necessidade de conexo


com o WebService.

O programa est contido junto aos arquivos de exemplo (Vide Captulo 8).

8. Arquivos de Exemplo
Para obter arquivos de exemplo acesse o link:
http://isscuritiba.curitiba.pr.gov.br/iss/arquivos.zip

9. Resumo Links
Abaixo, segue um resumo dos links necessrios para que a empresa configure seu sistema
para emisso de Notas Fiscais Eletrnicas optando pelo modo WebService:

1) Manual de Integrao de Sistemas -


http://isscuritiba.curitiba.pr.gov.br/portalnfse/Manuais/NFSENACIONAL_ManualDeInteg
racao _Curitiba.pdf

Manual de Utilizao WebService Pgina 29 de 30


Nota Fiscal de Servio
Eletrnica NFS-E

2) Manual de Utilizao de Envio Arquivos RPS -


http://isscuritiba.curitiba.pr.gov.br/portalnfse/Manuais/Manual_Layout_Arquiv
o_RPS_Curitiba.pdf

3) Definies de chamadas dos mtodos do WebService em ambiente piloto:


https://pilotoisscuritiba.curitiba.pr.gov.br/nfse_ws/nfsews.asmx

4) Endereo do WebService para ambiente de produo


https://isscuritiba.curitiba.pr.gov.br/Iss.NfseWebService/nfsews.asmx

5) Definio WSDL do WebService em ambiente piloto:


https://pilotoisscuritiba.curitiba.pr.gov.br/nfse_ws/nfsews.asmx?wsdl

6) Definio WSDL do WebService em ambiente de produo:


https://isscuritiba.curitiba.pr.gov.br/Iss.NfseWebService/nfsews.asmx?wsdl

7) Schema XSD para validao do XML:


http://isscuritiba.curitiba.pr.gov.br/portalnfse/manuais.aspx no link Arquivos XML
Exemplo.

8) O endereo da rea de testes (piloto) :


http://pilotoisscuritiba.curitiba.pr.gov.br/iss/

9) O endereo do ambiente de produo : http://isscuritiba.curitiba.pr.gov.br/iss

10) Modelo XML para recepo de lote RPS em ambiente piloto:


http://isscuritiba.curitiba.pr.gov.br/portalnfse/manuais.aspx
no link Arquivos XML Exemplo.

11) Para testes de envio via WS necessrio criar certificado digital (testes) no
endereo: http://pilotoisscuritiba.curitiba.pr.gov.br:8080/certsrv/

12) Para vincular o certificado (teste) criado ao login do usurio para envio de WS:
https://pilotoisscuritiba.curitiba.pr.gov.br/iss/Principal/frmVincularCertificado
Digital.aspx

13) Certificados raiz para o ambiente PILOTO Utilizao do WebService


http://isscuritiba.curitiba.pr.gov.br/portalnfse/manuais.aspx
* Acessar o Item: CERTIFICADO RAZ - SERVIDOR PILOTO - 08/01/2013

Manual de Utilizao WebService Pgina 30 de 30