SÃO BERNARDO DO CAMPO - SP

CTRL S SOFT

Integration Manual
Document Type: Confidential

WS laudo Financeiro
 CTRL S
SOFT

INDICE

About us Pg 03

Document Objective Pg 03

About the Service Pg 04

About the Input Pg 04

Return Layout Pg 05

Business model Pg 05

Installation Schedule Pg 06

Returns Example Pg 06

Possible Statuses Pg 06

www.vistoriago.com.br
(11) 3522-5918 / (11) 95179-8789
Rua Doutor Baeta Never, 114 , São Bernardo do Campo
P á g i n a 2 | 18
 CTRL S
SOFT
About us

We at CTRL S Soft are focused full time in the search of intelligent and practical solutions with
cadastral information of vehicles and individuals and companies. Our company's mission is to make
available with responsibility, credibility, and ease cadastral and vehicle information.
We are always creating and innovating in the market so that you always have a "cutting edge"
product to help you make the right decisions in your most doubtful and indecisive moments. With a
wide range of products, we offer our customers accurate information about vehicles, individuals, and
companies, providing online/real-time access to the most complete databases of vehicle and
registration information in the market.
Specializing in fraud prevention, we also work with the insurance market, banks, dispatchers,
dealers, insurance brokers, and law offices, among others. Our objective is to offer information about
vehicles and people in an agile way, allied to a high technology system and an extensive database,
seeking to obtain expressive results with objectivity and efficiency.

Document Objectives

The purpose of this document is to show step-by-step the integration model of the Laudo Financeiro
web service, and the available method.

www.vistoriago.com.br
(11) 3522-5918 / (11) 95179-8789
Rua Doutor Baeta Never, 114 , São Bernardo do Campo
P á g i n a 3 | 18
 CTRL S
SOFT
About the service

The WS format consists of a REST access, with JSON data return, thus facilitating the integration with any
system.

The available request method is GET, through the following URL:

https://www.vistoriago.com.br/Api/LaudoFinanceiro/Buscar/

Technical Description – REQUEST

PARAMETERS TYPE DESCRIPTION STD VALUE / POSSIBLE

Login ID provided by CTRL S

lgin_id INT XXX
SOFT

Serial access to the CTRL S

serial TEXT 00000000
Soft System

data_de date Search start date yyyy-mm-dd

data_ate date Date of search limit yyyy-mm-dd

Example of a request

https://www.vistoriago.com.br/Api/LaudoFinanceiro/Buscar/?
lgin_id=xxxx&serial=xxxxxx&data_de=yyyy-mm-dd&data_ate=yyyy-mm-dd

Maximum search period: 30 days

About the Input:

Base for consulting the Financial Reports performed

www.vistoriago.com.br
(11) 3522-5918 / (11) 95179-8789
Rua Doutor Baeta Never, 114 , São Bernardo do Campo
P á g i n a 4 | 18
 CTRL S
SOFT
Return Layout:
2. Return from the Query

DESCRIPTIO
PARAMETERS TYPE STD VALUE / POSSIBLE
N

code 200 – Successful

204 - Reporting period cannot be longer than

Returns the one month
Int code of the
401 - Serial does not match
query result
403 - Search not allowed
404 - Entered login does not exist

messages Returns
message
Text about the xxxxxx
number of
reports found

dados_laudo->ID Returns the

Int 00
report number

Returns the ip
dados_laudo-> IP int that the report 000.00.000
was generated

Returns the
date that the
dados_laudo->Data date Dd/mm/yyyy
report was
generated

Returns the
time that the
dados_laudo-> Hora int Hh:mm:ss
report was
generated

Em Andamento
Returns the
dados_laudo->Status text status of the Aberto
report
Finalizado

Returns
whether the
report was Sim ou Não
dados_laudo->Mobile text
made on the
portal or
mobile

Result of the Aprovado

dados_laudo->Resultado text analysis of the
report Aprovado com apontamento

www.vistoriago.com.br
(11) 3522-5918 / (11) 95179-8789
Rua Doutor Baeta Never, 114 , São Bernardo do Campo
P á g i n a 5 | 18
 CTRL S
SOFT
Aprovado com alerta

Aprovado com restrição

