cadastro xp manual de integração com...

18
V1.0 Cadastro XP Manual de integração com AAIs

Upload: vanque

Post on 12-Nov-2018

218 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Cadastro XP Manual de integração com AAIsportal-rs.xpi.com.br/email/manual_de_integracao_com_aais_v1_1.pdf · um formulário de cadastro integrado automaticamente com o da XP. Para

V1.0

Cadastro XP Manual de integração com AAIs

Page 2: Cadastro XP Manual de integração com AAIsportal-rs.xpi.com.br/email/manual_de_integracao_com_aais_v1_1.pdf · um formulário de cadastro integrado automaticamente com o da XP. Para

Manual de integração – Cadastro XP

2

1. Introdução

O cadastro web da XP Investimentos foi planejado para otimizar o processo cadastral, facilitando a vida do assessor e do cliente final. Veja alguns destaques, abaixo.

Sistema de parametrização completo para o assessor – Desenvolvemos um sistema de parametrização totalmente novo, que possibilita o preenchimento do cadastro externo ao site. Assim, o processo fica muito mais rápido e a captação de clientes facilitada. Com esse novo sistema é possível:

Aproveitar os dados preenchidos pelo cliente no site do seu escritório para que ele

não tenha que repetir as mesmas informações no cadastro XP.

Caso o seu escritório tenha acesso a uma base de dados de cadastros/prospects/mailing, através de parcerias externas, também é possível recuperar estas informações e aproveitá-las na hora do cadastro do cliente.

Realizar campanhas online específicas para o seu escritório, garantindo que os clientes sejam alocados no código de assessor correto.

Fluxo cadastral simplificado, com apenas três passos - Quanto maior o número de passos, menor é a conversão final. Com a otimização do fluxo, eliminando campos desnecessários, tornamos o cadastro mais fácil e mais fluido para o usuário final.

Layout otimizado, seguindo as mais modernas técnicas de usabilidade – Páginas projetadas

para facilitar a leitura, diminuir a rolagem da tela e evitar dúvidas, erros e frustrações do cliente. Além disso, ele está dissociado do site XP, evitando assim a navegação para outras páginas e fuga do processo.

Validação campo a campo, além de textos de ajuda para um preenchimento correto – Com este formato de validação, o cliente sabe em tempo real se inseriu algum dado errado, além de contar com ajudas ao longo do cadastro, nos campos que geram mais dúvidas.

Tudo isso com o objetivo de aumentar a conversão no processo cadastral via site internet.

Page 3: Cadastro XP Manual de integração com AAIsportal-rs.xpi.com.br/email/manual_de_integracao_com_aais_v1_1.pdf · um formulário de cadastro integrado automaticamente com o da XP. Para

Manual de integração – Cadastro XP

3

2. Como funciona

Nesta seção, separamos algumas sugestões de aplicação que ajudarão no dia a dia. Para maior comodidade dos usuários, não existem campos obrigatórios.

a) Parametrização manual

Caso o assessor queira enviar o link do cadastro para um cliente, ou colocar um banner em um site

parceiro, por exemplo, poderá realizar a parametrização manualmente, configurando o seu código de assessor/escritório e/ou plano de corretagem preferido. O procedimento é simples, e está descrito na seção 3 deste manual.

b) Site com formulário

Para deixar o sistema mais fluido possível para o cliente final, agora já é possível ter em seu próprio site um formulário de cadastro integrado automaticamente com o da XP. Para isto, será necessário que um programador faça esta integração, fornecendo um parâmetro específico para cada campo no seu site. Estes parâmetros serão transportados para uma URL no site da XP, que a lerá e preencherá automaticamente as informações em uma página específica do cadastro da corretora. Na prática, o cliente preencherá alguns dados no site do AAI, clicará em ´prosseguir´, e chegará no site da XP, já com os dados preenchidos.

Para garantir a integridade da base de dados e a validação correta das informações não é possível gravar

os dados diretamente na base de dados da XP, por isso é necessário que o cliente passe por todos os passos do cadastro no site da corretora. Devido a essa necessidade, apesar de ser possível enviar qualquer informação constante no cadastro através da URL, não recomendamos esta prática para os casos de preenchimento de formulário. Este tipo de implementação tornaria o cadastro muito longo para o cliente, tendendo a diminuir a eficiência da captação. Para maximizar a conversão, recomendamos que sejam replicados no site do AAI somente as informações que constam no passo 1 do cadastro da XP.

Page 4: Cadastro XP Manual de integração com AAIsportal-rs.xpi.com.br/email/manual_de_integracao_com_aais_v1_1.pdf · um formulário de cadastro integrado automaticamente com o da XP. Para

Manual de integração – Cadastro XP

4

Abaixo temos uma ilustração de como será o fluxo de telas para o cliente final:

c) Integração com bases de dados externas

Caso o seu escritório de AAI tenha uma parceria externa em que o parceiro tenha acesso a uma base de cadastrados online (uma comunidade online, um fórum ou um blog, por exemplo), também é possível aproveitar estes dados aos quais você já tem acesso, para facilitar o preenchimento do cadastro. O funcionamento é similar ao site com formulário, porém o cliente não precisará preencher estas informações, já que elas estão na base de dados do parceiro. Ao se logar, o cliente simplesmente pode optar por abrir uma conta com o AAI, e será direcionado automaticamente para o site da XP, com seus dados preenchidos.

Assim como o modelo de formulário no site, será necessária a intervenção de um programador para esta solução, mas o cadastro da XP já está preparado para receber este tipo de parceria.

