The guide illustrates the Shopware Return Orders processing strategy on Alumio
Return Orders placed on the website is captured in the Shopware environment, Alumio is responsible for performing periodic Return order dumps from Shopware to a destination endpoint.
Return orders can be complete return or partial returns, it is indicated by a status flag that can have the following values return or return_partially.
The strategy adopted for processing the Return Orders is as follows,
- Invoke the in-built prototype "Shopware return order subscriber" to fetch the return orders dump from Shopware to Alumio environment (Incoming connection).
- Perform necessary transformations to prepare the payload (Optional).
- Write the processed return orders to a destination storage (FTP, SFTP) or redirect the data to an external endpoint (outgoing connection).
Shopware API call details
The API call to fetch the return orders from Shopware is,
Shopware return order subscriber
statusId is obtained by invoking the
The subscriber used to construct the Incoming connection is the "Shopware return order subscriber", the subscriber utilizes OAuth for authentication and thus the relevant information has to be fed to the subscriber as shown below.
Return State - is used to select if the incoming connection should process the "returned" orders or "returned_partially" orders.
The route configuration to link the Incoming return orders connection to the Outgoing connection. The transformer Country Dictionary Map is also invoked here to convert the country code hash values to their respective ISO code.
The outgoing configuration of the return orders is a simple Filesystem XML publisher that performs a dump to the FTP location depicted in the Filesystem configuration.
KeyPath: The keypath will be directly translated as the FileNames of the created XML in the FTP storage.