Articles on: Frequently Asked Questions (FAQ)

Does Stock Sync support zip file(s)?

Yes, Stock Sync fully supports compressed ZIP files across file-based feed connections. You do not need to manually unzip or extract the archive before uploading it or processing your feed; Stock Sync automatically decompresses the file and reads the contents.


You do not need to extract the compressed file before running your feed—Stock Sync handles decompression automatically.



How to Set Up a ZIP File Feed


Go to App → Feed Settings → Step 1: Connection


  1. Provide the ZIP Source: Enter the file path, upload the archive, or provide the download URL pointing to your .zip file (e.g., via FTP, SFTP, HTTP/HTTPS URL, or direct upload).
  2. Configure File Format: In the File Format dropdown, select the actual format of the file located inside the ZIP archive (e.g., CSV, XML, TXT, or XLSX), or set it to Auto.
  3. Save and Test: Click Test Connection or run a preview to ensure Stock Sync successfully decompresses and detects the data columns.


Always set the File Format field to match the extracted file type (e.g., CSV or XML), not the .zip wrapper.



ZIP File Configuration Breakdown


1. Automatic Extraction

When a feed runs, Stock Sync downloads the .zip archive, extracts the contained data file in a secure temporary environment, and processes the rows according to your field mappings.


The archive should contain an unencrypted data file that matches a supported Stock Sync file format.


2. File Format Matching

Because .zip is a compression container and not a tabular data structure, the feed parser needs to know what format the extracted file uses.


Source Archive

File Inside ZIP

File Format Setting

Extraction & Sync Behavior

inventory.zip

inventory.csv

CSV (or Auto)

Automatically extracts and parses CSV columns

products.zip

catalog.xml

XML

Automatically extracts and parses XML nodes

feed.zip

supplier_data.xlsx

XLSX

Automatically extracts and reads Excel sheets

stock.zip

stock_levels.txt

TXT

Automatically extracts and parses tab/comma text



Key Rules & Technical Details


  • Inner File Format Requirement: Ensure the File Format setting in Step 1 reflects the actual extension of the file inside the archive. Setting the parser incorrectly can lead to read errors.
Priority rule: Stock Sync does not support password-protected or encrypted ZIP files. Archives must be accessible without a decryption key.
  • Archive Contents: Best practice is to include only a single data file inside the ZIP archive to prevent file-selection ambiguities during automated scheduled runs.



Troubleshooting Steps


  • Issue: The feed fails with a file format or parse error. → Solution: Verify what kind of file is compressed inside the ZIP archive. If the inner file is a CSV, change the File Format setting from Auto to CSV.
  • Issue: Connection fails when attempting to read the ZIP file. → Solution: Confirm that the ZIP archive is not password-protected or encrypted by your supplier.
  • Issue: Multiple files exist inside the ZIP and the wrong data is synced. → Solution: Ensure your supplier archives only the relevant feed file, or specify the exact filename if supported by your connection method.



Good Articles to Continue


Updated on: 03/11/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!