WeClapp

The remaining interface of WeClapp can be connected via wemalo-connect. The steps and information required for this are listed below.

Create client in wemalo

The client is created in wemalo in the usual way. For the client’s other facilities in wemalo-connect, the client ID and the warehouse ID must be known.

Create user in wemalo-connect

A new shop user is created in wemalo-connect and linked to the previously created client in wemalo using the client ID. The warehouse ID is also stored.

The creation of a REST-Key is not necessary!

Set up WeClapp interface

The WeClapp interface is created in the “Generic REST Interfaces” area. These interfaces use wemalo’s REST interface to communicate with the back end. However, the creation of a remaining token is not necessary.

A new interface can be defined by clicking on the “New entry” button. After selecting the system, the configuration of the system can be loaded via the button “System-Template”. Using the WeClapp example, key-value pairs are loaded for storing the required settings (URL, token, WeClapp ID, etc.). An overview of the required settings follows in the next subchapter.

You can also select the wemalo instance (previously set up by linking wemalo and the client ID) and the synchronization interval.

A warehouse must be created via Settings- >Basic settings- >Warehouse.
As soon as this is done you can open the warehouse via the edit function (pen symbol) and see the warehouse ID in the browser bar at the end (entityId=XXXX).
This is required in the WeClapp settings.

 

WeClapp Settings

The following settings must be provided by the customer:

  • Token: here you have to enter the token from the WeClapp shop, (My settings- > API Token) which has to be created.
  • url: the URL to the API interface of WeClapp. (Shop URL/webapp/api/v1)
    Example: https://4elements.weclapp.com/webapp/api/v1
  • (WeClappId: 1)
  • (storageLocationId: 1)
  • warehouseId: the ID of the warehouse in WeClapp.

 

The following settings are made by us:

  • extendedLog: true must be entered here to activate extended logging.

 

subscriptions

The following subscriptions can be activated/deactivated:

  • serviceLoadProducts: load product master data from WeClapp and transfer to wemalo.
  • serviceLoadGoodsOrders: load WA orders from WeClapp and send them to wemalo.
  • servicePushPackages: return sent packets from wemalo to WeClapp.
  • servicePushInventoryBookings: Transmission of inventory entries (entries and withdrawals).
  • servicePushIncomingBookings: Transmission of incoming goods bookings
  • servicePushSentBookings: Transmission of outgoing goods bookings.
  • servicePushReturnBookings: Transmission of return bookings.

 

Annotations

Due to API limitations, the following tasks must be performed manually in the shop.

In order to successfully create a delivery of an order, the order must be confirmed by clicking manually.

The dispatch of the delivery and the creation of the invoice must also be confirmed here by a manual click. The stock is not updated until the delivery was shipped.

The return of the order cannot be generated until the delivery has been sent.

The goods from the returns can be posted back to the warehouse by selecting “Post all items to warehouse” under “Goods receipts and workflow” in Weclapp.

 




wemalo connect rest api

The documentation for the interface wemalo connect REST API can be found here: connect-api.wemalo.com




REST API workflow

Is using wemalos rest api, at least the following calls might be used for interacting with wemalo.

First of all, an account needs to be set up for you. You’ll get a rest api token that is being used for authorization. Please see header information: Authorization

Product master data

Orders




wemalo-connect Release

Version 1.2.3

Date: 13.11.2017

Version 1.2.2

Date: 14.09.2017

  • Shopware configuration simplified
  • Activating/deactivating of wemalo instances implemented
  • new rest call for creating inventories implemented

Version 1.2.1

Date: 17.08.2017

  • Loading return orders from Shopware and pushing back booked returns integrated

Version 1.2.0

Date: 16.08.2017

  • Integration of Shopify api
  • Enhancements to shopware api

Version 1.1.0

Date: 07.07.2017

Version 1.0.1

Date: 28.06.2017

  • new call for creating multiple products at once added to connect api
  • possibility to set a product as activated/deactivated added to connect api
  • new rest calls need wemalo-backend 1.5.2.1 or later

Version 1.0.0

Date: 09.06.2017

  • connect-api has finally been implemented
  • wemalo-connect now allows using a wemalo rest api to transmit product data and goods orders and to load information about stock changes and sent packages
  • the api needs wemalo-backend 1.4.4 or higher

Version 0.2

Date: 07.06.2017

  • additional rest calls implemented
  • rest calls are now being validated before sending them to wemalo
  • preparation for managing shop systems in wemalo-connect

Version 0.1

Date: 31.05.2017

  • first beta version of wemalo-connect has been released
  • in this version it’s possible to manage users, wemalo instances and to communicate with wemalo via a rest api



wemalo-connect

wemalo-connect wemalo-connect connects Wemalo to shops, ERPs and other external systems. The software can be used independently of Wemalo, e.g. to synchronize the WordPress shop with the Plentymarkets shop. In addition, wemalo-connect provides a REST API to Wemalo, which is used to exchange product master data, transmit orders and query inventories. The full range of functions can be seen in the interface documentation: connect-api