LogidataChuẩn bị trước khi bắt đầu
Bạn nên làm trên máy tính và chuẩn bị sẵn 3 thứ:
- Tài khoản portal Logidata đã đăng nhập được.
- Tên đăng nhập và mật khẩu Shopee của shop (email, số điện thoại hoặc username). Nên dùng tài khoản chủ shop.
- Điện thoại có số đã đăng ký với shop để nhận mã xác minh của Shopee.
Mỗi nền tảng là một kết nối riêng: Shopee (đơn hàng, đối soát, trả hàng), Shopee Ads (quảng cáo) và Shopee Affiliate (tiếp thị liên kết). Muốn đủ dữ liệu, bạn làm bước 1 đến 6 cho từng nền tảng. Số kết nối còn lại của gói hiện ngay trên trang Thêm kết nối.
1Vào mục Kết nối và bấm Thêm kết nối
- Đăng nhập portal Logidata.
- Ở thanh bên trái, bấm Kết nối.
- Bấm nút + Thêm kết nối ở góc trên bên phải.
2Chọn nền tảng Shopee cần kết nối
Trang Thêm kết nối liệt kê các nền tảng Logidata hỗ trợ. Với Shopee có 3 thẻ:
| Thẻ | Lấy được dữ liệu gì |
|---|---|
| Shopee | Đơn hàng, tiền đối soát (escrow), trả hàng và hoàn tiền. |
| Shopee Ads | Hiệu suất quảng cáo CPC theo ngày. |
| Shopee Affiliate | Đơn và hoa hồng từ chương trình tiếp thị liên kết. |
Bấm nút trong thẻ bạn muốn kết nối. Nút ghi Kết nối … nếu bạn chưa nối lần nào, hoặc Nối thêm shop / Nối thêm tài khoản nếu đã có kết nối trước đó.
Làm xong bước 3 đến 6 cho Shopee rồi quay lại đây để kết nối Shopee Ads và Shopee Affiliate theo đúng các bước đó.
3Chọn vùng VN và đăng nhập tài khoản Shopee
Trình duyệt chuyển sang trang Login to Authorize Shopee Openplatform APP của Shopee.
- Bấm ô vùng bên trái (mặc định là SG) và chọn VN Vietnam.
- Nhập email, số điện thoại hoặc username của shop vào ô bên cạnh.
- Nhập mật khẩu Shopee và đăng nhập.
Để mặc định SG thì Shopee tìm tài khoản ở Singapore và báo sai tài khoản dù bạn nhập đúng.
Nút Switch to Main account dùng khi bạn đăng nhập bằng tài khoản chính (main account) quản lý nhiều shop. Shop bình thường không cần bấm.
4Nhập mã xác minh gửi về điện thoại
- Shopee gửi mã xác minh về số điện thoại đã đăng ký với shop.
- Nhập mã vào ô Verification Code.
- Bấm Verify.
Logidata không bao giờ hỏi mã này qua điện thoại, Zalo hay email. Chỉ nhập mã trên trang của Shopee.
5Đồng ý cấp quyền và chọn thời hạn
5a. Kiểm tra và bấm Confirm Authorization
- Bên trái: kiểm tra tên shop có đúng shop bạn muốn kết nối.
- Bên phải: ứng dụng nhận quyền là Logidata ERP, kèm danh sách dữ liệu được chia sẻ.
- Bấm Confirm Authorization.
| Quyền Shopee hiện | Nghĩa là |
|---|---|
| Product | Thông tin sản phẩm, giá, tồn kho và khuyến mãi sản phẩm tham gia. |
| Order | Đơn hàng, kèm chi tiết đối soát và vận chuyển. |
| Payment | Giao dịch ví và tiền đối soát. |
| Marketing | Thông tin chương trình giảm giá của shop. |
5b. Chọn thời hạn cấp quyền
- Ở ô Authorization Period, chọn 365 Days.
- Xem ngày hết hạn Shopee hiện bên dưới, ví dụ "2027-10-28 23:59 (UTC+07:00)".
- Bấm Confirm Authorization lần nữa.
Ghi lại ngày hết hạn để gia hạn trước khi kết nối ngừng hoạt động.
6Kiểm tra kết nối thành công
Shopee tự đưa bạn về portal Logidata. Trong mục Kết nối, shop vừa nối hiện với trạng thái Đang hoạt động.
Quay lại bước 1, lần này chọn thẻ Shopee Ads rồi Shopee Affiliate. Dùng cùng tài khoản Shopee của shop.
Bấm biểu tượng bút chì để đổi tên kết nối cho dễ nhận, ví dụ thêm đuôi _Ads, _Aff như trong ảnh.
7Gán kết nối cho API key
Kết nối mới chưa dùng được cho tới khi bạn tích nó vào một API key. Đây cũng là cách cấp quyền cho AI (MCP) hoặc Google Sheet đọc dữ liệu shop.
7a. Mở key cần dùng
- Ở thanh bên trái, bấm API key.
- Ở dòng key bạn muốn dùng, bấm biểu tượng bút chì để sửa. Chưa có key thì bấm + Tạo API key.
7b. Chọn mức quyền và tích các kết nối vừa thêm
- Ở Mức quyền, chọn Đầy đủ.
- Ở Kết nối được dùng, tích cả 3 kết nối vừa thêm: Shopee, Shopee Ads và Shopee Affiliate.
| Mức quyền | Dùng khi |
|---|---|
| Giới hạn | Chỉ gọi danh sách endpoint cơ bản. Không ghi. |
| Mở rộng | Gọi mọi endpoint đọc đã được Logidata duyệt. Không ghi. |
| Đầy đủ | Như Mở rộng, thêm các endpoint đọc chưa có trong danh mục. Chỉ ghi khi bạn bật riêng từng nền tảng. Script kéo dữ liệu Shopee cần mức này. |
7c. Kéo xuống và bấm Lưu kết nối
- Kéo khung xuống một chút, kiểm tra 3 kết nối đã được tích.
- Bấm Lưu kết nối ngay dưới danh sách.
- Nếu bạn vừa đổi tên key hoặc mức quyền, bấm thêm Lưu thay đổi ở cuối khung.
API key này giờ đọc được dữ liệu của shop. Các công cụ đang dùng key (AI, Google Sheet) không cần nhập lại key.
Bước tiếp theo
Kéo dữ liệu Shopee về Google Sheet
Đơn hàng, đối soát, quảng cáo, trả hàng, ví, đánh giá và affiliate tự về bảng tính, cập nhật mỗi giờ.
Xem hướng dẫnHỏi AI về dữ liệu shop
Trong portal, mở mục Dùng với AI để kết nối key với trợ lý AI và hỏi về doanh số, đơn hàng bằng tiếng Việt.
Gia hạn và thu hồi quyền
- Gia hạn: trước ngày hết hạn ở bước 5b, làm lại bước 1 đến 5 cho kết nối đó với cùng tài khoản Shopee.
- Thu hồi: vào Shopee Seller Center → Shop Setting → Partner Management và huỷ quyền của Logidata ERP.
- Ngừng cho một key dùng: mở key trong mục API key, bỏ tích kết nối rồi bấm Lưu kết nối. Kết nối vẫn còn cho các key khác.
Mọi API key, bảng tính và trợ lý AI đang dùng kết nối này sẽ báo lỗi quyền cho tới khi bạn kết nối lại.
Xử lý sự cố
Đăng nhập Shopee báo sai tài khoản dù nhập đúng
Kiểm tra ô vùng đã chọn VN chưa (bước 3). Nếu vẫn lỗi, thử đăng nhập trực tiếp Shopee Seller Center để chắc chắn mật khẩu còn đúng.
Không nhận được mã xác minh
Đợi hết đếm ngược rồi bấm Resend. Mã chỉ gửi về số điện thoại đã đăng ký với shop; nếu số này đã đổi, hãy cập nhật trong Shopee Seller Center trước.
Không bấm được Thêm kết nối, hoặc báo hết lượt kết nối
Gói của bạn đã dùng hết số kết nối. Xem dòng "Đã dùng x/y kết nối" trên trang Thêm kết nối. Hãy xoá kết nối không dùng hoặc liên hệ Logidata để nâng gói.
Sau khi xác nhận, không quay về portal Logidata
Mở lại portal và vào mục Kết nối. Nếu shop đã hiện Đang hoạt động thì kết nối đã xong. Nếu chưa có, làm lại từ bước 1.
Kết nối Đang hoạt động nhưng API key báo lỗi quyền
Kết nối chưa được tích vào key. Làm lại bước 7 và nhớ bấm Lưu kết nối.
Không có dữ liệu quảng cáo hoặc affiliate
Kiểm tra đã kết nối riêng Shopee Ads và Shopee Affiliate (bước 6) và đã tích cả hai vào API key.
Kết nối nhầm shop
Thu hồi quyền của shop đó trong Partner Management, rồi kết nối lại và kiểm tra kỹ tên shop ở bước 5a trước khi xác nhận.
Cần Logidata hỗ trợ?
Gọi cho chúng tôi nếu bị kẹt ở bước nào. Logidata cũng hỗ trợ kết nối thêm nền tảng, dựng báo cáo và tự động hoá quy trình dữ liệu.