Đăng ký: Hướng Dẫn Di chuyển

Hướng dẫn này giúp bạn di chuyển hợp đồng đăng ký một cách an toàn từ nền tảng hiện tại của bạn (ví dụ, Recharge hoặc Appstle) sang ứng dụng Đăng ký SHOPLINE. Điều này sẽ giúp bạn:

• Giảm thiểu mất khách hàng: Giữ hợp đồng hoạt động trên nền tảng gốc trong quá trình di chuyển để tránh các vấn đề thanh toán và giữ chân khách hàng.

• Đơn giản hóa việc di chuyển: Sử dụng quy trình mượt mà, đáng tin cậy để chuyển doanh nghiệp của bạn sang SHOPLINE và tận hưởng quản lý đăng ký nâng cao.

Hướng dẫn bao gồm chuẩn bị, nhập và đồng bộ hợp đồng, kiểm tra kết quả, quản lý hợp đồng và kích hoạt khách hàng để bắt đầu suôn sẻ.

Tổng quan về việc di chuyển

Trước khi bạn bắt đầu di chuyển

1. Thiết lập Đăng ký SHOPLINE

Trước khi di chuyển, hãy cài đặt và thiết lập SHOPLINE Đăng ký.

Hãy đảm bảo bạn đã thực hiện các bước sau:

• Đã cài đặt ứng dụng Đăng ký SHOPLINE.
• Đã tạo các gói đăng ký bạn cần. Các hợp đồng được di chuyển sẽ liên kết với các gói này.
• Đã thiết lập thông báo di chuyển hợp đồng trong phần Cài đặt hiển thị cửa hàng.
• Đã bật các thông tin khách hàng được phép cập nhật, trong phần Cài đặt, bao gồm:
  • Thông tin vận chuyển
  • Tần suất đăng ký
  • Phương thức thanh toán

Để biết chi tiết về các gói đăng ký và cài đặt hiển thị cửa hàng, xem bài viết "Đăng ký: Thiết lập Mua hàng Định kỳ."

2. Di chuyển Dữ liệu Cơ bản của Cửa hàng Trước

Trước khi di chuyển hợp đồng, hãy đảm bảo dữ liệu cơ bản của cửa hàng bạn đã được di chuyển sang SHOPLINE. Điều này là cần thiết để dữ liệu hợp đồng được ánh xạ và hiển thị chính xác. Bạn có thể sử dụng ứng dụng Di chuyển Cửa hàng Đa nền tảng để hỗ trợ di chuyển dữ liệu có cấu trúc này, bao gồm:

• Dữ liệu sản phẩm: Đảm bảo tất cả dữ liệu sản phẩm đã được di chuyển từ nền tảng gốc sang SHOPLINE.
• Dữ liệu khách hàng: Đảm bảo tất cả dữ liệu khách hàng đã được di chuyển từ nền tảng gốc sang SHOPLINE.

Giai đoạn 1: Di chuyển Hợp đồng

Mục tiêu ở đây là nhập các hợp đồng đăng ký vào SHOPLINE, bao gồm trạng thái hợp đồng, chu kỳ thanh toán, sản phẩm, khách hàng, địa chỉ giao hàng và thông tin vận chuyển.

Có hai cách để di chuyển hợp đồng:

• Đồng bộ API: Dành cho các thương nhân có cửa hàng gốc trên Shopify và dịch vụ đăng ký là Recharge, Appstle, Loop hoặc Seal. Lưu ý: Đồng bộ API yêu cầu cửa hàng gốc và ứng dụng đăng ký của bạn phải hoạt động trong suốt quá trình di chuyển, điều này có thể phát sinh chi phí thêm; vui lòng lên kế hoạch phù hợp.
• Nhập CSV: Dành cho các thương nhân không đáp ứng yêu cầu đồng bộ API, hoặc muốn chuẩn bị file và nhập tất cả trong một lần.

Di chuyển Hợp đồng qua Đồng bộ API

Khi nào áp dụng:

Đồng bộ API hiện hoạt động khi:

• Nền tảng cửa hàng gốc của bạn là Shopify.
• Nhà cung cấp đăng ký gốc của bạn là Recharge, Appstle, Loop hoặc Seal.
• Bạn có thể lấy cả thông tin đăng nhập Shopify và thông tin đăng nhập API cho nền tảng đăng ký của bạn.

Bước 1: Lấy Thông Tin Đăng Nhập Cửa Hàng Shopify Của Bạn

1. Trong Shopify Admin, vào Cài đặt > Tên miền để xem tên miền cửa hàng của bạn (ví dụ: handle.myshopify.com).
2. Ghi chú phần "handle" trong tên miền của bạn.

Lấy Khóa API Shopify (Quy Trình Mới 2026)

Từ tháng 1 năm 2026, một số cửa hàng Shopify sẽ được quản lý qua Bảng điều khiển Dev. Các cửa hàng sử dụng Bảng điều khiển Dev sẽ không thể lấy Khóa API thông qua Ứng dụng Tùy chỉnh Cũ. Cập nhật này không ảnh hưởng đến các Khóa API hiện có, chúng sẽ tiếp tục hoạt động bình thường trên SHOPLINE.

Nếu cửa hàng của bạn sử dụng Bảng điều khiển Dev, hãy làm theo các bước sau để lấy Client ID và Secret cho việc di chuyển hệ thống kép:

1. Tạo và Phát triển Ứng dụng

   • Đi tới Cài đặt > Ứng dụng và nhấp vào Xây dựng ứng dụng trong Bảng điều khiển Dev.

     

   • Trong Bảng điều khiển Dev, nhấp vào Tạo ứng dụng.

     

   • Trong phần Bắt đầu từ Bảng điều khiển Dev, nhập tên và nhấp vào Tạo.

     

   • Nhấp vào Chọn Phạm vi, chọn các quyền (bao gồm Ứng dụng, Đơn hàng, Khách hàng, Sản phẩm), sau đó nhấp vào Phát hành. Vui lòng đảm bảo tất cả các quyền sau đây được chọn:

     • read_all_orders

     • read_app_proxy

     • write_app_proxy

     • read_customers

     • read_customer_merge

     • read_orders

     • read_product_feeds

     • read_product_listings

     • read_products

     

   • Trong cửa sổ bật lên, nhấp lại vào Phát hành để xác nhận.

     

2. Lưu Client ID và Secret

   • Sau khi tạo ứng dụng, vào Cài đặt, sao chép và lưu trữ an toàn Client ID và Secret để di chuyển SHOPLINE.

     

3. Cài đặt Ứng dụng

   • Vào trang Trang chủ của ứng dụng và nhấp vào Cài đặt ứng dụng.

     

   • Trên trang Cài đặt ứng dụng trong quản trị Shopify của bạn, nhấp lại vào Cài đặt để hoàn tất việc cài đặt ứng dụng tùy chỉnh trong cửa hàng Shopify của bạn

     

Lấy Khóa API Shopify (Quy trình cũ trước năm 2025)

1. Phát triển và Tạo Ứng dụng

   • Đi tới Cài đặt > Ứng dụng và kênh bán hàng > Phát triển ứng dụng.

     

   • Nhấn Tạo ứng dụng tùy chỉnh, đặt tên cho ứng dụng của bạn (ví dụ: "Ứng dụng Di cư SHOPLINE"), và nhấn Tạo ứng dụng.

     
     

2. Cấu hình Quyền truy cập API Quản trị

   • Chọn tất cả các quyền API và nhấn Lưu.

     

3. Cài đặt Ứng dụng và Sao chép Khóa API

   • Đi tới thông tin xác thực API, nhấn Cài đặt ứng dụng, và sao chép mã thông báo API từ phần Thông tin xác thực API.

   Quan trọng: Mã thông báo chỉ hiển thị một lần. Hãy lưu trữ nó một cách an toàn.

Bước 2: Lấy Thông tin Xác thực API từ Nền tảng Đăng ký Hiện tại của Bạn

Bạn chỉ cần làm điều này cho nền tảng mà bạn đang sử dụng, không cần thiết lập tất cả các nền tảng.

Lấy Khóa API Recharge

