Tạo đơn hàng
Đồng bộ đơn hàng ecommerce với Brevo để tự động tính điểm thân thiết, cập nhật hạng khách hàng và kích hoạt các chiến dịch marketing được cá nhân hóa.
Bắt đầu nhanh
Tạo đơn hàng cơ bản
POST https://api.brevo.com/v3/ecommerce/ordersContent-Type: application/jsonapi-key: YOUR_API_KEY
{ "id": "ORD-2024-001", "billing": { "address": "123 Main St", "city": "New York", "country": "US", "phone": "+1234567890" }, "products": [ { "id": "PROD-123", "name": "Premium Widget", "quantity": 2, "price": 149.99, "category": ["Electronics", "Gadgets"] } ], "revenue": 309.97, "date": "2024-01-25T14:30:00Z"}Phản hồi
{ "id": "ORD-2024-001", "created": true, "loyaltyPointsAwarded": 310}Tích hợp Tajo Loyalty
Đơn hàng có tính điểm thân thiết
{ "id": "ORD-2024-001", "customerId": "CUST-12345", "loyaltyId": "LYL-2024-001",
"billing": { "name": "John Doe", "address": "123 Main St", "city": "New York", "state": "NY", "country": "US", "zipCode": "10001", "phone": "+1234567890" },
"shipping": { "name": "John Doe", "address": "456 Oak Ave", "city": "Brooklyn", "state": "NY", "country": "US", "zipCode": "11201", "method": "Standard Shipping", "cost": 9.99 },
"products": [ { "id": "PROD-123", "name": "Smart Watch Pro", "variant": "Black/42mm", "sku": "SW-PRO-BLK-42", "quantity": 1, "price": 299.99, "category": ["Electronics", "Wearables"], "brand": "TechBrand", "loyaltyPointsEarned": 300, "loyaltyMultiplier": 1.0 }, { "id": "PROD-456", "name": "Wireless Charger", "sku": "WC-FAST-01", "quantity": 1, "price": 49.99, "category": ["Electronics", "Accessories"], "loyaltyPointsEarned": 50, "loyaltyMultiplier": 1.0 } ],
"financial": { "subtotal": 349.98, "shipping": 9.99, "tax": 28.00, "discount": 35.00, "total": 352.97, "currency": "USD", "paymentMethod": "Credit Card", "paymentStatus": "Completed" },
"loyalty": { "pointsEarned": 353, "bonusPoints": 50, "pointsMultiplier": 1.2, "tierBefore": "Silver", "tierAfter": "Gold", "tierUpgraded": true, "totalPointsBalance": 2853, "couponUsed": "SAVE10", "couponDiscount": 35.00 },
"metadata": { "source": "Website", "campaign": "Summer Sale", "referrer": "Google Ads", "userAgent": "Mobile App", "firstPurchase": false, "returningCustomer": true },
"date": "2024-01-25T14:30:00Z", "status": "Completed"}Tính năng thân thiết nâng cao
Đơn hàng thưởng sinh nhật
{ "loyalty": { "pointsEarned": 200, "birthdayBonus": 500, "bonusReason": "Birthday Month", "totalBonusPoints": 500, "pointsMultiplier": 2.0, "specialOffer": "Double Points Week" }}Đơn hàng giới thiệu
{ "loyalty": { "pointsEarned": 150, "referralBonus": 250, "referredBy": "CUST-67890", "referralCode": "REF-FRIEND50", "firstPurchaseBonus": 100 }, "metadata": { "isReferralOrder": true, "referralSource": "Friend Referral" }}Đơn hàng đăng ký định kỳ
{ "subscription": { "id": "SUB-2024-001", "type": "Monthly", "frequency": 30, "nextBilling": "2024-02-25", "isRecurring": true }, "loyalty": { "pointsEarned": 100, "subscriptionBonus": 50, "loyaltyMultiplier": 1.1 }}Danh mục sản phẩm cho chương trình thân thiết
Hệ số nhân điểm theo danh mục
{ "products": [ { "id": "PROD-LUXURY-001", "category": ["Luxury", "Fashion"], "loyaltyMultiplier": 2.0, "loyaltyPointsEarned": 400 }, { "id": "PROD-ECO-001", "category": ["Eco-Friendly", "Sustainable"], "loyaltyMultiplier": 1.5, "loyaltyBonus": "Eco Warrior" } ]}Cập nhật trạng thái đơn hàng
Hoàn tất giao vận đơn hàng
{ "id": "ORD-2024-001", "status": "Shipped", "tracking": { "number": "TRK123456789", "carrier": "UPS", "url": "https://tracking.ups.com/TRK123456789" }, "fulfillment": { "date": "2024-01-26T10:00:00Z", "warehouse": "NYC-01", "method": "Ground Shipping" }}Hoàn thành đơn hàng
{ "id": "ORD-2024-001", "status": "Delivered", "delivery": { "date": "2024-01-28T16:30:00Z", "signature": "Customer", "location": "Front Door" }, "loyalty": { "reviewIncentive": 25, "reviewIncentiveExpiry": "2024-02-28" }}Xử lý đơn hàng theo lô
Tạo nhiều đơn hàng để đồng bộ hàng loạt:
{ "orders": [ { "id": "ORD-2024-001", "products": [...], "revenue": 199.99 }, { "id": "ORD-2024-002", "products": [...], "revenue": 299.99 } ]}Xử lý lỗi
{ "code": "duplicate_order", "message": "Order ID already exists", "details": { "orderId": "ORD-2024-001", "existingDate": "2024-01-25T14:30:00Z" }}{ "code": "invalid_customer", "message": "Customer email not found", "details": { "suggestion": "Create contact first" }}Tích hợp webhook
Thiết lập webhook để đồng bộ các thay đổi trạng thái đơn hàng:
{ "webhookUrl": "https://your-tajo-app.com/webhooks/brevo", "events": [ "order.created", "order.updated", "order.shipped", "order.delivered", "loyalty.points.awarded" ]}Thực hành tốt nhất cho Tajo
- Đồng bộ theo thời gian thực: Tạo đơn hàng ngay sau khi khách hoàn tất checkout
- Dữ liệu đầy đủ: Đưa vào mọi thông tin liên quan tới chương trình thân thiết
- Cập nhật trạng thái: Giữ trạng thái đơn hàng luôn mới để theo dõi chính xác
- Khôi phục sau lỗi: Xử lý khéo léo các đơn hàng trùng lặp và khách hàng chưa tồn tại
- Tính điểm: Xác minh cách tính điểm thân thiết khớp với hệ thống của bạn
- Phân khúc khách hàng: Dùng dữ liệu đơn hàng cho các chiến dịch nhắm mục tiêu
Phân tích và báo cáo
Theo dõi các chỉ số quan trọng:
- Xu hướng giá trị đơn hàng
- Tỷ lệ đổi điểm thân thiết
- Giá trị vòng đời khách hàng
- Mô hình nâng hạng
- Hiệu quả chiến dịch
Bước tiếp theo
- Cập nhật trạng thái đơn hàng
- Thiết lập chương trình khách hàng thân thiết
- Cấu hình quy tắc tính điểm
- Tạo danh mục sản phẩm