Release 2026.05-R1

Released May 18, 2026.

Customer collection and delivery methods for orders

Each fulfillment order now has a delivery method: Delivery, Collection or Digital. Customer collection covers orders the customer picks up from one of your locations instead of receiving them at home.

• Collection locations. Turn on Collection Location on a location (Settings > Locations) to let customers collect orders there.
• Collections. When items for a store collection are packed, Carriyo creates a collection with its own status: open, ready to collect, collected, expired or cancelled. Closing the collection also closes the fulfillment order.
• Auto-expire and auto-cancel. Under Settings > Order Management > Collection Management, you can expire uncollected orders after 1 to 60 days. You can also cancel expired collections after a further number of days.
• Order screen actions. Fulfillment orders have new actions on the order screen: Convert to Customer Collection, Convert to Delivery, Change Collection Location, Update Delivery Address, Change Schedule and Merge Fulfillment.

Order allocation rules

A new settings page, Settings > Order Allocation Rules, controls which fulfillment locations an order can be allocated to. Each rule has a schedule, conditions and a list of eligible locations to include or exclude, ranked by priority. Conditions include merchant, sales channel, order value, count of line items, count of unique line items, dangerous goods and product category. The page is available to tenants with an orders subscription.

Delivery options

Delivery options in Settings > Delivery Options now have a Delivery Method field. Collection delivery options take a list of Customer Collection Locations and an optional maximum distance the customer travels (in kilometers or miles). The Dropoff by Geography condition is now called Customer Geography.

Product category and digital products

Products have two new fields, Category (category) and Digital Product (digital). Both appear in the product list, the inventory list and product exports. Order line items and shipment items also carry category. When a shipment item has no category, Carriyo fills it from the product catalog. The Shopify connector imports the product category and digital flag from Shopify.

Fulfillment App

• Collect. A new page for handing collection orders to customers. Staff mark collections ready, scan parcels, and complete the handover after verifying the customer with an OTP sent by email.
• Customers. A customer list and a customer page with orders, past items, addresses and associated locations.
• Shipments. A shipment detail page where you can edit items, book or reprocess, and cancel. Shipment Upload creates shipments from a file.
• Order detail. Orders now show their collections and shipments alongside picks and packs.
• Packing. Choosing a ship zone is no longer required to complete a pack.
• Theme. Set the app's brand and background colors, for light and dark mode, under Settings > System Settings > Fulfillment App Theme in the Carriyo Dashboard.

Orders API changes

These changes affect integrations that create or read orders through the Carriyo Orders API.

• Delivery address. shipping_address is replaced by delivery_address. Create requests still accept shipping_address. The address is held on each fulfillment order.
• Fulfillment order delivery fields. The delivery object on fulfillment orders is replaced by delivery_method, delivery_type, delivery_option, delivery_address, delivery_schedule, customer_collection_address and customer_collection_schedule. Order create requests accept the same fields at the root to set up fulfillment orders.
• Line items. requires_shipping is removed. Use digital to mark items that do not ship. category is new.
• Customer key. Orders now return customer_key.
• New fulfillment order endpoints. Four PATCH actions under /orders/{order_reference}/fulfillment-orders/{fulfillment_order_id}/: update-delivery-method, update-address, update-schedule and update-partner-references. The generic PATCH on the fulfillment order itself is deprecated.
• Collections endpoints. /orders/collections/... lets you look up collections by order, fulfillment order, pack or shipment, and mark ready, reopen, cancel, unexpire, send an OTP and verify-and-collect.

Shipping API changes

• partner_shipment_reference is now required when creating a shipment. Carriyo no longer copies partner_order_reference into it when it is missing. Requests without it return Partner shipment reference is required.
• Clearing fields with null. Send a top-level field as an explicit null in a shipment update or reprocess request to clear it. This works for fields such as pickup, parcels and custom_attributes.
• Date formats. Date fields in API requests accept ISO 8601 timestamps with a Z or a UTC offset, and Unix epoch values in seconds or milliseconds.
• QR code labels. Shipments can return carrier_qrcode_label_url in post_shipping_info for carriers that issue a QR code instead of a printed label.

Delivery options API changes

