Manual de Integração do Crivo

Transcrição

Manual de Integração
API CREDITTALK
Versão do Crivo: 4
Versão da ‘API CreditTalk’: 4
Data: 15.04.2014
Crivo TransUnion
Rua Vergueiro, 2016 | 11º andar | Vila Mariana | CEP 04102-000 | São Paulo | SP |
Tel.: 11 5904-7830 – www.crivotransunion.com.br – Email: [email protected]
Página 2
ÍNDICE
................................................................................................................................................................................................... 1
................................................................................................................................................................................................... 1
1
INTRODUÇÃO ................................................................................................................................................................... 4
CONCEITOS DO CRIVO ........................................................................................................................................................... 5
O QUE É O CRIVO ................................................................................................................................................................................. 5
INTERFACES DO CRIVO ........................................................................................................................................................................... 6
Administrador Crivo ..................................................................................................................................................................... 6
Browser ........................................................................................................................................................................................ 6
CONFIGURAÇÕES BÁSICAS DO CRIVO ........................................................................................................................................................ 7
Definição e Configuração da Estrutura Corporativa .................................................................................................................... 7
Definição e Manutenção da Política ............................................................................................................................................ 8
Critérios ........................................................................................................................................................................................ 8
Operação ..................................................................................................................................................................................... 8
Regras .......................................................................................................................................................................................... 9
Variáveis ...................................................................................................................................................................................... 9
Variáveis Reservadas ................................................................................................................................................................. 10
Ações .......................................................................................................................................................................................... 10
Objetos de Análise ..................................................................................................................................................................... 11
Resultado de um critério ............................................................................................................................................................ 11
Informações geradas por uma política de análise ..................................................................................................................... 12
Informações configuradas no critério ........................................................................................................................................ 12
Informações Básicas .................................................................................................................................................................. 12
Exemplos de políticas de análise ................................................................................................................................................ 12
Fluxo de uma operação no Crivo................................................................................................................................................ 15
API CREDITTALK .................................................................................................................................................................... 17
ESTRUTURA DA ‘API CREDITTALK’ ......................................................................................................................................................... 17
Formas de acesso ....................................................................................................................................................................... 17
Componentes COM .................................................................................................................................................................... 18
Visual Basic ................................................................................................................................................................................ 18
IDL .............................................................................................................................................................................................. 18
BSD/Sockets ............................................................................................................................................................................... 19
Web Services .............................................................................................................................................................................. 19
Diagramas de Sequência ........................................................................................................................................................... 19
Diagramas de Estados ............................................................................................................................................................... 23
COMANDOS DA API CREDITTALK DO CRIVO............................................................................................................................................. 24
CT VERSION ................................................................................................................................................................................ 24
LOGIN ......................................................................................................................................................................................... 24
LAYOUT ...................................................................................................................................................................................... 25
EVAL ........................................................................................................................................................................................... 26
EXPLAIN...................................................................................................................................................................................... 28
VALUES ....................................................................................................................................................................................... 30
SOURCES .................................................................................................................................................................................... 30
REFRESH ..................................................................................................................................................................................... 31
REPORT ...................................................................................................................................................................................... 31
LOADLOG ................................................................................................................................................................................... 31
SETPOLICY .................................................................................................................................................................................. 32
COMMAND ................................................................................................................................................................................ 32
Documento de uso Confidencial entre a Crivo TransUnion e seus destinatários.
A sua utilização é exclusivamente para os membros autorizados destas partes – Não Reproduzir
Crivo TransUnion - Todos os Direitos Reservados®
Página 3
LOADPDF .................................................................................................................................................................................... 33
PARAMETERS ............................................................................................................................................................................. 33
OPSEARCH .................................................................................................................................................................................. 34
STMON ..................................................................................................................................................................................... 35
HELP ........................................................................................................................................................................................... 35
QUIT ........................................................................................................................................................................................... 36
Erros ........................................................................................................................................................................................... 36
COMANDOS DA API CREDITTALK STATELESS ............................................................................................................................................ 37
EVAL ........................................................................................................................................................................................... 37
EVALXML / RETORNOEVALXML ................................................................................................................................................. 39
Este comando solicita ao Crio a execução de uma política de análise com fontes de informação. O retorno deste método
trará um arquivo XML. ............................................................................................................................................................... 39
Sintaxe ....................................................................................................................................................................................... 39
String Parametro, string driver, string produto, boolincludeOA ................................................................................................ 39
Retorno da Execução da Operação ............................................................................................................................................ 39
<cod_operacao>;<cod_operacao_obj_analise>politica_PF;Ok;F .............................................................................................. 39
Retorno do XML ......................................................................................................................................................................... 39
Driver;Produto;<XML> ............................................................................................................................................................... 39
Salientamos que ao habilitar este comando / método para que os dados sejam gravados no arquivo XML será necessário
habilitar a chave de registro “RelatorioXMLColeta”. ................................................................................................................. 39
EXPLAIN...................................................................................................................................................................................... 39
LAYOUT ...................................................................................................................................................................................... 41
LOADPDF .................................................................................................................................................................................... 42
PARAMETERS ............................................................................................................................................................................. 42
RAWDATA .................................................................................................................................................................................. 43
REPORT ...................................................................................................................................................................................... 43
SETPOLICYEVAL .......................................................................................................................................................................... 43
SOURCES .................................................................................................................................................................................... 44
VALUES ....................................................................................................................................................................................... 44
EXEMPLO DE CONFIGURAÇÃO DO IDISPATH ............................................................................................................................................. 44
EXPORTAR O COMPONENTE SERVICES DO SERVIDOR DO CRIVO ................................................................................................................... 45
INSTALAR COMPONENTE SERVICES EXPORTADO DO SERVIDOR DO CRIVO ...................................................................................................... 45
RECURSOS DISPONÍVEIS NO PROCESSO DE INTEGRAÇÃO .............................................................................................................................. 45
ANALISAR O LOG DA ‘API CREDITTALK’ .................................................................................................................................................. 46
Exemplos de Log ........................................................................................................................................................................ 46
TESTES NO SERVIDOR .......................................................................................................................................................................... 47
TESTES NO CLIENTE............................................................................................................................................................................. 48
Teste pelo WebService do Cliente .............................................................................................................................................. 48
Teste ASP - API Crivo .................................................................................................................................................................. 48
Teste via VB Script ...................................................................................................................................................................... 49
TABELA DE ERROS............................................................................................................................................................................... 49
API ADMINISTRADOR .......................................................................................................................................................... 50
ALTERAÇÃO DE SENHAS ....................................................................................................................................................................... 50
1
Página 4
I NTRODUÇÃO
Neste manual você tem todas as informações necessárias para realizar o processo de integração de um sistema ao Crivo.
Inicialmente são descritos de forma objetiva e rápida os conceitos das principais funcionalidades e os recursos padrões do Crivo. Na
segunda parte deste manual são abordados os conceitos e comandos que possibilitam a integração de um Sistema ao Crivo de
modo automatizado.
Neste manual, você terá todas as informações e procedimentos de integração de um Sistema com o Crivo 4. Através
do índice no início do manual você pode localizar mais facilmente a função desejada.
Crivo TransUnion - Todos os Direitos Reservados
Página 5
C ONCEITOS DO C RIVO
O que é o Crivo
O Crivo é um sistema que permite a automação do processo de tomada de decisão de análise de crédito/risco de pessoas físicas e
jurídicas, através da coleta e análise de dados utilizando políticas previamente definidas.
Figura 1: Inteligência Crivo
Página 6
O Crivo beneficia os seguintes segmentos:
Bancos e Financeiras
• CDC
• Cartões
• Empréstimo Pessoal
• Risco
• Fraude
• Financiamentos
• Campanhas Internas
Crédito Consignado
• Consulta a todas as fontes
online;
• Cruzamento e dados de
fontes distintas
automaticamente;
• Cálculo de margem;
• Confirmação de dados
pessoais.
Área de Crédito
• Redução do tempo de
resposta;
• Padronização de
processos;
• Criação políticas sem
limitação;
• Automatização da busca /
coleta de dados nas fontes
de informações;
• Utilização de informações
internas do cliente como
parte do processo de
tomada de decisão;
• Redução dos custos com
fontes de informações
tarifadas.
Área de Prevenção a
Fraudes
• Traça perfis de
fraudadores da sua
carteira, através de
relatórios;
• Permite a coleta e a
comparaçaõ de
informações para
identificação de possíveis
fraudadores;
Seguradoras e
Veículos
• Agilidade na mudança dos
critérios de aprovação;
• Visualização gráfica dos
critérios de aprovação;
• Evita duplicidade de
consultas tarifadas,
permitindoa reutilização
de relatórios;
• Checa a veracidade das
informações fornecidas
por novos clientes;
• Armazenamento
eletrônico de todas as
consultas de uma
proposta em só registro;
• Permite a criação de listas
de clientes especiais,
diminuindo os custos com
fontes de informações
tarifadas.
• Avaliação de perfil de
condutor principal e
condutores autorizados
numa única operação.
Interfaces do Crivo
Administrador Crivo
O Administrador Crivo é uma aplicação cliente/servidor que deve ser instalada na estação de trabalho. Possibilita administrar
todos os recursos do Sistema, como definir e configurar acessos e usuários, criar e editar critérios de acordo com a política de
negócios da empresa.
Configurações
o Estrutura
Corporativa:
centro de custo, grupo e
usuário;
o Coletores;
o Global.
Políticas
o Criação, edição, e
exclusão dos critérios e
todos os demais
componentes necessários
para o funcionamento da
política.
Ferramentas
o Criação de Listas Especiais
para utilização na política;
o Acompanhamento
das
Listas Especiais;
o Geração do visualizador
dos passos de execução
de uma operação já
realizada.
Histórico de Decisões
o Exportar
informações
coletadas;
o Gerar Relatórios.
Monitoração
o Auditoria;
o Diagnóstico.
Browser
Pela interface Browser do Crivo o usuário pode inserir manualmente as informações necessárias para a tomada de decisão.
Histórico
o
o
Layout
Geração dos Relatórios.
o
Consulta e download da
Página 7
Individual
o
Processamento de apenas 01
Lote
o
Processamento de diversas
Visualização dos resultados das
estrutura do arquivo de
(uma) informação através de um
informações ao mesmo tempo e
operações individuais e em lote.
operação em lote.
ou mais parâmetros de entrada.
de forma automática, através de
um arquivo em formato prédefinido com os parâmetros de
entrada necessários para que a
análise seja processada.
Configurações Básicas do Crivo
Antes de qualquer coisa é necessário ter acesso ao Crivo, para isso é preciso ter um usuário e senha. A criação é feita no
Administrador do Crivo pela funcionalidade ‘Estrutura Corporativa’, a seguir descrita.
Definição e Configuração da Estrutura Corporativa
Pelo Administrador Crivo, na funcionalidade Estrutura Corporativa é possível criar e configurar:
Centro de Custo
• Configuração das Fontes de Informação, como por exemplo, os códigos, senhas e
outras características de acesso.
Grupo
• Permissão de acesso às telas do Sistema
• Acesso às Pastas
• Permissão de uso dos recursos, como por exemplo, escolher o critério a ser
executado, ou a visualização de "Pontos", "Limites", "Resposta", "Justificativa" e
relatórios gerados pelas políticas de análise.
Usuário
• Cadastro dos usuários e senhas para acesso às interfaces do Crivo (Administrador e
Browser);
• Usuários Internos do Crivo ou
• Usuário LDAP
Página 8
Todo Usuário (menor unidade da Estrutura Corporativa) criado no Crivo necessariamente pertence a um Grupo que por sua vez
está ligado a um Centro de Custo (maior unidade da Estrutura Corporativa). Assim, todo usuário está sujeito às permissões e
configurações definidas para o seu grupo.
Figura 1 - Estrutura Corporativa “Configurações”
Definição e Manutenção da Política
Na política para tomada de decisão de crédito/risco são definidas as diretrizes, critérios e os procedimentos a serem usados para
a realização ou não do negócio pretendido entre a sua empresa e o seu cliente.
Para o Crivo, uma política é formada por um ou mais critérios, e visa fornecer uma decisão a partir da aplicação das regras
definidas nos parâmetros de entrada e nos dados coletados durante a operação. Assim, a política pode ser modelada de acordo
com a regra de negócio ou fluxo de análise da empresa.
Critérios
Critério é uma sequência lógica de regras que juntas resultam em uma análise. Assim, quando um ou mais critérios forem
executados em conjunto será gerada operação identificada por um código de operação.
Operação
Operação é o resultado do processamento de um ou mais critérios para um conjunto de parâmetros informados de mesmo tipo
(Pessoa Física ou Jurídica) não repetidos. Ela é identificada por um código único e sequencial gerado automaticamente pelo
1
sistema .
1
O código de operação é uma codificação sequencial composta de 07 (sete) caracteres alfanuméricos, em alguns casos contendo também caracteres espec iais, como
‘/’ (barra). Seu objetivo é identificar a operação realizada por um determinado usuário, numa determinada data e com determinados parâmetros de entrada e saída. É de
natureza case sensitive, portanto o código ‘000000a’ e o código ‘000000A’ representam 02 (duas) operações distintas. É também a unidade de cobrança de uso do
Sistema.
Página 9
Regras
Regra é um componente básico do critério formado por uma expressão que gera uma ou mais condições, e para cada condição
pode-se incluir uma ou mais ações.
Pelo Administrador Crivo, na funcionalidade Edição de Políticas é possível definir e dar manutenção nas políticas de análise tanto
de pessoa física quanto de pessoa jurídica.
Até que seja associada a um "Grupo" uma política de análise é apenas um critério e somente entra em ação quando um usuário
que pertence a este "Grupo" executa uma operação.
São elementos de uma regra:
o
o
o
o
Variáveis
Variáveis Reservadas
Ações
Objetos de Análise
Variáveis

