menu-icon

Table of Contents

    Table of Contents

      Share On

      X IconLinkedIn IconFacebook Icon
      HomeIntegrationChefz
      Date: 11 June 2026

      Chefz Sales Channel Integration

      This native integration with Chefz enables order, catalog and inventory synchronization seamless.

      Version: v1.0
      Date: June 8, 2026
      Owner: Sales Channel Product Team

      1. Overview

      What this integration does

      The Chefz integration connects your Chefz Marketplace store with Omniful so that:

      • Orders created through Chefz automatically sync to Omniful for processing.
      • Inventory availability maintained in Omniful can be synced to Chefz.

      2. Prerequisites

      2.1 Sales Channel prerequisites

      You will be required to obtain the following details from Chefz:

      • Client ID
      • Client Secret
      • Note: You may need to request the above from Chefz Support.
      • Important: Please ensure that the entire catalog is deleted from Chefz before proceeding with the integration, as the catalog will be managed exclusively by Omniful moving forward.

      3. Integration Methods and Setup

      3.1 Connect Chefz store in Omniful

      Once you have the required details:

      In Omniful, go to:

      • Settings

      • Apps & Integration

      • Sales Channel Apps

      • Select Seller and choose Chefz from the marketplace section.

      • Click Add Store. 1.png

      • Enter your Store Name and the required Store API information in the respective input fields.

      • Click Integrate to complete the integration process. 2.png

      4. Omniful Configuration

      Once the store is connected, configure how data flows between Chefz and Omniful.

      4.1 Store-level settings

      Depending on your requirements, you can enable:

      • Order Sync – Enables listening of newly created orders from Chefz.
      • Inventory Sync – Enable real-time changes of available quantity of products from Omniful to Chefz. 3.png

      4.2 Hub Mapping

      Configure how Chefz orders are routed to Omniful hubs:

      • Map Omniful Hubs to the Branches configured in Chefz. 4.png

      4.3 Order status mapping

      Defines how Chefz and Omniful statuses stay in sync.

      • Sales Channel Mapping – Map incoming Chefz order statuses (e.g., Accepted) to internal Omniful order lifecycle stages (e.g., New, Ready for Picking).

      • Omniful Workspace Order Status Mapping – Define which outgoing Omniful fulfillment/shipment statuses update Chefz (e.g., Ready For Pickup, Canceled).

      Note: These status mappings have been fixed internally by the system. This is a view-only setting.

      4.4 Logs

      There are three types of logs in the Logs section:

      • Failed Events – Use the Failed Events section to see the failed API calls to Chefz.
      • Configurations – Use the Configuration Log to track changes to configurations.
      • File Processing Logs – Use this section to track failures in catalog sheet processing. 5.png

      5. Data and Sync Behaviour

      5.1 Orders

      • All orders for the mapped hubs will sync to Omniful.
      • Orders with type Pickup will appear as Click & Collect Order in Omniful.

      5.2 Catalog

      Sellers can upload their Chefz Catalog through Omniful's Upload Catalog and Upload Product Category features to create their catalog in both Chefz and Omniful.

      5.3 Inventory

      Omniful maintains per-hub inventory levels for the Chefz store. When Inventory Sync is enabled, Omniful sets Chefz SKUs to the available quantity of the corresponding mapped hub.

      5.4 Cancellations

      • Cancellations – When 'Automated Order Cancellation On Sales Channel' is enabled, canceling an order in Omniful triggers an automatic cancellation on Chefz, keeping both systems aligned.
      • Rejections – When 'Automated Order Rejection' is enabled, Omniful triggers an automatic cancellation on Chefz when inventory is insufficient or the SKU is not present in the Master Catalog.

      6. FAQs

      Q: My Chefz orders are not appearing in Omniful. What should I check?
      A: If orders are not syncing, verify the following: Order Sync is enabled in Store-Level Settings, and the order belongs to a Chefz hub that is mapped to an Omniful hub.

      Q: Why are cancellations from Omniful not reflecting on Chefz?
      A: For Omniful → Chefz cancellations to sync back, "Automated Order Cancellation on Sales Channel" must be enabled.

      Q: Who is the inventory master?
      A: Omniful is the inventory master. When Inventory Sync is enabled, Omniful sets Chefz SKUs to the available quantity of the corresponding mapped hub.

      Q: Who creates shipments of orders from the Chefz store?
      A: Shipment and delivery is managed by Chefz only. Shipment status is not updated by Omniful.