Reprovado

Não definido

http://www.credtudo.com.br/Laudos/Person
Link to link the
dados_laudo->impressão_laudo text alizadosFinanceiro/xxx/?id=xxxx&
report
tpRel=cons

Returns the
fotos->Id Int number of the 00
photo

Returns the
fotos->Nome Text name of the xxxxx
photo

Returns the
fotos->Ordem int position of the 00
photo

https://www.credtudo.com.br/adm/sistema/
Returns the imgLaudo/
fotos->Caminho text
image link
000/000/000/000/xxx.jpg

Returns the
Dados_cliente->Nome text name of the Xxxxxx xxxx
customer

Returns
Dados_cliente- boolea whether the
True ou False
>cliente_proprietario n client is an
owner

Returns the
Dados_cliente->proprietatio_nome text name of the Xxxx xxxx
owner

Dados_cliente- Returns the

int owner's 000.000.000-00 ou 00.000.000/0001-00
>proprietario_documento document

Returns the
Dados_funcionario-> vistoriador text name of the xxxxxxxx
surveyor

Returns the
Dados_funcionario-> digitador text name of the xxxxxxxx
report's typist

Returns the
engine number
dados_veiculo-> motor_cadastro text xxxxxxxx
according to
the base used

www.vistoriago.com.br
(11) 3522-5918 / (11) 95179-8789
Rua Doutor Baeta Never, 114 , São Bernardo do Campo
P á g i n a 6 | 18
 CTRL S
SOFT
Returns the
chassis
dados_veiculo-> chassi_cadastro text number xxxxxxx
according to
the base used

Returns the
engine
dados_veiculo-> motor text xxxxxxxx
numbering of
the vehicle

Returns the
chassis
dados_veiculo-> chassi text xxxxxxxx
number of the
vehicle

Returns
whether the
dados_veiculo-> engine
boolea
numbering True ou false
motor_padrao_fabrica n
matches with
factory
numbering

Returns
whether the
dados_veiculo-> chassis
boolea
numbering True ou false
chassi_padrao_fabrica n
matches with
factory
numbering

dados_veiculo-> Returns
text remark about xxxxxxxx
motor_observacoes the engine

Returns
dados_veiculo-> observation
text xxxxxxxx
chassi_observacoes about the
chassis

Returns the
dados_veiculo-> placa text license plate xxxxxxxx
number

Returns the
dados_veiculo-> km int distance 00000
traveled

Returns the
dados_veiculo-> renavam int RENAVAM 00000
numbering

Returns the
dados_veiculo-> marca text xxxxxxxx
vehicle brand

Returns the
dados_veiculo-> modelo text xxxxxxxx
vehicle model

www.vistoriago.com.br
(11) 3522-5918 / (11) 95179-8789
Rua Doutor Baeta Never, 114 , São Bernardo do Campo
P á g i n a 7 | 18
 CTRL S
SOFT
Returns the
year the
dados_veiculo-> ano_fabricacao int 00000
vehicle was
manufactured

Returns the
dados_veiculo-> ano_modelo int model year of 0000
the vehicle

Returns the
dados_veiculo-> combustivel text fuel the vehicle xxxxxxxx
uses

Returns the
dados_veiculo-> combustivel_nivel text xxxxxxxx
fuel level

Returns the
dados_veiculo-> cor text color of the xxxxxxxx
vehicle

Returns the
municipality
dados_veiculo-> municipio text xxxxxxxx
that the vehicle
is registered

Returns which
State of the
dados_veiculo-> UF text xx
Union that is
registered

Returns the
dados_veiculo-> motor_cilindradas text cubic capacity xxxxxxxx
of the vehicle

Returns the xxxxxxxx

dados_veiculo-> categoria text vehicle
category

dados_veiculo-> Returns xxxxxxxx

text equipment
equipamentos_obrigatorios status

Returns the xxxxxxxx

dados_veiculo-> documentacao text document
status

Returns the xxxxxxxx

dados_veiculo->manual text status of the
manual

Returns the xxxxxxxx

dados_veiculo->chave_extra text status of the
extra key

Returns xxxxxxxx
whether the
Acessorios->funciona int
accessory
works

