Direct Intelligence

DetranMgSituacaoVeiculo

Consultas do DETRAN/MG

**DetranMgSituacaoVeiculo** Parameters:
Name	Parameter	Data Type	Required	Description
Placa	path	string	No	Placa a ser consultada
Chassi	path	string	No	Chassi a ser consultado

**RequestModelBase** Parameters:
Name	Parameter	Data Type	Required	Description
Token	query	string	Yes	Token de Acesso
Options	body	Options	No	Opções extra de execução da consulta
TransactionUid	query	string	No	Unique Identifier da consulta. Só deve ser informado em caso de obtenção de resultado de chamadas assincrona.
Requestor	form	Requestor	No
TransactionCid	query	string	No	Transaction Cid (customer id) da consulta. Só deve ser informado em caso de de chamadas assincronas persistentes.
ValidationResults	bool	bool	No	Executa as validações no resultado da fonte

**Options** Parameters:
Name	Parameter	Data Type	Required	Description
ReadFromCache	body	OptionType	No	Indica que a chamada aceita leitura de resultados do cache (se existir). Por padrão, a consulta é executada usando o cache diário, ou seja, se a mesma consulta para a mesma entrada foi efetuada no mesmo dia com sucesso anteriormente, o resultado retornado será oriundo do cache. Allowable Values default enable disable
CacheLimitInHours	query	short	No	Limite, em horas, que uma consulta é aceita do cache. Caso informado, o sistema tenta buscar a consulta com a mesma chave de entrada no cache interno, retornando os dados caso encontre no período informado. Atenção: Quando a consulta é lida do cache, a velocidade é bem superior a online pois vem direto da base de dados, porém, o dado não será online, e sim da data encontrada no cache.
GenerateResultPdf	body	OptionType	No	Indica que se a fonte de dados possuir comprovante em PDF, ele deve ser obrigatoriamente retornardo. Caso esta opção seja especificada como 'enable' e haja falha na geração do comprovante em PDF, a consulta apresentará erro. Allowable Values default enable disable
StoreResultPdf	body	OptionType	No	[Deprecated] Não utilizar.
AllowOutdatedResult	body	OptionType	No	Indica que aceita resultados antigos (datados) em caso de problema para obter o resultado na fonte online. O sistema primeiro tenta obter o resultado online, caso a fonte esteja indisponível ou algum outro problema impeça o retorno da consulta online, o sistema tenta achar no cache um resultado antigo para retornar. Default: disable Allowable Values default enable disable
OutdatedResultLimitInHours	query	short	No	Tempo (em horas) que o sistema deve buscar a consulta no cache em caso de aceite de resultados antigos (datados). Este parâmetro só funciona caso o parâmetro 'allow_outdated_result' seja passado como enable. Allowable Values default enable disable
TimeoutInMilliseconds	query	integer	No	Tempo máximo de execução da consulta em milisegundos. Caso o tempo seja excedido, a consulta para a execução e retorna 'Tempo Esgotado'. Não funciona para todas as fontes, favor consultar a Direct Digital caso deseje utilizar o parâmetro.
CustomParameters	query	string	No	Parâmetros customizados específicos para seu token de acesso.
Async	query	boolean	No	Indica se a execução será síncrona ou assíncrona (padrão: false (síncrona))
ExecutionMode	body	ExecutionMode	No	Modo de execução da consulta. Allowable Values execute (default) test params_and_price_check status result statistics balance
CallbackUrl	query	string	No	URL de callback de resultado da chamada (webhook). Ao ser informado, o resultado da consulta será postado (POST) para a URL informada.
ResultHtml	query	boolean	No	Indica que deve retornar o bloco de informações em formato html. Utilizado para exibição do resultado da consulta direto em tela. (campo ResultHtml).
AsyncRunPersistent	query	boolean	No	Indica se a execução assíncrona deve ser persistente (executar até um resultado final, ignorando o tempo máximo da execução síncrona)
GeneratePdfSync	query	boolean	No	Indica se deve gerar o PDF de forma síncrona.

**OptionType** Enum:
Name	Value
Default	default
Enable	enable
Disable	disable

**ExecutionMode** Enum:
Name	Value
Execute	execute
Test	test
ParametersAndPriceCheck	params_and_price_check
Status	status
Result	result
Statistics	statistics
Balance	balance

**Requestor** Parameters:
Name	Parameter	Data Type	Required
Organization	form	Organization	No
Person	form	Person	No
Trusted	form	bool	No
UnauthorizedDataSourceTypeList	form	string[]	No
DataAccessLevel	form	byte	No

