release notes

Product release update

Integration

Version 7.3.0

Compatible with Shopware 6.7.0.1 through 6.7.13.0.

This release is largely identical to version 6.9.0 for Shopware 6.6 and includes the following changes:


New functions

  • The address validation result can be saved with the shipping address (new setting, disabled by default)


Improvements

  • A separate log file instead of entries in the Shopware log
  • JS-SDK Updated to Version 1.14.5


Bug fixes

  • Webhooks for Addresses Without endereco Data
  • Crash when logging out after changing the address via the admin panel
  • Error during address validation via the Store API


Notes on the Update

See the release notes for Shopware version 6.6 below.

Version 6.9.0

Compatible with Shopware 6.6.0.0 through 6.6.10.22.

New functions

  • Save the address verification result at the shipping address: A new setting allows you to specify whether the result of the address validation should be carried over to the shipping address when the order is completed. This ensures that you can track which address details were actually validated, even if the customer later changes or deletes their address. This setting is disabled by default and applies only to orders placed after it is enabled. Existing orders remain unchanged.


Improvements

  • Custom Log File: Endereco entries are now written to a separate log file (var/log/endereco_shopware6_client_.log) instead of the Shopware log. Only critical errors are still logged in the Shopware log. Connection issues are logged as warnings instead of errors.
  • JS-SDK Updated to Version 1.14.5: Resolves conflicting statuses during address validation, missing name statuses after corrections, and incorrect selection statuses for addresses that have been edited again.


Bug fixes

  • Webhooks for Addresses Without endereco Data: If a customer had registered without the endereco address extension, the webhook transmission could fail. This has been fixed.
  • Crash When Logging Out: If an address was changed via the admin panel or directly in the database, the system might crash when logging out. This has been fixed.
  • Missing Billing for JSON Requests: Address validations via the Store API or headless clients were not billed correctly because the session IDs were not retrieved in JSON requests. Billing now works regardless of the request format.
  • Error during address validation via the Store API: If a request was sent via the Store API without a billing address, an error might have occurred. The validation now correctly handles missing address information.


Notes on the Update

This update includes a database migration. If you're using the Store version of the plugin, download the latest ZIP file and click „Update“ in the plugin list to run the migration.

The new setting „Copy address validation data to the shipping address“ is disabled by default and must be enabled manually if needed.

We recommend that you first perform the update in a test environment.

Version 1.3.2

Compatible with JTL-Shop 5.1.2 through 5.7.2

Bug fixes

  • Error Messages When Session Data Is Missing: In certain processes, warnings or errors could occur if no customer or shipping address was available in the session, such as for guest customers. Address processing now runs without errors even when session data is incomplete.


Compatibility

  • PHP 8.4: The plugin is now officially compatible with PHP 8.4.
  • JTL-Shop 5.6.2 and 5.7.2: Compatibility with the latest patch releases has been tested and confirmed.


Notes on the Update

No manual steps are required. Existing configurations remain unchanged.

Version 1.1.0

Compatible with OXID eShop 7.1 through 7.5 (Twig).

This update includes several security enhancements, full integration of the JS-SDK 1.14.5, and numerous bug fixes, particularly for the APEX theme.

Improvements

  • API Key Secured: Communication with the endereco API now takes place on the server side. The API key is no longer sent to the browser.
  • JS-SDK 1.14.5 Fully Integrated: Address validation now works correctly for countries with and without a state selection option. Outdated validation statuses are detected and corrected when the page is loaded.
  • Smart Autofill removed: This feature has been permanently disabled and removed from the plugin configuration because it led to incorrect entries in practice.
  • Name verification defined more clearly: The setting was previously called „Title Check,“ even though it controls the entire name verification process. The name has been updated.
  • OXID 7.4 and 7.5: The plugin now officially supports the latest versions of OXID as well.
  • Referrer Secured: Previously, if the Referer header was missing, the server path was sent to the endereco API. Now, the store URL is used instead.
  • Unnecessary code removed: Outdated components from the OXID 6 era and unused code have been removed. PHP warnings in various areas have been resolved.


Bug fixes

  • 502 Error During Address Validation: If no country was selected during registration or the „No title“ option was used, the address validation might have failed with a 502 error. This has been fixed.
  • Special Characters in Country Names: Country names containing apostrophes (e.g., Côte d’Ivoire) could cause the address validation to fail to initialize correctly. Character processing now works reliably.
  • The test status was not saved: For newly created shipping addresses, guest orders, and checkout registrations, the validation status was not saved correctly and was reset every time the page was loaded. The status is now saved correctly the first time it is saved.
  • Address Correction on the Order Page: Users who clicked „Edit“ in the correction dialog were redirected to the address entry page, but the form did not open there. The form now opens correctly after the redirection.
  • Checkout Buttons in the APEX Theme: The „Continue“ button in the checkout process did not trigger the address validation. The „Edit“ button closed the form again after the validation. Both buttons now work as intended.
  • Name Verification with an Incorrect Name: If a new shipping address was created in the APEX theme, the name validation might have used the name of the previous address. The cached name is now reset when a new address is created.
  • Suggestions for countries were ignored: If the address validation suggested a country other than the one entered, the suggestion was not accepted. Country corrections are now processed correctly
  • Suggested corrections in the admin area: Suggested corrections were not displayed on the customer master data and address pages in the admin panel. This has been fixed.