Criadas pelo Administrador do Crivo.

Disponibilizadas pelos Drivers Crivo de acesso a fontes de informação.
Os Drivers são componentes desenvolvidos e mantidos pela Crivo com o objetivo de acessar as fontes de informações sejam elas
internas ou externas à rede da sua empresa.
Um Driver possui produtos, que contém um conjunto de informações disponibilizadas pelas fontes, para que o Driver possa se identificar
utilizando os dados configurados no "Centro de Custo". O Driver faz a coleta dos dados disponibilizados pela fonte acessada e carrega as
variáveis definidas durante a construção deste driver, variáveis estas que podem ser utilizadas na construção de um critério.
Página 10
Variáveis Reservadas
Resposta
É um elemento de retorno padrão do Crivo que exibe um texto padrão de até 50 (cinquenta) caracteres como resposta
2
para o usuário final na Interface Browser .
Pontos
É um elemento de retorno padrão do Crivo que objetiva pontuar as variáveis para ajudar o usuário final na aplicação de
modelos de scoring.
Limite
É um elemento de retorno padrão do Crivo que objetiva dar limites para ajudar o usuário final na análise de crédito.
Justificativa
É um elemento padrão do Crivo que retorna mensagens textuais que diferentemente da "Resposta" não interrompem a
execução de um critério e não são únicas, ou seja, ao final da execução da análise de um critério poderão ser produzidas
tantas justificativas quantas regras existam neste critério.
Sistema
É um elemento de retorno padrão do Crivo cujo objetivo é ser usado nas chamadas realizadas ao sistema através da
3
‘API CreditTalk’. É este retorno o indicado para uso como saída do Crivo para o seu sistema .
Ações
As ações modificam o conteúdo de variáveis reservadas ou mudam o fluxo da política de análise:
Adiciona à
Justificativa
Este elemento de retorno que exibe um texto na área de justificativas do relatório de análises informando na ação “Justificativa”
mais detalhes sobre o processo de decisão.
Define Cor:
É um elemento de retorno que define um marcador (disco colorido), ignorando todas as cores adicionadas até o momento.
Esta ação serve para reforçar visualmente o significado da resposta para o usuário final na Interface Browser.
Define
Justificativa
É um elemento de retorno que define um texto como justificativa para o usuário final na Interface Browser, ignorando todas
as justificativas adicionadas até o momento4.
Define Limite
É um elemento de contagem que define limites para ajudar o usuário final na análise de crédito, ignorando todas as limitações
adicionadas até o momento. Pode ser usado, por exemplo, para determinar o limite final do cartão de crédito do cliente em
análise.
Define Pontos
É um elemento de contagem que define uma pontuação para as variáveis na utilização de modelos de scoring, ignorando
todas as pontuações adicionadas até o momento.
Define
Resposta
É um elemento de retorno que define um texto fixo de resposta de até 50 (cinquenta) caracteres, ignorando todas as
respostas adicionadas até o momento. É visualizado no resultado da operação na Interface Browser.
Junto ao retorno “resposta” existe o retorno “sistema” cujo objetivo é definir um texto com até 50 (cinquenta) caracteres para
fins de integração de critérios ou de sistemas5.
Uma vez que esta ação aconteça a execução do critério é interrompida e nada mais do que foi configurado a seguir dentro do
critério em questão será executado para a operação em curso.
Delega Decisão
à
Esta ação permite que se execute outro critério a partir do critério atual, e a resposta final (decisão) passa a ser de
responsabilidade do critério que foi executado. A utilização deste recurso não gera uma nova operação, mas pode alterar a
posição no retorno do comando EVAL do retorno de sistema final (que aparece na primeira linha quando este recurso não é
usado).
Adicionar ao
Limite
Esta ação permite que a contagem de limite até o momento da execução desta ação seja aumentada ou diminuída.
Adicionar aos
Pontos
Esta ação permite que a contagem dos pontos até o momento da execução desta ação seja aumentada ou diminuída.
Redefine Valor
do Campo
Esta ação redefine o valor de um campo depois do início da operação. É constituída de uma expressão cujo resultado deve
necessariamente ser do mesmo tipo do campo (para campos do tipo lista será possível configurar uma variável que seja uma
opção de uma lista ou ainda um valor do tipo texto).
2
3
Este elemento de retorno não é apresentado nas operações via ‘API CreditTalk’.
Para cada critério executado (e uma operação pode ter ‘n’ critérios executados) é gerado um retorno de sistema. Quando o retorno for o gerado pelo critério que
toma a decisão final, este será marcado com o ‘F’ ao lado para que fique claro para o sistema que chama o Crivo que se trata do resultado final daquela operação.
4
5
É um dos retornos do método EXPLAIN da ‘API CreditTalk’.
É o retorno que aparece como resultado do método EVAL da ‘API CreditTalk’.
Página 11
Objetos de Análise
O objeto de análise é o recurso do Crivo que permite que em uma mesma decisão tenhamos mais de um elemento do mesmo
tipo. Casos de negócios em que é preciso analisar mais de uma pessoa física ou jurídica para a tomada de decisão ou quando é
necessário mesclar na mesma decisão elementos de tipo diferente (uma pessoa física e uma jurídica).
Exemplo:
Política
Critério Principal
Objeto de análise
Financeira
Comprador
Um ou mais avalistas
Seguradora
Transportadora
Seus motoristas
Factoring
Empresa
Seus títulos
Tabela 1: Exemplo de Uso do Objeto de Análise

Uma política não poderá conter somente regras com objetos de análise, é necessária a existência de algum parâmetro de entrada na
política principal.

Um objeto de análise não pode estar associado a um critério secundário, ou seja, ele deve sempre estar associado à política principal. O
seu uso é local, portanto pode-se usá-lo somente no critério em que foi criado.

Não é possível usar objeto de análise dentro de objeto de análise, ou seja, uma vez que o objeto de análise está associado a um critério
de pessoa física não poderá ser associado a um critério de pessoa jurídica dentro da mesma política.

Cada objeto de análise gera uma operação com seu próprio código. Para acessar as informações de um objeto de análise deve-se
executar o comando LOADLOG antes dos demais desejados.
Resultado de um critério
Um critério após a sua execução produz obrigatoriamente:
Resposta
Mensagem com o resultado textual da análise, por exemplo, "Aprovado", "Restrições internas", "Apenas com aprovação do Gerente
de crédito".
Uma regra que resulta em uma ação "Resposta" interromperá o critério em execução. Um critério pode produzir apenas uma
Resposta.
Sistema
Tem a mesma função do elemento "Resposta" com informações para sistemas integrados ao Crivo. Por exemplo, poderia conter
códigos mais facilmente tratáveis que os conteúdos mostrados nos exemplos da "Resposta". Assim como na "Resposta" um critério
pode produzir apenas um "Sistema". É um elemento de retorno padrão do Crivo cujo objetivo é ser usado nas chamadas realizadas
ao sistema através da ‘API CreditTalk’. É este retorno o indicado para uso como saída do Crivo para o seu sistema.
Limite
Fornece um valor numérico gerado pelo critério.
Pontos
Fornece um valor numérico gerado pelo critério.
Justificativa
Mensagens textuais que diferentemente da "Resposta" não interrompem a execução de um critério e não são únicas, ou seja, ao
final da execução da análise de um critério poderão ser produzidas tantas justificativas quantas regras existam neste critério.
Página 12
Informações geradas por uma política de análise
Uma política de análise gerará tanta informação quantos critérios forem utilizados em sua construção. Toda política de análise do
Crivo gera 02 (dois) grupos de informações.
Informações configuradas no critério
Baseadas nas regras definidas pelo Administrador do Crivo e, portanto geradas na execução do critério.
Respostas
Produzidas por todos os critérios envolvidos na política de análise.
Sistemas
Limites
Produzidos por todos os critérios envolvidos na política de análise.
Pontos
Produzidos por todos os critérios envolvidos na política de análise.
Justificativas
Informações Básicas
Coletadas pelo Crivo através dos Drivers utilizados na construção dos critérios ou geradas pelo Crivo durante a execução da
operação.
Variáveis ponderadas
Apenas as variáveis cujo conteúdo foi utilizado durante a execução da política de
análise.
Variáveis coletadas
Todas as variáveis coletadas por um Driver Crivo em um produto de uma fonte de
informação durante a execução da política, inclusive as "variáveis ponderadas".
Variáveis criadas
Conteúdos formados através de cálculos pré-configurados nas regras antes do início da
execução da operação.
Relatórios dos Drivers Crivo
Formatação dos dados coletados na fonte em formato de relatório. Não contém
obrigatoriamente todas as "variáveis coletadas".
Exemplos de políticas de análise
A seguir apresentamos alguns exemplos de políticas de análise possíveis de serem construídas no Crivo. Seus resultados são
destacados e comentados nos exemplos para melhor entendimento. É importante lembrar que todo critério gera "Resposta",
"Pontos", "Limite" e "Justificativa" independente de sua posição em uma política de análise:
Exemplo 1
Neste exemplo mostramos a utilização da ação “delega decisão a”, ou seja, um critério delega a decisão a outro critério da política
de análise.
Página 13
CRITÉRIO A
delega
CRITÉRIO B
Decisão Final (F)
delega
CRITÉRIO C
O critério C é o responsável pela
geração da "Resposta", "Limite",
"Pontos" e "Justificativas" das
operações
executadas
no
"Exemplo 1", porém todas as
informações produzidas pelos
critérios A, B e C estão disponíveis
Exemplo 2
Mostramos neste exemplo a situação em que um critério solicita pontos para outro critério da política de análise.
Decisão Final (F)
CRITÉRIO D
Solicita
pontos para
CRITÉRIO E
Neste exemplo o critério D é o
responsável pela geração da "Resposta",
"Limite", "Pontos" e "Justificativas" finais
da operação.
Solicita
pontos para
CRITÉRIO F
Exemplo 3
Neste exemplo mostramos a situação em que um critério solicita pontos e limite para outros critérios, que por sua vez delega a
decisão à outro critério da política de análise, que solicita pontos e limite para outros critérios da política de análise.
Página 14
CRITÉRIO A
Solicita pontos para
Solicita limite para
CRITÉRIO B
CRITÉRIO C
delega
Decisão Final (F)
responsável pela geração da
"Resposta", "Limite", "Pontos" e
"Justificativas" finais da operação
CRITÉRIO
D
CRITÉRIO E
CRITÉRIO F
Exemplo 4
Neste exemplo mostramos a situação em que um critério com objeto de análise.
CRITÉRIO
OA
A
CRITÉRIO
CRITÉRIO
B
C
delega
Decisão Final (F)
CRITÉRIO
D
responsável pela geração da
"Resposta", "Limite", "Pontos" e
"Justificativas" finais da operação.
Página 15
Fluxo de uma operação no Crivo
Início
 O usuário se