**Organization** Parameters:
Name	Parameter	Data Type	Required
Document	form	string	No
Name	form	string	No
Emails	form	string[]	No
Phones	form	string[]	No

**Person** Parameters:
Name	Parameter	Data Type	Required
Document	form	string	No
Name	form	string	No
Emails	form	string[]	No
Phones	form	string[]	No

**DetranMgSituacaoVeiculoResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Result	form	DetranMgSituacaoVeiculoResult	No

ResponseBase Parameters:

Name

Parameter

Data Type

Required

Description

UniqueIdentifier

form

uuid

Identificador único da transação (uuid). Recomendado armazenar para controle e depuração.

TransactionResultTypeCode

form

short

Código do tipo de resultado da transação.

TransactionResultType

form

TransactionResultType

TransactionResultType Code	TransactionResultType	Definitivo	Faturavel	Erro
1	Sucesso	Verdadeiro	Verdadeiro	Falso
2	Sucesso parcial ou com observações	Verdadeiro	Verdadeiro	Falso
3	Entrada ou documento inválido	Verdadeiro	Falso	Verdadeiro
4	Dados não disponíveis	Verdadeiro (no dia)	Falso	Falso
5	Entidade ou documento inexistente/não encontrado	Verdadeiro	Verdadeiro	Falso
6	Parâmetros de entrada inválidos	Verdadeiro	Falso	Verdadeiro
7	Combinação de parâmetros não suportados	Verdadeiro	Falso	Verdadeiro
8	Fonte de dados ou sistema remoto indisponível	Falso	Falso	Verdadeiro
9	Limite de tempo esgotado	Falso	Falso	Verdadeiro
10	Limite de tentativas atingido	Falso	Falso	Verdadeiro
11	Erro na fonte de dados ou sistema remoto	Falso	Falso	Verdadeiro
12	Transação em execução	Falso	Falso	Falso
101	Saldo em créditos insuficiente, entre em contato	Falso	Falso	Verdadeiro
102	Limite de transações simultâneas atingido, entre em contato	Falso	Falso	Verdadeiro
103	Transação não disponível, entre em contato	Falso	Falso	Verdadeiro
104	Credenciais inválidas ou acesso negado, entre em contato	Falso	Falso	Verdadeiro
105	Transação cancelada, entre em contato	Falso	Falso	Verdadeiro
255*	Erro interno não esperado, entre em contato	Verdadeiro (no dia)	Falso	Verdadeiro
* Consulta em manutenção, tente refazer mais tarde ou entre em contato com a Direct Digital para notificação do problema

Message

form

string

Mensagem.

TotalCostInCredits

form

short

Custo total da transação em créditos.

BalanceInCredits

form

integer

Saldo atual em créditos.

ElapsedTimeInMilliseconds

form

integer

Tempo de execução (em milisegundos).

Reserved

form

string

Reservado para uso interno.

Date

form

datetime

Data da transação.

OutdatedResult

form

boolean

Indica que o resultado é datado.

HasPdf

form

boolean

Indica que existe PDF de comprovante do resultado.

ValidationResultRiskIndicator

form

boolean

Indicador de risco dos resultados.

Allowable Values

Green
Amber
Red

ValidationResults

form

ValidationResult[]

Coleção de validações do resultado.

DataSourceHtml

form

string

[Depecrated]. Não utilizar.

DateString

form

string

[Depecrated]. Não utilizar.

OriginalFilesUrl

form

string

Url para download dos arquivos originais da transação (quando disponíveis).

PdfUrl

form

string

Url para download do arquivo de comprovante em PDF da transação (quando disponível).

ResultHtml

form

string

[Deprecated]

TotalCost

form

decimal

Internal use only.

ValidationResultRiskIndicatorN

form

boolean

Indicador de risco dos resultados.

Allowable Values

Undefined
Unavailable
Neutral
Green
Amber
Red

ValidationResultsN

form

ValidationResultN[]

Coleção de validações do resultado.

BalanceInBrl

form

decimal

Saldo atual em BRL.

ResultHtmlHeader

form

string

[Deprecated]

ResultHtmlDataSourceRiskIndicator

form

string

[Deprecated]

**TransactionResultType** Enum:
Name	Value
Success	success
SuccessWithRemarks	success_with_remarks
InvalidInputData	invalid_input_data
UnavailableData	unavailable_data
EntityNotFound	entity_not_found
InvalidParameters	invalid_parameters
ParametersNotSupported	parameters_Not_Supported
RemoteSystemUnavailable	remote_system_unavailable
Timeout	timeout
AttemptsLimitReached	attempts_limit_reached
RemoteSystemError	remote_system_error
AsyncExecutionInProgress	async_execution_in_progress
InsufficientBalance	insufficient_balance
SimultaneousTransactionsLimitReached	simultaneous_transactions_limit_reached
TransactionUnavailable	transaction_unavailable
AccessDenied	access_denied
TransactionCancelled	transaction_cancelled
InternalError	internal_error

