Với các đơn hàng được đồng bộ qua integration, thay vì phải update artwork một cách thủ công cho từng đơn, giờ đây bạn có thể import hàng loạt artwork cho nhiều order cùng lúc thông qua CSV và API. Ngoài ra, bạn cũng có thể cập nhật artwork hiện có bằng các artwork mới nhờ tính năng này.

Lưu ý: Việc import artwork qua CSV và API sẽ chỉ thay đổi/thêm artwork cho các đơn hàng cụ thể mà không làm thay đổi artwork cho tất cả các đơn hàng của cùng sản phẩm.

  1. Import Artwork hàng loạt qua CSV

Bước 1: Xuất tệp CSV

  • Đăng nhập vào tài khoản người bán Merchize, đi tới trang “Orders”.

  • Trên trang “Orders”, sử dụng bộ lọc để tìm các đơn cần cập nhật artwork.

  • Nhấp vào “Export Orders” để tải về tệp CSV chứa các đơn hàng đã chọn.

Bước 2: Thêm artwork vào tệp CSV

  • Mở tệp CSV vừa tải xuống.

  • Thêm URL của artwork vào cho từng order item ID trong các cột tương ứng (ví dụ: Artwork Front, Artwork Back, Artwork Sleeve, Artwork Hood).

Nếu muốn áp dụng các bộ artwork khác nhau cho một order item ID, hãy sao chép dòng của order item ID đó, điền link artwork và ghi số lượng item được áp dụng artwork vào cột “Apply for items” (từ 1 đến 50).

Yêu cầu khi import CSV:

  • Mỗi order item ID phải có ít nhất một artwork.

  • Số lượng bộ artwork tối đa cho mỗi order item ID là 10 (một bộ bao gồm Artwork Front, Artwork Back, Artwork Sleeve, và Artwork Hood).

  • Chỉ các đơn chưa được đẩy vào quy trình xử lý đơn mới có thể được cập nhật artwork.

Bước 3: Import tệp CSV

  • Trên trang Orders, click vào nút “More actions” và chọn “Import order artwork”.

  • Trong cửa sổ pop-up, click vào “Import” và chọn tệp CSV.


Bước 4: Theo dõi và xử lý lỗi 

Sau khi import, nhấn vào “View Details” để đi đến trang Artwork Import Log. Kiểm tra lỗi nếu có và nhấp vào biểu tượng mắt để xem lại các artwork được cập nhật và số lượng item áp dụng (“Apply for item”).

  1. Import Artwork hàng loạt qua API

Bước 1: Lấy thông tin chi tiết đơn hàng

Bạn có thể sử dụng một trong những API sau (vào trang API Reference để xem hướng dẫn chi tiết)

  • Get order detail: Lấy thông tin chi tiết của một đơn hàng cụ thể bằng mã đơn của Merchize (code) hoặc số đơn trong hệ thống của bạn (external_number).

  • Get list orders detail: Lấy thông tin chi tiết của nhiều đơn hàng bằng mã đơn của Merchize (code) hoặc mã đơn trong hệ thống của bạn (external_number).

Thông qua các API này, bạn sẽ lấy được orderitem id - thông tin này sẽ cần cho bước tiếp theo.

Bước 2: Import artwork 

Với orderitem id nhận được, bạn có thể sử dụng API Import order artwork để import hàng loạt artwork cho các đơn chưa được đưa vào quá trình xử lý đơn.

  • Yêu cầu:

    • Phải có ít nhất một artwork (cho một mặt bất kỳ: front, back, sleeve, hood).

    • Số bộ artwork tối đa cho mỗi order item ID là 10.

    • Điền số lượng item tương ứng với bộ artwork trong trường apply_for_item (số lượng mặc định là 1, có thể điền số từ 1 đến 50).

Bước 3: Theo dõi và xử lý lỗi

Sau khi import bằng API, kiểm tra phản hồi API hoặc trang Artwork Import Log để xem và xử lý các lỗi nếu có.

Error message trong phản hồi API

Lỗi và cách khắc phụ

The [field] is required

Thiếu trường bắt buộc: Đảm bảo tất cả các trường bắt buộc, như id, đã được điền.

Fill at least one item design from one side

Thiếu link artwork: Cung cấp ít nhất một liên kết artwork cho bất kỳ mặt nào của sản phẩm.

Invalid [field] format

Định dạng không hợp lệ: Kiểm tra lại định dạng của các trường theo yêu cầu của tài liệu API.

Wrong link [field] format file  

Liên kết URL không hợp lệ: Đảm bảo liên kết URL của artwork hợp lệ và có thể truy cập.

Order item [item_id] not found

Không tìm thấy mục đơn hàng: Đảm bảo orderitem id chính xác và tồn tại.

Invalid apply_for_item of item [item_id]. Enter a numeric value between 1 and 50

apply_for_item không hợp lệ: Đặt apply_for_item trong khoảng từ 1 đến 50.

[item_id]The number of added artwork sets exceeds the allowable limit (Limit 1-10 set artworks)

Giới hạn tối đa là 10 bộ artwork cho mỗi mục đơn hàng.

Order has been cancelled, can not update artwork

Đơn hàng đã hủy hoặc hoàn tất: Chỉ những mục chưa được hoàn tất mới có thể cập nhật.

Error message trong Artwork Import log

Lỗi


Order has been processed, can not update artwork

Order đã được đẩy sang quá trình xử lý đơn, không thể update artwork


Đây là 2 cách sẽ giúp bạn dễ dàng import artwork hàng loạt cho các đơn hàng của mình qua CSV hoặc API trên Merchize.