Recurring Import Tool FAQ
The Recurring Import tool is a powerful automation feature within Acenda that allows you to synchronize data from external sources on a set schedule. This tool is commonly used to keep your store updated with the latest information from PIMs, ERPs, or external warehouses.
What data can I update using Recurring Imports?
You can automate updates for nearly any data model within Acenda. Examples include:
Catalog: Syncing product titles, descriptions, and attributes.
Pricing: Updating MSRP, cost, and sale prices.
Promotions: Managing active coupons and site-wide discounts.
Fulfillment: Syncing inventory levels, warehouse locations, and shipping status.
How do I set up a new Recurring Import?
Follow these steps to configure your automated data sync:
Access the Tool: Navigate to Acenda Admin > Import/Export. Select the Import tab and click the Recurring Imports button.
Create New Entry: Click the + New button.
Select Model: Choose the import type model you wish to update (e.g., Catalog).
Name the Import: Assign a unique name to your import for easy identification (e.g., Salsify Catalog).
Configure SFTP and Schedule:
Enter your SFTP credentials and directory details.
Set the frequency of the import using a Cron schedule.
You may use one of the available presets or create a custom schedule. If you need assistance with custom expressions, crontab.guru is a helpful resource.
6. Save Initial Configuration: Click the Save button to proceed to field mapping.
How do I map my data fields?
Once the initial setup is saved, you must map the columns in your source file to the fields in Acenda. You have two options:
Automatic Mapping: Upload your file to the designated SFTP directory and click the Sync Fields button. This will automatically pull the headers from your file.
Manual Mapping: Click the + Add Row button to manually define each field mapping.
What are the different mapping types?
When configuring your rows, you must select one of the following types for each field:
Type | Description | Example |
Source Property | Directly maps a column from your file to an Acenda field. | Map "brand_column" to fields.brand |
Static String | Applies a fixed value to every record in the import. | Set value to "Acme" |
Logic Rule | Uses a Twig rule to transform or modify source data. | {{ fields.brand|title }} Here's a way to reformat fields.brand to Title Case. |
Pro Tip: If you require complex transformations for a Logic Rule, you can use ChatGPT to generate the necessary Twig syntax based on your requirements.
Finalizing the Setup
After you have completed your field mapping, click the Save button. Your import is now active and will run automatically according to the Cron schedule you defined.