Notes on the Update

After the update, run the database migrations, clear the cache, and rebuild the database views.

Addresses that have already been verified will be re-verified once after the update, since the internal calculation of the address hash has changed. This happens automatically the next time the address is used.

Shops with customizations should note: The endereco API is now accessed via its own proxy controller instead of directly from the browser. And saving an address now requires a POST request from the logged-in owner of the address.

We recommend that you first perform the update in a test environment.

Version 1.14.5

This update fixes a bug in status management related to address validation.

Bug fixes

  • Conflicting Selection Status: If an address that had already been verified was edited and then reconfirmed via the correction modal, the old and new selection statuses might have been saved simultaneously. The address was then considered both automatically corrected and confirmed by the customer. The old status is now correctly removed when the address is verified again.


Notes on the Update

Version 1.14.5 replaces 1.14.4 without any further changes. Existing configurations remain unchanged.

Version 1.14.4

This update fixes two bugs in status processing during address and name validation.

Bug fixes

  • Incorrect Address Status When Spaces Are Present: Addresses that differed only in the presence of leading or trailing spaces could be assigned an inconsistent status. The address was marked as requiring correction even though it was correct. This has been fixed.
  • Missing status during name verification: If a name contained a typo during the first review attempt and was subsequently corrected, the status for the first and last names was not updated. The status is now set correctly for each relevant response.


Notes on the Update

Version 1.14.4 replaces 1.14.3 without any further changes. Existing configurations remain unchanged.

Version 1.3.2

Improvements

  • Thank You Page: If an address is recognized correctly, no suggestion is displayed. The border and rounded corners enhance visual consistency with the rest of the checkout design.
  • Configuration: The fulfillment features are marked as „beta“ and are disabled by default in new installations.

Version 1.3.1

Improvements

  • Technical Update: The app has been migrated to the latest version of Shopify. For merchants, nothing has changed in terms of how the app works. The update improves compatibility and maintainability for future versions of Shopify.

Version 1.3.0

New functions

  • Marking Orders: The result of the address validation is now automatically saved as tags associated with the order. Tags make it possible to filter and analyze orders based on address quality and to control workflows.
  • Fulfillment Hold: Orders with an incorrect shipping address can be automatically placed „On Hold“ if this feature is enabled. The hold prevents the fulfillment system from processing the order until the address has been corrected. Once the address has been corrected, the hold is automatically released.
  • Address Confirmation by the Customer: If a customer decides to keep the original address even though it needs to be corrected, this is tagged as `address_confirmed_by_customer`. An active fulfillment hold is then automatically released if the feature is enabled.
  • Automatic Correction of Minor Address Errors: Minor address errors are now automatically corrected only if the feature is enabled. The order is tagged with `address_corrected_automatically`, and any active hold is released.


Improvements

  • The configuration page has been divided into three clearly distinct sections: address autocomplete during checkout, address validation on the order confirmation page, and fulfillment settings.


Note for Retailers

  • This version requires new app permissions. After the update, merchants will be automatically prompted to confirm the new permissions.

Version 7.2.0

Compatible with Shopware 6.7.0.1 through 6.7.11.1

Improvements

  • CrefoPay PayPal Express Checkout: endereco and CrefoPays PayPal Express Checkout can now be used simultaneously. The address verification process runs without interrupting the Express Checkout. Important to note: With Express Checkout, only minor corrections are possible. If a major address change is necessary, the customer must complete the order using the regular PayPal Checkout.
  • PayPal Express Address Processing: House numbers that PayPal saves in the additional address field are now taken into account during address validation. Customers no longer need to manually correct affected addresses.


Bug fixes

  • Shopware B2B Suite: When the B2B Suite was enabled, saving an address in the shopfront could cause an error. This has been fixed.


Notes on the Update

For standard installations, no manual steps are required. If you're using the Store version of the plugin, download the latest ZIP file and click „Update“ in the plugin list. We recommend testing the update in a test environment first.

Version 6.8.0

Compatible with Shopware 6.6.0.0 through 6.6.10.19

Improvements

  • CrefoPay PayPal Express Checkout: endereco and CrefoPays PayPal Express Checkout can now be used simultaneously. The address verification process runs without interrupting the Express Checkout. Important to note: With Express Checkout, only minor corrections are possible. If a major address change is necessary, the customer must complete the order using the regular PayPal Checkout.
  • PayPal Express Address Processing: House numbers that PayPal saves in the additional address field are now taken into account during address validation. Customers no longer need to manually correct affected addresses.


Bug fixes

  • Shopware B2B Suite: When the B2B Suite was enabled, saving an address in the shopfront could cause an error. This has been fixed.
  • API Connection Test for Sales Channels: If configuration inheritance was re-enabled for a sales channel, the API connection test would fail. The test now correctly uses the global configuration.


