ecommerce-fulfillment

Installation

SKILL.md

E-Commerce Fulfillment

You are an expert in e-commerce fulfillment operations and direct-to-consumer logistics. Your goal is to help online retailers optimize order processing, warehouse operations, shipping strategies, and returns management to deliver fast, accurate, cost-effective fulfillment while maximizing customer satisfaction.

Initial Assessment

Before optimizing e-commerce fulfillment, understand:

Business Model & Scale
- Order volume? (orders per day, peak vs. average)
- Average order value (AOV)?
- SKU count and product types?
- B2C, B2B, or both?
- Growth trajectory? (scaling challenges)
Fulfillment Operations
- Fulfillment model? (in-house, 3PL, hybrid)
- Number of fulfillment centers? Locations?
- Warehouse size and capacity?
- Technology? (WMS, OMS, automation level)
- Current order accuracy rate?
Shipping & Delivery
- Shipping carriers used? (USPS, UPS, FedEx, regional)
- Delivery promises? (2-day, 3-5 day, standard)
- Free shipping threshold?
- International shipping?
- Average shipping cost per order?
Current Performance
- Order fulfillment cycle time? (order to ship)
- On-time shipment rate?
- Order accuracy? (correct items, no damages)
- Return rate? (% of orders)
- Fulfillment cost per order?

E-Commerce Fulfillment Framework

Fulfillment Models

1. In-House Fulfillment

Own warehouse and operations
Full control over process and quality
Higher fixed costs, requires expertise
Best for: Large volumes, specialized products

2. Third-Party Logistics (3PL)

Outsource to fulfillment provider
Variable costs, scalability
Less control, shared resources
Best for: Growing businesses, seasonal peaks

3. Dropshipping

Supplier ships directly
No inventory investment
Longer delivery times, less control
Best for: Marketplaces, extended assortment

4. Hybrid Model

Combination of in-house + 3PL
Fast movers in-house, long tail via 3PL
Balance control and flexibility
Best for: Mature businesses, diverse catalog

5. Fulfillment by Amazon (FBA) / Marketplace

Leverage platform's fulfillment network
Access to Prime customers
Fees and restrictions
Best for: Sellers on marketplaces

Order Processing Optimization

Order Management Workflow

import numpy as np
import pandas as pd
from datetime import datetime, timedelta
from typing import List, Dict

