Tabela 240 - Política de observação de produto

Este artigo apresenta os campos do layout de integração da Política de Observação do Produto.

Para entender melhor o conceito por trás dessa política, recomendamos a leitura do artigo Conceito da Política de Observação do Produto. Saiba como fazer a Exclusão de Políticas de Observação de Produto por integração.

Campos do layout

Ordem	Descrição do Campo	Formato e Tamanho	Obrigatório	Versão	Observação
1	Identificador da Tabela (IDENTIFICADOR)	Fixo=240 (3)	Sim	5.12	Identifica o layout de integração.
2	Código (codigo)	Texto (30)	Sim	5.12	Identificador da política no ERP. A integração localiza o registro pelo código dentro da empresa; reutilize o mesmo código para atualizar a política.
3	Código do produto (codProduto)	Texto (30)	Sim	5.12	Código do produto ao qual a observação se aplica.
4	Código do cliente (codCliente)	Inteiro	Não	5.12	Restringe a política ao cliente informado. Vazio: não restringe por cliente. Nas versões antigas, o cliente era obrigatório.
5	Observação (observacao)	Texto (TEXT)	Sim	5.12	Texto completo da observação. Pode conter HTML, renderizado no aplicativo.
6	Código da lista de preço (codListaPreco)	Texto (30)	Não	—	Restringe à lista de preço do cenário do pedido. Vazio: não restringe por lista.
7	Código da filial (codFilial)	Texto (30)	Não	—	Restringe à filial do pedido. Vazio: não restringe por filial.
8	Código do vendedor (codVendedor)	Inteiro	Não	—	Restringe ao vendedor do pedido. Vazio: não restringe por vendedor.
9	Código do tipo de pedido (codTipoPedido)	Inteiro	Não	—	Restringe ao tipo de pedido informado. Vazio: não restringe por tipo.
10	Prioridade (prioridade)	Inteiro	Não	—	Entre políticas com a mesma especificidade, prevalece o menor número. Recomenda-se informar explicitamente, por exemplo, 1.
11	Código da região do cliente (codRegiaoCliente)	Inteiro	Não	—	Restringe à região cadastrada no cliente. Vazio: não restringe por região.
12	UF do cliente (ufCliente)	Texto (2)	Não	—	Restringe à UF cadastrada no cliente, por exemplo, RS. Vazio: não restringe por UF.
13	Observação resumida (observacaoResumida)	Texto (255)	Não	—	Resumo exibido no produto; pode conter HTML, respeitando o limite total de 255 caracteres. Ao clicar, o vendedor acessa as observações completas.

O marcador “—” indica que a versão de introdução do campo no layout não foi identificada. Consulte a compatibilidade das aplicações abaixo.

Aplicação das políticas

Todos os filtros preenchidos devem corresponder ao cenário do pedido. Um filtro vazio não restringe a aplicação da política; para representar essa condição no arquivo, mantenha a posição vazia entre os separadores. Não utilize zero como substituto de um filtro vazio.

Para cada produto, a seleção segue esta ordem:

1. Seleciona as políticas cujos filtros correspondem ao cenário.
2. Mantém as políticas mais específicas: aquelas com a maior quantidade de filtros preenchidos entre cliente, região do cliente, UF do cliente, lista de preço, filial, vendedor e tipo de pedido. Cada filtro conta igualmente.
3. Entre essas políticas, mantém as que possuem o menor valor de prioridade.
4. Se houver empate nos dois critérios, mantém todas as políticas empatadas, ordenadas pelo identificador interno mais recente primeiro.

Por exemplo, uma política com cliente e filial preenchidos prevalece sobre outra com apenas cliente, mesmo que a segunda tenha um número de prioridade menor. A prioridade desempata políticas com a mesma quantidade de filtros preenchidos.

No App Demander, as observações completas das políticas selecionadas são reunidas, separadas por quebras de linha. A prévia utiliza o primeiro resumo não vazio na ordem de seleção. Se nenhum resumo estiver preenchido, utiliza o conteúdo completo.

O banco define prioridade padrão 1 na criação do registro. Esse padrão não garante que um campo vazio enviado pelo importador seja convertido em 1. Informe a prioridade explicitamente para obter uma seleção previsível.

Compatibilidade

A API de produtos da tela de pedido aplica a seleção com os novos filtros para Android a partir do código de versão 50290000 e iOS a partir de 4030. Para a plataforma Web, aplica essa seleção quando a requisição informa uma versão numérica válida.

Nas versões anteriores atendidas por essa API, a consulta considera apenas produto e cliente e retorna uma observação por produto, sem aplicar os novos filtros, a prioridade ou o resumo. Atualize as aplicações antes de utilizar políticas gerais ou cenários com os novos filtros.

Exemplos de registro

Política específica para um cliente, com os demais filtros vazios:

240|OBS001|54|1234|<p>Conferir embalagem antes do envio.</p>|||||1|||Conferir embalagem

Política para qualquer cliente, restrita à lista LP01, filial F01, vendedor 25, tipo de pedido 2, região 10 e UF RS:

240|OBS002|54||<p>Condição comercial especial para esta região.</p>|LP01|F01|25|2|1|10|RS|Condição comercial especial

Cada exemplo contém 13 posições, incluindo o identificador 240. Preserve a ordem e os campos vazios; o identificador interno da política, a empresa e as datas são gerenciados pelo Demander e não fazem parte deste layout.