Most Common Traceability Upload Errors

TRACT runs two rounds of validation on every file:
​

Some fields are required for every record. If any mandatory field is left empty, your upload will fail. Always make sure the following are filled in before uploading:

• Product
• StartNodeID
• SubProduct
• ProductCertification
• SupplyChainType
• UnloadDate
​

UnloadDate and other date fields must match one of the accepted formats. Free text, custom formats, or incomplete dates will be rejected.

• DD/MM/YYYY (e.g. 23/04/2025)
• MM/YYYY (e.g. 04/2025)
• MMM/YYYY (e.g. Apr/2025)
• YYQQ (e.g. 2501 for Q1 2025)
• YYYY (e.g. 2025)
• ISO 8601 with timezone offset (e.g. 2025-04-23T14:30:00Z)
​

Where separators are used, /, -, and . are accepted.
​

Applies to: UnloadDate, SalesContractDate, DeliveryPeriodStartDate, DeliveryPeriodEndDate

• Use one of the accepted formats listed above
• Make sure the date is complete — partial or ambiguous dates will fail
• Check for typos such as letters mixed into date fields

UnloadDate is a required field for every Traceability record. If any row is missing an UnloadDate, the entire upload will fail.

• Check every row has a value in the UnloadDate column
• If the exact date is unknown, use a year (YYYY) or month/year (MM/YYYY) format

ProductCertification is a required field. It must be filled in for every record and must be a valid certification for the selected Product.

• Make sure no ProductCertification cells are blank
• Check the value matches an accepted certification for your product (see #10)

The StartNodeID or EndNodeID is correctly formatted but does not exist in your Master Data. TRACT cannot process a Traceability record that references a location it does not recognise.

• Make sure your Master Data has been uploaded before the Traceability file
• Copy the exact Node ID from your uploaded Master Data rather than typing it manually
• Check for extra spaces, typos, or formatting differences

This error is caused by an issue in your Master Data and prevents TRACT from validating the Traceability record. The Node ID you are referencing as a Start or End Node has a duplicate Node ID in Master Data, which means TRACT cannot uniquely identify which record to link to.

• Go to your Master Data and resolve the duplicate Node ID first
• Re-upload the corrected Master Data
• Then re-upload your Traceability file

The StartNodeID is not in a valid format and cannot be checked against Master Data. The StartNodeID must be either a 32-character system-generated Node ID or a user-defined Node ID from your Master Data.

• Copy the exact ID directly from your uploaded Master Data
• Do not shorten, abbreviate, or manually type Node IDs
• Check for extra spaces or hidden characters

Every transaction must have a unique TransactionId, both within your file and against all previously uploaded records. TRACT rejects any TransactionId it has already seen.

• Check your file for rows with the same TransactionId
• Check if the same TransactionId was used in a previous upload
• Assign a new unique ID to the duplicate

TransactionIds must contain only letters, numbers, and the following separators:

• Period (.)
• Underscore (_)
• Hyphen (-)

Spaces and other special characters are not allowed.

• Remove spaces and unsupported special characters
• Use only . _ - as separators

If you leave the EndNodeID blank (an open-ended segment), TRACT requires a TransactionId to track the shipment. Without it, the record cannot be processed.

• If EndNodeID is blank, enter a TransactionId
• Alternatively, provide an EndNodeID if one is available
• Make sure at least one of these fields is populated before uploading

The certification you entered is not valid for the product you selected. Each product has a defined list of accepted certifications. Values outside that list will be rejected.

• Check that the ProductCertification matches an accepted value for your specific product
• Make sure the ProductCertification field is populated (see #3)
• Contact your TRACT customer success manager if you are unsure which certifications are valid for your product