Bài viết này hướng dẫn chi tiết cách nhập đơn hàng hiệu quả bằng tệp CSV. Tối ưu quản lý đơn hàng bằng cách nhập hàng loạt, không còn phải nhập tay từng đơn.
Chuẩn bị tệp CSV để nhập dữ liệu
Trước khi bắt đầu nhập dữ liệu, hãy đảm bảo tệp CSV được cấu trúc đúng. Tải xuống mẫu CSV để định dạng dữ liệu chính xác. Mỗi hàng trong tệp CSV nên đại diện cho một dòng mặt hàng, cho phép một đơn hàng trải dài trên nhiều hàng. Sử dụng cột "orderReferenceId" để liên kết các dòng mặt hàng với đơn hàng tương ứng.
Lưu ý: Nếu tiêu đề cột xuất hiện trong một cột duy nhất khi mở CSV trong Excel, hãy thử các cách khắc phục sau:
Dùng Google Sheets: Mở tệp CSV đúng cách với các cột được tách riêng.
Điều chỉnh thủ công trong Excel: Chuyển đổi tệp sang định dạng đúng bằng cách đặt mỗi tiêu đề vào một cột riêng.
Với mỗi hàng, thêm các thông tin đơn hàng thiết yếu:
Mã tham chiếu đơn hàng
Chi tiết vận chuyển
Chi tiết mục
URL cho từng khu vực in
Để xem giải thích chi tiết về các trường bắt buộc trong tệp CSV, hãy tham khảo trang "Tạo đơn hàng" trong tài liệu API của chúng tôi. Nguồn tài liệu đầy đủ này cung cấp góc nhìn hữu ích để bạn cấu trúc dữ liệu nhập khẩu hiệu quả: Tạo đơn hàng.
Nhập đơn hàng: Hướng dẫn từng bước
Làm theo các bước sau để nhập đơn hàng một cách mượt mà:
Truy cập Trang đơn hàng và nhấp vào nút "Nhập".
Chọn cửa hàng được chỉ định cho các đơn hàng nhập của bạn. Những đơn hàng này sẽ được đánh dấu là đã đặt từ cửa hàng đã chọn. Bạn cũng có thể linh hoạt nhập chúng dưới dạng đơn hàng thủ công.
Tải lên tệp CSV chứa các đơn hàng bạn muốn nhập. Bạn cũng có thể tải xuống mẫu CSV mới ngay trên trang này.
Kiểm tra kỹ lại xem bạn đã chọn đúng cửa hàng đích và tệp nhập hay chưa. Khi mọi thứ đã ổn, nhấp vào "Nhập" để bắt đầu quá trình nhập.
Bạn sẽ nhận được thông báo xác nhận rằng quá trình nhập đã bắt đầu.
Khi quá trình nhập hoàn tất, chúng tôi sẽ gửi email thông báo cho bạn. Email này sẽ tóm tắt nội dung nhập, bao gồm:
Tổng số đơn hàng trong tệp nhập.
Số đơn hàng đã nhập thành công.
Số đơn hàng không nhập được.
Ngoài ra, email sẽ đính kèm một tệp CSV chứa kết quả nhập chi tiết. Tệp này sẽ có ba cột:
mãThamChiếuĐơnHàng
kết quả (chỉ ra "thành công" hoặc "thất bại" cho từng đơn hàng)
lỗi (nêu rõ lý do cụ thể cho bất kỳ lỗi nhập nào)
Tìm hiểu các tham số bắt buộc trong tệp CSV để nhập dữ liệu
Bên dưới, bạn sẽ thấy phần phân tích chi tiết các tham số cần thiết cùng tài liệu tham chiếu tương ứng để giúp bạn hoàn thành bảng tính một cách chính xác.
Phương pháp này chủ yếu được dùng bởi những người đang thử nghiệm nền tảng trước khi tích hợp với API của chúng tôi hoặc gửi các đơn hàng ad hoc.
Thông tin chung về đơn hàng
orderReferenceId – Hiển thị số đơn hàng trong Trang quản lý của Gelato. Ví dụ:
G-250202201217.customerReferenceId – Tham chiếu ID khách hàng nội bộ.
orderType – Có thể đặt là
draft, nhưng mặc định làorder.shipmentMethodUid – Chỉ định phương thức giao hàng:
normal,standard, hoặcexpress.currency – Loại tiền tệ dùng để thanh toán.
retailShippingPriceInclVat, retailCurrency, item.retailPriceInclVat – Được dùng trong phân tích và nhiều khu vực khác nhau của nền tảng, bao gồm cả biểu mẫu hải quan.
Chi tiết địa chỉ giao hàng
Các tham số này tương ứng với các trường địa chỉ tiêu chuẩn trong phần thanh toán:
shippingAddress.firstName
shippingAddress.lastName
địaChỉGiaoHàng.dòngĐịaChỉ1
shippingAddress.addressLine2
shippingAddress.city
shippingAddress.postCode
shippingAddress.state
shippingAddress.country
shippingAddress.email
shippingAddress.phone
shippingAddress.companyName
Chi tiết Thuế và Tuân thủ
shippingAddress.federalTaxId – Mã số thuế liên bang của người nhận. Dùng để cung cấp CPF/CNPJ cho người nhận tại Brazil. Bắt buộc cho Brazil. Để cung cấp CNPJ thay vì CPF, đặt
isBusinessthànhtrue.shippingAddress.stateTaxId – Mã số thuế bang của người nhận. Dùng để cung cấp IE cho người nhận tại Brazil. Bắt buộc ở Brazil nếu người nhận là công ty. Để cung cấp trường này, đặt
isBusinessthànhtrue.shippingAddress.registrationState – Mã số cho một bang của Hoa Kỳ hoặc tương đương ở các quốc gia khác, xác định bang nơi công ty người nhận được đăng ký. Bắt buộc ở Brazil nếu người nhận là công ty. Để cung cấp trường này, đặt
isBusinessthànhtrue.
Thông tin sản phẩm
item.itemReferenceId – Tương ứng với
Item Reference IDtrong đơn hàng. Với đơn đến từ nền tảng Thương mại điện tử, giá trị này được gán tự động. Với đơn tạo thủ công, cần tự xác định.item.productUid – Làm theo hướng dẫn về UID sản phẩm và cách ánh xạ sản phẩm theo tiêu chuẩn của Gelato.
item.storeProductVariantId – Cung cấp ID biến thể từ URL của cửa hàng, ví dụ:
https://dashboard.gelato.com/stores/e92a3ee9-e494-41bf-a031-ca80e2fa3558/products/edit/04076663-f5a3-4701-af66-be932c676697.item.quantity – Chỉ định số lượng đơn vị đã đặt hàng.
item.pageCount – Bắt buộc cho sản phẩm nhiều trang (ví dụ: Brochure).
Tham số dành riêng cho thêu
Đối với thiết kế thêu, cần có thêm các tham số. Xem Hướng dẫn thêu để biết đầy đủ chi tiết.
item.adjustProductUidByFileTypes
item.file1.id, item.file1.type, item.file1.url, item.file1.threadColors, item.file1.fitMethod, item.file1.fillMethod
item.file2.id, item.file2.type, item.file2.url, item.file2.threadColors, item.file2.fitMethod, item.file2.fillMethod
Vì việc gửi đơn hàng bằng CSV đòi hỏi quản lý bảng tính liên tục và chuẩn bị tệp sẵn sàng in, chúng tôi khuyên bạn nên tận dụng các tùy chọn Xử lý đơn hàng tinh gọn hơn thông qua tích hợp API. Cách tiếp cận này giúp tối ưu hiệu suất và giảm công việc thủ công. Để biết thêm chi tiết, hãy tham khảo Tài liệu API của Gelato.