www.vistoriago.com.br
(11) 3522-5918 / (11) 95179-8789
Rua Doutor Baeta Never, 114 , São Bernardo do Campo
P á g i n a 8 | 18
 CTRL S
SOFT
Returns the xxxxxxxx
Acessorios->valor text value of the
accessory

Returns xxxxxxxx
Acessorios->observacao text remarks about
the accessory

Returns the
Acessorios->id int accessory 0000
number

Returns the
Acessorios->nome text name of the xxxxxxxx
accessory

Aprovado

Aprovado com apontamento

Returns the
Status of the Aprovado com alerta
Checklist-> respostas->Status text
selected Aprovado com restrição
response
Reprovado

Não definido

Returns the
Checklist-> respostas->Ordem int position of the 000
response

Returns the
Checklist-> respostas->id int number of the 0000
response

Returns the
Checklist-> respostas->nome text name of the xxxxxxxx
answer

Returns the xxxxxxxx

Checklist-> respostas->topico text
response topic

Returns the xxxxxxxx

Checklist-> resposta->item text name of the
response item

Returns the xxxxxxxx

Checklist-> respostas_avulsa- name of the
text
>item separate
answer item

Checklist-> respostas_avulsa- Returns the xxxxxxxx

text separate
>topico answer topic

Returns the xxxxxxxx

Checklist-> respostas_avulsa- name of the
text
>resposta separate
answer

www.vistoriago.com.br
(11) 3522-5918 / (11) 95179-8789
Rua Doutor Baeta Never, 114 , São Bernardo do Campo
P á g i n a 9 | 18
 CTRL S
SOFT
Returns the xxxxxxxx
general
Checklist->observacoes_gerais text
remarks of the
report

Returns the
Pneus->id int 000
tire number

Returns the xxxxxxxx

Pneus->marca text
tire brand

Returns the xxxxxxxx

Pneus->medida text measure of the
tire

Returns the xxxxxxxx

Pneus->estado text
state of the tire

Returns the
Avarias->id Int number of the 000
malfunction

Returns the
Avarias->valor_item text value of the R$00,00
damaged item

Returns the
Avarias->valor_servico_terceiros text value of the R$00,00
service

Returns the
Avarias->valor_deducao text deduction R$00,00
value

Returns the
Avarias->valor_total text R$00,00
total value

Returns the
Avarias->observacoes text malfunction xxxx
remark

Returns the
Avarias->item text name of the xxxx
faulty item

Returns the
name of the
Avarias->operacao textt xxxxx
repair
operation

Returns the
Avarias->avaria text name of the xxxx
malfunction

Pendencias_financeiras-> Returns the

text R$00,00
dpvat_valor dpvat value

Pendencias_financeiras-> text Returns the R$00,00

license value
licenciamento_taxas_valor

www.vistoriago.com.br
(11) 3522-5918 / (11) 95179-8789
Rua Doutor Baeta Never, 114 , São Bernardo do Campo
P á g i n a 10 | 18
 CTRL S
SOFT
of the car

Pendencias_financeiras-> Returns the

text R$00,00
ipva_valor value of IPVA

Pendencias_fnianceiras-> Returns the

text R$00,00
multas_valor value of fine

Pendencias_financeiras-> Returns the

text R$00,00
debitos_total total debits

valores_avaliacao- Returns the

text name of the xxxxxx
>referencia_mao_obra
labor

valores_avaliacao->valor_avaliado Returns the

text appraised R$00,00
value

valores_avaliacao->valor_fipe Returns the

text R$00,00
Fipe value

valores_avaliacao- Returns the

text accessories R$00,00
>valor_acessorios
values

valores_avaliacao- Returns the

text value of R$00,00
>valor_implementos
implements

valores_avaliacao- Returns the

appraised
>valor_referencia_avaliado text R$00,00
reference
value

valores_avaliacao- Returns the

text Fipe reference R$00,00
>valor_referencia_fipe
value

valores_avaliacao- Returns the

chassis
>porcentagem_chassi_remarcado decimal 00.00
markup
percentage

valores_avaliacao-
Returns the
>variacao_chassi_remarcado_avali text R$00,00
variation value
ado

valores_avaliacao- Returns the