Page 5: Cadastro XP Manual de integração com AAIsportal-rs.xpi.com.br/email/manual_de_integracao_com_aais_v1_1.pdf · um formulário de cadastro integrado automaticamente com o da XP. Para

Manual de integração – Cadastro XP

5

3. Integração

A página de cadastro da XP aceita parâmetros de URL para todos os campos do cadastro, conforme

descrito abaixo. Todos os campos são opcionais, porém para que o cliente seja alocado para um assessor ou escritório específico, os parâmetros ´assessor´ ou ‘escritório’ deverão ser implementados obrigatoriamente. No caso do parâmetro ´escritório´, o cliente será alocado no assessor master.

A URL de base para assessores é http://www.xpi.com.br/cadastro/aai/passo1.aspx

Ela deve ser seguida dos ´operadores padrão´ nos casos abaixo: ´?´ - após a URL base, aplicável somente ao primeiro parâmetro ´=´ - para separar o parâmetro de seu valor ´&´ - para separação entre os parâmetros

Por exemplo, uma URL que retorne o nome e o CPF:

http://www.xpi.com.br/cadastro/aai/passo1.aspx?nome=teste joão da silva&cpf=99509478474

Para os escritórios que gostariam de manter seus sites inalterados, seguindo a parametrização atual,

basta utilizar os parâmetros da seguinte maneira: Somente parametrizando o código de assessor:

http://www.xpi.com.br/cadastro/aai/passo1.aspx?assessor=AXXX

Parametrizando o código de assessor e plano de corretagem:

http://www.xpi.com.br/cadastro/aai/passo1.aspx?assessor=AXXX&plano=CV

Veja, abaixo, a tabela com todos os parâmetros possíveis, e suas respectivas descrições e sintaxes aceitas:

PARÂMETRO DESCRIÇÃO nome Nome do cliente (até 60 caracteres) cpf CPF do cliente no formato 99999999999 dataNasc Data de nascimento do cliente no formato AAAAMMDD. O ano não pode ser menor

que 1890 email E-mail do cliente (até 80 caracteres) celular Número do celular do cliente com o DDD no formato DDNNNNNNNN[N]. Onde as

duas primeiras posições (D) contêm o DDD e as 8 (ou 9) seguintes contêm o número telefone Número do telefone do cliente com o DDD no formato DDNNNNNNNN[N]. Onde

as duas primeiras posições (D) contêm o DDD e as 8 (ou 9) seguintes contêm o número

comoConheceuXP Informa como o cliente conheceu a XP. Os valores possíveis são os seguintes: 1 - Indicação de Amigos/Família 2 - Contato Comercial 3 - Quiosque

Page 6: Cadastro XP Manual de integração com AAIsportal-rs.xpi.com.br/email/manual_de_integracao_com_aais_v1_1.pdf · um formulário de cadastro integrado automaticamente com o da XP. Para

Manual de integração – Cadastro XP

6

PARÂMETRO DESCRIÇÃO 4 - Cursos 5 - Palestras e Eventos 6 - Notícias (Ex.: Jornais, Revistas ou Portais) 7 - Anúncios Impressos 8 - E-mail Marketing 9 - Sites de Busca 10 - Redes Sociais, Fóruns ou Chats 11 - Portal InfoMoney

assessor Código do assessor do cliente atribuído no inicio do cadastro escritorio Código do escritório que o cliente será alocado plano Plano de corretagem do cliente. Os valores possíveis são os seguintes:

CF - Plano Express CV - Plano Private CU - Plano Universitário

cep CEP do endereço do cliente no formato 99999999 end Endereço do cliente (rua, avenida, estrada, etc) com até 30 caracteres endNum Número da residência do cliente (até 5 caracteres) endCompl Complemento do endereço do cliente (até 10 caracteres) endBairro Bairro de residência do cliente (até 18 caracteres) endEstado Sigla do estado de residência do cliente endCidade Nome da cidade de residência do cliente profissao Profissão do cliente. Deverá ser passado no parâmetro, o código numérico que consta

antes do nome da profissão. Os valores possíveis são os seguintes: 125 - ADMINISTRADOR 131 - ADVOGADO 405 - AGENCIADOR DE PROPAGANDA 292 - AGENTE ADMINISTRATIVO 595 - AGENTE DE SERVICOS FUNERARIOS E EMBALSAMADOR 594 - AGENTE DE VIAGEM E GUIA DE TURISMO 103 - AGRONOMO 2 - AGROPECUARIA 591 - ALFAIATE 126 - ANALISTA DE SISTEMAS 923 - APOSENTADO (EXCETO FUNCIONARIO PUBLICO)- Preencher o campo ´cargo´ com o mesmo nome da profissão 102 - ARQUITETO 134 - ASSISTENTE SOCIAL 128 - ASTRONOMO E METEOROLOGISTA 47 - ATIVIDADES NAO ESPECIFICADAS/CLASSIFICADAS 168 - ATLETA PROFISSIONAL E TECNICO EM DESPORTOS 162 - ATOR E DIRETOR DE ESPETACULOS PUBLICOS 123 - ATUARIO E MATEMATICO 394 - AUXILIAR DE ESCRITORIO E ASSEMELHADOS 596 - AUXILIAR DE LABORATORIO 395 - BANCARIO E ECONOMIARIO 135 - BIBLIOTECARIO, ARQUIVISTA, MUSEOLOGO E ARQUEOLOGO 116 - BIOLOGO E BIOMEDICO 931 - BOLSISTA, ESTAGIARIO E ASSEMELHADOS