**ValidationResultRiskIndicator** Enum:
Name	Value
Green	green
Amber	amber
Red	red

**ValidationResult** Parameters:
Name	Parameter	Data Type	Required	Description
ValidationResultType	form	ValidationResultType	No	Tipo de validação de resultado.
ValidationResultRiskIndicator	form	ValidationResultRiskIndicator	No	Indicador de risco do resultado da validação. Allowable Values Green Amber Red
Confidence	form	float	No	Grau de confiança da validação (de 0 a 1000).
Message	form	string	No	Mensagem.

**ValidationResultType** Parameters:
Name	Parameter	Data Type	Required	Description
ValidationResultTypeId	form	string	No	Código do tipo de resultado de validação.
ValidationResultTypeCode	form	string	No
ValidationResultCategory	form	ValidationResultCategoryEnum	No
Description	form	string	No	Descrição do tipo de validação de resultado.

**ValidationResultCategoryEnum** Enum:
Name	Value
General	geral
DocumentRecognitionImage	document_recognition_image
DocumentRecognitionDocument	DocumentRecognitionDocument
DocumentRecognitionDocumentCnh	DocumentRecognitionDocumentCnh
ReceitaFederalCpf	ReceitaFederalCpf
ReceitaFederalCnpj	ReceitaFederalCnpj
TribunalSuperiorEleitoral	TribunalSuperiorEleitoral
Ieptb	Ieptb
CguPep	CguPep
PoliciaFederalAntecedentesCriminais	PoliciaFederal
PrevidenciaQualificacaoCadastral	PrevidenciaQualificacaoCadastral
TribunalSuperiorDoTrabalho	TribunalSuperiorDoTrabalho
ReceitaFederalCcd	ReceitaFederalCcd
MteRais	MteRais
FazendaSp	FazendaSp
Gbody	Gbody
RegistroBr	RegistroBr
CnjBnmp	CnjBnmp
Coaf	Coaf
CadastroPf	CadastroPf
CguCeaf	CguCeaf
CguTerceirizados	CguTerceirizados
BolsaFamilia	BolsaFamilia
ReceitaFederalSimplesNacional	ReceitaFederalSimplesNacional
Sintegra	Sintegra
Suframa	Suframa
SintegCaixara	Caixa
CguCeis	CguCeis
CguCnep	CguCnep
Bpc	Bpc
Processos	Processos
PortalEmpreendedorMei	PortalEmpreendedorMei
Ibama	Ibama
Inmetro	Inmetro
Anvisa	Anvisa
CaixaMte	Mte
Customer_Quod	customer_quod

**ValidationResultRiskIndicatorN** Enum:
Undefined
Unavailable
Neutral
Green
Amber
Red

**ValidationResultN** Parameters:
Name	Parameter	Data Type	Required	Description
ValidationResultType	form	ValidationResultType	No	Tipo de validação de resultado.
ValidationResultRiskIndicator	form	ValidationResultRiskIndicator	No	Indicador de risco do resultado da validação. Allowable Values Green Amber Red
Confidence	form	float	No	Grau de confiança da validação (de 0 a 1000).
Message	form	string	No	Mensagem.

**DetranMgSituacaoVeiculoResult** Parameters:
Name	Parameter	Data Type	Required
Placa	form	string	No
PlacaAnterior	form	string	No
Municipio	form	string	No
MunicipioAnterior	form	string	No
Marca	form	string	No
Modelo	form	string	No
AnoFabricacao	form	int	No
AnoModelo	form	int	No
AnoIpva	form	int	No
ParcelaIpva	form	string	No
AnoSeguro	form	int	No
ParcelaSeguro	form	string	No
AnoLicenciamento	form	int	No
DataLicenciamento	form	DateTime	No
SituacaoLicenciamento	form	string	No
AnoSeguroAnterior	form	int	No
ParcelaSeguroAnterior	form	string	No
Autuacoes	form	Autuacao[]	No
Multas	form	Multa[]	No
Impedimentos	form	Impedimento[]	No
Restricoes	form	Restricao[]	No

**Autuacao** Parameters:
Name	Parameter	Data Type	Required
Situacao	form	string	No
Codigo	form	string	No
DataHora	form	DateTime	No
Descricao	form	string	No
Local	form	string	No
Municipio	form	string	No
IncluidaEm	form	DateTime	No
DataLimiteDefesa	form	DateTime	No
NumeroAit	form	string	No
NumeroProcessamento	form	long	No
Uf	form	string	No
Orgao	form	string	No

