Skip to main content

Shopify

warning

Từ ngày 1/1/2026, Shopify không cho phép tạo mới legacy custom app (loại app dùng API Password). Nếu store của bạn chưa có sẵn custom app, vui lòng làm theo hướng dẫn Tạo app trên Shopify Dev Dashboard (Client ID & Client Secret) bên dưới.

Chi tiết thông báo của Shopify: Legacy custom apps can't be created after January 1, 2026.

Hướng dẫn lấy Shopify API Password​

Chỉ áp dụng cho các store đã có sẵn custom app (legacy). Với app mới, xem phần Client ID & Client Secret.

Khi setup data source ở Elton, tại mục App type chọn Custom app – API Password (legacy).

Vào Shopify Admin và làm theo các bước sau:

  1. Vào Settings

  1. Vào mục Apps and sales channels và bấm vào Develop apps

  1. Chọn Allow custom app development

  1. Chọn tiếp Allow custom app development

  1. Bấm vào Create an app và đặt tên cho app: vd Elton Data Integration

  1. Vào mục Configure Admin API scopes, chọn những loại dữ liệu mà bạn cho phép Elton có thể lấy data (chỉ chọn những ô bắt đầu với read_), sau khi chọn xong thì bấm Save.

  1. Bấm vào Install app

  1. Bấm vào Reveal token once, copy token này và input vào API Password khi setup data source ở trong Elton.

warning

Khi đổi token phải cập nhật token mới ở Elton data source để tránh lỗi connection.

Tạo app trên Shopify Dev Dashboard (Client ID & Client Secret)​

Áp dụng cho app mới tạo sau ngày 1/1/2026. Thay vì một API Password, app loại này dùng cặp Client ID và Client Secret.

Khi setup data source ở Elton, tại mục App type chọn Dev Dashboard app – Client ID & Secret, sau đó điền Client ID và Client Secret lấy được ở các bước dưới đây.

Vào Shopify Dev Dashboard và làm theo các bước sau:

  1. Trong Dev Dashboard, mở tab Apps và bấm Create app để tạo app mới, đặt tên cho app: vd Elton Data Integration.

  2. Vào phần cấu hình Admin API scopes (hoặc API access / Scopes) của app, chọn những loại dữ liệu mà bạn cho phép Elton lấy data (chỉ chọn những scope bắt đầu với read_), sau đó Save.

  3. Cài đặt app vào store của bạn: chọn Install / Select store rồi chọn đúng store cần lấy data.

  4. Mở mục API credentials (hoặc Client credentials) của app, tại đây bạn sẽ thấy:

    • Client ID — copy và điền vào ô Client ID khi setup data source ở Elton.
    • Client Secret — bấm Reveal / Show để hiện, copy và điền vào ô Client Secret khi setup data source ở Elton.

  5. Điền Shop name (lấy từ url khi đăng nhập Shopify Admin, ví dụ https://admin.shopify.com/store/elton-data-test thì shop name là elton-data-test) và lưu lại data source.

warning

Khi đổi (rotate) Client Secret trên Shopify, phải cập nhật Client Secret mới ở Elton data source để tránh lỗi connection.

Query data trên BigQuery​

Elton cung cấp 1 số câu query mẫu để bạn có thể tham khảo khi sử dụng data Shopify ở trên BigQuery.

  • Lấy thông tin inventory:

Để lấy quantity của những trạng thái khác làm tương tự cách lấy on_hand và available ở trong ví dụ.

Toàn bộ tên trạng thái có thể xem thêm ở đây: Shopify Inventory States

SELECT
  inventory_item_id,
  JSON_VALUE(il, "$.id") AS inventory_level_id,
  JSON_VALUE(il, "$.location_id") AS location_id,
  JSON_VALUE(il, "$.updated_at") AS updated_at,
  JSON_QUERY(il, "$.quantities.on_hand") AS on_hand,
  JSON_QUERY(il, "$.quantities.available") AS available,
FROM `elton.shopify_dwh.shopify_inventory_test`
JOIN UNNEST(inventory_levels) AS il

Add-on: Cách tính Billable Pipeline cho source​

  • Khi sử dụng Elton, bạn sẽ được thông báo về cách mà hệ thống sẽ tính phí sử dụng dịch vụ. Cách tính hiện tại chủ yếu dựa trên số pipeline bạn tạo.

  • Tuỳ từng loại source mà cách tính số lượng pipeline giới hạn sẽ khác nhau. Để biết thêm chi tiết, bạn vui lòng tham khảo cách tính ở link ở đây.

Last updated on