---
title: "Criar Pedido | Tajo"
description: "Sincronize pedidos de e-commerce com a Brevo para cálculo de pontos de fidelidade e engajamento com clientes"
url: https://tajo.io/pt/docs/ecommerce-loyalty/orders/create-order/
markdown: https://tajo.io/pt/docs/ecommerce-loyalty/orders/create-order.md
lang: pt-BR
author: "Set Noa"
author_url: https://tajo.io/pt/set-noa/
robots: noindex
---

Solicite acesso antecipado

Indique o seu nome e endereço de e-mail profissional. Enviaremos um link para confirmar o seu pedido de acesso ao Tajo.

# Criar Pedido

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

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

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

### Resposta

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

## Integração de Fidelidade do Tajo

### Pedido com Cálculo de Fidelidade

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

## Funcionalidades Avançadas de Fidelidade

### Pedido com Bônus de Aniversário

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

### Pedido por Indicação

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

### Pedido de Assinatura

```json
{
  "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

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

## Atualizações de Status do Pedido

### Envio do Pedido

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

### Conclusão do Pedido

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

## Processamento de Pedidos em Lote

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

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

## Tratamento de Erros

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

## Integração com Webhooks

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

```json
{
  "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

1. **Sincronização em Tempo Real**: Crie pedidos imediatamente após o checkout
2. **Dados Completos**: Inclua todas as informações relevantes de fidelidade
3. **Atualizações de Status**: Mantenha o status do pedido atualizado para rastreamento preciso
4. **Recuperação de Erros**: Trate pedidos duplicados e clientes ausentes de forma adequada
5. **Cálculo de Pontos**: Verifique se os cálculos de pontos de fidelidade correspondem ao seu sistema
6. **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

## Próximos Passos

- Atualizar Status do Pedido
- Configurar Programas de Fidelidade
- Configurar Regras de Pontos
- Criar Categorias de Produtos