Ir para o conteúdo principal

4.2 Restringir lista de itens utilizando a function CRMOne_Itens

Restringindo Itens com a Function CRMOne_Itens

Use a função CRMOne_Itens para definir quais produtos não devem aparecer no CRM One durante o preenchimento de documentos, como pedidos e cotações.

Parâmetros da função

A função recebe os seguintes parâmetros para filtrar os itens:

  • UserID: ID do usuário logado
  • CodigoCliente: código do cliente vinculado ao documento
  • ListaPreco: ID da lista de preços do documento
  • CondicaoPagamento: ID da condição de pagamento
  • Filial: ID da filial (em ambientes multifiliais)

Como funciona

A function deve retornar uma tabela com apenas uma coluna chamada ItemCode. Essa tabela será usada numa cláusula NOT IN.

Ou seja, os itens retornados por essa função não serão exibidos nas telas do CRM One.

Exemplo de regra

Exemplo de uso: restringir todos os produtos para clientes que não sejam a Maxi-Teq, exibindo apenas itens do grupo 105:

image.png

 

Como a função é utilizada com NOT IN, o SELECT da view/função deve listar os códigos dos itens que não devem aparecer. No exemplo acima, o retorno são itens fora do grupo 105 para clientes diferentes da Maxi-Teq.

Onde isso se aplica?

Essa filtragem será aplicada automaticamente em:

  • Listagem de itens
  • Assistente de itens
  • Outras interfaces que consultam produtos

Pré-requisitos

  • CRM One Add-on versão 2020.04.6.002 ou superior
  • API e aplicação web versão 2021.05.6.003 ou superior