class OrderProcessingEngine:
    """
    Optimize order processing workflow

    From order receipt to shipment handoff
    """

    def __init__(self, warehouse_config):
        """
        Parameters:
        - warehouse_config: Warehouse capacity and operational parameters
        """
        self.warehouse = warehouse_config
        self.order_statuses = {}

    def prioritize_orders(self, orders_df):
        """
        Prioritize order processing

        Factors:
        - Shipping method (expedited first)
        - Order time (FIFO generally)
        - Customer tier (VIP, repeat, new)
        - Geographic zone (consolidate picking)
        """

        orders_df = orders_df.copy()

        # Calculate priority score
        def calculate_priority(row):
            score = 0

            # Shipping method priority
            shipping_priority = {
                'overnight': 100,
                'two_day': 80,
                'three_day': 60,
                'standard': 40,
                'economy': 20
            }
            score += shipping_priority.get(row['shipping_method'], 40)

            # Order age (older = higher priority)
            hours_since_order = (
                datetime.now() - pd.to_datetime(row['order_time'])
            ).total_seconds() / 3600
            score += min(hours_since_order * 2, 50)  # Cap at 50

            # Customer tier
            customer_priority = {
                'vip': 30,
                'repeat': 15,
                'new': 0
            }
            score += customer_priority.get(row.get('customer_tier', 'new'), 0)

            # Order value (higher value = slight priority boost)
            if row['order_value'] > 200:
                score += 10
            elif row['order_value'] > 100:
                score += 5

            # At-risk SLA (cut-off time approaching)
            cutoff_time = pd.to_datetime(row['order_date'].date()) + timedelta(hours=14)
            minutes_to_cutoff = (cutoff_time - datetime.now()).total_seconds() / 60

            if minutes_to_cutoff < 60 and minutes_to_cutoff > 0:
                score += 40  # Urgent - approaching cutoff

            return score

        orders_df['priority_score'] = orders_df.apply(calculate_priority, axis=1)

        # Sort by priority
        orders_df = orders_df.sort_values('priority_score', ascending=False)

        return orders_df

    def batch_orders_for_picking(self, orders_df, batch_size=20):
        """
        Batch orders for efficient picking

        Group orders that can be picked together
        """

        # Simple zone-based batching
        # (In practice, would use sophisticated wave planning)

        orders_df = self.prioritize_orders(orders_df)

        batches = []
        current_batch = []

        for idx, order in orders_df.iterrows():
            current_batch.append(order['order_id'])

            if len(current_batch) >= batch_size:
                batches.append({
                    'batch_id': len(batches) + 1,
                    'order_ids': current_batch.copy(),
                    'order_count': len(current_batch),
                    'estimated_pick_time': len(current_batch) * 3  # 3 min per order
                })
                current_batch = []

        # Add remaining orders
        if current_batch:
            batches.append({
                'batch_id': len(batches) + 1,
                'order_ids': current_batch,
                'order_count': len(current_batch),
                'estimated_pick_time': len(current_batch) * 3
            })

        return pd.DataFrame(batches)

    def calculate_order_cycle_time(self, order_volume_per_hour,
                                   picker_count=10):
        """
        Calculate expected order cycle time

        From order receipt to ready-to-ship
        """

        # Processing steps and times (minutes)
        steps = {
            'order_validation': 1,
            'inventory_allocation': 0.5,
            'picking': 8,  # Varies by order size
            'packing': 5,
            'labeling': 2,
            'quality_check': 2,
            'staging': 1
        }

        total_processing_time = sum(steps.values())

        # Capacity
        orders_per_picker_per_hour = 60 / total_processing_time
        total_capacity = orders_per_picker_per_hour * picker_count

        # Queue time (if volume exceeds capacity)
        if order_volume_per_hour > total_capacity:
            queue_time = (order_volume_per_hour - total_capacity) / total_capacity * 60
        else:
            queue_time = 0

        total_cycle_time = total_processing_time + queue_time

        return {
            'processing_time_minutes': total_processing_time,
            'queue_time_minutes': queue_time,
            'total_cycle_time_minutes': total_cycle_time,
            'hourly_capacity': total_capacity,
            'utilization': min(order_volume_per_hour / total_capacity, 1.0) * 100
        }

    def calculate_cutoff_times(self, carrier_pickup_times):
        """
        Calculate order cutoff times for same-day shipping

        Work backwards from carrier pickup
        """

        cutoffs = []

        for carrier, pickup_time in carrier_pickup_times.items():
            # Work backwards
            pickup = datetime.strptime(pickup_time, '%H:%M')

            # Need 30 min buffer before pickup
            ready_by = pickup - timedelta(minutes=30)

            # Average processing time: 45 minutes
            processing_time = 45

            cutoff = ready_by - timedelta(minutes=processing_time)

            cutoffs.append({
                'carrier': carrier,
                'pickup_time': pickup_time,
                'order_cutoff': cutoff.strftime('%H:%M'),
                'processing_buffer': processing_time
            })

        return pd.DataFrame(cutoffs)

# Example usage
orders_data = pd.DataFrame({
    'order_id': [f'ORD{i:05d}' for i in range(1, 51)],
    'order_time': pd.date_range('2024-03-15 08:00', periods=50, freq='15min'),
    'order_date': pd.Timestamp('2024-03-15'),
    'shipping_method': np.random.choice(
        ['standard', 'two_day', 'three_day', 'overnight'],
        50,
        p=[0.5, 0.3, 0.15, 0.05]
    ),
    'order_value': np.random.uniform(30, 250, 50),
    'customer_tier': np.random.choice(['new', 'repeat', 'vip'], 50, p=[0.3, 0.6, 0.1])
})

processor = OrderProcessingEngine({})

# Prioritize orders
prioritized = processor.prioritize_orders(orders_data)
print("Top 5 Priority Orders:")
print(prioritized.head()[['order_id', 'shipping_method', 'priority_score']])

# Batch orders
batches = processor.batch_orders_for_picking(orders_data, batch_size=20)
print(f"\nCreated {len(batches)} picking batches")
print(batches)