Page 7: Cadastro XP Manual de integração com AAIsportal-rs.xpi.com.br/email/manual_de_integracao_com_aais_v1_1.pdf · um formulário de cadastro integrado automaticamente com o da XP. Para

Manual de integração – Cadastro XP

7

PARÂMETRO DESCRIÇÃO 544 - BOMBEIRO E INSTALADOR DE GAS, AGUA, ESGOTO E ASSEMELHADOS 511 - CABELEREIRO, BARBEIRO, MANICURE, PEDICURE, MAQUILADOR 163 - CANTOR E COMPOSITOR 907 - CAPITALISTA RECEBENDO RENDIMENTO DE APLICACAO DE CAPITAL 391 - CHEFE INTERMEDIARIO 52 - CLUBE DE INVESTIMENTO 183 - COMANDANTE DE EMBARCACOES 30 - COMERCIO ATACADISTA 29 - COMERCIO VAREJISTA 182 - COMISSARIO DE BORDO 136 - COMUNICOLOGO 124 - CONTADOR 533 - CONTRAMESTRE DE EMBARCACOES 45 - COOPERATIVAS 500 - COORDENADOR DE AREA 305 - COORDENADOR E SUPERVISOR 165 - COREOGRAFO E BAILARINO 403 - CORRETOR DE IMOVEIS, SEGUROS, TITULOS E VALORES 193 - DECORADOR 214 - DELEGADO DE POLICIA 491 - DEMONSTRADOR 192 - DESENHISTA COMERCIAL 105 - DESENHISTA INDUSTRIAL 158 - DESENHISTA TECNICO 593 - DESPACHANTE, INCLUSIVE O ADUANEIRO 212 - DIPLOMATA 301 - DIRETOR DE EMPRESAS 144 - DIRETOR DE ESTABELECIMENTO DE ENSINO 121 - ECONOMISTA 542 - ELETRICISTA DE MANUTENCAO DE VEICULOS AUTOMOTORES E MAQUINAS 703 - ELETRICISTA E ASSEMELHADOS 598 - EMPREGADO DOMESTICO 304 - EMPRESARIO 113 - ENFERMEIRO E NUTRICIONISTA 101 - ENGENHEIRO 44 - ENSINO 42 - ESCRITORIOS CENTRAIS E REGIONAIS 191 - ESCULTOR, PINTOR E ASSEMELHADOS 949 - ESPOLIO 122 - ESTATISTICO 597 - ESTIVADOR, CARREGADOR, EMBALADOR E ASSEMELHADOS 932 – ESTUDANTE - Preencher o campo ´cargo´ com o mesmo nome da profissão 1 - EXTRACAO DE MINERAIS 3 - EXTRACAO VEGETAL 117 - FARMACEUTICO 413 - FEIRANTE 213 - FISCAL

Page 8: Cadastro XP Manual de integração com AAIsportal-rs.xpi.com.br/email/manual_de_integracao_com_aais_v1_1.pdf · um formulário de cadastro integrado automaticamente com o da XP. Para

Manual de integração – Cadastro XP

8

PARÂMETRO DESCRIÇÃO 106 - FISICO 114 - FISIOTERAPEUTA E TERAPEUTA OCUPACIONAL 49 - FND DE INVESTIMENTO EXCETO 118 - FONOAUDIOLOGO 922 - FUNCIONARIO PUBLICO CIVIL APOSENTADO 48 - FUNDACAO, ENTIDADE E ASSOCIACAO SEM FIM LUCRATIVO 605 - GARIMPEIRO 127 - GEOGRAFO 107 - GEOLOGO 303 - GERENTE 521 - GOVERNANTA DE HOTEL, CAMAREIRO, PORTEIRO, COZINHEIRO 40 - HOLDING - CONTROLADORA DE PARTICIPACAO 27 - INDUSTRIA DA CONSTRUCAO 22 - INDUSTRIA DE BEBIDAS 13 - INDUSTRIA DE BORRACHA 26 - INDUSTRIA DE CALCADOS 14 - INDUSTRIA DE COUROS, PELES E ASSEMELHADOS 23 - INDUSTRIA DE FUMO 10 - INDUSTRIA DE MADEIRA 9 - INDUSTRIA DE MATERIAL DE TRANSPORTE 8 - INDUSTRIA DE MATERIAL ELETRICO 12 - INDUSTRIA DE PAPEL, PAPELAO E CELULOSE 21 - INDUSTRIA DE PRODUTOS ALIMENTARES 18 - INDUSTRIA DE PRODUTOS DE MATERIAS PLASTICAS 16 - INDUSTRIA DE PRODUTOS FARMACEUTICOS 11 - INDUSTRIA DO MOBILIARIO 20 - INDUSTRIA DO VESTUARIO E ARTEFATOS 5 - INDUSTRIA E PRODUTOS MINERAIS 24 - INDUSTRIA EDITORIAL E GRAFICA 7 - INDUSTRIA MECANICA 6 - INDUSTRIA METALURGICA 15 - INDUSTRIA QUIMICA 19 - INDUSTRIA TEXTIL 25 - INDUSTRIAS DIVERSAS 41 - INSTITUICOES FINANCEIRAS, SOCIEDADES 717 - JOALHEIROS E OURIVES 412 - JORNALEIRO 171 - JORNALISTA 543 - LANTERNEIRO E PINTOR DE VEICULOS METALICOS 404 - LEILOEIRO, AVALIADOR E ASSEMELHADOS 166 - LOCUTOR E COMENTARISTA DE RADIO E TELEVISAO E RADIALISTA 535 - MAQUINISTA, FOGUISTA DE EMBARCACOES, LOCOMOTIVAS 534 - MARINHEIROS E ASSEMELHADOS 541 - MECANICO DE MANUTENCAO DE VEICULOS, AUTOMOVEIS E MAQUINAS 702 - MECANICO DE MANUTENCAO, MONTADOR, PREPARADOR, OPERADOR 111 - MEDICO

