Abastecimentos
—Nesta páginaAbastecimentos
Atualização a cada minuto
Litros medidos
—Nesta páginaVeículos identificados
—Nesta páginaEstoque virtual
Volume dos tanques das unidades autorizadas
Terminais Android vinculados
Leitor RFID remoto
Use um Android da mesma conta como leitor de etiquetas. Abra Admin → Leitor RFID remoto no app e permita a leitura.
Selecione um terminal com o AutoCAF 1.0.40 ou superior.
Nenhuma etiqueta recebida
Novas leituras são acrescentadas ao final. Mantenha Número e UID separados por tabulação; uma terceira coluna pode conter observações. A mesma UID não é repetida na sessão.
Sessão de até 30 minutos. Os dados temporários do cloud são excluídos ao encerrar ou expirar. Copie ou exporte a lista antes de fechar esta página.
Cadastros oficiais da frota
Uma etiqueta por cadastro. Use Salvar e cadastrar outro para continuar a leitura.
Tanques e movimentações
Controle virtual, sem bloqueio de abastecimentos por saldo.
As saídas consideram os abastecimentos dos bicos vinculados pela data/hora real, inclusive os enviados com atraso e os com inconsistências cadastrais. O saldo pode ficar negativo. A capacidade é uma referência visual.
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…
