Skip to Content
ProductSHIP Guide

SHIP Guide

SHIP is the freight-audit workflow in RGL8R. It is designed for teams that need to go from uploaded shipment or billing data to operational findings and then through a tracked dispute lifecycle.

Start here

Main surfaces

  • Freight Audit Upload Wizard (/freight-audit/upload) for UPS 2.1 billing exports and files that need column mapping
  • Freight Audit (/freight-audit) for known-good canonical or FedEx-style CSV uploads
  • SHIP Audit (/ship/audit) for findings review and shipment detail
  • SHIP Claims (/ship/claims) for packetized carrier submissions and credit confirmation
  • SHIP Agreements for carrier agreement imports and reference context

Use /freight-audit/upload when

  • you are uploading a raw UPS billing export, including UPS 2.1 files with no header row
  • your file has custom column names
  • you need to review column mapping before processing
  • you are not sure the file already matches the standard SHIP CSV shape

Upload raw UPS exports as-is. Do not manually add headers to the raw UPS file. The backend adapter handles UPS-specific parsing and aggregation during processing.

Use /freight-audit when

  • you already have a known-good SHIP CSV
  • you are uploading a FedEx-style file that already works through the standard SHIP intake path
  • you do not need column mapping or UPS-specific previewing

Typical workflow

  1. Upload shipment or billing data.
  2. Review findings and evidence in SHIP Audit.
  3. Move valid findings into dispute workflow.
  4. Group eligible findings into claim submissions.
  5. Track carrier acknowledgement, review, rejection, or credit confirmation.
  6. Reconcile confirmed credits before billing or downstream reporting.

Workflow states to expect

Individual findings move through states such as:

  • OPEN
  • DISPUTED
  • SUBMITTED
  • CARRIER_REVIEW
  • CREDITED
  • REJECTED
  • DISMISSED

Claim submissions track a related but separate packet lifecycle.

Duplicate uploads

SHIP blocks duplicate uploads when the matching file is already:

  • PENDING
  • PROCESSING
  • COMPLETED

If the earlier SHIP upload failed, you can retry the file. When a duplicate is blocked, use the existing job or results link instead of starting a second in-progress copy.

Claims and dispute flow

Use SHIP Audit to move valid findings into dispute, then use SHIP Claims to build and track carrier submissions.

When moving a claim into a submitted or acknowledged carrier-facing state, capture the real carrier reference in externalReference. Use the actual claim ID, case ID, or equivalent carrier ticket reference so the claim can be audited and reconciled later.

Agreements and reference data

Carrier agreements can be uploaded to improve operating context. The agreements workflow supports review before import, including PDF-based extraction flows where relevant.

Pack profiles

Pack profiles let you define standard dimension templates and assign SKUs to them. This avoids entering per-shipment dimensions manually and improves audit accuracy when carrier billing is based on dimensional weight.

  • Create profiles with standard length, width, height, and weight dimensions for common packaging types.
  • Assign SKUs to profiles so that SHIP uses the profile dimensions when auditing shipments for those SKUs.
  • Override dimensions at the SKU level when a specific SKU’s packaging differs from its assigned profile.
  • Effective dimensions for any SKU are resolved as: SKU-level override → assigned profile → carrier-reported dimensions.

Pack profiles and SKU assignments are managed via the SHIP API. Profiles cannot be deleted while active SKU assignments exist.

Accessorial charge analysis

Accessorial charge breakdowns are available through the SHIP API. Use them to understand which accessorial types contribute most to freight cost and where carrier billing patterns may warrant investigation.

Adjustment bias analytics

Adjustment bias data is available through the SHIP API, showing how carrier-applied adjustments trend over a configurable lookback period. The bias percentage indicates whether adjustments are systematically skewing costs up or down.

Use this to identify carriers or accounts where adjustment patterns may warrant renegotiation or further audit.

What to validate in Sandbox

  • Your input file format maps cleanly.
  • UPS billing exports work through the upload wizard without manual file edits.
  • Findings are understandable to your operations team.
  • The dispute and claims workflow matches how you work carriers today.
  • Confirmed credits and exception cases are handled the way you expect.
SHIP Quick StartSHIP FAQ