Cadastro, preços, variações, kits e imagens.
Só consultaEncontra produtos pelo nome (em qualquer ordem das palavras) ou pelo código.
“Busca cadeira de escritório”
“Quais produtos de papelaria temos com estoque?”
buscar_produtos
O que não faz
- Não filtra por categoria (a listagem do Bling não traz a categoria).
- Preço e estoque desta lista podem ter até 10 min de atraso; para o saldo atual use consultar_estoque.
Só consultaMostra a ficha completa de um produto: preço, custo, NCM, pesos, variações e saldo.
“Ficha do produto 1050”
“Qual o NCM da caneca de porcelana?”
detalhar_produto
O que não faz
- Não mostra histórico de vendas do produto; use listar_pedidos_venda com `produto`.
Só consultaLista todos os campos de produto que dá para preencher ou alterar.
“Quais campos do produto eu consigo alterar?”
listar_campos_produto
O que não faz
- Não altera nada; é só a lista de nomes aceitos.
Só consultaPlaneja um cadastro antes de criar: confere duplicados e o que falta preencher.
“Quero cadastrar uma camiseta X azul e preta, P, M e G, a 59,90”
“Cadastra um kit com 2 cadernos e 1 caneta”
planejar_produto
O que não faz
- Não grava nada: devolve o plano (simples, variações ou kit) e as perguntas pendentes.
- Não decide sozinho entre variações e kit quando a descrição é ambígua: pergunta.
Mostra prévia e pede confirmaçãoAcrescenta variações (cor, tamanho) a um produto que já tem variações.
“Adiciona a cor verde na camiseta X”
“Adiciona a cor verde em P e M na camiseta X (atributos: Cor=[Verde], Tamanho=[P, M])”
adicionar_variacao
O que não faz
- Só em produto que já tem variações; para produto simples use converter_em_variacoes.
- Ignora variações que já existem.
Mostra prévia e pede confirmaçãoTransforma um produto simples em produto com variações.
“Transforma a camiseta básica em produto com variações de cor, transferindo o estoque”
converter_em_variacoes
O que não faz
- Não decide sozinho o que fazer com o saldo: exige 'zerar' ou 'transferir'.
- Não converte produto que já tem variações ou é kit.
Mostra prévia e pede confirmaçãoCadastra um produto novo.
“Cadastra o produto Garrafa térmica 500 ml a R$ 38,90, unidade UN”
“(com plano) Pode criar a camiseta com as 6 variações que planejamos”
criar_produto
O que não faz
- Não cria sem prévia e confirmação.
- Não aceita plano com pendências: primeiro feche com planejar_produto.
- Avisa se já existe produto com o mesmo nome.
Mostra prévia e pede confirmaçãoMonta um kit: define quais produtos e quantidades o compõem.
“Monta o kit escritório com 2 cadernos e 1 caneta”
definir_componentes
O que não faz
- Não movimenta estoque; só define a estrutura.
- Produto com variações não pode virar kit.
Mostra prévia e pede confirmaçãoColoca ou troca as imagens e o vídeo de um produto, na ordem que você quiser.
“Coloca estas 3 imagens no produto 1050, nesta ordem”
definir_imagens
O que não faz
- Não faz upload de arquivo: só links públicos (http/https).
- Substitui as imagens externas atuais.
Mostra prévia e pede confirmaçãoAltera preço, descrição, NCM ou qualquer outro campo de um produto.
“Muda o preço da caneca de porcelana para 15,90”
“Coloca o NCM 6912.00.00 na caneca de porcelana”
editar_produto
O que não faz
- Não altera nada sem prévia e confirmação (token de 15 min).
- Não move saldo de estoque (use movimentar_estoque).
- Ainda não mexe em variações, composição e imagens.
- Campos fiscais (NCM, CEST, origem) elevam o risco para R2 e a prévia avisa.
Mostra prévia e pede confirmaçãoExclui um produto (dá para restaurar depois).
“Exclui o produto caneca de porcelana”
“Remove o produto 1050 do cadastro”
excluir_produto
O que não faz
- Não apaga de verdade: muda a situação para Excluído, reversível com restaurar_produto.
- Não exclui sem prévia e confirmação.
- Avisa se o produto aparece em pedidos em aberto.
Mostra prévia e pede confirmaçãoTraz de volta um produto excluído ou inativo.
“Restaura o produto caneca de porcelana”
“Reativa o produto 1050”
restaurar_produto
O que não faz
- Não restaura sem prévia e confirmação.