Đồng bộ Sapo Omni (Sapo Pos)
I. GIỚI THIỆU VỀ ĐỒNG BỘ SAPO OMNI
Sapo Omni sẽ đồng bộ về Abaha những thông tin sau:
Dữ liệu | Abaha -> Sapo Omni | Sapo Omni -> Abaha |
Danh mục sản phẩm |
| ✓ |
Sản phẩm | ✓ | ✓ |
Đơn đặt hàng | ✓ | ✓ |
Khách hàng |
| ✓ |
1.Danh mục sản phẩm - sản phẩm
Đối với đồng bộ Danh mục SP - sản phẩm: hệ thống Abaha đồng bộ một chiều từ Sapo Omni về Abaha
Điều kiện để đồng bộ sản phẩm: Bật chức năng đồng bộ sản phẩm
Lưu ý:
Hệ thống có cập nhật thông tin về name, của danh mục khi có thay đổi ở bên Sapo Pos.
Đồng bộ trạng thái của sản phẩm
Trạng thái [Ngừng giao dịch] bên Sapo Pos sẽ được đồng bộ về trạng thái Ẩn tại Abaha
Trạng thái [Đang giao dịch] bên Sapo Pos sẽ được đồng bộ về trạng thái Hiện tại Abaha
Tại Sapo pos: Nếu nhập giá bán lẻ khác giá bán buôn, sẽ đồng bộ về Abaha giá niêm yết = giá bán = giá bán lẻ bên Sapo pos
Đồng bộ tồn kho của sản phẩm: theo tồn kho của Chi nhánh mặc định được cài đặt bên Sapo Omni
2.Khách hàng
Chỉ đồng bộ 1 chiều từ Sapo omni về Abaha.
Điều kiện để đồng bộ khách hàng: Bật chức năng Đồng bộ khách hàng
Lưu ý:
Không đồng bộ tên khách hàng mặc định khi đồng bộ về sẽ lấy tên là Khách
Không đồng bộ địa chỉ khách hàng
Chỉ đồng bộ khách hàng có số điện thoại
3.Đơn hàng
Đồng bộ 2 chiều giữa Sapo omni và Abaha
Điều kiện để đồng bộ đơn hàng về Abaha:
Nếu đơn hàng chứa sản phẩm và khách hàng đã tồn tại bên Abaha => Cần bật chức năng Đồng bộ đơn hàng
Nếu đơn hàng chứa sản phẩm chưa tồn tại bên Abaha và khách hàng đã tồn tại bên Abaha => Cần bật chức năng Đồng bộ đơn hàng và Đồng bộ sản phẩm
Nếu đơn hàng chứa sản phẩm đã tồn tại bên Abaha và khách hàng chưa tồn tại bên Abaha => Cần bật chức năng Đồng bộ đơn hàng và Đồng bộ khách hàng
Điều kiện để đẩy đơn sang Sapo Pos : Bật chức năng Đồng bộ đơn hàng, sản phẩm, Khách hàng
Lưu ý:
Không đồng bộ địa chỉ giao hàng.
Các trạng thái tương ứng của 2 hệ thống:
Tại Abaha | Tại Sapo omni |
Đặt hàng Duyệt Đóng gói Xuất kho Hoàn thành | Đã đặt hàng |
Hủy Hoàn hàng | Đã hủy
|
II. CÁC BƯỚC THỰC HIỆN ĐỒNG BỘ
1. Khái quát
Bước 1: Khách hàng liên hệ Sapo yêu cầu mở chức năng đồng bộ API với app Bước 2: Sapo gửi cho khách hàng thông tin cấu hình đồng bộ qua email bao gồm cấu hình và tài liệu hướng dẫn đồng bộ API Bước 3: Khách hàng lấy Access_token (trong trường hợp khách muốn Abaha hỗ trợ thì cần cung cấp tài khoản đăng nhập Omni/ Pos cho Abaha và email tại bước 2 ) Bước 4: Thực hiện kết nối giữa Abaha và Sapo Omni Bước 5: Thực hiện đồng bộ và kiểm tra kết quả
2. Chi tiết các bước thực hiện
2.1 Hướng dẫn khởi tạo thông tin kết nối trên hệ thống Sapo Omni
Mục đích: Mục này phục vụ cho những khách hàng chưa biết cách khởi tạo thông tin kết nối trên hệ thống SAPO
Người thực hiện: Khách hàng
Link tài liệu hướng dẫn của SAPO: https://support.sapo.vn/sapo-omnichannel
Thông tin Chi nhánh cửa hàng Tham khảo tại đây: https://support.sapo.vn/quan-ly-chi-nhanh-pos
Thông tin Nhân viên phụ trách xử lý đơn hàng Tham khảo tại đây: https://support.sapo.vn/them-moi-nhan-vien-sapo-fnb
Thông tin Cài đặt nguồn bán hàng Tham khảo tại đây: https://support.sapo.vn/nguon-don-hang-pos
Thông tin Phương thức thanh toán mặc định Tham khảo tại link tại đây: https://support.sapo.vn/cau-hinh-thanh-toan
2.2 Lấy Access_token
Bước 1: Lấy thông tin Authorization code
Đầu tiên, truy cập địa chỉ mà SAPO Omni cung cấp qua url: {domain sapo cung câp}.mysapogo.com , đăng nhập vào hệ thống bằng tài khoản do SAPO Omni cung cấp:
Username
Password
![](https://tailieu.abaha.vn/~gitbook/image?url=https%3A%2F%2F4274594821-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MQa7fjZRtFKJkPsrqu5%252Fuploads%252FPYXR9j4X3glmoPI6VtLj%252Fimage.png%3Falt%3Dmedia%26token%3Da5c06d9d-6b68-457f-89d2-4599a8e8e6ce&width=768&dpr=4&quality=100&sign=2dd1892f&sv=1)
Lấy Authorization code bằng cách chạy url [GET] trên một trình duyệt bất kỳ (VD: Chrome): https://{sub_domain}.mysapogo.com/admin/oauth/authorize?client_id={api_key}&scope={scopes}&redirect_uri={redirect_uri}
Thay các thông tin dưới đây được SAPO cung cấp thông qua Email tới khách hàng vào url phía trên:
sub_domain
api_key
scopes
redirect_uri
Sau khi có url đúng thì paste vào url của trình duyệt chrome và enter ta sẽ có màn hình tương tự như ảnh. Phần tô đậm chính là Authorization code.
Bước 2: Lấy access_token dựa trên authorization code vừa lấy tại bước 1
Vào phần mềm PostMan, chạy url [POST] https://{sub_domain}.mysapogo.com/admin/oauth/access_token để lấy access_token
Tham số truyền vào gồm:
client_id: là API key (có trong email SAPO gửi)
client_secret: là Secret Key (có trong email SAPO gửi)
code: là Authorization code lấy tại bước 1
Kết quả trả về là access_token
2.3 Cấu hình kết nối với Sapo Omni tại hệ thống Abaha
Bước 1: Truy cập trang quản trị, chọn chức năng Đồng bộ
Link truy câp: https://app.abaha.vn/sites/sync_product/{site_id}
Bước 2: Chọn phần mềm đồng bộ là [sapopos]. Tiếp tục chọn các đối tượng muốn đồng bộ
Bước 3: Nhập thông tin kết nối
Gồm 2 trường thông tin:
Tên của shop: là thông tin [Alias] trong Email mà SAPO đã gửi về cho cửa hàng
Access_token: Thông tin vừa lấy theo hướng dẫn phía trên.
Sau khi điền 2 trường thông tin này, các trường thông tin Chi nhánh cửa hàng, Nhân viên phụ trách xử lý đơn hàng, Nguồn bán hàng, Cài đặt phương thức thanh toán sẽ tự mở để người dùng lựa chọn tiếp.
Bước 4: Chọn các thông tin Chi nhánh cửa hàng, Nhân viên phụ trách xử lý đơn hàng, Nguồn bán hàng:
Chi nhánh cửa hàng: lấy thông tin từ {Quản lý chi nhánh} trong phần Cầu hình của hệ thống SAPO
Nhân viên phụ trách xử lý đơn hàng: lấy thông tin từ {Nhân viên và phân quyền} trong phần Cấu hình
Nguồn bán hàng: Lấy thông tin từ {Nguồn bán hàng} trong phần Cấu hình
Cài đặt phương thức thanh toán mặc định để xác nhận đơn đã thanh toán từ App đẩy sang
Bước 5: Click nút [Đồng bộ] để hệ thống thực hiện đồng bộ dữ liệu.
Đến đây là kết thúc cấu hình kết nối để đồng bộ thông tin thành công giữa Abaha và sapo omni.
Last updated