FleetConnector Detrack Documentation

Automatic Delivery Creation

FleetConnector Detrack automatically creates deliveries for you:

• • When an order is created, the plugin creates a delivery in Detrack
• • The delivery date is set based on your configured delivery date plugin or defaults
• • Deliveries appear in your Detrack dashboard ready for assignment to drivers
• • The DO number (the order number) and the job date are saved to the order for tracking and synchronization
• • Updates and deletes use the saved job date, so a fallback date never moves an existing job and a delete always reaches the right job
• • The tracking link is taken from Detrack’s tracking_link

Life cycle

• • Created right after the delivery is sent to Detrack.
• • Follows every change of the order (address, products, dates), also after the delivery is completed, for example when a rental is extended.
• • Removed when no product in the order needs a pickup anymore, and created again when one does.
• • Removed together with the delivery whenever the plugin removes the delivery, for example when the order is cancelled and the plugin is set to delete it then (see 2.4).
• • Left alone once the pickup itself is completed or failed.

• • The number of days comes from the product, then from its category, then from the “Pickup after (days)” setting (default: 7).
• • The setting “Count pickup days as” chooses calendar days (default) or business days. Business days are Monday to Friday; developers can change them with the fcd_business_days filter.

• • A failed delivery or pickup sets the “Delivery Failed Status” right away, with both rules.
• • A pickup that is removed because no product needs it anymore no longer holds the status back: the status is set then.

• • The order types are Detrack’s job types: Delivery (D) and Collection (P). Collection is Detrack’s own word for a pickup.
• • The type is part of the job’s identity (DO number + date + type), so an existing job keeps its type. When the products change the type later, the order gets a note and the activity log a warning instead.
• • The pickup is a Collection job with DO number <DO>-P on the pickup date. It has the same address and contact details as the delivery and the same webhook URL with your secret token, so its status updates arrive like those of the delivery.
• • Its payment_amount is 0: a cash-on-delivery amount is only collected on the delivery, never twice.
• • After a timeout, the plugin looks the pickup up with /dn/jobs/show (the -P DO number, its date and type Collection) before it sends it again, so no duplicate is created.
• • Detrack has no “cancelled” status. Time windows are only sent when custom code added them to the delivery job; “Same time window as the delivery” then copies them.
• • There is no background queue: a failed pickup is retried on the next update of the order, with the order action “Update Detrack description” or with the bulk action “Update Detrack descriptions”.

Webhook security

• • Token: a request with a wrong token is rejected.
• • Verified with the Detrack API: before an order is changed, the plugin fetches the job from the Detrack API with your API key and uses that data. A forged request with a guessed DO number can’t complete an order.
• • Formats: both JSON and Detrack’s older form-encoded json field are accepted.
• • Each status once: when Detrack sends the same status more than once, it is applied only once.

WooCommerce → Detrack Flow

Detrack API v2 endpoints used

• POST /dn/jobs: create a delivery job
• PUT /dn/jobs/update: update a job (by DO number and job date)
• DELETE /dn/jobs/delete: delete a job (by DO number and job date)
• GET /dn/jobs/show: look up a job, for example to verify a webhook

Delivery Data Structure

{
    "data": {
        "type": "Delivery",
        "do_number": "1234",
        "date": "2026-10-01",
        "order_number": "1234",
        "address": "Keizersgracht 123, 1015 CJ Amsterdam, Netherlands",
        "address_1": "Keizersgracht 123",
        "postal_code": "1015 CJ",
        "city": "Amsterdam",
        "country": "Netherlands",
        "deliver_to_collect_from": "Jan Jansen",
        "phone_number": "+31612345678",
        "notify_email": "jan@example.com",
        "instructions": "Order Number: 1234 …",
        "items": [
            {
                "sku": "SKU-001",
                "description": "Product Name",
                "quantity": 2
            }
        ],
        "invoice_number": "1234",
        "invoice_amount": "49.99",
        "payment_mode": "online",
        "payment_amount": 0,
        "webhook_url": "https://yoursite.com/wp-json/fleetconnector-detrack/v1/webhook?token=…"
    }
}

Field notes

• • do_number is the WooCommerce order number.
• • address is the shipping address, or the billing address when the order has no shipping address. It is formatted in the WooCommerce address format of the order’s country and always includes the country name (and the state, for countries such as the US, Canada and Australia). The parts are also sent separately (address_1, postal_code, city, state, country).
• • payment_amount is the order total only for cash on delivery; for all other payment methods it is 0.
• • webhook_url makes Detrack send status updates of this job to your site (see 5.1).

Phone number

The phone number is converted to international format with the calling code of the order’s country: the shipping country, or the billing country when the phone number came from the billing details.

• • A number that starts with + is kept as it is.
• • A 00 prefix is replaced by +.
• • North America (+1): a 10-digit number gets +1; an 11-digit number starting with 1 gets +.
• • Italy, San Marino and Vatican City: the leading 0 is kept after the country code.
• • A number that already starts with the country code (no leading 0, at least 10 digits, at least 8 digits after the code) is kept with a + in front.
• • Otherwise the leading 0 is dropped and the country code is added (0612345678 → +31612345678 for the Netherlands).

An order without a phone number is sent without a phone number; no placeholder number is used.