Quay lại catalog nguồn dữ liệu
Sàn TMĐTPhù hợp với Retailer

Shopify

Nền tảng D2C website thương mại điện tử, phổ biến với brand riêng có sản phẩm ngoại nhập.

Trang chính của vendor Tài liệu API chính thức

Loại API

GraphQL API

Xác thực

OAuth 2.0

Tần suất refresh khả thi

Real-time, Mỗi giờ, Hằng ngày

Setup · Maintain hằng tháng

6-10 giờ · 0,5-1 giờ

Hướng dẫn kết nối, 6 bước

Làm theo thứ tự từ trên xuống. Mỗi bước có ngữ cảnh để đội kỹ thuật của bạn hiểu lý do, không phải checklist bấm.

  1. 1

    Đăng ký Shopify Partner Account

    partners.shopify.com, đăng ký Partner, hoàn toàn miễn phí.

  2. 2

    Tạo Custom App hoặc Public App

    Custom App cho 1 shop cụ thể (đơn giản hơn). Public App nếu phục vụ nhiều shop khác nhau.

  3. 3

    Chọn API Scopes

    read_orders, read_products, read_inventory, read_customers, read_reports, read_analytics, chỉ chọn read scopes nếu chỉ làm reporting.

  4. 4

    Install App vào shop

    Admin shop click Install → grant access, nhận Admin API access token.

  5. 5

    Implement webhooks cho real-time

    Đăng ký webhooks: orders/create, orders/updated, products/update, Shopify POST vào endpoint của bạn khi có sự kiện.

  6. 6

    Kết nối Admin GraphQL API

    Endpoint: https://{shop}.myshopify.com/admin/api/2024-10/graphql.json. Header: X-Shopify-Access-Token. Query orders, products, customers, inventory.

Credentials cần có

Lưu vào vault hoặc secret manager. Không hardcode trong code, không commit lên git.

  • Shop Domain
  • Admin API Access Token
  • API Version

Trường dữ liệu mẫu

Các field thường có trong API response. Map vào schema warehouse khi ingest.

  • id
  • name
  • createdAt
  • totalPriceSet
  • lineItems[].sku
  • customer.email
  • discountApplications
  • fulfillments
  • inventoryItem.tracked

Lỗi và pitfalls thường gặp tại Việt Nam

Đọc kỹ trước khi cam kết timeline, vài rủi ro dưới đây có thể kéo dài tích hợp thêm 1-2 tuần nếu không lên kế hoạch.

  • GraphQL cost-based rate limit: mỗi query có 'cost', shop có ngân sách 1.000 points/phút, query phức tạp tốn nhiều.
  • Webhook có thể delay 1-30 giây trong giờ cao điểm, không tin tuyệt đối là real-time.
  • Multi-currency shop trả về 2 giá: presentment (giá hiển thị) và shop (giá quy đổi shop currency), đừng dùng nhầm.
  • Inventory levels theo location_id, shop có nhiều warehouse cần group rõ.
  • API version đổi 4 lần/năm, hỗ trợ trong 1 năm, cần plan upgrade theo quý.
Bước tiếp theo

Kết nối Shopify vào data warehouse của doanh nghiệp bạn

Đặt lịch rà soát 30 phút. Chia sẻ tài khoản hiện tại, chúng tôi đề xuất phạm vi kết nối ưu tiên và timeline ngày bàn giao.

Đặt lịch rà soát 30 phútXem toàn bộ nguồn dữ liệu