Skip to content
Marketing Factory Digital GmbH
Contact
Logo Marketing Factory Digital GmbH
  • Agency
    • About us
    • History
  • Services
    • Consulting, Analysis and Strategy
    • Programming and Development
      • Interface Development
      • PIM/ERP Links
      • Custom Development
      • Seamless CMS Integration
    • Hosting and Support
      • Cloud Strategies
      • Hosting Partners of Marketing Factory
    • Services with Third Parties
  • Technology
    • TYPO3
      • Current TYPO3 Versions
    • Shopware
    • IT Security
      • DDoS Protection
      • Continuous Upgrading
      • Privacy First
    • Tech Stack
      • Commitment to Open Source
      • Technology Selection
      • PHP Ecosystem
      • Containerisation & Clustering
      • Content Delivery Networks
      • Search Technologies
  • References
    • Projects
    • Clients
      • Client List
    • Screenshot of the homepage of the new Maxion Wheels websiteNEW: Relaunch of the corporate website of Maxion Wheels
  • Community
    • Community Initiatives
  • Blog
  • Contact
  • Deutsch
  • English

You are here:

  1. Blog
  2. Development of an interface from Addressware to Shopware 6 to increase address quality
Houses in Oxford
  • Development
  • E-commerce
  • Shopware
12.10.2022

Development of an interface from Addressware to Shopware 6 to increase address quality


At the latest when it comes to shipping goods ordered online, a physical address is necessary - at least until replicators are not in all households ;-). Only with a correct postal address can senders ensure that the shipments reach the recipient. Incorrect addresses result in manual post-processing during routing coding or increased returns. The larger the number of shipments, the more important it is to have the correct address, since manual post-processing of the address data is too expensive.

Therefore, our customer Westfalia Werkzeugcompany GmbH & Co. KG uses the product Addressware from ESW for the address check. This solution is used both internally and in the online shop for address validation.

Show larger version for: ESW: Concept sketch
ESW: Concept sketch

Connection of Shopware 6 online shop to Adressware

As in the existing Westfalia online shop, the address check when entering addresses is also to be implemented in the relaunch project based on Shopware 6. The software offers the option of proposing, validating and correcting addresses from Germany, Austria and Switzerland internally. No connection to an external system is necessary for this, the data does not leave the systems of the shop operator: Important for compliance with the DSGVO and the TTDSG.

In Shopware 6, the implementation had to be largely revised and supplemented with additional new functionalities.

In the first step, we developed a concept that is as intuitive and user-friendly as possible. First of all, a distinction must be made between the two topics "suggestion" and "validation".

Show larger version for: ESW: Street suggestions
ESW: Street suggestions

Suggested addresses

When suggesting addresses, we use the functionality to suggest complete addresses, i.e. streets with postcode and city, in the combined input field for street and house number. The user's input is used to search for the most suitable streets. For the sake of clarity, the suggested list of addresses that are displayed, based on the street, is limited to ten entries.

 

Show larger version for: ESW: Zip code and city
ESW: Zip code and city

Ideally, the street is fairly clear and the user can select the suggestion they want. The street name is completed and the input fields for the postal code and the city are filled out.

If the user has already entered the zip code and/or the city, contrary to the order in which the input fields were entered in Shopware 6, the suggestions for the street will be much more precise, since the results for a street depend on the zip code and the city. Of course, it can also happen that no street is suggested at all if the entry does not match the postcode or the city or if the postcode and city do not match.

The input fields for the ZIP code and the city, on the other hand, are independent of other input fields. Does that mean that e.g. For example, the suggestions for the postal code are not limited by a street that has already been entered. The suggestions for a postal code always include the city, but never a street. Similarly, the suggestions for a city always include the postal code.

Shopware 6 also expects the house number in the street input field, but this is not taken into account in the suggestions. That will be important later.

Show larger version for: ESW: Valid address
ESW: Valid address

Validation of addresses

The validation of the address takes place as soon as a suggestion is selected and all three input fields for the address each have a value. Of course, if one of the values is changed, a new validation takes place. A delay is implemented here so that no validation disco occurs when typing.

The validation is visually displayed to the user below the input fields with the native alert messages "warning" or "success" from Shopware 6. Here we can distinguish between three cases:

  • If the validation is successful, the address is shown as valid.
Show larger version for: ESW: No house number
ESW: No house number
  • If the validation is unsuccessful, there are two possibilities. If a suggestion list can be created based on the input or the address can even be corrected, then the first or the corrected entry will be displayed to the user. Here we have based ourselves on the well-known "Did you mean..." from other search systems and leave the decision to the user. At this point, we deliberately decided against automatically correcting the address in the input field if the address check returns a corrected address. The decision is still up to the user and nothing happens "behind their back". Also, there may be edge cases where the user enters a new address that is not yet known to the system. In this case, he even has to ignore the validation.
  • Finally, there is still the possibility that the address is not valid and cannot be corrected. Unfortunately, this always happens when a suggestion is selected. We remember that the suggestions never include the house number. However, the validation expects a complete address with house number. In this case, we will at least indicate that the house number may be missing. So the user can still add them and the address is valid.

Conclusion

Basically, the implementation of the address check only serves as an input aid and is intended to reduce typing errors. The validation also only serves as an orientation for the user and is formulated accordingly. Therefore, an incorrect validation still allows the form to be submitted.

 

ESW Demo

ESW in Action:

Outlook

So far we have carried out the integration for our customer Westfalia. The connection will be revised for the next version of Addressware and can then also be used in other shops.

 

Christoph Schneider
Get blog posts as RSS feed

Related blog posts

  • Logging-Extension for Shopware 6
  • Efficient review environments: Why we replaced Kubernetes with Virtual Machines
  • Show Trusted Shops reviews in Shopware 6
  • Extension UTM parameters in Shopware Store

Please feel free to share this article.


Comments

No comments yet.

Write a comment.

I have been informed that the processing of my data is on a voluntary basis and that I can refuse my consent without detrimental consequences for me or withdraw my consent at any time to Marketing Factory Digital GmbH by mail (Erkrather Straße 401, D-40231 Düsseldorf) or e-mail (info@marketing-factory.de).

I understand that the above data will be stored for as long as I wish to be contacted by Marketing Factory. After my revocation my data will be deleted. Further storage may take place in individual cases if this is required by law.

  • Data privacy policy
  • Legal notice

© Marketing Factory Digital GmbH

Picture Credits
  1. "Houses in Oxford": Toa Heftiba / License: Unsplash License
  2. "ESW: Concept sketch": © Christoph Schneider / Marketing Factory Digital GmbH
  3. "ESW: Street suggestions": © Christoph Schneider / Marketing Factory Digital GmbH
  4. "ESW: Zip code and city": © Christoph Schneider / Marketing Factory Digital GmbH
  5. "ESW: Valid address": © Christoph Schneider / Marketing Factory Digital GmbH
  6. "ESW: No house number": © Christoph Schneider / Marketing Factory Digital GmbH