list_products
Produtos (cadastro vendável) · domínio Vendas · escopo mcp:inventory
O que faz
Lista/pesquisa o cadastro de produtos VENDÁVEIS (ativos, não fora de linha, não proibidos). Retorna a classificação completa (departamento, seção, categoria, subcategoria, linha de produto e marca — com nomes), os códigos de barras (EAN-13 da unidade, DUN-14 da caixa, e do display/fardo quando houver) e a unidade de venda. Filtre por fornecedor, categoria, subcategoria, linha, departamento, seção, marca, ou pelo código de barras exato (ean).
Parâmetros
| Parâmetro | Tipo | Obrigatório | Padrão | Significado |
|---|---|---|---|---|
supplier_code | integer | não | — | |
category_code | integer | não | — | |
product_code | integer | não | — | |
subcategory_code | integer | não | — | |
line_code | integer | não | — | Linha de produto (LINHA DE PRODUTO) |
department_code | integer | não | — | Departamento |
section_code | integer | não | — | Seção |
brand_code | integer | não | — | Marca |
ean | string | não | — | Código de barras EAN-13 da unidade, busca exata |
limit | integer (1–1000) | não | 100 |
O que você recebe
product_code— Produto (cód.)description— Descriçãosupplier_code— Fornecedor (cód.)category_code— Categoria
Cuidados ao ler o resultado
Leia antes de interpretar
- Vendável = PCPRODFILIAL ATIVO='S', não fora-de-linha, não proibido (rotina 238) — não o OBS2='FL'.
- Classificação WinThor: categoria (grossa, ~77) ⊃ subcategoria (~146); linha de produto = a taxonomia comercial (WAFERS, ROSQUINHA…).
- ean13 = código de barras da unidade; dun14 = da caixa. ean_display/ean_fardo (display/caixa de revenda/fardo) existem só p/ ~24% dos itens — vazio quando o produto não tem essa embalagem cadastrada.
- Unidades por caixa = units_per_box (QTUNITCX).
Por trás da ferramenta
Esta ferramenta consulta o endpoint /v1/products da API REST — as mesmas permissões e o mesmo recorte da sua credencial valem nos dois caminhos.
Esta página ajudou? Conte para a gente — lemos tudo.