Với bốn nền tảng dưới đây, bạn không cần tự xuất JSON: chọn nền tảng trong Website → Nhập dữ liệu → Tạo lần nhập, xStore đọc dữ liệu rồi quy đổi về JSON chuẩn. Mọi bước sau (chạy thử, bắt đầu, huỷ, thử lại, chuyển hướng 301, giới hạn, tuỳ chọn) giống hệt cách nhập bằng tệp JSON.
Thông tin xác thực (token, khoá API) được mã hoá, chỉ dùng để đọc dữ liệu trong lần nhập đó và bị xoá khi lần nhập kết thúc. Trình duyệt không lưu chúng.
| Địa chỉ nhập | Xác thực | Nhập được | |
|---|---|---|---|
| Shopify | Địa chỉ website, ví dụ https://shop.example.com |
Tuỳ chọn: access token | Không token: sản phẩm, bộ sưu tập. Có token: thêm bài viết, trang, khuyến mãi, mã giảm giá |
| WooCommerce | Địa chỉ website WordPress | Tuỳ chọn: consumer key + secret | Không khoá: sản phẩm, danh mục, thương hiệu, bài viết, trang. Có khoá: thêm mã giảm giá |
| Haravan | Địa chỉ website (bất kỳ) | Bắt buộc: access token | Sản phẩm, bộ sưu tập, bài viết, trang, khuyến mãi, mã giảm giá |
| Sapo | Địa chỉ *.mysapo.net |
Bắt buộc: API key + API secret | Sản phẩm, bộ sưu tập, bài viết, trang, khuyến mãi, mã giảm giá |
Shopify
- Địa chỉ: địa chỉ công khai của cửa hàng. xStore đọc
/products.jsonvà/collections.jsoncông khai, nên cửa hàng đặt mật khẩu hoặc tắt các endpoint này sẽ không đọc được. - Token (tuỳ chọn): trong Shopify Admin vào Settings → Apps and sales channels → Develop apps,
tạo ứng dụng riêng, cấp quyền đọc cho sản phẩm, nội dung (bài viết, trang) và giảm giá, cài đặt và
sao chép Admin API access token. Token chỉ được gửi qua header
X-Shopify-Access-Token. - Tên miền cửa hàng (tuỳ chọn): nếu website dùng tên miền riêng, nhập thêm địa chỉ
*.myshopify.comđể xStore gọi Admin API đúng nơi. - Nhập: sản phẩm với biến thể, tuỳ chọn, ảnh, nhà cung cấp → thương hiệu, loại sản phẩm → danh mục, bộ sưu tập; với token: bài viết (và danh mục blog), trang, quy tắc giá → khuyến mãi, mã giảm giá.
- Chưa hỗ trợ: metafield và trường SEO riêng (SEO lấy từ tiêu đề/mô tả sản phẩm nếu có); giảm giá tự động không dùng mã; chỉ đọc tối đa 200 bộ sưu tập.
- Tiền tệ: đọc từ
/meta.json; không đọc được thì giả định VND.
WooCommerce
- Địa chỉ: địa chỉ website WordPress. xStore dùng Store API (
/wp-json/wc/store/v1) và REST API của WordPress, không cần khoá cho sản phẩm và nội dung. - Khoá (tuỳ chọn, chỉ HTTPS): trong WordPress vào WooCommerce → Settings → Advanced → REST API → Add key, quyền Read. Nhập cả consumer key và consumer secret (thiếu một trong hai bị từ chối). Dùng để đọc mã giảm giá.
- Nhập: sản phẩm (đơn giản và có biến thể), danh mục, thương hiệu, ảnh, bài viết và danh mục bài viết, trang; với khoá: mã giảm giá và khuyến mãi tương ứng.
- Chưa hỗ trợ: tồn kho WooCommerce: Store API không trả số lượng nên tồn kho để trống (không ghi gì) — nhập riêng bằng
inventory[]; số yêu cầu đọc biến thể có giới hạn — vượt giới hạn thì các sản phẩm còn lại chỉ nhập một biến thể và có cảnh báo; không quy đổi đa tiền tệ.
Haravan
- Địa chỉ: địa chỉ website; dữ liệu luôn đọc qua
https://apis.haravan.com/com. - Access token (bắt buộc): tạo ứng dụng riêng (private app) trong Haravan Admin, cấp quyền đọc sản
phẩm, bộ sưu tập, nội dung và khuyến mãi, rồi sao chép token. Token gửi theo
Authorization: Bearer. - Nhập: sản phẩm (biến thể, tuỳ chọn, ảnh), bộ sưu tập tuỳ chọn và thông minh (kèm danh sách sản phẩm), bài viết, trang, khuyến mãi và mã giảm giá. Tiền tệ mặc định VND.
- Lưu ý: cấu trúc dữ liệu Haravan được viết theo API Admin tương thích Shopify và chưa được đối chiếu với tài liệu trực tuyến mới nhất; nếu một trường không đọc được, lần chạy thử sẽ có cảnh báo.
Sapo
- Địa chỉ: địa chỉ cửa hàng dạng
https://<ten-cua-hang>.mysapo.net. Nếu website công khai dùng tên miền riêng, nhập địa chỉ*.mysapo.netvào ô Tên miền cửa hàng. - API key + secret (bắt buộc): tạo ứng dụng riêng trong Sapo Admin (Cấu hình → Ứng dụng → Quản lý ứng dụng riêng), cấp quyền đọc; gửi theo HTTP Basic.
- Nhập: giống Haravan. Tiền tệ mặc định VND.
- Lưu ý: như Haravan, cấu trúc dữ liệu chưa được đối chiếu với tài liệu trực tuyến mới nhất.
Những điều chưa hỗ trợ (mọi nền tảng)
- Tồn kho Shopify, Haravan, Sapo được nhập theo
inventory_quantitycủa biến thể (vào kho mặc định); WooCommerce thì không có số lượng. - Giảm giá đặc thù nền tảng không có dạng tương ứng bị bỏ qua và có cảnh báo;
buy_x_get_ychỉ nhập dưới dạng khuyến mãi mô tả. - Tiền tệ khác VND được làm tròn thành số nguyên và không quy đổi tỉ giá (có cảnh báo).
- Khuyến mãi, mã giảm giá luôn ở trạng thái chưa kích hoạt; bài viết ở dạng nháp.
- Khách hàng và đơn hàng không được nhập.
Xử lý sự cố
| Cảnh báo / lỗi | Nguyên nhân thường gặp | Cách xử lý |
|---|---|---|
No products found: this does not look like a Shopify storefront |
Cửa hàng có mật khẩu, tắt /products.json, hoặc không phải Shopify |
Mở khoá cửa hàng tạm thời, hoặc xuất JSON chuẩn |
No access token: articles, pages, promotions and coupons were not imported |
Chưa nhập token Shopify | Thêm token (tuỳ chọn) nếu cần các nội dung này |
No API keys: coupons were not imported |
WooCommerce chưa có khoá | Thêm consumer key + secret |
Both consumer_key and consumer_secret are required |
Chỉ nhập một trong hai khoá | Nhập đủ cả hai |
Haravan needs an access_token / Sapo needs an api_key and an api_secret |
Thiếu thông tin bắt buộc | Nhập đủ thông tin xác thực |
Enter the store's mysapo.net address as store_domain |
Website Sapo dùng tên miền riêng | Điền ô Tên miền cửa hàng |
Shop currency not detected; assuming VND |
Shopify không trả /meta.json |
Kiểm tra giá sau khi nhập |
Currency XXX was not converted to VND; prices are imported as given |
Cửa hàng bán bằng tiền tệ khác | Giá không được quy đổi; chỉnh lại sau |
Stock quantities are not available from the Store API; import inventory separately or set it after the import |
WooCommerce Store API không trả số lượng tồn | Nhập tồn kho riêng bằng inventory[] |
Variation request budget reached; remaining products imported as a single variant |
Quá nhiều biến thể cần đọc | Các sản phẩm còn lại chỉ có một biến thể; xuất JSON chuẩn nếu cần đủ biến thể |
Could not read … / … stopped after 200 pages / … stopped at 20000 records |
Một phần dữ liệu lỗi hoặc quá lớn | Xem thông báo, thử lại; phần còn lại vẫn được nhập |
| Lần nhập bị chặn, báo vượt hạn mức | Chạy thử vượt products / storage_mb |
Giảm nội dung nhập, giải phóng hạn mức hoặc nâng cấp gói |