Tham chiếu: Nhân viên và vai trò

Danh sách nhân viên và vai trò để chọn người phụ trách khi tạo đơn hoặc đổi phân công đơn. Mọi đường dẫn dưới https://danix.vn/api/open/v1. Đặc tả máy đọc: openapi.json.

Danh sách nhân viên

GET /staff

Các nhân viên đang làm việc trong shop (không gồm tài khoản hệ thống, ứng dụng kết nối hay người bị vô hiệu hoá), chỉ mã và tên. Dùng id làm handlerUserId khi tạo đơn hay đổi người phụ trách. Người nào chọn được làm người phụ trách còn tuỳ quyền sửa đơn của họ — chọn người không dùng được thì tạo đơn chia theo bậc dưới, đổi người phụ trách thì validation-failed.

Quyền cần có: khoá có quyền pos.orders.create.

Ví dụ yêu cầu

curl -X GET "https://danix.vn/api/open/v1/staff" \
  -H "Authorization: Bearer dnx_live_…"

Phản hồi mẫu (200)

{
  "data": [
    {
      "id": "018f3b8e-1c2d-7a4b-9c3d-000000000a01",
      "name": "Nguyễn Văn An"
    }
  ]
}

Trường của phản hồi

Lỗi

Định dạng lỗi và bảng mọi mã code: Lỗi.

Danh sách vai trò

GET /roles

Các vai trò của shop (không gồm vai trò của ứng dụng kết nối), chỉ mã và tên. Dùng id làm handlerRoleId khi tạo đơn: đơn chia lần lượt cho những người của vai trò ấy có quyền sửa đơn.

Quyền cần có: khoá có quyền pos.orders.create.

Ví dụ yêu cầu

curl -X GET "https://danix.vn/api/open/v1/roles" \
  -H "Authorization: Bearer dnx_live_…"

Phản hồi mẫu (200)

{
  "data": [
    {
      "id": "018f3b8e-1c2d-7a4b-9c3d-000000000b01",
      "name": "Bán hàng"
    }
  ]
}

Trường của phản hồi

Lỗi

Định dạng lỗi và bảng mọi mã code: Lỗi.