# Calculate cycle time
cycle_time = processor.calculate_order_cycle_time(
    order_volume_per_hour=100,
    picker_count=15
)
print(f"\nOrder cycle time: {cycle_time['total_cycle_time_minutes']:.1f} minutes")
print(f"Capacity utilization: {cycle_time['utilization']:.1f}%")

Warehouse Operations Optimization

Pick-Pack-Ship Efficiency

class WarehouseEfficiencyOptimizer:
    """
    Optimize warehouse picking, packing, and shipping operations
    """

    def __init__(self, warehouse_layout, sku_velocity_data):
        """
        Parameters:
        - warehouse_layout: Warehouse zones and locations
        - sku_velocity_data: SKU sales velocity (for slotting)
        """
        self.layout = warehouse_layout
        self.velocity = sku_velocity_data

    def optimize_slotting(self, strategy='velocity_based'):
        """
        Optimize SKU slotting in warehouse

        Place fast movers in prime locations (near packing stations)
        """

        # Classify SKUs by velocity
        self.velocity['velocity_class'] = pd.qcut(
            self.velocity['daily_units'],
            q=3,
            labels=['Slow', 'Medium', 'Fast']
        )

        # Assign zones
        def assign_zone(velocity_class):
            if velocity_class == 'Fast':
                return 'Zone_A_Front'  # Closest to packing
            elif velocity_class == 'Medium':
                return 'Zone_B_Middle'
            else:
                return 'Zone_C_Back'

        self.velocity['recommended_zone'] = self.velocity['velocity_class'].apply(assign_zone)

        # Calculate expected savings
        current_avg_pick_distance = 150  # feet
        optimized_avg_pick_distance = 95  # feet
        picks_per_day = self.velocity['daily_units'].sum()

        distance_saved = (current_avg_pick_distance - optimized_avg_pick_distance) * picks_per_day
        time_saved_minutes = distance_saved / 200  # 200 ft/min walk speed
        labor_cost_saved = time_saved_minutes / 60 * 18  # $18/hour

        return {
            'sku_assignments': self.velocity[['sku', 'velocity_class', 'recommended_zone']],
            'distance_saved_feet': distance_saved,
            'time_saved_minutes': time_saved_minutes,
            'daily_labor_cost_saved': labor_cost_saved
        }

    def calculate_picking_method_efficiency(self):
        """
        Compare picking methods

        - Discrete picking (one order at a time)
        - Batch picking (multiple orders)
        - Zone picking (pickers assigned to zones)
        - Wave picking (batches at scheduled times)
        """

        methods = []

        # Discrete picking
        discrete_picks_per_hour = 35
        discrete_accuracy = 0.98
        methods.append({
            'method': 'Discrete (single-order)',
            'picks_per_hour': discrete_picks_per_hour,
            'accuracy': discrete_accuracy,
            'complexity': 'Low',
            'best_for': 'Low volume, simple orders'
        })

        # Batch picking
        batch_picks_per_hour = 80
        batch_accuracy = 0.95
        methods.append({
            'method': 'Batch picking',
            'picks_per_hour': batch_picks_per_hour,
            'accuracy': batch_accuracy,
            'complexity': 'Medium',
            'best_for': 'Medium-high volume'
        })

        # Zone picking
        zone_picks_per_hour = 75
        zone_accuracy = 0.96
        methods.append({
            'method': 'Zone picking',
            'picks_per_hour': zone_picks_per_hour,
            'accuracy': zone_accuracy,
            'complexity': 'Medium',
            'best_for': 'Large warehouses, high SKU count'
        })

        # Wave picking
        wave_picks_per_hour = 90
        wave_accuracy = 0.95
        methods.append({
            'method': 'Wave picking',
            'picks_per_hour': wave_picks_per_hour,
            'accuracy': wave_accuracy,
            'complexity': 'High',
            'best_for': 'Very high volume, scheduled waves'
        })

        return pd.DataFrame(methods)

    def recommend_automation_opportunities(self, order_volume_per_day,
                                          avg_order_lines=3):
        """
        Recommend warehouse automation based on volume

        - Put walls / Light-directed picking
        - Automated storage and retrieval (AS/RS)
        - Robotic picking
        - Automated packing
        - Conveyor systems
        """

        recommendations = []

        total_picks_per_day = order_volume_per_day * avg_order_lines

        # Put wall / Light-directed picking
        if order_volume_per_day > 500:
            recommendations.append({
                'technology': 'Put wall / Light-directed picking',
                'investment': '$50K - $150K',
                'expected_benefit': '40% picking efficiency gain',
                'payback_months': 12,
                'priority': 'High' if order_volume_per_day > 2000 else 'Medium'
            })

        # Conveyor system
        if order_volume_per_day > 1000:
            recommendations.append({
                'technology': 'Conveyor system',
                'investment': '$200K - $500K',
                'expected_benefit': '30% labor reduction in movement',
                'payback_months': 18,
                'priority': 'High' if order_volume_per_day > 3000 else 'Medium'
            })

        # Goods-to-person (AS/RS)
        if order_volume_per_day > 3000:
            recommendations.append({
                'technology': 'Goods-to-person (AS/RS)',
                'investment': '$1M - $3M',
                'expected_benefit': '3x picking productivity',
                'payback_months': 24,
                'priority': 'High'
            })

        # Automated packing
        if order_volume_per_day > 2000:
            recommendations.append({
                'technology': 'Automated packing stations',
                'investment': '$150K - $400K',
                'expected_benefit': '50% packing labor reduction',
                'payback_months': 15,
                'priority': 'High' if order_volume_per_day > 5000 else 'Medium'
            })

        if not recommendations:
            recommendations.append({
                'technology': 'Manual operations sufficient',
                'investment': 'N/A',
                'expected_benefit': 'Focus on process optimization',
                'payback_months': 0,
                'priority': 'N/A'
            })

        return pd.DataFrame(recommendations)

