HomeHelp guidesAPI
Help guides

Validation Process

Uploading your rate sheet to Integrated Rate Management

When you upload your completed Xeneta rate sheet template, the system performs comprehensive automatic validation to ensure data quality and system compatibility.

This is an important process as it helps maintain data integrity across the platform.

What is validated?

Please see the table below to see how columns are validated.

Field

Value

Container types

Only supported container types are accepted. Automatic value mapping occurs for common variations, for example:

  • "40FT" -> "40DC"
  • "40' Standard Dry" -> "40DC"
  • "40' High Cube Dry" -> "40HC"
  • "40 hc" or "40' hc" or "40' HC" -> "40HC"
  • "20FT" -> "20DC"
  • "45FT" -> "45DC"
  • Any many other common variations

Service mode

Automatic mapping occurs of common abbreviations, for example:

  • "CY" -> "CONTAINER_YARD"
  • "CFS" -> "CONTAINER_FREIGHT_STATION"
  • "SD" / "DO" / "D" -> "DOOR"
  • "DC" -> "DISTRIBUTION_CENTER"
  • "WH" -> "WAREHOUSE"
  • "RT" -> "RAIL_RAMP"
  • "PT" -> "PORT"
  • "AP" -> "AIRPORT"
  • "FC" -> "FACTORY"
  • "CD" -> "CROSS_DOCK"
  • "IT" -> "INTERMODAL_TERMINAL"

Unit of measurement

Automation standardization will be applied, for example:

  • "teu" -> "PER_TEU"
  • "per 20ft" / "per 40ft" / "per 45ft" / "container" -> "PER_CONTAINER"
  • "per cbm" / "lcl" / "cbm" -> "PER_LCL"
  • "shipment" -> "PER_SHIPMENT"

Location validation (origin and destination)

The system validates locations using integrated lookup tools.

  • Port names and codes (offered): validated against Xeneta's port database. Please note that port of loading and discharge must be different.
  • Supplier (contract provider): mandatory field, will error if not supplied.
  • Carrier (if different from supplier): optional field.

Other information: Ports can be in different locations than country/city as these refer to the collection and drop-off location. Country, city, province, street address, and zip code should be in same location.

Currency

All currency values must be numeric. No text or special characters are allowed. Decimal values are supported.

Date

Contract validity start must be before end date.


Validation color codes

Understanding what the color highlighting means helps you correct issues efficiently.

ColorWhat it can mean
BlueA cell was auto-corrected. You can hover over to see a tooltip explanation of the correction. For example, a port name typo was corrected from Rotterdan to Rotterdam.
YellowNeeds attention, but you can proceed with the upload. This could be you're missing optional information or have minor inconsistencies. For example, missing IMO class when hazardous is set to Yes.
RedCritical error that must be corrected. You cannot proceed with the upload until resolved. A specific error message will appear explaining what needs fixing. For example, missing required field, invalid date format, or unrecognizable port code.

Common validation issues

Be aware of these common validation issues that may slow your upload.

Watch out for:

These could be:

Missing required fields

  • Supplier
  • Port of loading
  • Port of discharge
  • Container type
  • Contract validity start
  • Contract validity end
  • OTHC included in ocean rate (Yes/No)
  • DTHC included in ocean rate (Yes/No)

Format errors

  • Invalid date formats (correct format: YYYY-MM-DD)
  • Non-numeric currency values (text or special characters)
  • Unrecognized container types
  • Invalid port codes

Duplicate detection

After validation passes, Integrated Rate Management checks for duplicates before submitting your rates.

🚧

A rate is considered a duplicate when it matches an existing rate on all of the following fields and has an overlapping validity period: Contract number, Supplier, Container type, Port of loading, Port of discharge, Origin service mode, Origin street address, Origin City, Origin state/province, Origin ZIP code, Origin country, Origin country code, Destination service mode, Destination street address, Destination city, Destination state/province, Destination ZIP code, Destination country, Destination country code and Hazardous classification

If any of these fields differ, the rates are treated as distinct. For example, two rates with the same port-to-port routing but serving different inland locations, or one for hazardous and one for standard cargo, will both be accepted as separate rates.

Duplication check:What happens:
Duplicate with no changesThe record remains unchanged, with no user notification. The system recognizes it's identical to an existing rate.
Duplicate with value changesThe system will prompt for confirmation to update. It will show a comparison of current vs. new value. You must confirm before updating.
Duplicate within the same fileThe system will identify and flag. This requires correction before proceeding as you cannot upload both versions.
New distinct rateIf any of the matching fields differ, a new rate entry is created with no duplicate warning.

Data visibility after upload

Once the upload is confirmed, your rates are instantly accessible to all company users with IRM access - giving your team immediate visibility for faster, more efficient rate management.

Your rates will also be available across Xeneta - Ocean Monitor, Ocean Analyze, and our other benchmark products - under 'Your rates'. This process removes the previous 5-day SLA, giving you near real-time benchmarking capability.


Xeneta Footer - Fixed