With the second version of the WordPress plugin, Wemalo has considerably extended the range of functions.

furnishing

• Download and activate the Wemalo Connectplugin from the WordPress shop.
• A user account must then be set up in wemalo-connect(by a Wemalo employee).
• The security key generated in wemalo-connect must be stored in the plugin configuration (a Wemalo entry has been added to the admin menu).

products

• If a product is updated, the change is sent directly to Wemalo via wemalo-connect.
• In addition, the product master data is requested by Wemalo at regular intervals. Since this is primarily required for the initial setup, the frequency of periodic queries is reduced.

mandatory fields

The only real mandatory field is the article number. However, they are also important for the warehouse processes:

• EAN (if article number cannot already be scanned)
• Article dimensions and weight (for storage and shipping)
• Product image (for visual verification)
• Product name (for name matching when picking/packing)

Expansion of products

The plugin extends the products and variants and adds the following information:

• New alternative stock field (for example, B goods)
• new field EAN (Tab Wemalo in main product)
• new setting possibility serial number (Tab Wemalo in main product)
• Overview of serial numbers/batches (Tab Wemalo in main product)

data transfer

• When the main product is saved, the data record is transmitted directly to Wemalo. The time stamp of the last data transfer is displayed in the Wemalo tab.
• A direct transmission also takes place when saving variants. Here the timestamp is displayed in the variant view.
• If an error occurs during transmission, the return of the server is output.

product bundles

• The WooCommerce product Bundle plugin has been supported since version 2.0.2 of the Wemalo plugin. The WooCommerce product Bundle plugin has been supported since version 2.0.2 of the Wemalo plugin.
• As an alternative to using a plugin in WooCommerce, sets can also be defined in Wemalo. To do this, the set product must be created as a normal product in WooCommerce and configured accordingly in Wemalo (done by the Wemalo customer consultant).

orders

• As soon as an order is set to “in progress”, data is transmitted to wemalo-connect and thus directly to Wemalo.
• The download timestamp is set immediately. If an error occurs during transmission, the error message is stored as a custom field.
• If the order could be completely reserved, it changes to a new fulfillment status.
• As long as the order has not been reserved and is being processed in the order, it can also be cancelled in Wemalo using the WordPress stroning function. However, if the order is ready for fulfillment, it must be cancelled manually in Wemalo.
• Once an hour, WooCommerce queries the current order status as long as the order has not yet been reserved.

Update orders

• If the order is not yet in fulfillment, it can be processed at any time.

status extension

• Returns registered (see Returns)
• Returns posted (see Returns)
• Order in fulfillment

If an order was sent to Wemalo, but cannot be set to Wemalo status open there (and thus released for picking), it will remain in processing status in WooCommerce and can still be cancelled from WooCommerce.

Wemalo fields in orders

• Blocked: if the checkbox is checked, a transfer is made to Wemalo and the order is picked and packed. In Wemalo, however, it lands in the status “blocked packed” and is sent only after release.
• Note: the text field can be used to send a note to the picker or packer.
• ETD: if the date field has been set and is in the future, the goods will be reserved, but in Wemalo no pick list can be created yet. Only when the date has been reached, the picking list can be created and the order further processed/sent.

Additionally there is the panel with wemalo with the following data:

• Priority: determines the priority of the order and can be distinguished between normal, high and very high. The priority affects the order of picking and reservation.
• Order: another WooCommerce order can be linked via order, in which the order number is entered. A function that goes beyond this does not exist (no link in wemalo or similar).
• Document upload: enables the upload of documents such as invoices or customs declarations.
• Promi: allows you to mark an order as a Promi dispatch. In addition, a text can be entered which is sent to an e-mail address stored in the configuration. This can be used, for example, to write individual texts for orders and attach them to the packages.
• Shipping: to hire the shipping service provider.
• Product: Depending on the shipping service provider, the shipping products can be selected.
• Returns no SN check: if products contain serial numbers, this flag can be used to switch off the validation of correctly returned serial numbers. The flag is transferred to wemalo when a return is registered.

tracking numbers

Tracking numbers are entered as notes and in the tracking_number field.

If wp_liste for Amazon or Ebay have been installed, the shipping service provider is entered in the field _wpla_tracking_provider (Amazon) / _wpl_tracking_provider (Ebay) and the tracking number in _wpla_tracking_number (Amazon) / _wpl_tracking_number (Ebay).

The tracking number can also be integrated into the e-mails sent automatically by WooCommerce when orders are completed. A manual can be found here: Insert tracking number e-mail at WooCommerce

shipping profiles

An external ID can be stored in Wemalo for matching the shipping profile to be sent. This comes from the WordPress installation and can be found under WooCommerce- > Settings- >Shipping.

Stock

• Wemalo’s doing a stock update. This means that the stocks changed in Wemalo are transferred to the WooCommerce shop at regular intervals. The stocks of A-goods are transferred to the normal warehouse stock. All other stocks (B-stock, C-stock, etc.) are entered in a separate field for alternative stocks.
• In order to be able to transfer stocks to WooCommerce, inventory management must be activated in the products on the shop side.

returns

• The Wemalo API plug-in offers the possibility to turn an order into a registered return. As soon as the status of the order has been changed accordingly, the return is sent to Wemalo.
• The return can then be scanned against the original order and the goods can therefore be validated.
• Wemalo reports the received goods back to the plugin and sets the status to Return booked.

Supported Plugins

Supported WordPress plugins

Wemalo supports the Magento SOAP API in Magento 1.9.

Setup

To do this, you must create a Soap user in Magento that has far-reaching authorizations. Wemalo accesses at least the following resources:

• catalog
• sales

