Obter dados da sessão de rastreamento de caixa
Em workflows que exigem dados da sessão de rastreamento de caixa, use a ação Obter dados da sessão de rastreamento de caixa para recuperar as informações da sessão de rastreamento de caixa do POS Pro. As sessões de rastreamento de caixa são usadas para rastrear o dinheiro nos caixas da loja.
Configuração
Campos
A ação Obter dados da sessão de rastreamento de caixa contém os seguintes campos.
| Campo | Descrição |
|---|---|
| Classificar dados por | Obrigatório. Os parâmetros pelos quais os dados retornados pela consulta de pesquisa são classificados. |
| Número máximo de resultados | Obrigatório. O número máximo de resultados que podem ser retornados pela consulta de pesquisa que você selecionar. É possível retornar até 100 de cada vez. |
| Consulta | Obrigatório. Escolha uma das consultas comuns ou selecione Avançado para criar uma própria. |
String de consulta
Este é um exemplo de consulta para obter as sessões de rastreamento de caixa que foram encerradas no último dia:
closing_time:<='{{ scheduledAt }}' AND closing_time:>'{{ scheduledAt | date_minus: "1 day" }}'A variável closing_time é um filtro disponível na consulta CashTrackingSessions e pode ser usada várias vezes ou combinada com outras variáveis. A variável do Liquid scheduledAt está disponível em workflows que usam o acionador Horário agendado. A tag date_minus do Liquid é uma tag especial do Flow que permite subtrair tempo de uma data.
Ao consultar dados, é útil saber o seguinte:
Lista de filtros disponíveis para a sessão de rastreamento de caixa
As consultas precisam seguir uma sintaxe específica
Os valores de campo da consulta nem sempre são documentados. Em alguns casos, os valores podem ser encontrados na documentação da API. Como alternativa, você pode encontrar os valores de campo nos URLs no painel do admin quando filtra. Por exemplo, para encontrar alguns valores de consulta de Pedido, filtre a página Pedidos no painel do admin e verifique o URL.
É possível executar ou testar uma consulta em sua loja usando o app Shopify GraphiQL.
Fique atento ao que acontece se a consulta falhar. Muitas vezes, a API retornará todos os resultados (em vez de nenhum).
Dados retornados
Todas as ações Obter dados retornam uma lista de 0 a 100 recursos. Dependendo do seu caso de uso, você pode usar esses dados de várias maneiras:
- Se precisar lidar com cada item da lista individualmente, como para adicionar uma tag a cada um, use a ação Para cada.
- Se precisar agregar dados, como contar quantos resultados foram retornados, use as ações Contagem ou Soma.
- Se precisar exibir a lista, como para enviar um e-mail com todos os itens, use os dados retornados diretamente nas ações subsequentes.
Para acessar os dados retornados nas etapas seguintes a esta ação, use a variável chamada Obter dados da sessão de rastreamento de caixa, que é uma lista de sessões de rastreamento de caixa. É possível usar essa variável tanto em condições quanto em ações. Por exemplo, você pode enviar a lista de sessões de rastreamento de caixa em uma ação Enviar e-mail interno como esta:
{% for single_cash_tracking_session in GetCashTrackingSessionData %}
* {{ single_cash_tracking_session.id }}
{% endfor %}Acionadores
Use esta ação em qualquer workflow, incluindo o acionador Horário agendado. Em um workflow que usa o acionador Horário agendado, o workflow começa no horário que você especificou, e não como resultado de um evento. Como não há nenhum evento específico em sua loja ou de um app que inicie o workflow, nenhum dado é incluído automaticamente.
Referência da API
Para saber mais sobre a API usada nesta ação, consulte a consulta CashTrackingSessions.