Pular para o conteúdo

Consultas

Uma etapa que pergunta antes de decidir. Traz um número da sua conta e o deixa disponível para as etapas seguintes.

Para que serve

Um workflow só sabe o que o evento trazia. “O orçamento COT-7 de 150.000 foi aprovado” não diz quanto esse cliente deve a você nem como estão seus recebíveis, então um aviso não podia incluir isso e uma condição não podia decidir com base nisso.

Uma consulta fecha essa lacuna: você a coloca antes, o Cord a executa e os resultados dela ficam como variáveis para o resto do workflow.

Uma consulta só lê. Ela nunca altera nada na sua conta, então você pode usá-la quantas vezes quiser sem risco.

Como adicionar

  1. Clique em Adicionar uma etapa › Ação ou consulta.
  2. No buscador, filtre por Consulta ou digite o que procura (“vencidos”, “pipeline”, “saldo”).
  3. Escolha a consulta. Se ela tiver um parâmetro de dias, ajuste-o.
  4. No painel, você verá Deixa disponíveis: essas são as variáveis que você pode usar depois.

As consultas

Consulta O que traz Variáveis
Recebíveis vencidos Quanto devem a você com o prazo já vencido. {{vencido_total}}, {{vencido_cantidad}}, {{vencido_dias_max}}
Pipeline aberto Quanto há em orçamentos enviados ou visualizados ainda sem decisão. {{pipeline_total}}, {{pipeline_cantidad}}
Valor recebido Quanto você recebeu nos últimos dias que escolher (1 a 90): pagamentos de orçamentos e de faturas, descontado o que foi reembolsado. {{cobrado_cantidad}} conta os pagamentos recebidos. {{cobrado_total}}, {{cobrado_cantidad}}
O que está a vencer Quanto vence nos próximos dias que você escolher (1 a 90). {{por_vencer_total}}, {{por_vencer_cantidad}}
Saldo do cliente Quanto o cliente do evento deve e quanto disso já venceu. {{cliente_saldo}}, {{cliente_vencido}}, {{cliente_documentos}}

Os valores saem na moeda do seu negócio: o que você vendeu em outra moeda é convertido como em Relatórios, com a taxa de câmbio congelada no documento ou a publicada no dia, e o valor recebido é o mesmo número que você vê lá. Se uma moeda não tiver nenhuma taxa disponível, o valor dela fica fora do total; nunca se inventa uma taxa.

A ordem importa

Uma variável de consulta existe a partir da etapa que a traz. Se você usá-la antes, o workflow não é publicado e o editor avisa: “A variável {{vencido_total}} vem de uma consulta que está depois desta etapa.”

O mesmo vale dentro de um ramo: o que o ramo Se for atendida consulta não existe no ramo Se não for atendida. Se os dois precisarem, coloque a consulta antes da condição.

Saldo do cliente: precisa de um cliente

Saldo do cliente usa o cliente do evento, então só funciona com gatilhos que trazem um: orçamentos, faturas, pagamentos e clientes. Em um gatilho agendado ou de repasse, não há cliente sobre quem perguntar, e o workflow não pode ser publicado com essa consulta.

Um exemplo completo

“Sua segunda: o recebido, o vencido e para quem ligar”, uma das ideias que o Cord traz:

  1. Quando isto acontecer: toda segunda-feira às 9h.
  2. Consulta: o valor recebido nos últimos 7 dias.
  3. Consulta: os recebíveis vencidos.
  4. Consulta: o pipeline aberto.
  5. Ação: avisar o proprietário da conta, com o assunto “Sua semana no Cord ({{fecha}})” e a mensagem “Recebido nos últimos 7 dias: {{cobrado_total}} em {{cobrado_cantidad}} pagamentos. Vencido: {{vencido_total}} em {{vencido_cantidad}} documentos, o mais atrasado com {{vencido_dias_max}} dias. A fechar: {{pipeline_total}} em {{pipeline_cantidad}} orçamentos.” Com o Slack ou o Teams conectados, o aviso sai por lá.

Você pode ampliá-lo: adicione a consulta do que está a vencer ou mude o destinatário para toda a equipe.

Limites

Cada consulta é uma etapa, então conta para o máximo de 30 etapas por workflow. Elas não têm limite por hora próprio: só leem.

Próximos passos