1. Tạo Token Quản Trị

   • Đi tới Công cụ & ứng dụng > Token API, sau đó nhấp vào Tạo ngay trong thẻ Token Quản Trị.

     

2. Cấu hình Phạm vi API Quản Trị
   • Sau khi tạo token, vào trang Tạo Token API và đặt tên cho token của bạn.

   • Chọn tất cả quyền API và nhấp Lưu.

     

3. Sao chép Khóa API

   • Đi tới phần Token API và sao chép khóa API của bạn.

     

Lấy Khóa API Appstle

1. Đi tới Appstle Subscription > Thêm > Truy cập API.

   

2. Tìm phần Khóa API và nhấp vào Tạo khóa.

   

3. Trong cửa sổ bật lên, nhập tên cho khóa API, chọn Đọc & Ghi — Truy cập đầy đủ tất cả các điểm cuối API, sau đó nhấp Tạo khóa.

   

4. Sao chép Khóa API đã tạo để sử dụng sau.

   

Lấy Khóa API Seal

Lấy Khóa API Loop

Để lấy khóa API Loop Subscriptions, vui lòng tham khảo bài viết Tạo Mã API Loop trong Trung tâm Trợ giúp Loop.

Bước 3: Bắt đầu Đồng bộ Hợp đồng trong SHOPLINE

1. Đăng nhập vào quản trị ứng dụng Subscriptions của SHOPLINE.
2. Đi đến Trung tâm Di cư và nhấn Bắt đầu Di cư.
3. Chọn nền tảng đăng ký gốc của bạn.
4. Nhập tên Shopify handle, Client ID, Secret và thông tin xác thực API cho nền tảng đăng ký hiện tại của bạn.
5. Nếu có tùy chọn Tự động khớp kế hoạch đăng ký, hãy chọn nếu phù hợp với nhu cầu của bạn.
6. Nhấn Nhập Ngay.

Hệ thống sẽ kiểm tra tính hợp lệ của thông tin xác thực của bạn trước. Khi được xác minh, nó sẽ lấy và đồng bộ dữ liệu hợp đồng đăng ký từ nền tảng gốc.

Di cư Hợp đồng qua Tệp CSV

Bước 1: Tải Mẫu Di cư Hợp đồng

1. Đăng nhập vào quản trị ứng dụng Subscriptions của SHOPLINE.
2. Đi đến Trung tâm Di cư và nhấn Bắt đầu Di cư.
3. Chọn Nhập CSV.
4. Tải xuống mẫu nhập hợp đồng mới nhất.

Luôn sử dụng mẫu mới nhất được tải xuống từ bảng quản trị.

Bước 2: Xuất Dữ liệu Hợp đồng từ Nền tảng Gốc

Đăng nhập vào nền tảng đăng ký gốc của bạn và xuất dữ liệu hợp đồng bạn muốn di cư.

Trước khi tổ chức dữ liệu, hãy đảm bảo:

• Sản phẩm và biến thể đã tồn tại trong SHOPLINE.
• Khách hàng đã tồn tại trong SHOPLINE.
• Mỗi hợp đồng có một ID duy nhất, ổn định từ nền tảng gốc.
• Các hợp đồng cần giữ việc thanh toán đã bao gồm ngày thanh toán tiếp theo.

Bước 3: Điền Mẫu Nhập Hợp đồng

Mẫu hợp đồng dùng để di cư dữ liệu hợp đồng; bạn cần tự tổ chức dữ liệu của mình theo cấu trúc này trước khi tải lên.

Thông tin Cơ bản về Hợp đồng

Giá trị Status được phép: ACTIVE, PAUSED, CANCELLED, FAILED, EXPIRED

Thông tin Chu kỳ Thanh toán

Giá trị Interval được phép: DAY, WEEK, MONTH, YEAR

Thông tin Ngày và Tiền tệ

Thông tin Gói đăng ký và Sản phẩm

Giá trị Loại điều chỉnh mặt hàng được phép: PERCENTAGE, FIXED_AMOUNT

Thông tin Địa chỉ Giao hàng

Thông tin Vận chuyển

