DOCUMENTAÇÃO CORPORATIVA
Validar Ordem de Abastecimento
POST /api/broker/ordemAbastecimento/validar
Endpoint responsável validar todos os Parâmetros de Controle cadastrados pelo Frotista. Nele serão enviados os campos necessários para essa validação e, caso configurado previamente pelo responsável da Ordem em questão, impedirá o pagamento quando existir alguma não conformidade.
Importante:
Se no objeto de Resposta dos campos solicitados no Retorno da Localização houver uma resposta de um campo do tipo MultiSelect (6), os valores serão delimitados por “ ; “ .
Headers
Content-Type | application/json |
Authorization | Bearer {token} |
Request Body application/json
Schema:
Campo | Tipo | Descrição | Obrigatório |
Localizador | String | Código de Identificação da Ordem de Abastecimento, disponibilizado pelo Motorista. | Sim |
Identificador | String | Identificador do Combustível que será Abastecido. | Sim |
ValorLitro | Decimal | Valor por Litro do Combustível que será Abastecido. | Sim |
Resposta | Array Of Object <Resposta> | Objeto de Resposta dos campos solicitados no Retorno da Localização. | Sim |
Resposta:
Campo | Tipo | Descrição |
Chave | String | Chave do Campo solicitado na Etapa de Localização. |
Valor | String | Valor preenchido para Validação. |
JSON:
{
"localizador": "128",
"identificador": "DSS10",
"valorLitro": 3.900,
"resposta": [
{
"chave": "23",
"valor": "1000"
},
{
"chave": "24",
"valor": "ZZZ1234"
},
{
"chave": "25",
"valor": "82193909210"
},
{
"chave": "29",
"valor": "2"
},
{
"chave": "31",
"valor": "2;3;4"
}
]
}
Response Body application/json
Campo | Tipo | Descrição |
Localizador | String | Código de Identificação da Ordem de Abastecimento, disponibilizado pelo Motorista. |
Mensagem | String | Mensagem indicando resultado da operação. |
Detalhes | Object <Detalhe> | Dados da Ordem de Abastecimento a serem apresentados para o Usuário. |
<Detalhes>:
Campo | Tipo | Descrição |
Solicitante | String | Nome do Frotista/Empresa que cadastrou a Ordem de Abastecimento. |
DescricaoCombustivel | String | Descrição do Combustível liberado para essa Ordem de Abastecimento, quando houver. |
ValorLitro | Decimal | Valor por Litro do Combustível em questão, cadastrado previamente pelo Posto de Combustível. |
DescontoNegociado | Decimal | Valor de Desconto Negociado previamente pelo Posto de Combustível e o Transportador/Frotista. |
ValorLitroNegociado | Decimal | Valor por Litro Negociado. No caso de não existir uma negociação prévia, constará o Valor por Litro cadastrado pelo Posto de Combustível. |
QuantidadeLitrosLiberada | Decimal | Quantidade de Litros liberados para abastecimento. (Disponibilizado apenas para Ordens de Abastecimento que não sejam Tanque Cheio) |
TanqueCheio | Boolean | Indica se a Ordem de Abastecimento é para Tanque Cheio. Nesse caso, o Valor Total da Ordem será a Quantidade de Litros Abastecidos multiplicado pelo Valor Litro Negociado (Disponibilizado nesse objeto) |
JSON:
{
"Localizador": "128",
"Mensagem": "Ordem de Abastecimento Validada com Sucesso!",
"detalhes": {
"solicitante": "IS Transportes",
"descricaoCombustivel": "Diesel",
"valorLitro": 3.800,
"descontoNegociado": 0.300,
"valorLitroNegociado": 3.500,
"quantidadeLitrosLiberada": 0.000,
"tanqueCheio": true
}
}