identifica na
Interface Browser
Seleciona o menu
Individual na barra
lateral esquerda
 Seleciona o
critério na barra
lateral direita
Fim
 Informa os
parâmetros
apresentados em
tela (pelo menos os
obrigatórios) e clica
no botão
Buscar/Executar
Uma
operação
é
caracterizada por um
conjunto
de
parâmetros de entrada,
sejam eles obrigatórios
ou não, de mesmo tipo
não repetido.
 A coleta dos
dados é realizada e
o resultado
apresentado em
tela
Uma
análise
é
aplicação/execução de
um critério.
Uma decisão é
gerada com base
em
uma
combinação
de
análises.
Legenda:
 Quando um usuário se identifica no Sistema são determinadas:

Quais as permissões que o usuário logado possui.

Quando coletando dados de fontes tarifadas (Serasa, SPC Brasil, Equifax, Megadata, dentre outros) quais
identificações, como por exemplo, código e senha deverão ser utilizados.
 Quando é solicitada uma operação é verificado o "Grupo" ao qual o usuário logado que solicitou a operação pertence:

Se a permissão de uso “Permitir a escolha do critério para gerar operação” estiver marcada o usuário deverá
definir qual política será utilizada e informá-la.

Se a permissão de uso “Permitir a escolha do critério para gerar operação” estiver desmarcada o usuário deverá
escolher entre política de análise jurídica ou física.
 A partir das escolhas anteriores o Crivo solicita os parâmetros de entrada (obrigatórios e não obrigatórios) baseados na
política de análise (jurídica ou física). O usuário informa esses parâmetros e solicita a execução. Neste momento são feitas as
seguintes verificações:

Os parâmetros informados são válidos?

Há dados válidos (prazo de validade) na Base de Dados para os parâmetros fornecidos? Caso contrário será
iniciado o processo de coleta externa.
 Os dados obtidos pelos drivers são compactados e armazenados no Banco de Dados do Crivo no formato em que foram
coletados.
As variáveis utilizadas nos critérios são carregadas e as políticas de análise executadas conforme o fluxo determinado pelo
Administrador do Crivo.
Ao término da execução das políticas de análise serão fornecidos os seguintes dados baseados nas permissões do "Grupo" a
que pertence o usuário:








Código de operação
Variáveis ponderadas
Relatórios
Resposta
Sistema
Pontos
Limite
Justificativa
Página 16
Página 17
API C REDITTALK
A ’API Credittalk’ possibilita o desenvolvimento de aplicações, através de protocolos padrões, para integração ao Crivo o que
permitirá:

A submissão de análises ao Crivo;

A obtenção:
o
Do detalhamento da política de análise submetida;
o
Do layout da informação de entrada para um determinado usuário;
o
De relatórios dos dados obtidos nas fontes;
o
Dos códigos de operação a partir de parâmetros submetidos para execução de política.
É importante dizer que na ’API Credittalk’ não é possível acessar as funções administrativas do Crivo, pois estas devem ser
realizadas pela Interface Browser ou pelo Administrador do Crivo.
Estrutura da ‘API Credittalk’
A ’API Credittalk’ possui comandos simples formados por uma string na seguinte forma:
<COMANDO> <Parâmetro1>,<Parâmetro2>,...,<ParâmetroN>

Exceto para os comandos ‘EVAL’ e ‘OPSEARCH’, cujos parâmetros são separados por um par ‘CR+LF’ (caracteres 13 e 10), as
respostas dos demais comandos da ’API CreditTalk’ sempre serão "strings". Caso o comando retorne mais de uma linha de resposta,
as "strings" serão separadas por ‘CR+LF’, como num arquivo texto comum.

No caso de parâmetros do tipo "string", não é necessário utilizar nenhum delimitador especial, como parênteses e aspas, por
exemplo.

No caso dos parâmetros numéricos somente são aceitos valores de 27 (vinte e sete) dígitos.
Formas de acesso
Há 03 (três) formas de acesso à ’API CreditTalk’:

Componentes COM

BSD/Sockets

Web Services
A ’API CreditTalk’ é essencialmente a mesma, bem como os comandos, mudando apenas a maneira como são enviados.
Página 18
Componentes COM
Os comandos são enviados através de métodos ou de funções que sempre retornam "strings". Para tanto, a "type library" da ‘API
CreditTalk’ deve estar registrada nas estações onde o sistema de integração será desenvolvido ou iniciará a comunicação com o
Servidor Crivo.
Para isso, durante o processo de instalação do Crivo, o instalador cria uma aplicação COM+ que encapsula os arquivos necessários
à integração, aplicação esta denominada CreditTalk.
A comunicação, nesse caso, será via componente COM. Não há comandos de controle de seção e de Servidor, como é o caso da
comunicação via BSD/Sockets descrita a seguir, pois isto é provido pelos mecanismos nativos do COM.
Depois de instalado o "application proxy" exportado do servidor Crivo na máquina cliente, o nome do componente a ser
instanciado é ‘CredittalkCOM.Credittalk’, já a interface é a ‘CredittalkAPI.ICredittalk’.
Parte da definição da interface segue abaixo com 02 (dois) métodos e 06 (seis) funções, nos formatos:
Visual Basic
Sub Login(ByVal sUser As String, ByVal sPassword As String)
Function Layout() As String
Function Eval(ByVal sParametros As String) As String
Function Explain() As String
Function Values() As String
Function Sources() As String
Sub Refresh()
Function Report (ByVal sDriver As String, ByVal sProduto As String) As
String
Function Loadlog(ByVal sCodigodeOperacao As String) As String
IDL
HRESULT Login([in] BSTR sUser, [in] BSTR sPassword);
HRESULT Layout([out, retval] BSTR* rhs);
HRESULT Eval([in] BSTR sParametros, [out, retval] BSTR* rhs);
HRESULT Explain([out, retval] BSTR* rhs);
HRESULT Values([out, retval] BSTR* rhs);
HRESULT Sources([out, retval] BSTR* rhs);
HRESULT Refresh();
HRESULT Report ( [in] BSTR sDriver, [in] BSTR sProduto, [out, retval]BSTR* rhs);
HRESULT Loadlog([in] BSTR sCodigodeOperacao, [out, retval] BSTR* rhs);
Página 19
BSD/Sockets
Através dessa forma de comunicação, os comandos são enviados a uma porta 7000 em uma seção TCP terminados pelo caractere
CR (caractere 13). Todos os retornos são "strings", terminadas por ‘CR+LF’ (caracteres 13 e 10). Há comandos específicos de seção
e de identificação de Servidor, descritos nos tópicos a seguir deste manual.
Web Services
Os comandos são enviados e retornados via SOAP. É necessário manter o estado da seção entre as requisições (métodos da API) de
uma operação. No ‘Microsoft .Net Framework’ deve ser definida a propriedade ‘CookieContainer’. Para obter mais informações
sobre esta propriedade acesse http://msdn.microsoft.com/en-us/library/system.net.httpwebrequest.cookiecontainer.aspx.
Exemplo de uso:
CreditTalkV4.CreditTalkVersion4 ctv4 = new CreditTalkV4.CreditTalkVersion4();
ctv4.CookieContainer = new System.Net.CookieContainer();
Caso não seja mantida a seção ocorrerá o erro abaixo:
CrivoException.CTException: CTERROR#7#CreditTalk Command invalid in this context
Para obter o ‘WSDL’ com a descrição da ‘Web Service’ acesse:

http://homologacao.crivo.com.br/ws/credittalkversion4.asmx?WSDL
Para obter o ‘WSDL’ com a descrição da ‘Web Service Stateless’ acesse:

http://homologacao.crivo.com.br/ws/CreditTalkStateless.asmx?WSDL
Para obter a descrição dos formatos das mensagens ‘SOAP’ acesse:

