FlowDino Documentation

Discover how to use all FlowDino features

📚 Menu Documentation

Documentation

Shopify Application

FlowDino for Shopify

Install the app on the Shopify App Store

1. Overview

FlowDino for Shopify is an app that enables Shopify merchants to list their products on the FlowDino marketplace (flowdino.com), specializing in second-hand and refurbished goods. The app handles:

Automatic publishing and updating of your Shopify products on FlowDino.
Retrieval of your FlowDino sales directly in your Shopify admin.
Stock and status synchronization between both platforms.
GDPR compliance through customer data management.

2. Installation

Install the app from the Shopify App Store.
Authorize the requested permissions (read products, manage orders, webhooks).
You are automatically redirected to the app dashboard.
Then connect your FlowDino account (see next section).

Permissions requises : read products and collections, create/edit orders, product webhooks.

3. Connect to FlowDino

Before syncing, you need to link your FlowDino account to the app.

Go to Settings in the app menu.
In the FlowDino Connection section, enter your FlowDino email address and password.
Click Connect.
A confirmation message indicates the connection is established.

The app automatically handles token renewal (valid for 24 h). No manual action is needed.

To disconnect your account, click Disconnect in the same section.

4. Dashboard

The dashboard is the app's home page. It displays:

Indicator	Description
FlowDino Connection	Connection status (connected / disconnected)
Synced products	Number of products successfully sent to FlowDino
Pending	Products never synced or awaiting processing
Errors	Products whose last sync failed
Total products	Total number of published products in your store
Recent syncs	History of the last 5 sync operations

From the dashboard, you can launch a full sync directly via the dedicated button.

5. Product synchronization

5.1 Full synchronization

Full synchronization sends all your published products to FlowDino in a single operation.

From the dashboard, click Full synchronization.
Confirm the launch.
Progress is displayed in real time; a summary (success / errors / skipped) is shown at the end.

Conseil : use full sync during initial setup or after a major catalog update.

5.2 Selective synchronization

Selective sync lets you choose which products to send and set their status on FlowDino.

Go to Products in the menu.
Use filters (sync status, title, collection) to find your products.
Check the products to sync.
Select the desired FlowDino status (e.g. Available, Draft).
Click Sync selection.

Sync statuses displayed:

Status	Meaning
✅ Synced	The product is up to date on FlowDino
⏳ Pending	The product has not been synced yet
❌ Error	The last sync attempt failed (see logs)
— Never synced	Product not yet sent to FlowDino

5.3 Pull updates from FlowDino

FlowDino may update the stock or status of your products (e.g. sold item, deactivated). This function pulls those changes back into Shopify.

On the Products page, open the Pull FlowDino updates panel.
Select the start date from which to retrieve changes.
Click Pull updates.
The affected Shopify variants are updated automatically.

6. Mappings

FlowDino uses a controlled reference for categories, brands, colors, materials, sizes and ratings. You must map your Shopify store values to the values accepted by FlowDino.

Important : incomplete mappings may prevent some products from syncing.

6.1 Categories

Maps Shopify product types to FlowDino categories.

Go to Categories in the menu.
Each product type detected in your store appears in the left column.
Select the matching FlowDino category from the dropdown (full path shown, e.g. Electronics > Video Games > Consoles).
Click Save.

Only leaf nodes in the FlowDino tree are selectable (the most specific categories).

6.2 Brands

Maps Shopify vendors to FlowDino brands.

Go to Brands in the menu.
For each Shopify vendor, select the equivalent FlowDino brand. You can search by name.
Set a default brand (used when no mapping is found for a product).
Click Save.

6.3 Colors

The app automatically detects options named Color, Colour or Couleur.

Go to Colors in the menu.
For each Shopify color, select the matching FlowDino color.
Set a default color if needed.
Click Save.

6.4 Materials

Maps your product material values to FlowDino materials. The material data source is configurable in Settings:

