Skip to main content
All CollectionsMALL
🔗 Connection - Step by Step
🔗 Connection - Step by Step
Updated over 2 months ago

Below you will find a step-by-step guide to connecting your e-shop to selling on Mall.cz.


1. Step - Download the Add-on

If you are on Shoptet, download the EXPANDO MALL add-on.

With this add-on, you will have an overview of all orders in one place. It helps you ensure easy import of orders from the MALL Partner portal and synchronizes their current status. It also helps transfer tracking numbers. This will save you the double work of maintaining the correct order status in both your own e-shop and the MALL Partner portal.

What does the add-on enable?

  • Pair and synchronize orders, payment methods, and shipping carriers from your e-shop back to the MALL Partner administration.

  • Synchronize stock levels and prices.

  • Transfer tracking numbers to the MALL Partner administration.

  • Simplify daily operations on MALL Partner.

How to proceed to use the add-on?

1. Create an account on MALL.

2. List your products on MALL using an XML feed or manually.

3. Then register in EXP APP and connect your MALL account.

4. Connect the availability feed (the source is automatically connected through the Shoptet add-on).

5. Set up rules for importing orders, payments, and shipping into your e-shop.

6. In case of selling to other countries, we will assist you with product translations.

💬 Need help? Contact us at help@expan.do and we will be happy to assist you.


2. Step - Registration in EXPANDO APP and Mall Partner

More information about registration can be found in the previous chapter.

💡 If you are using Shoptet, log in to EXPANDO APP through Shoptet.

3. Step - Listing Products in the MALL Interface

The listing (registering products on the marketplace, adding images, descriptions, categories, dimensions, etc.) is not done through EXPANDO APP, but directly in the MALL Partner interface.


Product listing on MALL is done manually or through feeds or API in the MALL PARTNER interface. Our app currently synchronizes stock levels and downloads orders. We link to existing products in the MALL interface using the SKU code (note: ensure the same SKU code is used in both feeds).

Options for connecting products to MALL:

🎯 Expansion within the MALL Group

With the help of MALL Group, you can easily expand to other markets where MALL operates. MALL is already an established player in these markets and will also promote your products through PPC.

To expand, all you need are product translations and your existing connection (for Slovenia, you will need a MALL feed, as Heureka is not yet active in that market).


4. Step - Connecting EXPANDO APP to MALL

To connect the MALL marketplace to EXPANDO APP, you need to enter your API key, which can be found in the MALL Partner environment, and the webhooks generated by our EXPANDO APP, which you will insert into MALL Partner.

What if I already have EXPANDO APP running and connected, and I need to connect MALL?

In the EXPANDO APP, navigate to Sales Channels and select one of the MALL countries, then choose Connect MALL or Change Connection.

(Note: Only one e-shop can be connected to one account in our APP.)


API Key (ClientID)

  1. Register or log in at app.expan.do, or use the Shoptet add-on.

  2. Confirm the registration by verifying it in your email inbox.

  3. You will be redirected back to our EXPANDO APP from the email.

  4. Enter the ClientID key, which you will receive from MALL, into EXPANDO APP > Sales Channels > Mall > Connect (Log in to MALL Partner, then go to "Company Profile" and under "API Key" you will find ClientID).

  5. If you are connecting additional countries like MALL SK, MALL PL, MALL HU, etc., you will find the ClientID in the MALL Partner account for that specific country.

WEBHOOK

  1. Copy the webhook from our EXPANDO APP (Marketplaces > MALL -> Edit Connection for CZ, SK, PL, HU), and enter the CLIENT ID, or do it directly during onboarding.

  2. Insert it into MALL Partner (Log in to MALL Partner, then go to "Company Profile" and "Webhook").

  3. Enable the "Allow Webhook" option.

  4. Click "Connect Account."


5.Step - Inserting the Feed

Connect the availability feed (EXPANDO APP - Settings → Product Source).

✅ If you have the Shoptet add-on, the source is automatically connected through the add-on.

Automatic Synchronization:

The best way is to upload the product feed using an XML source.

Learn more here:


6. Step - Completing the Settings in EXPANDO APP

You will complete the settings in the app - General - MALL. More details can be found in the next chapter.

⚠️ It is necessary to fill in all mandatory shipping and payment statuses; otherwise, the order import cannot be enabled.

Order Statuses

We transfer order statuses from Shoptet to MALL. We need to complete the settings to link the statuses in Shoptet with those in the MALL Partner account. Currently, we do not transfer status changes from MALL back to your e-shop (this occurs when using MALL shipping and the status DELIVERED, which MALL updates for you, but we do not transfer it to your system).

