Abastecimentos
Atualização a cada minuto
Exportar relatório
Inclui todos os registros sincronizados que correspondem aos filtros aplicados.
Compara a data/hora real, mesmo quando o envio chega atrasado. Não altera os abastecimentos.
Terminais Android vinculados
Cadastros oficiais da frota
Consulte seus abastecimentos em outros sistemas
Use o mesmo e-mail e senha do tablet e deste painel. A API retorna somente os abastecimentos já sincronizados das empresas e unidades autorizadas para sua conta.
1. Endereço e autenticação
Requisição GET, com autenticação Basic, sempre em HTTPS.
Envie Authorization: Basic BASE64(email:senha). Base64 é uma codificação; a proteção do transporte é o HTTPS. Não envie senha na URL. Mantenha as credenciais no servidor do sistema integrador.
A mesma API atende todas as contas. O login define o acesso; o filtro local não concede permissão para outra unidade. Sessões Bearer do Supabase também são aceitas.
2. Parâmetros de entrada
Datas no fuso UTC−03:00 (Brasília), no formato yyyy-mm-dd hh:mm:ss. Os dois limites são inclusivos.
| Nome | Obrigatório | Como preencher |
|---|
3. Exemplos de chamada
Defina AUTOCAF_USUARIO e AUTOCAF_SENHA no ambiente do seu sistema. Os dados dos exemplos são ilustrativos.
cURL · Linux / macOS / terminal compatível
Python · consulta de todas as páginas
4. Testar com minha conta
O teste usa sua sessão do painel e não pede a senha novamente. Nenhum abastecimento é alterado.
5. Resposta e paginação
sucesso: true indica consulta válida; dados: [] significa que nenhum registro corresponde aos filtros. Se proximo_cursor tiver valor, repita a chamada com esse cursor e as mesmas datas e local, até receber null.
Exemplo resumido. A resposta real inclui todos os campos documentados abaixo, com null quando a informação não foi coletada.
A ordenação é por chegada ao cloud e UUID. consulta_ate fixa o limite de chegada durante a paginação. Como um tablet offline pode enviar abastecimentos antigos depois, refaça periodicamente os períodos anteriores e grave por abastecid com chave única no seu sistema.
6. Campos retornados
Os nomes seguem o manual do webservice AutoCAF. Nesta integração, os IDs de abastecimento, empresa e cadastros são UUIDs; o tipo de medidor também aceita OH. Estes ajustes exigem adaptação em integrações antigas. Campos de consumo médio, frota e leituras anteriores ficam nulos.
| Campo | Tipo | Descrição |
|---|
7. Falhas e uso recomendado
400: parâmetros inválidos. 401: credenciais ou sessão inválidas. 403: acesso negado. 405: use GET. 429: aguarde e tente novamente. 500, 502 ou 504: falha temporária; repita com espera progressiva.
Erros retornam sucesso: false, mensagem, erro e dados: []. Consulte, por exemplo, a cada minuto e continue as páginas sequencialmente. Não existe ambiente de homologação separado nesta implantação.
Fotos permanecem privadas. Os campos de URL apontam para objetos do Storage; abrir ou baixar exige sessão Bearer autorizada para a unidade e depende de a foto ainda existir. A API não libera bombas nem altera configurações.
Registros sincronizados
Carregando…
