Toda chamada leva três parâmetros na query:
| Parâmetro | O que é |
|---|---|
APP, REDE, CNPJ ou CPF |
Um deles, conforme o seu acesso: o nome do app, o nome da rede, ou o CNPJ/CPF (do posto ou do cliente) |
SENHA |
Senha do dia, calculada por você (abaixo) |
A |
Id do app no GAS4US (informado pela TX Fuel) |
SENHA = md5( identificador + data + valor )
AAAA-MM-DD (ex.: 2026-11-12). O servidor aceita tambémAPP/REDE (o nome do app ou da rede, como cadastrado) ou o CNPJ/CPFCNPJ/CPF).Exemplo (valores fictícios): identificador 0123456789abcdef0123456789abcdef, data 2026-11-12, CNPJ=00000000000100:
md5("0123456789abcdef0123456789abcdef" + "2026-11-12" + "00000000000100")
GET https://gas4us1.txfuel.com.br/api/v1/terceiro/status?CNPJ=00000000000100&SENHA=<md5>&A=1
bash (Linux e macOS)
IDENTIFICADOR='seu-identificador'; VALOR='00000000000100'
SENHA=$(printf '%s' "$IDENTIFICADOR$(TZ=America/Sao_Paulo date +%F)$VALOR" | { md5sum 2>/dev/null || md5; } | cut -d' ' -f1)
curl -s "https://gas4us1.txfuel.com.br/api/v1/terceiro/status?CNPJ=$VALOR&SENHA=$SENHA&A=1"
Python
import hashlib, datetime, zoneinfo
hoje = datetime.datetime.now(zoneinfo.ZoneInfo('America/Sao_Paulo')).strftime('%Y-%m-%d')
senha = hashlib.md5((identificador + hoje + valor).encode('utf-8')).hexdigest()
JavaScript (Node.js)
const crypto = require('crypto');
const hoje = new Date().toLocaleDateString('sv-SE', { timeZone: 'America/Sao_Paulo' }); // AAAA-MM-DD
const senha = crypto.createHash('md5').update(identificador + hoje + valor, 'utf8').digest('hex');
Java
String hoje = java.time.LocalDate.now(java.time.ZoneId.of("America/Sao_Paulo")).toString();
byte[] h = java.security.MessageDigest.getInstance("MD5").digest((identificador + hoje + valor).getBytes(java.nio.charset.StandardCharsets.UTF_8));
String senha = java.util.HexFormat.of().formatHex(h);
C#
var tz = TimeZoneInfo.FindSystemTimeZoneById("America/Sao_Paulo"); // Windows antigo: "E. South America Standard Time"
var hoje = TimeZoneInfo.ConvertTime(DateTime.UtcNow, tz).ToString("yyyy-MM-dd");
var senha = Convert.ToHexString(System.Security.Cryptography.MD5.HashData(System.Text.Encoding.UTF8.GetBytes(identificador + hoje + valor))).ToLowerInvariant();
PHP
$hoje = (new DateTime('now', new DateTimeZone('America/Sao_Paulo')))->format('Y-m-d');
$senha = md5($identificador . $hoje . $valor);
%20) — as bibliotecas HTTP fazem isso sozinhas.| Código | Quando |
|---|---|
401 |
Identificador, senha, valor ou A não conferem; acesso bloqueado; app inativo |
403 |
Autenticou, mas o seu perfil não pode usar este método neste endpoint, ou o registro pedido não é do seu escopo (outro posto, outro cliente) |