Import artwork files for campaign items

Imports artwork files from a ZIP archive and associates them with campaign items based on POS numbers.

Import Process:

Accepts ZIP file containing image/PDF files at root level

Matches files to campaign items by filename = POS number

Creates or updates Artwork entities for each matched item

Updates campaign items to mark them as having artwork

Supports JPG, PNG, GIF, BMP, PDF file formats

File Matching:

File name (without extension) must match item's POS number exactly

Case-sensitive matching

Files not matching any POS number are reported as unmatched

Files in subdirectories or system files are rejected

Business Rules:

Campaign must not be locked

Only image and PDF files are accepted

Locked campaign items are skipped and reported

Existing artwork is updated, new artwork is created as needed

Campaign items are marked as having artwork after successful import

Side Effects:

Creates File entities for uploaded artwork

Updates or creates Artwork entities

Updates CampaignItem hasArtwork flag

Generates thumbnails for image files (not PDFs)

{ "itemIds": [ "660e8400-e29b-41d4-a716-446655440001", "660e8400-e29b-41d4-a716-446655440002" ], "itemEntities": [ { "_id": "660e8400-e29b-41d4-a716-446655440001", "name": "Promotional Flyer", "posNumber": "FLY001", "artworks": [ "770e8400-e29b-41d4-a716-446655440003" ] } ], "unmatchedItems": [ "UNKNOWN001.jpg", "backup_file.txt" ], "lockedItems": [ "LOCKED001.jpg" ], "errors": [], "writeErrors": [] }

Import artwork files for campaign items

Request

Responses