Troubleshooting

For merchants

Logs

Click and Pick writes to Shopware's main log (var/log/<env>-<date>.log). Notification failures in its Flow actions (missing template, mail or SMS error) are logged there and never shown on screen. See Shopware: Logging.

"Self pick-up" is not offered in checkout

• The shipping method is assigned to the sales channel (Sales Channels → (channel) → Shipping methods) and active. The plugin assigns it to every sales channel on install, activation and update; check whether someone removed it since.
• Its availability rule matches — by default All customers (Shopware: Rule Builder).

No pickup locations in the list

A location appears only if all of these hold:

1. It is active. New locations are saved inactive unless you switch Active on.
2. It is assigned to this sales channel.
3. It is open on at least one day of the next 14 days, in its own time zone — check the weekly schedule and special dates.
4. If Enable pickup location selection is off: it is the storefront's default location (Default Sales Channel).

A location closed today is still listed; the customer then picks a later date.

No time slots for a date

• The location is closed on that date (weekly schedule or a special date).
• All slots on that day are in the past.
• The location's time zone is wrong, shifting the opening hours. New locations start on UTC; set it to e.g. Africa/Lagos.

Checkout blocked: pickup location or time required / invalid pickup time

The order cannot be placed with Self pick-up until a valid location and a pickup time are chosen, and the time lies within the location's opening hours. Messages: "Please select a valid pickup location…", "Please choose a pickup time…", "The selected pickup time is outside the location's opening hours…". Common causes: no time chosen yet; the location was deactivated or removed from the storefront during checkout; a stored time no longer fits the opening hours (e.g. the schedule changed); selection is switched off and no location has this storefront as its Default Sales Channel.

"Pay on pickup" is not offered

It is only available when Self pick-up is the selected shipping method (rule Payment method is self pick-up), and it must be assigned to the sales channel.

If Pay on pickup is somehow selected with another shipping method, checkout is blocked with unsupported delivery method.

The store did not receive the pickup email

• The flow Send pickup notification to admin is active (Settings → Flow Builder).
• The pickup location has a correct email.
• Shopware can send mail (Shopware: Mailer), and — if mail is sent via the queue — a queue worker is running.
• The shop log mentions a missing template or mail error; notification errors are logged, not shown.

The customer did not get "ready for pickup"

• The delivery status was set to Ready (not Shipped), and you clicked Update status in the dialog.
• The flow Send pickup ready mail to customer is active and uses the trigger Pickup order ready.
• The order was placed with Self pick-up and its pickup location still exists — the email is skipped otherwise.
• Mail sending works — see the previous section.

Pickup details missing on older orders

Before 0.10.0, opening an order in the Administration could delete its pickup record, leaving the Pickup information tab with No pickup information. Updating the plugin (plugin:update) stops this and moves records that were still attached to an Administration draft back to the order. Records already deleted can't be recovered — the store and ready emails sent at the time still contain the details.

The pickup time looks wrong

The confirmation page, both emails, the SMS to the location and the order's Pickup information tab show the pickup time in the location's time zone. If it looks off:

• check the location's time zone — new locations start on UTC;
• the Selected on date on the order tab is in your user's time zone (your user menu → Your profile → Time zone);

"Use my location" does not appear

• Enable sorting pickup locations by distance is on for the storefront (Configuration). After an update without plugin:update, toggle it off and on again and save — see the tip there.
• The customer switched on Pickup location by distance in the storefront's cookie settings. Without that consent the link stays hidden.
• The browser supports location access. If the customer refuses the browser prompt, the list keeps its alphabetical order.

"Pickup Locations" is missing from the menu, or checkout shows no pickup fields

The plugin's built assets are out of date — for example after updating from a version that used different identifiers. Rebuild and clear the cache:

bin/console assets:install
bin/console theme:compile
bin/console cache:clear

If you install from the repository rather than a release ZIP, build the plugin's Administration and Storefront assets first (bin/build-administration.sh, bin/build-storefront.sh, or shopware-cli extension build <plugin-path>).

The SMS action does nothing

Send pickup SMS to location needs the SMS plugin installed and configured, and a phone number on the location.

Uninstalling

The shipping and payment methods are deactivated, not deleted — past orders refer to them. If you uninstall without keeping data, all pickup locations, schedules and the order pickup records are deleted; orders themselves are kept. The mail templates, the two flows and the Ready delivery status stay in Shopware.

Known issues

In 0.10.0:

Issue	Impact	Workaround
No slot capacity, lead time or cut-off rules.	Any open slot can be booked.	A developer can add rules — see Extending.

Fixed in 0.10.0 — see the Changelog: pickup details no longer lost when an order is opened in the Administration; locations closed today stay selectable; a pickup time is required; turning off location selection locks the default location; pickup times in the location's time zone everywhere including the SMS; translated checkout labels and Flow Builder triggers; the upgrade gap for the Default Sales Channel column; methods assigned to every sales channel; setting defaults stored; releases are now tagged, so Composer can require a version.

Still stuck? Contact support with versions and log lines.