MANUAL DA DLL de INTEGRAÇÃO VIATCP IP Resumo das funções Belo Horizonte Agosto - 2007
SUMÁRIO Introdução...03 1. Consultas... 03 1.1.1 - Função MenuSocket... 03 1.1.2 - Função ConsultaSocket... 05 2. Funções de Consistência... 06 2.1.1 Função Verifica CPF... 06 2.1.2 Função Verifica CNPJ... 06 2.1.3 Função Verifica Versão... 06 2.1.4 Função Força Rota Socket... 06 2.1.5 Função Testa CMC7... 06 3. Anexo I... 07
INTRODUÇÃO A DLL Integração tem por objetivo integrar sistemas de qualquer segmento, tais como Supermercados, Farmácias, Postos de Combustível, Lojas de Conveniência, Fábricas, dentre outros, as bases de dados cadastrais positivas ou negativas e bases de cheques com abragência em todo território nacional. As transações são realizadas host a host utilizando acesso dedicado através de protocolo TCP/IP ou acesso discado através do protocolo X.25, o processo se resume no envio e retorno de strings de caracteres de acordo com os layouts que acompanham essa documentação. RESUMO DE FUNÇÕES DLL 1 CONSULTAS 1.1.1 - Função MenuSocket Assinatura : function MenuSocket(Host, Porta, Usuario, SenhaUsuario:Pchar):Pchar;StdCall; -Host IP do Servidor de consultas; - Porta Número da porta de comunicação no servidor de consultas; -Usuário Usuário de acesso ao sistema (Cód. Operador); -Senha Senha do usuário de acesso ao sistema; Tipo de Conexão: TCP/IP Socket Retorno: Texto
Layout: ZZXXAABBBBBBBBBBBBBBBBBBBBBBBBBBBBBBCDEFGHI Header (X) Total de opções de Consulta - Início: 1 - Fim: 2 - Tamanho: 2 (Z) Retorno de sucesso (00 - Sucesso / 01 a 99 - Erro) - Início: 1 - Fim: 2 - Tamanho: 2 Detalhes de 39 em 39 Bytes o número de vezes que o header indicar. INÍCIO FIM TAMANHO (A) Número da Opção de Consulta 3 4 2 (B) Descrição da Opção de Consulta 5 34 30 (C) Tipo de Pessoa (F - Física, J - Jurídica, A - Ambas) 35 35 1 (D) Solicita RG (S/N) 36 36 1 (E) Solicita Nome + Data de Nascimento (S/N) 37 37 1 (F) Solicita Dados de Cheque (S/N) 38 38 1 (G) Obriga informação de CMC7 (S/N) 39 39 1 (H) Solicita DDD +Telefone (S/N) 40 40 1 (I) Opção Use Auto (P-Placa, C-Chassi, M-Motor), R-Renavam, X-Caixa de Câmbio, L-Chassi e UF, (M-Placa e UF, N-Não solicita USE AUTO). 41 41 1
1.1.2 - Função ConsultaSocket Assinatura: function ConsultaSocket (Tipo, FormatoResposta, NumeroDeColunas, Host, Porta, NumeroDaOpcao, NomeOpcaoConsulta, Nome, Documento, DataNascimento, Compensacao, Banco, Agencia, ContaCorrente, PrimeiroCheque, UltimoCheque, DataCheque, ValorCheque, CMC7, DDD,Telefone, AutoPlaca, AutoChassi, AutoMotor, AutoRenavam,AutoUF, AutoCambio, FormaAcesso, Usuario, SenhaUsuario: Pchar): Pchar; StdCall; -Tipo (A) Analítico (S) Sintética - Formato Resposta (HTML) ou (TEXTO) (Z) Retorno de sucesso (00 - Sucesso / 01 a 99 - Erro) - Início: 1 - Fim: 2 - Tamanho: 2 Tipo de Conexão: TCP/IP Socket Retorno: (HTML) ou (TEXTO) Depende da opção solicitada no parâmetro FormatoResposta Layout: ZZ Retorno da resposta em HTML ou ZZ Retorno da resposta em TXT Header (Z) Retorno de sucesso (00 - Sucesso / 01 a 99 - Erro) - Início: 1 Fim: 2 Tamanho: 2 Detalhes (HTML) Indica que o texto contido nessa posição encontra-se no formato HTML, deverá ser
lido da posição 3 até o final da string. (TXT) Indica que o texto contido nessa posição encontra-se no formato TXT, deverá ser lido da posição 3 até o final da string. 2 CONSISTÊNCIA 2.1.1 - Função Verifica CPF Descrição: Verifica se o CPF é válido. Assinatura: function VerificaCPF (CPF:Pchar):Boolean;Stdcall; 2.1.2 - Função VerificaCNPJ Descrição: Verifica se o CNPJ é válido. Assinatura: function VerificaCNPJ (CNPJ:Pchar):Boolean;Stdcall; 2.1.3 - Função Verifica Versão Descrição: Verifica o número da Versão da DLL, ( Ex.: Versão 3.0.3 ). Assinatura: function VerificaVersao : Pchar; Stdcall; 2.1.4 - Função Força Rota Socket Descrição: Mantêm a conexão ativa entre a aplicação que utiliza a DLL e o Host de destino. Assinatura: function ForcaRotaSocket (Host, Porta: Pchar): Pchar; Stdcall; 2.1.5 - Função Testa CMC7 Descrição: Verifica se o CMC7 é válido. Assinatura: function TestaCMC7 (CMC7:Pchar): Pchar; Stdcall; ANEXO I
ANEXO I TIPO DESCRIÇÃO FUNÇÃO OBSERVAÇÃO Agência Número da agência bancária Auto Cambio Número do câmbio do veículo Auto Chassi Número do chassi do veículo Auto Motor Número do motor do veículo ConsultaSocket Auto Placa Número da placa do veículo Auto Renavam Número do renavam do veículo ConsultaSocket Auto UF Estado de origem do veículo. Banco Número do banco CMC7 É o conjunto de três blocos numéricos que vem impresso no canto inferior do CHEQUE. Neles estão contidas todas as TestaCMC7 informações referentes à conta, banco, número do cheque e titular da conta. Compensação Conta Corrente Data Cheque Número de compensação do cheque Número da conta corrente Data em que o cheque foi emitido DDD O número do DDD da cidade Documento CPF ou CNPJ Forma Acesso O meio de acesso para realizar as consultas. Neste campo será enviado as letras, S (Sim) para envia o CMC7 ou N (Não) para não envia o CMC7 OBS: Não enviando o CMC7 a consulta será feita pelos dados digitados do cheque. Será enviado para o sistema o número: 0 para TCP Formato Resposta HTML ou Texto Host IP do servidor de consultas MenuSocket, ForcaRotaSocket Nome Opção O nome da opção que vai ser Consulta realizada Número Colunas O número de colunas Para exibição de resposta da consulta, somente para formato texto Número da O número da opção de Opção Porta consulta O número da porta de comunicação no servidor de consultas MenuSocket, ForcaRotaSocket
Primeiro O número do primeiro Cheque cheque Senha Usuário Conjunto com até 4 (quatro) dígitos numéricos fornecido pelo provedor de serviços Menu Socket, Consulta Socket, Telefone O número do telefone Tipo Se a resposta da consulta será analítica ou sintética Ultimo Cheque O número do último cheque Usuário Conjunto com até 6 (seis) dígitos numéricos fornecido pelo provedor de serviços Menu Socket, Consulta Socket,