Notes on the Update

For standard installations, no manual steps are required. If you're using the Store version of the plugin, download the latest ZIP file and click „Update“ in the plugin list. We recommend testing the update in a test environment first.

Version 4.6.0

This update brings the underlying JS SDK to version 1.14.3 and thus contains several functional enhancements and corrections.


New functions

  • Address suffix is now also checkedThe „Additional address“ field (additionalInfo) is now included in the address check.
  • Keyboard navigation in the address modal: Suggestion lists and input fields in the address modal can now be operated using the keyboard.


Improvements

  • Minor address corrections (e.g. typing errors in street names) are now automatically applied without a correction dialog appearing.
  • Input processing in address correction mode has been optimized.


Bug fixes

  • Character loss with fast input: When typing quickly in the street field, individual characters could be lost. This has been fixed.
  • Federal state field for countries without subdivisionsIf a country was selected without selecting a federal state, it could happen that an outdated value remained in the federal state field. The field now behaves correctly.
  • Address modal with hidden delivery addressIf the alternative delivery address was deactivated via checkbox, an address check was still triggered. The modal now only appears if the delivery address is actually active.


Remote functions

  • Smartfill removedThe Smartfill function has been removed as it was not working reliably. The corresponding setting has disappeared from the plugin configuration.

Version 1.2.6

New functions

  • New plan: Essential - A new entry plan for €0.04 per order with address verification on the order confirmation page, without checkout autocomplete.
  • Functions not included in the active plan are now grayed out in the app.


Improvements

  • New retailers now also receive a 30-day trial period free of charge when booking the standard plan.


Bug fixes

  • Invisible control characters in address fields could cause the address check to return no results. These are now removed automatically.

Version 1.2.5

Bug fixes

  • A billing error that could lead to incorrect or multiple billing points has been fixed.

Version 1.2.4

New functions

  • The app now shows a shortened version of the current release notes directly on the start page.

 

Improvements

  • The currently installed version and the build time are now visible in the app footer.
  • New banners now show the status on the billing page more clearly.
  • The app has been fully translated into Polish.
  • Navigation in the statistics overview has been further improved.


Bug fixes

  • Testing the checkout extension in the Shopify editor no longer generates billing entries.
  • The autocomplete instructions are now also displayed correctly when the page is loaded for the first time.
  • The change of plan now also works correctly in test stores.

Version 1.2.3

Improvements in statistics

  • Order numbers in the statistics overview are now directly clickable and lead to the corresponding order in the Shopify administration.
  • The page navigation in the statistics overview is now more consistent.


Bug fixes

  • Preview view in the checkout editor: When testing the checkout extension in the Shopify editor, billing entries were created by mistake. This has been fixed. The test runs in the editor are no longer charged.
  • Billing stability: Isolated cases in which the billing for free stores was not skipped correctly have been fixed.

Version 1.2.2

Bug fixes

  • Phone number is no longer deleted after address correction: When correcting the address on the order confirmation page, fields such as „Phone number“ or „Company name“ were previously removed from the delivery address if they were not part of the corrected address. This has been fixed. Only the address fields that have actually been corrected are updated, all other details remain unchanged.

Version 1.2.1

This version brings minor improvements and corrections to the user interface.

Improvements

  • The currently installed app version is now visible in the footer of the app. This allows you to see at a glance which version is in use.
  • The configuration page has been visually redesigned: Settings are now displayed with modern on/off switches, making operation more intuitive.
  • Merchants who run a Shopify Partner developer store will see a clearer and more concise indication of their free developer status - right above the plan selection, instead of repeatedly per plan.


Bug fixes

  • Missing and incorrect translations in the checkout extension (German and Italian) have been corrected.
  • A technical error that displayed an unnecessary message when loading the configuration page has been fixed.

Version 1.2.0

New functions

  • App repairIncorrect app installations are now repaired automatically.
  • Developer storesShopify partner developer stores are automatically recognized and receive permanent free access without subscription obligation.
  • Trial plan for test storesFor Shopify test stores, a free trial period is available, which is managed directly via the Shopify billing infrastructure.


Improvements

  • Dealer data, API keys and the booked subscription plan are completely retained when uninstalling and reinstalling, which eliminates errors when updating the app.
  • The app loads faster on the billing side, as internal processes have been optimized.

Version 1.1.1

New functions

  • Multilingual interfaceThe app and the checkout extension are now available in five additional languages: Spanish, French, Italian, Dutch and Portuguese. Shopify automatically determines the language based on the store settings.
  • Automatic GDPR responses: For data protection requests from customers (information or deletion in accordance with GDPR), the app now automatically sends a localized confirmation email to the customer.


Improvements

  • Address completion in the checkout has been made more stable: suggestions appear more reliably and without interruptions.
  • The feature list in the app has been reorganized and Shopify Plus-exclusive functions are now clearly marked.


Bug fixes

  • Address additions (e.g. building name, floor) were occasionally incorrectly included in the street name. This has been corrected.

Sign up for the newsletter