# Ferramenta de Substituir na tabela — Central de Ajuda da Albato Source: https://albato.com/br/wiki/articles/ferramenta-de-substituicao-de-tabelas Bem-vindo ao Central de Ajuda da Albato Buscar artigos # Ferramenta de Substituir na tabela Última atualização: 23/5/2026 · 3 min de leitura * * * NESTE ARTIGO ### Instruções para trabalhar com a ferramenta “Substituir na tabela” na transferência A ferramenta "Substituir na Tabela" permite que você substitua os dados de entrada do sistema de transmissão. Imagine que você recebeu um pedido de uma loja com o status “Pago”. Você está satisfeito e deseja alterar o status desta transação no sistema CRM para “Pago”. Porém, ao tentar transferir o campo “status” de um sistema com loja online (onde, por exemplo, tem o nome do sistema “pago”) para o campo “status” do sistema CRM, ocorre um erro. Isso ocorre porque o CRM espera um código de “status” (por exemplo, “1231551”) no campo “status”, mas recebe o texto “pago”. Para contornar este erro, é necessário transformar “pago” em código, ou seja, realizar uma “substituição de tabela” utilizando a ferramenta Albato. Nas instruções, analisaremos como configurar esta ferramenta. Por exemplo, considere o caso da integração de Aliexpress e Bitrix24. Vamos criar um link que irá reagir às mudanças nos status do pedido no Aliexpress e alterar automaticamente os status no Bitrix24. A tarefa que estamos resolvendo é rastrear rapidamente os cancelamentos de pedidos pelos clientes. **Status do pedido do Aliexpress:**  - PLACE\_ORDER\_SUCCESS – Aguardando pagamento do cliente - PAYMENT\_PROCESSING – O pagamento do pedido está sendo processado - RISK\_CONTROL – Pagamento bem-sucedido, pedido sob controle de risco - WAIT\_SELLER\_SEND\_GOODS – Esperando que o vendedor envie as mercadorias - SELLER\_PART\_SEND\_GOODS – O vendedor enviou parcialmente as mercadorias - WAIT\_BUYER\_ACCEPT\_GOODS – O vendedor enviou todas as mercadorias, aguardando a confirmação do pedido pelo comprador - IN\_CANCEL – Esperando chegar a um acordo entre o vendedor e o comprador - FINISH – Fechamento completo do pedido - ARQUIVO – O pedido foi enviado para o arquivo **E aqui estão as etapas do funil “Bitrix24” do sistema CRM de teste:** - Novo novo - PREPARAÇÃO – Preparação de documentos - PREPAYMENT\_INVOICE – Fatura pré-paga - 1 – Entrega em Ya. Taxi - 2 – Enviar número da faixa - EXECUTANDO – Em andamento - FINAL\_INVOICE – pontuação final - GANHOU – Negócio bem sucedido - PERDER – Negociação falhou - APOLOGIA – Análise do motivo da falha Como você pode ver, eles não são os mesmos. Você pode resolver facilmente esse problema por meio da substituição de tabela. **Etapa 1. Criação de pacote** Abra a seção Minhas Integrações e adicione uma ferramenta entre as duas etapas. Clique em “+”, selecione “Ferramentas”, na janela que se abre, localize o item “Substituição tabular”: **Etapa 2. Configurando o instrumento** Selecione uma ferramenta e clique em Avançar. Uma janela de configuração com 4 campos será aberta: Em ordem sobre cada um dos campos:  1. **Título**. Forneça um nome para sua nova variável. Mais adiante nas configurações do pacote, você usará esse nome.  2. **Valor**. Selecione o valor que o sistema verificará para conformidade com a condição que você configurará posteriormente. No exemplo, este é o valor “Status do pedido” do Aliexpress. 3. **Adicione condição**. Ao clicar neste botão, você adicionará condições para o seu instrumento. Contaremos mais sobre o que é e como funciona a seguir.  4. **Caso contrário**. Aqui, especifique o valor que será passado se o sistema Albato não puder encontrar um valor que corresponda à condição acima. Se você está familiarizado com programação, então você sabe – esta ferramenta funciona de acordo com o princípio da expressão IF… .ELSE. Para personalizar a ferramenta, selecione valores para os campos e adicione uma condição: Aqui está o que fizemos: 1. **Título**. Chamamos nossa nova variável de “Status do pedido transformado”.  2. **Valor**. Escolhemos a variável “Status do pedido” do Aliexpress como o valor.  3. **Condição 1**. Estabelecemos uma condição de acordo com a qual a seguinte lógica é obtida “ _Se os dados da variável“ Valor ”forem iguais ao texto embutido em código“ IN\_CANCEL ”, então alteramos este valor para o texto embutido em código“ PERDER ”_ . IN\_CANCEL é o status do sistema que Aliexpress dá em caso de cancelamento do pedido. PERDER é o valor do sistema do status de uma transação perdida no funil em nosso CRM Bitrix24. 4. **Caso contrário**. Configuramos o campo para que, se nenhuma das condições for atendida, os dados da variável “Status do pedido” no Aliexpress serão substituídos automaticamente pelo valor “EXECUTANDO” – este é o valor do sistema do funil “Em andamento” status no Bitrix24. 5. **Condição 2**. Configure mais uma condição. O processo é semelhante ao estabelecimento da primeira condição. O número de condições personalizáveis ​​não é limitado. **Mensagem:** Você pode encontrar os valores do sistema dos status de funis ou pedidos nos livros de referência na seção “Credenciais”. Para fazer isso, vá para a seção “Credenciais”, encontre o serviço com o qual você criou uma conexão e procure o valor nos diretórios. Abaixo está uma tela com uma página onde você pode encontrar valores para o Bitrix 24. A ferramenta está configurada! Tudo o que resta é usar o valor na próxima etapa. **Etapa 3. Conectando o instrumento** . Vamos usar a função de processamento duplicado ao criar um novo negócio para encontrar um existente. Este exemplo assume que durante a criação inicial de ofertas, o ID do pedido do AliExpress foi transferido para o “Nome” da oferta criada. Para que a etapa “Bitrix24: New Deal” funcione, que na verdade atualiza o status de uma transação existente, também é necessário transferir o ID do pedido do AliExpress para o campo “Nome”. Em seguida, vá para as configurações de processamento duplicado na etapa Bitrix24: New Deal: Especifique a regra de processamento “Atualizar apenas o registro existente se uma duplicata for encontrada” e selecione “Nome do negócio” como o campo para verificação de conformidade: Todos os campos conterão “Valor atual”, o que significa – o campo salvará os dados já existentes. Para atualizar os dados, você precisará especificar um novo valor. Posicione o cursor no campo “Estágio”, exclua “Valor atual” como texto normal e coloque a variável da ferramenta “Substituir na tabela – Albato”. Para fazer isso, na lista que aparece, localize a seção “Outros valores”, e nela – a etapa “Substituir na tabela– Albato”. Selecionamos uma variável com o nome criado anteriormente, no nosso caso é “Status do pedido transformado”: Clique em “Salvar”. Pronto! Agora você aprendeu como personalizar a ferramenta de Substituir na tabela na Albato. ### Casos sobre o uso da ferramenta “Substituir na tabela” Aqui estão alguns casos que você pode resolver usando esta ferramenta. **Caso No. 1** **Tarefa**: Por exemplo, você demonstrou receber notificações no Telegram quando o status de uma transação foi alterado no amoCRM. No entanto, se considerarmos a solução do ponto de vista dos detalhes, não basta mostrar o nome da situação para a qual a transação se moveu, em vez de uma representação numérica. "Como posso fazer isso usando a substituição de tabelas?“ **Solução** Desde a última vez, nossa conexão permaneceu ativa, portanto, poderemos demonstrar uma versão atualizada da mensagem com a exibição correta dos nomes das etapas. Você precisa preencher os campos como este: 1. **Título**. Indique o nome do nosso substituto – o que estamos mudando e por quê. 2. **Valor**. Selecione um campo cujos valores serão alterados de acordo com as condições. Em nosso caso, este é o campo “Status” (nota: amoCRM transfere um valor inteiro para o campo de status). 3. **Condição**. Indique o valor inicial do status e o valor final. Para entender melhor a mecânica da substituição de tabela, basta reformular a construção e trazê-la para a seguinte forma: “Se o valor no campo X for igual ao valor Y, então passe o valor Z mais adiante no link. No nosso caso: “Se o valor do campo“ Status ”for igual ao valor“ 142 ”, então mais adiante no link passe o valor“ Implementado com sucesso ”. E assim, para cada status. 1. **Caso contrário**. Anote o valor que será transmitido pela cadeia se nenhuma das condições de substituição funcionou. Resta salvar e testar o formato da mensagem recebida no Telegram. **Caso No. 2** **Tarefa** : “Temos uma conexão entre JivoSite e amoCRM. É necessário criar tarefas para os mesmos gerentes no amoCRM, que são operadores no JivoSite. “ **Solução** Claro, essa é a tarefa que a substituição de tabelas fará com esplendor! Para isso, crie um novo link “Albato – Substituir na tabela” no link existente e vá para o modo “Configurações”. Coisas a ter em mente ao fazer as configurações: 1. O responsável no amoCRM é transmitido como um identificador único. 2. A substituição do JivoSite pode ser realizada tanto pela ID do operador quanto pelo nome. Agora você precisa coletar a seguinte lógica: “Se o parâmetro” Nome do operador “for igual ao valor” Andrey “, então transfira o valor” 872567332 “para o próximo link, caso contrário, transfira o valor” 98638475 “. Após salvar o bloco com substituição de tabela, configure a substituição correta deste valor na próxima etapa. Agora, o mesmo operador que se comunicou com o usuário no JivoSite receberá uma tarefa definida automaticamente no amoCRM. Isso respondeu à sua pergunta?