# Example
sku_velocity = pd.DataFrame({
    'sku': [f'SKU{i:04d}' for i in range(1, 201)],
    'daily_units': np.random.lognormal(3, 1.5, 200)
})

warehouse_layout = {}  # Simplified

optimizer = WarehouseEfficiencyOptimizer(warehouse_layout, sku_velocity)

# Optimize slotting
slotting = optimizer.optimize_slotting()
print("Slotting Optimization:")
print(f"Daily labor cost saved: ${slotting['daily_labor_cost_saved']:.2f}")
print(f"Time saved: {slotting['time_saved_minutes']:.0f} minutes/day")

# Compare picking methods
picking_methods = optimizer.calculate_picking_method_efficiency()
print("\nPicking Methods:")
print(picking_methods)

# Automation recommendations
automation = optimizer.recommend_automation_opportunities(order_volume_per_day=2500)
print("\nAutomation Recommendations:")
print(automation)

Shipping Optimization

Carrier Selection & Rate Shopping

class ShippingOptimizer:
    """
    Optimize shipping costs and delivery speed

    Carrier selection, rate shopping, zone skipping
    """

    def __init__(self, carrier_rates, fulfillment_locations):
        """
        Parameters:
        - carrier_rates: Rate tables by carrier, service, zone
        - fulfillment_locations: Fulfillment center locations
        """
        self.rates = carrier_rates
        self.locations = fulfillment_locations

    def select_optimal_carrier(self, order):
        """
        Select best carrier for order

        Balance cost, speed, and service requirements
        """

        customer_zip = order['ship_to_zip']
        weight = order['weight_lbs']
        dimensions = order['dimensions']
        service_level = order['service_level']  # standard, expedited, overnight

        # Get closest fulfillment center
        fc = self._get_closest_fc(customer_zip)

        # Get shipping zone
        zone = self._get_shipping_zone(fc['zip'], customer_zip)

        # Get rates from all carriers
        carrier_options = []

        for carrier in ['USPS', 'UPS', 'FedEx']:
            # Get applicable services
            if service_level == 'overnight':
                services = [f'{carrier}_Overnight']
            elif service_level == 'expedited':
                services = [f'{carrier}_2Day', f'{carrier}_3Day']
            else:
                services = [f'{carrier}_Ground', f'{carrier}_Standard']

            for service in services:
                rate = self._lookup_rate(carrier, service, zone, weight)

                if rate:
                    # Estimate delivery days
                    delivery_days = self._estimate_delivery_days(service, zone)

                    carrier_options.append({
                        'carrier': carrier,
                        'service': service,
                        'cost': rate,
                        'delivery_days': delivery_days,
                        'zone': zone
                    })

        if not carrier_options:
            return None

        # Select based on objective
        if service_level == 'overnight':
            # Must be overnight, pick cheapest overnight option
            overnight_options = [o for o in carrier_options if o['delivery_days'] <= 1]
            if overnight_options:
                return min(overnight_options, key=lambda x: x['cost'])
        elif service_level == 'expedited':
            # 2-3 days, pick cheapest
            expedited_options = [o for o in carrier_options if o['delivery_days'] <= 3]
            if expedited_options:
                return min(expedited_options, key=lambda x: x['cost'])
        else:
            # Standard - pick cheapest that meets delivery promise
            return min(carrier_options, key=lambda x: x['cost'])

    def calculate_dimensional_weight(self, length, width, height, divisor=139):
        """
        Calculate dimensional weight

        If dim weight > actual weight, charged on dim weight
        """

        dim_weight = (length * width * height) / divisor

        return dim_weight

    def optimize_packaging(self, items):
        """
        Select optimal packaging to minimize dimensional weight

        Try to fit in smallest box possible
        """

        # Standard box sizes (length x width x height in inches)
        box_sizes = [
            {'name': 'Small', 'dims': (8, 6, 4), 'cost': 0.50},
            {'name': 'Medium', 'dims': (12, 10, 6), 'cost': 0.75},
            {'name': 'Large', 'dims': (16, 12, 10), 'cost': 1.00},
            {'name': 'X-Large', 'dims': (20, 16, 12), 'cost': 1.50}
        ]

        # Calculate total item volume (simplified)
        total_item_volume = sum(
            item['length'] * item['width'] * item['height']
            for item in items
        )

        # Add 20% for packing material
        required_volume = total_item_volume * 1.2

        # Find smallest box that fits
        for box in box_sizes:
            box_volume = box['dims'][0] * box['dims'][1] * box['dims'][2]

            if box_volume >= required_volume:
                dim_weight = self.calculate_dimensional_weight(*box['dims'])

                return {
                    'box_name': box['name'],
                    'dimensions': box['dims'],
                    'box_cost': box['cost'],
                    'dimensional_weight': dim_weight
                }

        # If no box fits, need X-Large
        box = box_sizes[-1]
        dim_weight = self.calculate_dimensional_weight(*box['dims'])

        return {
            'box_name': box['name'],
            'dimensions': box['dims'],
            'box_cost': box['cost'],
            'dimensional_weight': dim_weight
        }

    def calculate_shipping_budget(self, forecast_orders, target_margin_pct=30):
        """
        Calculate shipping budget to maintain margin targets

        Used for free shipping threshold decisions
        """

        avg_order_value = forecast_orders['order_value'].mean()
        avg_shipping_cost = forecast_orders['shipping_cost'].mean()

        # Calculate breakeven for free shipping
        # Need to absorb shipping cost while maintaining margin

        # If AOV > X, can afford free shipping
        min_aov_for_free_shipping = avg_shipping_cost / (1 - target_margin_pct/100)

        return {
            'avg_order_value': avg_order_value,
            'avg_shipping_cost': avg_shipping_cost,
            'target_margin_pct': target_margin_pct,
            'min_aov_for_free_shipping': min_aov_for_free_shipping,
            'recommended_free_ship_threshold': round(min_aov_for_free_shipping * 1.2, 0)  # 20% buffer
        }

    def _get_closest_fc(self, customer_zip):
        """Find closest fulfillment center"""
        # Simplified
        return {'zip': '90001', 'id': 'FC1'}

    def _get_shipping_zone(self, origin_zip, dest_zip):
        """Determine shipping zone (1-8)"""
        # Simplified - would use actual zone lookup
        return np.random.randint(2, 7)

    def _lookup_rate(self, carrier, service, zone, weight):
        """Look up shipping rate"""
        # Simplified rate calculation
        base_rate = 5.0 + (zone * 0.50) + (weight * 0.80)
        if 'Overnight' in service:
            base_rate *= 3
        elif '2Day' in service:
            base_rate *= 1.8
        return round(base_rate, 2)

    def _estimate_delivery_days(self, service, zone):
        """Estimate delivery time"""
        if 'Overnight' in service:
            return 1
        elif '2Day' in service:
            return 2
        elif '3Day' in service:
            return 3
        else:
            return 5 if zone > 5 else 4

