Configure shipping

Sellbase ships with manual shipping: the store decides the price, and ships with any carrier. A carrier aggregator (automatic labels and quotes) comes later.

Options (store_update_settings)

All amounts are integers in minor units: $99.00 MXN is 9900.

{
  "settings": {
    "shipping": {
      "flat_rate_amount": 9900,
      "free_over_amount": 99900,
      "label": "Envío estándar",
      "estimated_days": { "min": 2, "max": 5 },
      "pickup": { "enabled": true, "label": "Recoger en tienda" }
    }
  }
}

• flat_rate_amount: price of a normal shipment.
• free_over_amount: subtotal from which shipping is free. Use null to never make it free.
• pickup.enabled: offers store pickup at no cost. The buyer then gives no address.
• Only physical products need shipping. Digital products and services never ask for an address.
• For weight-based pricing in the future, fill variants[].physical (weight_g, length_cm, width_cm, height_cm) with product_upsert from the start.

Check the result: store_status, then add a physical product to a cart. GET /storefront/carts/:token/shipping-rates lists the options the buyer will see.

Shipping an order

1. orders_search with fulfillment_status: "unfulfilled" lists what to ship today.
2. order_action with action: "fulfill", and carrier, tracking_number and tracking_url when there is a guide. The buyer gets the "tu pedido va en camino" email unless notify_customer: false.
3. For partial shipments, send items with the order item ids and quantities.

Tax on shipping

If the store charges VAT on shipping (the default in Mexico), leave settings.tax.applies_to_shipping: true. With tax-inclusive prices, the shipping price already includes VAT.

Raw Markdown for agents: skills/configure-shipping/SKILL.md · Edit on GitHub