Changelog

Histórico de mudanças, novos endpoints e breaking changes da API.

[v1.2] — 2026-08-13

Transportadora (API de Clientes)

Novos endpoints

  • POST /v1/customers/fuelings — Registra manualmente um abastecimento avulso de um veículo do cliente (substitui POST /v1/customers/transactions).

  • GET /v1/customers/products e GET /v1/customers/products/{id} — Catálogo de produtos.

Correções

  • GET /v1/customers/invoices — corrigido o campo invoice_url (segmento de rota ausente) e a ordenação passou a ser estável entre chamadas.

  • GET /v1/customers/transactions — o campo invoice_key deixou de retornar null quando a consulta é filtrada por invoice_key.

Breaking Changes

  • Removido POST /v1/customers/transactions. Use POST /v1/customers/fuelings para registrar um abastecimento avulso.

⛽ Fornecedor (API de Fornecedores)

Novos endpoints

  • GET /v1/suppliers/products e GET /v1/suppliers/products/{id} — Catálogo de produtos.

  • GET /v1/suppliers/batch/{processId} — Consulta o status de um processamento assíncrono de lote de preços.

  • GET /v1/suppliers/invoices/data-issuing — Retorna os dados necessários para emissão de NF-e de recolha autônoma.

Atualizações

  • Preços — os endpoints de lote (POST /v1/suppliers/prices/standard/batch e POST /v1/suppliers/prices/agreements/batch) passam a processar de forma assíncrona: retornam 202 Accepted com process_id e status = PENDING; o andamento é consultável em GET /v1/suppliers/batch/{processId}.

  • Listagens paginadas — listagens de repasse e de notas pendentes passam a usar o envelope paginado padrão (data, total_items, page, page_size).

Breaking Changes

  • POST /v1/suppliers/invoices (anexar NF-e de recolha) — corpo da requisição alterado: os campos xml_content e invoice_key foram removidos; envie o XML em xml_content_base64.

[v1.1] — 2026-04-29

Correções

  • GET /v1/suppliers/transactions — corrigido endpoint errado no guia de Primeiros Passos do Fornecedor (estava usando /v1/customers/vehicles)

  • Autenticação — removido header Authorization duplicado no exemplo curl

  • Autenticação — corrigida instrução de navegação para Perfil → Subscriptions (antes referenciava página Produtos inexistente)

  • Paginação — corrigido texto que mencionava objeto meta; os metadados de paginação ficam na raiz da resposta

  • Primeiros Passos (Transportadora e Fornecedor) — adicionada instrução sobre onde encontrar client_id e client_secret após aprovação

Novas Páginas

  • Ambientes de Integração — nova página descrevendo URLs e credenciais de Homologação e Produção

  • Changelog — esta página, para registro histórico de mudanças na API e no portal

Breaking Changes

Nenhum.

Tipos de Mudança

  • Novo endpoint — endpoint adicionado à API

  • Atualização — comportamento ou documentação de endpoint existente alterado

  • Correção — bug ou imprecisão corrigido

  • Breaking change — mudança incompatível com versões anteriores

  • Depreciado — endpoint ou parâmetro marcado para remoção futura