--- title: "주문 생성 | Tajo" description: "로열티 포인트 계산과 고객 인게이지먼트를 위해 이커머스 주문을 Brevo와 동기화합니다" url: https://tajo.io/kr/docs/ecommerce-loyalty/orders/create-order/ markdown: https://tajo.io/kr/docs/ecommerce-loyalty/orders/create-order.md lang: ko-KR author: "Set Noa" author_url: https://tajo.io/kr/set-noa/ robots: noindex --- Tajo 사전 이용 신청 이름과 회사 이메일 주소를 입력하세요. Tajo 이용 신청을 확인할 수 있는 링크를 이메일로 보내드립니다. # 주문 생성 [Set Noa](https://tajo.io/kr/set-noa/) 이커머스 주문을 Brevo와 동기화하면 로열티 포인트가 자동으로 계산되고, 고객 등급이 갱신되며, 개인화된 마케팅 캠페인이 실행됩니다. ## 빠른 시작 ### 기본 주문 생성 ```http POST https://api.brevo.com/v3/ecommerce/orders Content-Type: application/json api-key: YOUR_API_KEY { "id": "ORD-2024-001", "email": "customer@example.com", "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" } ``` ### 응답 ```json { "id": "ORD-2024-001", "created": true, "loyaltyPointsAwarded": 310 } ``` ## Tajo 로열티 연동 ### 로열티 계산이 포함된 주문 ```json { "id": "ORD-2024-001", "email": "customer@example.com", "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" } ``` ## 고급 로열티 기능 ### 생일 보너스 주문 ```json { "loyalty": { "pointsEarned": 200, "birthdayBonus": 500, "bonusReason": "Birthday Month", "totalBonusPoints": 500, "pointsMultiplier": 2.0, "specialOffer": "Double Points Week" } } ``` ### 추천 주문 ```json { "loyalty": { "pointsEarned": 150, "referralBonus": 250, "referredBy": "CUST-67890", "referralCode": "REF-FRIEND50", "firstPurchaseBonus": 100 }, "metadata": { "isReferralOrder": true, "referralSource": "Friend Referral" } } ``` ### 구독 주문 ```json { "subscription": { "id": "SUB-2024-001", "type": "Monthly", "frequency": 30, "nextBilling": "2024-02-25", "isRecurring": true }, "loyalty": { "pointsEarned": 100, "subscriptionBonus": 50, "loyaltyMultiplier": 1.1 } } ``` ## 로열티용 상품 카테고리 ### 카테고리 기반 포인트 배수 ```json { "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" } ] } ``` ## 주문 상태 업데이트 ### 주문 처리 ```json { "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" } } ``` ### 주문 완료 ```json { "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" } } ``` ## 일괄 주문 처리 대량 동기화를 위해 여러 주문을 한 번에 생성합니다. ```json { "orders": [ { "id": "ORD-2024-001", "email": "customer1@example.com", "products": [...], "revenue": 199.99 }, { "id": "ORD-2024-002", "email": "customer2@example.com", "products": [...], "revenue": 299.99 } ] } ``` ## 오류 처리 ```json { "code": "duplicate_order", "message": "Order ID already exists", "details": { "orderId": "ORD-2024-001", "existingDate": "2024-01-25T14:30:00Z" } } ``` ```json { "code": "invalid_customer", "message": "Customer email not found", "details": { "email": "unknown@example.com", "suggestion": "Create contact first" } } ``` ## 웹훅 연동 주문 상태 변경을 동기화하도록 웹훅을 설정합니다. ```json { "webhookUrl": "https://your-tajo-app.com/webhooks/brevo", "events": [ "order.created", "order.updated", "order.shipped", "order.delivered", "loyalty.points.awarded" ] } ``` ## Tajo 운영 권장 사항 1. **실시간 동기화**: 체크아웃 직후에 주문을 생성합니다 2. **완전한 데이터**: 로열티와 관련된 모든 정보를 포함합니다 3. **상태 업데이트**: 정확한 추적을 위해 주문 상태를 항상 최신으로 유지합니다 4. **오류 복구**: 중복 주문과 존재하지 않는 고객을 안정적으로 처리합니다 5. **포인트 계산**: 로열티 포인트 계산 결과가 자체 시스템과 일치하는지 확인합니다 6. **고객 세그먼트**: 주문 데이터를 활용해 타깃 캠페인을 실행합니다 ## 분석 및 리포팅 주요 지표를 추적합니다. - 주문 금액 추이 - 로열티 포인트 사용률 - 고객 생애 가치 - 등급 상승 패턴 - 캠페인 성과 ## 다음 단계 - 주문 상태 업데이트 - 로열티 프로그램 설정 - 포인트 규칙 구성 - 상품 카테고리 생성