http://homologacao.crivo.com.br/ws/credittalkversion4.asmx
Para acessar estas informações a partir do Servidor Crivo instalado, basta trocar a string ‘homologação.com.br’ pelo endereço correto.
Diagramas de Sequência
Nos Diagramas de Sequência a seguir podem ser visualizadas situações simples e complexas da troca de mensagens entre a
aplicação cliente e a ’API CreditTalk’ do Crivo:
Página 20
Exemplo 1
Neste exemplo a permissão de uso “Permitir a escolha do critério para gerar operação” está desmarcada, ou seja, o usuário
deverá escolher entre política de análise jurídica ou física.
Exemplo 2
Neste exemplo a permissão de uso “Permitir a escolha do critério para gerar operação” está marcada, ou seja, o usuário deverá
definir qual critério/política será utilizada.
Exemplo 3
Mostramos neste exemplo a recuperação de uma operação executada anteriormente e a solicitação de relatório em HTML.
Página 21
Exemplo 4
Neste exemplo mostramos a recuperação de uma operação executada anteriormente, com solicitação de variáveis e justificativas
pontuadas na operação.
Página 22
Exemplo 5
Mostramos neste exemplo a solicitação de layout antes da operação, com a identificação dos drivers e produtos utilizados na
consulta antes da solicitação do relatório em HTML.
Página 23
Exemplo 6
Neste exemplo mostramos a solicitação de busca utilizando o comando ‘OPSearch’ para retornar as operações, baseado nos
parâmetros utilizados para execução das políticas de decisão.
Diagramas de Estados
Definição das regras de utilização da ’API CreditTalk’ do Crivo.
Página 24
Comandos da API CreditTalk do Crivo
Os comandos da ‘API CreditTalk’ são disponibilizados de acordo com a versão especificada no comando "CT Version".
Trataremos neste manual somente da última versão “CT Version 4”. Por isso, é importante observar que nem todos os comandos
da versão 4 estão disponíveis nas versões anteriores.
Execute o comando "?" após o "CT Version X" para identificar os comandos disponíveis em uma determina versão. Os valores
retornados e aceitos podem conter valores de 27 (vinte e sete) dígitos sem o sinal.
CT VERSION
Este comando serve para a identificação de versão da ’API CreditTalk’. É um comando específico para conexão via BSD/Sockets.
Deve ser o 1º (primeiro) comando a ser executado, antes mesmo do CT LOGIN.
Sintaxe:
CT VERSION VERSAO<CR+LF>
Parâmetros:
VERSAO: Número da versão da ‘API CreditTalk’ (O valor a ser utilizado é o 4). Tem por função compatibilizar com versões
anteriores e futuras.
Retorno de sucesso:
OK
Retorno de erro:
CTERROR#6#Number Expected
LOGIN
Este comando realiza o login de um usuário no Crivo. No caso do acesso a ’API CreditTalk’ ser feito via BSD/Sockets, o comando
LOGIN deverá ser precedido do comando CT VERSION.
Caso o acesso a ’API CreditTalk’ seja feito via DCOM, esse deve ser o 1º (primeiro) comando a ser executado. Todos os demais
falharão se este falhar ou não for executado. Este comando necessita ser executado apenas 01 (uma) vez por seção iniciada.
Sintaxe:
LOGIN USER, PWD<CR+LF> (Via BSD/Sockets usar CT LOGIN)
Página 25
Parâmetros:
USER
Nome do usuário
PWD
Senha do usuário
Retorno de sucesso:
OK
Retorno de erro:
CTERROR#2#Login Failed
LAYOUT
Este comando retorna os layouts das informações de entrada e de saída para o usuário autenticado no Crivo no momento da
execução do comando.
O retorno é feito em várias linhas distribuídas em 03 (três) formatos distintos, dependendo da informação que elas contêm. Os 03
(três) tipos de linhas e seus formatos são:

Linha Input

Linha Source

Linha Variable
Sintaxe:
LAYOUT<CR+LF>
Retorno de sucesso:
Linha Input: Contém as informações de entrada.
IDENTIFICAÇÃODALINHA1;TIPOCONSULTA;PARÂMETRO
IDENTIFICAÇÃODALINHAN;TIPOCONSULTA;PARÂMETRO
Sendo:
IDENTIFICAÇÃODALINHA
String que identifica o tipo de informação apresentada na linha.
Nesse caso, seu conteúdo é a literal ‘INPUT’
TIPOCONSULTA
PARÂMETRO
Tipos de consultas disponíveis. Apenas o caractere:

‘E’ para jurídica e

‘P’ para física
São os parâmetros de entrada que devem ser passados ao Crivo dependendo da consulta que se quer realizar
Página 26
Linha Source: Possíveis fontes de informação a serem consultadas.
IDENTIFICAÇÃODALINHA1;TIPOCONSULTA;DRIVER;PRODUTO
IDENTIFICAÇÃODALINHAN;TIPOCONSULTA;DRIVER;PRODUTO
Sendo:
DRIVER
String com o nome do driver disponível para a coleta de dados.
PRODUTO
String com o nome do produto disponível para a coleta de dados.
Linha Variable: Contém as informações de saída. Como são as últimas, dentre os 03 (três) tipos de linha retornados, sua finalização
é através da string ‘OK’ na última linha.
IDENTIFICAÇÃODALINHA1;TIPOCONSULTA;DRIVER;PRODUTO;VARIÁVEL
IDENTIFICAÇÃODALINHAN;TIPOCONSULTA;DRIVER;PRODUTO;VARIÁVEL
OK
Sendo:
VARIÁVEL
String com o nome das variáveis disponíveis.
Retorno de erro:
CTERROR#<Descrição do erro>
EVAL
Este comando solicita ao Crivo a execução de uma política de análise.
Os parâmetros são passados linha a linha, separados por ‘CR+LF’. Após todos os parâmetros serem informados deve-se fornecer
outro ‘CR+LF’ para que a análise dos dados fornecidos seja realizada.
Será gerada uma operação, o retorno desta operação terá um mínimo de 02 (duas) linhas, ou o número de linhas correspondentes
à quantidade de critérios definidos em cascata. A resposta final do critério sempre será identificada pelo caractere “F”, ao final da
linha.
Uma última variação do retorno é para os casos em que são definidos, para o grupo do usuário, políticas de análise que disparam
em paralelo. Nesse caso, o retorno se dará no mínimo em tantas linhas quantos forem as políticas de análise paralelas definidas,
podendo essa quantidade aumentar caso haja cascatas de políticas de análise. Para as políticas de análise em paralelo haverá, para
a resposta de cada um, um último caractere igual a "F" na linha de retorno e, no caso de haver cascata em alguma política de
Página 27
análise, a regra é a mesma definida anteriormente, ou seja, apenas a resposta final (Sistema) será identificada pelo último caractere
igual a "F".
Caso tenha sido utilizado o recurso para análises de pessoas físicas e jurídicas na mesma política de análise haverá a necessidade da
especificação dos objetos de análise envolvidos no processo. Neste caso, recomendamos verificar com o Administrador do Crivo a
necessidade de tratamento para objetos de análise.
Sintaxe:
EVAL<CR+LF>TIPOCONSULTA<CR+LF> (Via BSD/Sockets usar CT EVAL)
PARÂMETRO1;VALOR1<CR+LF>
PARÂMETRON;VALORN<CR+LF>OBJETODEANALISE<CR+LF>PARÂMETRO1;VALOR1<CR+LF>
PARÂMETRON;VALORN<CR+LF><CR+LF>
Parâmetros:
TIPOCONSULTA


PARÂMETRO
String (case sensitive) contendo o nome do parâmetro obtido através do LAYOUT.
VALOR
Valor do respectivo parâmetro
OBJETODEANALISE
Objeto que receberá os parâmetros complementares, sendo responsabilidade do
Administrador do Crivo a sua criação ou não.
Retorno para critério único:
CÓDIGOOPERACÃO
CRITÉRION;RESULTADON;INDICADORFINAL
OK
Retorno para critérios em cascata:
CÓDIGOOPERACÃO
CRITÉRIO1;RESULTADOA;INDICADORFINAL
CRITÉRIO2;RESULTADOB
CRITÉRIO3;RESULTADOC
CRITÉRION;RESULTADON
OK
Retorno para critérios em paralelo:
CÓDIGOOPERACÃO
CRITÉRIO2;RESULTADOBCRITÉRIO3;RESULTADOC;INDICADORFINAL
OK
Página 28
Sendo:
CÓDIGOOPERAÇÃO
String alfanumérica de até 07 (sete) caracteres que identifica unicamente a operação realizada.
CRITÉRIO
String livre definida pelo responsável pela criação dos critérios com o nome do critério utilizado para
realizar a coleta de dados.
RESULTADO
Uma string livre (definida pelo responsável pela criação dos critérios) que conterá o resultado do
critério.
INDICADORFINAL
Conterá o caractere "F" indicando a resposta final do fluxo de análise.
EXPLAIN
Este comando retorna um arquivo XML com as justificativas definidas na política executada considerando as definições de
configuração (Administrador do Crivo/ Estrutura Corporativa/Grupo/Permissões Globais):

