Obter lista

Lista, de forma paginada, as manutenções alteradas em um período, para sincronização incremental. Inclui as manutenções canceladas e as excluídas.

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

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

Revendedor x Cliente

Revendedor: retorna as manutenções de todos os clientes do revendedor; customerId filtra um cliente.

Cliente: retorna apenas as manutenções do próprio cliente; se customerId for enviado, ele é ignorado.

Regras

Os filtros vão na query string.

A ordem é updatedAt e depois maintenanceId, 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 maintenanceId, não inserido de novo.

Manutenção excluída vem com deletedAt preenchido. Manutenção cancelada vem com status igual a CANCELLED e deletedAt nulo.

Alterar um item de custo ou uma ordem de serviço da manutenção atualiza o updatedAt dela.

createdAt, updatedAt, deletedAt e completedAt vêm em UTC no formato ISO 8601. scheduledDate e expectedCompletionDate são só data (AAAA-MM-DD).

odometerAtCompletion e hourmeterAtCompletion vêm da última telemetria do veículo na conclusão; manutenções concluídas antes deste campo existir vêm com eles nulos.

totalCost é a soma dos itens de custo da manutenção. O custo das ordens de serviço é a mesma soma: não some os dois.

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/maintenance?customerId=2521&updatedSince=2026-10-30T13%3A11%3A54Z&updatedUntil=2026-10-31T23%3A59%3A59Z&page=1&perPage=100' \ --header 'Authorization: Bearer <token>'

{ "currentPage": 1, "data": [ { "maintenanceId": 8, "customer": { "id": 2521, "name": "Transportadora Exemplo" }, "asset": { "id": 27486, "identifier": "CAM-01", "plate": "ABC1D23" }, "maintenanceType": { "id": 5, "name": "Troca de óleo", "category": "PREVENTIVE" }, "supplier": { "id": 4, "name": "Oficina Exemplo" }, "scheduledDate": "2026-10-25", "status": "COMPLETED", "odometerAtScheduling": 120000, "hourmeterAtScheduling": null, "completedAt": "2026-10-29T23:30:00Z", "odometerAtCompletion": 120450, "hourmeterAtCompletion": null, "expectedCompletionDate": "2026-10-30", "totalCost": 489.9, "notes": null, "createdAt": "2026-10-20T17:13:34Z", "updatedAt": "2026-10-30T13:11:54Z", "deletedAt": null }, { "maintenanceId": 11, "customer": { "id": 2521, "name": "Transportadora Exemplo" }, "asset": { "id": 28316, "identifier": "CAM-02", "plate": null }, "maintenanceType": { "id": 6, "name": "Troca de pneu", "category": "CORRECTIVE" }, "supplier": null, "scheduledDate": "2026-11-05", "status": "CANCELLED", "odometerAtScheduling": 98000, "hourmeterAtScheduling": null, "completedAt": null, "odometerAtCompletion": null, "hourmeterAtCompletion": null, "expectedCompletionDate": null, "totalCost": 0, "notes": "Cancelada pelo gestor", "createdAt": "2026-10-21T14:00:00Z", "updatedAt": "2026-10-30T14:03:00Z", "deletedAt": null } ], "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