Fluent Commerce Logo
Docs

commercetools connector - Location Sync

FeatureFeature overview

Changed on:

6 June 2026

Overview

A Location is any place where an order can be fulfilled and/or collected by the customer. Locations can include a physical store, warehouse, drop ship vendor, lockers or third-party collection points. Locations will be synced from Fluent to commercetools. The existing entity in commercetools for Fluent location is Channel.

How it Works

The location will be synced from Fluent to commercetools via a job. The job will consist of a timestamp parameter to be set in fluent Settings. On behalf of setting values ie. dates, and props such as network, commercetools channel details will get created/updated in the merchant center. `Setting Name: fc.connect.commerce-tools.batch.batch-location-sync`

Location update specification

A GraphQL request looks like shown below:

Location Sync scenarios

There are two scenarios for sync locations:
  • Full & Partial sync
    • Full & Partial sync should be implemented using a setting in the Fluent configuration interface, commercetools connector fetches all Fluent locations modified since chosen data against the mapped network
  • Delta sync
    • Delta sync can be executed daily on the desired frequency and it fetches all Fluent locations modified since the last sync.
No alt provided

Fields Mapping

The below fields will need to be created and mapped in commercetools to keep all data coming from Fluent
Fluent Field Namecommercetools Field Namecommercetools custom field identifier
RefChannel Key
Store NameChannel Name
PhonePhone No.flStorePhoneNo
User EmailEmailflStoreEmail
TypeTypeflStoreType
StatusStatusflStoreStatus
Address Line 1Street Name
Address Line 2City
Address Line 3State
Address Line 4Postal Code
Address Line 5Country
LatitudeLatitudeflStoreLatitude
LongitudeLongitudeflStoreLongitude
TimezoneTimezoneflStoreTimezone
Opening HoursOpening ScheduleflOpeningSchedule
AttributesAttributesflStoreAttributes