Skip to content

Test cases: Address mapping

A big part of the integration is the correct mapping of the address data from Abacus to Shopware. To test this thoroughly, different processes must be taken into account, and the handling in Abacus must be correct too.

1.1 Shopper with same billing and shipping address

In Abacus:

  1. Go to the Order processing module in Abacus and go to the customer base(411)
  2. Create a new customer (optional)
  3. Go to the API shop tab and generate the shopper

In Shopware:

  1. Go to your Shopware and run the webwirkung.abacus.subscription.shopper task (manual sync)
  2. Go to «Customers» and find your new shopper
  3. Log in to the Storefront and place an order with a changed address

In Abacus:

  1. Go back to Abacus -> E-business -> Edit e-documents(API)(J15)
  2. Find your order
  3. Map(edit) the shipping addresses and the invoice address
Link addressEdit addressLink contactEdit contact
Map addresses

Result

In Abacus:Map addresses

In Shopware:

  1. Go back to Shopware and execute the task webwirkung.abacus.subscription.shopper to map address IDs
  2. Under «Customers» find your shopper
  3. In the address, you should now see the new custom field with the abacus address ID

Map addresses

Final verification

  1. Login as the shopper in Storefront
  2. Place a new order
  3. Go back to Abacus -> E-business -> Edit e-documents(API)(J15)
  4. Now all 3 addresses should be "green," which means our mapping works

Map addresses

1.2 Shopper with a different billing and shipping address

In Abacus:

  1. Create a new shopper in the Abacus customer

In Shopware:

  1. Go to your Shopware and run the webwirkung.abacus.subscription.shopper task
  2. Go to the «Customers» and find your shopper
  3. Log in to the storefront and place an order with a different shipping address

In Abacus:

  1. Go back to Abacus > E-business > Edit e-documents(API)(J15)
  2. Find your order
  3. Map(edit) your shipping addresses (see screenshots below)
  4. Map(edit) your invoice address

Shipping & Invoice address mapping

Link addressEdit addressLink contactEdit contactSame on invoice
Map Shipping addressesMap Shipping addressesMap Shipping addressesMap Shipping addressesMap Shipping addresses

Result

The result should look like (now marked green):

Map Shipping addresses

In Shopware:

  1. Go to your Shopware and run the webwirkung.abacus.subscription.shopper task to map address IDs
  2. Go to «Customers» and find your shoppwe
  3. In the addresses you should see the custom field filled with the abacus address ID. This ID is different for every address:
First address with different IDSecond address with different ID
Map Shipping addressesMap Shipping addresses

Final verification

  1. Login as the shopper in Storefront
  2. Place a new order
  3. Go back to Abacus -> E-business -> Edit e-documents(API)(J15)
  4. Now all 3 addresses should be "green," which means our mapping works

1.3 Shopper with different contact persons

In Abacus:

  1. Create a new shopper in the Abacus customer

In Shopware:

  1. Go to your Shopware and run the webwirkung.abacus.subscription.shopper task
  2. Go to the «Customers» and find your shopper
  3. Log in to the storefront and place an order with the same address and company name but different first and last names

Map Shipping addresses

In Abacus:

  1. Go back to Abacus > E-business > Edit e-documents(API)(J15)
  2. Find your order
  3. Map(edit) your addresses. Here you have to choose your address from the list or Abacus will find duplicate addresses
Select address in listDuplicate address warning
Map Shipping addressesMap Shipping addresses
Link addressSelect in listLink contactEdit contactSame on invoice
Map Shipping addressesMap Shipping addressesMap Shipping addressesMap Shipping addressesMap Shipping addresses

Result

The result should look like:

Map Shipping addresses

As you see address ID is the same, butthe the contact ID is different!

In Shopware:

  1. Go to your Shopware and run the webwirkung.abacus.subscription.shopper task
  2. Go to the «Customers» and find your shopper
  3. In the addresses you should see the custom field filled with the abacus address ID. This ID is same for every address:
First address same IDSecond address same ID
Map Shipping addressesMap Shipping addresses

Final verification

  1. Login as the shopper in Storefront
  2. Place a new order
  3. Go back to Abacus > E-business > Edit e-documents(API)(J15)
  4. Now all addresses should be "green," which means our mapping works

1.4 Shopper with different addresses and different contact

In Abacus:

  1. Create a new shopper in the Abacus customer

In Shopware:

  1. Go to your Shopware and run the webwirkung.abacus.subscription.shopper task
  2. Go to the «Customers» and find your shopper
  3. Log in to the storefront and place an order with a different address and different names

In Abacus:

  1. Go back to Abacus > E-business > Edit e-documents(API)(J15)
  2. Find your order
  3. Map(edit) your shipping address
Link addressEdit addressLink contactEdit contact
Map Shipping addressesMap Shipping addressesMap Shipping addressesMap Shipping addresses
  1. Same with an invoice address:
Link addressEdit addressLink contactEdit contact
Map Shipping addressesMap Shipping addressesMap Shipping addressesMap Shipping addresses

Result

The result should look like:

Map Shipping addresses

In Shopware:

  1. Go to your Shopware and run the webwirkung.abacus.subscription.shopper task to map address IDs
  2. Go to the «Customers» and find your shopper
  3. In the addresses you should see the custom field filled with the abacus address ID. This ID is different for every address:

Final verification

  1. Login as the shopper in Storefront
  2. Place a new order
  3. Go back to Abacus -> E-business -> Edit e-documents(API)(J15)
  4. Now all addresses should be "green," which means our mapping works

Map Shipping addresses

1.5 Shopper with different addresses and types (private/business)

In Abacus:

  1. Create a new shopper in the Abacus customer

In Shopware:

  1. Go to your Shopware and run the webwirkung.abacus.subscription.shopper task
  2. Go to the «Customers» and find your shopper
  3. Log in to the storefront and place an order with a different address and type (business or private)

In Abacus:

  1. Go back to Abacus > E-business > Edit e-documents(API)(J15)
  2. Find your order
  3. Map(edit) your shipping address
Link addressLink contactEdit contact
Map Shipping addressesMap Shipping addressesMap Shipping addresses
  1. Same with an invoice address - please note that in this example without a company = private
Link addressEdit addressLink contact
Map Shipping addressesMap Shipping addressesMap Shipping addresses

Result

The result should look like:

Map Shipping addresses

In Shopware:

  1. Go to your Shopware and run the webwirkung.abacus.subscription.shopper task to map address IDs
  2. Go to the «Customers» and find your shopper
  3. In the addresses you should see the custom field filled with the abacus address ID. This ID is different for every address:

Final verification

  1. Login as the shopper in Storefront
  2. Place a new order
  3. Go back to Abacus > E-business > Edit e-documents(API)(J15)
  4. Now all addresses should be "green," which means our mapping works

Map Shipping addresses