Skip to main content

SHIPMENT_COST — Oracle Transportation Management Reference

Shipment cost records for freight charges and accessorials.

This page documents the SHIPMENT_COST table in Oracle Transportation Management (OTM) -- columns, primary key, incremental cursor, and the exact REST API endpoints used to extract it. This is one of 18 OTM tables that Supaflow's Oracle Transportation Management connector syncs natively into Snowflake, Databricks, BigQuery, Redshift, or Postgres.

Overview

AttributeValue
OTM export table nameSHIPMENT_COST
OTM metadata resource nameshipmentCosts
Primary keySHIPMENT_COST_SEQNO
Incremental cursor fieldUPDATE_DATE
CategoryShipment children

OTM REST API endpoints

OTM exposes every table through the logistics REST API. Paths depend on the authentication method you use.

Export API (fetch rows)

POST one of the following URLs, depending on your OTM authentication mode:

  • OAuth 2.0 (IDCS): https://{your-otm-host}/logisticsRestApi/data/v1/exportRequests/
  • Basic Auth: https://{your-otm-host}/logisticsRestApi/data-int/v1/exportRequests/

Example request body for SHIPMENT_COST:

{
"schema": "PRIMARY",
"contentType": "text/plain",
"tables": {
"items": [
{ "tableName": "SHIPMENT_COST", "partSize": 5000 }
]
}
}

To pull only rows updated after a given timestamp (the recommended pattern for incremental sync), add a rangeAfter block:

{
"schema": "PRIMARY",
"contentType": "text/plain",
"rangeAfter": { "value": "2026-04-01T00:00:00Z" },
"tables": {
"items": [
{ "tableName": "SHIPMENT_COST", "partSize": 5000 }
]
}
}

The response is a CSV payload with the table name on line 1, column headers on line 2, and data rows starting on line 3.

Metadata catalog (fetch schema)

GET the schema for SHIPMENT_COST:

  • OAuth 2.0: https://{your-otm-host}/logisticsRestApi/resources/v2/metadata-catalog/shipmentCosts
  • Basic Auth: https://{your-otm-host}/logisticsRestApi/resources-int/v2/metadata-catalog/shipmentCosts
note

The OTM metadata-catalog endpoint returns HTTP 400 for several tables. If you receive a 400 here, fall back to data-driven type inference by sampling rows from the Export API. See the OTM integration guide for the full pattern.

Columns

