--- title: "Action: Serial-numbered items (product instances)" description: "Imports individually tracked product instances (serialized units) into Sapera. Rows are matched on the instance Identifier; matched instances are updated and new ones are created. Run Compare first to preview the changes." url: https://support.sapera.io/en/articles/587-action-serial-numbered-items-product-instances collection: "SyncTool" updated: 2026-09-25 language: en alternates: [da] --- # Action: Serial-numbered items (product instances) Imports individually tracked product instances (serialized units) into Sapera. Rows are matched on the instance Identifier; matched instances are updated and new ones are created. Run Compare first to preview the changes. Imports individually tracked serial-number items (serialized units) into Sapera. Rows are matched on the instance Identifier; matched instances are updated and new ones are created. Run Compare first to preview the changes. ## How to use the action 1\. Select the action in the **Action** field. 2. Point to your data source – a **file** (CSV or Excel) or a **SQL query**. 3. Map the source columns to Sapera's fields in the column mapping (see _Source fields_ below). 4. Run **Compare** to see what will be created, changed or stay unchanged – without writing to Sapera. 5. Run **Update Sapera** to perform the import. Use the **Allow create** and **Allow update** parameters to control whether new rows are created and whether existing ones are updated. ## How matching and updating works Each row is matched on the instance's **identifier** (Identifier). Matching instances are updated and new ones created. - Each instance belongs to a product (ProductIdentifier) and can carry a serial number and current owner. - Only the instances in your source are processed. Direction: from file/SQL into Sapera. ## Key parameters

Parameter	Explanation
AllowCreate	When enabled, instances that do not yet exist are created.
AllowCreateCatalogValues	When enabled, missing catalog/attribute values are created during import.
AllowUpdate	When enabled, existing instances are updated with the imported values.
InstanceTemplate	System name of the template used when creating new instances.
StockDraft	Name of the stock draft used when stock counts are imported.

## Source fields

Field	Explanation
AddressLine1	First address line for the instance.
AddressLine2	Second address line for the instance.
BarCode	Bar code of the instance.
Country	Country of the instance address.
CurrentOwnerIdentifier	Identifier of the actor that currently owns the instance.
DiscountPrice	Discounted sales price of the instance.
DisplayName	Name shown for the instance.
Identifier	Unique identifier of the serial-number item; used to match rows.
IsUsed	Whether the instance is used (second-hand).
PostalCode	Postal code of the instance address.
PostalDistrict	Postal district of the instance address.
ProductIdentifier	Identifier of the product this instance belongs to.
PurchasePrice	Purchase price of the instance.
RegistrationNo	Registration number of the instance (for example a vehicle plate).
Remark	Free-text remark on the instance.
SalesPrice	Sales price of the instance.
SerialNumber	Serial number of the instance.
SoldAt	Date and time the instance was sold.
State	Current state of the instance.
WorkflowCommunicationInitiationDate	Date the workflow communication was initiated.
WorkflowCommunicationType	Type of workflow communication associated with the instance.

* * * See also the overview [SyncTool – actions](https://support.sapera.io/en/articles/547-synctool-handlinger.md). * * * **Want to know more?** Read more in these related articles: [ Standard parameters for all actions The general parameters available on most SyncTool actions: step control, error handling, timeout, etc. ](https://support.sapera.io/en/articles/648.md)