Khắc phục sự cố các lỗi thường gặp khi di chuyển cửa hàng
Di chuyển cửa hàng giúp chuyển dữ liệu kinh doanh từ nền tảng gốc của bạn sang SHOPLINE, nhưng một số bản ghi có thể bị lỗi khi dữ liệu bắt buộc bị thiếu, không được hỗ trợ, bị trùng lặp hoặc không phù hợp với cài đặt cửa hàng SHOPLINE của bạn.
Hướng dẫn này giải thích cách đọc lỗi di chuyển thô, sửa các vấn đề dữ liệu nguồn phổ biến, thử lại các mục bị lỗi và quyết định khi nào nên liên hệ với Bộ phận Hỗ trợ SHOPLINE.
Lỗi Di chuyển Sản phẩm và Danh mục
Sử dụng phần này khi các bản ghi sản phẩm, tồn kho hoặc danh mục bị lỗi trong quá trình di chuyển:
| Loại dữ liệu | Thông tin hiển thị trong kết quả di chuyển | Cách sử dụng |
| Danh mục sản phẩm | Định danh bộ sưu tập, ví dụ automated-collection | Sử dụng định danh bộ sưu tập để tìm danh mục hoặc bộ sưu tập thông minh trên nền tảng gốc, sau đó kiểm tra điều kiện và cài đặt sắp xếp của nó. |
| Sản phẩm | Định danh sản phẩm, ví dụ the-side-sleeper-s-cloud | Sử dụng định danh sản phẩm để tìm sản phẩm trên nền tảng gốc, sau đó kiểm tra hình ảnh, giá trị tùy chọn, tồn kho và các vị trí liên quan. |
| Thông báo lỗi thô | Ý nghĩa | Hành động tiếp theo |
| column:product_category_id unsupport / product_category_id_with_descendants unsupport | Bộ sưu tập thông minh sử dụng điều kiện loại sản phẩm tiêu chuẩn không được hỗ trợ. | Cập nhật điều kiện bộ sưu tập thông minh trên nền tảng gốc, sau đó thử lại việc di chuyển. |
| body.smart_collection: The required property 'rules' is missing from the object | Bộ sưu tập thông minh không có bất kỳ quy tắc nào. | Kiểm tra xem điều kiện bộ sưu tập thông minh có trống trên nền tảng gốc không. Thêm các quy tắc hợp lệ, sau đó thử lại. |
| SORTATION_CONDITION_INVALID | Loại sắp xếp danh mục sản phẩm không được hỗ trợ. | Mục này có thể cần hỗ trợ sản phẩm trước khi có thể di chuyển. Liên hệ Bộ phận Hỗ trợ SHOPLINE nếu danh mục quan trọng. |
| The product or category relocation failed, resulting in the inability to bind the category relationship. Please try again. | Một số sản phẩm không thể liên kết với danh mục vì việc di chuyển sản phẩm hoặc danh mục bị lỗi. | Thử lại mục bị lỗi. Nếu vẫn lỗi, trước tiên kiểm tra xem các sản phẩm liên quan đã di chuyển thành công chưa. |
| Failed to add product[At least one of the image ID or src should be valued.]; | Sản phẩm không có hình ảnh sử dụng được. | Thêm ít nhất một hình ảnh sản phẩm trên nền tảng gốc, sau đó thử lại. |
| Failed to update product[You need to add option values for color_family]; | Tùy chọn sản phẩm color_family thiếu giá trị tùy chọn. | Thêm giá trị tùy chọn còn thiếu trên nền tảng gốc, sau đó thử lại. |
| activation inventory Error[System error, please try again.]; | Kích hoạt tồn kho thất bại, thường do các vị trí liên quan không được di chuyển thành công. | Kiểm tra xem các vị trí tồn kho đã di chuyển thành công chưa, sau đó thử lại việc di chuyển sản phẩm. |
Lỗi Di cư Thanh toán bị Bỏ và Đơn hàng
Sử dụng phần này khi các thanh toán bị bỏ hoặc đơn hàng không thành công trong quá trình di cư:
| Loại dữ liệu | Thông tin hiển thị trong kết quả di cư | Cách sử dụng |
| Thanh toán bị bỏ | Số thanh toán hoặc ID thanh toán | Sử dụng số thanh toán để tìm thanh toán bị bỏ trên nền tảng gốc, sau đó kiểm tra thông tin liên hệ khách hàng, sản phẩm, thị trường, tiền tệ, ghi chú người bán và dữ liệu mã giảm giá. |
| Đơn hàng | ID đơn hàng | Sử dụng ID đơn hàng để tìm đơn hàng trên nền tảng gốc, sau đó kiểm tra chi tiết thanh toán, hoàn tiền, thị trường, tiền tệ và chi tiết giảm giá. |
| Thông báo lỗi gốc | Nghĩa của lỗi | Hành động tiếp theo |
| Mục trong đơn hàng bị bỏ không hợp lệ. | Thanh toán bị bỏ chứa sản phẩm không tồn tại trong SHOPLINE. Sản phẩm có thể đã không di cư thành công hoặc đã bị xóa khỏi nền tảng gốc. | Nếu sản phẩm không di cư thành công, hãy di cư sản phẩm trước. Nếu sản phẩm đã bị xóa khỏi nền tảng gốc, thanh toán bị bỏ này không thể di cư trong lô này. |
| buyerinfo phải chứa userId, email hoặc điện thoại | Thanh toán bị bỏ không bao gồm đủ thông tin liên hệ khách hàng. | Xác nhận xem thanh toán bị bỏ có địa chỉ email hoặc số điện thoại trên nền tảng gốc không. Nếu cả hai đều thiếu, thanh toán bị bỏ không thể khôi phục hoặc di cư. |
| presentmentCurrency không khớp với tiền tệ thị trường | Tiền tệ thanh toán không tồn tại trong cài đặt thị trường hiện tại của SHOPLINE. | Kiểm tra cài đặt thị trường và tiền tệ của SHOPLINE, đảm bảo chúng khớp với nền tảng gốc. |
| Tạo thất bại: A-INVALID_ARGUMENT: Không tìm thấy thị trường CA | Thị trường được sử dụng bởi thanh toán bị bỏ không tồn tại trong SHOPLINE. | Kiểm tra cài đặt thị trường của SHOPLINE, đảm bảo thị trường cần thiết tồn tại. |
| Tạo thất bại: A-INVALID_ARGUMENT: invalid RelocateAbandonedOrderRequest.AbandonedOrder: embedded message failed validation | caused by: invalid AbandonedOrderRelocationDTO.SellerNote: độ dài giá trị tối đa là 1000 ký tự | Ghi chú người bán vượt quá giới hạn ký tự. | Rút ngắn ghi chú người bán trên nền tảng gốc, sau đó thử lại. |
| Tạo thất bại: A-INVALID_ARGUMENT: mã giảm giá trùng lặp: BOGOS-BPuyW55 | Cùng một đơn hàng sử dụng mã giảm giá giống nhau nhiều hơn một lần. | Sửa dữ liệu giảm giá trên nền tảng gốc. Loại dữ liệu bất thường này không được hỗ trợ di cư nếu không được sửa. |
| tạo đơn hoàn tiền: ["SYSTEM_ERROR","OFC_123686_B1002"] | Số tiền hoàn trả lớn hơn số tiền đã thanh toán cho đơn hàng. | Xem lại đơn hàng trên nền tảng gốc. Nếu số tiền hoàn trả cao hơn số tiền đã thanh toán, đơn hàng không thể di cư. |
Lỗi Di cư Khách hàng
Sử dụng phần này khi hồ sơ khách hàng không thành công trong quá trình di cư:
| Loại dữ liệu | Thông tin hiển thị trong kết quả di chuyển | Cách sử dụng |
| Khách hàng | Email khách hàng, số điện thoại hoặc ID khách hàng | Sử dụng email, số điện thoại hoặc ID khách hàng để tìm khách hàng trên nền tảng gốc, sau đó kiểm tra định dạng email, thông tin liên hệ trùng lặp, trạng thái tiếp thị qua email và dữ liệu email đã được xác minh. |
| Thông báo lỗi gốc | Ý nghĩa | Hành động tiếp theo |
| email is illegal argument | Địa chỉ email khách hàng không đúng định dạng hợp lệ. | Sửa lại địa chỉ email khách hàng trên nền tảng gốc, sau đó thử lại. |
| code=DATA_NOT_EXIST, alertMessage=data does not exist, debugMessage=data does not exist, suppressedErrors=[] | Yêu cầu dịch vụ thất bại hoặc không tìm thấy dữ liệu cần thiết. | Thử lại sau. Nếu thử lại nhiều lần vẫn thất bại, liên hệ quản lý tài khoản SHOPLINE hoặc Bộ phận Hỗ trợ SHOPLINE. |
| code=0003, alertMessage=There are different accounts registered with email and mobile phone, debugMessage=There are different accounts registered with email and mobile phone, suppressedErrors=[] | Các tài khoản khách hàng khác nhau đang sử dụng cùng một địa chỉ email hoặc số điện thoại. | Sửa dữ liệu khách hàng trùng lặp trên nền tảng gốc. Loại dữ liệu bất thường này không được hỗ trợ di chuyển nếu không được sửa. |
| Email consent state is 'Subscribed' or 'Pending', email cannot be empty | Khách hàng được đánh dấu là đã đăng ký hoặc đang chờ tiếp thị qua email, nhưng địa chỉ email để trống. | Thêm địa chỉ email khách hàng hoặc cập nhật trạng thái tiếp thị qua email trên nền tảng gốc, sau đó thử lại. |
| Verified_email is yes, email cannot be empty | Khách hàng được đánh dấu có email đã được xác minh, nhưng địa chỉ email để trống. | Sửa dữ liệu email khách hàng trên nền tảng gốc. Loại dữ liệu bất thường này không được hỗ trợ di chuyển nếu không được sửa. |
Lỗi Di chuyển Mã giảm giá, Thẻ quà tặng, Metafield và Metaobject
Sử dụng phần này khi dữ liệu khuyến mãi hoặc dữ liệu tùy chỉnh gặp lỗi trong quá trình di chuyển:
| Loại dữ liệu | Thông tin hiển thị trong kết quả di chuyển | Cách sử dụng |
| Giảm giá và mã giảm giá | ID quy tắc giảm giá hoặc mã giảm giá | Sử dụng ID quy tắc giảm giá hoặc mã để tìm chương trình khuyến mãi trên nền tảng gốc, sau đó kiểm tra loại giảm giá, sản phẩm được chọn, khách hàng hoặc phân khúc mục tiêu, số tiền, phần trăm và mã trùng lặp. |
| Thẻ quà tặng | ID thẻ quà tặng | Sử dụng ID thẻ quà tặng để tìm thẻ quà tặng trên nền tảng gốc, sau đó kiểm tra xem ghi chú có nằm trong độ dài được hỗ trợ hay không. |
| Metafields | Tài nguyên chủ sở hữu, ID chủ sở hữu, namespace, khóa, ID metafield và loại metafield | Sử dụng tài nguyên chủ sở hữu để xem metafield thuộc về gì, ví dụ như SẢN PHẨM. Sử dụng ID chủ sở hữu để tìm sản phẩm, trang hoặc tài nguyên cụ thể. Sử dụng namespace, khóa, ID metafield và loại để tìm chính xác metafield và kiểm tra xem loại, giá trị hoặc tài nguyên tham chiếu có hợp lệ không. |
| Mục và định nghĩa metaobject | Handle mục, ID mục, tên metaobject, ID định nghĩa và loại định nghĩa | Sử dụng handle mục hoặc ID mục để tìm mục metaobject cụ thể. Sử dụng tên metaobject, ID định nghĩa và loại định nghĩa để tìm định nghĩa metaobject. Nếu lỗi đề cập đến giá trị trường bị thiếu, hãy kiểm tra các trường bắt buộc trong mục đó. |
| Thông báo lỗi gốc | Ý nghĩa | Hành động tiếp theo |
| graphql: Gọi dịch vụ thất bại. | Một yêu cầu dịch vụ tạm thời đã thất bại. | Thử lại sau. Nếu thử lại nhiều lần vẫn thất bại, liên hệ với quản lý tài khoản SHOPLINE hoặc Bộ phận Hỗ trợ SHOPLINE. |
| Chỉ một hoạt động được chỉ định có thể có hiệu lực cho một sản phẩm trong cùng một kênh cùng lúc. | Một sản phẩm có nhiều hơn một chương trình giảm giá tự động đang hoạt động trong cùng một kênh cùng lúc. | Xem lại cài đặt giảm giá trên nền tảng gốc, sửa xung đột, sau đó thử lại. |
| Phải định nghĩa các mục trong 'khách hàng nhận' khi 'khách hàng nhận tất cả mục' là sai | Một chương trình giảm giá được đặt áp dụng cho các sản phẩm được chọn, nhưng không có sản phẩm nào được chọn. Đối với giảm giá Mua X Tặng Y, có thể thiếu sản phẩm quà tặng. | Kiểm tra xem chương trình giảm giá đã chọn sản phẩm chưa. Nếu đã chọn, xác nhận các sản phẩm đó đã được di chuyển thành công. |
| khách hàng và phân đoạn khách hàng không thể cùng lúc để trống | Chương trình giảm giá nhắm đến khách hàng hoặc phân đoạn khách hàng cụ thể, nhưng danh sách mục tiêu trống hoặc không được di chuyển thành công. | Kiểm tra cài đặt khách hàng mục tiêu hoặc phân đoạn khách hàng trên nền tảng gốc. Nếu đã chọn khách hàng hoặc phân đoạn, xác nhận chúng đã được di chuyển thành công. |
| Phần trăm phải nằm trong khoảng 0.00 - 1.00 | Tỷ lệ phần trăm giảm giá nằm ngoài phạm vi được hỗ trợ. | Cập nhật tỷ lệ phần trăm giảm giá trên nền tảng gốc, sau đó thử lại. |
| Giá trị số tiền giảm giá phải nằm trong khoảng 0.01 - 99999999999.00 | Số tiền giảm giá nằm ngoài phạm vi được hỗ trợ hoặc bằng 0. | Cập nhật số tiền giảm giá trên nền tảng gốc, sau đó thử lại. |
| Giá trị nhập đã tồn tại. | Quy tắc giảm giá đã tồn tại. | Kiểm tra xem giảm giá đã được di chuyển chưa. Nếu đã di chuyển đúng, bạn có thể bỏ qua lỗi này. |
| Loại giảm giá không được hỗ trợ. | Loại giảm giá không được hỗ trợ để di chuyển. | Hiện tại các loại giảm giá được hỗ trợ bao gồm giảm giá đơn hàng, giảm giá sản phẩm, Mua X Tặng Y và miễn phí vận chuyển. |
| Hiện tại không hỗ trợ đặt quy tắc giảm giá cho cả sản phẩm và biến thể sản phẩm | Giảm giá được đặt ở cả cấp độ sản phẩm và cấp độ biến thể. | Cài đặt này hiện không được hỗ trợ. Liên hệ Bộ phận Hỗ trợ SHOPLINE nếu bạn cần giúp quyết định cách tạo lại giảm giá. |
| REQUEST_LIMIT_EXCEEDED | Việc di chuyển đã kích hoạt giới hạn yêu cầu do khối lượng dữ liệu lớn. | Thử lại sau, hoặc liên hệ quản lý tài khoản SHOPLINE để yêu cầu tăng giới hạn. |
| mã giảm giá trùng lặp | Mã giảm giá đã tồn tại. | Kiểm tra xem mã giảm giá đã được di chuyển chưa. Nếu đã di chuyển đúng, bạn có thể bỏ qua lỗi này. |
| invalid GiftCardCreateOpenRequest.Note: độ dài giá trị tối đa là 500 ký tự | Ghi chú thẻ quà tặng vượt quá giới hạn ký tự. | Rút ngắn ghi chú thẻ quà tặng trên nền tảng gốc, sau đó thử lại. |
| Loại Metafield không được hỗ trợ. / loại không hợp lệ. | Loại metafield không được hỗ trợ. | Cập nhật loại metafield trên nền tảng gốc, hoặc liên hệ Bộ phận Hỗ trợ SHOPLINE. |
| khóa không cho phép số | Giá trị hoặc khóa metafield sử dụng số ở vị trí không được hỗ trợ. | Cập nhật giá trị hoặc khóa metafield trên nền tảng gốc, sau đó thử lại. |
| không thể lấy giá trị tham chiếu | Metafield tham chiếu đến tài nguyên khác, như hình ảnh, video, sản phẩm hoặc trang, nhưng không tìm thấy. | Xác nhận tài nguyên được tham chiếu đã được di chuyển thành công, sau đó thử lại. |
| Khóa phải có độ dài ít nhất 3 ký tự | Khóa metafield quá ngắn. | Cập nhật tên khóa metafield trên nền tảng gốc, sau đó thử lại. |
| json: không thể giải mã chuỗi thành trường cấu trúc Go ShoplineMetafieldDefinition.definition.id kiểu int64 | Dữ liệu metafield không thể được xử lý. | Liên hệ Bộ phận Hỗ trợ SHOPLINE để được giúp đỡ. |
| `single_line_text_field` phải nhất quán với loại định nghĩa: 'boolean' | Giá trị metafield không khớp với loại trường của nó. | Cập nhật loại hoặc giá trị metafield trên nền tảng gốc, hoặc liên hệ Bộ phận Hỗ trợ SHOPLINE. |
| VALIDATION_ERROR: giá trị xác thực "metaobject_definition_id" "gid://shopify/MetaobjectDefinition/9186738408" không hợp lệ | Metafield tham chiếu đến một metaobject không hợp lệ. | Xác nhận dữ liệu metaobject đã được di chuyển thành công, sau đó thử lại. |
| định nghĩa metafield đã tồn tại | Định nghĩa metafield đã tồn tại. | Nếu dữ liệu đã được di chuyển đúng, bạn có thể bỏ qua lỗi này. |
| Không thể lấy giá trị tham chiếu. Vui lòng kiểm tra xem các tài nguyên liên quan có bị di chuyển không. | Mục metaobject tham chiếu đến một tài nguyên khác, như hình ảnh, video, sản phẩm hoặc trang, không được tìm thấy. | Xác nhận tài nguyên được tham chiếu đã được di chuyển thành công, sau đó thử lại. |
| body.metaobject.fields.#n: Thuộc tính bắt buộc 'value' bị thiếu trong đối tượng | Thiếu giá trị trường metaobject bắt buộc. | Kiểm tra mục metaobject trên nền tảng gốc và thêm giá trị bị thiếu, sau đó thử lại. |
| Loại trường này là meta-object nhưng không thể khớp với định nghĩa. | Trường metaobject không thể khớp với định nghĩa của nó. | Xác nhận rằng metaobject được sử dụng làm giá trị trường đã được di chuyển thành công. |
| definition.type: giá trị không khớp với mẫu regex `^[A-Za-z][A-Za-z0-9_-]*$` | Tên loại định nghĩa metaobject sử dụng ký tự không được hỗ trợ. | Đổi tên loại metaobject trên nền tảng gốc chỉ sử dụng chữ cái, số, dấu gạch ngang và dấu gạch dưới. |
Lỗi Di cư Liên quan đến Vận chuyển và Vị trí
Sử dụng phần này khi hồ sơ vận chuyển, quy tắc giao hàng, vị trí tồn kho hoặc kích hoạt tồn kho không thành công trong quá trình di cư:
| Loại dữ liệu | Thông tin hiển thị trong kết quả di cư | Cách sử dụng |
| Vận chuyển và giao hàng | Tên hồ sơ vận chuyển | Sử dụng tên hồ sơ để tìm hồ sơ vận chuyển trên nền tảng gốc, sau đó kiểm tra các quy tắc giao hàng và sản phẩm liên quan. |
| Thông báo lỗi gốc | Ý nghĩa | Hành động tiếp theo |
| Không thể thiết lập Profile[invalid ProductGroupSetReq.DeliveryLocationGroupList[0]: embedded message failed validation | caused by: invalid SetDeliveryLocationGroupReq.DeliveryPlans: value must contain at least 1 item(s)]; | Hồ sơ vận chuyển thiếu quy tắc giao hàng, hoặc sản phẩm liên quan không được di cư thành công. | Kiểm tra xem dữ liệu vận chuyển trên nền tảng gốc có đầy đủ không. Nếu đầy đủ, xác nhận rằng các sản phẩm được gán cho quy tắc vận chuyển đã di cư thành công. |
| Lỗi kích hoạt tồn kho[System error, please try again.]; | Kích hoạt tồn kho có thể thất bại nếu các vị trí tồn kho liên quan không được di cư thành công. | Kiểm tra xem các vị trí tồn kho đã di cư thành công chưa, sau đó thử lại. |
Hiểu về Thống kê Khách hàng Sau Khi Di cư
Thống kê khách hàng như tổng số đơn hàng và tổng chi tiêu phụ thuộc vào các đơn hàng đã được di cư. Nếu bạn di cư khách hàng mà không di cư đơn hàng, hồ sơ khách hàng có thể không hiển thị số lượng đơn hàng lịch sử hoặc tổng chi tiêu.
| Lưu ý: Để hiển thị số lượng đơn hàng và tổng chi tiêu của khách hàng sau khi di cư, hãy di cư đơn hàng cùng với dữ liệu khách hàng. |
Liên hệ Hỗ trợ SHOPLINE cho Các Lỗi Di cư Chưa Giải quyết
Nếu quá trình di cư thất bại và lỗi không thể được giải quyết bằng hướng dẫn khắc phục trong bài viết này, hãy xác định xem bạn nên thử lại di cư hay liên hệ Hỗ trợ SHOPLINE dựa trên thông báo lỗi và các khuyến nghị được cung cấp.
- Thử lại sau: Sử dụng tùy chọn này cho các lỗi dịch vụ tạm thời hoặc giới hạn yêu cầu.
- Liên hệ Hỗ trợ SHOPLINE: Sử dụng tùy chọn này khi lỗi vẫn còn sau khi thử lại, lỗi báo cài đặt không được hỗ trợ, hoặc bảng khuyến nghị cần hỗ trợ từ bộ phận hỗ trợ.
Bài viết này được dịch bằng AI và có thể chứa sai sót. Để có thông tin chính xác nhất, vui lòng tham khảo phiên bản tiếng Anh gốc.