Field Kit Fulfillment (Bobgo)

Regions that ship field kits to newly formed teams can connect Lumieos to Bobgo to automate order creation, tracking, and team notifications. Once connected, a paid formation invoice that includes shipped items automatically creates a delivery order in your Bobgo account — no manual data entry required.

Note: Bobgo fulfillment applies only to formation invoices that include shipped items. See Setting Up Payments — Team Formation Invoices for how to configure shipped item pricing.

Connecting Bobgo

Admin URL: https://<your instance>/en/region/commerce/?tab=fulfillment

Only partner administrators can add or edit fulfillment configurations.

1. Open Commerce → Fulfillment tab.
2. Click Add Fulfillment Configuration.
3. Fill in the fields described in the table below.
4. Click Save. Lumieos validates the API key against Bobgo and registers your tracking webhook automatically. If validation fails, double-check that you copied the full key and that you are using a production key (not a sandbox key) for a live instance.

Note: Lumieos registers a tracking webhook with Bobgo when you save the configuration. This webhook is how Lumieos learns when Bobgo has assigned a tracking number, so it can update the invoice and notify the team automatically. No manual webhook setup is needed in Bobgo.

Automatic Fulfillment Flow

When Automatically send paid kit invoices to Bobgo is enabled, the following happens without any manual steps:

1. A team completes payment on a formation invoice that includes shipped items.
2. Lumieos creates a delivery order in your Bobgo account containing the recipient’s name and shipping address, the kit item, and the shipping fee.
3. You (or Bobgo’s own automation rules) book the courier and print the waybill from within the Bobgo dashboard.
4. When Bobgo assigns a tracking number, Lumieos receives the update via webhook, marks the invoice as Shipped, fills in the tracking number, and notifies the team.

Tip: You do not need to enter tracking numbers manually. As long as the Bobgo webhook is registered (verified on save), tracking updates happen automatically.

Manual Send & Retry

Even with automatic sending enabled, there are situations where you may need to send an order manually — for example, if a send failed or if automatic sending was disabled at the time of payment.

Admin URL: Invoice detail page — https://<your instance>/en/region/commerce/ → open the relevant invoice

On a paid formation invoice that includes shipped items:

• If the order has not yet been sent to Bobgo, a Send to Bobgo button appears at the top of the invoice detail page.
• If a previous send failed, the error message is displayed and a Retry Send to Bobgo button appears in its place.

Note: The existing Mark as Shipped action is still available as a manual override for cases where you are managing fulfillment outside of Bobgo (for example, handling a replacement shipment directly).

”To Fulfill” View & CSV Export

Admin URL: https://<your instance>/en/region/commerce/

The Invoices list includes two tools for managing outstanding fulfillment:

To Fulfill Toggle

Enable the To fulfill toggle on the Invoices list to filter the view to paid formation invoices that have not yet been sent to Bobgo or marked as shipped. Use this as your fulfillment work queue.

Export for Bobgo (CSV)

Click Export for Bobgo (CSV) to download a file of the currently filtered invoices in a format compatible with Bobgo’s bulk order import.

To import the file into Bobgo:

1. In Bobgo, go to Orders → Import CSV.
2. Upload the exported file.
3. Use Bobgo’s column mapper to confirm the header mapping (Lumieos uses standard column names that match Bobgo’s expected headers).

Tip: The CSV export is useful as a fallback if the API connection is unavailable, or for regions that prefer to review and batch-send orders rather than using the automatic integration.