Criar Pedido

Sincronize pedidos de e-commerce com a Brevo para calcular automaticamente pontos de fidelidade, atualizar níveis de clientes e acionar campanhas de marketing personalizadas.

Início Rápido

Criação Básica de Pedido

POST https://api.brevo.com/v3/ecommerce/orders
Content-Type: application/json
api-key: YOUR_API_KEY

{
  "id": "ORD-2024-001",
  "email": "[email protected]",
  "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"
}

Resposta

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

Integração de Fidelidade do Tajo

Pedido com Cálculo de Fidelidade

{
  "id": "ORD-2024-001",
  "email": "[email protected]",
  "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"
}

Funcionalidades Avançadas de Fidelidade

Pedido com Bônus de Aniversário

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

Pedido por Indicação

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

Pedido de Assinatura

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

Categorias de Produtos para Fidelidade

Multiplicadores de Pontos por Categoria

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

Atualizações de Status do Pedido

Envio do Pedido

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

Conclusão do Pedido

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

Processamento de Pedidos em Lote

Crie múltiplos pedidos para sincronização em massa:

{
  "orders": [
    {
      "id": "ORD-2024-001",
      "email": "[email protected]",
      "products": [...],
      "revenue": 199.99
    },
    {
      "id": "ORD-2024-002",
      "email": "[email protected]",
      "products": [...],
      "revenue": 299.99
    }
  ]
}

Tratamento de Erros

{
  "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": {
    "email": "[email protected]",
    "suggestion": "Create contact first"
  }
}

Integração com Webhooks

Configure webhooks para sincronizar alterações de status de pedidos:

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

Melhores Práticas para o Tajo

Sincronização em Tempo Real: Crie pedidos imediatamente após o checkout
Dados Completos: Inclua todas as informações relevantes de fidelidade
Atualizações de Status: Mantenha o status do pedido atualizado para rastreamento preciso
Recuperação de Erros: Trate pedidos duplicados e clientes ausentes de forma adequada
Cálculo de Pontos: Verifique se os cálculos de pontos de fidelidade correspondem ao seu sistema
Segmentação de Clientes: Use dados de pedidos para campanhas direcionadas

Analytics e Relatórios

Acompanhe métricas principais:

Tendências de valor de pedidos
Taxas de resgate de pontos de fidelidade
Valor vitalício do cliente
Padrões de upgrades de nível
Eficácia de campanhas