# Example
order = {
    'order_id': 'ORD001',
    'ship_to_zip': '10001',
    'weight_lbs': 3.5,
    'dimensions': (10, 8, 6),
    'service_level': 'standard'
}

shipping_opt = ShippingOptimizer({}, {})

# Select carrier
carrier_selection = shipping_opt.select_optimal_carrier(order)
print("Optimal Carrier Selection:")
print(carrier_selection)

# Optimize packaging
items = [
    {'length': 8, 'width': 6, 'height': 2},
    {'length': 5, 'width': 4, 'height': 3}
]
packaging = shipping_opt.optimize_packaging(items)
print(f"\nOptimal packaging: {packaging['box_name']}")
print(f"Dimensional weight: {packaging['dimensional_weight']:.1f} lbs")

# Shipping budget
forecast_orders = pd.DataFrame({
    'order_value': np.random.uniform(50, 200, 1000),
    'shipping_cost': np.random.uniform(5, 12, 1000)
})
budget = shipping_opt.calculate_shipping_budget(forecast_orders, target_margin_pct=30)
print(f"\nRecommended free shipping threshold: ${budget['recommended_free_ship_threshold']:.0f}")

Returns Management

class ReturnsOptimizer:
    """
    Optimize returns processing and reverse logistics

    Minimize return costs and maximize recovery value
    """

    def __init__(self, return_policy, restocking_costs):
        self.policy = return_policy
        self.costs = restocking_costs

    def calculate_return_profitability(self, product_category, return_rate,
                                      avg_selling_price):
        """
        Calculate net profitability accounting for returns

        High return rates erode profitability
        """

        # Return costs
        reverse_shipping_cost = 6.50
        inspection_labor = 2.00
        restocking_labor = 1.50
        packaging_disposal = 0.50

        total_return_cost = (
            reverse_shipping_cost +
            inspection_labor +
            restocking_labor +
            packaging_disposal
        )

        # Recovery value (% of original price product can be resold)
        recovery_rate = {
            'apparel': 0.70,  # 70% can be resold at full price
            'electronics': 0.50,  # High damage rate
            'home_goods': 0.80,
            'consumables': 0.10  # Most cannot be resold
        }

        recovery_pct = recovery_rate.get(product_category, 0.60)

        # Calculate impact
        gross_profit_per_unit = avg_selling_price * 0.40  # Assume 40% margin

        # Return cost per unit sold
        return_cost_per_unit = return_rate * total_return_cost

        # Loss from returns (unrecoverable value)
        loss_per_return = avg_selling_price * (1 - recovery_pct)
        loss_per_unit = return_rate * loss_per_return

        # Net profit
        net_profit_per_unit = gross_profit_per_unit - return_cost_per_unit - loss_per_unit

        return {
            'category': product_category,
            'return_rate': return_rate * 100,
            'gross_profit_per_unit': gross_profit_per_unit,
            'return_cost_per_unit': return_cost_per_unit,
            'loss_from_returns': loss_per_unit,
            'net_profit_per_unit': net_profit_per_unit,
            'profit_margin_after_returns': net_profit_per_unit / avg_selling_price * 100
        }

    def recommend_return_prevention_strategies(self, current_return_rate):
        """
        Recommend strategies to reduce return rates

        Better than processing returns is preventing them
        """

        strategies = []

        if current_return_rate > 0.25:
            strategies.append({
                'strategy': 'Improve product descriptions and photos',
                'expected_impact': '-5 to -8 percentage points',
                'investment': 'Medium (content creation)',
                'priority': 'High'
            })

        if current_return_rate > 0.20:
            strategies.append({
                'strategy': 'Add size/fit guides and reviews',
                'expected_impact': '-3 to -5 percentage points',
                'investment': 'Low (software)',
                'priority': 'High'
            })

        if current_return_rate > 0.15:
            strategies.append({
                'strategy': 'Implement stricter quality control',
                'expected_impact': '-2 to -4 percentage points',
                'investment': 'Medium (labor)',
                'priority': 'Medium'
            })

        strategies.append({
            'strategy': 'Offer virtual try-on or AR visualization',
            'expected_impact': '-4 to -6 percentage points',
            'investment': 'High (technology)',
            'priority': 'Medium' if current_return_rate > 0.20 else 'Low'
        })

        return pd.DataFrame(strategies)

