CRM, Commerce, Bookings & Privacy
CRM & Chống gộp nhầm liên hệ
Phần tiêu đề “CRM & Chống gộp nhầm liên hệ”POST /v1/customer-upsertsupsert theo{namespace, external_id}.- Không bao giờ tự động gộp khách hàng mới chỉ vì trùng SĐT/email chưa xác minh; hỗ trợ gộp tường minh
POST /v1/customer-merges(hỗ trợdry_run: true). - Trạng thái consent
opted_outchặn tin nhắn marketing và loại khách hàng khỏiPOST /v1/campaigns/{id}/dry-runs&/sends.
Inventory, Orders, Payments & Bookings
Phần tiêu đề “Inventory, Orders, Payments & Bookings”POST /v1/inventory-reservationsvàPOST /v1/orderskhóa dòng (row-lock) chống bán quá tồn kho (409 INSUFFICIENT_STOCK).- Để chuyển lượt giữ hàng thành đơn, truyền
reservation_idcòn hiệu lực của cùng tích hợp và đúng sản phẩm, biến thể, số lượng. Lệnh commit riêng trừ tồn kho ngay. PATCH /v1/orders/{id}chỉ cho phép sửa metadata/ghi chú/địa chỉ; chuyển trạng thái qua command/confirmations,/cancellations,/fulfillments. Hủy đơn hoàn tồn kho idempotent.- Ghi nhận thanh toán thủ công qua
POST /v1/orders/{id}/manual-payment-recordsvới scopepayments:recordvà currency của đơn. Tạo yêu cầu hoàn tiền quaPOST /v1/orders/{id}/refundsvới scopepayments:refund. Sau khi tiền đã được hoàn ở hệ thống thanh toán, ghi mã đối chiếu quaPOST /v1/refunds/{id}/confirmations. POST /v1/bookingskiểm tra sức chứa theo timezone UTC chuẩn xác và vô hiệu hóa reminder cũ khi reschedule/hủy lịch.
Privacy Erasure & Deletion Ledger
Phần tiêu đề “Privacy Erasure & Deletion Ledger”POST /v1/data-erasure-requestskiểm tra legal hold trước khi xóa PII và ghi nhận SHA-256 hashes (không lưu PII thô) vàodeletion_ledger.- Sau khi khôi phục backup database, vận hành viên chạy
php artisan public-api:replay-deletionsđể tự động xóa lại dữ liệu đã từng yêu cầu xóa.
Client Chat
Phần tiêu đề “Client Chat”Backend cấp tp_cs_* qua POST /v1/client-sessions. Phiên khách ẩn danh mới bắt đầu với lịch sử riêng. Để nối lại lịch sử của khách đã xác thực, backend dùng bearer workspace làm khóa HMAC-SHA256 và ký chuỗi SHA-256 dạng hex của JSON có các khóa channel, customer, integration, visitor, workspace theo thứ tự chữ cái. Dùng public ID từ API và giữ giá trị null cho channel hoặc customer còn trống. Gửi chữ ký hex trong identity_proof và khai báo allowed_origin cho widget trình duyệt.
