1. Tổng quan
Bài viết này hướng dẫn anh/chị cách lấy API Key của ứng dụng Pancake trên hệ thống. Việc lấy mã này là bước bắt buộc để thực hiện kết nối, cho phép đồng bộ dữ liệu giữa Pancake và các hệ thống quản lý khác (như MISA eShop) nhằm tự động hóa quy trình bán hàng và quản lý đơn hàng.
Nội dung gồm:
- Truy cập mục Cấu hình ứng dụng bên thứ 3.
- Thiết lập ứng dụng Webhook/API cho Pancake.
- Tạo và sao chép API Key.
Đối tượng áp dụng: Quản trị viên hệ thống, nhân viên phụ trách tích hợp phần mềm.
2. Hướng dẫn thực hiện
2.1. Truy cập mục kết nối ứng dụng bên thứ 3
Để bắt đầu quá trình thiết lập kết nối, anh/chị thực hiện các bước sau:
- Bước 1: Tại menu danh mục bên trái, anh/chị nhấn vào mục [Cấu hình].
- Bước 2: Tại màn hình Cấu hình chung, anh/chị tìm đến nhóm [Đối tác], sau đó nhấn vào mục [Đối tác chuyển] (hoặc mục tương ứng với tích hợp bên thứ 3).
- Bước 3: Tại nhóm [Nâng cao], anh/chị tìm thấy mục [Tích hợp bên thứ 3] và nhấn vào đó để xem danh sách các ứng dụng có thể kết nối.
2.2. Thiết lập ứng dụng Webhook/API cho Pancake
Sau khi vào danh sách tích hợp, anh/chị cần chọn đúng ứng dụng để quản lý mã kết nối.
- Bước 1: Tại danh sách các ứng dụng, anh/chị tìm ứng dụng có tên [Webhook/API – Pancake].
- Bước 2: Nhấn vào nút [Chi tiết] ngay dưới tên ứng dụng để mở cửa sổ thiết lập cấu hình Webhook – API.
- Bước 3: Tại cửa sổ hiện ra, anh/chị chọn tab [API Key] ở thanh menu phía trên.
2.3. Tạo và lấy API Key
Sau khi đã ở tab API Key, anh/chị tiến hành tạo mã mới để sử dụng.
- Bước 1: Nhấn nút [+ Thêm mới] để khởi tạo một mã API Key mới.
- Bước 2: Tại dòng vừa được tạo, anh/chị quan sát cột [API Key]. Nhấn vào biểu tượng [Sao chép] (hình hai tờ giấy chồng lên nhau) ở cuối dòng để lấy mã.
Sau khi hoàn tất, anh/chị có thể sử dụng mã này để nhập vào phần cấu hình trên Pancake để hoàn tất việc kết nối.
3. Lưu ý
- Bảo mật mã API: API Key là mã định danh quan trọng để các hệ thống “nói chuyện” với nhau. Anh/chị tuyệt đối không cung cấp mã này cho người không có trách nhiệm để tránh việc dữ liệu đơn hàng bị truy cập trái phép.
- Quản lý ghi chú: Khi tạo nhiều API Key, anh/chị nên nhập thông tin vào cột [Ghi chú] (ví dụ: “Key kết nối Pancake tháng 08/2026”) để dễ dàng quản lý và phân biệt các mã nếu cần thay đổi sau này.