> ## Documentation Index
> Fetch the complete documentation index at: https://developer.orchestro.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Shipper Invoice
> This section detail all the fields in the Orchestro standardized [shipper invoice template](https://developer.orchestro.ai/dev/invoice/shipper/shipper-invoice-template).
Orchestro uses a standardized Shipper invoice format for all shipments. This format is included as an attached Excel template (".xlsx") containing example data. The document accompanying the template details each field.
## Field Specifications
Below is an example of the various field specification data.
### Invoice Level fields
| Invoice Field | Details | Data Type |
| -------------------------- | ----------------------------------------------------------------------------------------- | ---------------------------------- |
| orchestro\_account\_number | Orchestro’s Customer Account Number for the Shipper | String(100) |
| customer\_name | Name of the shipping company | String(100) |
| invoice\_number | The number for the invoice from the Shipper side | String(50) |
| invoice\_date | The date the invoice was generated | Timestamp(MM/DD/YYYY) |
| payment\_terms | Payment Terms as set in the contract. It is the number of days for payment of the invoice | Numeric |
| due\_date | Due Date for the invoice | Timestamp(MM/DD/YYYY) |
| invoice\_amount | Total Invoice Amount | Numeric(10,2) |
| currency\_code | Invoice Currency Code | String(3)
example: USD |
### Parcel Level fields
| Invoice Field | Details | Data Type |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| transaction\_date | The date the order was created. This is usually the date of manifest in the Shipper system | Timestamp(MM/DD/YYYY) |
| orchestro\_tracking\_number | Orchestro tracking number for the given parcel | String(50) |
| carrier\_tracking\_number | Tracking number of the Carrier for the given parcel | String(50) |
| other\_carrier\_tracking\_number | Additional tracking number of the carrier if applicable | String(50) |
| reference\_1 | Reference 1 as provided during order creation | String(50) |
| reference\_2 | Reference 2 as provided during order creation | String(50) |
| reference\_3 | Reference 3 as provided during order creation | String(50) |
| invoice\_type | Type of invoice | String (50)
(Valid Values: Regular/Adjustment/Claim) |
| service\_type | The network service type code of Orchestro | String(50)
(e.g. GRD, DGRD) |
| zone | Zone of the parcel used in the billing (as per the agreed contract with Orchestro) | Numeric(4, 0) |
| parcel\_type | Type of the packaging of the parcel | String(50)
(Valid values: Box/Envelope/Polybag) |
| unit\_of\_length | Unit of measure for the dimensions of the parcel | String(10)
(Valid values: in/cm/ft)
In - Inches
cm - Centimeters
Ft - Feet |
| declared\_length | Length of the parcel as received from the sender of the parcel/Orchestro | Numeric(10, 2) |
| declared\_width | Width of the parcel as received from the sender of the parcel/Orchestro | Numeric(10, 2) |
| declared\_height | Height of the parcel as received from the sender of the parcel/Orchestro | Numeric(10, 2) |
| actual\_length | Length of the parcel as measured by the Shipper | Numeric(10, 2) |
| actual\_width | Width of the parcel as measured by the Shipper | Numeric(10, 2) |
| actual\_height | Height of the parcel as measured by the Shipper | Numeric(10, 2) |
| unit\_of\_weight | Unit of measure for the weight of the parcel | String(10)
String (Valid values: oz/lb/g/kg)
oz - ounces
lb - pounds
g - grams
Kg - kilograms |
| declared\_weight | The physical weight of the parcel as received from the sender of the parcel/Orchestro | Numeric(10, 2) |
| actual\_weight | The physical weight of the parcel as measured by the Shipper | Numeric(10, 2) |
| billable\_weight | The highest of the dimensional weight and the actual weight | Numeric(10, 2) |
| base\_charges | Base charge for the parcel is calculated using billable weight and zone provided | Numeric(10, 2) |
| surcharge\_FUEL | Fuel surcharge | Numeric(10, 2) |
| surcharge\_DDAS | Delivery Area Surcharge. If the delivery address was in a postal code outside the standard delivery area. Leave blank if surcharge\_EDAS is applicable | Numeric(10, 2) |
| surcharge\_EDAS | Extended Delivery Area Surcharge. If the delivery address was in a postal code outside the ‘delivery area surcharge’ postal code range. Leave blank if surcharge\_DDAS is applicable | Numeric (10, 2) |
| surcharge\_NSCC | Non-Standard Cube Surcharge
For example: any package with L x W x H measuring more than 2 cubic feet (3456 cubic inch) would be shared a surcharge | Numeric (10, 2) |
| surcharge\_NSLC | Non-Standard Length Charge
Any package with longest side measuring more than 22 inches and not exceeding 48 inches | Numeric(10, 2) |
| surcharge\_ADDL | Additional Handling Surcharge
An Additional Handling Charge will apply for any packages that require special handling
Length > 48 Inches
Second Side > 30 inches
Weight > 70 lbs
Any article that is encased in an outside shipping container made of metal or wood
Any items such as a barrel, drum, pail or tire, or other cylindrical item that is not fully encased in a corrugated cardboard shipping container | Numeric(10, 2) |
| surcharge\_DDIM | Large Package/ Oversize Charge Surcharge
A Large Package / Oversize Charge will be applied when a package length plus girth (twice the width plus twice the height) combined exceeds 130 inches or any one dimension is greater than 72 inches
Subject to a minimum billable weight of 90 pounds
An Additional Handling charge will not be assessed when a Large Package/Oversize Charge is applied | Numeric(10, 2) |
| surcharge\_UAPK | Unauthorized Package Charge
- Packages with an actual weight of more than 150 pounds, or that exceed 108 inches in length, or exceed a total of 165 inches in length and girth (twice the width plus twice the height) combined, as measured to determine their billable weight, are not accepted for transportation
If found in the system, packages with these characteristics will be subject to an Unauthorized Package Charge | Numeric(10, 2) |
| surcharge\_UNDP | Undeliverable Surcharge
An additional surcharge fee will be charged in addition to the freight charges to return package to shipper | Numeric(10, 2) |
| surcharge\_DSUR | An additional charge per package will apply to any package shipped during a Demand Period | Numeric(10, 2) |
| surcharge\_ADCR | Address Correction Surcharge
If the actual address did not match the original address that was provided | Numeric(10, 2) |
| surcharge\_MISC | Miscellaneous other surcharges
Any additional Shipper charges not listed under above surcharge types should be summed up and entered into this column | Numeric(10, 2) |
| surcharge\_MISC\_description | Any miscellaneous surcharge amount will be accompanied with a description | String(100) |
| PICK | Pickup Charges
Any charges for picking up a parcel from a fulfillment center | Numeric(10, 2) |
| POD\_RQD | Charges for the Proof of Delivery service | Numeric(10, 2) |
| AD\_SIGN | Charges for the Areferdult Signature service | Numeric(10, 2) |
| prior\_invoice\_number | If invoice type is ADJUSTMENT, this column indicates the reference invoice number for the original invoice for the parcel | Numeric(10, 2) |
| adjustment\_reason\_code | Indicates the classification code of the adjustment made, if invoice type is **adjustment** | Numeric(10, 2) |
| credits | If the invoice type is **Claim** the credit amount will be listed under this column, and deducted from the total invoice amount | Numeric(10, 2) |
| total\_charges | Total Charges including all applicable surcharges | Numeric(10, 2) |
| shipFrom\_name | Details of the Sender | String(100) |
| shipFrom\_company | Company Name of the Sender | String(100) |
| shipFrom\_address1 | Address line 1 of the sender of the parcel | String(100) |
| shipFrom\_address2 | Address line 2 of the sender of the parcel | String(100) |
| shipFrom\_city | City of the sender of the parcel | String(100) |
| shipFrom\_state | State of the sender of the parcel | String(100) |
| shipFrom\_zip | Postal code of the sender of the parcel | String(20) |
| shipFrom\_country | Country of the sender of the parcel | String(100) |
| shipTo\_name | Details of the Receiver | String(100) |
| shipTo\_company | Company Name of the Receiver | String(100) |
| shipTo\_address1 | Address line 1 of the receiver of the parcel | String(100) |
| shipTo\_address2 | Address line 2 of the receiver of the parcel | String(100) |
| shipTo\_city | City of the receiver of the parcel | String(100) |
| shipTo\_state | State of the receiver of the parcel | String(100) |
| shipTO\_zip | Postal Code of the receiver of the parcel | String(100) |
| shipTo\_country | Country of the receiver of the parcel | String(100) |
| date\_of\_delivery | Date of Delivery | Timestamp(MM/DD/YYYY) |
| delivery\_location | Location of Delivery | String(100) |
The base rate, surcharge and service attribute charges are as per the contract with Orchestro