# Example
returns_opt = ReturnsOptimizer({}, {})

# Calculate return impact
return_impact = returns_opt.calculate_return_profitability(
    product_category='apparel',
    return_rate=0.25,  # 25% return rate
    avg_selling_price=65
)

print("Return Profitability Impact:")
print(f"Gross profit: ${return_impact['gross_profit_per_unit']:.2f}")
print(f"Return cost: ${return_impact['return_cost_per_unit']:.2f}")
print(f"Loss from returns: ${return_impact['loss_from_returns']:.2f}")
print(f"Net profit: ${return_impact['net_profit_per_unit']:.2f}")
print(f"Net margin: {return_impact['profit_margin_after_returns']:.1f}%")

# Prevention strategies
strategies = returns_opt.recommend_return_prevention_strategies(current_return_rate=0.25)
print("\nReturn Prevention Strategies:")
print(strategies)

Tools & Libraries

Python Libraries

Optimization:

scipy.optimize: Routing and allocation optimization
pulp, pyomo: Linear programming for order batching
ortools: Google OR-Tools for warehouse optimization

Data Processing:

pandas: Data manipulation
numpy: Numerical computations

Commercial Software

Warehouse Management Systems (WMS):

Manhattan Active WMS: Cloud-native WMS
Blue Yonder WMS: AI-powered warehouse management
SAP EWM: Enterprise warehouse management
NetSuite WMS: Cloud ERP with WMS
Fishbowl: SMB warehouse management

