Manual Tcnico Sistema de Informaes para Convenentes via Web Service

Verso 1.4

Ficha Tcnica
Ministro da Fazenda Guido Mantega Secretrio da Receita Federal Jorge Antonio Deher Rachid Coordenador-Geral de Tecnologia e Segurana da Informao Vitor Marcos Almeida Machado Coordenador de Tecnologia da Informao Donizetti Victor Rodrigues Coordenador de Sistemas de Informao Maria do Belem Ferraz Chefe da Diviso de Acompanhamento de Contratos e Convnios Lusinlia Borges Analista de Negcios da Cotec Jos Glaucy de Aguiar Rocha Sandra Aparecida de Souza
Serpro

Presidente Marcos Vincius Ferreira Mazoni Diretor Superintendente Gilberto Paganotto Superintendncia de Negcio Andr de Csero Coordenador de Negcio Edenir Lara dos Santos Chefe de Plo Roland Stock Chefe de Projeto Angelo Matias Rodrigues dos Santos Desenvolvimento Equipe ATCPF
Pblico Alvo Este Manual destina-se s equipes de desenvolvimento dos rgos ou entidades que celebrarem convnio com a Secretaria da Receita Federal do Brasil para obteno de informaes via Web Service. _____________________________________________________________________________________
Braslia, 25 de julho de 2008

Histrico de Verses
Data 30/11/2006 Verso 1.0 Descrio Minuta inicial do Manual Tcnico Rerratificao Atualizaes no item 2.3, 2.4, 2.5, 3.4, 5. Includa seo sobre testes e FAQ. Rerratificao da seo referente ao ambiente de testes e FAQ. Atualizao do FAQ com telefone da CAS e recomendao de uso de dois certificados. Includa mensagens do SPED. Incluso dos erros CPF08, CPJ11 e alterao do erro ACS02 Autor
Equipe ATCPF

Revisor Jos Glaucy de Aguiar Rocha Sandra Aparecida de Souza

09/05/2007

1.1

Aprovado por Jos Glaucy de Aguiar Rocha Jos Glaucy de Aguiar Rocha

15/10/2007

1.2

Equipe ATCPF Jos Glaucy de Aguiar Rocha Jos Glaucy de Aguiar Rocha Jos Glaucy de Aguiar Rocha Jos Glaucy de Aguiar Rocha

19/10/2007

1.2

18/04/2008

1.3

Equipe ATCPF

27/06/2008

1.4

Equipe ATCPF

Jos Glaucy de Aguiar Rocha

Jos Glaucy de Aguiar Rocha

INTRODUO ............................................................2 1. 1.1. 1.2. 1.3. 1.4. 2. 2.1. 2.2. SOBRE A TECNOLOGIA WEB SERVICE .....3 Conceito .................................................................3 XML (eXtensible Markup Language) ..............3 SOAP (Simple Object Access Protocol)............4 WSDL (Web Services Description Language).4 SOBRE A CERTIFICAO DIGITAL .............5 Conceito .................................................................5 Uso do Certificado Digital...................................6

4. 4.1. 4.2. 5. 5.1. 5.2. 5.2.1. 5.2.2. 5.2.3. 5.2.4.

SOBRE O AMBIENTE DE TESTES ..............11 Como realizar uma consulta de teste ..............11 Consideraes sobre o ambiente de testes......12 MENSAGENS DE ERRO................................13 Mensagens de Erro na Validao de Acesso..13 Mensagens de Erro do Sistema Acessado.......18 Mensagens de Erro do Sistema CPF ...........18 Mensagens de Erro do Sistema CNPJ.........20 Mensagens de Erro do Sistema SPED-CPF22 Mensagens de Erro do Sistema SPED-CNPJ 23 PERGUNTAS MAIS FREQENTES .............24

2.3. Qual o certificado digital necessrio para utilizar o InfoConv-WS......................................................6 2.4. Como obter o certificado digital eEquipamento........................................................................6 2.5. 3. Fluxo simplificado do processamento ...............7 COMO UTILIZAR O INFOCONV .....................9

6.

6.1. Podemos utilizar um perfil de produo para realizarmos testes? Se sim, seremos tarifados? ............24 6.2. Estamos sem um certificado no momento. Vocs podem fornecer o WSDL sem que seja necessrio buscar na pgina fornecida para acelerar o processo? 24 6.3. Existe algum certificado provisrio para ser utilizado no desenvolvimento das aplicaes p/ acesso ao novo servio? Ou existe alguma alternativa para obter acesso ao WSDL do web Service? ........................25 6.4. Estou obtendo um erro ao tentar acessar o WSDL pelo link fornecido por vocs. Voc sabe me dizer o por qu?.................................................................25 6.5. O que acontece se o meu certificado de eEquipamento no tiver o bit de autenticao ligado? .25

3.1. Celebrar convnio com a RFB e firmar Contrato de Prestao de Servios com o Serpro ..........9 3.2. 3.3. Informar para o Serpro a faixa de IP ...............9 Criar uma aplicao com base no WSDL ......10

3.4. Enviar o certificado e-Equipamento na requisio de consulta ......................................................10 3.5. Informar o CPF do usurio na requisio de consulta ...............................................................................10 3.6. Informar o sistema e perfil de acesso na requisio de consulta ......................................................10

6.6. Qual a documentao necessria para adquirir este certificado?.................................................................26 6.7. Quais as certificadoras habilitadas para emitir o e-Equipamento com o bit de autenticao de cliente ligado? 26 6.8. Quais as certificadoras habilitadas para emitir o e-Equipamento com o bit de autenticao de cliente ligado? 26 6.9. Para determinado perfil do CPF, percebi que pode haver registro com data de nascimento fora do calendrio civil...................................................................26 6.10. Como eu envio o certificado durante a requisio? .........................................................................27 6.11. Onde deve ser instalado o certificado? ...........27

6.12. Como registrar um incidente relacionado ao InfoConv-WS?...................................................................27 6.13. Por que a aplicao estava funcionando e agora estou recebendo o erro 403.13 - Forbidden: Client certificate has been revoked on the Web server? 27

1.2.

1.3.

1.4.

3.6.