Docs/sell/shipping
Reviewed 2026-07-06
Markdown
BetaBuy & sell · Task

Configure shipping and delivery

Offer only delivery methods that apply to the buyer destination and remain attached to the created order.

Map delivery requirementsEstimated time15–30 minutes
Trust, applicability, and sourcesMobazha v0.3 release candidate

Before you start

  • List origin locations, supported destinations, delivery methods, estimated times, and pricing rules.
  • Decide which listings use each shipping profile.
  • Document exclusions, customs responsibility, tracking availability, and return handling.

How shipping enters a Mobazha order

StageAuthoritative factFailure to avoid
Shipping profileZones, services, rates, estimates, and conditions configured under /admin/settings/shippingTreating one global rate as valid for every listing and destination.
Listing assignmentThe physical listing revision is attached to an eligible profile in the listing Shipping sectionPublishing a product that has no route to the buyer destination.
QuoteDestination and selected service produce the buyer-visible shipping amount and estimateReusing a catalog estimate after address, quantity, or profile changes.
Order snapshotThe accepted delivery service, amount, destination obligation, and seller promise remain with the orderLetting a later profile edit silently change an existing order.
Fulfillment evidenceCarrier, tracking, handoff, digital proof, service completion, or another supported recordMarking an order fulfilled with no evidence appropriate to its product type.

Shipping setup steps

  1. Open Admin → Settings → Shipping (/admin/settings/shipping).
  2. Create or select a profile representing one coherent fulfillment policy.
  3. Add destination zones and keep overlaps intentional and understandable.
  4. Add rates with buyer-visible names, amounts, currency, conditions, and estimated delivery.
  5. Open each physical listing's Shipping section and assign the appropriate profile; remove digital goods, services, or items requiring another delivery path.
  6. Save and test addresses inside, outside, and at the edge of every supported zone.
  7. Complete a test order and record carrier, tracking, or delivery evidence through the order flow.

Expected result and verification

Checkout should show only delivery methods valid for the item and destination. The selected shipping amount must appear in the final cost breakdown and remain associated with the created order. Seller order view should preserve selected service and obligation.

After changing a profile, test a new quote and confirm that an already accepted order still shows its original delivery commitment.

If something fails

  • If no option appears, check destination normalization, profile assignment, listing type, and zone coverage.
  • If duplicate options appear, inspect overlapping zones and duplicate profile assignment.
  • If checkout amount differs from configuration, stop accepting orders and verify currency and calculation basis.
  • If tracking cannot be saved, preserve the reference privately and report the transition defect.

Digital goods and services

Do not attach physical shipping charges to digital or service flows merely to satisfy checkout. Use the supported delivery contract and explain access, scheduling, redemption, or evidence separately.