As APIs de terceiro permitem que outros sistemas conversem com o PetroW: supervisórios de carregamento e descarregamento,
balanças, cancelas, totens, ERPs de distribuidoras e transportadoras, laboratórios e qualquer integração que precise ler ou
gravar ordens, notas fiscais, laudos e cadastros.
A).| Servidor | Endereço base |
|---|---|
| Servidor 1 | https://pwbase1.txfuel.com.br/api |
| Servidor 2 | https://pwbase2.txfuel.com.br/api |
Use o servidor informado pela TX Fuel: os dados de cada empresa ficam em um deles. Todos os caminhos deste manual começam
em /v1/terceiro/… depois do endereço base (exemplo: https://pwbase1.txfuel.com.br/api/v1/terceiro/ordem).
| Assunto | Endpoints |
|---|---|
| Ordens | ordem, ordemCarregamento, ordemDescarregamento, ordemLacre, ordemAmostra, conferencia |
| Notas fiscais, CT-e e laudos | notaFiscal, importarNotaFiscal, conhecimentoTransporte, importarConhecimentoTransporte, laudoProduto, movimentoSaldoDia |
| Cadastros | cliente, fornecedor, transportadora, veiculo, motorista, produto, txPessoa, txEstabelecimento, operador, txObservacao |
| Supervisório e automação | supervisorio, danload6000, zlx9000, dayler, totem, balanca, cancela, camera, impressoraJob, status |
Alguns sistemas de outras empresas, usados por clientes do PetroW, têm endpoints próprios, com particularidades e
customizações feitas para a integração deles.
A documentação de cada um fica separada (a autenticação, os perfis e os erros são os deste manual):
| Sistema | Manual | Swagger | Postman |
|---|---|---|---|
| Basama | petrow/api/basama | abrir | baixar |
| Vitreum | petrow/api/vitreum | abrir | baixar |
"status": "ok" ou "status": "error" com os erros em errors — veja Respostas e erros.AAAA-MM-DD, data e hora AAAA-MM-DD HH:MM:SS.AAAA-MM-DDTHH:MM:SS.ffffff, com segundos e frações omitidos quando zero2026-11-12T08:30); 1980-01-01T00:00 significa "sem data" e 2099-12-31T23:59:59, "sem limite".