ColumnTypeNullablePKForeign key
SHIPMENT_COST_SEQNONUMBER()Yes
SHIPMENT_GIDVARCHAR2(101)SHIPMENT
COST_TYPEVARCHAR2(1)COST_TYPE
COSTNUMBER()
COST_GIDVARCHAR2(101)CURRENCY
COST_BASENUMBER()
ACCESSORIAL_CODE_GIDVARCHAR2(101)YesACCESSORIAL_CODE
ACCESSORIAL_COST_GIDVARCHAR2(101)YesACCESSORIAL_COST
BILLABLE_INDICATOR_GIDVARCHAR2(101)YesBILLABLE_INDICATOR
RATE_GEO_COST_GROUP_GIDVARCHAR2(101)Yes
RATE_GEO_COST_SEQNUMBER()Yes
SPECIAL_SERVICE_GIDVARCHAR2(101)YesSPECIAL_SERVICE
IS_COST_FIXEDVARCHAR2(1) Y/N
PROCESS_AS_FLOW_THRUVARCHAR2(1) Y/N
ADJUSTMENT_REASON_GIDVARCHAR2(101)YesADJUSTMENT_REASON
GENERAL_LEDGER_GIDVARCHAR2(101)YesGENERAL_LEDGER_CODE
PAYMENT_METHOD_CODE_GIDVARCHAR2(101)YesPAYMENT_METHOD_CODE
EXCHANGE_RATE_DATEDATEYes
EXCHANGE_RATE_GIDVARCHAR2(101)YesEXCHANGE_RATE
COST_FNNUMBER()Yes
COST_FN_CURRENCY_GIDVARCHAR2(101)YesCURRENCY
S_SHIP_UNIT_GIDVARCHAR2(101)Yes
S_SHIP_UNIT_LINE_NONUMBER()Yes
IS_WEIGHTEDVARCHAR2(1) Y/N
DOMAIN_NAMEVARCHAR2(50)
INSERT_USERVARCHAR2(128)
INSERT_DATEDATE
UPDATE_USERVARCHAR2(128)Yes
UPDATE_DATEDATEYes
COST_CATEGORY_GIDVARCHAR2(101)YesCOST_CATEGORY
TRACKING_NUMBERVARCHAR2(240)Yes
COST_IDENTIFIERVARCHAR2(256)Yes
ATTRIBUTE1VARCHAR2(150)Yes
ATTRIBUTE2VARCHAR2(150)Yes
ATTRIBUTE3VARCHAR2(150)Yes
ATTRIBUTE4VARCHAR2(150)Yes
ATTRIBUTE5VARCHAR2(150)Yes
ATTRIBUTE6VARCHAR2(150)Yes
ATTRIBUTE7VARCHAR2(150)Yes
ATTRIBUTE8VARCHAR2(150)Yes
ATTRIBUTE9VARCHAR2(150)Yes
ATTRIBUTE10VARCHAR2(150)Yes
ATTRIBUTE11VARCHAR2(150)Yes
ATTRIBUTE12VARCHAR2(150)Yes
ATTRIBUTE13VARCHAR2(150)Yes
ATTRIBUTE14VARCHAR2(150)Yes
ATTRIBUTE15VARCHAR2(150)Yes
ATTRIBUTE16VARCHAR2(150)Yes
ATTRIBUTE17VARCHAR2(150)Yes
ATTRIBUTE18VARCHAR2(150)Yes
ATTRIBUTE19VARCHAR2(150)Yes
ATTRIBUTE20VARCHAR2(150)Yes
ATTRIBUTE_NUMBER1NUMBER()Yes
ATTRIBUTE_NUMBER2NUMBER()Yes
ATTRIBUTE_NUMBER3NUMBER()Yes
ATTRIBUTE_NUMBER4NUMBER()Yes
ATTRIBUTE_NUMBER5NUMBER()Yes
ATTRIBUTE_NUMBER6NUMBER()Yes
ATTRIBUTE_NUMBER7NUMBER()Yes
ATTRIBUTE_NUMBER8NUMBER()Yes
ATTRIBUTE_NUMBER9NUMBER()Yes
ATTRIBUTE_NUMBER10NUMBER()Yes
ATTRIBUTE_NUMBER11NUMBER()Yes
ATTRIBUTE_NUMBER12NUMBER()Yes
ATTRIBUTE_NUMBER13NUMBER()Yes
ATTRIBUTE_NUMBER14NUMBER()Yes
ATTRIBUTE_NUMBER15NUMBER()Yes
ATTRIBUTE_NUMBER16NUMBER()Yes
ATTRIBUTE_NUMBER17NUMBER()Yes
ATTRIBUTE_NUMBER18NUMBER()Yes
ATTRIBUTE_NUMBER19NUMBER()Yes
ATTRIBUTE_NUMBER20NUMBER()Yes
ATTRIBUTE_DATE1DATEYes
ATTRIBUTE_DATE2DATEYes
ATTRIBUTE_DATE3DATEYes
ATTRIBUTE_DATE4DATEYes
ATTRIBUTE_DATE5DATEYes
ATTRIBUTE_DATE6DATEYes
ATTRIBUTE_DATE7DATEYes
ATTRIBUTE_DATE8DATEYes
ATTRIBUTE_DATE9DATEYes
ATTRIBUTE_DATE10DATEYes
ATTRIBUTE_DATE11DATEYes
ATTRIBUTE_DATE12DATEYes
ATTRIBUTE_DATE13DATEYes
ATTRIBUTE_DATE14DATEYes
ATTRIBUTE_DATE15DATEYes
ATTRIBUTE_DATE16DATEYes
ATTRIBUTE_DATE17DATEYes
ATTRIBUTE_DATE18DATEYes
ATTRIBUTE_DATE19DATEYes
ATTRIBUTE_DATE20DATEYes
ATTRIBUTE_CURRENCY1NUMBER()Yes
ATTRIBUTE_CURRENCY1_GIDVARCHAR2(101)Yes
ATTRIBUTE_CURRENCY1_BASENUMBER()Yes
ATTRIBUTE_CURRENCY2NUMBER()Yes
ATTRIBUTE_CURRENCY2_GIDVARCHAR2(101)Yes
ATTRIBUTE_CURRENCY2_BASENUMBER()Yes
ATTRIBUTE_CURRENCY3NUMBER()Yes
ATTRIBUTE_CURRENCY3_GIDVARCHAR2(101)Yes
ATTRIBUTE_CURRENCY3_BASENUMBER()Yes
Column list source

The column list above is extracted from Oracle's OTM data dictionary included with the February 2025 release snapshot of this connector. Oracle publishes an updated dictionary with every Transportation and Global Trade Management release; for the current version, consult Oracle's Transportation and Global Trade Management documentation.

Incremental sync

The SHIPMENT_COST table supports incremental sync via the UPDATE_DATE cursor. Supaflow's connector handles:

  • Server-side clock skew -- measured once from OTM's RFC 1123 Date header and applied to every cursor comparison.
  • Late-arriving updates -- configurable lookback window (recommended 300-600 seconds in production) re-scans the tail of the previous window.
  • Identical-timestamp batches -- tracks record count at the maximum cursor timestamp so batch updates that stamp thousands of rows with the same UPDATE_DATE don't cause missed or duplicated rows.

Full pattern: The Complete Guide to Oracle Transportation Management Integration.

Sync SHIPMENT_COST with Supaflow

Supaflow's Oracle Transportation Management connector syncs SHIPMENT_COST -- along with 17 other OTM tables -- into your cloud data warehouse with:

  • Sync and async (Object Storage PAR) export modes
  • Proactive OAuth token refresh (60-second safety margin on IDCS tokens)
  • Composite primary key preservation for tables with multi-field keys
  • Automatic handling of the five OTM-specific data quirks (metadata 400s, "0" temporal sentinels, Z-suffixed date fields, 1 MB sync-mode truncation, _TEXT / _COMMENT column type overrides)
  • Predictable connector-based pricing -- not per-row, not per MAR

Next steps: