Извличане на данни за опит за таксуване на абонамент

В работни процеси, които изискват данни за опити за таксуване на абонаменти, можете да използвате действието „Извличане на данни за опит за таксуване на абонамент“, за да извлечете информация за поръчки от Вашия магазин.

Конфигурация

Полета

Действието „Извличане на данни за опит за таксуване на абонамент“ съдържа следните полета, които се използват за изграждане на заявката:

Низ на заявка

Това е примерна заявка за извличане на опити за таксуване на абонаменти, които са създадени през последните три дни:

created_at:>'{{ createdAt | date_minus: "3 day" }}'

Променливата created_at е филтър, наличен в заявката за опит за таксуване на абонамент, и може да се използва за избиране на конкретно съобщение за грешка при опити за таксуване на абонаменти.

Когато правите заявки за данни, е полезно да знаете:

• Списък с налични филтри за опит за таксуване на абонамент
• Заявките трябва да следват определен синтаксис
• Стойностите на полетата за заявки невинаги са документирани. В някои случаи стойностите могат да бъдат намерени, като прегледате документацията на API. Алтернативно, често можете да намерите стойностите на полетата в URL адресите в администраторския панел, когато филтрирате. Например, за да намерите някои стойности за заявка за поръчка, филтрирайте страницата „Поръчки“ в администраторския панел и след това проверете URL адреса.
• Можете да изпълните или тествате заявка във Вашия магазин, като използвате приложението Shopify GraphiQL app.
• Имайте предвид какво се случва, ако заявката Ви е неуспешна. Често API ще върне всички резултати (вместо нито един).

Върнати данни

Всички действия от тип „Извличане на данни“ връщат списък с от 0 до 100 ресурса. В зависимост от Вашия случай на употреба, може да искате да използвате тези данни по различни начини:

• Ако трябва да обработвате всеки артикул от списъка поотделно, като например да добавите таг към всеки, тогава можете да използвате действието „За всеки“.
• Ако трябва да обобщавате данни, като например да преброите колко резултата са върнати, тогава можете да използвате действията „Преброяване“ или „Сумиране“.
• Ако трябва да изведете списъка, като например да изпратите имейл с всички артикули, тогава можете да използвате върнатите данни директно в последващи действия.

За достъп до върнатите данни в стъпките, които следват това действие, използвайте променливата с име „Извличане на данни за опит за таксуване на абонамент“, която представлява списък с опити за таксуване на абонаменти. Можете да използвате тази променлива както в условия, така и в действия. Например можете да изпратите списъка с опити за таксуване на абонаменти в действие „Изпращане на вътрешен имейл“ по следния начин:

{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
  {{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}

Пример

Например един работен процес е насрочен да се изпълнява всяка неделя в 9:00 ч. Действието „Извличане на данни за опит за таксуване на абонамент“ се използва за събиране на данни за опити за таксуване на абонаменти, създадени през последната седмица. Ако те съдържат съобщение за грешка, тогава опитите за таксуване се изпращат по имейл.

Справка за API

• Ресурс за опит за таксуване на абонамент
• Филтри за заявки за опит за таксуване на абонамент