Cài Đặt Hệ Thống & Tích Hợp API

Quản lý khóa API, cổng tiếp nhận đơn hàng tự động từ website namdung.com và webhook hãng vận chuyển.

Cổng Tiếp Nhận Lead & Đơn Hàng (namdung.com)

Form đặt hàng trên landing page gửi POST về URL này để tự động tạo đơn

Endpoint tiếp nhận:

POSThttps://crm.namdung.com/api/lead-intake

Header xác thực:

x-api-key: namdung_secret_api_key_2026

Mẫu dữ liệu JSON gửi lên:

{
  "customer_name": "Nguyễn Thị Hương Lan",
  "customer_phone": "0988123456",
  "province": "Hà Nội",
  "district": "Hà Đông",
  "ward": "Quang Trung",
  "address": "Số 18 Ngõ 45 Đường Quang Trung",
  "baby_name": "Bé Bon",
  "baby_birthdate": "2026-04-15",
  "baby_gender": "boy",
  "items": [
    { "name": "Sữa bột Meiji số 0 (800g)", "quantity": 2, "price": 545000, "amount": 1090000 }
  ],
  "subtotal": 1090000,
  "shipping_fee": 30000,
  "notes": "Khách đặt từ form website namdung.com"
}

Webhook Cập Nhật Trạng Thái ĐVVC (Viettel Post, GHTK, GHN)

Khi shipper giao thành công hoặc đối soát tiền COD, bưu cục tự động gọi webhook này

Webhook URL đăng ký trên cổng ĐVVC:

POSThttps://crm.namdung.com/api/webhooks/shipping

Mẫu Payload ĐVVC gửi sang:

{
  "tracking_code": "VT261031980VN",
  "carrier": "viettel_post",
  "status": "delivered", // 'in_transit' | 'delivered' | 'reconciled' | 'returned'
  "cod_collected": 1495000
}

Cơ Sở Dữ Liệu Supabase (Kit Next.js CRM Standard)

4 bảng cố định: workspaces, profiles, subscriptions và records (doc JSONB + GIN index)

Tất cả schema SQL đã sẵn sàng trong file schema.sql tại thư mục gốc của dự án.

Chạy file schema.sql trên Supabase SQL Editor một lần duy nhất để thiết lập toàn bộ bảng, chỉ mục GIN, Row Level Security (RLS) và bộ dữ liệu mẫu NamDung.