Supply Chain Sourcing

Supply Chain Sourcing

Connect your Mobazha store to a print-on-demand (POD) or dropshipping supplier, import products, configure pricing, and set up automatic inventory monitoring.

Prerequisites

• A Mobazha store (SaaS, VPS Standalone, or Local)
• A supplier account (Printful and Printify are supported)

1. Connect a Supplier

Via the Admin Dashboard

1. Go to Admin → Settings → Integrations
2. Find the supplier (e.g., Printful) and click Connect
3. Enter your API key (get it from your supplier dashboard)
4. The connection status turns green once verified

Via the API

curl -X POST <your-store>/v1/fulfillment/printful/connect \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"credentials":{"apiKey":"<your-printful-api-key>"}}'

Replace <your-store> with your store URL:

• SaaS: https://app.mobazha.org
• VPS Standalone: https://your-domain.com
• Local: http://localhost:15104

2. Browse & Import Products

Print-on-Demand (POD) Workflow

POD products require custom designs. The recommended flow:

1. Design on supplier dashboard — create products with your artwork on Printful
2. Import via My Designs — go to Admin → Sourcing → My Designs, find your design, and click Import
3. Set pricing — choose a retail markup (recommended 40-60% for apparel, 50-100% for accessories)
4. Publish — the product is live in your store

Import via API

# List your designs from the supplier
curl <your-store>/v1/fulfillment/printful/store-products \
  -H "Authorization: Bearer <token>"

# Import a specific design
curl -X POST <your-store>/v1/fulfillment/printful/import \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "syncProductId": "<sync-product-id>",
    "retailMarkup": 50,
    "title": "My Custom T-Shirt"
  }'

Via MCP

If connected via MCP, the AI agent can browse your supplier catalog and import products conversationally.

3. Manage Imported Products

Go to Admin → Sourcing → Imported Products to see all synced products with their status:

• Synced — product data is up to date with the supplier
• Pending — sync in progress
• Error — sync failed; check the error details

Click Re-sync on any product to pull the latest data from the supplier.

4. Monitor Alerts

The system automatically monitors your supplier for inventory and pricing changes. Go to Admin → Sourcing → Alerts & Rules to view:

Alert Types

Severity Levels

• Critical — requires immediate action (e.g., item sold out)
• Warning — should review soon (e.g., price increased)
• Info — informational (e.g., item back in stock)

Dismiss alerts once reviewed. Dismissed alerts are hidden by default but can be shown with the toggle.

5. Configure Automation Rules

Set up rules to automatically respond to supplier changes. Go to Admin → Sourcing → Alerts & Rules and click Add Rule.

Available Triggers

Available Actions

Example: Auto-hide Out-of-Stock Items

curl -X POST <your-store>/v1/fulfillment/rules \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "trigger": "out_of_stock",
    "action": "hide_listing",
    "enabled": true
  }'

Example: Alert on Price Increase > 10%

curl -X POST <your-store>/v1/fulfillment/rules \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "trigger": "price_increase",
    "action": "notify_only",
    "threshold": 10,
    "enabled": true
  }'

6. Order Fulfillment

When a buyer purchases a sourced product:

1. The order is automatically sent to the supplier for fulfillment
2. A margin gate checks that the supplier cost hasn't exceeded your retail price
3. The supplier prints/ships the product directly to the buyer
4. Tracking information is automatically synced to the order

Check fulfillment status in Admin → Orders → Order Details under the Fulfillment section.

Fulfillment Statuses

Failure Reasons

If fulfillment fails, the failure reason helps diagnose the issue:

• Margin protection failed — supplier cost exceeds your retail price. Adjust pricing.
• Validation failed — order data rejected by supplier. Check product configuration.
• Retryable error — temporary issue; automatic retry is scheduled.
• Manual action required — needs operator review.

7. API Reference