Page 9: Cadastro XP Manual de integração com AAIsportal-rs.xpi.com.br/email/manual_de_integracao_com_aais_v1_1.pdf · um formulário de cadastro integrado automaticamente com o da XP. Para

Manual de integração – Cadastro XP

9

PARÂMETRO DESCRIÇÃO 203 - MEMBRO DO PODER EXECUTIVO: PRESID DA REPUB, MINISTRO, ETC 205 - MEMBRO DO PODER JUDICIARIO: MINISTRO DO SUPREMO TRIB SUP 201 - MEMBRO DO PODER LEGISLATIVO: SENADOR, DEPUTADO FED E EST 701 - MESTRE E CONTRAMESTRE 295 - MILITAR EM GERAL 921 - MILITAR REFORMADO 492 - MODELO DE MODAS 532 - MOTORISTA DE VEICULOS DE TRANSPORTE DE CARGA 531 - MOTORISTA DE VEICULOS DE TRANSPORTE DE PASSAGEIROS 164 - MUSICO 291 - OCUPANTE DE CARGO DE DIRECAO E ASSESSORAMENTO INTERMEDIARIO 215 - OCUPANTE DE CARGO DE DIRECAO E ASSESSORAMENTO SUPERIOR 115 - ODONTOLOGO 216 - OFICIAIS DAS FORCAS ARMADAS E FORCAS AUXILIARES 167 - OPERADOR DE CAMERA DE CINEMA E TELEVISAO 609 - OUTROS 145 - OUTROS TRABALHADORES DE NIVEL SUPERIOR LIGADOS AO ENSINO 924 - PENSIONISTA 4 - PESCA E AQUICULTURA 181 - PILOTO DE AERONAVES 501 - PORTEIRO DE EDIFICIO, ASCENSORISTA, GARAGISTA E FAXINEIRO 211 - PROCURADOR E ASSEMELHADOS 161 - PRODUTOR DE ESPETACULOS PUBLICO 142 - PROFESSOR DE ENSINO SUPERIOR 143 - PROFESSOR DE PRIMEIRO E SEGUNDO GRAU 138 - PROFISSIONAIS DE LETRAS E DE ARTES 901 - PROPRIETARIO DE ESTABELECIMENTO AGRICOLA E PECUARIA 902 - PROPRIETARIO DE ESTABELECIMENTO COMERCIAL 904 - PROPRIETARIO DE ESTABELECIMENTO DE PRESTACAO DE SERVICOS 906 - PROPRIETARIO DE IMOVEL (RECEBENDO RENDIMENTO DE ALUGUEL) 905 - PROPRIETARIO DE MICROEMPRESAS 903 - PROPRIETARIO ESTABELECIMENTO INDUSTRIAL 592 - PROTETICO 132 - PSICOLOGO 172 - PUBLICITARIO 104 - QUIMICO 17 - REFINO DE PETROLEO E DESTILACAO 137 - RELACOES PUBLICAS 910 - SACERDOTE OU MEMBRO DE ORDENS OU SEITAS RELIGIOSAS 393 SECRETARIO, ESTENOGRAFO, DATILOGRAFO, RECEPCIONISTA, TELEFONISTA 396 - SECURITARIO 293 - SERVENTUARIO DE JUSTICA 37 - SERVICOS AUXILIARES DIVERSOS 43 - SERVICOS COMUNITARIOS E SOCIAIS 39 - SERVICOS DE ADMINISTRACAO OU LOCACAO

Page 10: Cadastro XP Manual de integração com AAIsportal-rs.xpi.com.br/email/manual_de_integracao_com_aais_v1_1.pdf · um formulário de cadastro integrado automaticamente com o da XP. Para

Manual de integração – Cadastro XP

10

PARÂMETRO DESCRIÇÃO 46 - SERVICOS DE ADMINISTRACAO PUBLICA 33 - SERVICOS DE ALOJAMENTO E ALIMENTACAO 32 - SERVICOS DE COMUNICACAO 36 - SERVICOS DE RADIODIFUSAO OU TELEVISAO 34 - SERVICOS DE REPARACAO E MANUTENCAO 38 - SERVICOS DE SAUDE 31 - SERVICOS DE TRANSPORTE 28 - SERVICOS INDUSTRIAIS DE UTILIDADE PUBLICA 35 - SERVICOS PESSOAIS 297 - SERVIDOR PUBLICO ESTADUAL 296 - SERVIDOR PUBLICO FEDERAL 298 - SERVIDOR PUBLICO MUNICIPAL 133 - SOCIOLOGO 401 - SUPERIOR, INSPETOR E AGENTE DE COMPRAS E VENDAS 294 - TABELIAO 152 - TECNICO DE BIOLOGIA 151 - TECNICO DE CONTABILIDADE E ESTATISTICA 156 - TECNICO DE ELETRICIDADE, ELETRONICA E TELECOMUNICACOES 157 - TECNICO DE LABORATORIO E RAIO X 155 - TECNICO DE MECANICA 154 - TECNICO DE QUIMICA 153 - TECNICO EM AGRONOMIA E AGRIMENSURA 108 - TECNOLOGO 601 - TRABALHADOR AGRICOLA 602 - TRABALHADOR DA PECUARIA 604 - TRABALHADOR DA PESCA 711 - TRABALHADOR DE ARTES GRAFICAS 709 - TRABALHADOR DE CONSTRUCAO CIVIL 713 - TRABALHADOR DE FABRICACAO DE ARTEFATOS DE MADEIRA 715 - TRABALHADOR DE FABRICACAO DE CALCADOS E ARTEFATOS DE COURO 714 - TRABALHADOR DE FABRICACAO DE PAPEL E PAPELAO 716 - TRABALHADOR DE FABRICACAO DE PRODUTOS DE BORRACHA E PLASTICO 712 - TRABALHADOR DE FABRICACAO DE PRODUTOS TEXTEIS 705 - TRABALHADOR DE FABRICACAO DE ROUPAS 710 - TRABALHADOR DE FABRICACAO E PREPARACAO DE ALIMENTOS E BEBIDA 704 - TRABALHADOR DE INSTALACOES DE PROCESSAMENTO QUIMICO 706 - TRABALHADOR DE TRATAMENTO DE FUMO E DE FABRICACAO CIGARROS 708 - TRABALHADOR DE USINAGEM DE METAIS 392 - TRABALHADOR DOS SERVICOS DE CONTABILIDADE E CAIXA 603 - TRABALHADOR FLORESTAL 707 - TRABALHADOR METALURGICO E SIDERURGICO 411 - VENDEDOR DE COMERCIO VAREJISTA E ATACADISTA 402 - VENDEDOR PRACISTA, REPRESENT COMERCIAL, CAIXEIRO VIAJANTE 112 - VETERINARIO E ZOOTECNISTA

