Manual do webservice de Inscrição CPF

Transcrição

1 Manual do webservice de Inscrição CPF Versão 1.0

2 P á g i n a 2 Sumário 1. Inscrição CPF XML de entrada de inscrição de CPF XML de retôrno de inscrição de CPF XSD de retôrno de inscrição de CPF Endereços de acesso e regras dos webservices Endereços de acesso: Regras dos webservices:... 6

3 P á g i n a 3 MANUAL DE INSCRIÇÃO DE CPF DA CENTRAL DE INFORMAÇÕES DO REGISTRO CIVIL NACIONAL CRC NACIONAL Versão 1.0 Histórico de versões: Data Versão do Webservice Descrição 01/03/ Elaboração Inicial de acordo com o Convênio ARPENSP e RFB sobre inscrição de CPF. 1. Inscrição CPF Introdução: Solicitação de Inscrição de CPF para a CRC/RFB Modelo Web Service: Por este modelo o sistema próprio do cartório chamará um serviço disponibilizado pela CRC, para ser efetuada a inscrição de CPF junto a RFB. Esse serviço quando consumido realizará a inscição de CPF junto a RFB, passando os seguintes parametros: XML de entrada de Inscrição de CPF <?xml version="1.0" encoding="iso "?> <cpf_gerar> <dnv></dnv> <flag_dnv_ignorada></flag_dnv_ignorada> <data_nascimento></data_nascimento> <data_registro></data_registro> <sexo></sexo> <cod_ibge_cidade_naturalidade></cod_ibge_cidade_naturalidade> <cep></cep> <endereco></endereco> <num_end></num_end> <complemento></complemento> <bairro></bairro> <cod_ibge_cidade_domicilio></cod_ibge_cidade_domicilio> <num_telefone></num_telefone> <num_celular></num_celular> <ddd_celular></ddd_celular> <ddd_telefone></ddd_telefone> <matricula></matricula> <nome_crianca></nome_crianca> <nome_genitora></nome_genitora> <nome_genitor></nome_genitor > <cpf_genitora></cpf_genitora> <cpf_genitor></cpf_genitor > </cpf_gerar>

4 P á g i n a 4 TAG Tamanho Tipo Obrigatório Descrição dnv 11 Numerico Sim Numero de DNV(Declaração de Nascido Vivo) flag_dnv_ignorada 1 Char Sim Deverá ser enviado deste formato S ou N data_nascimento 10 String Sim Deverá ser enviado deste formato DD/MM/YYYY data_registro 10 String Sim Deverá ser enviado deste formato DD/MM/YYYY sexo 1 Char Sim cod_ibge_cidade_naturalidade 7 Numerico Sim Deverá ser enviado deste formato M - Masculuno, F - Feminino, I - Não Definido Deverá ser enviado o Código do Ibge da cidade de naturalidade (mínimo 7 digitos, caso não não tenha acrescentar 0 a esquerda) cep 8 Numerico Sim Deverá ser enviado o CEP do domicílio endereco 40 String Sim Deverá ser enviado o endereço do domicílio num_end 6 Numerico Sim complemento 40 String Não Deverá ser enviado o numero do endereço do domicílio Deverá ser enviado o complemento do endereço do domicílio bairro 40 String Sim Deverá ser enviado o bairro do domicílio cod_ibge_cidade_domicilio 7 Numerico Sim num_telefone 8 Numerico Não num_celular 9 Numerico Não ddd_celular 4 Numerico Não ddd_telefone 4 Numerico Não matricula 32 Numerico Sim Deverá ser enviado o Código do Ibge da cidade do domicílio (mínimo 7 digitos, caso não não tenha acrescentar 0 a esquerda) Deverá ser enviado o numero do telefone contendo somente os numeros Deverá ser enviado o numero do celular contendo somente os numeros Deverá ser enviado o numero do DDD do celular contendo somente os numeros Deverá ser enviado o numero do DDD do telefone contendo somente os numeros Deverá ser enviado o numero de matricula somente numeros nome_crianca 60 String Sim Deverá ser enviado o nome da criança nome_genitora 100 String Sim Deverá ser enviado o nome da genitora nome_genitor 100 String Não Deverá ser enviado o nome do genitor cpf_ genitora 11 Numerico Não Cpf_ genitor 11 Numerico Não Deverá ser enviado o numero de CPF da genitora somente numeros Deverá ser enviado o numero de CPF do genitor somente numeros

5 P á g i n a XML de retôrno de Inscrição de CPF <?xml version="1.0" encoding="iso "?> <cpf_retorno> <erro_cod></erro_cod> <erro_msg></erro_msg> <nome_crianca></nome_crianca> <cpf_gerado></cpf_gerado> <matricula></matricula> <dnv></dnv> <data_nascimento></data_nascimento> <data_registro></data_registro> <nome_genitora></nome_genitora> <nome_genitor></nome_genitor> <cpf_genitora></cpf_genitora> <cpf_genitor></cpf_genitor> </cpf_retorno> TAG Tamanho Tipo Obrigatório Descrição erro_cod 5 Numerico Sim Codigo de erro caso seja a operação foi realizada com sucesso.codigo de erro caso seja foi emitido um erro na aplicação da CRC.Codigo de erro caso seja diferente de e erro aconteceu no sistema da SERPRO. erro_msg 400 String Sim Mensagem de erro emitido pelo sistema da CRC/SERPRO nome_crianca 100 String Sim Nome da criança que foi enviado cpf_gerado 11 Numerico Não CPF Gerado da criança, caso houver algum problema este campo ira retornar 0 matricula 32 Numerico Sim Numero de matricula que foi enviado dnv Numerico Sim Numero de DNV que foi enviado data_nascimento 10 String Sim Data de nascimento que foi enviado data_registro 10 String Sim Data do registro que foi enviado nome_genitora 100 String Não Nome da genitora que foi enviado nome_genitor 100 String Não Nome do genitor que foi enviado cpf_genitora 11 Numerico Não CPF da genitora que foi enviado cpf_genitor 11 Numerico Não CPF do genitor que foi enviado

6 P á g i n a XSD de retôrno de Inscrição de CPF Pode ser baixado em: Homologação: Produção: 2. Endereços de acesso e regras dos webservices 2.1 Endereços de acesso: Homologação O endereço para Inscrição de CPF no ambiente de homologação: Produção (Será disponibilizado depois da homologação) O endereço para Inscrição de CPF no ambiente de produção: Regra do webservice: Para Consumir esse serviço o usuário tem que estar cadastrado na CRC em algum oficio. AUTENTICAÇÃO VIA CERTIFICADO DIGITAL O arquivo XML deverá ser lido em byte array e precisará estar assinado digitalmente, utilizando o seu certificado digital e-cpf para transmissão deve ser do tipo A3, e deverá ter sido emitido por uma Autoridade Certificadora credenciada pela Infraestrutura de Chaves Públicas Brasileira - ICP-Brasil. O serviço de autenticação via certificado digital, e ser enviado formatado em BASE 64. Possuindo as seguinte característica: Certificado do usuário é enviado no cabeçalho do pacote SOAP. Esse certificado contém informações que permitem identificar o usuário e verificar se possui permissão para o envio da solicitação. Para que seja garantido que a formação dos XML esteja correta e que as informações prestadas sejam minimamente validadas, o XML contendo os dados do movimento deve ser submetido a uma validação a partir do XSD. Será feita a validação da assinatura do arquivo como um usuário cadastrado na CRC e com privilégios para execução. NOTA: Esse XML de inscrição de CPF deverá ser assinado em p7s e convertido em byte array e posteriormente converter para Base64.