Flowwise Sync for Allegro

Flowwise Sync for Allegro brings a seller's Allegro orders into their own Shopify store and sends the tracking numbers back to Allegro. This page explains how the application uses the public Allegro REST API, how sellers sign in and how it follows the Allegro REST API Terms and Conditions.

ApplicationFlowwise Sync for Allegro
Operated byNewcraft, as part of Flowwise (flowwise.dev)
Used throughThe Shopify app Allegro Sync Pro and the Flowwise web app at app.flowwise.dev
User-AgentFlowwise-Sync-for-Allegro/1.0 (+https://app.flowwise.dev/docs/allegro-api/)
API hostsallegro.pl (sign-in) and api.allegro.pl
ContactThrough Flowwise support in the app, or flowwise.dev/contact

PurposeWhat the application does

The application serves Allegro sellers who also run a Shopify store. It does three things for the seller who connected their own Allegro account:

  1. Import orders. Paid orders that are ready for processing on Allegro are created as orders in the seller's Shopify store, so the seller ships every sales channel from one place.
  2. Match products. For an order line that lacks a SKU or EAN, the application reads the seller's own offer to find the SKU (external id), the EAN and the title, so the line matches the right Shopify product.
  3. Report shipments. When the seller ships the order in Shopify, the application adds the carrier and tracking number to the Allegro order and marks the order as sent once every line has shipped.

Orders fulfilled by Allegro One Fulfillment are not shipped by the seller, so the application never reports a shipment for them. The application only works with the seller's own account. It does not read other sellers' data, does not scrape allegro.pl and does not message buyers.

AuthenticationHow sellers sign in

The application uses Allegro's OAuth 2.0 authorization code flow. The seller's Allegro password never reaches us.

  1. The seller clicks Connect Allegro in Allegro Sync Pro or in Flowwise.
  2. The application sends the seller to https://allegro.pl/auth/oauth/authorize with prompt=confirm and a signed, time-limited state that ties the answer to that seller's shop and user.
  3. The seller logs in on allegro.pl and approves the requested access.
  4. Allegro returns to https://app.flowwise.dev/embedded/allegro/oauth/callback. The application checks the state, exchanges the code at https://allegro.pl/auth/oauth/token and reads GET /me to show which Allegro account was approved.
  5. The seller confirms that this Allegro account belongs to their shop. Only then are the tokens stored.

Requested scopes

ScopeWhy
allegro:api:profile:readIdentify the connected seller account (GET /me).
allegro:api:orders:readRead order events and checkout forms to import orders, and read carriers and existing shipments.
allegro:api:orders:writeAdd shipment tracking and set the fulfillment status to sent.
allegro:api:sale:offers:readRead the seller's own offer to find the SKU and EAN of an order line.

API usageResources the application calls

All requests use Accept: application/vnd.allegro.public.v1+json and the User-Agent shown above.

RequestUsed for
GET /meIdentify the seller after sign-in.
GET /order/event-statsFind the latest order event when the import starts.
GET /order/eventsFind orders that changed since the last check (100 per page).
GET /order/checkout-formsFind recent orders that are ready for processing (at most the last 7 days) when a seller first connects.
GET /order/checkout-forms/{id}Read one order to create it in Shopify, or to check its status before reporting a shipment.
GET /sale/product-offers/{offerId}Read the SKU, EAN and title of an ordered offer. Cached per offer during one run.
GET /order/carriersMap the Shopify carrier to an Allegro carrier id.
GET /order/checkout-forms/{id}/shipmentsCheck which tracking numbers are already on the order, so no shipment is added twice.
POST /order/checkout-forms/{id}/shipmentsAdd the carrier, tracking number and shipped line items.
PUT /order/checkout-forms/{id}/fulfillmentSet the order status to SENT when every line has shipped.

Request volume

DataWhich data is used and how

To create the order in Shopify, the application uses the order number, line items, prices, delivery method, the buyer's name, delivery address, email address and phone number. It stores the imported orders and their status so the seller can see them and so no order is imported twice.

ComplianceHow we follow the Allegro REST API Terms and Conditions

RequirementHow the application meets it
Identify the application (art. 3.4 c and h)Every request, including token requests, sends User-Agent: Flowwise-Sync-for-Allegro/1.0 (+https://app.flowwise.dev/docs/allegro-api/). Only the version number changes between releases.
Keep the API key to ourselves (art. 3.9 and 3.10)The client id and secret are held only on our servers and are never given to sellers or third parties.
Authorize users through Allegro (art. 4.1 d)Sellers authorize only through Allegro's OAuth sign-in. The application has no sign-in of its own for Allegro accounts.
Inform users (art. 4.3)This page, the terms and the privacy policy explain what the application does with the seller's data.
Act within the seller's permissionThe application only reads and changes the connected seller's own orders and offers, and only within the approved scopes.
Use the API with careScheduled checks, paging, retry with backoff and caching keep the number of requests low.