Page 11: Cadastro XP Manual de integração com AAIsportal-rs.xpi.com.br/email/manual_de_integracao_com_aais_v1_1.pdf · um formulário de cadastro integrado automaticamente com o da XP. Para

Manual de integração – Cadastro XP

11

PARÂMETRO DESCRIÇÃO cargo Cargo do cliente (até 40 caracteres) estadoCivil Estado civil do cliente. Deverá ser passado no parâmetro o código numérico que

consta antes do nome do estado civil. Os possíveis valores são os seguintes: 1 - SOLTEIRO(A )- Bloqueia o campo ´Nome do conjugue´ 2 - DESQUITADO(A) - Bloqueia o campo ´Nome do conjugue´ 3 - VIUVO(A) - Bloqueia o campo ´Nome do conjugue´ 4 - DIVORCIADO(A) - Bloqueia o campo ´Nome do conjugue´ 5 - CASADO(A) COM BRASILEIRO(A) NATO(A) - Habilita o campo ´Nome do conjugue´ 6 - CASADO(A) COM BRASILEIRO(A) NATURALIZADO - Habilita o campo ´Nome do conjugue´ 7 - CASADO(A) COM ESTRANGEIRO(A) - Habilita o campo ´Nome do conjugue´ 8 - UNIÃO ESTÁVEL - Habilita o campo ´Nome do conjugue´

nomeConj Nome do(a) cônjuge tipoDoc Tipo do documento do cliente. Deverá ser passado no parâmetro o código

alfanumérico que consta antes do nome do documento. Os valores possíveis são os seguintes: RG - REGISTRO GERAL PP - PASSAPORTE AD - ORDEM DOS ADVOGADOS DO BRASIL MP - MINISTERIO PUBLICO EX - MINISTERIO DO EXERCITO ME - MINISTERIO DAS RELACOES EXTERIORES MR - MINISTERIO DA MARINHA MM - MINISTERIO DA MARINHA MJ - MINISTERIO DA JUSTICA AE - MINISTERIO DA AERONAUTICA DT - DTRA DR - DTRA 1 - DIC EN - CONSELHO REG. ENGENHARIA E ARQUITETURA KS - CONSELHO REG. DE QUIMICA PS - CONSELHO REG. DE PSICOLOGIA OD - CONSELHO REG. DE ODONTOLOGIA NT - CONSELHO REG. DE NUTRICIONISTA MV - CONSELHO REG. DE MEDICINA VETERINARIA MD - CONSELHO REG. DE MEDICINA FA - CONSELHO REG. DE FARMACIA EF - CONSELHO REG. DE ENFERMAGEM EC - CONSELHO REG. DE ECONOMIA CI - CONSELHO REG. DE CORRETORES DE IMOVEIS CT - CONSELHO REG. DE CONTABILIDADE BT - CONSELHO REG. DE BIBLIOTECONOMIA AS - CONSELHO REG. DE ASSISTENTES SOCIAIS AM - CONSELHO REG. TECNICOS DE ADMINISTRACAO RC - CONSELHO REG. DE REPRESENTANTE COMERCIAIS RP - CONSELHO REG DE PROF DE RELACOES PUBLICA

Page 12: Cadastro XP Manual de integração com AAIsportal-rs.xpi.com.br/email/manual_de_integracao_com_aais_v1_1.pdf · um formulário de cadastro integrado automaticamente com o da XP. Para

Manual de integração – Cadastro XP

12

PARÂMETRO DESCRIÇÃO 20 - CGPM CN - CERTIDAO DE NASCIMENTO CH - CARTEIRA NACIONAL DE HABILITACAO JZ - CARTEIRA IDENTIDADE DE JUÍZES RN - CARTEIRA IDENTIDADE DE ESTRANGEIROS AR - CARTEIRA IDENT.EXPEDIDA FORÇAS ARMADAS PF - CART. IDENT. EXPEDIDA POLICIA FEDERAL PL - CART. IDENT. EXP. CONSELHO PROF. LIBERAIS PJ - CART. DE IDENT. EXP. PELO PODER JUDICIAR

