SHIP FAQ
How do I upload weekly shipment files?
Use /freight-audit/upload for raw UPS billing exports, UPS 2.1 files, or any file that needs column mapping. Use /freight-audit for known-good canonical or FedEx-style CSVs that already work with the standard SHIP upload path.
Can I add headers to a raw UPS export and use the regular SHIP upload?
No. A raw UPS billing export is still a multi-row-per-shipment file even if you add headers. The correct path is to upload the raw UPS file as-is through /freight-audit/upload, or use the direct SHIP upload only when the file already succeeds through the standard intake path.
Why do I see “file already uploaded”?
The system detected a duplicate effective upload. If the earlier upload is still in progress or already completed, use the existing job or results instead of re-uploading. If the earlier SHIP upload failed, the file can be retried.
What states can a finding move through?
OPEN -> DISPUTED -> SUBMITTED -> CARRIER_REVIEW -> CREDITED or REJECTED, plus DISMISSED where appropriate. Dismissed, credited, rejected, submitted, and carrier-review findings can be reopened back to OPEN.
What is the required external reference when I submit or acknowledge a claim?
Use the carrier-facing claim or ticket ID that identifies the case in carrier systems. This is required for both submit and acknowledge transitions so the claim can be audited and reconciled later.
When can I mark a finding as credited?
Only after you have confirmed carrier credit or refund evidence and can provide:
- source
- reference ID
- confirmation timestamp
- positive amount
Can I credit findings in batch?
No for billing-critical credit confirmation. Use the per-finding credit flow so each finding has its own confirmation payload.
What does billable recovered value mean?
A finding is billable only when it is CREDITED with complete confirmation evidence. Disputed, submitted, and review states are not billable.
Where do I manage notification preferences?
Use /notifications.
Where do SHIP dispute links go?
They should take you to /ship/audit.
What should I capture before asking support for help?
- tenant or workspace name
- finding ID or job ID
- current state
- requested action
- error message payload
- deadline or value impact
When should I escalate to human support?
Escalate immediately for missing evidence on credit requests, repeated API failures, deadline-risk claims, or any billing ambiguity.