Mandatory Data

Select the order status for import into Shoptet - which order status should we send you when created in MALL (the status in MALL is called OPEN).

I want to send the order status "shipped" to MALL - order status "shipped" (the status in MALL is called SHIPPED).

Optional Data

I want to send the order status "shipping" to MALL - status "in progress" (the status in MALL is called SHIPPING).

I want to send the order status "delivered" to MALL - status "delivered" (the status in MALL is called DELIVERED).

More about individual MALL order statuses can be found here.

Mapping of shipping methods.

On the left side are your shipping methods from the e-shop, and on the right side are the shipping methods in your MALL Partner account. The rows will increase depending on the number of shipping methods in MALL, and all must be filled.

Mapping of payment methods.

On the left side are your payment methods from the e-shop, and on the right side are the payment methods in your MALL Partner account. The rows will increase depending on the number of shipping methods in MALL, and all must be filled.

In the EXPANDO APP, you will then see the order as "pending," meaning it is waiting for payment. Once the payment is made, it will be transferred to Shoptet.


7. Step - Import if you are not using Shoptet

Here you will learn how to connect orders from EXPANDO APP (Amazon, MALL, eMag, Alza) to your system and how to connect products from your system to EXPANDO APP.

There are three options - Orders API, .xml feed with orders, or import into the POHODA system.

Orders API

The API for downloading orders is described at the address here.

Orders XML

We automatically generate an .xml feed with orders for all sellers. You can find the link to the .xml by logging into the EXPANDO APP in the SETTINGS ➡️ GENERAL section.

The .xml feed specification can be found here.

✅ For testing, you can use a demo account at app.expan.do.

Pass: expandodemo

Vzor .xml feedu

<orders>
<order>
<orderId>404-3565664-8143513</orderId>
<orderStatus>Shipped</orderStatus>
<purchaseDate>2019-12-20 10:36:36</purchaseDate>
<marketplace>AMAZON ES</marketplace>
<venue>AMAZON</venue>
<fulfillmentChannel>Seller</fulfillmentChannel>
<businessOrder>false</businessOrder>
<totalPrice>56.27</totalPrice>
<totalItemTax>0</totalItemTax>
<currencyCode>EUR</currencyCode>
<language>ES</language>
<paymentMethod>Other</paymentMethod>
<shippingMethod>Std ES Dom_2</shippingMethod>
<shippingPrice>11.5</shippingPrice>
<latestShipDate>2019-12-23 22:59:59</latestShipDate>
<latestDeliveryDate>2019-12-30 22:59:59</latestDeliveryDate>
<isPremiumOrder>false</isPremiumOrder>
<isPrime>false</isPrime>
<isComplete>false</isComplete>
<isRefunded>false</isRefunded>
<invoiceUrls></invoiceUrls>
<invoices></invoices>
<customer>
<firstname>expando</firstname>
<surname>demo</surname>
<email>fqwmmcdkvlkws4q@marketplace.amazon.es</email>
<phone>000000000</phone>
<taxId/>
<taxCountry/>
<address>
<address1>Havlickova 13</address1>
<address2/>
<address3/>
<city>Prague</city>
<zip>11000</zip>
<stateOrRegion>Prague</stateOrRegion>
<country>CZ</country>
</address>
</customer>
<items>
<item>
<itemId>V152677</itemId>
<externalId/>
<itemPrice>44.77</itemPrice>
<itemQuantity>1</itemQuantity>
<itemName>Brandit Lord Canterbury Hooded Chaqueta Negro tamaño XL</itemName>
<orderItemId>32517278048963</orderItemId>
<itemTax>0</itemTax>
<shippingDiscount>0</shippingDiscount>
<shippingDiscountTax>0</shippingDiscountTax>
<promotionDiscount>0</promotionDiscount>
<promotionDiscountTax>0</promotionDiscountTax>
<shippingPrice>11.5</shippingPrice>
<shippingTax>0</shippingTax>
</item>
</items>
</order>

API Confirmation

Fulfillment API

If you send a shipment, we need to be informed. Therefore, use the fulfillment API to enter the shipment's tracking number and the carrier used for shipping.

Fulfillment API is described here.

Integration into Accounting and ERP Systems (Pohoda/Flexibee/...)

Together with Dativery, we can connect our app (inventory/orders/tracking numbers/invoices) to standard accounting systems.

For any questions, contact Dativery:

+420 377 477 761

+420 775 638 008

Did this answer your question?