File packages
Deliver the files of many products in a ZIP —for a tender, a retailer, a marketplace or a distributor— with the names they ask for and an index with each file's fingerprint.
What it is
A package is a ZIP with the files of some products, built with a template. It's built outside Bruxel: you request it, we let you know in the bell when it's ready and you download it from “File packages” for 7 days.
The templates
In Media → “Packages” → “Package templates” an admin saves the organization's templates: which file types each one carries (and whether the current version or the latest approved one goes), which images (main, gallery, color swatch), how each file is named inside the ZIP and whether it includes an index.
Changing a template doesn't change the packages already requested with it. Within each product, images go first (the main one is 1) and then the types, in the order of “File types”.
| Piece | What it puts |
|---|---|
| '{sku}' | The product's SKU. It always goes. |
| '{type}' | The file type's code, or the image's (main, gallery, swatch). |
| '{version}' | The version number (1 if the file never had another). |
| '{n}' | 1, 2, 3… within the product, in the template's order. |
| '{filename}' | The file's original name, without its extension. |
| '{ext}' | The file's real extension. The name always ends in .'{ext}'. |
Requesting a package
From the catalog: pick products and use “File package”, or filter and use “File package with the filtered ones”. You can also pick a saved view on the packages screen. “Calculate” tells how many products and files it carries and what's left out; “Request package” sends it to be built.
A draft never goes in a package: with “the current one”, a file whose current version isn't approved is left out; with “the latest approved”, the latest version that went through an approval goes. Only files with a clean virus check go. Requesting packages is for a team member or above.
The index
If the template includes it, the ZIP carries index.csv (for Excel) and index.pdf with each file: its name in the ZIP, SKU, type, version, date, who approved it and when, its sha256 and its size. The sha256 is the file's fingerprint: whoever receives it can check it's exactly that one. The screen also shows the sha256 of the whole ZIP.
Limits
- Up to 5,000 products, 10,000 files and 10 GB per package; if it goes over, narrow the filter or request two.
- Up to 3 packages being built per person and 50 a day per organization.
- The ZIP is deleted after 7 days; the files stay in the library and you can request it again.
- Also through the public API, with the files:read permission.