Ver somente operações do seu Grupo: Se o Grupo do usuário não executou a operação, este usuário nem chegará ao
comando EXPLAIN porque ele não conseguirá o retorno do comando LOADLOG (mensagem apresentada: CTERROR#25# User don't have permission);

Ver somente operações do seu Centro de Custo: Se o Grupo do usuário não executou a operação, este usuário nem
chegará ao comando EXPLAIN porque ele não conseguirá o retorno do comando LOADLOG (mensagem apresentada:
CTERROR#25# - User don't have permission);

Ver explicação dos pontos no resultado da operação: Se esta permissão estiver desmarcada as justificativas de ponto
(tag <justificativaPontos>) definidas na política não serão apresentadas no arquivo XML gerado pelo método EXPLAIN;

Ver explicação do limite no resultado da operação: (Se esta permissão estiver desmarcada as justificativas de limite (tag
<justificativaLimite>) definidas na política não serão apresentadas no arquivo XML gerado pelo método EXPLAIN.
O comando EXPLAIN deve ser executado somente após o comando EVAL (operação corrente) ou LOADLOG (resgate de operação).
E, para operações de objeto de análise é necessário executar o comando LOADLOG antes do comando EXPLAIN.
Sintaxe:
EXPLAIN<CR+LF>
Retorno:
<justificativas>
<justificativaVariaveis>
<justificativaNulas>
<justificativaPontos>
<justificativaLimite>
<justificativaTextual>
</justificativas>
As justificativas podem se repetir*
*A ordem das ações na política interferem na apresentação das justificativas.
As ações: “Adiciona à Justificativa”, “Adicionar ao Limite” e/ou “Adicionar aos Pontos” são todas apresentadas no arquivo,
tantas quanto forem adicionadas na política.
Já as ações: “Define Justificativa”, “Define Limite” e/ou “Define Pontos” tem o seguinte comportamento:
Página 29

Se a ação “define” for a final do critério então será apresentado o retorno apenas a última ação “define”.

Se após a ação “define” houver uma das ações “adiciona”, citadas anteriormente, então serão apresentados os retornos
das ações “define” mais os retornos das ações “adiciona”.
Exemplos:
RETORNOS
Exemplo 1:
<justificativaPontos criterio="Criterio ABC PF" total="-1,00">
<regra>
<motivo><texto>Padrão</texto></motivo>
<valor><numero>-1,00</numero></valor>
</regra>
</justificativaPontos>
DESCRIÇÃO
<justificativaVariaveis>, <justificativaNulas>, <justificativaPontos>,
<justificativaLimite> e <justificativaTextual>
Possíveis retornos. São apresentados considerando o uso na política e a
permissão de visualização do usuário que gera a operação.
Este retorno é apresentado ao final do bloco correspondente ao critério à
que se refere à substituição sempre que houver substituição automática de
valores nulos no critério. Se o dado do campo for do tipo:
Lógico: será apresentado “Falso” ou “Verdadeiro”.
Exemplo 2:
<justificativaPontos criterio="Criterio ABC SRF" total="15,82">
<regra>
<motivo><formula>=1==2</formula><valor>FALSE</valor></motivo>
<valor><numero>15,00</numero></valor></regra>
<regra><motivo>
<formula>=e(3/3<>0;DISTANCIATEXTO([Trocar letras - coletado];[Trocar letras digitado])==30%)</formula>
<valor>FALSE</valor></motivo>
<valor><formula>=DISTANCIATEXTO([Trocar letras - coletado];[Trocar letras digitado])</formula><valor>0,82</valor></valor>
</regra>
Lista: será apresentado o texto “Comparações em fórmula com a variável
resultarão em falso”.
Data: será apresentada a data no formato dd/mm/aaaa hh:mm:ssss.
Número: será apresentado o valor atribuído na substituição (sem vírgula)
Este retorno é apresentado somente se o critério possuir o elemento “Minhas
Variáveis”.
Se o valor de retorno do elemento “Minhas Variáveis” for de um Driver será
identificado no arquivo como "Variavel driver= " (a letra “V” de forma
maiúscula). Entretanto, se o Driver for referenciado dentro da expressão será
identificado no arquivo como “variavel nome= “ (a letra “v” de forma
minúscula). Veja exemplo 3 ao lado.
criterio="Criterio ABC PF" total="-1,00"
Exemplo 3:
<variavel nome="Trocar letras - digitado"><formula>a=[Tira os da e do - digitado]
=substituir(substituir(substituir(a;"k";"c");"w";"v");"z";"s")</formula><valor>Julian
MarcuirSilva</valor></variavel>
<variavel nome="Tira os da e do - digitado"><formula>a=[Nome]
=substituir(substituir(substituir(substituir(substituir(a;" da ";"");" de ";"");" dos ";"");"
das ";"");" do ";"")</formula><valor>Julian MarcuirSilva</valor></variavel>
<variavel nome="Trocar letras - coletado"><formula>a=[Tira os da e do - coletado]
=substituir(substituir(substituir(a;"k";"c");"w";"v");"z";"s")</formula><valor>Comparaç
ões em fórmula com a variável resultarão em falso</valor></variavel>
<variavel nome="Tira os da e do - coletado"><Variavel driver="SRF"
produto="Situacao Cadastral do CPF" nome="Lista - Erro na consulta">Comparações
em fórmula com a variável resultarão em
falso</Variavel></variavel></justificativaVariaveis>
Equivalem a algumas informações (Critério, Pontos, Limites) da linha
“Resultados” do relatório “Resultado da Operação” da Interface Browser do
Crivo.
O bloco de justificativas é apresentado por critério, do primeiro executado e
não daquele que traz necessariamente a resposta final. Sendo assim, o uso
da ação “delega decisão à” não muda a ordem de apresentação dos critérios.
<regra>
Regra aplicada para chegar ao resultado, não necessariamente é uma regra
de critério.
<texto>
Texto pré-configurado. Neste caso, obtido da configuração de “Valores
padrão” da área de “Pré-execução” do critério.
<formula>
Caso tenha sido definida uma fórmula para obter a pontuação, o retorno
neste caso será <formula> ao invés de <texto>.
Se os símbolos “<” e “>” forem utilizados nas fórmulas, serão representados
no arquivo pelos seguintes símbolos:
&lt - equivalente a “<”
&gt - equivalente a “>”
Padrão / Erro / Sem parâmetro para execução / Conteúdo de uma fórmula
Padrão: retorno padrão.
Erro: quando ocorrer erro na execução.
Sem parâmetro para execução: quando este recurso estiver ligado e algum
parâmetro necessário para a execução do critério não for informado
Conteúdo de uma fórmula: quando for definida uma fórmula para obter a
pontuação e a tag de retorno for <formula>, logo após esta tag será
apresentada a fórmula definida, como no exemplo 2 ao lado.
<valor> <numero>
Valores de 27 (vinte e sete) dígitos sem sinal:
Ponto: É a pontuação efetiva expressa em valor.
Limite: É o limite concedido expresso em valor.
Página 30
VALUES
Solicita os valores coletados pelo driver na fonte para o qual foi construído.
Somente pode ser executado após o comando EVAL (operação corrente) ou após a execução do LOADLOG (para operações
provenientes de objeto de análise ou qualquer outra operação realizada).
Sintaxe:
VALUES<CR+LF>
Retorno:
DRIVER;PRODUTO;VARIÁVEL;VALOR
OK
Sendo:
DRIVER
String com o nome do driver utilizado para realizar a coleta de dados
PRODUTO
String com o nome do produto utilizado para realizar a coleta de dados.
VARIÁVEL
String com o nome da variável analisada.
VALOR
Valores de 27 (vinte e sete) dígitos sem sinal, indicando o valor da variável ou uma string
A sequência do retorno do comando Values pode ser modificada quando houver alguma alteração na política de critérios, como por
exemplo, a inclusão ou remoção de uma nova regra.
SOURCES
Assim como o EXPLAIN, só poderá ser executado após o comando EVAL ou LOADLOG, pois solicita os drivers e os produtos
utilizados para a execução da política de análise.
Sintaxe:
SOURCES<CR+LF>
Retorno:
DRIVER;PRODUTO;DATADAINFORMAÇÃO
OK
Sendo:
DRIVER
String com o nome do driver utilizado para realizar a coleta de dados.
PRODUTO
String com o nome do produto utilizado para realizar a coleta de
dados.
DATADAINFORMAÇÃO
String "Atualizado" ou a data no formato dd/mm/aaaa em que a
informação utilizada na análise foi obtida no cache.
Página 31
REFRESH
Este comando ignora o prazo de validade definido para as informações coletadas anteriormente. Equivale ao "Atualiza
Informações" da tela de consulta do Crivo e deve ser executado antes do comando EVAL.
Sintaxe:
REFRESH<CR+LF>
Retorno de sucesso:
OK
Retorno de erro:
CTERROR#<Descrição do erro>
REPORT
Este comando relata os resultados de uma determinada análise e tem como parâmetros de entrada "driver" e "produto", que
podem ser recuperados a partir do resultado do comando "Sources".
Sintaxe:
REPORT DRIVER, PRODUTO<CR+LF>
Parâmetros:
DRIVER
String com o nome do "driver" utilizado para realizar a coleta de dados.
PRODUTO
Retorno:
HTML contendo o relatório solicitado.
LOADLOG
Recupera uma operação (decisão, parâmetros, dados coletados) a partir do código de operação, após a sua execução passa a ser
equivalente ao comando EVAL, pois todos os comandos passam a estar disponíveis para o código de operação fornecido.
Sintaxe:
LOADLOG CÓDIGOOPERACÃO<CR+LF>
Página 32
Parâmetros:
String alfanumérica de 07 (sete) caracteres contendo o código da
operação da decisão que se deseja recuperar
CÓDIGOOPERACÃO
Retorno:
CÓDIGOOPERACÃO
OK
Sendo:
CÓDIGOOPERACÃO
String alfanumérica de 07 (sete) caracteres contendo o código da operação
da decisão que se deseja recuperar
CRITÉRIO
String livre (definida pelo responsável pela criação dos critérios) com o
nome do critério utilizado para realizar a avaliação de crédito.
RESULTADO
Uma string livre (definida pelo responsável pela criação dos critérios) que
conterá o resultado do critério.
INDICADORFINAL
Retorno:
CTERROR#13#Consulta não encontrada.
SETPOLICY
Este comando permite definir por qual critério serão analisados os parâmetros fornecidos antes de executar o comando EVAL.
É necessário caso a permissão de uso “Permitir a escolha do critério para gerar operação” esteja marcada no cadastro do Grupo
a que pertence o usuário autenticado.
Sintaxe:
SETPOLICY CRITERIO<CR+LF>
Parâmetros:
CRITERIO
Nome do critério a ser analisado, pode ser obtido através do comando LAYOUT.
Retorno de sucesso:
OK
Retorno com erro:
Critério para tomada de decisão, não encontrado.
COMMAND
Relata os resultados de uma determinada análise e tem como parâmetros de entrada "driver", "produto" e "comando". Assim como
os comandos EXPLAIN e SOURCES, o comando COMMAND só pode ser executado após o comando EVAL ou LOADLOG.
É importante ressaltar que cada "driver" possuirá o seu próprio comando.
Página 33
Sintaxe:
COMMAND driver,produto,comando<CR+LF>
Parâmetros:
DRIVER e PRODUTO
Ambos podem ser obtidos através do comando LAYOUT.
Retorno de sucesso:
Verificar com a Crivo quais "drivers" possui tal função.
Retorno com erro:
Verificar com a Crivo quais "drivers" possui tal função.
LOADPDF
Assim como os comandos EXPLAIN e SOURCES, o comando LOADPDF só pode ser executado após o comando EVAL ou LOADLOG.
O comando LOADPDF devolve um array de bytes em que os 04 (quatro) primeiros bytes são os números de bytes subsequentes
para a formação do arquivo PDF.
Sintaxe:
LOADPDF<CR+LF>
Retorno de sucesso:
Arquivo [nomedoarquivo.pdf] criado com sucesso
PARAMETERS
Assim como o EXPLAIN, o comando PARAMETERS só poderá ser executado após o comando EVAL ou LOADLOG, pois solicita os
parâmetros e valores utilizados para a execução da política de análise.
Sintaxe:
PARAMETERS<CR+LF>
Retorno com sucesso:
PARAMETRO;VALOR<CR+LF>
OK
Sendo:
PARAMETRO
String com o nome do parâmetro utilizado para a execução da política de análise.
VALOR
String com o valor do parâmetro utilizado para a execução da política de análise.
Retorno com erro:
CTERROR#13#Consulta não encontrada.
Página 34
OPSEARCH
Este comando busca no Crivo as operações realizadas. Todas as maneiras de escrita serão contempladas na busca, como por
exemplo:

Busca por: João da Silva

Resultado: João da Silva, JOÃO DA SILVA, joão da silva, Joao da Silva, JOAO DA SILVA, joao da silva
O primeiro parâmetro é QUANTIDADEDIAS, que deve ser passado logo após o comando OPSEARCH, os outros parâmetros
PARÂMETRO;VALOR são passados linha a linha, separados por CR+LF. Após todos os parâmetros serem informados deve-se
fornecer outro CR+LF para que a busca das operações seja realizada.
Sintaxe:
OPSEARCH QUANTIDADEDIAS<CR+LF> (Via BSD/Sockets usar CT OPSEARCH)
PARÂMETRON;VALORN<CR+LF>
Parâmetros:
QUANTIDADEDIAS
Quantos dias passados o Crivo deve fazer a busca.
Exemplo: A data atual é 31/01/2011, foi passado como QUANTIDADEDIAS o valor ‘10’ (dez), então
o Crivo retornará as operações que ocorreram entre 22/01/2011 e 31/01/2011.
PARÂMETRO
String (case sensitive) contendo o nome do parâmetro obtido através do comando LAYOUT ou
PARAMETERS.
VALOR
Valor do respectivo parâmetro.
Retorno com sucesso:
DATA;HORA;CÓDIGOOPERACÃO<CR+LF>
OK
Sendo:
DATA
Data da Operação no formato (yyyy-MM-dd).
Exemplo: 2011-01-31
HORA
Hora da Operação no formato (HH:mm).
Exemplo: 14:15
CÓDIGOOPERAÇÃO
String alfanumérica de até 07 (sete) caracteres que identifica unicamente a operação realizada.
Retorno com erro:
Se não for passado QUANTIDADEDEDIAS, retorna CTERROR#18#Expected parameters
Se não for passado nenhum PARAMETRO;VALOR, retorna CTERROR#5#Parameter Missing
Se não houver nenhuma Operação com os parâmetros passados, retorna CTERROR#13#Consulta não encontrada
Página 35
STMONAs linhas com PARAMETRO;VALOR que não estiverem neste formato, utilizando o ";" (ponto e vírgula) como separador serão ignorados
como parâmetro de busca.
Este comando que passa via WebService às informações do relatório.
Parâmetros:
Data
Data da operação no formato (dd/MM/yyyy HH:mm:ss)
Exemplo: 29/04/2010 20:50:55
Operacao
String alfanumérica de até 07 (sete) caracteres que
identifica unicamente a operação realizada.
TempoC
Tempo da Consulta em ms
TempoL
Tempo da Lista Variáveis em ms
TempoF
Tempo do Formata em ms
TempoBusca
Tempo do Busca Cache em ms
TempoBuscaCont
Tempo do Busca Contingência em ms
Tentativas
Número de tentativas
Codigo Erro
Código do erro
Erro
Mensagem do erro
Atualizada
Buscou informação online na fonte
Contingencia
Buscou informação dentro da validade no banco de dados
Driver
Driver utilizado na coleta
Produto
Produto utilizado na coleta
HELP
Este comando lista todos os comandos disponíveis e sua sintaxe básica. É um comando específico para conexão via BSD/Sockets.
Sintaxe:
HELP<CR+LF>
Retorno:
CT COMANDO 1<CR+LF>
CT COMANDO 2<CR+LF>
CT COMANDO 3<CR+LF>
CT COMANDO N<CR+LF>
Sendo:
COMANDO 1 a COMANDO N
Strings separadas por CR+LF contendo os comandos aceitos pela ‘API Credittalk’.
Página 36
Envio:
HELP
Retorno:
VERSION
LOGIN
LAYOUT
REFRESH
EVAL
EXPLAIN
SOURCES
VALUES
LOADLOG
BATCH START
BATCH STATUS
BATCH EXTRACT
BATCH ERRORS
PARAMETERS
OPSEARCH
HELP
?
QUIT
OK
QUIT
Este comando encerra uma seção. A seção também pode ser encerrada simplesmente fechando o socket ou pelo identificador de
fim de arquivo. É um comando específico para conexão via BSD/Sockets.
Sintaxe:
QUIT<CR+LF>
Erros
Este comando retorna os erros identificados por uma string de retorno da seguinte forma:
Retorno:
CTERROR#NNN#ERRORMESSAGE
Sendo:
CTERROR
String constante.
NNN
Inteiro de 32 bits com sinal contendo o código de erro
ERRORMESSAGE
Mensagem descritiva do erro ocorrido
Página 37
Comandos da API CreditTalk Stateless
A ‘API CreditTalk Stateless’ foi desenvolvida para possibilitar o desenvolvimento de aplicações que sejam integradas ao Crivo,
iniciando operações com o mesmo, obtendo respostas em tempo real, sem necessidade de manter estado entre as chamadas. É
disponibilizada como Web Services. Os comandos disponíveis são:
EVAL
Solicita ao Crivo a execução de uma política de análise.
Os parâmetros são passados, separados por CR+LF. Após todos os parâmetros serem informados deve-se fornecer outro CR+LF
para que a análise dos dados fornecidos seja realizada.
O retorno desta operação ocorrerá em, no mínimo, 02 (duas) linhas e, no máximo, em tantas linhas quantos forem os critérios
definidos em cascata, sendo que a última linha é em ambos os casos definida pelo último caractere igual a "F", indicando a resposta
6
final .
Uma última variação do retorno é para os casos em que são definidos, para o grupo do usuário, políticas de análise que disparam
em paralelo. Nesse caso, o retorno se dará no mínimo em tantas linhas quantos forem às políticas de análises paralelas definidas,
podendo essa quantidade aumentar caso haja cascatas de políticas de análise.
Para as políticas de análise em paralelo haverá, para a resposta de cada um, um último caractere igual a "F" na linha de retorno e,
no caso de haver cascata em alguma política de análise, a regra é a mesma definida acima: apenas a resposta final (Sistema) será
identificada pelo último caractere igual a "F".
Caso tenha sido utilizado o recurso para análises de pessoas físicas e jurídicas na mesma política de análise haverá a necessidade da
especificação dos objetos de análise envolvidos no processo. Verifique com o Administrador do Crivo a necessidade de tratamento
para objetos de análise.
Sintaxe:
EVAL(string usuario, string senha, string parametros)
Parâmetros:
TIPOCONSULTA<CR+LF>
PARÂMETRON;VALORN<CR+LF>OBJETODEANALISE<CR+LF>PARÂMETRO1;VALOR1<CR+LF>
6
A exibição das respostas dos critérios está condicionada à opção "Mostrar Respostas" na funcionalidade Edição de Políticas, e na funcionalidade Estrutura Corporativa
"Ver explicação da resposta", no Administrador do Crivo.
Sendo:
TIPOCONSULTA


PARÂMETRO
String (case sensitive) contendo o nome do parâmetro obtido através do LAYOUT.
VALOR
Valor do respectivo parâmetro
OBJETODEANALISE
Objeto que receberá os parâmetros complementares, sendo responsabilidade do
Administrador do Crivo a sua criação ou não.
Retorno para critério único:
CÓDIGOOPERACÃO
OK
Retorno para critérios em cascata:
CÓDIGOOPERACÃO
CRITÉRIO3;RESULTADOC
CRITÉRION;RESULTADON
OK
Retorno para critérios em paralelo:
CÓDIGOOPERACÃO
CRITÉRIO3;RESULTADOC;INDICADORFINAL
OK
Sendo:
CÓDIGOOPERAÇÃO
String alfanumérica de até 07 (sete) caracteres que identifica unicamente a operação
realizada.
CRITÉRIO
String livre definida pelo responsável pela criação dos critérios com o nome do critério
utilizado para realizar a coleta de dados.
RESULTADO
Uma string livre (definida pelo responsável pela criação dos critérios) que conterá o
resultado do critério.
INDICADORFINAL
Página 38
Página 39
EVALXML / RETORNOEVALXML
Este comando solicita ao Crio a execução de uma política de análise com fontes de informação. O retorno deste método trará um
arquivo XML.
Sintaxe
String Parametro, string driver, string produto, boolincludeOA
Retorno da Execução da Operação
<cod_operacao>;<cod_operacao_obj_analise>politica_PF;Ok;F
Retorno do XML
7
Driver;Produto;<XML>
Salientamos que ao habilitar este comando / método para que os dados sejam gravados no arquivo XML será necessário habilitar a
chave de registro “RelatorioXMLColeta”.
EXPLAIN
Este comando retorna um arquivo XML com as justificativas definidas na política executada considerando as definições de
configuração (Administrador do Crivo/ Estrutura Corporativa/Grupo/Permissões Globais):

Ver somente operações do seu Grupo: Se o Grupo do usuário não executou a operação, este usuário nem chegará ao
comando EXPLAIN porque ele não conseguirá o retorno do comando LOADLOG (mensagem apresentada: CTERROR#25# User don't have permission);

Ver somente operações do seu Centro de Custo: Se o Grupo do usuário não executou a operação, este usuário nem chegará
ao comando EXPLAIN porque ele não conseguirá o retorno do comando LOADLOG (mensagem apresentada:
CTERROR#25# - User don't have permission);

Ver explicação dos pontos no resultado da operação: Se esta permissão estiver desmarcada as justificativas de ponto (tag
<justificativaPontos>) definidas na política não serão apresentadas no arquivo XML gerado pelo método EXPLAIN;

Ver explicação do limite no resultado da operação: (Se esta permissão estiver desmarcada as justificativas de limite (tag
<justificativaLimite>) definidas na política não serão apresentadas no arquivo XML gerado pelo método EXPLAIN.
7
Os dados serão apresentados, conforme a parametrização da sintaxe.
Página 40
O comando EXPLAIN deve ser executado somente após o comando EVAL (operação corrente) ou LOADLOG (resgate de operação).
E, para operações de objeto de análise é necessário executar o comando LOADLOG antes do comando EXPLAIN.
Sintaxe:
EXPLAIN<CR+LF>
Retorno:
<justificativas>
<justificativaPontos>
<justificativaLimite>
<justificativaTextual>
</justificativas>
As justificativas podem se repetir*
*A ordem das ações na política interferem na apresentação das justificativas.
As ações: “Adiciona à Justificativa”, “Adicionar ao Limite” e/ou “Adicionar aos Pontos” são todas apresentadas no arquivo,
tantas quanto forem adicionadas na política.
Já as ações: “Define Justificativa”, “Define Limite” e/ou “Define Pontos” tem o seguinte comportamento:

Se a ação “define” for a final do critério então será apresentado o retorno apenas a última ação “define”.

Se após a ação “define” houver uma das ações “adiciona”, citadas anteriormente, então serão apresentados os retornos
das ações “define” mais os retornos das ações “adiciona”.
Exemplos:
RETORNOS
DESCRIÇÃO
Exemplo 1:
<justificativaVariaveis>, <justificativaNulas>, <justificativaPontos>,
<justificativaLimite> e <justificativaTextual>
<justificativaPontos criterio="Criterio ABC PF" total="-1,00">
<regra>
<motivo><texto>Padrão</texto></motivo>
<valor><numero>-1,00</numero></valor>
</regra>
Possíveis retornos. São apresentados considerando o uso na política e a
permissão de visualização do usuário que gera a operação.
Este retorno é apresentado ao final do bloco correspondente ao critério à
que se refere à substituição sempre que houver substituição automática de
valores nulos no critério. Se o dado do campo for do tipo:
Lógico: será apresentado “Falso” ou “Verdadeiro”.
Exemplo 2:
<justificativaPontos criterio="Criterio ABC SRF" total="15,82">
<regra>
<motivo><formula>=1==2</formula><valor>FALSE</valor></motivo>
<valor><numero>15,00</numero></valor></regra>
<regra><motivo>
<formula>=e(3/3<>0;DISTANCIATEXTO([Trocar letras - coletado];[Trocar letras digitado])==30%)</formula>
<valor>FALSE</valor></motivo>
<valor><formula>=DISTANCIATEXTO([Trocar letras - coletado];[Trocar letras -
Lista: será apresentado o texto “Comparações em fórmula com a variável
resultarão em falso”.
Data: será apresentada a data no formato dd/mm/aaaa hh:mm:ssss.
Número: será apresentado o valor atribuído na substituição (sem vírgula).
Este retorno é apresentado somente se o critério possuir o elemento “Minhas
Variáveis”.
Se o valor de retorno do elemento “Minhas Variáveis” for de um Driver será
identificado no arquivo como "Variavel driver= " (a letra “V” de forma
digitado])</formula><valor>0,82</valor></valor>
</regra>
Página 41
maiúscula). Entretanto, se o Driver for referenciado dentro da expressão será
identificado no arquivo como “variavel nome= “ (a letra “v” de forma
minúscula). Veja exemplo 3 ao lado.
criterio="Criterio ABC PF" total="-1,00"
Exemplo 3:
<variavel nome="Trocar letras - digitado"><formula>a=[Tira os da e do - digitado]
=substituir(substituir(substituir(a;"k";"c");"w";"v");"z";"s")</formula><valor>Julian
MarcuirSilva</valor></variavel>
<variavel nome="Tira os da e do - digitado"><formula>a=[Nome]
=substituir(substituir(substituir(substituir(substituir(a;" da ";"");" de ";"");" dos ";"");"
das ";"");" do ";"")</formula><valor>Julian MarcuirSilva</valor></variavel>
<variavel nome="Trocar letras - coletado"><formula>a=[Tira os da e do - coletado]
=substituir(substituir(substituir(a;"k";"c");"w";"v");"z";"s")</formula><valor>Comparaç
ões em fórmula com a variável resultarão em falso</valor></variavel>
<variavel nome="Tira os da e do - coletado"><Variavel driver="SRF"
produto="Situacao Cadastral do CPF" nome="Lista - Erro na consulta">Comparações
em fórmula com a variável resultarão em
falso</Variavel></variavel></justificativaVariaveis>
Equivalem a algumas informações (Critério, Pontos, Limites) da linha
“Resultados” do relatório “Resultado da Operação” da Interface Browser do
Crivo.
O bloco de justificativas é apresentado por critério, do primeiro executado e
não daquele que traz necessariamente a resposta final. Sendo assim, o uso
da ação “delega decisão à” não muda a ordem de apresentação dos critérios.
<regra>
Regra aplicada para chegar ao resultado, não necessariamente é uma regra
de critério.
<texto>
Texto pré-configurado. Neste caso, obtido da configuração de “Valores
padrão” da área de “Pré-execução” do critério.
<formula>
Caso tenha sido definida uma fórmula para obter a pontuação, o retorno
neste caso será <formula> ao invés de <texto>.
Se os símbolos “<” e “>” forem utilizados nas fórmulas, serão representados
no arquivo pelos seguintes símbolos:
&lt - equivalente a “<”
&gt - equivalente a “>”
Padrão / Erro / Sem parâmetro para execução / Conteúdo de uma fórmula
Padrão: retorno padrão.
Erro: quando ocorrer erro na execução.
Sem parâmetro para execução: quando este recurso estiver ligado e algum
parâmetro necessário para a execução do critério não for informado
Conteúdo de uma fórmula: quando for definida uma fórmula para obter a
pontuação e a tag de retorno for <formula>, logo após esta tag será
apresentada a fórmula definida, como no exemplo 2 ao lado.
<valor> <numero>
Valores de 27 (vinte e sete) dígitos sem sinal:
Ponto: É a pontuação efetiva expressa em valor.
Limite: É o limite concedido expresso em valor.
LAYOUT
Este comando retorna os layouts das informações de entrada e de saída para o usuário autenticado no Crivo no momento da
execução do comando. O retorno ocorre em várias linhas distribuídas em três formatos distintos, dependendo da informação que
elas contêm.
Sintaxe:
LAYOUT(string usuario, string senha)
Retornos de sucesso:
Linha Input: Contém as informações de entrada
IDENTIFICAÇÃODALINHAN;TIPOCONSULTA;PARÂMETRO
Sendo:
IDENTIFICAÇÃODALINHA
Página 42
String que identifica o tipo de informação apresentada na linha.
Nesse caso, seu conteúdo é a literal ‘INPUT’
TIPOCONSULTA
PARÂMETRO


São os parâmetros de entrada que devem ser passados ao Crivo
dependendo da consulta que se quer realizar
Linha Source: Possíveis fontes de informação a serem consultadas
IDENTIFICAÇÃODALINHAN;TIPOCONSULTA;DRIVER;PRODUTO
Sendo:
DRIVER
String com o nome do driver disponível para a coleta de dados.
PRODUTO
String com o nome do produto disponível para a coleta de dados.
Linha Variable: Contém as informações de saída. Como são as últimas, dentre os 03 (três) tipos de linha retornados, sua finalização
é através da string OK na última linha.
IDENTIFICAÇÃODALINHAN;TIPOCONSULTA;DRIVER;PRODUTO;VARIÁVEL
OK
LOADPDF
Este comando devolve um array de bytes em que os 04 (quatro) primeiros bytes são os números de bytes subsequentes para a
formação do arquivo PDF.
Sintaxe:
LOADPDF(string usuario, string senha, string codigo_operacao)
Retorno de sucesso:
Arquivo [nomedoarquivo.pdf] criado com sucesso
PARAMETERS
Este comando devolve os parâmetros de execução da Operação.
Sintaxe:
PARAMETERS(string usuario, string senha, string codigo_operacao)
Página 43
Retorno de sucesso:
<Parametro>
<Nome>CPF</Nome>
<Valor>11111111111</Valor>
</Parametro>
<Parametro>
<Nome>Nome</Nome>
<Valor />
</Parametro>
RAWDATA
Este comando devolve o RawData da Operação para o Driver e Produto informados.
Sintaxe:
RAWDATA(string usuario, string senha, string codigo_operacao, string driver, string produto)
Retorno de sucesso:
Array de strings contendo o RawData da operação
REPORT
Este comando relata os resultados de uma determinada análise e tem como parâmetros de entrada "driver" e "produto", que
podem ser recuperados a partir do resultado do comando SOURCES.
Sintaxe:
REPORT(string usuario, string senha, string codigo_operacao, string driver, string produto)
Retorno:
HTML contendo o relatório solicitado.
SETPOLICYEVAL
Este comando define qual o critério será analisado e realiza um EVAL.
É necessário caso a permissão de uso “Permitir a escolha do critério para gerar operação” esteja marcada no cadastro do Grupo
a que pertence o usuário autenticado.
Sintaxe:
SETPOLICYEVAL(string usuario, string senha, string politica, string parametros)
Parâmetros:
CRITERIO: Nome do critério a ser analisado, pode ser obtido através do "LAYOUT".
Retorno de sucesso:
OK
Retorno com erro:
Critério para tomada de decisão, não encontrado
Página 44
SOURCES
Este comando solicita os drivers e os produtos utilizados para a execução da política de análise.
Sintaxe:
SOURCES(string usuario, string senha, string codigo_operacao)
Retorno:
DRIVER;PRODUTO;DATADAINFORMAÇÃO
OK
Sendo:
DRIVER
PRODUTO
DATADAINFORMAÇÃO
String com o nome do driver utilizado para realizar a coleta de dados.
String com o nome do produto utilizado para realizar a coleta de
dados.
String "Atualizado" ou a data no formato dd/mm/aaaa em que a
informação utilizada na análise foi obtida no cache.
VALUES
Este comando solicita os valores coletados pelo driver na fonte para o qual foi construído.
Sintaxe:
VALUES(string usuario, string senha, string codigo_operacao)
Retorno:
DRIVER;PRODUTO;VARIÁVEL;VALOR
OK
Sendo:
DRIVER
String com o nome do driver utilizado para realizar a coleta de dados
PRODUTO
VARIÁVEL
String com o nome da variável analisada.
VALOR
Valores de 27 (vinte e sete) dígitos sem sinal, indicando o valor da variável ou
uma string.
A sequência do retorno do comando Values pode ser modificada quando houver alguma alteração na política de critérios, como por
exemplo a inclusão ou remoção de uma nova regra.
Exemplo de configuração do IDispath
O IDispath (CTCentura) seve para integrações baseadas em scripts (ASP, VBScript, etc.).
Exemplo de integração utilizando ASP acessando IDispatch:
Página 45
Exportar o Componente Services do Servidor do Crivo
1.
2.
3.
4.
5.
6.
7.
Abra o Componet Services do Servidor Crivo;
Clique em Start ->Run -> C:\WINDOWS\system32\Com\comexp.msc;
Expanda o Component Services -> Computers -> My Computer -> COM+ Applications;
Clique com o botão direito do mouse em CTCentura, opção Export;
Na tela de boas vindas do COM+ clique em Next;
Na próxima tela especifique o local onde será exportado o componente -> Selecione a opção "Application Proxy";
Clique em Finish.
A opção ‘Save application in COM+ 1.0 format’ é aplicada somente quando utilizada em Servidores rodando Windows 2000 Server.
Instalar Componente Services Exportado do Servidor do Crivo
1.
2.
Copie o arquivo exportado para o micro/servidor onde será executada a aplicação (do cliente).
Execute (duplo clique) o arquivo exportado.
Recursos disponíveis no processo de integração
Para ativar o log da ‘API CreditTalk’ execute o seguinte procedimento:
1.
2.
3.
Utilize o regedit;
Altere ou crie a chave ‘CreditTalkLog’ do tipo ‘DWORD’ com o valor "1" (um) em ‘HKLM/Software/Crivo/Crivo/’;
Execute o comando IISreset /restart.



O arquivo CreditTalk.log será encontrado no caminho ..\Crivo\ (instalação do Crivo).
Na ocorrência de problema ou dúvidas entre em contato com o Service Desk da Crivo (veja como no tópico 1.3 Instruções
para Registros de Dúvidas ou Sugestões deste manual).
Para desativar o log da ‘API CreditTalk’, basta alterar para "0" (zero) o valor da chave no registro ‘CreditTalkLog’.
Página 46
Analisar o Log da ‘API CreditTalk’
O log da ‘API CreditTalk’ é composto por 03 (três) blocos:

Bloco 1 = Este bloco é composto da data e hora da execução do comando e do retorno obtido pelo comando;

Bloco 2 = Este bloco é composto da seção do Login;

Bloco 3 = Este bloco é composto pelos comandos enviados para o Crivo e os executados/devolvidos pelo Crivo.
Exemplos de Log
Exemplo 1
Única seção de login.
Bloco 1
Bloco 2
Bloco 3
[2009-01-01 07:32:24,561] [DEBUG]05761a9190d94127a911740649d7ff9d Login Usuario_A,******* (inicio)
[2009-01-01 07:32:24,577] [DEBUG]05761a9190d94127a911740649d7ff9d Login Usuario_A,******* (final)
[2009-01-01 07:32:24,630] [DEBUG]05761a9190d94127a911740649d7ff9d SetPolicy PoliticaGeral (inicio)
[2009-01-01 07:32:24,630] [DEBUG]05761a9190d94127a911740649d7ff9d SetPolicy PoliticaGeral (final)
[2009-01-01 07:32:24,646] [DEBUG]05761a9190d94127a911740649d7ff9d Eval P
[2009-01-01 07:32:30,499] [DEBUG]05761a9190d94127a911740649d7ff9d Values
...
...
...
Exemplo 2
Múltiplas seções de login:
Bloco 1
Bloco 2
Bloco 3
[2009-01-01 06:16:43,358] [DEBUG]b53f562564664338af0399cb9b1773f5 Login Usuario_A,******* (inicio)
[2009-01-01 06:16:43,374] [DEBUG]b53f562564664338af0399cb9b1773f5 Login Usuario_A,******* (final)
[2009-01-01 06:16:43,374] [DEBUG]b53f562564664338af0399cb9b1773f5 SetPolicy PoliticaGeral (inicio)
[2009-01-01 06:16:43,374] [DEBUG]b53f562564664338af0399cb9b1773f5 SetPolicy PoliticaGeral (final)
[2009-01-01 06:16:43,805] [DEBUG]c7e99d0e29654c8ab259f56daf5d0a31 Login Usuario_B,******* (inicio)
[2009-01-01 06:16:43,805] [DEBUG]c7e99d0e29654c8ab259f56daf5d0a31 Login Usuario_B,******* (final)
[2009-01-01 06:16:43,805] [DEBUG]45fe44a7856b454fbbd040f6b26a4818 Login Admin,******* (inicio)
[2009-01-01 06:16:43,805] [DEBUG]45fe44a7856b454fbbd040f6b26a4818 Login Login Admin,******* (final)
[2009-01-01 06:16:43,845] [DEBUG]b7621555d2cc42ca837210a6edfb9e59 Login Usuario_C,******* (inicio)
[2009-01-01 06:16:43,845] [DEBUG]b7621555d2cc42ca837210a6edfb9e59 Login Usuario_C,******* (final)
[2009-01-01 06:16:43,850] [DEBUG]b7621555d2cc42ca837210a6edfb9e59 SetPolicy PoliticaGeral (inicio)
[2009-01-01 06:16:43,850] [DEBUG]b7621555d2cc42ca837210a6edfb9e59 SetPolicy PoliticaGeral (final)
[2009-01-01 06:16:43,860] [DEBUG]45fe44a7856b454fbbd040f6b26a4818 SetPolicy PoliticaGeral (inicio)
Página 47
[2009-01-01 06:16:43,860] [DEBUG]45fe44a7856b454fbbd040f6b26a4818 SetPolicy PoliticaGeral (final)
[2009-01-01 06:16:43,865] [DEBUG]c7e99d0e29654c8ab259f56daf5d0a31 SetPolicy PoliticaGeral (inicio)
[2009-01-01 06:16:43,865] [DEBUG]c7e99d0e29654c8ab259f56daf5d0a31 SetPolicy PoliticaGeral (final)
...
...
...
Exemplo 3
Erro causado por não haver a preservação da seção entre os comandos de uma mesma operação.
Bloco 1
Bloco 2
Bloco 3
[2009-01-01 14:22:55,03]
[DEBUG] 9c3d2ae8468443ce9ce153fe05e3fa6e
Login Usuario_B,******* (inicio)
[2009-01-01 14:22:55,05]
Login Usuario_B,******* (final)
[2009-01-01 14:22:55,10]
SetPolicy Politica_X (inicio)
[2009-01-01 14:22:55,10]
SetPolicy Politica_X (final)
[2009-01-01 14:22:55,10]
Eval P
[2009-01-01 14:22:55,10]
CPF;00000000191
[2009-01-01 14:22:55,10]
Valor;503
[2009-01-01 14:22:55,10]
[2009-01-01 14:26:48,68]
000910X
[2009-01-01 14:26:48,69]
Politica_X;Correto;F
[2009-01-01 14:26:48,69]
Politica_AB;1
[2009-01-01 14:27:09,86]
[DEBUG] e2a5e70e03b34302acb02704c95940f3
Explain
[2009-01-01 14:27:10,18]
[ERROR] e2a5e70e03b34302acb02704c95940f3
CrivoException.CTException:
CTERROR#7#CreditTalk Command invalid in this context
[2009-01-01 14:27:10,18]
[ERROR] e2a5e70e03b34302acb02704c95940f3
at i5.a(a A_0)
[2009-01-01 14:27:10,18] [ERROR] e2a5e70e03b34302acb02704c95940f3 at t.e()
...
...
...
Testes no Servidor
1.
2.
3.
4.
Acesse a pasta ...\Crivo\web\Help\ExemploAPICreditTalk;
Descompacte o arquivo ViaScript.zip;
Execute o arquivo "ConsultaViaScript.vbs";
Serão exibidas telas em que deverão ser digitados os parâmetros solicitados:
1. Usuário
2. Senha
3. Escolher (E) Empresário ou (P) Pessoal
4. Informar Nome do Critério
5. Digitar o valor dos Campos que serão solicitados (depende do critério) será exibido o código da operação
6. Clique em OK
7. Informe o nome do arquivo PDF
8. Clique em OK até o fechamento completo de todas as telas de mensagens.
Todos os parâmetros de entrada serão validados no Servidor.
Página 48
Testes no Cliente
Teste pelo WebService do Cliente
1.
2.
3.
4.
Baixe os arquivos ASP.ZIP e TesteSRFAPI.zip;
5.
Acesse o cadastro de Grupo pelo Administrador do Crivo e marque a permissão de uso “Permitir a escolha do critério
para gerar operação” para que o usuário possa definir qual critério/política será utilizada;
6.
7.
Acesse a Interface Browser e aponte para o arquivo crivo_api.asp;
Descompacte o arquivo ASP.ZIP na pasta do seu WebService;
Descompacte o arquivo TesteSRFAPI.zip e importe os critérios para o Crivo;
Abra o arquivo crivo_api.asp, altere o usuário/senha conforme estiver cadastrado no Crivo e na linha 224 (duzentos e vinte
e quatro) altere o código ("0001vO7") para uma operação válida já realizada no cliente;
Se estiver tudo OK, será retornado uma página.
Teste ASP - API Crivo
Retorno do método EVAL:
0002+ec;0002+ed Teste_SRF_API_PJ;Consulta Realizada com Sucesso;F
Retorno do método EVAL utilizando o parser:
Código da Operação: 0002+ec
Nome do Critério:
Teste_SRF_API_PJ
Resposta do Critério:
Consulta Realizada com Sucesso
Resposta Final
Retorno do método VALUES:
SRF;Situacao Cadastral do CNPJ;Existe - Empresa domiciliada no exterior;False SRF;Situacao Cadastral do CNPJ;% de diferença de
Razão social;100 SRF;Situacao Cadastral do CNPJ;Status do CNPJ;1 SRF;Situacao Cadastral do CPNJ;% de semelhança de Razão
social;0 SRF;Situacao Cadastral do CNPJ; Situação especial;0;SRF;Situacao Cadastral do CNPJ;Data da situação cadastral;03/11/2005
12:00:00 AM SRF;Situacao Cadastral do CNPJ;Data de abertura;01/08/1966 12:00:00 AM SRF;Situacao Cadastral do CNPJ;Data Informação coletada na fonte;28/08/2008 07:45:30 PM SRF;Situacao Cadastral do CNPJ;Código da Natureza Jurídica;203-8
SRF;Situacao Cadastral do CNPJ;Código da Atividade Econômica;64.22-1-00 SRF;Situacao Cadastral do CNPJ;Discreta - Códigos de
Atividade Econômica Secundária da empresa;64.99-9-99 SRF;Situacao Cadastral do CNPJ;Logradouro;SBS QUADRA 01 BLOCO G
SRF;Situacao Cadastral do CNPJ;Natureza Jurídica;SOCIEDADE DE ECONOMIA MISTA SRF;Situacao Cadastral do CNPJ;UF;DF
SRF;Situacao Cadastral do CNPJ;Bairro;ASA SUL SRF;Situacao Cadastral CNPJ;Cidade;BRASILIA SRF;Situacao Cadastral do
CNPJ;Nome Fantasia;DIRECAO GERAL SRF;Situacao Cadastral do CNPJ;Atividade Econômica;Bancos múltiplos com carteira
comercial SRF;Situacao Cadastral do CNPJ;Complemento;24 ANDAR(PARTE) SRF;Situacao Cadastral do CNPJ;Número;S/N
SRF;Situação Cadastral do CNPJ;CEP;70.073-901 SRF;Situacao Cadastral do CNPJ;Razão Social;BANCO DO BRASIL AS
Retorno do método VALUES utilizando o parser:
Driver: SRF
Produto: Situacao Cadastral do CNPJ
Variável: Razão Social
Página 49
Valor: Banco do Brasil SA
LoadPDF
PDF criado
Teste via VB Script
1.
2.
3.
4.
Acesse a pasta ...\Crivo\web\Help\ExemploAPICreditTalk, no servidor onde está instalado o Crivo;
Copie e descompacte o arquivo ViaScript.zip na máquina cliente;
Depois de descompactado execute o arquivo "ConsultaViaScript.vbs";
Serão exibidas telas em que deverão ser digitados os parâmetros solicitados:
1. Usuário
2. Senha
3. Escolher (E)mpresario ou (P)essoal
4. Informar Nome do Critério
5. Digitar o valor dos Campos que serão solicitado (depende do critério), será exibido o código da operação
6. Clique em OK
7. Informe o nome do arquivo PDF
8. Clique em OK até o fechamento completo de todas as telas de mensagens.
Tabela de Erros
EVENT
ID
4000
4001
4002
ERRO
DESCRIÇÃO
0
1
2
Unknown Credittalk
Syntax Error: line is too short
Login Failed
4003
4004
4005
3
4
5
You need to login first
Run CT EVAL first
Parameter Missing
4006
6
Invalid Version
4007
4008
4009
7
8
9
Credittalk Command invalid in this context
Erro de validação dos campos
[;] esperado em chamada a Credittalk EVAL
4010
4011
4012
4013
10
11
12
13
Não existe critério para este grupo
User can’t refresh eval
Number Expected
Consulta não encontrada
4014
4015
4016
14
15
16
Produto não encontrado
Erro na consulta do produto
Usuário não tem direito a justificativa
EXPLICAÇÃO
Command Comando inválido
Usuário ou senha inválido informados no comando
LOGIN
Faltam parâmetros nos comandos CT LOGIN e CT
EVAL
Versão inválida informada no comando VERSION (CT
VERSION é Socket)
Comando fora de contexto
Quando é chamado um critério e aplicado o layout
de outro critério que também esteja associado ao
grupo do usuário logado
O código de operação fornecido ao comando
LOADLOG não foi encontrado.
4017
4018
4019
4020
17
18
19
20
4021
4022
4023
21
22
23
4024
4025
4026
4027
4028
4029
24
25
26
27
28
29
4030
30
Usuário configurado para escolher o critério
Expected parameters
Usuário Inválido ou Inexistente
Tipo do critério definido em SetPolicy não é o mesmo do tipo da
consulta
Usuário não tem direito de escolher o Critério
Critério para tomada de decisão não encontrado
É necessário executar o Comando SetPolicy para definir o critério
Página 50
Parâmetros do comando EVAL não encontrados
Só deve acontecer quando o recurso "Escolhe
Critério" estiver habilitado para o grupo do usuário
autenticado.
Not valid in this version
User don't have permission
Tipo de consulta não definido
Critério para tomada de decisão com erro
Fonte de informação não implementa busca de ""RawData""
LoginTOKEN expirado. Verifique se o horário do servidor de lotes está
compatível com o horário do servidor Crivo.
A operação foi gerada e a decisão foi tomada. Porém, as informações
coletadas ainda estão em processo de gravação. Tente recuperar a
operação novamente em alguns instantes.
Os logs do CTERROR são lançados no Event Viewer identificados pelo “Event ID” para melhor identificação.
API A DMINISTRADOR
Alteração de Senhas
O Crivo disponibiliza em sua API interna o webservice admin onde são disponibilizados os métodos utilizados pelo Administrador,
entre eles a alteração de senhas.
Para utilizar o método:
1.
2.
Adicione a service reference à URL http://<crivo url>/ws/admin.asmx ;
Instanciar o objeto e executar o método:
CrivoAdm.adminSoapClient adm = new
CrivoAdm.adminSoapClient();
adm.AlteraSenhaUsuario(usuario, senhaAntiga, senhaNova);
O método AlteraSenhaUsuario é o responsável pela alteração da senha e recebe os seguintes parâmetros:

usuario: Nome do usuário que terá sua senha alterada;

senhaAntiga: Senha que será substituída;

senhaNova: Nova senha.

Manual de Integração do Crivo

Transcrição

Documentos relacionados

válvula de pé com crivo

Dmcar - Manutenção e Repara

Crivo de Eratóstenes

CONCENTRAÇÃO EM JIGUES TIPOS DE EQUIPAMENTOS Q

VGA/RGB não funciona

Acessórios : CHUVEIRO COM LAVA ÓLHOS DE EMERGÊNCIA EM

Vortech MP 10 - WaveMaker

MANUAL DE INTEGRAÇÃO DO CRIVO WORKFLOW

Implementação da API de Recomendações do