**Multa** Parameters:
Name	Parameter	Data Type	Required
Orgao	form	string	No
Situacao	form	string	No
Codigo	form	string	No
DataHora	form	DateTime	No
Descricao	form	string	No
Municipio	form	string	No
IncluidaEm	form	DateTime	No
DataLimiteRecurso	form	DateTime	No
NumeroAit	form	string	No
NumeroProcessamento	form	long	No
Valor	form	double	No
Local	form	string	No

**Impedimento** Parameters:
Name	Parameter	Data Type	Required	Description
Descricao	form	string	No

**Restricao** Parameters:
Name	Parameter	Data Type	Required	Description
Descricao	form	string	No

To override the Content-type in your clients, use the HTTP Accept Header, append the .soap11 suffix or ?format=soap11

HTTP + SOAP11

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /soap11 HTTP/1.1 
Host: api.exato.digital 
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: DetranMgSituacaoVeiculo

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>

<DetranMgSituacaoVeiculo xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://intelligence.directdigital.com.br/types">
  <cid>String</cid>
  <options>
    <read_from_cache>default</read_from_cache>
    <cache_limit_in_hours>0</cache_limit_in_hours>
    <generate_result_pdf>default</generate_result_pdf>
    <store_result_pdf>default</store_result_pdf>
    <allow_outdated_result>default</allow_outdated_result>
    <outdated_result_limit_in_hours>0</outdated_result_limit_in_hours>
    <timeout_ms>0</timeout_ms>
    <custom_parameters>String</custom_parameters>
    <async>false</async>
    <exec_mode>execute</exec_mode>
    <callback_url>String</callback_url>
    <result_html>false</result_html>
    <async_run_persistent>false</async_run_persistent>
    <generate_pdf_sync>false</generate_pdf_sync>
  </options>
  <requestor xmlns:d2p1="http://schemas.datacontract.org/2004/07/DirectDigital.Intelligence.ServiceModel.TransactionContext" i:nil="true" />
  <token>String</token>
  <uid>String</uid>
  <validations>false</validations>
  <chassi>String</chassi>
  <placa>String</placa>
</DetranMgSituacaoVeiculo>

    </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>

<DetranMgSituacaoVeiculoResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://intelligence.directdigital.com.br/types">
  <BalanceInBrl>0</BalanceInBrl>
  <BalanceInCredits>0</BalanceInCredits>
  <DataSourceHtml>String</DataSourceHtml>
  <Date>0001-01-01T00:00:00</Date>
  <DateString>String</DateString>
  <ElapsedTimeInMilliseconds>0</ElapsedTimeInMilliseconds>
  <HasPdf>false</HasPdf>
  <Message>String</Message>
  <OriginalFilesUrl>String</OriginalFilesUrl>
  <OutdatedResult>false</OutdatedResult>
  <PdfUrl>String</PdfUrl>
  <Reserved>String</Reserved>
  <ResultHtml>String</ResultHtml>
  <ResultHtmlDataSourceRiskIndicator>String</ResultHtmlDataSourceRiskIndicator>
  <ResultHtmlHeader>String</ResultHtmlHeader>
  <TotalCost>0</TotalCost>
  <TotalCostInCredits>0</TotalCostInCredits>
  <TransactionResultType>success</TransactionResultType>
  <TransactionResultTypeCode>0</TransactionResultTypeCode>
  <UniqueIdentifier>String</UniqueIdentifier>
  <ValidationResultRiskIndicator>green</ValidationResultRiskIndicator>
  <ValidationResultRiskIndicatorN>Undefined</ValidationResultRiskIndicatorN>
  <ValidationResults>
    <ValidationResult>
      <Confidence>0</Confidence>
      <Message>String</Message>
      <ValidationResultRiskIndicator>green</ValidationResultRiskIndicator>
      <ValidationResultType>
        <ValidationResultTypeId>0</ValidationResultTypeId>
        <ValidationResultTypeCode>String</ValidationResultTypeCode>
        <ValidationResultCategory>geral</ValidationResultCategory>
        <Description>String</Description>
      </ValidationResultType>
    </ValidationResult>
  </ValidationResults>
  <ValidationResultsN xmlns:d2p1="http://schemas.datacontract.org/2004/07/DirectDigital.Intelligence.ServiceModel.Base">
    <d2p1:ValidationResultN>
      <d2p1:Confidence>0</d2p1:Confidence>
      <d2p1:Message>String</d2p1:Message>
      <d2p1:ValidationResultRiskIndicator>Undefined</d2p1:ValidationResultRiskIndicator>
      <d2p1:ValidationResultType>
        <ValidationResultTypeId>0</ValidationResultTypeId>
        <ValidationResultTypeCode>String</ValidationResultTypeCode>
        <ValidationResultCategory>geral</ValidationResultCategory>
        <Description>String</Description>
      </d2p1:ValidationResultType>
    </d2p1:ValidationResultN>
  </ValidationResultsN>
  <Result>
    <Placa>String</Placa>
    <PlacaAnterior>String</PlacaAnterior>
    <Municipio>String</Municipio>
    <MunicipioAnterior>String</MunicipioAnterior>
    <Marca>String</Marca>
    <Modelo>String</Modelo>
    <AnoFabricacao>0</AnoFabricacao>
    <AnoModelo>0</AnoModelo>
    <AnoIpva>0</AnoIpva>
    <ParcelaIpva>String</ParcelaIpva>
    <AnoSeguro>0</AnoSeguro>
    <ParcelaSeguro>String</ParcelaSeguro>
    <AnoLicenciamento>0</AnoLicenciamento>
    <DataLicenciamento>0001-01-01T00:00:00</DataLicenciamento>
    <SituacaoLicenciamento>String</SituacaoLicenciamento>
    <AnoSeguroAnterior>0</AnoSeguroAnterior>
    <ParcelaSeguroAnterior>String</ParcelaSeguroAnterior>
    <Autuacoes xmlns:d3p1="http://schemas.datacontract.org/2004/07/DirectDigital.Intelligence.ServiceModel.Br.Detran.Mg.SituacaoVeiculo">
      <d3p1:Autuacao>
        <d3p1:Codigo>String</d3p1:Codigo>
        <d3p1:DataHora>0001-01-01T00:00:00</d3p1:DataHora>
        <d3p1:DataLimiteDefesa>0001-01-01T00:00:00</d3p1:DataLimiteDefesa>
        <d3p1:Descricao>String</d3p1:Descricao>
        <d3p1:IncluidaEm>0001-01-01T00:00:00</d3p1:IncluidaEm>
        <d3p1:Local>String</d3p1:Local>
        <d3p1:Municipio>String</d3p1:Municipio>
        <d3p1:NumeroAit>String</d3p1:NumeroAit>
        <d3p1:NumeroProcessamento>0</d3p1:NumeroProcessamento>
        <d3p1:Orgao>String</d3p1:Orgao>
        <d3p1:Situacao>String</d3p1:Situacao>
        <d3p1:Uf>String</d3p1:Uf>
      </d3p1:Autuacao>
    </Autuacoes>
    <Multas xmlns:d3p1="http://schemas.datacontract.org/2004/07/DirectDigital.Intelligence.ServiceModel.Br.Detran.Mg.SituacaoVeiculo">
      <d3p1:Multa>
        <d3p1:Codigo>String</d3p1:Codigo>
        <d3p1:DataHora>0001-01-01T00:00:00</d3p1:DataHora>
        <d3p1:DataLimiteRecurso>0001-01-01T00:00:00</d3p1:DataLimiteRecurso>
        <d3p1:Descricao>String</d3p1:Descricao>
        <d3p1:IncluidaEm>0001-01-01T00:00:00</d3p1:IncluidaEm>
        <d3p1:Local>String</d3p1:Local>
        <d3p1:Municipio>String</d3p1:Municipio>
        <d3p1:NumeroAit>String</d3p1:NumeroAit>
        <d3p1:NumeroProcessamento>0</d3p1:NumeroProcessamento>
        <d3p1:Orgao>String</d3p1:Orgao>
        <d3p1:Situacao>String</d3p1:Situacao>
        <d3p1:Valor>0</d3p1:Valor>
      </d3p1:Multa>
    </Multas>
    <Impedimentos xmlns:d3p1="http://schemas.datacontract.org/2004/07/DirectDigital.Intelligence.ServiceModel.Br.Detran.Mg.SituacaoVeiculo">
      <d3p1:Impedimento>
        <d3p1:Descricao>String</d3p1:Descricao>
      </d3p1:Impedimento>
    </Impedimentos>
    <Restricoes xmlns:d3p1="http://schemas.datacontract.org/2004/07/DirectDigital.Intelligence.ServiceModel.Br.Detran.Mg.SituacaoVeiculo">
      <d3p1:Restricao>
        <d3p1:Descricao>String</d3p1:Descricao>
      </d3p1:Restricao>
    </Restricoes>
  </Result>
</DetranMgSituacaoVeiculoResponse>

    </soap:Body>
</soap:Envelope>