| Ferramenta | Parâmetros | Retorno |
|---|---|---|
industria24_listar_registros | tabela, limite (1–200, padrão 20), offset, filtro_coluna, filtro_valor | registros, total_count, has_more, next_offset |
industria24_buscar_registro | tabela, id | O registro, ou mensagem de não encontrado |
industria24_buscar_produtos | termo, limite(1–100) | Produtos cujo nome contém o termo |
industria24_rastrear_corrida | corrida_id, limite(1–200) | transport, device, locations — ver Rastreio em tempo real |
O parâmetro tabela aceita apenas esta lista. Qualquer outro valor é rejeitado antes de chegar ao banco.
produtos lojas categorias
subcategorias pedidos linha_itens
entregas vendas_futuras promocoes_progressivas
afiliacoes centros_distribuicao
corridas corrida_posicoesPágina por offset. Enquanto has_more for verdadeiro, repita a chamada com o next_offset devolvido. total_count é a contagem exata do filtro aplicado.
{
"registros": [ ... ],
"total_count": 137,
"has_more": true,
"next_offset": 20
}Exigem token i24_write_ aprovado e o módulo correspondente habilitado. Toda escrita é filtrada pelo loja_id do token e registrada em auditoria.
| Ferramenta | Parâmetros | Módulo |
|---|---|---|
industria24_atualizar_produto | id, nome, descricao, valor, sku | catalogo |
industria24_atualizar_estoque | id, estoque_atual | catalogo |
industria24_atualizar_status_pedido | id, status_pedido | pedidos |
industria24_atualizar_entrega | linha_item_id, status (Pendente | Enviado | Entregue), rastreio | pedidos |
Erros de ferramenta voltam como conteúdo de texto com isError, no formato Erro: mensagem — o agente lê e explica. Falha de token acontece antes, no HTTP.
| Situação | O que você vê |
|---|---|
| Token ausente, inválido, expirado ou revogado | 401 no HTTP |
| Token de leitura chamando ferramenta de escrita | A ferramenta nem aparece na lista |
| Módulo de escrita ainda não habilitado | Erro explicando qual módulo falta |
| Registro de outra loja | Erro de não encontrado — nunca os dados |
| Nenhum campo enviado no update | Erro: nenhum campo para atualizar |