text Fipe variation R$00,00
>variacao_chassi_remarcado_fipe
value

valores_avaliacao- Returns the

decimal percentage of 00.00
>porcentagem_variacao_sugerida
change

www.vistoriago.com.br
(11) 3522-5918 / (11) 95179-8789
Rua Doutor Baeta Never, 114 , São Bernardo do Campo
P á g i n a 11 | 18
 CTRL S
SOFT
valores_avaliacao- Returns the
text value of R$00,00
>variacao_sugerida_avaliado
change

valores_avaliacao- Returns the

text suggested R$00,00
>variacao_sugerida_fipe
Fipe variation

valores_avaliacao- Returns the

text value of the R$00,00
>valor_mao_obra
labor

valores_avaliacao->valor_pecas Returns the R$00,00

text value of the
parts

valores_avaliacao- Returns the R$00,00

text deduction
>valor_deducoes
value

valores_avaliacao- R$00,00
Returns the
>complemento_reparos_mecanico text mechanical
s repairs value

valores_avaliacao- R$00,00
It returns the
>complemento_reparos_borracha text value of the
ria tire repairs

valores_avaliacao- Returns the R$00,00

text upholstery
>complemento_reparos_tapecaria
repairs value

valores_avaliacao- Returns the R$00,00

text appraised
>valor_avaliado_resumo
value summary

valores_avaliacao- Returns the R$00,00

text Fipe summary
>valor_fipe_resumo
value

2. 1 Response Return - With Registration

