cold-science

Quem sou eu

Retorna identidade do operador atual: nome, papel, permissões efetivas e estado do kill-switch. Use primeiro para saber o que este operador pode fazer.

Vendas por período

Relatório de vendas (receita, pedidos, ticket médio, série temporal). Canal padrão: COLD_SCIENCE. Se series.truncado:true, refine o intervalo de datas.

Vendas por cupom

Relatório de vendas por cupom (receita, desconto, share, ticket médio por código). Canal padrão: COLD_SCIENCE. Máximo 50 cupons por resposta — refine o período se necessário.

Comissões por afiliado

Relatório de comissões por afiliado (base, pendente, pago, estornado). PII mascarada. Máximo 50 linhas por resposta — refine o período se necessário.

KPIs do dashboard

KPIs do painel: pedidos, vendas, pendentes de pagamento, top cupons, estoque baixo. Escolha periodo: day | week | month (padrão: month).

Listar pedidos

Lista pedidos com filtros: status, período, canal (sem padrão: omitir = todos), busca por nome/número. Se truncado:true, use pagina=N ou refine os filtros.

Detalhe do pedido

Detalhe completo de um pedido: cliente (PII mascarada), itens, totais, endereço, envio. Se itensTruncados:true há mais itens — use listar_pedidos para resumo.

Pedidos pagos sem etiqueta

Pedidos pagos sem etiqueta de envio gerada. Canal padrão: COLD_SCIENCE (use ALL para ver Excellency). Se truncado:true, use pagina=N.

Fila de expedição

Fila de expedição: pedidos prontos para separar/embalar (PII mascarada). Se truncado:true há mais pedidos na fila.

Detalhe do envio

Detalhe do envio de um pedido: transportadora, rastreio, eventos (PII mascarada). Eventos limitados a 20; use o painel para ver o histórico completo.

Estoque de produto

Estoque atual por SKU (quantidade, reservado, disponível, status). Se truncado:true, refine a busca ou use pagina=N.

Estoque baixo

Produtos abaixo do limiar de estoque baixo (configurado nas Settings). Se truncado:true há mais produtos — use estoque_de_produto para busca específica.

Buscar produtos

Busca produtos do catálogo admin (inclui inativos). Se truncado:true, refine a busca ou use pagina=N.

Detalhe do produto

Detalhe de um produto pelo slug (admin: inclui inativos). Obtenha o slug via buscar_produtos antes de chamar esta tool.

Buscar cliente

Busca clientes (PII mascarada: email, telefone, CPF). Se truncado:true, refine a busca ou use pagina=N.

Listar cupons

Lista cupons de desconto (código, tipo, usos, validade). Se truncado:true, filtre por ativo ou use pagina=N.

Listar afiliados

Lista afiliados e comissões individuais (PII mascarada). Se truncado:true, filtre por status ou período, ou use pagina=N.

Listar fornecedores

Lista fornecedores (nome, país, contato, ativo). Se truncado:true, refine a busca ou use pagina=N.

Listar ordens de compra

Lista ordens de compra (código, fornecedor, status, total USD/BRL). Se truncado:true, filtre por status ou use pagina=N.

Detalhe da ordem de compra

Detalhe de uma ordem de compra: itens, custos, recebimentos, anexos. Se *Truncados:true há mais dados — use o painel para ver tudo.

Sugestão de compra

Sugestão de reposição de estoque: produtos com criticidade alta e quantidade sugerida. Se truncado:true há mais sugestões.

Entregas de notificação

Histórico de entregas de notificações (destinatário mascarado na origem). Se truncado:true, filtre por tipo/canal/status ou use pagina=N.

Configuração de notificações

Matriz de canais de notificação: qual canal (email/whatsapp/off) está ativo para cada tipo de evento.

Configurações da loja

Configurações operacionais da loja: frete grátis, PIX, cashback, estoque baixo, kill-switch MCP.

Status das integrações

Status das integrações (nome, adapter, habilitado, atualizado em). Nunca devolve segredos de configuração (ADR-148 P1).