Shopify

Товары, заказы, клиенты и остатки в магазине Shopify

Shopify — платформа интернет-магазина: товары, заказы, клиенты, склады и коллекции.

С Shopify в Pailot вы можете:

Создавать, читать, обновлять и удалять товары
Смотреть и менять заказы, отменять заказ, оформлять отгрузку
Вести клиентов
Смотреть остатки, склады и корректировать количество
Работать с коллекциями

Нужен домен магазина (mystore.myshopify.com) и доступ к API (Application Programming Interface — программный интерфейс) Shopify. ID сущностей — в формате GID (gid://shopify/Product/...). Блок ставят на холст как отдельный шаг или прикрепляют к агенту.

Инструменты

`shopify_create_product`

Создать товар в магазине Shopify.

Вход

Параметр	Тип	Обязательный	Описание
`shopDomain`	string	Да	Домен магазина (например mystore.myshopify.com)
`title`	string	Да	Название товара
`descriptionHtml`	string	Нет	Описание (HTML)
`vendor`	string	Нет	Производитель / бренд
`productType`	string	Нет	Тип / категория
`tags`	array	Нет	Теги
`status`	string	Нет	Статус: ACTIVE, DRAFT, ARCHIVED

Выход

Параметр	Тип	Описание
`product`	object	Созданный товар

`shopify_get_product`

Получить товар по ID.

Вход

Параметр	Тип	Обязательный	Описание
`shopDomain`	string	Да	Домен магазина (например mystore.myshopify.com)
`productId`	string	Да	ID товара (gid://shopify/Product/123456789)

Выход

Параметр	Тип	Описание
`product`	object	Данные товара

`shopify_list_products`

Список товаров с фильтром.

Вход

Параметр	Тип	Обязательный	Описание
`shopDomain`	string	Да	Домен магазина (например mystore.myshopify.com)
`first`	number	Нет	Сколько товаров вернуть (по умолчанию 50, макс. 250)
`query`	string	Нет	Поиск (например "title:shirt", "vendor:Nike", "status:active")

Выход

Параметр	Тип	Описание
`products`	array	Список товаров
`pageInfo`	object	Данные постраничного вывода

`shopify_update_product`

Обновить товар.

Вход

Параметр	Тип	Обязательный	Описание
`shopDomain`	string	Да	Домен магазина (например mystore.myshopify.com)
`productId`	string	Да	ID товара (gid://shopify/Product/123456789)
`title`	string	Нет	Новое название
`descriptionHtml`	string	Нет	Новое описание (HTML)
`vendor`	string	Нет	Новый производитель / бренд
`productType`	string	Нет	Новый тип / категория
`tags`	array	Нет	Новые теги
`status`	string	Нет	Новый статус: ACTIVE, DRAFT, ARCHIVED

Выход

Параметр	Тип	Описание
`product`	object	Обновлённый товар

`shopify_delete_product`

Удалить товар.

Вход

Параметр	Тип	Обязательный	Описание
`shopDomain`	string	Да	Домен магазина (например mystore.myshopify.com)
`productId`	string	Да	ID товара (gid://shopify/Product/123456789)

Выход

Параметр	Тип	Описание
`deletedId`	string	ID удалённого товара

`shopify_get_order`

Получить заказ по ID.

Вход

Параметр	Тип	Обязательный	Описание
`shopDomain`	string	Да	Домен магазина (например mystore.myshopify.com)
`orderId`	string	Да	ID заказа (gid://shopify/Order/123456789)

Выход

Параметр	Тип	Описание
`order`	object	Данные заказа

`shopify_list_orders`

Список заказов с фильтром.

Вход

Параметр	Тип	Обязательный	Описание
`shopDomain`	string	Да	Домен магазина (например mystore.myshopify.com)
`first`	number	Нет	Сколько заказов вернуть (по умолчанию 50, макс. 250)
`status`	string	Нет	Статус: open, closed, cancelled, any
`query`	string	Нет	Поиск (например "financial_status:paid", "fulfillment_status:unfulfilled", "email:customer@example.com")

Выход

Параметр	Тип	Описание
`orders`	array	Список заказов
`pageInfo`	object	Данные постраничного вывода

`shopify_update_order`

Обновить заказ (заметка, теги, email).

Вход

Параметр	Тип	Обязательный	Описание
`shopDomain`	string	Да	Домен магазина (например mystore.myshopify.com)
`orderId`	string	Да	ID заказа (gid://shopify/Order/123456789)
`note`	string	Нет	Новая заметка
`tags`	array	Нет	Новые теги
`email`	string	Нет	Новый email клиента в заказе

Выход

Параметр	Тип	Описание
`order`	object	Обновлённый заказ

`shopify_cancel_order`

Отменить заказ.

Вход

Параметр	Тип	Обязательный	Описание
`shopDomain`	string	Да	Домен магазина (например mystore.myshopify.com)
`orderId`	string	Да	ID заказа (gid://shopify/Order/123456789)
`reason`	string	Да	Причина: CUSTOMER, DECLINED, FRAUD, INVENTORY, STAFF, OTHER
`notifyCustomer`	boolean	Нет	Уведомить клиента
`refund`	boolean	Нет	Вернуть оплату
`restock`	boolean	Нет	Вернуть товар на склад
`staffNote`	string	Нет	Внутренняя заметка для сотрудников

Выход

Параметр	Тип	Описание
`order`	object	Результат отмены

`shopify_create_customer`

Создать клиента.

Вход

Параметр	Тип	Обязательный	Описание
`shopDomain`	string	Да	Домен магазина (например mystore.myshopify.com)
`email`	string	Нет	Адрес почты
`firstName`	string	Нет	Имя
`lastName`	string	Нет	Фамилия
`phone`	string	Нет	Телефон
`note`	string	Нет	Заметка о клиенте
`tags`	array	Нет	Теги
`addresses`	array	Нет	Адреса

Выход

Параметр	Тип	Описание
`customer`	object	Созданный клиент

`shopify_get_customer`

Получить клиента по ID.

Вход

Параметр	Тип	Обязательный	Описание
`shopDomain`	string	Да	Домен магазина (например mystore.myshopify.com)
`customerId`	string	Да	ID клиента (gid://shopify/Customer/123456789)

Выход

Параметр	Тип	Описание
`customer`	object	Данные клиента

`shopify_list_customers`

Список клиентов с фильтром.

Вход

Параметр	Тип	Обязательный	Описание
`shopDomain`	string	Да	Домен магазина (например mystore.myshopify.com)
`first`	number	Нет	Сколько клиентов вернуть (по умолчанию 50, макс. 250)
`query`	string	Нет	Поиск (например "first_name:John", "last_name:Smith", "email:*@gmail.com", "tag:vip")

Выход

Параметр	Тип	Описание
`customers`	array	Список клиентов
`pageInfo`	object	Данные постраничного вывода

`shopify_update_customer`

Обновить клиента.

Вход

Параметр	Тип	Обязательный	Описание
`shopDomain`	string	Да	Домен магазина (например mystore.myshopify.com)
`customerId`	string	Да	ID клиента (gid://shopify/Customer/123456789)
`email`	string	Нет	Новый email
`firstName`	string	Нет	Новое имя
`lastName`	string	Нет	Новая фамилия
`phone`	string	Нет	Новый телефон
`note`	string	Нет	Новая заметка
`tags`	array	Нет	Новые теги

Выход

Параметр	Тип	Описание
`customer`	object	Обновлённый клиент

`shopify_delete_customer`

Удалить клиента.

Вход

Параметр	Тип	Обязательный	Описание
`shopDomain`	string	Да	Домен магазина (например mystore.myshopify.com)
`customerId`	string	Да	ID клиента (gid://shopify/Customer/123456789)

Выход

Параметр	Тип	Описание
`deletedId`	string	ID удалённого клиента

`shopify_list_inventory_items`

Список складских позиций. По SKU удобно найти ID позиции.

Вход

Параметр	Тип	Обязательный	Описание
`shopDomain`	string	Да	Домен магазина (например mystore.myshopify.com)
`first`	number	Нет	Сколько позиций вернуть (по умолчанию 50, макс. 250)
`query`	string	Нет	Поиск (например "sku:ABC123")

Выход

Параметр	Тип	Описание
`inventoryItems`	array	Позиции: ID, SKU и остатки
`pageInfo`	object	Данные постраничного вывода

`shopify_get_inventory_level`

Остаток варианта товара на складе.

Вход

Параметр	Тип	Обязательный	Описание
`shopDomain`	string	Да	Домен магазина (например mystore.myshopify.com)
`inventoryItemId`	string	Да	ID складской позиции (gid://shopify/InventoryItem/123456789)
`locationId`	string	Нет	ID склада для фильтра

Выход

Параметр	Тип	Описание
`inventoryLevel`	object	Данные остатка

`shopify_adjust_inventory`

Изменить остаток варианта товара на складе.

Вход

Параметр	Тип	Обязательный	Описание
`shopDomain`	string	Да	Домен магазина (например mystore.myshopify.com)
`inventoryItemId`	string	Да	ID складской позиции (gid://shopify/InventoryItem/123456789)
`locationId`	string	Да	ID склада (gid://shopify/Location/123456789)
`delta`	number	Да	На сколько изменить (плюс — увеличить, минус — уменьшить)

Выход

Параметр	Тип	Описание
`inventoryLevel`	object	Результат корректировки

`shopify_list_locations`

Список складов. ID склада нужен для операций с остатками.

Вход

Параметр	Тип	Обязательный	Описание
`shopDomain`	string	Да	Домен магазина (например mystore.myshopify.com)
`first`	number	Нет	Сколько складов вернуть (по умолчанию 50, макс. 250)
`includeInactive`	boolean	Нет	Включить отключённые склады (по умолчанию false)

Выход

Параметр	Тип	Описание
`locations`	array	Склады: ID, названия и адреса
`pageInfo`	object	Данные постраничного вывода

`shopify_create_fulfillment`

Оформить отгрузку (позиции заказа отправлены). Нужен ID fulfillment order из деталей заказа.

Вход

Параметр	Тип	Обязательный	Описание
`shopDomain`	string	Да	Домен магазина (например mystore.myshopify.com)
`fulfillmentOrderId`	string	Да	ID заказа на отгрузку (например gid://shopify/FulfillmentOrder/123456789)
`trackingNumber`	string	Нет	Трек-номер
`trackingCompany`	string	Нет	Служба доставки (например UPS, FedEx, USPS, DHL)
`trackingUrl`	string	Нет	URL отслеживания
`notifyCustomer`	boolean	Нет	Отправить клиенту письмо об отправке (по умолчанию true)

Выход

Параметр	Тип	Описание
`fulfillment`	object	Созданная отгрузка: трек и отгруженные позиции

`shopify_list_collections`

Список коллекций. Фильтр по названию, типу (custom/smart) или handle.

Вход

Параметр	Тип	Обязательный	Описание
`shopDomain`	string	Да	Домен магазина (например mystore.myshopify.com)
`first`	number	Нет	Сколько коллекций вернуть (по умолчанию 50, макс. 250)
`query`	string	Нет	Поиск (например "title:Summer" или "collection_type:smart")

Выход

Параметр	Тип	Описание
`collections`	array	Коллекции: ID, названия и число товаров
`pageInfo`	object	Данные постраничного вывода

`shopify_get_collection`

Получить коллекцию по ID, включая товары.

Вход

Параметр	Тип	Обязательный	Описание
`shopDomain`	string	Да	Домен магазина (например mystore.myshopify.com)
`collectionId`	string	Да	ID коллекции (например gid://shopify/Collection/123456789)
`productsFirst`	number	Нет	Сколько товаров из коллекции вернуть (по умолчанию 50, макс. 250)

Выход

Параметр	Тип	Описание
`collection`	object	Коллекция и её товары

SharePoint Slack

На этой странице

На этой странице

Инструменты

shopify_create_product

shopify_get_product

shopify_list_products

shopify_update_product

shopify_delete_product

shopify_get_order

shopify_list_orders

shopify_update_order

shopify_cancel_order

shopify_create_customer

shopify_get_customer

shopify_list_customers

shopify_update_customer

shopify_delete_customer

shopify_list_inventory_items

shopify_get_inventory_level

shopify_adjust_inventory

shopify_list_locations

shopify_create_fulfillment

shopify_list_collections

shopify_get_collection

Получить доступ

Копилот собирает процесс. Менеджер запускает сам. Можно поставить в контур компании.

Получить доступ