Order No: {order.order_no}Total: ₹{float(order.final_amount):.2f}
Item
Qty
Amt
{items_html}
"""
return HTMLResponse(content=html)
@router.post("/webhook")
async def handle_shiprocket_webhook(
request: Request,
background_tasks: BackgroundTasks,
db: Session = Depends(get_db)
):
"""
Autonomous webhook listener that ingests status updates directly from Shiprocket:
- PICKED UP / IN TRANSIT -> Order automatically updates to SHIPPED
- OUT FOR DELIVERY -> Order automatically updates to OUT_FOR_DELIVERY
- DELIVERED -> Order automatically updates to DELIVERED
- RTO_INITIATED -> Order automatically updates to RTO_INITIATED
"""
try:
body = await request.body()
payload = json.loads(body.decode("utf-8")) if body else {}
except Exception as e:
raise HTTPException(status_code=400, detail=f"Invalid webhook JSON: {str(e)}")
awb = payload.get("awb") or payload.get("awb_code") or payload.get("tracking_number")
raw_status = (payload.get("current_status") or payload.get("shipment_status") or payload.get("status") or "").upper().strip()
order_no = payload.get("order_id") or payload.get("order_no")
if not awb and not order_no:
return {"ok": False, "message": "No AWB or order identifier provided in webhook"}
# Find matching order
order = None
if awb:
order = db.query(Order).filter(Order.tracking_number == awb).first()
if not order and order_no:
order = db.query(Order).filter(Order.order_no == order_no).first()
if not order:
return {"ok": False, "message": f"Order not found for AWB: {awb} / Order: {order_no}"}
previous_status = order.status
new_status = None
reason = f"Automated Shiprocket update: {raw_status} (AWB: {awb})"
# Map Shiprocket statuses to internal order statuses
if any(k in raw_status for k in ["PICKED UP", "IN TRANSIT", "SHIPPED", "REACHED AT DESTINATION"]):
if previous_status in ["READY_FOR_DELIVERY", "CONFIRMED", "PROCESSING"]:
new_status = "SHIPPED"
order.fulfillment_status = "FULFILLED"
elif "OUT FOR DELIVERY" in raw_status:
new_status = "OUT_FOR_DELIVERY"
elif "DELIVERED" in raw_status:
new_status = "DELIVERED"
order.fulfillment_status = "FULFILLED"
WarrantyService.generate_warranty_for_order(db, order.order_id)
elif "RTO" in raw_status or "RETURN" in raw_status:
new_status = "RTO_INITIATED"
order.last_logistics_status = raw_status
if new_status and new_status != previous_status:
order.status = new_status
history = OrderStatusHistory(
history_id=str(ulid.ULID()),
order_id=order.order_id,
previous_status=previous_status,
new_status=new_status,
changed_by="SHIPROCKET_WEBHOOK",
reason=reason
)
db.add(history)
db.commit()
return {"ok": True, "updated": True, "order_no": order.order_no, "new_status": new_status}
db.commit()
return {"ok": True, "updated": False, "current_status": order.status, "logistics_status": raw_status}
@router.post("/orders/{order_id}/sync-tracking")
async def sync_order_tracking(
order_id: str,
db: Session = Depends(get_db)
):
"""
Manually or cron-triggered tracking sync with Shiprocket.
"""
order = db.query(Order).filter(Order.order_id == order_id).first()
if not order:
raise HTTPException(status_code=404, detail="Order not found")
if not order.tracking_number:
return {"ok": False, "message": "No AWB tracking number assigned to this order yet"}
return {
"ok": True,
"order_id": order.order_id,
"order_no": order.order_no,
"status": order.status,
"tracking_number": order.tracking_number,
"courier_name": order.courier_name,
"shipping_label_url": order.shipping_label_url,
"last_logistics_status": order.last_logistics_status
}