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ừ 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 app (Bắt buộc): Điền tên app của đối tác muốn kết nối, tối đa 50 ký tự.
• 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ô tả: Tối đa 255 ký tự

Sau đó nhấn Kết nối.

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.

Sau khi khi kết nối thành công, các phần mềm 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:

• 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
• 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!