{
"code": 200,
"messages": "10 laudo(s) encontrado(s) para o período informado",
"data": [
{
"dados_laudo": {
"id": "32",
"IP": "000.00.000-00",
"data": "17/02/2022",
"hora": "17:28:00",
"status": "Em andamento",
"mobile": "NÃO",
"resultado": "Reprovado",

www.vistoriago.com.br
(11) 3522-5918 / (11) 95179-8789
Rua Doutor Baeta Never, 114 , São Bernardo do Campo
P á g i n a 12 | 18
 CTRL S
SOFT
"impressao_laudo": "http://wwww.credtudo.com.br/Laudos/PersonalizadosFinanceiro/xxx/?
id=xxxxx&tpRel=cons"
},
"fotos": [
{
"id": "6887",
"nome": "Chassi",
"ordem": "1",
"caminho": "wwww.credtudo.com.br/adm/sistema/imgLaudo/ccc/cc/ccc/c/xccxxx.jpg"
},
{
"id": "6886",
"nome": "Hodômetro",
"ordem": "2",
"caminho": "wwww.credtudo.com.br/adm/sistema/imgLaudo/ccc/cc/ccc/c/xccxxx.jpg"
},
{
"id": "6890",
"nome": "Motor",
"ordem": "3",
"caminho": "wwww.credtudo.com.br/adm/sistema/imgLaudo/ccc/cc/ccc/c/xccxxx.jpg"
},
{
"id": "6885",
"nome": "Placa",
"ordem": "4",
"caminho": "wwww.credtudo.com.br/adm/sistema/imgLaudo/ccc/cc/ccc/c/xccxxx.jpg"
},
{
"id": "6888",
"nome": "",
"ordem": "0",
"caminho": "wwww.credtudo.com.br/adm/sistema/imgLaudo/ccc/cc/ccc/c/xccxxx.jpg"
},
{
"id": "6889",
"nome": "",
"ordem": "0",
"caminho": "wwww.credtudo.com.br/adm/sistema/imgLaudo/ccc/cc/ccc/c/xccxxx.jpg"
},
{
"id": "6891",
"nome": "",
"ordem": "0",
"caminho": "wwww.credtudo.com.br/adm/sistema/imgLaudo/ccc/cc/ccc/c/xccxxx.jpg"
},
{
"id": "6892",
"nome": "",
"ordem": "0",
"caminho": "wwww.credtudo.com.br/adm/sistema/imgLaudo/ccc/cc/ccc/c/xccxxx.jpg"
},
{
"id": "6893",
"nome": "",
"ordem": "0",
"caminho": "wwww.credtudo.com.br/adm/sistema/imgLaudo/ccc/cc/ccc/c/xccxxx.jpg"
},
{

www.vistoriago.com.br
(11) 3522-5918 / (11) 95179-8789
Rua Doutor Baeta Never, 114 , São Bernardo do Campo
P á g i n a 13 | 18
 CTRL S
"id": "6894",
SOFT
"nome": "",
"ordem": "0",
"caminho": "wwww.credtudo.com.br/adm/sistema/imgLaudo/ccc/cc/ccc/c/xccxxx.jpg"
}
],
"dados_cliente": {
"nome": "xxx xxx",
"cliente_proprietario": true,
"proprietario_nome": "xxxx",
"proprietario_documento": "000.00.000-00"
},
"dados_funcionario": {
"vistoriador": "xxxxxxxxxxx",
"digitador": " xxxxxxxxxxx "
},
"dados_veiculo": {
"motor_cadastro": "",
"chassi_cadastro": "xxxxxxxxxxx",
"motor": "motor",
"chassi": "chassi",
"motor_padrao_fabrica": null,
"chassi_padrao_fabrica": null,
"motor_observacoes": null,
"chassi_observacoes": null,
"placa": "xxxxx",
"km": "123456",
"renavam": "xxxx",
"marca": "GM",
"modelo": "BLAZER DLX",
"ano_fabricacao": "1998",
"ano_modelo": "1999",
"combustivel": "GASOL/GNV",
"combustivel_nivel": "1/4",
"cor": "BRANCA",
"municipio": "JACAREI",
"UF": "",
"motor_cilindradas": "Cilindradas do motor",
"categoria": "Categoria",
"equipamentos_obrigatorios": "OK",
"documentacao": "OK",
"manual": "Não OK",
"chave_extra": "Não OK"
},
"acessorios": [
{
"funciona": "1",
"valor": "R$ 1,00",
"observacao": "",
"id": "859",
"nome": "acessórios"
},
{
"funciona": "0",
"valor": "R$ 3,33",
"observacao": "",
"id": "851",
"nome": "coxinha çabão"
},

www.vistoriago.com.br
(11) 3522-5918 / (11) 95179-8789
Rua Doutor Baeta Never, 114 , São Bernardo do Campo
P á g i n a 14 | 18
 CTRL S
{
SOFT
"funciona": null,
"valor": "R$ 0,00",
"observacao": "",
"id": "852",
"nome": "coxinha molejão"
}
],
"checklist": {
"respostas": [
{
"status": "Aprovado",
"ordem": "1",
"id": "15764",
"nome": "teste",
"topico": "(ETA) CONDIÇÃO DAS ETIQUETAS DE IDENTIFICAÇÃO DO CHASSI",
"item": "Do Batente da Porta"
},
{
"status": "Reprovado",
"ordem": "1",
"id": "44231",
"nome": "CINTO MUITO MAS VOU REPROVAR",
"topico": "(ETA) CONDIÇÃO DAS ETIQUETAS DE IDENTIFICAÇÃO DO CHASSI",
"item": "ETIQUETA CINTO DE SEGURANCA"
},
{
"status": "Não definido",
"ordem": "4",
"id": "16535",
"nome": "NUMERO DE MOTOR DIVERGENTE CADASTRADO NO CRLV APRESENTADO",
"topico": "CONDIÇÃO DA NUMERAÇÃO DO MOTOR",
"item": "Motor"
}
],
"respostas_avulsas": [
{
"item": "VIDRO TRASEIRO(VIGIA)",
"topico": "(VIS) CONDIÇÃO DA GRAVAÇÃO CHASSI NOS VIDROS",
"resposta": "teste resp"
}
],
"observacoes_gerais": null
},
"pneus": [
{
"id": "33",
"pneu": "Pneu",
"marca": "Marca",
"medida": "Medida",
"estado": "TWI maior que 1.6"
},
{
"id": "32",
"pneu": "1234",
"marca": "12345",
"medida": "4156",
"estado": "TWI menor que 1.6"
}

www.vistoriago.com.br
(11) 3522-5918 / (11) 95179-8789
Rua Doutor Baeta Never, 114 , São Bernardo do Campo
P á g i n a 15 | 18
 CTRL S
],
SOFT
"avarias": [
{
"id": "27",
"valor_item": "R$ 12,34",
"valor_servico_terceiros": "R$ 3,33",
"valor_deducao": "R$ 410,10",
"valor_total": "-R$ 394,43",
"observacoes": "",
"item": "Acendedor de cigarros",
"operacao": "Operações teste",
"avaria": "Amassado"
},
{
"id": "28",
"valor_item": "R$ 3.233,33",
"valor_servico_terceiros": "R$ 5,32",
"valor_deducao": "R$ 0,40",
"valor_total": "R$ 3.238,25",
"observacoes": "sdfsf",
"item": "Acendedor de cigarros",
"operacao": "Operações teste",
"avaria": "Amassado"
}
],
"pendencias_financeiras": {
"dpvat_valor": "R$ 0,00",
"licenciamento_taxas_valor": "R$ 0,00",
"ipva_valor": "R$ 1,87",
"multas_valor": "R$ 0,00",
"debitos_total": "R$ 1,87"
},
"valores_avaliacao": {
"referencia_mao_obra": "Nacional",
"valor_avaliado": "R$ 14,13",
"valor_fipe": "R$ 15,35",
"valor_acessorios": "R$ 66,54",
"valor_implementos": "R$ 56,54",
"valor_referencia_avaliado": "R$ 137,21",
"valor_referencia_fipe": "R$ 138,43",
"porcentagem_chassi_remarcado": "98.74",
"variacao_chassi_remarcado_avaliado": "R$ 13,95",
"variacao_chassi_remarcado_fipe": "R$ 15,16",
"porcentagem_variacao_sugerida": "8.52",
"variacao_sugerida_avaliado": "R$ 1,20",
"variacao_sugerida_fipe": "R$ 1,31",
"valor_mao_obra": "R$ 8,65",
"valor_pecas": "R$ 3.245,67",
"valor_deducoes": "R$ 410,50",
"complemento_reparos_mecanicos": "R$ 0,00",
"complemento_reparos_borracharia": "R$ 0,00",
"complemento_reparos_tapecaria": "R$ 0,00",
"valor_avaliado_resumo": "-R$ 2.691,46",
"valor_fipe_resumo": "-R$ 2.688,92",
"valor_final_avaliado": "-R$ 2.693,33",
"valor_final_fipe": "-R$ 2.690,79"
}
}
]

www.vistoriago.com.br
(11) 3522-5918 / (11) 95179-8789
Rua Doutor Baeta Never, 114 , São Bernardo do Campo
P á g i n a 16 | 18
 CTRL S
}
SOFT

