commercetools Connect

To evaluate the certified fulfillmenttools integration, a test system can be provided. For access, contact the Professional Services team at [email protected].

The fulfillmenttools connector application, available in the commercetools Marketplace, is a certified integration that synchronizes information between a commercetools project and a fulfillmenttools project. It enables the fulfillment of orders from an e-commerce system with a streamlined deployment process.

commercetools Connect allows functionality to be added to a project without requiring dedicated hosting or runtime environments.

The fulfillmenttools connector application is published as open source under the MIT license and is available in a GitHub repository.

Receiving orders at fulfillmenttools

The fulfillmenttools connector application utilizes commercetools subscriptions to react to order status changes. When the commercetools OrderState of an order changes to Confirmed, the connector creates a corresponding new order in the fulfillmenttools platform.

A diagram showing a commercetools order with state Confirmed being sent to the fulfillmenttools connector, which then creates an order in the fulfillmenttools platform.

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 is created in the fulfillmenttools platform. Throughout the lifecycle of the pick job (e.g., picking started, finished) and the corresponding handover job (e.g., created, handed over), the fulfillmenttools platform sends events with status updates. The connector application processes these events to update custom fields and the ShipmentState of the commercetools order.

A diagram showing that as a fulfillmenttools order progresses through states like pick job created and handover job created, events are sent to the connector, which in turn updates the status of the original 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