• Checkout delivery options. POST /checkout/delivery-options takes a flat request: merchant, order_date, payment, line_items, parcels, fulfillment_locations, customer, carriyo_metadata, delivery_methods, max_collection_locations and max_collection_distance. It replaces the earlier order_id, partner_order_reference and order shape. Each returned option now has an id and a delivery_method (previously type), plus customer_collection_locations for collection options.
• Delivery option fields. On delivery options, type is renamed delivery_method and dropoff is renamed customer. New fields customer_collection_locations and customer_collection_max_distance configure collection options.

Order webhook filtering

Order webhooks now fire on their selected triggers only. Order statuses selected on an order webhook no longer act as additional triggers.

Webhook conditions by source ID

Webhooks under Settings > Webhooks have two new conditions, Creation Source ID and Update Source ID. Use them to send a webhook only for shipments or orders created or updated by a specific source, such as one connector.

Carriyo MCP server: 63 new tools

The Carriyo MCP server grows from 17 to 80 tools, so AI agents can now act on most of the platform, not only look up shipments.

• Orders (5): create_order, get_order, list_orders, edit_order, cancel_order.
• Fulfillment orders (9): change location or delivery method, schedule, split, merge, fulfill, unfulfill, ship and cancel items. For example change_fulfillment_order_delivery_method and merge_fulfillment_orders.
• Shipments (12 new): create, edit and confirm drafts, cancel, mark_ready_to_ship, update_shipment_status, schedule_collection, schedule_delivery, update_customer_promise_date, get_shipping_rates and get_shipment_activity.
• Returns (10): create, edit, list and get return requests, and approve, reject, receive items, ship, cancel or complete them.
• Products (5) and Inventory (6): product CRUD, stock reads, update_inventory, adjust_inventory, transfer_inventory and get_inventory_history.
• Reports (11): dashboard summary, shipment status, carrier performance, failed delivery, SLA compliance, transit time, volume trend, ageing, exception history, return analytics and product performance.
• Lookups (6 new): get_merchants and the return-request reasons, resolutions, rejection reasons, item conditions and refund types.

Changes to existing tools:

• reassign_shipment no longer takes carrier. Pass carrier_id, or carrier_account_name as a fallback.
• get_accessible_tenants now returns the merchants you can access in each tenant.
• get_shipment documents its full output.

See the MCP tool catalog for each tool.

New connectors: Logistiq and Roads Runner

• Logistiq. Configure the account type, credentials, service type (Standard or Express), mode of transport (Air or Road), location mapping and references.
• Roads Runner. Set up with an API key, account and client name.

Find both under Settings > Carrier Accounts.

Carrier updates

• FedEx. The consolidated shipping settings introduced in 2026.04-R2 move into a FedEx Consolidation Shipping section, which adds a choice of consolidation type, consolidation documents and a Dropoff Type. Tracking events now include the scan location.
• UPS. A new Billing & Payment section sets who pays duties, taxes and transportation charges, including a third party. Consolidated shipping (UPS World Ease) cancels child shipments with the parent.
• EMX. New service codes and an Incoterms setting (DDP or DDU).
• Flick. Choose which reference (order, shipment or alternate) is sent as the Flick shipment identifier.
• Saudi Post. The Saudi short code is passed to the carrier.
• Happy Returns. Shipments can be cancelled, multi-parcel shipments are supported, and the drop-off QR code is returned in carrier_qrcode_label_url.
• Shipa. Updated status mapping and missing reason codes in tracking.
• Aramex. The commercial invoice is downloaded during booking.
• Intersoft. Declared value is calculated per package.
• DX. Phone numbers are sent without the + sign.
• Arabic address translation handles common Arabic names more accurately.

Connector updates

• Shopify. Order update webhooks that change nothing Carriyo tracks no longer update the order. Tracking updates on fulfilled orders no longer trigger duplicate fulfillment attempts. Shopify fulfillment order methods map to Carriyo delivery methods, and the Order Types Mapping setting is removed.
• Magento. Order webhooks use the Order Created, Order Cancelled and Order Closed triggers and fire only for orders from that connector.
• Mirakl. Carriyo no longer reports an error when it cannot create a shipment for a fully refunded Mirakl order.

Fixes

• Reason codes show again in shipment details, the Failed Delivery report and the bulk status change dialog.
• Manifests show the correct item count.
• Delivery type and order type options load correctly in connector settings.
• The Carriyo AI shipment summary loads for shipments with no pickup or drop-off state.
• The package optimizer accounts for rotated items when placing items in a package.