Cross Segmentos - TOTVS CRM Automação de Força de Vendas (SFA) - WEB - Configuração - Criar regras de Integração com API Nativa Protheus

Tempo aproximado para leitura: 00:02:00 min

Dúvida
Como criar regras de importação com API Nativa Protheus, diretamente nas variáveis de integração ?

Ambiente
Cross Segmentos - TOTVS CRM Automação de Força de Vendas (SFA) - WEB - Configuração - Integração - A partir da versão 12

Solução
Na integração entra o SFA e o Protheus é possível realizar configurações via variável de integração, permitindo customizações dinâmicas utilizando Java Script, no entanto, há algumas limitações que devem ser consideradas.

Para configurar essa funcionalidade, siga os passos abaixo:

• Acesse o ambiente WEB do SFA.
• Navegue até o menu: Configuração / Integração / Variáveis de integração:

Funcionalidades Disponíveis:

• Substituição de Campos: Permite substituir um campo padrão por outro, seja ele um campo padrão do Protheus ou um campo personalizado.
• Cálculos Simples: Realize operações básicas como soma, subtração, multiplicação e divisão. Para multiplicação e divisão, é essencial adicionar uma condição que evite operações com valores nulos ou zero, prevenindo erros.
• Uso de If Ternário: Utilize o operador ternário padrão do JavaScript para criar condições simples. Exemplo: (CONDICAO ? VALOR_SE_VERDADEIRO : VALOR_SE_FALSO)
• Filtro customizado: Permite definir critérios específicos para a importação de dados, garantindo que apenas as informações relevantes sejam processadas. Pode ser utilizado para excluir determinados tipos de notas, cliente ou qualquer outro campo disponível na integração.
  
  

Atenção!

Para realizar cálculos ou utilizar o operador ternário, é necessário prefixar o valor do campo com @. Todos os nomes de campos devem ser informados em letras minúsculas e delimitados por chaves {}; Os campos que estiverem configurados com o @ na frente não serão reescritos pela integração. Dessa forma é possível a manutenção com atualizações do padrão, mas mantendo os parâmetros já configurados.

Exemplos de Uso:

• Filtro customizado:

  "filter_custom":"f1_tipo eq 'N'"

• Substituição simples:

  "precomaximo": "{da1_xprc}"

• Substituição de valores:

  "precomaximo": "@({da1_prcmax} == 0 ? 999999 : {da1_prcmax})"

• Cálculo:

  "quantidade": "@{b2_qatu} - ({b2_qemp} + {b2_reserva} + {b2_qpedven})"

• Condição para valores binários:

  "idnativo": "@('{da0_ativo}' == '2' ? 0 : 1)"

• Substituição condicional de campo:

  "codigo": "@('{x5_chave}' == '123' ? '{x5_descri}' : '{x5_chave}')"

• Combinação de múltiplas condições:

  "idnativo": "@('{acy_grpven}' == '01' && '{acy_grpven}' == '05' ? 0 : 1)"

• Round (Arredondamento)

  "preco": "@{da1_xprc}.toFixed(2)"

Essas regras possibilitam um alto grau de flexibilidade na integração de dados, permitindo ajustes específicos para diferentes necessidades operacionais diretamente nas variáveis configuradas.

Guia Simplificado de Operadores Básicos no Java Script ES5:

> (Maior que): Compara se o valor da esquerda é maior que o da direita. Similar ao > do SQL.

< (Menor que): Compara se o valor da esquerda é menor que o da direita. Similar ao < do SQL.

>= (Maior ou igual): Verifica se o valor da esquerda é maior ou igual ao da direita. Similar ao >= no SQL.

<= (Menor ou igual): Verifica se o valor da esquerda é menor ou igual ao da direita. Similar ao <= no SQL.

== (Igualdade): Compara se dois valores são iguais. Similar ao = do SQL, mas sem diferenciar tipos.

!= (Diferença): Compara se dois valores são diferentes. Similar ao != no SQL.

+ (Soma): Adiciona dois valores. Equivalente ao + do SQL para operações de adição.

- (Subtração): Subtrai o segundo valor do primeiro. Similar ao - do SQL.

* (Multiplicação): Multiplica dois valores. Funciona como o * no SQL.

/ (Divisão): Divide o primeiro valor pelo segundo. Equivalente ao / no SQL.

% (Módulo): Retorna o resto da divisão entre dois valores. Similar ao operador % no SQL.

&& (E lógico / AND): Retorna verdadeiro se ambas as condições forem verdadeiras. Similar ao AND no SQL.

|| (Ou lógico / OR): Retorna verdadeiro se pelo menos uma das condições for verdadeira. Equivalente ao OR no SQL.

! (Não / NOT): Inverte o valor lógico de uma condição, transformando verdadeiro em falso e vice-versa. Similar ao NOT no SQL.

Atenção!
Tenha certeza que o ajuste realizado está sendo aplicado na variável correta, identificando através das colunas CONTEXTO, DESCRIÇÃO E TABELA.

No SFA, o ajuste realizado será colocado na coluna VALOR, uma vez que seja finalizada a configuração no campo é importante clicar no campo GRAVAR, para salvar as informações adicionadas:

Importante!
Recomendamos testar esta configuração primeiramente em seu ambiente de homologação e após os testes necessários, replicar para o ambiente de produção.