PetroW
APIs para integrar sistemas de terceiros (supervisório, balança, ERP, transportadora…) ao PetroW. O manual completo fica na wiki; esta página é o atalho para cada parte.
Comece aqui
Os quatro passos de toda integração.
A).SENHA do dia e A. Código pronto em várias linguagens na wiki.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.
| Servidor | Endereço base |
|---|---|
| Servidor 1 | https://pwbase1.txfuel.com.br/api |
| Servidor 2 | https://pwbase2.txfuel.com.br/api |
# teste de conexão e credencial (responde {"status":"ok"})
curl "https://pwbase1.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.
Ordens
Ver na wiki ↗Ordens de carregamento e descarregamento: criar, consultar, mudar a situação (fila, operação, finalizar), cancelar, lacres, amostras e conferência.
Notas fiscais, CT-e e laudos
Ver na wiki ↗Consulta de notas fiscais e CT-e, pedido de importação pela chave, laudos de produto (com checklist) e movimento de saldo diário.
Cadastros
Ver na wiki ↗Clientes, fornecedores, transportadoras, veículos, motoristas, produtos, pessoas, filiais, operadores e observações.
Supervisório e automação
Ver na wiki ↗Usadas pelo programa Supervisório e pelos equipamentos da base: ordens do dia, senhas, eventos, tanques, peso de balança, cancela, câmera, totem, Dayler, Danload e impressão.
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.
| Sistema | Endpoints | Manual | Swagger | Postman |
|---|---|---|---|---|
| Basama Integração com o Basama, sistema usado por clientes do PetroW (formato SisPetro): criação e cancelamento de ordem. | 2 | wiki ↗ | abrir | baixar |
| Vitreum Integração com o Vitreum, sistema usado por clientes do PetroW: rotas /v1/terceiro/vitreum/. | 20 | wiki ↗ | abrir | baixar |
Suporte
Acesso, identificador, dúvidas e erros 500.