Skip to Content
FeaturesShipping

Shipping

Overview

The Shipping feature handles delivery logistics for Siyahfy stores. Vendors can configure shipping zones and rates, set up Cash on Delivery (COD) controls, and integrate with Delhivery — India’s leading logistics partner — for automated pickup scheduling and shipment tracking. The system calculates shipping charges dynamically based on weight, destination, and vendor-defined rate tables.

How It Works

Shipping Rate Calculation

When a customer enters their shipping address at checkout, the system:

  1. Looks up the vendor’s shipping rate configuration.
  2. Matches the destination to a shipping zone.
  3. Calculates the rate based on weight, price thresholds, or flat-rate rules.
  4. Returns available shipping options with costs.

COD (Cash on Delivery) Controls

Vendors can configure COD availability with fine-grained controls:

  • Enable/disable COD globally for the store
  • Set minimum and maximum order amounts for COD
  • Block COD for specific pin codes or regions
  • Disable COD for specific customers (via customer management)
  • Add a COD surcharge (extra fee)

Delhivery Integration

Siyahfy integrates with Delhivery for:

  • Pickup address management — Register and manage warehouse/pickup locations
  • Shipment creation — Automatically create shipments when orders are fulfilled
  • Rate estimation — Get real-time shipping cost estimates from Delhivery
  • Tracking — Track shipment status via Delhivery’s tracking API

Key API Endpoints

Shipping Rate Calculation

POST/api/shipping-charges

Calculate shipping charges based on cart items, weight, and destination address

COD Settings

POST/api/cod-settingsAuth Required

Save or update COD settings (enable/disable, min/max amounts, surcharge)

GET/api/cod-settingsAuth Required

Get current COD configuration for a store

GET/api/cod-settings-global

Get COD settings for storefront checkout (customer-facing)

Delhivery Integration

GET/api/delhivery/pickup-addressesAuth Required

Get all registered pickup addresses from Delhivery

POST/api/delhivery/pickup-addressesAuth Required

Register a new pickup address with Delhivery

PUT/api/delhivery/pickup-addresses/:idAuth Required

Update an existing Delhivery pickup address

Address Suggestions

GET/api/address-suggestions

Get address autocomplete suggestions for checkout (India pin code lookup)

Database Tables

TablePurpose
shipping_zonesShipping zone definitions with rate rules per region
shipping_ratesRate tables linked to zones (flat, weight-based, price-based)
cod_settingsCOD configuration per store — enabled, min/max, surcharge, blocked pincodes
delhivery_addressesRegistered pickup addresses for Delhivery integration
ordersStores shipping address, carrier info, tracking number per order
  • Orders — Shipping is part of the order fulfillment flow
  • Payments — COD is a payment method that depends on shipping config
  • Storefront — Customers see shipping rates at checkout
  • Integrations — Delhivery is a key third-party integration
Discounts & OffersPayments