Chuyển tới nội dung chính

API Quản lý Dữ liệu Cốt lõi

Tài liệu các endpoint dành cho Quản lý (Partner) để quản lý (Thêm/Sửa/Xóa) các dữ liệu cốt lõi bao gồm Chi nhánh, Nhân viên, Thẻ thành viên, và Phân hạng.

1. Quản lý Chi nhánh​

1.1 Lấy danh sách Chi nhánh​

  • Method: GET
  • Endpoint: /api/{locale}/v1/partner/clubs
  • Auth: auth:partner_api

1.2 Lấy danh sách Chi nhánh CukCuk​

  • Method: GET
  • Endpoint: /api/{locale}/v1/partner/cukcuk-branches
  • Auth: auth:partner_api

1.3 Tạo Chi nhánh mới​

  • Method: POST
  • Endpoint: /api/{locale}/v1/partner/clubs
  • Body: name, is_active, cukcuk_branch_id

1.4 Cập nhật / Liên kết CukCuk​

  • Method: PUT
  • Endpoint: /api/{locale}/v1/partner/clubs/{id}

1.5 Xóa Chi nhánh​

  • Method: DELETE
  • Endpoint: /api/{locale}/v1/partner/clubs/{id}

2. Quản lý Nhân viên​

2.1 Lấy danh sách Nhân viên​

  • Method: GET
  • Endpoint: /api/{locale}/v1/partner/staff

2.2 Thêm Nhân viên mới​

  • Method: POST
  • Endpoint: /api/{locale}/v1/partner/staff

2.3 Cập nhật Nhân viên​

  • Method: PUT
  • Endpoint: /api/{locale}/v1/partner/staff/{id}

2.4 Xóa Nhân viên​

  • Method: DELETE
  • Endpoint: /api/{locale}/v1/partner/staff/{id}

3. Quản lý Thẻ Thành viên​

3.1 Lấy danh sách Thẻ​

  • Method: GET
  • Endpoint: /api/{locale}/v1/partner/cards

3.2 Tạo mẫu Thẻ mới​

  • Method: POST
  • Endpoint: /api/{locale}/v1/partner/cards
  • Body: multipart/form-data (Hỗ trợ upload ảnh logo, background)

3.3 Cập nhật mẫu Thẻ​

  • Method: POST (với _method=PUT) hoặc PUT
  • Endpoint: /api/{locale}/v1/partner/cards/{id}

4. Quản lý Hạng Thành viên​

4.1 Lấy danh sách Hạng​

  • Method: GET
  • Endpoint: /api/{locale}/v1/partner/clubs/{clubId}/tiers

4.2 Thêm/Sửa/Xóa Hạng Thành viên​

  • Các thao tác cấu hình điều kiện lên hạng, mức chiết khấu và thiết kế thẻ.
  • Endpoint CRUD: /api/{locale}/v1/partner/clubs/{clubId}/tiers/{tierId}

5. Quản lý Voucher​

5.1 Lấy danh sách Voucher​

  • Method: GET
  • Endpoint: /api/{locale}/v1/partner/vouchers

5.2 Tạo Voucher​

  • Method: POST
  • Endpoint: /api/{locale}/v1/partner/vouchers

5.3 Cập nhật / Kích hoạt / Hủy Voucher​

  • Method: PUT
  • Endpoint: /api/{locale}/v1/partner/vouchers/{id}

5.4 Xóa Voucher​

  • Method: DELETE
  • Endpoint: /api/{locale}/v1/partner/vouchers/{id}