Dinn Pharma Stock

Use esta ferramenta quando o usuário quiser entender uma loja específica e seu ranking de SKUs. Requer uma referência retornada por outra ferramenta; não aceite IDs livres.

stock.get_point_of_sale

Use esta ferramenta quando o usuário quiser analisar a evolução da ruptura de um produto já resolvido ao longo do tempo. Exija product_refs por padrão e preserve todas as apresentações escolhidas da família; só analise carteira inteira por pedido explícito. Não use para o valor pontual atual ou para listar PDVs.

stock.get_rupture_trend

Use esta ferramenta quando, depois de definir o produto, o usuário quiser escolher uma rede, UF, cidade ou brick válido. Se ele não especificar rede, confirme se deseja uma rede específica ou todas antes da análise. Não use para calcular indicadores.

stock.get_filter_options

Use esta ferramenta quando o usuário quiser ordenar as apresentações de um produto ou as redes do recorte por ruptura. Exija product_refs por padrão; carteira inteira é somente para pedido explícito de portfólio. Chame no máximo uma vez com os mesmos argumentos por resposta, salvo paginação ou refinamento solicitado. Ruptura extrema pode indicar descontinuação, saída de linha ou exclusão de sortimento, mas não confirme a causa sem evidência. Não use para detalhe de PDV nem para localizar farmácias próximas.

stock.get_ranking

Use esta ferramenta quando o usuário quiser uma visão executiva de disponibilidade de um produto já resolvido: PDVs, SKUs, estoque aproximado, percentual sem estoque e criticidade. Exija product_refs por padrão; só omita para carteira inteira quando isso for pedido explicitamente. Não use para tendência histórica ou detalhe de uma loja.

stock.get_overview

Use esta ferramenta quando o usuário quiser encontrar ou comparar PDVs para um produto já resolvido, por ruptura, dias parados, estoque congelado, localização ou indicadores comerciais autorizados. Exija product_refs por padrão; carteira inteira é somente para pedido explícito. Não use para abrir o detalhe completo de uma loja.

stock.list_points_of_sale

Use esta ferramenta quando for preciso resolver o produto antes de qualquer análise de disponibilidade ou ruptura. Pesquise pelo nome ou família informada e devolva todas as apresentações, SKUs e EANs autorizados relacionados; não liste o catálogo inteiro salvo pedido explícito. Não use para calcular indicadores.

stock.list_products

Use esta ferramenta quando o usuário fizer um pedido genérico de análise ou pedir uma visualização salva, favorita ou recente. Liste atalhos privados do próprio usuário para ele escolher; não aplique filtros silenciosamente. Pule esta ferramenta quando produto ou família já estiver informado. Não use para criar, alterar, favoritar ou excluir visualizações.

stock.list_saved_views

Use esta ferramenta quando o usuário quiser localizar farmácias próximas com ou sem estoque de um produto. Requer produto e coordenadas já autorizadas pelo usuário; não use para rankings de carteira.

stock.find_product_locations