Escolar Documentos
Profissional Documentos
Cultura Documentos
ELETRNICA (NFS-e)
Manual de Utilizao
WebService
Verso 2.0
Nota Fiscal de Servio
Eletrnica NFS-E
SUMRIO
1. INTRODUO ........................................................................................................ 3
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.
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/
Neste passo necessitamos criar um certificado de browser, ou seja, clique no link (Web
Browser Certificate).
Alguns dados pessoais sero solicitados como mostrado abaixo:
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:
Aps confirmar a solicitao do certificado, ir aparecer uma tela para que possamos instalar
o certificado digital em nossa mquina, como mostrado a seguir:
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).
Na tela que ser exibida, selecionar menu Arquivo > Adicionar/remover snap-in.
*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
*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
* Clicar em Concluir
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).
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.
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.
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).
Logo em seguida, clique no boto (Copiar para arquivo). Onde ser apresentada a seguinte
tela:
Clique no boto Avanar, e ser mostrada a tela abaixo, onde deve ser marcada a opo:
(Sim, exportar a chave particular).
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:
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.
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.
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.
<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>
<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>
<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>
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
Desta forma, garantiremos que o arquivo a ser validado pegue todas as informaes dos
schemas de validao dos dados.
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:
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