> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.chrt.com/prod/shippers/rate-sheets/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.chrt.com/_mcp/server. # Rate Sheets > Create and manage shipper rate sheets in chrt — ground, flights, and OBC — and how rate sheets drive line items on every order. A **rate sheet** is a reusable pricing template chrt applies to a shipment. Rate sheets carry per-mile, per-stop, and per-instance rates plus surcharges, and they cover one **service kind** — ground, flights, or on-board courier (OBC). When you place an order against a provider, the relevant rate sheet drives the line items that appear on the order's financials. ## Before you start * Rate sheets are owned by the org that creates them. A shipper rate sheet expresses the rates the shipper is willing to pay (or has agreed to pay) on shipments to or from a specific provider. * In most flows, the forwarder or courier you work with provides the rate sheet they want to bill against, and you accept it as part of your connection. Some shippers also maintain their own rate sheets for internal costing or for off-platform billing. ## 1. Open the rate sheets list Open [chrt.com/rate-sheets](https://chrt.com/rate-sheets). The page lists all rate sheets visible to your org, filterable by service kind (**Ground**, **Flights**, **OBC**). ## 2. Create a rate sheet 1. Click **Create rate sheet** and pick the service kind: * **Ground** for over-the-road shipments priced by distance. * **Flights** for air shipments priced by airline + service. * **OBC** for on-board courier hand-carry, priced as a day rate. 2. Give the rate sheet a clear **name** (e.g., "ACME → JFK ground", "Standard OBC day rate"). Add **comments** for context — the team that uses this sheet six months from now will thank you. 3. Fill in the fields that apply to your kind (see below). 4. Save. ### Ground rate sheet fields | Field | What it represents | | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | **Base mileage** | Distance in miles covered by the base rate, and the base rate itself. Shipments under the base threshold are billed at the flat base rate. | | **Additional mileage** | Per-mile rate above the base. | | **Long-distance surcharge** | Optional additional per-mile rate that kicks in after a configurable distance. | | **Fuel surcharge** | Per-mile fuel surcharge. | | **Wait time** | Free wait window (minutes) and the per-minute rate after that. | | **Extra stops** | Per-instance rate for stops beyond the standard pickup-and-deliver pair. | | **Attempts** | Per-instance rate for failed/repeat delivery attempts. | | **Pick-and-hold** | Per-instance rate for hold-at-location workflows. | | **Dangerous goods** | Per-instance surcharge for hazmat cargo. | | **After-hours, weekend, holiday** | Per-instance surcharges for off-hours work. | | **Cargo types / vehicle types** | Restricts which cargo and vehicle types the sheet applies to. | ### Flights rate sheet fields * **Airline name** — restricts the sheet to one airline if you need carrier-specific pricing. * **Service type name** — e.g., "Same day", "Next flight out". * **Quantity** — units sold (e.g., per-kilo, per-piece) depending on the service type. * **Rate** — USD per unit. ### OBC rate sheet fields * **Day rate USD** — the per-day price for hand-carry service. ## 3. Edit or archive a rate sheet Open a rate sheet from the list to see its detail page. From there you can: * **Edit** any field. Edits apply to future orders that reference the sheet — historical line items already generated against the old version don't change. * **Archive** the sheet to hide it from selection on new orders without deleting historical references. ## 4. How rate sheets drive line items When a shipment is assigned and a task group runs, chrt looks up the relevant rate sheet (by service kind, by org pairing, and by the rate-sheet ID you've attached at the order or task-group level). It then generates a **line item group** with one line per chargeable rule — base rate, additional mileage, fuel surcharge, wait time, surcharges. Each line shows quantity × rate = amount, plus a comment chrt fills in automatically (e.g., "Additional mileage: 49.74 miles @ \$1.75/mile"). You'll see these line items on the order page under the **Financials** tab and on statements in [Billing](/shippers/billing). > **Note** > > Forwarders typically maintain ground, flights, and OBC rate sheets for each > shipper they work with. As a shipper, you mostly review and accept what > your forwarder configures, but you can maintain your own rate sheets for > internal costing or for off-platform billing. ## How to know it worked * The new rate sheet appears in the [Rate sheets list](https://chrt.com/rate-sheets) under the right kind tab. * The rate sheet is selectable on the relevant draft order or task group. * When the order runs, the Financials tab shows line items derived from the sheet's fields. ## If something looks different * **You can't find the kind you need** — confirm you're on the right kind tab (**Ground**, **Flights**, **OBC**) above the list. * **Saved fields don't appear on the order** — make sure the rate sheet is attached to the task group. Rate sheets are matched by org pairing and service kind; if no match exists, no line items generate. * **Rates look wrong** — open the rate sheet's detail page and check the field values. Edits to the sheet only affect future orders, not historical line items. * Contact [hi@chrt.com](mailto:hi@chrt.com) if you have issues. ## Related guides * [Billing](/shippers/billing) — see line items and statements derived from rate sheets. * [Cargo types](/docs/concepts/cargo-types) — cargo type can restrict which rate sheets apply. * [Creating shipments](/shippers/creating-shipments) — where you assign a rate sheet to a task group. > Define the pricing chrt should apply to shipments, by service kind.