---
title: "Crea Ordine | Tajo"
description: "Sincronizza gli ordini e-commerce con Brevo per il calcolo dei punti fedeltà e il coinvolgimento dei clienti"
url: https://tajo.io/it/docs/ecommerce-loyalty/orders/create-order/
markdown: https://tajo.io/it/docs/ecommerce-loyalty/orders/create-order.md
lang: it-IT
author: "Set Noa"
author_url: https://tajo.io/it/set-noa/
robots: noindex
---

Richiedi l’accesso anticipato

Inserisci il tuo nome e indirizzo email aziendale. Ti invieremo un link per confermare la richiesta di accesso a Tajo.

# Crea Ordine

[Set Noa](https://tajo.io/it/set-noa/)

Sincronizza gli ordini e-commerce con Brevo per calcolare automaticamente i punti fedeltà, aggiornare i livelli dei clienti e attivare campagne di marketing personalizzate.

## Avvio Rapido

### Creazione Ordine Base

```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"
}
```

### Risposta

```json
{
  "id": "ORD-2024-001",
  "created": true,
  "loyaltyPointsAwarded": 310
}
```

## Integrazione Fedeltà Tajo

### Ordine con Calcolo Fedeltà

```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"
}
```

## Funzionalità Fedeltà Avanzate

### Ordine con Bonus Compleanno

```json
{
  "loyalty": {
    "pointsEarned": 200,
    "birthdayBonus": 500,
    "bonusReason": "Birthday Month",
    "totalBonusPoints": 500,
    "pointsMultiplier": 2.0,
    "specialOffer": "Double Points Week"
  }
}
```

### Ordine da Referral

```json
{
  "loyalty": {
    "pointsEarned": 150,
    "referralBonus": 250,
    "referredBy": "CUST-67890",
    "referralCode": "REF-FRIEND50",
    "firstPurchaseBonus": 100
  },
  "metadata": {
    "isReferralOrder": true,
    "referralSource": "Friend Referral"
  }
}
```

### Ordine in Abbonamento

```json
{
  "subscription": {
    "id": "SUB-2024-001",
    "type": "Monthly",
    "frequency": 30,
    "nextBilling": "2024-02-25",
    "isRecurring": true
  },
  "loyalty": {
    "pointsEarned": 100,
    "subscriptionBonus": 50,
    "loyaltyMultiplier": 1.1
  }
}
```

## Categorie Prodotto per la Fedeltà

### Moltiplicatori di Punti per Categoria

```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"
    }
  ]
}
```

## Aggiornamenti Stato Ordine

### Evasione Ordine

```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"
  }
}
```

### Completamento Ordine

```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"
  }
}
```

## Elaborazione Ordini in Batch

Crea più ordini per la sincronizzazione in blocco:

```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
    }
  ]
}
```

## Gestione degli Errori

```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"
  }
}
```

## Integrazione Webhook

Configura i webhook per sincronizzare le variazioni di stato degli ordini:

```json
{
  "webhookUrl": "https://your-tajo-app.com/webhooks/brevo",
  "events": [
    "order.created",
    "order.updated",
    "order.shipped",
    "order.delivered",
    "loyalty.points.awarded"
  ]
}
```

## Best Practice per Tajo

1. **Sincronizzazione in Tempo Reale**: Crea ordini immediatamente dopo il checkout
2. **Dati Completi**: Includi tutte le informazioni rilevanti per la fedeltà
3. **Aggiornamenti di Stato**: Mantieni aggiornato lo stato degli ordini per un tracciamento accurato
4. **Recupero degli Errori**: Gestisci con eleganza gli ordini duplicati e i clienti mancanti
5. **Calcolo dei Punti**: Verifica che i calcoli dei punti fedeltà corrispondano al tuo sistema
6. **Segmentazione Clienti**: Utilizza i dati degli ordini per campagne mirate

## Analytics e Reporting

Monitora le metriche chiave:

- Andamento del valore degli ordini
- Tassi di riscatto dei punti fedeltà
- Valore lifetime del cliente
- Pattern di aggiornamento dei livelli
- Efficacia delle campagne

## Passi Successivi

- Aggiorna Stato Ordine
- Configura Programmi Fedeltà
- Configura Regole Punti
- Crea Categorie Prodotto