2.2 Response Return - Without Registration

{
"code": 200,
"messages": "Nenhum laudo encontrado para o período informado",
"data": [

]
}

Business Models
Model 1.1 (access via REST)

1. After signing the contracts, CTRL S SOFT Group will make available the access
manuals to the contracted inputs
2. SUPORTE CTRL S SOFT & Vistoria GO, will perform the integration following the
requested manuals
After the integration, 5 queries will be released for testing the integration done. After
receiving the contract at CTRL S SOFT headquarters, it will be released for use

Installation Schedule Model 1.1

Action Duration Responsible part

1 day SUPORTE CTRL S SOFT &
Contract Signing VISTORIA GO
Manual Release 1 day CTRL S SOFT
SUPORTE CTRL S SOFT &
Integration Study 2 days VISTORIA GO
SUPORTE CTRL S SOFT & CRED
System Integration 2 days TUDO

Possible errors:
Return 1.1
{"status":false,"mensagem":"O serial deve ser informado"}

Return 1.2

{"status":false,"mensagem":"O usuario deve ser informado"}

Return 1.3

{"status":false,"mensagem":"serial de acesso nao confere"}

www.vistoriago.com.br
(11) 3522-5918 / (11) 95179-8789
Rua Doutor Baeta Never, 114 , São Bernardo do Campo
P á g i n a 17 | 18
 CTRL S
SOFT
If you still have any questions, please contact us so we can help you.

suporte@ctrlssoft.com.br

Last updated: 04/03/202

www.vistoriago.com.br
(11) 3522-5918 / (11) 95179-8789
Rua Doutor Baeta Never, 114 , São Bernardo do Campo
P á g i n a 18 | 18