Importar transação de combustível

post

https://api.cobli.co/herbie-1.1/fuel/transactions

Importa uma nova transação de combustível.
Com esse endpoint você pode:

Importar nova transação de combustível sem a necessidade de possuir uma associação de cartão combustível.
Anexar comprovante, foto do odômetro e foto da bomba de combustível, enviando a requisição como multipart/form-data.
Reenviar a mesma transação com segurança: enviar novamente os mesmos dados (mesmo veículo, data/hora, tipo de combustível, quantidade e custo total) retorna 409 em vez de duplicar — trate esse código como confirmação de que a transação já foi registrada.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Informações da transação a ser importada. Use multipart/form-data para anexar comprovante e fotos como arquivo binário.

vehicle_id

string

required

Id do veículo cadastrado na Cobli referente a transação realizada.

transaction_time

date-time

required

Data e hora em que a transação foi realizada.

fuel_type

string

required

Tipo do combustível abastecido.

quantity_in_liters

number

required

Quantidade de combustível, em litros, abastecido na transação.

total_cost

number

required

Custo total da transação.

odometer_in_km

number

required

Odômetro, em quilômetros, do veículo no momento da transação.

driver_name

string

Nome do motorista

created_by

string

Defaults to API

Nome da empresa responsável pela importação ou da fornecedora das informações da transação.

merchant

object

Dados do estabelecimento onde a transação foi feita.

Headers

content-type

string

enum

Defaults to application/json

Generated from available request content types

Allowed:

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Transação salva com sucesso

401Chave API inválida ou ausente

409Transação duplicada — já existe uma transação idêntica (mesmo veículo, data/hora, tipo de combustível, quantidade e custo total). Trate como confirmação de que a transação já foi registrada, não como erro, ao reenviar uma requisição.

500Erro no servidor