orgEmissor Órgão emissor do documento do cliente. Deverá ser passado no parâmetro o código alfanumérico que consta antes do nome do emissor do documento. Os valores possíveis são os seguintes: AGU - ADVOCACIA GERAL DA UNIAO AER - AERONAUTICA CH - C. HABILITAÇÃO CNH - CARTEIRA NACIONAL DE HABILITACAO CE - CE CIE - CEDULA DE IDENTIDADE DE ESTRANGEIRO ** - CI OD - CONS. REG. DE ODONTOLOGIA CFRC - CONSELHO FEDERAL REPRESENTANTE COMERCIAL CNT - CONSELHO NACIONAL DE TRANSITO CORE - CONSELHO REGIONAL CRB - CONSELHO REGIONAL BIOLOGIA CRA - CONSELHO REGIONAL DE ADMINISTRACAO CRC - CONSELHO REGIONAL DE CONTABILIDADE CRCI - CONSELHO REGIONAL DE CORRETORES D CRE - CONSELHO REGIONAL DE ECONOMIA CREF - CONSELHO REGIONAL DE EDUCACAO FISICA CREN - CONSELHO REGIONAL DE ENFERMAGEM CREA - CONSELHO REGIONAL DE ENGENHARIA CFA - CONSELHO REGIONAL DE FARMACIA CRF - CONSELHO REGIONAL DE FISIOTERAPIA CRM - CONSELHO REGIONAL DE MEDICINA CRN - CONSELHO REGIONAL DE NUTRIÇÃO CRO - CONSELHO REGIONAL DE ODONTOLOGIA CRP - CONSELHO REGIONAL DE PSICOLOGIA CRQ - CONSELHO REGIONAL DE QUIMICA CRMV - CONSELHO REGIONAL MEDICINA VETERINÁRIA CRTR - CONSELHO REGIONAL TECNOLOGO EM RADIOLOGI CGB - CONSULADO GERAL DO BRASIL CBM - CORPO DE BOMBEIROS MILITAR DGPC - DELEGACIA GERAL DA POLICIA CIVIL DPF - DEPARTAMENTO DE POLICIA FEDERAL DETR - DETRAN DF - DF DIC - DIRETORIA DE IDENTIFICAÇÃO CIVIL

Page 13: Cadastro XP Manual de integração com AAIsportal-rs.xpi.com.br/email/manual_de_integracao_com_aais_v1_1.pdf · um formulário de cadastro integrado automaticamente com o da XP. Para

Manual de integração – Cadastro XP

13

PARÂMETRO DESCRIÇÃO DPT - DPT DR - DTRA DPMA - ESTRANGEIRO FNJP - FEDERACAO NAC JORNALISTAS PROFISSIONAIS FSP - FSP GCB - GOVERNO CIVIL DE BRAGA SEPC - IFP IFPR - IFPR SEPS - IMPLANTAÇÂO - FAVOR ACERTAR IITP - INST. IDENT. TECNICA POLICIAL IIML - INST. DE IDENTIFICACAO MEDICO LEGAL IBO - INSTITUTO BRASILEIRO DE OPTOMETRIA IGP - INSTITUTO GERAL DE PERICIAS INSS - INSTITUTO NACIONAL DE SEGURIDADE SOCIAL IPF - INSTITUTO PEREIRA FAUSTINO ITGP - INSTITUTO TECNICO CIENTIFICO DE POLICIA IFP - INTISTUTO FELIX PACHECO ISP - ISP EX - M. EXERCITO MAN - MAN MB R - MARINHA MFAZ - MFAZ MAER - MINISTERIO DA AERONAUTICA MD - MINISTERIO DA DEFESA MED - MINISTERIO DA EDUCACAO MFA - MINISTERIO DA FAZENDA MAR - MINISTERIO DA MARINHA MRE - MINISTERIO DAS RELAÇOES EXTERIORES ME - MINISTERIO DO EXERCITO MMA - MINISTERIO DO MEIO AMBIENTE MT - MINISTERIO DO TRABALHO MPE - MINISTERIO PUBLICO ESTADUAL MPF - MINISTERIO PUBLICO FEDERAL OE - OE OAB - ORDEM DOS ADVOGADOS DO BRASIL OMB - ORDEM DOS MUSICOS DO BRASIL IIPR - PARANA PP - PASSAPORTE PE - PE PJ - PODER JUDICIARIO PC - POLICIA CIVIL PF - POLICIA FEDERAL PM - POLICIA MILITAR PMES - POLICIA MILITAR ESTADO DE SAO PAULO PG - PROCURADORIA GERAL REG - REGISTRO CIVIL CERTIDAO DE NASCIMENTO RS - REGISTRO DO SUL RG - REGISTRO GERAL

Page 14: Cadastro XP Manual de integração com AAIsportal-rs.xpi.com.br/email/manual_de_integracao_com_aais_v1_1.pdf · um formulário de cadastro integrado automaticamente com o da XP. Para

Manual de integração – Cadastro XP

14