Bước 4: Tải lên Tệp CSV Hợp đồng của bạn

1. Quay lại trang Nhập hàng loạt CSV.
2. Nhấn Tiếp theo.
3. Tải lên tệp CSV hợp đồng đã hoàn thành của bạn.
4. Chọn kênh thanh toán cho mỗi hợp đồng, theo yêu cầu.
5. Nhấn Nhập và chờ quá trình hoàn tất.

Giai đoạn 2: Di chuyển Thanh toán

Khi các hợp đồng đã được di chuyển, nếu bạn muốn tiếp tục sử dụng phương thức thanh toán gốc trong SHOPLINE, bạn cần tải lên mã token thanh toán riêng biệt.

Di chuyển thanh toán không thay thế cho việc di chuyển hợp đồng; hãy đảm bảo hợp đồng đã được nhập thành công trước, sau đó tải lên các mã token thanh toán tương ứng.

Trước khi bắt đầu, chuẩn bị:

• Mã ID Đăng ký Gốc của hợp đồng đã nhập thành công.
• Email của khách hàng.
• Kênh thanh toán hiện tại và thông tin mã token thực tế được hợp đồng sử dụng.

Chỉ tải lên mã token thanh toán cho các hợp đồng vẫn cần sử dụng phương thức thanh toán gốc; bạn không cần điền tệp mã token cho các hợp đồng không cần di chuyển thanh toán.

Các Trường trong Tệp Mã Token Thanh toán

Mỗi dòng hợp đồng chỉ cần các trường cho kênh thanh toán thực tế của nó; để trống các trường của các kênh khác.

Cách Tải Lên Token Thanh Toán

1. Xác nhận hợp đồng đã được di chuyển.
2. Tải xuống và điền mẫu nhập token thanh toán.
3. Kiểm tra kỹ mã hợp đồng khớp chính xác với hợp đồng được nhập.
4. Đi đến trang tải lên token thanh toán trong SHOPLINE Subscriptions.
5. Tải lên tệp và chờ kết quả.
6. Nếu có tệp kết quả, tải xuống và sửa các bản ghi bị lỗi.

Nếu token thanh toán không thể di chuyển, hợp đồng có thể giữ trạng thái "Đang di chuyển"; khách hàng vẫn có thể cập nhật phương thức thanh toán sau trong Trung tâm Khách hàng.

Quản Lý Các Hợp Đồng Đã Di Chuyển

Khi việc di chuyển hoàn tất, bạn có thể xem và quản lý tất cả các hợp đồng đã di chuyển từ Trung tâm Di chuyển.

Danh Sách Hợp Đồng Đã Di Chuyển

Đi đến Trung tâm Di chuyển > Hợp đồng Đã Di chuyển để xem tất cả các hợp đồng đã nhập hoặc đồng bộ. Danh sách thường bao gồm:

Ý nghĩa trạng thái di chuyển

Các hành động có sẵn

Đối với các hợp đồng được đánh dấu "Chờ cập nhật thanh toán" hoặc "Không cần di chuyển," bạn có thể (tùy thuộc vào hỗ trợ của quản trị viên):

• Thêm mã giảm giá.
• Lọc và xuất danh sách hợp đồng và khách hàng.
• Gửi email thu hút lại khách hàng đủ điều kiện.

Giúp khách hàng hoàn thành việc di chuyển

Đối với các hợp đồng chưa hoàn thành việc di chuyển thanh toán hoặc cập nhật phương thức thanh toán, khách hàng cần cập nhật phương thức thanh toán trong Trung tâm Khách hàng trước khi hợp đồng chuyển sang trạng thái "Di chuyển thành công."

Thiết lập thông báo di chuyển hợp đồng

Trong Đăng ký > Trung tâm Di chuyển > Thông báo Di chuyển Hợp đồng, bật bảng nhắc cập nhật.

Trước khi khách hàng cập nhật phương thức thanh toán, tốt nhất không nên hướng họ chỉnh sửa hợp đồng trực tiếp, trước tiên hãy giải thích rằng họ cần cập nhật phương thức thanh toán để tránh nhầm lẫn trong quá trình di chuyển.

