githubEdit

commercetools connect

The fulfillmenttools connector apparrow-up-right in the commercetools marketplacearrow-up-right is a certified integration connector that synchronizes information between your commercetools and your fulfillmenttools project. It's fully customizable and very easy to set up and deploy, so you can start fulfilling orders from your e-Commerce system without a complicated integration process.

commercetools Connectarrow-up-right lets you add functionality to your project without buying and maintaining dedicated hosting or runtime environments.

Our fulfillmenttools connector app is published as open source under the MIT license. You can check it out from our GitHub repositoryarrow-up-right.

Receiving orders at fulfillmenttools

The fulfillmenttools connector app uses commercetools subscriptionsarrow-up-right to get notified once the commercetools OrderStatearrow-up-right of an order is changed to Confirmed. With this status the commercetools order is ready and a new order is created in the fulfillmenttools platform.

ct order to fft

Depending on the shipping method of the commercetools order, either a ship-from-store or a click-and-collect order is created in fulfillmenttools.

Fulfillment status update at commercetools

As a result of the order routing process, a pick job will be created in the fulfillmenttools platform. During the lifetime of the pick job (picking started, finished) and the corresponding handover job (created, handed over), the fulfillmenttools platform will send out events with status updates. The fulfillmenttools connector app processes this information to update the custom fields and the ShipmentState of the commercetools orderarrow-up-right.

fft status to ct

Events used to update the commercetools order

The following fulfillmenttools events are used to update the commercetools order:

Event
Action

ORDER_CREATED

Set custom field fft_order_id

PICK_JOB_CREATED

Set custom fields fft_pickjob_id, fft_short_id, and fft_facility_id

PICK_JOB_PICKING_FINISHED

Set custom field fft_load_units_amount

HANDOVERJOB_CREATED

Set custom field fft_handoverjob_id, update ShipmentState to Ready

HANDOVERJOB_HANDED_OVER

Update ShipmentState to Shipped

Last updated