TX Fuel Developers
Wiki
APIs de terceiro

GAS4US

APIs para integrar sistemas de terceiros (automação de posto, PDV, ERP…) ao GAS4US. O manual completo fica na wiki; esta página é o atalho para cada parte.

Comece aqui

Os quatro passos de toda integração.

Peça o acessoAo suporte: você recebe o servidor, o perfil, o identificador (segredo) e o id do app (A).
Monte a senha do diaTodo pedido leva o perfil, a SENHA do dia e A. Código pronto em várias linguagens na wiki.
Veja o que o seu perfil pode fazerApp, rede, filial, cliente: cada perfil lê e grava um escopo diferente.
Teste no SwaggerNo navegador, com a senha do dia calculada na própria página. Códigos de retorno: respostas e erros.

Ferramentas

Tudo gerado da mesma fonte que o manual: o que está aqui é o que está na wiki. Como usar cada uma ↗

Servidores

Use o servidor informado pela TX Fuel: os dados de cada empresa ficam em um deles.

ServidorEndereço base
Servidor 1https://gas4us1.txfuel.com.br/api
Servidor 2https://gas4us2.txfuel.com.br/api
# teste de conexão e credencial (responde {"status":"ok"})
curl "https://gas4us1.txfuel.com.br/api/v1/terceiro/status?APP=NOME&SENHA=SENHA_DO_DIA&A=ID_DO_APP"

Assuntos

Endpoints por assunto. Parâmetros, corpo, respostas e exemplos ficam na página de cada assunto na wiki.

Vendas e abastecimento

Ver na wiki ↗

Abastecimento com o token do app do cliente: validar, registrar, consultar e cancelar vendas no posto.

GETPOSTDELETEvenda

Preços e promoções

Ver na wiki ↗

Preço de bomba, preço do app (promoção vigente) e agenda semanal de descontos por posto e combustível.

GETPUTprecoBombaGETprecoAplicativoGETPUTagendaPostoGETPUTagendaPostoExtra

Financeiro e relatórios

Ver na wiki ↗

Faturamento, créditos, movimento e saldo dos clientes, repasses aos postos e situação de boleto.

GETfaturamentoGETfaturamentoAppGETcreditoGETmovimentoGETfinanceiroRelatorioSaldoGETtransferenciaGETtransferenciaCreditoGETboletoSituacao

Clientes e fidelidade

Ver na wiki ↗

Exportação do cadastro de clientes para o sistema do posto e programa de fidelidade (cupons, extrato, parceiros).

GETediClientesGETPOSTfidelidadeCupomGETfidelidadeExtratoGETfidelidadeParceiro

Geral

Ver na wiki ↗

Teste de credencial, tabelas de códigos (combustíveis) e observações livres.

GETstatusGETtabelasGETPOSTPUTDELETEtxObservacao

Integrações com outros sistemas

Sistemas de outras empresas com endpoints e particularidades próprias. Autenticação, perfis e erros são os do manual geral, salvo quando o manual da integração diz outra coisa.

SistemaEndpointsManualSwaggerPostman
Linx
Integração com a Linx (App do Consumidor/POS e AutoSystem): validar código, pós-venda, cancelar venda e preços dos produtos.
4wiki ↗abrirbaixar

Suporte

Acesso, identificador, dúvidas e erros 500.