Cadastrar Login ☰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