Allegro - integration with auction service.

SOTESHOP online store is integrated with Allegro. From the store level, you can list products on Allegro and import orders from this service. Check out how to register an application in Allegro and how to configure Allegro in the store configuration. Read about adding ,tasks-schedule rates, sending products to Allegro and order tracking.

Table of Contents

SOTESHOP. Allegro – see how to integrate your store with Allegro.

Application registration in Allegro

  1. Go to https://apps.developer.allegro.pl/,
  2. Log in using your Allegro account details,
  3. Press the Register new application button, Application registration in Allegro
  4. Enter any Application name,
  5. Select The application will have access to the browser through which the user will log in to Allegro (e.g. an application on a server or an executable file),
  6. Enter the Redirect URI,

    Enter the address of your store.

  7. Select all Application permissions,
  8. Select I have read and accept the WebAPI and Allegro REST API terms and conditions,
  9. Press the Add button. Allegro REST API keys
  10. After registering the application, return to the Allegro configuration in the store's admin panel.
  11. Go to the Application data – one-time Allegro code section and follow the steps described there to connect the store to your Allegro account.

Allegro configuration in the online store

In the admin panel, select Applications → Allegro → Configuration Allegro module icon

Allegro configuration with the one-time Allegro code field

Allegro.pl account settings

  1. Select Enable,

    The Sandbox option is intended only for a special Allegro Sandbox test account and must remain unchecked.

  2. Enter the Allegro one-time code,
  3. Select the Region,
  4. Enter the City,
  5. Enter the Postal code,
  6. Press the Save button.

Application data – one-time Allegro code

After registering the application, the store is connected to the Allegro account using a one-time code. You no longer enter the Client ID and Client Secret fields manually in the module configuration.

  1. In the Application data section, press the Generate Allegro code button. You will be redirected to the Allegro website.
  2. If required, log in to the Allegro account that you want to connect to the store.
  3. Select I have read and accept the Allegro REST API terms and conditions.
  4. Press the Generate code button.
Generating a one-time code on the Allegro website

Allegro will display the generated code together with information about its expiration date.

One-time code generated by Allegro
  1. Copy the generated code.
  2. Return to the Allegro configuration in the store panel and paste the code into the Allegro one-time code field.
  3. Complete the remaining module settings, including delivery and payment settings and the complaint, warranty and return policies.
  4. Press the Log in to Allegro button.

The one-time Allegro code has a limited validity period. If the code expires before you complete the configuration, press Generate Allegro code again and generate a new code.

Adding a delivery price list to Allegro auctions

Select Delivery price lists

  1. Press the Add button, Allegro delivery price lists in the SOTESHOP online store
  2. Enter the Name,
  3. Enable the Delivery method:
    • Enter the price of the First item,
    • Enter the Maximum number of items in the package,
    • Enter the price of each Additional item.
  4. Press the Save button.

Listing a product from SOTESHOP on Allegro

  1. Edit the product,
  2. Go to Additional options → Allegro Creating an Allegro auction in the SOTESHOP online store
  3. Press the Add button.

Listing an auction in Allegro.pl production mode

Allegro auction form in the online store
  1. Complete the Basic information,

    In the Allegro Product field, you can link the listed auction to a product in the Allegro catalog. In most categories, Allegro requires a specific percentage of offers to be linked to a product in the Allegro catalog. Learn more about the Allegro Product Catalog.

  2. Set the Sale format,
  3. Configure Delivery and payment,
  4. Select the Photos,
  5. Enter the Descriptions,
  6. Complete the GPSR data,
  7. Complete the Item features,

    Some parameters are dependent. This means that, based on the value selected in another parameter, they may appear on the list or become required. For example, in categories containing the Condition and ISBN parameters, setting Condition to New makes the ISBN parameter required. In categories containing the Material parameter, selecting Gold displays the additional Gold fineness parameter.

    The labels of parameters required to list an auction are shown in bold.

  8. Select the Offer terms,
  9. Optionally, select the Promotion options,

    Some options may incur additional fees. See the Allegro price list for more information.

  10. Press Save and List.
Confirmation that an auction has been listed on Allegro from SOTESHOP

Example of an auction from SOTESHOP on Allegro

Example Allegro auction listed from the SOTESHOP store

Auction registration

In the admin panel, select Sales → Allegro

List of Allegro auctions in the online store

Select Offer list

List of Allegro auctions in the online store

Use the following actions:

  • Edit Edit icon,
  • Preview Preview icon,
  • List similar List similar auction icon.

Importing orders from Allegro to the online store

Orders are imported using the Task Scheduler. The import can run automatically and periodically. See the Task Scheduler documentation.

Registration of orders from Allegro

In the admin panel, select Sales → Orders → Allegro Orders

Recording an order from an Allegro auction in the SOTESHOP store
  1. Edit the order, Editing an order imported from an Allegro auction in SOTESHOP
  2. Configure the order,
  3. Press the Save button.

Reports

Reports for orders from Allegro in the SOTESHOP online store

The reports contain filters that allow you to analyse data according to selected criteria. You can review the effect of the filters directly on the Gross order value, Average gross order value and Number of orders charts.

Printing an order from Allegro

In the admin panel, select Sales → Orders → Allegro Orders

  1. Edit the order,
  2. Press the Download button Printing an order from an Allegro auction in SOTESHOP

See the Orders documentation.

Related documentation

SOTE YouTube

Stay up to date with the latest SOTESHOP program updates. Subscribe to the SOTE YouTube channel.