Product Sources
Product sources at /integrations/product-sources let you connect external catalogs to import and keep your products synchronized in Fenicia. Centralize your catalog regardless of where the data originates.
Compatible Platforms
| Platform | Type | Sync |
|---|---|---|
| Shopify | E-commerce | Bidirectional (products, variants, images) |
| WooCommerce | E-commerce | Import with periodic sync |
| Custom API | Custom | Flexible configuration via webhooks or polling |
Tip
If you already have a Shopify channel connected in Fenicia, the product source is configured automatically. You do not need an additional connection to import the catalog.
Connect a Source
Select platform
On the product sources screen, click "Add source" and select the origin platform.
Authenticate the connection
Depending on the platform, complete the authentication flow:
- Shopify: Enter your store URL and authorize via OAuth.
- WooCommerce: Provide the site URL, consumer key, and consumer secret.
- Custom API: Configure the endpoint, authentication method, and data format.
Configure field mapping
Associate the external catalog fields with product fields in Fenicia (name, SKU, price, description, images, variants).
Start import
Run the first import. Depending on catalog size, it can take from seconds to several minutes.
Source Status
Each connected source displays a status indicating its current condition:
| Status | Description |
|---|---|
| Active | The source is working and syncing at the configured frequency |
| Inactive | The source is paused; no syncs are executed |
| Syncing | An import or sync is in progress |
| Error | The last sync failed; review the error details |
Sources with errors
If a source remains in error status, verify that credentials are still valid and the external service is available. Fenicia retries automatically, but if the error persists for more than 24 hours, the source is deactivated.
Import Workflows
Initial Import
The first sync imports the entire available catalog. During this process:
- Products are created in Fenicia with all their information (name, description, price, images).
- Variants are imported with their attributes (size, color, material).
- SKUs are validated to prevent duplicates.
Periodic Sync
After the initial import, the source syncs changes incrementally:
- New products: Automatically created in Fenicia.
- Modified products: Changed fields are updated.
- Deleted products: Marked as inactive in Fenicia (not deleted).
Manual Sync
At any time you can force a sync by clicking "Sync now". This is useful when you made changes on the external platform and do not want to wait for the next automatic cycle.
Active/Inactive Filtering
Use the filters at the top to view:
- All: Shows all configured sources.
- Active: Only sources that are syncing regularly.
- Inactive: Paused or disconnected sources.
Manage a Source
From each source's detail you can:
- Edit configuration: Modify sync frequency, field mapping, or credentials.
- Pause/Resume: Temporarily stop syncing without losing configuration.
- View history: Check a log of all executed syncs with their results.
- Delete: Permanently disconnect the source. Already imported products remain in Fenicia.
Orphaned products
If you delete a source, products imported from it will continue to exist in your Fenicia catalog. You can edit or delete them manually as needed.
Next Steps
- Inventory Sources to sync stock levels from external systems.
- Sales Channels to publish imported products on marketplaces.