01About the application
YourWeb Studio is a panel in which clients of YourWeb Agency manage their website and shop: content, products, orders and connections with external services.
The Allegro integration lets a seller connect their Allegro account with a shop running on a website built by YourWeb. The application uses the official Allegro REST API and acts on the seller's behalf only with their consent.
02Who the integration is for
- YourWeb clients whose website has the shop module turned on.
- Sellers with a business account on Allegro. Allegro only allows offers to be listed through the API from business accounts.
03How to connect an Allegro account
- Sign in to YourWeb Studio and open Ustawienia → Połączenia (Settings → Connections).
- Choose Allegro and click Połącz z Allegro (Connect to Allegro).
- Sign in at allegro.pl and check which account will be connected. Confirm access for the YourWeb application.
- After confirming, you return to the panel, where Allegro shows the connection status and the account name.
You sign in directly on the Allegro website. YourWeb never learns your Allegro login or password and does not ask for your account's API keys. The connection works with an access token issued by Allegro after your consent (OAuth 2.0, Authorization Code flow).
04Permissions
The application only asks for the permissions needed for the features described here:
| Permission | What it is for |
|---|---|
allegro:api:profile:read | Reading basic account data, to show which Allegro account is connected and to check that it is a business account. |
allegro:api:sale:offers:read | Reading the seller's offers, to link them with products in the shop. |
allegro:api:sale:offers:write | Listing offers from the shop's products and changing their price, stock and status, once the seller turns these features on. |
allegro:api:sale:settings:read | Reading delivery price lists, return and complaint policies, warranties and manufacturer details that the seller chooses for offers. |
allegro:api:orders:read | Reading Allegro orders, to show them in the panel and reduce stock in the shop. |
allegro:api:orders:write | Changing the fulfilment status of an order and adding shipment tracking numbers. |
05Features
Available
- Connecting the seller account and checking that it is a business account.
- Viewing the connection status in the panel and disconnecting it.
In preparation
- Choosing which shop products are listed on Allegro, with selected products excluded.
- Listing offers linked to the Allegro product catalogue, with category and parameter mapping.
- Price synchronisation, with an optional margin, and stock synchronisation.
- Importing Allegro orders and updating the fulfilment status and tracking numbers.
The seller turns each of these features on themselves. The application does not list or change offers without the seller's decision.
06What data we process
- The Allegro account identifier and login, and whether the account is a business account.
- Access and refresh tokens issued by Allegro.
- Offer and order data to the extent needed for the features the seller turns on.
The data is used only to run the integration for the given seller. We do not sell it or share it with other sellers. We do not use Allegro data outside the seller's shop. The processing of personal data is described in the Privacy policy, and the rules for using YourWeb Studio in the Terms of service.
07Security
- Tokens are stored only on the server, encrypted with AES-256-GCM using a separate key for each website. The encryption key is kept outside the database.
- Tokens never reach the browser or the shop website and are not shown in the panel.
- The connection can only be managed by the website owner, people assigned to that website by YourWeb and YourWeb administrators.
- Communication with Allegro takes place only over an encrypted HTTPS connection.
08Disconnecting the account
You can disconnect the account at any time:
- in YourWeb Studio: Ustawienia → Połączenia → Allegro → Rozłącz (Settings → Connections → Allegro → Disconnect). The tokens are then deleted from our server;
- on Allegro: in your account settings, in the section for connected applications. Allegro then revokes the YourWeb application's access.
The tokens also stop working when you change your Allegro password or email address, or sign out of all devices. The connection then has to be renewed with the Połącz z Allegro (Connect to Allegro) button.
09Help and contact
For questions about the integration, contact us:
- E-mail: kontakt@your-web.pl
- Phone: +48 660 790 373, +48 664 034 072
YourWeb clients can also write to us from the panel, with the Pomoc (Help) button in the top bar.