wemalo connect rest api
The documentation for the interface wemalo connect REST API can be found here: connect-api.wemalo.com
The documentation for the interface wemalo connect REST API can be found here: connect-api.wemalo.com
Any number of containers can be entered for a product via the product master.
To do this, you can view and add the container units via the Units tab. A container unit consists of a name (displayed during stock transfer, pick and pack) and a quantity (how many pieces are in a unit). You can also store dimensions (height/width/length and weight), since this could have an effect on billing (if you use pick categories).
Possible packaging unit types are carton, handle unit and pallet. From a technical point of view, however, there is no distinction.
With the help of a barcode, a specific barcode for the packaging unit can be stored, which is accepted at goods receipt, stock transfer, pick & pack.
Via the client master, containers can be uploaded as CSV files. For the structure of the CSV file, see Inline Help in wemalo.
In the Shipping group, containers can be activated for billing.
The container unit can be selected via a drop-down menu. The total sum is calculated and displayed according to the selected unit and the entered quantity.
If the specific container barcode is scanned, the corresponding container is already preselected.
Example: if a container unit with 6 pieces was selected and the quantity 2 was entered, the total number of pieces is 12.
In the MDE view, after scanning the product and entering the quantity, a proposal for removing the product as a container is displayed.
When picking, the employee is shown a drop-down menu to select the container after the product has been scanned. As soon as a container has been selected, the display jumps to the quantity entry and the picker can continue with it. It is checked that the entered quantity multiplied by the container quantity (in the above example 6) does not exceed the quantity to be picked.
Example: the container has a stored quantity of 6 and the quantity entered is 2. If there are less than 12 picks, the picker will be prevented from continuing with a corresponding error message. At any time the picker gets the calculated total number of pieces.
After scanning the product barcode, the packer can select the container and the number of scans is converted according to the container quantity. When the container barcode is scanned, the container is selected automatically.
Creation/editing of containers: http://connect-api.wemalo.com/#api-Product-addUnit
Loading the available container units: http://connect-api.wemalo.com/#api-Product-getUnits
In addition: when creating a GR order, the ID of the container unit can be entered in the position: http://connect-api.wemalo.com/#api-GoodsReceipt-addGoodsReceipt
There is now the parameter “productUnitId”.
Example:
For one product a container unit “advantage pack 5 pieces” is created. This container unit contains 5 pieces of said product.
When the goods receipt is transmitted, this container unit can be specified with a number of pieces, e.g. 2 pieces.
In this case wemalo expects 10 pieces of the product (2 times the container with 5 pieces = > 2*5=10).
Using the shipping costs matrix, the shipping costs for each parcel are stored in the client master according to recipient country, weight and shipping service provider, so that exact shipping prices can be determined during billing generation.
A template for each shipping service provider can be downloaded from the client master under Accounting – >Shipping Costs Matrix. All shipping service providers that have been set up for the client are displayed to the user.
At warehouse level, you can store a template that is used for dispatches that have not been defined via the client.
MatchingID;Dispatcher;Product;Comments;Country;Country DE;Country Code;ZIP;BasePrice;KiloPrice;Weight;Price
To create a matrix for a client, you can build on a template. For this purpose, templates can be stored for each shipping service provider per warehouse. The client can also be used to download a template file tailored to the shipping profiles set up for the client.
Overview of the shipping matrices stored so far
Display of a stored matrix as HTML view
Download as CSV
View after CSV export
wemalo offers a manual upload of tracking numbers for some shipping service providers (e.g. GLS). To do this, an upload button is displayed in DockManagement, which can be used to upload a CSV file for the respective shipping service provider.
NOT USED;Client Order Number;Tracking Number;NOT USED(Optional);NOT USED(Optional)
Please note: the first column is not used, but must still be filled (the import only goes to columns 2 and 3).
21.09.2017;test 2;123456789;wemalo customer;1030
21.09.2017;7531;987654321;Max Mustermann;1170
Where only the second and third columns are used!
The rolling inventory is a random inventory that takes place during picking, depending on the interval set. Rolling inventory is first activated at warehouse level. For the individual clients, you can then specify whether the rolling inventory is to be carried out and which interval is to be used.
By selecting the “Activate rolling inventory” option, rolling inventory can be activated at warehouse level. This checkbox can be used to determine for the entire warehouse whether rolling inventories may be carried out in general or not.
In the client master, the rolling inventory is set via “Configuration”- > “Rolling inventory”:
During the pick, the inventory counter is incremented. When the limit defined in the client master has been reached, the picker is prompted to perform a rolling inventory. All articles of the current client must be counted on the parking space from which the picker has just picked. The result is processed and sent by e-mail.
The differences are not posted!
If there are differences, a normal inventory order must be created for the client and the parking space and the parking space must be checked again.
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
Our WooCommerce plugin writes the tracking number into the order field tracking_number. It is possible that an order consists of several packages and that the tracking numbers are separated by commas in the field.
In addition, the carrierfield is used to enter the shipping service provider (e.g. DHL, DPD, etc.) with which the parcel was sent.
You can use the template customer-completed-order.phpto set the template for sending e-mails. Via the admin menu WooCommerce- > Settings- >E-Mails the template file can be adapted into the template and over it afterwards.
The tracking numbers could be displayed in the file e.g. above the footer, i.e. directly above:
/** * @hooked WC_Emails::email_footer() Output the email footer */ do_action( 'woocommerce_email_footer', $email );
The following code excerpt reads out the tracking numbers and shows them as DHL link in the e-mail. For production use, you would also have to read out the carrier at this point and put the link together accordingly depending on the carrier.
$post_id = $order->ID; echo "tracking number for $post_id "; $tn = get_post_meta($post_id, "tracking_number"); if ($tn) { $numbers = explode(',', $tn[0]); if ($numbers) { foreach ($numbers as $code) { echo '<a href="https://nolp.dhl.de/nextt-online-public/de/search?piececode="'.$code.'>'.$code.'</a><br/>'; } } } /** * @hooked WC_Emails::email_footer() Output the email footer */ do_action( 'woocommerce_email_footer', $email );
With the second version of the WordPress plugin, Wemalo has considerably extended the range of functions.
The only real mandatory field is the article number. However, they are also important for the warehouse processes:
The plugin extends the products and variants and adds the following information:
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.
Additionally there is the panel with wemalo with the following data:
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
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.
Supported versions in Plugin 2.x:
WordPress/ WooCommerce | 3.1.2 | 3.2.6 |
---|---|---|
4.7.1 | X | ? |
4.8.3 | X | X |
4.8.4 | X | X |
4.9.2 | ? | X |
Version 1.x
WordPress/ WooCommerce | 2.6.9 | 3.1.2 |
---|---|---|
4.5.10 | ? | X |
4.7.1 | X | ? |
X = > This combination is supported
? => Diese Kombination wird nicht aktiv unterstützt, könnte aber funktionieren
– = > This combination is not supported.
When using the Wemalo API, the following plugins are supported by Wemalo:
If other plugins are used in the shop, the functionality of the Wemalo plugin cannot be guaranteed. If necessary, the plugin must be adapted so that it works together with other plugins.