Update Order Status

PUT https://api.tribemade.in/api/orders/{order_id}/status

started → processing → dispatched → delivered
            ↘ cancelled (from any status)

{
  "error": "Status is required"
}

{
  "error": "Status must be one of: processing, dispatched, cancelled, delivered"
}

{
  "error": "Cannot update order status. Order is already delivered."
}

{
  "error": "Order not found"
}

{
  "error": "Order does not belong to this store"
}

{
  "error": "Invalid API key"
}

{
  "error": "Missing API key"
}

{
  "error": "Rate limit exceeded",
  "retry_after": 60
}

import requests

class OrderFulfillment:
    def __init__(self, api_key):
        self.api_key = api_key
        self.base_url = "https://api.tribemade.in/api/orders"
    
    def update_status(self, order_id, status, tracking_url=None):
        """Update order status"""
        url = f"{self.base_url}/{order_id}/status"
        headers = {
            "X-API-Key": self.api_key,
            "Content-Type": "application/json"
        }
        
        data = {"status": status}
        if tracking_url:
            data["tracking_url"] = tracking_url
        
        response = requests.put(url, headers=headers, json=data)
        return response.status_code == 200
    
    def fulfill_order(self, order_id):
        """Complete fulfillment workflow"""
        print(f"Starting fulfillment for order {order_id[:8]}...")
        
        # Step 1: Mark as processing
        if self.update_status(order_id, "processing"):
            print("✓ Marked as processing")
        else:
            print("✗ Failed to mark as processing")
            return False
        
        # Step 2: Pack and prepare (your logic here)
        print("✓ Order packed and ready")
        
        # Step 3: Create shipping label (your shipping provider API)
        tracking_url = self.create_shipping_label(order_id)
        
        # Step 4: Mark as dispatched with tracking
        if self.update_status(order_id, "dispatched", tracking_url):
            print(f"✓ Marked as dispatched with tracking: {tracking_url}")
            return True
        else:
            print("✗ Failed to mark as dispatched")
            return False
    
    def create_shipping_label(self, order_id):
        """Create shipping label (mock implementation)"""
        # Integrate with your shipping provider API
        # Return tracking URL
        return "https://delhivery.com/track/AWB123456"

# Usage
fulfillment = OrderFulfillment("tb-a1b2-c3d-e4f5")
fulfillment.fulfill_order("770e8400-e29b-41d4-a716-446655440789")

from flask import Flask, request
import requests

app = Flask(__name__)

@app.route('/webhook/orders', methods=['POST'])
def handle_new_order():
    """
    Receive webhook notification and automatically mark as processing
    """
    data = request.get_json()
    
    if data.get('event') != 'order.created':
        return '', 400
    
    order_id = data.get('order_id')
    
    # Automatically mark new orders as processing
    url = f"https://api.tribemade.in/api/orders/{order_id}/status"
    headers = {
        "X-API-Key": "tb-a1b2-c3d-e4f5",
        "Content-Type": "application/json"
    }
    data = {"status": "processing"}
    
    response = requests.put(url, headers=headers, json=data)
    
    if response.status_code == 200:
        print(f"✓ Order {order_id[:8]}... marked as processing")
    
    return '', 200

app.run(port=5000)

import requests
import time

def bulk_update_status(order_ids, status, tracking_urls=None):
    """
    Update status for multiple orders
    
    order_ids: List of order IDs
    status: New status
    tracking_urls: Dict mapping order_id to tracking_url (optional)
    """
    base_url = "https://api.tribemade.in/api/orders"
    headers = {
        "X-API-Key": "tb-a1b2-c3d-e4f5",
        "Content-Type": "application/json"
    }
    
    results = {"success": [], "failed": []}
    
    for order_id in order_ids:
        url = f"{base_url}/{order_id}/status"
        data = {"status": status}
        
        # Add tracking URL if provided
        if tracking_urls and order_id in tracking_urls:
            data["tracking_url"] = tracking_urls[order_id]
        
        try:
            response = requests.put(url, headers=headers, json=data)
            
            if response.status_code == 200:
                results["success"].append(order_id)
                print(f"✓ Updated {order_id[:8]}... to {status}")
            else:
                results["failed"].append(order_id)
                error = response.json().get('error', 'Unknown error')
                print(f"✗ Failed {order_id[:8]}...: {error}")
        
        except Exception as e:
            results["failed"].append(order_id)
            print(f"✗ Error {order_id[:8]}...: {str(e)}")
        
        # Respect rate limit (20 req/min)
        time.sleep(3)
    
    print(f"\n✓ Success: {len(results['success'])}")
    print(f"✗ Failed: {len(results['failed'])}")
    
    return results

# Usage - Mark multiple orders as dispatched
order_ids = ["770e8400-...", "880e8400-...", "990e8400-..."]
tracking_urls = {
    "770e8400-...": "https://delhivery.com/track/AWB111",
    "880e8400-...": "https://delhivery.com/track/AWB222",
    "990e8400-...": "https://delhivery.com/track/AWB333"
}

bulk_update_status(order_ids, "dispatched", tracking_urls)

import requests

def ship_order_with_delhivery(order_id):
    """
    Complete workflow: Get order → Create shipment → Update status
    """
    api_key = "tb-a1b2-c3d-e4f5"
    base_url = "https://api.tribemade.in/api/orders"
    
    # Step 1: Get order details
    get_url = f"{base_url}/{order_id}"
    headers = {"X-API-Key": api_key}
    
    response = requests.get(get_url, headers=headers)
    if response.status_code != 200:
        print("Failed to fetch order")
        return False
    
    order = response.json()
    customer = order['customer']
    
    # Step 2: Create Delhivery shipment (mock)
    # In reality, you'd call Delhivery API here
    delhivery_data = {
        "order_id": order['id'],
        "customer_name": customer['name'],
        "phone": customer['number'],
        "address": customer['full_address'],
        "pincode": customer['pincode']
    }
    
    # Mock response
    tracking_awb = "AWB123456789"
    tracking_url = f"https://delhivery.com/track/{tracking_awb}"
    print(f"✓ Created Delhivery shipment: {tracking_awb}")
    
    # Step 3: Update order status with tracking
    update_url = f"{base_url}/{order_id}/status"
    headers["Content-Type"] = "application/json"
    
    data = {
        "status": "dispatched",
        "tracking_url": tracking_url
    }
    
    response = requests.put(update_url, headers=headers, json=data)
    
    if response.status_code == 200:
        print(f"✓ Order marked as dispatched with tracking")
        print(f"  Tracking: {tracking_url}")
        return True
    else:
        print("✗ Failed to update order status")
        return False

# Usage
ship_order_with_delhivery("770e8400-e29b-41d4-a716-446655440789")