Obter lista

Lista, de forma paginada, os abastecimentos alterados em um período, para sincronização incremental. Inclui os abastecimentos excluídos.

Disponível para: Revendedor e Cliente
Rate limit: 100 requisições/minuto

Esta é a versão da documentação para token de Cliente.

Revendedor x Cliente

Revendedor: retorna os abastecimentos de todos os clientes do revendedor; customerId filtra um cliente.

Cliente: retorna apenas os abastecimentos do próprio cliente; se customerId for enviado, ele é ignorado.

Regras

Os filtros vão na query string.

A ordem é updatedAt e depois fuelRecordId, do mais antigo para o mais novo.

updatedSince e updatedUntil aceitam AAAA-MM-DD hh:mm:ss (UTC) ou ISO 8601 com fuso, como 2026-10-30T13:11:54Z ou 2026-10-30T10:11:54-03:00. O + de um fuso positivo vai codificado na URL como %2B.

Para sincronizar, guarde o maior updatedAt recebido e use-o como updatedSince na consulta seguinte. O filtro é inclusivo: o último registro volta e deve ser atualizado pelo fuelRecordId, não inserido de novo.

Abastecimento excluído vem com deletedAt preenchido.

Um lançamento retroativo recalcula o abastecimento seguinte do ativo, que também volta com updatedAt novo.

createdAt, updatedAt e deletedAt vêm em UTC no formato ISO 8601. filledAt é o horário local informado no lançamento, sem fuso (AAAA-MM-DD hh:mm:ss).

asset.size e asset.fuelType são a categoria do ativo e podem vir nulos.

kmPerLiter e costPerKm vêm nulos quando o trecho não tem distanceKm.

Identifique o ativo pelo asset.id: a placa (asset.plate) é opcional no cadastro.

perPage vai de 1 a 100 (padrão 20).

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

curl --location 'https://api.cloud-services.yuv.com.br/fuel-record?updatedSince=2026-10-30T13%3A11%3A54Z&updatedUntil=2026-10-31T23%3A59%3A59Z&page=1&perPage=100' \ --header 'Authorization: Bearer <token>'

{ "currentPage": 1, "data": [ { "fuelRecordId": 22, "customer": { "id": 2122, "name": "Transportadora Exemplo" }, "asset": { "id": 18963, "identifier": "CAM-03", "plate": "DEF4G56", "size": "LARGE", "fuelType": "DIESEL" }, "filledAt": "2026-10-29 18:00:00", "fuelType": "DIESEL", "liters": 45, "totalCost": 261, "odometer": 120900, "station": "Posto Exemplo", "notes": null, "origin": "MANUAL", "pricePerLiter": 5.8, "distanceKm": 900, "distanceMethod": "ODOMETER", "kmPerLiter": 20, "costPerKm": 0.29, "createdAt": "2026-10-30T13:38:02Z", "updatedAt": "2026-10-30T13:38:02Z", "deletedAt": null }, { "fuelRecordId": 23, "customer": { "id": 2122, "name": "Transportadora Exemplo" }, "asset": { "id": 18970, "identifier": "CAM-04", "plate": null, "size": null, "fuelType": null }, "filledAt": "2026-10-29 08:15:00", "fuelType": "GASOLINE", "liters": 30, "totalCost": 186, "odometer": null, "station": null, "notes": null, "origin": "DRIVER_APP", "pricePerLiter": 6.2, "distanceKm": null, "distanceMethod": "FIRST_RECORD", "kmPerLiter": null, "costPerKm": null, "createdAt": "2026-10-29T11:15:00Z", "updatedAt": "2026-10-30T09:00:00Z", "deletedAt": "2026-10-30T09:00:00Z" } ], "lastPage": 1, "perPage": 20, "total": 2 }

Revendedor x Cliente

Regras

Requisição

Respostas

Obter lista

Revendedor x Cliente#

Regras#

Requisição

Respostas

Revendedor x Cliente

Regras