ShiftDocs

Orders and shipping

Create an order

Last updated

This page covers regular (B2C) orders: B2B, Quick Delivery, and Return orders are each created from a different place (see Where each order type is created). Go to Orders > Forward Orders > Create Order to open the order creation side panel. It has two tabs - Single Order (for creating one order) and Bulk Order (for uploading many at once, see Upload orders in bulk). On Fulfillment Services, Create Order is under Orders > Outbound Orders, with Ship from: Warehouse or Self Shipping; see the Fulfillment guide.

Where each order type is created

Shift's order types are each created from a different place:

  • Regular (B2C) order: Orders > Forward Orders > Create Order.
  • B2B order: B2B Orders (sidebar - only shown once B2B is enabled for your account; ask support) > Create Order.
  • Quick Delivery (Hyperlocal, same-city rider) order: Quick Delivery (sidebar) > New Order, which opens the Create Quick Order screen.
  • Return order (bringing a delivered regular order back from your customer): the Return button (or three-dot > Create Return) on a Delivered order, or Orders > Returns > Create Return.

B2B and Quick Delivery orders follow their own rules, covered in their own guides.

How orders get into your orders list (manual, channel sync, open API)

There are three ways orders end up in your Forward Orders list:

  • Manually, via the Create Order button: single order creation (see Sender (pickup) address) or bulk CSV upload (see Upload orders in bulk).
  • Synced in automatically from a connected sales channel: orders from Shopify, WooCommerce, Flipkart, Amazon, etc. sync in on their own once a channel is connected, landing in the New tab alongside manually created orders. Each order row shows a small source icon/label (e.g., Shift, Shopify, Flipkart) so you can tell where it came from - see each channel's own guide for its specific sync behavior.
  • Via the Open API: if you have your own systems, you can create orders programmatically instead of using the UI. See Creating orders via the open API.

Sender (pickup) address

Under Pickup from, choose an existing saved pickup address (Select pickup address), or add a new one with Add Pickup. A new sender address requires phone OTP verification before it can be used: existing saved addresses don't need this. If you don't select a sender address at all, your account's primary address is used automatically.

Receiver details

PO box and army/APO addresses aren't supported as delivery addresses - use a full street address.

Under Deliver to, choose an existing saved customer/receiver (Select customer / recipient), or add a new one with Add New: name, phone, email, address lines, city, state, and a 6-digit pincode. You can optionally save a new receiver as a customer for reuse next time.

Note: when adding or editing a receiver through this UI, email is a required field. Bulk order upload is more lenient here - Customer Email is optional in the CSV template (see Bulk order upload required columns). If your customer hasn't given you an email, enter your own, or set a default receiver email under Settings > Preferences & Defaults > Receiver Email: once configured, it fills in automatically (see Default receiver email).

Products

Add one or more product rows - name, SKU, weight, quantity, and price are required for each. You can pick from your saved product catalog (selecting the same product again just increases its quantity instead of adding a duplicate row) or enter details manually. Quantity per product must be between 1 and 100. There's no fixed limit on the number of product rows in one order.

Package details

A regular (B2C) order is booked as a single package: one set of dead weight and dimensions for the packed parcel. (Shipments with several boxes are supported in B2B Orders, which has a No. of box field - see the B2B orders guide.) Under Package Details, either select a saved Package Type with Select package (this auto-fills length/breadth/height) or enter the package dimensions and dead weight manually. Enter the weight and size of the packed parcel (box and packaging included) - if the courier's re-weigh comes out higher, it's flagged as a weight discrepancy and the extra charge is applied unless you dispute it within 5 working days (see Weight discrepancy disputes). If you leave dimensions blank, Smart Package Selection may fill them in automatically - see Smart package selection.

Minimums: 0.50 kg for dead weight is recommended, though any weight greater than zero is accepted. The minimum chargeable weight is 0.50 kg: a lighter shipment is still charged as 0.50 kg. Weight allows decimals, but dimensions (Length, Width, Height in cm) must be whole numbers greater than zero: at order creation and when you edit the order later (see Order detail page).

Weight limit: the larger of your dead weight or volumetric weight (Length × Breadth × Height ÷ 5000) - called your Applicable Weight: cannot exceed 25 kg, and this is what your freight charges are calculated on. Orders above this limit can't be created/shipped as a single package.

Note: your final chargeable weight may still be rounded up to the weight slab of whichever courier you select at Select Carrier (see Choose a courier) - the Applicable Weight shown while creating the order is the basis for that calculation, not necessarily the exact final charge.

Payment mode (COD vs. prepaid)

Under Product Catalog & Payment, choose Payment Mode COD or Prepaid (PPD) for the order - this is required and affects which carriers are available later at Select Carrier (see COD vs. prepaid carrier availability). COD orders may carry additional charges; Prepaid orders don't have this extra charge.

COD charge: it's added to your shipping charges (the same as any other freight cost), not deducted from your COD remittance. The exact rate can vary by courier partner, so check the Charges Breakup at Select Carrier (see Choose a courier) for the amount that applies to your shipment.

Custom order number

On Orders > Forward Orders > Create Order, the optional Custom Order Number field lets you use your own reference instead of Shift's generated order number. It's checked live for uniqueness against your existing orders - if it's already used, you'll see "Order number already exists or is invalid." If you leave it blank, Shift generates one for you.