PARÂMETRO DESCRIÇÃO RFB - REPUBLICA FEDERATIVA DO BRASIL SJSP - SAO PAULO SJC - SECRETARIA DA JUSTICA DA SEGURANCA SJT - SECRETARIA DA JUSTICA DO TRABALHO SJS - SECRETARIA DA JUSTIÇA E SEGURANÇA SJTC - SECRETARIA DA JUSTIÇA TRABALHO CIDADANIA SRF - SECRETARIA DA RECEITA FEDERAL SDS - SECRETARIA DE DEFESA SOCIAL SEJS - SECRETARIA DE ESTADO JUR SEGURANÇA PUBLICA SSP - SECRETARIA DE SEGURANCA PUBLICA SSI - SECRETARIA DE SEGURANÇA E IDENTIFICAÇÃO SSSP - SECRETARIA DE SEGURANÇA PUBLICA SSPS - SECRETARIA DE SEGURANÇA PUBLICA SSPC - SECRETARIA DE SEGURANÇA PUBLICA DO CEARA SESP - SECRETARIA DO ESTADO DE SEGURANCA PUBLICA SSPE - SECRETARIA SEGURANCA PUBLICA ESTADUAL SFP - SFP SPPR - SPPR SPSP - SPSP SRJ - SRJ SSO - SSO SSPD - SSPD SSPM - SSPM SSPR - SSPR SSRJ - SSRJ SPTC - SUP DE POLICIA TECNICO CIENTIFICA TJMG - TJMG TJ - TRIBUNAL DE JUSTICA TJCE - TRIBUNAL DE JUSTICA CEARA TRT - TRIBUNAL REGIONAL DO TRABALHO TRF - TRIBUNAL REGIONAL FEDERAL

numDoc Número do documento do cliente (até 16 caracteres) dtEmissao Data de emissão do documento do cliente no formato AAAAMMDD ufEmissao Sigla do estado do órgão emissor do documento do cliente. nac Nacionalidade do cliente. Deverá ser passado no parâmetro, o código numérico que

consta antes da nacionalidade. Os valores possíveis são os seguintes: 1 - BRASILEIRO NATO 2 - BRASILEIRO NATURALIZADO 3 – ESTRANGEIRO

nat Naturalidade do cliente (até 30 caracteres) ufNat Sigla do estado da naturalidade do cliente sexo Sexo do cliente. Deverá ser passado no parâmetro o código alfanumérico que consta

antes do sexo. Os valores possíveis são os seguintes: M - Masculino F – Feminino

nomePai Nome do pai do cliente (até 60 caracteres) nomeMae Nome da mãe do cliente (até 60 caracteres) empresa Nome da empresa que o cliente trabalha (até 60 caracteres)

Page 15: Cadastro XP Manual de integração com AAIsportal-rs.xpi.com.br/email/manual_de_integracao_com_aais_v1_1.pdf · um formulário de cadastro integrado automaticamente com o da XP. Para

Manual de integração – Cadastro XP

15

PARÂMETRO DESCRIÇÃO cepCom CEP do endereço comercial do cliente no formato 99999999 endCom Endereço comercial do cliente (rua, avenida, estrada, etc) com até 30 caracteres endNumCom Número do endereço comercial do cliente (até 5 caracteres) endComplCom Complemento do endereço comercial do cliente (até 10 caracteres) endBairroCom Bairro do endereço comercial do cliente (até 18 caracteres) endEstadoCom Sigla do estado do endereço comercial do cliente endCidadeCom Nome da cidade de do endereço comercial do cliente telCom Número do telefone comercial do cliente no formato DDNNNNNNNN[N]. Onde as

duas primeiras posições (D) contêm o DDD e as 8 (ou 9) seguintes contêm o número ramal Número do ramal do cliente na empresa (até 5 números) salario Valor do salário/Pró-labore do cliente (formato javascript 99999.99 onde o ponto é o

separador decimal) aplicacoes Valor das aplicações financeiras do cliente (formato javascript 99999.99 onde o

ponto é o separador decimal) outrosRend Valor de outros rendimentos do cliente (formato javascript 99999.99 onde o ponto é o

separador decimal) bensMoveis Valor de bens móveis do cliente (formato javascript 99999.99 onde o ponto é o

separador decimal) bensImoveis Valor de bens imóveis do cliente (formato javascript 99999.99 onde o ponto é o

separador decimal) banco Código do banco onde o cliente tem conta. Deverá ser passado no parâmetro o código

numérico que consta antes do nome do banco. Os valores possíveis são os seguintes: 222 - A G F BRASEG S.A. 654 - A.J. RENNER S.A. 246 - ABC ROMA S/A 217 - AGROINVEST S.A. 025 - ALPHA 003 - AMAZONIA 215 - AMERICA DO SUL S/A 213 - ARBI S/A 094 - BANCO PETRA S.A 082 - BANCO TOPAZIO 756 - BANCOOB 230 - BANDEIRANTES S/A 021 - BANESTES S/A 719 - BANIF - BANCO INTERNACIONAL DO FUNCHAL 744 - BANKBOSTON 184 - BBA CREDITANSTAL S/A 107 - BBM S/A 740 - BCN BARCLAYS S/A 739 - BGN S/A 320 - BIC BANCO S/A 096 – BM&F S/A 394 - BMC S/A 318 - BMG S/A 752 - BNP PARIBAS BRASIL S.A 479 - BOSTON S/A

Page 16: Cadastro XP Manual de integração com AAIsportal-rs.xpi.com.br/email/manual_de_integracao_com_aais_v1_1.pdf · um formulário de cadastro integrado automaticamente com o da XP. Para

Manual de integração – Cadastro XP

16

