Създаване на поръчка
Синхронизирайте поръчките от електронния си магазин с Brevo, за да изчислявате автоматично точки за лоялност, да актуализирате нивата на клиентите и да задействате персонализирани маркетингови кампании.
Бърз старт
Създаване на основна поръчка
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"}Отговор
{ "id": "ORD-2024-001", "created": true, "loyaltyPointsAwarded": 310}Интеграция с лоялността на Tajo
Поръчка с изчисляване на лоялност
{ "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"}Разширени функции за лоялност
Поръчка с бонус за рожден ден
{ "loyalty": { "pointsEarned": 200, "birthdayBonus": 500, "bonusReason": "Birthday Month", "totalBonusPoints": 500, "pointsMultiplier": 2.0, "specialOffer": "Double Points Week" }}Поръчка от препоръка
{ "loyalty": { "pointsEarned": 150, "referralBonus": 250, "referredBy": "CUST-67890", "referralCode": "REF-FRIEND50", "firstPurchaseBonus": 100 }, "metadata": { "isReferralOrder": true, "referralSource": "Friend Referral" }}Абонаментна поръчка
{ "subscription": { "id": "SUB-2024-001", "type": "Monthly", "frequency": 30, "nextBilling": "2024-02-25", "isRecurring": true }, "loyalty": { "pointsEarned": 100, "subscriptionBonus": 50, "loyaltyMultiplier": 1.1 }}Продуктови категории за лоялност
Множители на точките според категорията
{ "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" } ]}Актуализации на статуса на поръчката
Изпълнение на поръчката
{ "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" }}Приключване на поръчката
{ "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" }}Пакетна обработка на поръчки
Създайте няколко поръчки наведнъж за масова синхронизация:
{ "orders": [ { "id": "ORD-2024-001", "products": [...], "revenue": 199.99 }, { "id": "ORD-2024-002", "products": [...], "revenue": 299.99 } ]}Обработка на грешки
{ "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" }}Интеграция с webhook
Настройте webhook, за да синхронизирате промените в статуса на поръчките:
{ "webhookUrl": "https://your-tajo-app.com/webhooks/brevo", "events": [ "order.created", "order.updated", "order.shipped", "order.delivered", "loyalty.points.awarded" ]}Добри практики за Tajo
- Синхронизация в реално време: създавайте поръчките веднага след плащането
- Пълни данни: включвайте цялата информация, свързана с лоялността
- Актуализации на статуса: поддържайте статуса на поръчката актуален за точно проследяване
- Възстановяване след грешка: обработвайте коректно дублираните поръчки и липсващите клиенти
- Изчисляване на точките: проверявайте дали изчислените точки за лоялност съвпадат с Вашата система
- Сегментиране на клиентите: използвайте данните за поръчките за таргетирани кампании
Анализи и отчети
Проследявайте ключовите показатели:
- Тенденции в стойността на поръчките
- Проценти на осребряване на точките за лоялност
- Стойност на клиента за целия период на връзката
- Модели на преминаване към по-високо ниво
- Ефективност на кампаниите
Следващи стъпки
- Актуализиране на статуса на поръчка
- Настройване на програми за лоялност
- Конфигуриране на правила за точките
- Създаване на продуктови категории