Other charges and discounts

Under Product Catalog & Payment on Orders > Forward Orders > Create Order, click Add other charges and discounts? (Optional) to open four optional fields (in ₹): Shipping Charges, Gift Wrap, Transaction Charges, and Total Discount. These are what you charge your customer on top of the product price, or take off it - the Shipping Charges field here is what your customer pays you for shipping, not what Shift charges you. The order summary shows Sub Total for Product, Other Charges (Shipping Charges + Gift Wrap + Transaction Charges), Discount, and Total Order Value, and the Other Charges and Discount also appear on the order invoice.

How other charges and discounts affect freight, COD charge, and E-Way bill

These change your order value, not your freight rate. Freight is still based on the package weight (see Package details). But the Total Order Value - products plus these charges, minus the discount - is the order value Shift uses for the order, so on a COD order a higher order value can mean a higher COD charge (see Payment mode (COD vs. prepaid)), and it counts toward the ₹50,000 E-Way Bill threshold (see High-Value orders).

Return address and billing address

Under Pickup from on Orders > Forward Orders > Create Order, if the selected pickup address doesn't already have its own RTO address, the Use same address for RTO (Return) checkbox is shown, selected by default. Unselect it to enter a different return address: Full Name, Phone, Email, Address Line 1, Address Line 2, Pincode, City, and State. There's no option to enter a different billing address on the Create Order screen.

High-Value orders

If your order's declared value is ₹50,000 or more, an E-Way Bill number is required before the order can be shipped (you'll be prompted for this at Select Carrier). This applies to both COD and Prepaid orders: COD is still allowed above ₹50,000 (see High-Value orders and E-Way bill at select carrier). If such a shipment is lost or damaged, Shift's maximum liability is still ₹2,000 (or the product value, if lower).

Ship now vs. create order

At the bottom of the Single Order tab, Create Order saves the order at New status without shipping it, so you can ship it later from Orders > Forward Orders. Ship Now creates the order and immediately continues into the Select Carrier screen (see Choose a courier). Both buttons are disabled when the order's dead or volumetric weight exceeds 25 kg (see Package details).

Creating orders via the open API

If you run your own systems, you can create and ship orders programmatically instead of using the UI, using Shift's Open API.

Getting your API key: go to profile avatar > My Profile > API Key: the key is shown masked (with a show/hide toggle and a copy button), and Regenerate key lets you rotate it. Available on Enterprise and Fulfillment Services plans.

Authentication: send your key in an X-API-Key request header.

Key endpoints:

  • A cost-estimate/rate-lookup endpoint, similar to what the Select Carrier screen (see Choose a courier) shows you in-app.
  • A create-and-ship endpoint that creates the order and books the shipment in a single call - you provide an order number, pickup and delivery locations (either a saved address ID or a full address), at least one product line (with an SKU/HSN code), and how the carrier should be chosen (either a specific carrier code, or an auto-select preference like fastest/cheapest). Weight, payment details, and dimensions can also be included for accurate rating.

Availability: Open API order creation is available on the Enterprise and Fulfillment Services plans. It isn't available on Prime or Growth.

Same rules apply: orders created via the Open API follow the same platform rules as orders created in the UI - the 25 kg weight limit (see Package details) and the ₹50,000 E-Way Bill requirement for both COD and Prepaid orders (see High-Value orders) both apply here too.

For full technical details (request/response formats, additional endpoints), reach out to support for the API documentation.

How do I create an order, and how is that different from shipping it?

For a regular (B2C) order, go to Orders > Forward Orders > Create Order: the Single Order tab for one order, or Bulk Order to upload many via CSV (see Upload orders in bulk). (For B2B, Quick Delivery, and Return orders, see Where each order type is created.) Fill in your pickup address, receiver, products, and package details, and choose a payment mode. Creating and shipping are two separate steps: Create Order saves the order at New status, with no courier chosen yet. Ship Now: on the Create Order screen, or on the order later - opens Select Carrier (see Choose a courier), where booking a courier creates the shipment, assigns a tracking number (AWB), and moves the order to Ready to ship.

How do I create multiple orders at once?

Use the Bulk Order tab on the Create Order screen to upload a CSV file with many orders (see Upload orders in bulk), instead of creating them one at a time.

What do I need before I can create and ship orders?

A completed KYC (needed to recharge your wallet, so you have funds to pay for shipping) and, ideally, at least one saved pickup address (if you don't select one, your account's primary address is used automatically). See the Complete your KYC guide for details.

Will syncing my channel again create duplicate orders?

No - from any channel (Shopify, WooCommerce, Flipkart, Amazon), a sync only creates new records for orders that haven't been synced into Shift yet. Orders already in Shift aren't created again, whether the sync runs on schedule or you click Sync orders on Setup & Manage > Channels - but status changes made in the channel (for example, a cancellation) are still picked up and update the existing order.

Can I create orders through an API instead of the UI?

Yes - Shift has an Open API for creating and shipping orders programmatically. Get your API key from profile avatar > My Profile > API Key (available on Enterprise and Fulfillment Services plans), and authenticate using an X-API-Key header. It isn't available on Prime or Growth. Reach out to support for the full API documentation.

Still need help?

Your account manager and our support team are a message away.

Talk to us