commercetools connect

The fulfillmenttools connector app in the commercetools marketplace 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 Connect 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 repository.

Receiving orders at fulfillmenttools

The fulfillmenttools connector app uses commercetools subscriptions to get notified once the commercetools OrderState of an order is changed to Confirmed. With this status the commercetools order is ready and a new order is created in fulfillmenttools.

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 fulfillmenttools. During the lifetime of the pick job (picking started, finished) and the corresponding handover job (created, handed over), fulfillmenttools sends out events with status updates. The fulfillmenttools connector app processes this information to update the custom fields and the ShipmentState of the commercetools order.

Events for 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