Order Management Systems (OMS):

Shopify: E-commerce platform with order management
BigCommerce: Enterprise e-commerce
Magento: Open-source e-commerce
Salesforce Commerce Cloud: Enterprise OMS

Fulfillment Platforms:

ShipStation: Multi-carrier shipping software
ShipBob: 3PL fulfillment network
Deliverr: Fast fulfillment for marketplaces
Amazon FBA: Fulfillment by Amazon
Rakuten: E-commerce fulfillment

Common Challenges & Solutions

Challenge: Peak Season Capacity

Problem:

Order volume spikes (Black Friday, holidays)
Warehouse capacity constraints
Labor shortages
Shipping delays

Solutions:

Temporary labor hiring (start early)
3PL overflow partnerships
Extended operating hours
Wave scheduling optimization
Pre-positioning inventory
Communicate longer delivery times
Offer incentives for earlier orders

Challenge: High Shipping Costs

Problem:

Shipping costs erode margins
Free shipping expectations
Carrier rate increases

Solutions:

Multi-carrier rate shopping
Regional carrier usage
Free shipping thresholds (encourage larger orders)
Fulfilled by merchant (FBM) vs. FBA analysis
Zone skipping programs
Packaging optimization (reduce dim weight)
Negotiate carrier contracts

Challenge: Order Accuracy

Problem:

Wrong items shipped
Missing items
Damaged products
Customer dissatisfaction and returns

Solutions:

Barcode scanning at pick/pack
Quality control checkpoints
Light-directed picking
Automated packing verification
Photo documentation
Staff training and incentives
Root cause analysis of errors

Challenge: Returns Processing

Problem:

High return rates (20-30% for apparel)
Expensive to process
Lost revenue
Inventory complications

Solutions:

Improve product content (reduce returns)
Streamlined return process
Automated return label generation
Inspection and grading workflow
Quick restocking vs. liquidation decisions
Return fraud detection
Free returns only above threshold

Challenge: Inventory Accuracy

Problem:

System inventory ≠ physical inventory
Overselling out-of-stock items
Customer cancellations

Solutions:

Cycle counting programs
RFID technology
Real-time inventory updates
Reserved inventory (don't oversell)
Safety stock buffers
Automated inventory reconciliation
Regular physical audits

Output Format

E-Commerce Fulfillment Analysis Report

Executive Summary:

Daily order volume: 3,500 orders
Current fulfillment cost: $8.25 per order
Target fulfillment cost: $6.50 per order
Current accuracy: 96.2%
Target accuracy: 99%
Average order cycle time: 18 hours

Current Performance:

Metric	Current	Industry Benchmark	Gap
Fulfillment cost per order	$8.25	$6.50	27% higher
Order accuracy	96.2%	99%+	-2.8 pts
Cycle time (order to ship)	18 hours	12 hours	+50%
On-time shipment	88%	95%	-7 pts
Return rate	22%	15-18%	+4-7 pts
Picking productivity	45 units/hour	75 units/hour	-40%

Cost Breakdown Per Order:

Cost Component	Current	Optimized	Savings
Labor (pick/pack)	$4.50	$3.00	-$1.50
Packaging materials	$1.25	$1.00	-$0.25
Shipping	$7.50	$6.80	-$0.70
Returns processing	$1.80	$1.10	-$0.70
Overhead	$1.20	$1.00	-$0.20
Total	$16.25	$12.90	-$3.35

Optimization Opportunities:

Warehouse slotting optimization
- Move fast movers to prime locations
- Expected impact: +30% picking efficiency
- Investment: $25K
- Annual savings: $420K
Implement batch picking
- Replace discrete picking with batching
- Expected impact: +45% picking productivity
- Investment: $50K (put walls)
- Annual savings: $650K
Multi-carrier rate shopping
- Implement automated carrier selection
- Expected impact: -9% shipping costs
- Investment: $15K (software)
- Annual savings: $340K
Automated packing stations
- Right-size boxes automatically
- Expected impact: -20% packaging cost, -12% shipping cost
- Investment: $180K
- Annual savings: $280K
Return rate reduction program
- Better product content, fit guides
- Expected impact: -5 percentage point return rate
- Investment: $40K
- Annual savings: $520K

Implementation Roadmap:

Quarter	Initiative	Investment	Annual Benefit	Payback
Q1	Warehouse slotting + batch picking	$75K	$1.07M	1.0 mo
Q2	Rate shopping software	$15K	$340K	0.5 mo
Q3	Return reduction program	$40K	$520K	0.9 mo
Q4	Automated packing stations	$180K	$280K	7.7 mo

Expected Results (Year 1):

Metric	Current	Year 1 Target	Improvement
Fulfillment cost per order	$8.25	$6.50	-21%
Order accuracy	96.2%	98.5%	+2.3 pts
Cycle time	18 hours	12 hours	-33%
Picking productivity	45/hour	75/hour	+67%
Return rate	22%	17%	-5 pts
Annual savings	-	$2.21M	-

Questions to Ask

If you need more context:

What's your daily order volume? Peak vs. average?
What fulfillment model do you use? (in-house, 3PL, hybrid)
How many fulfillment centers? Where located?
What's your current order accuracy and cycle time?
What's your average shipping cost per order?
What's your return rate?
Do you have a WMS? What system?
What carriers do you use?
What are your biggest pain points? (cost, speed, accuracy, returns)

Related Skills

omnichannel-fulfillment: Multi-channel fulfillment (stores + online)
last-mile-delivery: Final mile delivery optimization
warehouse-design: Fulfillment center layout and design
route-optimization: Delivery routing
inventory-optimization: Inventory management and safety stock
demand-forecasting: Demand forecasting for inventory planning
supply-chain-analytics: Fulfillment metrics and KPIs

Related skills

More from kishorkukreja/awesome-supply-chain

Installs

Repository

kishorkukreja/a…ly-chain

GitHub Stars

First Seen

Mar 16, 2026

Security Audits

Gen Agent Trust HubPass

SocketPass

SnykPass

ecommerce-fulfillment

E-Commerce Fulfillment

Initial Assessment

E-Commerce Fulfillment Framework

Fulfillment Models

Order Processing Optimization

Order Management Workflow

Warehouse Operations Optimization

Pick-Pack-Ship Efficiency

Shipping Optimization

Carrier Selection & Rate Shopping

Returns Management

Tools & Libraries

Python Libraries

Commercial Software

Common Challenges & Solutions

Challenge: Peak Season Capacity

Challenge: High Shipping Costs

Challenge: Order Accuracy

Challenge: Returns Processing

Challenge: Inventory Accuracy

Output Format

E-Commerce Fulfillment Analysis Report

Questions to Ask

Related Skills

More from kishorkukreja/awesome-supply-chain

procurement-optimization

replenishment-strategy

inventory-optimization

supplier-selection

pharmaceutical-supply-chain

retail-replenishment