FleetConnector Routific Documentation

License States

Step 1: Create a Routific API Token

1. Log in to Routific
2. Go to Company Settings → Integrations
3. Click "Create API Token"
4. Copy the generated token

Step 2: Configure in WooCommerce

1. In WordPress admin, go to WooCommerce → FleetConnector Routific
2. Find the "Routific Connection" card
3. Paste your token in the "Routific API Token" field
4. Click "Load workspaces" and choose your workspace in the "Workspace" dropdown (selected automatically when your token has access to only one workspace)
5. Click "Test Connection" to verify the token and workspace
6. Click "Save All Settings" at the bottom of the page

Automatically send orders to Routific

When enabled, orders are sent to Routific as soon as they reach one of the selected statuses.

Send orders when the status changes to:

Choose one or more WooCommerce order statuses (custom statuses are listed too). An order is sent the first time it changes to one of these statuses and is not yet linked to a Routific order.

Only send orders that need a delivery

Skips orders without shippable products and orders with local pickup. Pickup shipping methods are local_pickup, pickup_location and local_pickup_plus (customizable with the fcr_excluded_shipping_methods filter).

Send orders in the background (recommended)

Uses the WooCommerce Action Scheduler so checkout is never slowed down by the Routific API. Temporary errors are retried automatically (see section 3.6).

Automatically sync order changes to Routific

When enabled (default), changes to an order that was already sent to Routific are pushed to the Routific order.

Remove the Routific order when the WooCommerce order is cancelled

When enabled, cancelling a WooCommerce order deletes the linked order in Routific. Default: Disabled.

Checkboxes

Delivery date plugin

When no delivery date is found

Time windows

The plugin looks for a time slot in these order fields: jckwds_timeslot, _jckwds_timeslot, _orddd_time_slot, _orddd_lite_time_slot, orddd_time_slot, _delivery_time, delivery_time, ywcdd_order_slot_from. Slots like "09:00 - 12:00", "9am - 12pm" or "09.00 to 12.00" are converted to a 24-hour time window. The start time must be before the end time.

Webhook URL

Use "Copy URL" to copy the URL for your Routific webhook:

You'll configure this in Chapter 4 (Webhooks).

Signing secret

Required. Every webhook is verified with this secret (HMAC-SHA256), so nobody else can change your orders. Without a signing secret, all incoming webhooks are rejected.

Order status mappings

Each option defaults to "Do not change status". Choose a WooCommerce status to change orders automatically:

Save the driver name on the order

Default: Enabled. Controls whether the driver's name from the published route is stored on the order. The stop number and ETA are stored whenever a route is published.

Email the Routific tracking link to the customer

Default: Disabled. Adds the tracking link as a customer note (WooCommerce sends it by email) as soon as the route is published.

Show a Routific status column in the orders list

Enable debug logging

Writes detailed information to WooCommerce → Status → Logs (source: fleetconnector-routific). Errors are always logged. Default: Disabled.

Remove all Routific links

Use this when you switch to another Routific account or workspace. It removes the link between your WooCommerce orders and Routific (the Routific order ID, status, driver, ETA, tracking link and related order data), so orders can be sent to the new account or workspace. Nothing is deleted in Routific.

Large shops are processed in batches. If the result says "orders cleaned up so far", click the button again to continue.

Clear Activity Logs

Clears all FleetConnector Routific activity logs from the dashboard.

From the Order Actions Dropdown

1. Open any WooCommerce order
2. In the "Order actions" box, open the dropdown
3. Choose one of the Routific actions below and click the update button

How to Use Bulk Actions

1. Go to WooCommerce → Orders
2. Check the boxes next to the orders you want to process
3. Select "Send to Routific" or "Update in Routific" from the Bulk Actions dropdown
4. Click "Apply"

Information Displayed

Orders that haven't been sent show "Not sent to Routific yet." and, when applicable, "This order does not require a delivery."

Status Indicators

Automatic Retries

Temporary errors are retried automatically up to three times: after 1 minute, after 5 minutes and after 15 minutes. Temporary errors are:

• Connection errors and timeouts
• Rate limits (HTTP 429)
• Routific server errors (HTTP 5xx)

Other errors, such as validation errors, are not retried. They are shown in the meta box, the status column and the dashboard, where you can retry after fixing the order.

Step 1: Get Your Webhook URL

1. In WordPress admin, go to WooCommerce → FleetConnector Routific
2. Scroll to the "Delivery Status Updates (Webhooks)" card
3. Click "Copy URL" (it will look like https://yoursite.com/wp-json/fleetconnector-routific/v1/webhook)

Step 2: Create the Webhook in Routific

1. Log in to Routific with an admin user (only admins can manage webhooks)
2. Go to Company Settings → Routific webhook
3. Create a webhook with the URL you copied and activate it
4. Subscribe to the events order.status_updated, route.published, route.unpublished and route.eta_updated

Step 3: Add the Signing Secret

1. Copy the signing secret of the webhook from Routific
2. Paste it in the "Signing secret" field in the plugin settings
3. Click "Save All Settings"
4. Use "Test connection" in Routific to check that everything works

Filters

Log Columns

Details

Click "Details" to open the Log Details window with the Request Data (the order data sent to Routific) and the Response Data (Routific's answer or the webhook payload) as formatted JSON.

How to Export

1. Set any filters you want (status, action, date range)
2. Click the "Export CSV" button
3. The filtered results download as fleetconnector-routific-logs-YYYY-MM-DD.csv

The CSV contains the columns ID, Order ID, Routific ID, Action, Status, Message, Error and Created At. Values are protected against spreadsheet formula injection.

How to Retry

1. Filter the log on status "Failed"
2. Find the failed create or update action
3. Click "Retry" and confirm

Retry runs immediately. It creates the order in Routific, or updates it when the order was already sent, so a retry never creates a duplicate.

Available Filters

Available Actions

Examples

add_filter('fcr_order_payload', function ($payload, $order) {
    // Only plan refrigerated orders on routes with the "refrigerated" tag
    if ($order->get_meta('_needs_cooling') === 'yes') {
        $payload['tags']   = isset($payload['tags']) ? $payload['tags'] : array();
        $payload['tags'][] = 'refrigerated';
    }

    // Show a gate code to the driver
    $gate_code = $order->get_meta('_gate_code');
    if ($gate_code) {
        $payload['instructions'] .= "\n\nGate code: " . $gate_code;
    }

    return $payload;
}, 10, 2);

add_filter('fcr_phone_country_code', function ($calling_code, $country) {
    if ($calling_code === '') {
        return '+31'; // Netherlands
    }
    return $calling_code;
}, 10, 2);

add_filter('fcr_delivery_date_meta_keys', function ($keys, $order) {
    array_unshift($keys, '_my_checkout_delivery_date');
    return $keys;
}, 10, 2);

add_action('fcr_webhook_order_delivered', function ($order, $data) {
    error_log('Order #' . $order->get_id() . ' delivered via Routific');
}, 10, 2);

Table: wp_fcr_logs

The wp_ prefix matches your WordPress table prefix.

Settings and Scheduled Tasks

Deactivation

Deactivating the plugin stops the scheduled tasks and removes pending background actions. Settings, logs and order data are kept.

Uninstall (Delete)

• Releases the license activation slot, so the key can be used on another site
• Deletes all plugin settings and temporary data
• Removes scheduled tasks and pending background actions
• Drops the wp_fcr_logs activity log table

Before Contacting Support

How to Contact Us