Pra integrar o Frete Offline com um ERP (Bling, Tiny, etc.), o ERP precisa identificar qual método de envio o cliente escolheu. Isso é feito pelo ID do método.
Formato do ID
O ID gerado pelo plugin segue o padrão:
wcts_<instance_id>
Por exemplo: wcts_64.
wcts_é o prefixo fixo do plugin (significa "wc table shipping").64é o ID da instância do método dentro do WooCommerce.
É esse valor que você cadastra no seu ERP.
Como descobrir o instance_id
O instance_id é único por método de envio. Pra encontrar:
- Vá em WooCommerce → Configurações → Entrega.
- Clique na área de entrega que contém o método.
- Clique no nome do método pra editar.
- Olhe a URL no navegador. Vai ter algo como:
wp-admin/admin.php?page=wc-settings&tab=shipping&instance_id=64 - O número depois de
instance_id=é o que você precisa.
No exemplo acima, o ID é 64. O valor pra cadastrar no ERP é wcts_64.
Múltiplos métodos = múltiplos IDs
Cada instância do Frete Offline tem instance_id próprio. Se você tem:
- Frete Offline na área "Brasil" →
wcts_64 - Frete Offline na área "Sul" →
wcts_72 - Frete Refrigerado (também offline) →
wcts_85
São três IDs distintos pro ERP.
Antes de qualquer pedido real, cadastre os IDs no ERP e faça um pedido teste pra confirmar que o ERP reconheceu o método. Sem o ID correto, o pedido entra no ERP sem método de envio identificado.
Mudou o método e o ID quebrou?
Se você apaga e recria um método, o instance_id muda. O ERP perde o vínculo até você atualizar.
Pra evitar isso, edite o método em vez de apagar e recriar quando possível. Trocar a tabela CSV ou o nome não afeta o ID.
Variação por linha (label)
O ID identifica o método, não a linha da tabela. Se duas linhas diferentes do CSV correspondem ao mesmo cliente, o ERP recebe o mesmo wcts_<instance_id> — apenas o nome (campo Nome da tabela) muda na exibição.
Pra integrações que precisam saber qual linha foi escolhida, use o filter wc_table_shipping_rate pra salvar metadados extras no pedido. Veja Salvar dados da tabela no pedido.