Dados para API na Legale: envie os dados dos seus CSV para outros sistemas com regras e alarmes
Dados para API (Data to API) é a parte das automações CSV da Legale que pega os dados do seu arquivo CSV, e dos seus documentos inteligentes, e os envia por callback para a API de outro sistema. Com regras condicionais você decide qual valor sai em cada campo, e com os alarmes pode programar avisos com datas que vêm do próprio CSV.
Onde se configura
Entre em Automação → CSV, abra a automação e vá para a seção Dados para API. Ali você define quais campos são enviados, as regras que transformam seus valores e a configuração dos alarmes. Se ainda não tem uma automação CSV, comece pelo guia configurar uma automação CSV da central de ajuda (em inglês).
Regras condicionais por campo
Cada campo enviado pode ter uma ou várias condições. Em cada condição você escolhe:
- De onde vem o valor a comparar: de um documento inteligente (você escolhe uma variável) ou do CSV (você escolhe um campo).
- A condição lógica que será avaliada.
- O valor de comparação.
Com o botão + você adiciona quantas condições precisar e as une com conectores: & (e), | (ou) e != (não, diferente). Assim você pode montar regras como “se o país é Chile e o valor é maior que 1.000”.
A condição Preenchido verifica se o campo ou a variável tem informação antes de aplicar a regra. Quando você a escolhe, o campo do valor de comparação fica oculto, porque não é necessário.
Operadores disponíveis
As condições aceitam estes operadores: =, !=, >, <, >=, <=, contém, não contém, vazio e preenchido.
Valor de saída: transforme o dado antes de enviá-lo
O campo opcional Valor de saída (Output Value) define o que é enviado no callback quando a condição é cumprida. Por exemplo, se a coluna do CSV traz o código 320 e a condição é cumprida, você pode enviar “chilena” em vez de 320.
- Se a condição é cumprida e há valor de saída, é enviado o valor de saída.
- Se a condição não é cumprida, é enviado o valor original do CSV.
- Se você deixar o valor de saída vazio, também é enviado o valor original.
- Só muda o campo que tem a regra; os demais campos do CSV são enviados como estão.
Na configuração da regra, o valor a comparar aparece antes da palavra condicional, que é um texto livre e opcional. O valor de saída existe só no Dados para API: ele não aparece nas regras condicionais dos fluxos.
Alarmes com datas manuais ou do CSV
No Dados para API você também configura alarmes com título, descrição, data de início e data de término. As datas podem ser definidas de duas formas:
- Manualmente: você escolhe a data de início e a de término no calendário.
- A partir do CSV: com a opção “Obter data de → CSV” (Get date from → CSV), o calendário é desativado e você escolhe quais colunas do CSV trazem cada data. Assim cada linha pode ter suas próprias datas.
As datas ficam salvas quando você reabre a configuração, e os dados do alarme são guardados em colunas próprias (alarm_title, alarm_description, alarm_start_date e alarm_end_date), separados das variáveis do CSV.
Como o Dados para API mudou
- Novembro de 2025: várias condições por campo, conectores e a condição Preenchido.
- Dezembro de 2025: valor de saída, mais operadores, alarmes com datas do CSV e alarmes guardados em suas próprias colunas. Nesse mês também foi retirado o valor de saída das regras dos fluxos, onde aparecia por erro.
Perguntas frequentes
O que é enviado se a condição não é cumprida?
O valor original da coluna do CSV.
Posso combinar várias condições no mesmo campo?
Sim. Adicione-as com o botão + e una-as com os conectores e, ou e não.
As datas de um alarme podem vir do CSV?
Sim. Escolha “Obter data de → CSV” e selecione a coluna de cada data.
Para integrações com outros sistemas, veja a documentação da API e o guia gerenciar integrações externas (em inglês). Dúvidas? Crie um ticket no Meus Tickets ou fale com nossa equipe de suporte.