Tạo Product QR Code từ Pango Model

Hướng dẫn tính năng tự động tạo Product QR Code trong Batch từ Pango Model chứa QR code có sẵn

Giới thiệu

Tính năng mới cho phép hệ thống tự động tạo và cập nhật mã QR sản phẩm trên Pango Activation dựa vào dữ liệu có sẵn trong Pango Model. Chỉ cần dữ liệu trong Model có các thông tin như mã sản phẩm và ngày hết hạn, hệ thống sẽ tự động đẩy sang Activation để tạo hoặc cập nhật mã QR tương ứng.

Nhờ đó, đội ngũ vận hành không cần thao tác thủ công hay nhập dữ liệu nhiều lần — tất cả được đồng bộ hóa giữa Pango Model và Activation thông qua Webhook kết nối tự động.

Tính năng này giúp:

• Giảm thời gian xử lý khi tạo mã QR số lượng lớn

• Đảm bảo dữ liệu Product QR Code giữa các hệ thống luôn đồng nhất - tránh các sai sót trong vận hành

• Dễ dàng thiết lập, theo dõi và kiểm tra kết quả trực tiếp trên giao diện Activation

Nội dung cần chuẩn bị

• Dữ liệu Pango Model có sẵn các trường: mã QR Code và ngày hết hạn (expiredDay)

• Batch Product QR Code được tạo sẵn trên Activation để nhận dữ liệu

• Token API để sử dụng trong việc tạo kết nối giữa hệ thống Pango Webhook và Pango Activations (sử dụng tài khoản App Connect để tạo)

Hướng dẫn thực hiện

Cấu hình Pango Webhook tích hợp với hệ thống Pango Activation để đẩy dữ liệu vào Batch tạo mã Product QR.

• Tạo Webhook và cấu hình Authentication Type loại: Pango App Connector

  

• Sau khi tạo Webhook, cấu hình Extend Parameters ⇒ lưu ý các trường thông tin đặc biệt dưới dây

  • Header Parameters: nhập cấu trúc đúng để khai báo Org như sau: orgId::{ your-orgID }

• Thiết lập Connection Setting với các cấu hình sau:

  • Token Field : accessToken

  • Endpoint: theo cấu trúc https://act-svc.mydatalakes.com/api/External/IngestProductQrs/{ your-batchProductQRId }

    • your-batchProductQRId: thông tin ID của Batch Product QR Code được dùng để chứa mã QR Code được tạo ra trên Activation (nếu chưa có, hãy tạo sẵn)

  • Method: Post - đẩy dữ liệu từ Pango Model qua Pango Activation

• Thiết lập Webhook Event để push data từ Pango Model sang - hệ thống sẽ lấy hai field

  • code: mã dùng để tạo Product QR Code, định dạng String

  • expiryDate: ngày hết hạn, định dạng String, format Timestamp

• Đặt thời gian đẩy dữ liệu từ Pango Model sang Activation: Batch Product QR Code để tạo mã theo lịch định kỳ hoặc ngay lập tức

• Hệ thống tự xử lý và tạo mã tương ứng trên Batch Product QR Code

• Kiểm tra lại trên Activation để đảm bảo tạo được mã tương ứng thành công

Một số lưu ý trong quá trình sử dụng tính năng:

• Hệ thống kiểm tra Code trước khi tạo mới - nếu trùng code đã có trong Batch sẽ không thể tạo

• Nếu không truyền ExpiryDate ⇒ hệ thống sẽ mặc định "null" nghĩa là mã sẽ không có ngày hết hạn sử dụng

• Truyền thêm ExpiryDate theo Code đã tồn tại để cập nhật lại ngày hết hạn, lưu ý chỉ áp dụng dành cho các mã ở trạng thái Issued ⇒ đã phát hoặc sử dụng rồi không thể cập nhật.