주문 생성
이커머스 주문을 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" }}웹훅 연동
주문 상태 변경을 동기화하도록 웹훅을 설정합니다.
{ "webhookUrl": "https://your-tajo-app.com/webhooks/brevo", "events": [ "order.created", "order.updated", "order.shipped", "order.delivered", "loyalty.points.awarded" ]}Tajo 운영 권장 사항
- 실시간 동기화: 체크아웃 직후에 주문을 생성합니다
- 완전한 데이터: 로열티와 관련된 모든 정보를 포함합니다
- 상태 업데이트: 정확한 추적을 위해 주문 상태를 항상 최신으로 유지합니다
- 오류 복구: 중복 주문과 존재하지 않는 고객을 안정적으로 처리합니다
- 포인트 계산: 로열티 포인트 계산 결과가 자체 시스템과 일치하는지 확인합니다
- 고객 세그먼트: 주문 데이터를 활용해 타깃 캠페인을 실행합니다
분석 및 리포팅
주요 지표를 추적합니다.
- 주문 금액 추이
- 로열티 포인트 사용률
- 고객 생애 가치
- 등급 상승 패턴
- 캠페인 성과
다음 단계
- 주문 상태 업데이트
- 로열티 프로그램 설정
- 포인트 규칙 구성
- 상품 카테고리 생성