PARÂMETRO DESCRIÇÃO 237 - BRADESCO S/A 225 - BRASCAN S/A 001 - BRASIL S/A- Não permitir inserir letra no DV, alterar para 0 (zero) 070 - BRB - BANCO REGIONAL DE BRASILIA 044 - BVA 263 - CACIQUE S/A 104 - CAIXA ECONOMICA FEDERAL S/A 085 - CECREDI 266 - CEDULA S/A 091 - CENT DE COOP EC CR MUT EST R G DO SUL 376 - CHASE MANHATTAN S/A 745 - CITIBANK S/A 241 - CLASSICO S.A. 175 - CONTINENTAL BANCO S/A 075 - CR2 S/A 721 - CREDIBEL S/A 505 - CREDIT SUISSE 229 - CRUZEIRO DO SUL S/A 707 - DAYCOVAL S/A 487 - DEUTSCHE BANK S/A - BANCO ALEMAO 214 - DIBENS S/A 743 - EMBLEMA S/A 031 - ESTADO DE GOIAS S.A. 024 - ESTADO DE PERNAMBUCO S.A. 047 - ESTADO DE SERGIPE S.A 036 - ESTADO DO MARANHAO S.A. 038 - ESTADO DO PARANA S.A. 037 - ESTADO DO PARÁ S.A. 039 - ESTADO DO PIAUI S.A. 029 - ESTADO DO RIO DE JANEIRO 041 - ESTADO DO RIO GRANDE DO SUL S.A. 370 - EUROPRU P/AM. LATINA - BEAL 641 - EXCEL BANCO S/A 265 - FATOR S/A 224 - FIBRA S/A 626 - FICSA S/A 252 - FININVEST S/A 734 - GERDAU S/A 612 - GUANABARA S.A. 399 - HSBC S/A- Verificar se está inserindo 2 dígitos no DV. 604 - INDL DO BRASIL S/A 653 - INDUSVAL S/A 630 - INTERCAP S/A 492 - INTERNAT. NEDERLANDEN BANK N.V. 249 - INVESTCRED S/A 341 - ITAU S/A 998 - LIQUIDANTE FUNDOS 600 - LUSO BRASILEIRO S.A.

Page 17: Cadastro XP Manual de integração com AAIsportal-rs.xpi.com.br/email/manual_de_integracao_com_aais_v1_1.pdf · um formulário de cadastro integrado automaticamente com o da XP. Para

Manual de integração – Cadastro XP

17

PARÂMETRO DESCRIÇÃO 233 - MAPPIN S/A 212 - MATONE S.A. 389 - MERCANTIL DO BRASIL S/A 746 - MODAL 738 - MORADA S/A 488 - MORGAN GUARANTY TRUST COMPANY OF N.Y 300 - NACION ARGENTIA S.A. 412 - NACIONAL DA BAHIA S.A. 753 - NBC BANK BRASIL SA 004 - NORDESTE DO BRASIL S.A. 045 - OPPORTUNITY 208 - PACTUAL S/A 623 - PANAMERICANO S/A 254 - PARANA BANCO S/A 611 - PAULISTA S/A 613 - PECUNIA S/A 643 - PINE S/A 724 - PORTO SEGURO S/A 735 - POTTENCIAL S/A 638 - PROSPER S/A 495 - PROVINCIA DE BUENOS AIRES 633 - RENDIMENTO S/A 494 - REOUBKICA ORIENTAL DEL URUGUAY 741 - RIBEIRAO PRETO S/A 453 - RURAL S/A 422 - SAFRA S/A 033 - SANTANDER S/A 914 - SANTOS S/A 250 - SCHAHIN CURY S/A 013 - SENSO CCVM S/A (CONTA RESERVA BC) 748 - SICREDI S/A 637 - SOFISA S/A 366 - SOGERAL S/A 204 - SRL S/A 243 - STOCK S/A 464 - SUMITOMO S.A. 456 - TOKIO S/A 634 - TRIANGULO S/A 116 - UNICO S.A. 084 - UNICRED 090 - UNICRED 087 - UNICRED 099 - UNICRED PONTA GROSSA 610 - V R S/A 655 - VOTORANTIM S/A

tpConta Tipo da conta bancária do cliente. Deverá ser passado no parâmetro, o código numérico que consta antes do tipo de conta. Os valores possíveis são os seguintes: 1 - Corrente

Page 18: Cadastro XP Manual de integração com AAIsportal-rs.xpi.com.br/email/manual_de_integracao_com_aais_v1_1.pdf · um formulário de cadastro integrado automaticamente com o da XP. Para

Manual de integração – Cadastro XP

18

PARÂMETRO DESCRIÇÃO 2 – Investimento

agencia Número da agência do cliente (apenas números - máx. 4 dígitos) numConta Número da conta do cliente sem o dígito verificador (apenas números) dvConta Número do dígito verificador da conta do cliente (apenas números) nomeCoTitular Nome do co-titular da conta do cliente caso seja uma conta conjunta (até 60

caracteres) cpfCoTitular Número do CPF do co-titular da conta do cliente caso seja uma conta conjunta

(formato 99999999999) vinculo Informa se o cliente é pessoa vinculada à XP Investimentos ou outra corretora.

Deverá ser passado no parâmetro o código numérico que consta antes da opção. Os valores possíveis são os seguintes: S - Sim N – Não

ppe Informa se o cliente é pessoa politicamente exposta. Deverá ser passado no parâmetro, o código numérico que consta antes da opção. Os valores possíveis são os seguintes: S - Sim N – Não

oportunidades Informa se o cliente deseja receber oportunidades e notícias sobre o mercado financeiro por e-mail. Deverá ser passado no numérico que consta antes da opção. Os valores possíveis são os seguintes: S - Sim N – Não

nomeProc Nome do procurador do cliente (até 60 caracteres) cpfProc Número do CPF do procurador do cliente (formato 99999999999) rgProc Número da identidade/RG do procurador do cliente (até 16 caracteres) emailProc E-mail do procurador do cliente (até 80 caracteres)