Khách hàng làm gì

1. Đăng nhập vào Trung tâm Khách hàng của cửa hàng.
2. Đi đến Đăng ký của tôi.
3. Khi họ cố gắng chỉnh sửa hợp đồng đang ở trạng thái "Chờ Cập nhật Thanh toán" (ví dụ, thay đổi lịch thanh toán hoặc địa chỉ giao hàng), hệ thống sẽ yêu cầu họ cập nhật phương thức thanh toán.
4. Họ nhấp vào Cập nhật ngay để vào trình hướng dẫn cập nhật hợp đồng.
5. Họ xác nhận hoặc cập nhật thông tin như ngày thanh toán tiếp theo và địa chỉ giao hàng.
6. Họ thêm phương thức thanh toán mới.
7. Khi phương thức thanh toán được cập nhật, SHOPLINE hoàn tất việc chuyển giao, và trạng thái hợp đồng chuyển sang "Di cư thành công".

Khi khách hàng hoàn tất việc chuyển giao, người bán sẽ nhận được thông báo. Để tránh việc tính phí hai lần, hãy đảm bảo xử lý kịp thời hợp đồng cũ tương ứng trên nền tảng gốc.

Giữ Dữ liệu Luôn Cập nhật

Cập nhật Tự động qua API

Nếu bạn đã bật đồng bộ tự động qua API, các thay đổi về dữ liệu hợp đồng từ Recharge, Appstle, Loop hoặc Seal (như gia hạn hoặc thay đổi trạng thái) sẽ được đồng bộ gần như theo thời gian thực vào danh sách hợp đồng di cư của SHOPLINE thông qua webhook. Bạn không cần phải cập nhật thủ công thông tin snapshot cho các hợp đồng "Chờ Cập nhật Thanh toán" này.

Cập nhật Thủ công qua CSV

Nếu bạn đã sử dụng nhập khẩu CSV, và dữ liệu hợp đồng thay đổi trên nền tảng gốc trong khi hợp đồng vẫn ở trạng thái "Chờ Cập nhật Thanh toán", bạn có thể cập nhật thủ công thông tin snapshot trong SHOPLINE.

Nếu bạn vẫn đang vận hành hợp đồng gốc trên nền tảng cũ, hãy đảm bảo đồng bộ cập nhật đó ở đó nữa.

Câu hỏi Thường Gặp (FAQs)

Tìm câu trả lời cho các câu hỏi phổ biến về việc sử dụng giải pháp di cư hệ thống kép.

Q1: Tại sao các hợp đồng tôi nhập khẩu lại được đánh dấu là "Chờ Cập nhật Phương thức Thanh toán"?

Điều này thường xảy ra khi phương thức thanh toán gốc (ví dụ, Shopify Payment) không được SHOPLINE hỗ trợ, hoặc việc di cư phương thức thanh toán chưa hoàn tất.

Q2: Làm thế nào để thay đổi hợp đồng sang trạng thái "Di cư thành công"?

Khách hàng cần cập nhật phương thức thanh toán của họ trong cửa hàng của bạn đối với các hợp đồng ở trạng thái "Chờ Cập nhật Phương thức Thanh toán".

Q3: Tôi có cần hủy hợp đồng trên nền tảng gốc một cách thủ công không?

Đối với nhập khẩu CSV, khi một hợp đồng được đánh dấu "Di cư thành công" trong SHOPLINE, bạn phải hủy hợp đồng cũ trên nền tảng gốc của bạn để tránh việc tính phí hai lần. Đối với nhập khẩu API từ các nền tảng đăng ký được hỗ trợ, SHOPLINE sẽ tự động hủy hợp đồng cũ qua API.

Q4: Dữ liệu đơn hàng của Shopify hoặc Giải pháp Thương mại Điện tử Legacy có được đồng bộ vào SHOPLINE sau khi đồng bộ API không?

Đồng bộ API chủ yếu cập nhật dữ liệu hợp đồng. Bạn phải đồng bộ dữ liệu đơn hàng thủ công bằng cách sử dụng ứng dụng Di chuyển cửa hàng đa nền tảng .