API Tích Hợp Locker Thông Minh: Kết Nối Với Hệ Thống Logistics Và ERP

Tủ locker thông minh không phải thiết bị độc lập — giá trị thực sự đến từ khả năng tích hợp với hệ thống xung quanh: quản lý đơn hàng, CRM, ứng dụng mobile, và hạ tầng IT hiện có của doanh nghiệp.

API (Application Programming Interface) là lớp kết nối cho phép tủ locker thông minh "nói chuyện" với các hệ thống khác. Một hệ thống locker không có API mở buộc doanh nghiệp phải quản lý thủ công — ngược lại, locker có API đầy đủ có thể hoạt động hoàn toàn tự động trong quy trình nghiệp vụ hiện có.

Kiến Trúc Hệ Thống Locker Có API

[Hệ thống bên ngoài] ←→ [API Gateway Locker] ←→ [Locker Controller] ←→ [Phần cứng Locker]
         ↑                         ↑
  ERP/WMS/OMS                 Dashboard quản lý
  App mobile người dùng        Webhook/notification
  Hệ thống vận chuyển

API Gateway Locker là điểm trung tâm xử lý:

• Xác thực (API key hoặc OAuth 2.0)
• Rate limiting
• Routing đến locker cụ thể theo serial number
• Logging và audit trail

Các API Endpoint Cốt Lõi

1. Quản Lý Đặt Chỗ (Reservation)

POST /api/v1/reservations
{
  "locker_id": "LOC-001",
  "size": "M",
  "duration_hours": 48,
  "recipient_phone": "0901234567",
  "order_ref": "GHN-123456"
}
→ Response: { "cell_id": "LOC-001-B3", "access_code": "847291", "expires_at": "..." }

Cho phép hệ thống logistics đặt trước ô locker trước khi shipper đến giao hàng.

2. Xác Nhận Giao Hàng

POST /api/v1/deliveries
{
  "reservation_id": "RES-789",
  "shipper_id": "SHP-456"
}
→ Mở ô, ghi nhận thời gian giao, kích hoạt thông báo người nhận

3. Nhận Hàng (Pickup)

POST /api/v1/pickups
{
  "cell_id": "LOC-001-B3",
  "otp": "847291"
}
→ Xác thực OTP, mở ô, ghi nhận hoàn thành giao hàng

4. Trạng Thái Real-Time

GET /api/v1/lockers/{locker_id}/status
→ {
    "total_cells": 50,
    "available": 23,
    "occupied": 24,
    "out_of_service": 3,
    "cells": [{...}]
  }

5. Webhook Sự Kiện

Locker push notification về hệ thống bên ngoài khi có sự kiện:

• delivery.completed — hàng đã được đặt vào locker
• pickup.completed — người nhận đã lấy hàng
• reservation.expired — hết thời hạn, hàng chưa được lấy
• cell.fault — ô có lỗi kỹ thuật

Tích Hợp Với Hệ Thống Thực Tế

Tích Hợp Với Đơn Vị Vận Chuyển (GHN, GHTK, J&T)

Khi đơn hàng được assign cho shipper:

1. Hệ thống OMS gọi API locker tạo reservation
2. Shipper app nhận thông tin: "Giao vào locker LOC-001, ô B3 đã được đặt sẵn"
3. Shipper đến, quét mã → ô mở tự động
4. Hệ thống cập nhật trạng thái đơn hàng qua webhook

Tích Hợp Với App Mobile

Người dùng nhận thông báo từ app thương hiệu (không phải app locker riêng):

• App gọi API locker để kiểm tra trạng thái hàng
• Khi đến locker, app tạo QR code tạm thời qua API
• Quét QR → mở ô (không cần nhập OTP thủ công)

Tích Hợp Với Hệ Thống Tòa Nhà (BMS)

Locker có thể kết nối với hệ thống BMS:

• Dùng thẻ RFID tòa nhà để mở locker (một thẻ đa năng)
• Báo cáo sử dụng tích hợp vào dashboard BMS
• Cảnh báo kỹ thuật locker hiển thị trên màn hình quản lý tòa nhà

Yêu Cầu Kỹ Thuật Khi Chọn Nhà Cung Cấp Locker

Trước khi mua hệ thống locker, đặt câu hỏi:

1. Tài liệu API: Có Swagger/OpenAPI spec không? Sandbox để test không?
2. Xác thực: API key hay OAuth 2.0? Có hỗ trợ multi-tenant không?
3. SLA uptime API: 99.9% hay cao hơn? Có SLA endpoint riêng không?
4. Webhook reliability: Retry logic nếu endpoint của bên nhận down?
5. Rate limit: Bao nhiêu request/phút? Phù hợp với quy mô doanh nghiệp?

Liên hệ TSE Vending để nhận tài liệu API, sandbox access và tư vấn phương án tích hợp locker thông minh với hệ thống hiện có của doanh nghiệp bạn.