Troubleshooting

For merchants

Logs

var/log/kommandhub_africacommercecore_<env>.log (rotating, 7 files) is the plugin's log channel, but version 0.1.0 writes no entries to it. For import problems use the result table or the command output; for anything else Shopware's own log, var/log/<env>.log.

The import button shows "Reference data is disabled in the Features card"

Switch on Features → Reference data with the Sales Channel drop-down on All Sales Channels, Save, then click the button again. A value set for a single storefront is not used by the import. The command line says Reference data feature is disabled (Features card). Nothing imported. in the same situation.

The import button shows "Reference-data import failed"

The import stopped with an error. Datasets processed before the error may already be saved; running the import again is safe. Run bin/console africa:reference:import on the server to see the full error message. If the error says Cannot read reference data file, the plugin files are incomplete — reinstall the package.

Currencies are listed as "Missing"

Expected when those currencies do not exist in your shop: the plugin never creates a currency, because it needs your exchange rate. Create the ones you sell in under Settings → Shop → Currencies → Add currency, then run the import again. Currencies you do not sell in can stay missing.

The import changed a country or state I had edited

Countries are set back to active (and Ghana/Nigeria's postal-code and state settings re-applied), and state names reset to their ISO name, on every run. Tick Merchant override on the record to keep your version — see Reference data → Merchant override. For states this needs the Admin API in 0.1.0.

A country does not appear in the storefront

The import activates countries; it does not add them to sales channels. Add it under Sales Channels → your storefront → General → Countries, Save.

A state appears twice

You had created the state yourself with a different short code than the ISO code (for example LA instead of NG-LA). The import matches on the ISO code only and added its own. Deactivate or delete the duplicate you no longer need under Settings → Shop → Countries → country → States — check first that no address uses it.

The divisions row stays at 0 / "Local division" never appears

Work through these in order:

1. Administrative-division hierarchy is on under All Sales Channels, and the import was run after switching it on.
2. In the storefront in question, both Administrative-division hierarchy and Additive address fields are on.
3. The customer chose a state that has divisions — in 0.1.0 only Lagos (Nigeria).
4. Shopware's cache was cleared after changing settings (Settings → System → Caches & indexes → Clear cache), in case the storefront page was cached.

The extra address fields do not appear

Additive address fields must be on for that storefront (check the value with the storefront selected in the Sales Channel drop-down). The fields are added to Shopware's standard address form; a theme that replaces that form entirely will not show them.

The extra address details are not on the order

By design in 0.1.0: they are stored with the customer's address book entry and not copied to orders. See Address fields → Where you can see the values.

The phone check shows nothing

1. Phone normalization is on for that storefront.
2. The phone field is shown: Settings → Log-in & sign-up → Show phone number.
3. A country is selected in the form — without one no feedback is shown.
4. The feedback appears when the customer leaves the field, not while typing.

A valid number is marked as not valid

The check uses the selected country of the address. A number from another country typed without its + prefix is checked against the selected one. Typing it with + and the country code is checked correctly. The warning never blocks the form.

Known issues

• The checkout address dialog can clear saved extra details. When an existing address is edited in the address dialog during checkout, the extra fields open empty (only Account → Addresses pre-fills them). Saving the dialog then clears the stored landmark, area, directions, digital code and division of that address. Workaround: have customers edit addresses under Account → Addresses.
• Extra details are not copied to orders and not shown in the Administration.
• Administrative-division depth (Country rules) has no visible effect: the address validator that reads it is not called anywhere.
• Logging settings have no effect: the plugin writes no log entries.
• Merchant override cannot be set on states or local divisions in the Administration — no screen shows their custom fields.
• No Administration screen for local divisions; only the Lagos sample ships.
• In a German Administration the four Features switches and their help texts are shown in English (card titles, the import button and the Country rules and Logging settings are translated). There is no French Administration translation.
• After a form error, the registration and address forms show the extra fields empty again; re-enter them before submitting.