Workflows & Integration Patterns

const product = await fetch('https://your-store.com/api/v1/products/', {
  method: 'POST',
  headers: {
    'Authorization': 'Token YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Classic T-Shirt',
    description: 'A comfortable cotton t-shirt.',
    status: 'draft',
    category_id: 42,
    options: [
      { name: 'Size', values: ['S', 'M', 'L', 'XL'] },
      { name: 'Color', values: ['Black', 'White', 'Navy'] }
    ]
  })
}).then(r => r.json());

console.log('Product created:', product.id);

const variants = [
  { options: { Size: 'S', Color: 'Black' }, sku: 'TSHIRT-BLK-S', price: '29.99' },
  { options: { Size: 'M', Color: 'Black' }, sku: 'TSHIRT-BLK-M', price: '29.99' },
  { options: { Size: 'L', Color: 'Black' }, sku: 'TSHIRT-BLK-L', price: '29.99' },
  { options: { Size: 'S', Color: 'White' }, sku: 'TSHIRT-WHT-S', price: '29.99' },
  // ... more variants
];

for (const variant of variants) {
  await fetch(`https://your-store.com/api/v1/products/${product.id}/variants/`, {
    method: 'POST',
    headers: {
      'Authorization': 'Token YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(variant)
  });
}

console.log(`Created ${variants.length} variants`);

// Set inventory for a variant at a specific warehouse
await fetch(`https://your-store.com/api/v1/inventory/`, {
  method: 'POST',
  headers: {
    'Authorization': 'Token YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    variant_id: variantId,
    warehouse_id: 1,
    quantity: 100
  })
});

// Publish the product
await fetch(`https://your-store.com/api/v1/products/${product.id}/`, {
  method: 'PATCH',
  headers: {
    'Authorization': 'Token YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ status: 'active' })
});

// Create a new cart (or retrieve existing by session)
const cart = await fetch('https://your-store.com/api/v1/cart/', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' }
}).then(r => r.json());

// Add items to cart
await fetch(`https://your-store.com/api/v1/cart/${cart.id}/items/`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    variant_id: 'var_abc123',
    quantity: 2
  })
});

// Apply a voucher code
await fetch(`https://your-store.com/api/v1/cart/${cart.id}/vouchers/`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ code: 'SAVE10' })
});

const checkout = await fetch('https://your-store.com/api/v1/checkout/', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    cart_id: cart.id,
    email: '[email protected]',
    shipping_address: {
      first_name: 'Jane',
      last_name: 'Smith',
      address_line_1: '456 Oak Ave',
      city: 'Los Angeles',
      state: 'CA',
      postal_code: '90001',
      country: 'US',
      phone: '+1-555-0123'
    },
    billing_same_as_shipping: true
  })
}).then(r => r.json());

// Response includes available shipping methods
console.log('Shipping options:', checkout.shipping_methods);

// Select shipping method
await fetch(`https://your-store.com/api/v1/checkout/${checkout.id}/`, {
  method: 'PATCH',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    shipping_method_id: checkout.shipping_methods[0].id
  })
});

// Get available payment methods
const paymentMethods = await fetch(
  `https://your-store.com/api/v1/checkout/${checkout.id}/payment-methods/`
).then(r => r.json());

// Create payment intent (e.g., with Stripe)
const payment = await fetch(`https://your-store.com/api/v1/checkout/${checkout.id}/pay/`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    payment_method_id: paymentMethods.results[0].id
  })
}).then(r => r.json());

// Redirect to payment.redirect_url or handle client-side

// Get orders in "processing" status (paid, ready to ship)
const orders = await fetch(
  'https://your-store.com/api/v1/orders/?status=processing&expand=items',
  { headers: { 'Authorization': 'Token YOUR_API_KEY' }}
).then(r => r.json());

console.log(`${orders.count} orders ready for fulfillment`);

for (const order of orders.results) {
  console.log(`Order ${order.order_number}:`);
  for (const item of order.items) {
    console.log(`  - ${item.quantity}x ${item.variant.sku}`);
  }
}

const shipment = await fetch(
  `https://your-store.com/api/v1/orders/${orderId}/shipments/`,
  {
    method: 'POST',
    headers: {
      'Authorization': 'Token YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      carrier: 'fedex',
      tracking_number: '794932643366',
      items: [
        { order_item_id: 101, quantity: 1 },
        { order_item_id: 102, quantity: 2 }
      ],
      notify_customer: true  // Sends shipping confirmation email
    })
  }
).then(r => r.json());

console.log(`Shipment created: ${shipment.id}`);