Kết nối với các ứng dụng khác qua Open API trên máy tính

1. Tổng quan

Tính năng kết nối Open API để cho phép các phần mềm khác kết nối và sử dụng dữ liệu từ Misa Eshop một cách an toàn.

Phạm vi áp dụng: Hiện tại phần mềm đang đáp ứng kết nối với phần mềm Bravo.

2. Các bước thực hiện

2.1. Thêm ứng dụng

Bước 1: Tại màn hình tổng quan, chọn Ứng dụng/Open API

Bước 2: Nhấn Thêm kết nối API mới

Bước 3: Nhập thông tin kết nối

• Tên ứng dụng kết nối (Bắt buộc): Điền tên ứng dụng của đối tác kết nối
  • Lưu ý: Hiện tại phần mềm đang đáp ứng kết nối với phần mềm Bravo.
• Tên đơn vị phát triển: Nhập tên đơn vị phát triển phần mềm ứng dụng kết nối
• Danh sách IP (Bắt buộc): Điền danh sách địa chỉ IP mà bên thứ 3 sử dụng để kết nối với hệ thống
  • Gồm 4 nhóm số, mỗi nhóm là số từ 0 đến 255 (VD: 192.168.1.100)
  • Tối đa 255 ký tự → khi vượt quá tự động rút ngắn
  • Ký tự hợp lệ: ký tự số, dấu phẩy “,” và dấu chấm phẩy “;”
• Mục đích kết nối: Tối đa 255 ký tự

Bước 4: Nhập Thông tin liên hệ

Mục đích: Thiết lập thông tin liên hệ cho kết nối Open API để đảm bảo nhận cảnh báo sự cố an toàn, kịp thời và đúng người phụ trách khi hệ thống Open API xảy ra sự cố, thay đổi hoặc nâng cấp.

• Tên người liên hệ (Bắt buộc): Nhập họ và tên người phụ trách nhận thông báo
• Số điện thoại: Nhập số điện thoại liên hệ
• Email nhận thông báo (Bắt buộc): Nhập địa chỉ email muốn nhận thông báo

Sau đó nhấn Lưu.

Lưu ý: Một cửa hàng chỉ kết nối được với 1 ứng dụng khác qua Open API.

Bước 5: Xác thực email nhận cảnh báo

Sau khi lưu kết nối, để đảm bảo email hoạt động chính xác, hệ thống sẽ gửi 1 mail xác nhận tới email người nhận đã khai báo.

• Anh/Chị vui lòng kiểm tra hộp thư và xác thực nội dung trong mail
  • Lưu ý: Đường dẫn xác thực chỉ có hiệu lực trong vòng 24h.

• Sau khi xác nhận thành công, trạng thái email liên hệ trên MISA eShop sẽ ở trạng thái Đã xác thực

Sau khi kết nối thành công, ứng dụng khi kết nối sẽ được đồng bộ các dữ liệu từ MISA eShop bao gồm (Phạm vi: Phương pháp tính thuế khấu trừ, đơn hàng từ sàn Shopee, Tiktok Shop):

– Đơn hàng:

• Thông tin chính:
  • ID gian hàng trên sàn: Mã seller_id trên sàn
  • Mã kho eShop
  • Tên kho eShop
  • Mã đơn hàng sàn
  • Mã vận đơn sàn
  • Ngày KH đặt đơn trên sàn
  • Ngày thay đổi đơn hàng ở eShop
  • Tổng số lượng:
    • Tổng SL mặt hàng theo eShop trong đơn, bao gồm cả các mặt hàng tặng
    • T/H là hàng hóa combo thì tính là 1 (không đếm SL hàng hóa thành phần)
  • Đơn vị vận chuyển
  • Trạng thái đơn hàng
  • Tổng tiền hàng trước thuế
  • Tổng tiền hàng sau thuế
  • Tổng tiền chiết khấu trước thuế = Tổng tiền chiết khấu hàng hóa trước thuế + chiết khấu hóa đơn trước thuế
  • Tổng tiền chiết khấu sau thuế
  • Tổng tiền Thuế = Tổng tiền thuế các dòng hàng hóa
  • Tổng thanh toán = Tổng tiền hàng trước thuế – Tổng Tiền chiết khấu + Tổng Tiền thuế
• Thông tin chi tiết đơn hàng:
  • Mã hàng: Model id sàn
  • Mã hàng hóa eShop
  • Tên hàng hóa eShop
  • Là hàng tặng: đánh dấu là hàng tặng hay không
  • Đơn vị tính: Đơn vị tính eShop
  • Số lượng: Số lượng hàng hóa
  • Đơn giá trước thuế: Đơn giá hàng hóa trước thuế
  • Đơn giá sau thuế: Đơn giá hàng hóa sau thuế
  • Thành tiền trước thuế = Đơn giá trước thuế * Số lượng
  • Thành tiền sau thuế = Đơn giá sau thuế * Số lượng
  • Tiền chiết khấu: Tiền chiết khấu hàng hóa
  • %VAT: Thuế suất
  • Tiền Thuế: Tiền thuế
  • Ghi chú: Ghi chú hàng hóa
• Lưu ý:
  • Nếu là hàng hóa trong đơn là combo thì trả về thông tin chi tiết combo và chi tiết hàng hóa thành phần theo các thông tin trên
  • Nếu là hàng hóa có thuộc tính thì trả về hàng hóa thuộc tính với chi tiết thông tin trên

– Thông tin hóa đơn:

• Trạng thái phát hành: Chưa phát hành, Đã phát hành, Phát hành lỗi,

– Thông tin xuất hóa đơn:

• Tên KH
• Địa chỉ
• Email
• MST

– Thông tin hóa đơn đã phát hành:

• Ký hiệu, Mẫu số
• Số hóa đơn
• Ngày hóa đơn

2.2. Sửa kết nối

Bước 1: Nhấn Sửa

Bước 2: Thực hiện sửa thông tin kết nối

• App_id: Không cho phép chỉnh sửa.
• App_key: Hệ thống tự sinh, cho phép tạo lại mã mới.
  • Khi lấy lại mã, sẽ không thể thực hiện sao chép mã mới vừa sinh
• Email: Email đã xác thực không cho phép sửa. Chỉ sửa được email có tình trạng chưa xác thực.
• Các thông tin khác có thể sửa tương tự như khi thêm mới.

2.3. Xóa kết nối

Để xóa kết nối, chọn chức năng Xóa.

• Hệ thống hiển thị cảnh báo trước khi xóa kết nối.

Chúc Anh/Chị thực hiện thành công!