• System->WebServices->SOAP Roles
• new role with resources: Catalog and Sales
• System->WebServices->SOAP Users
• with the new role
• Required are username and API-Key

functional overview

• loading of product master data
• loading of customer orders
• Transmission of sent parcels and tracking numbers
• Transfer of stocks

Loading orders

• All orders with the status wemalo_ready (must be newly created in Magento) are downloaded by Wemalo. A comment is then added and the status is changed to vendor.
• Note: once an order has been submitted to Wemalo, no further changes to the order will be submitted to Wemalo.

Transmission of tracking numbers

• After an order has been sent, a Shipment is created. The tracking number including information about the shipping service provider is then handed over.

Wemalo supports the Magento Rest-Api in Magento 2.

Setup

To do this, a remaining user must be created in Magento that has extensive authorizations. Wemalo accesses at least the following resources:

• POST V1/shipment/track
• POST V1/shipment
• POST V1/order/{id}/invoice
• GET V1/invoices?searchCriteria[filter_groups][0][filters][0][field]=order_id&searchCriteria[filter_groups][0][filters][0][value]={id}
• GET V1/products/{sku}
• GET V1/products?searchCriteria..
• GET V1/orders?searchCriteria...
• POST V1/invoices/%s/capture
• POST V1/invoices/%s/emails
• POST V1/shipment/{shipmentId}/emails
• PUT V1/products/{sku}/stockItems/{id}
• POST V1/orders/{salesOrderId}/comments

Create User Role:

• System -> Benutzerrollen -> Neue Rolle hinzufügen
• Role name e.g. wemalo
• Role Resources: Catalog, Shops, Data Transfer, Sales (Orders, Invoices, Shipments)

Create user:

• System – > All users – > Create new user
• Assign user name, first and last name and password
• Assign previously created user role
• username and password are required in the data exchange configuration in wemalo

Set Up Integration

• System – >Integrations – >Add new integration
• Only assign name and set authorizations analogous to user role
• release and store tokens in the data exchange configuration in wemalo

Define Order Status:

• Shops – > Order status – >Create new status
• Status code vendor, status label fulfillment
• Status code wemalo_ready, status label Ready
• Use “Assign status to status” to specify that wemalo_ready is to be used for payment input.

functional overview

• Loading of product master data
• Load customer orders (Note: once an order has been submitted to Wemalo, no further changes to the order will be submitted to Wemalo.)
• load invoices
• Transmission of sent parcels and tracking numbers
• Transfer of stocks
• Execution of invoicing and e-mail dispatch

Loading orders

• All orders with the status wemalo_ready (must be newly created in Magento) are downloaded by Wemalo. A comment is then added and the status is changed to vendor(also to be newly created).
• Note: once an order has been submitted to Wemalo, no further changes to the order will be submitted to Wemalo.

Shopware is integrated into wemalo-connect and can be used to exchange data with Wemalo. In wemalo-connect a shop account is necessary.

The supported versions and functions are listed in the function matrix.

Settings in Shopware

• Set up API users in shopware
• API user, API key and URL to Shopware’s rest API are required.
• After the initial setup, Wemalo sets all stocks to 0!*1

Configuration in wemalo-connect

• a shop user must be set up
• for the interface Shopware the data from the previous section must be entered
• The synchronization time can be set. If the time is set to 0, the interface is off.
• The individual data subscriptions can be activated/deactivated
• For each data subscription, the system records when the subscription was last successfully completed.
• The interface shows when the interface was last executed.

products

• All activeproducts are loaded and transferred to Wemalo.
• Only products that have updated since the last successful product synchronization are considered.
• The product ID is stored in Wemalo as an external ID and is used to match the product master data.
• The article number from the shopware is transferred to Wemalo as SKU.
• The weight is read in as kilograms, product dimensions as centimetres with decimal places.
• For variant articles, the additional text in shopware is appended to the name in Wemalo. It is therefore necessary to fill this field, for example, with the color or another text so that a distinction can be made between the different variants in the warehouse.

orders

• Orders with the status “In process (Waiting)” are downloaded by Wemalo and set to the status “Ready for delivery”.
• After dispatch, orders are set to the status “completely delivered”.
• The matching of the shipping service provider to be used is done via the name of the stored shipping type, e.g. standard shipping”.
• Note: once an order has been submitted to Wemalo, no further changes to the order will be submitted to Wemalo.

Via wemalo-connect invoices can be downloaded as Base64. To do this, the end point must be stored in the wemalo-connect shopware configuration under “Invoice end point”. In addition, the Shopware API must be extended by the stored end point.

wemalo assumes that the base64 document about {“data”: {“pdfDocument”:”base64 “}} can be retrieved……..

stock

• Current product inventories are loaded via wemalo-connect and synchronized with shopware. Only pickable stocks are confirmed. I.e. goods on blocked stock or already picked goods will not be transferred as available stock of shop goods.

Sent parcels

• The tracking code is transferred to the order in shopware. If an order is shipped in several packages, the tracking numbers are separated by semicolons.
• The order is then marked as sent.

returns

• An order status can be stored in Wemalo that is used for picking up registered returns (e.g. “Register returns”). If Wemalo has loaded a return, the status is set to “Wemalo fetched”. Both status IDs are not available in the standard shopware and must be newly stored in the shopware.
• It can also be activated that returns are reported back. In addition, the retrieval of returns must also be activated, since Wemalo requires the ID of the order to retrieve the returns message. An accepted return is displayed in Shopware on the basis of another new status.

*1: Excluding products

If products are not to be synchronized, they must be assigned to the customer group WAPI (Wemalo API). To do this, a new customer group must first be created in Shopware:

The customer groups must then be assigned to the products that are notto be called up by Wemalo:

Please note: The assignment must take place before Wemalo loads the product!