Source	Description
Product option	Value of a Shopify option named "Material" or similar
Metafield	Value of a product metafield
Metaobject	Value from a metaobject linked to the product

Go to Materials in the menu.
For each detected value, select the matching FlowDino material.
Set a default material (used when no mapping is found).
Click Save.

6.5 Sizes

Maps Shopify size option values to FlowDino sizes.

Go to Sizes in the menu.
For each Shopify size, select the matching FlowDino size.
Click Save.

6.6 Video game ratings

For video game products, maps your ratings (PEGI, ESRB, etc.) to FlowDino ratings.

Go to Video game ratings in the menu.
For each detected value, select the matching FlowDino rating.
Set a default rating if needed.
Click Save.

7. FlowDino Sales

The Sales page lets you retrieve and view orders placed on FlowDino.

Trigger a sales sync

Go to Sales in the menu.
Click Sync sales.
The app retrieves new orders since your last sync for each of your active sales platforms.

Per-platform statistics

The summary table shows, for each active FlowDino platform:

Column	Description
Platform	Name of the resale site
Orders	Total number of orders retrieved
Revenue	Total sales amount (incl. tax)
Fees	Commissions charged by FlowDino
Net	Net amount received
Active listings	Number of products currently live
Views	Number of views on your listings

Recent orders list

The recent orders table shows for each order: FlowDino ID, date, platform, amount and status.

8. Settings

The Settings page centralizes the app configuration.

FlowDino Connection

Email and Password: your FlowDino account credentials
Connect / Disconnect button
Connection status indicator

Default values

These values are used during sync when no specific mapping is found for a product.

Setting	Description
Default material	Material sent to FlowDino when not mapped
Default video game rating	Rating sent when not mapped
Default brand	Brand sent when the Shopify vendor is not mapped

Sync options

Option	Description
Tax-inclusive prices	Send prices including tax instead of excluding tax
Sync stock	Send stock levels to FlowDino
Auto sync	Automatically sync products when created or updated in Shopify

9. Sync logs

The Logs page shows the complete history of all sync operations.

Available filters

Status: Success / Error / Pending
Entity type: Product / Order
Sync type: Full / Selective / Webhook / Update
Period: Last hour / Today / 7 days / 30 days

Displayed information

Date and time of the operation
Product or entity concerned
Type and direction of the sync
Status (success / error)
Detail message in case of error

Astuce : when a sync fails, check the error message in the logs to identify the cause (missing mapping, incomplete product, API error, etc.).

10. GDPR compliance

The app is fully compliant with Shopify's GDPR requirements:

Webhook	Action
Customer data request	Automatic export of all customer-related data (orders, sync history) in JSON format
Customer deletion	Anonymization of the customer's personal data in the database within 30 days
Shop deletion	Complete deletion of all shop data when the app is uninstalled

These operations are handled automatically without any action on your part.

11. FAQ

My products are not syncing, what should I do?

First check that the FlowDino connection is active in Settings. Then check the Logs to identify the error message. The most common causes are missing mappings (category, brand, color).

How do I know which products have missing mappings?

Run a selective or full sync: skipped products are flagged with the exact reason (e.g. Category not mapped, Color not mapped).

My FlowDino stock does not match Shopify, how do I fix it?

Use the Pull FlowDino updates function (Products page) with an appropriate start date to retrieve the latest stock changes.

Does the app automatically sync new products?

Yes, if the Auto sync option is enabled in Settings. Product creation and updates in Shopify automatically trigger a sync to FlowDino.

How long is the FlowDino connection token valid?

24 hours. The app renews it automatically; you do not need to reconnect manually.

How do I disconnect my FlowDino account?

Go to Settings and click Disconnect. Your mappings and sync data are kept.

Is the app available in multiple languages?

Yes, the interface is available in French, English and Spanish. You can change the language via the selector at the top right of each page.

For technical assistance, please contact our support team.