---
title: "Resolve"
method: POST
path: "/billing_new/chrt_ground_provider_rates/resolve/v1"
tags: ["/billing_new"]
---

# Resolve

`POST /billing_new/chrt_ground_provider_rates/resolve/v1`

Returns accounts-payable and accounts-receivable CHRT-ground provider-rate candidates for each eligible TaskGroup. AP candidates target a distinct executor, or the assigned driver when the coordinator is also the executor; AR candidates target the shipper. | authz: allowed_org_types=[provider], min_org_role=operator | authz_personas=[coordinator_org_operators] | (ResolveChrtGroundProviderRatesReq) -> (list[ResolvedTaskGroupChrtGroundProviderRates1])

## Request body

- ResolveChrtGroundProviderRatesReq
  - `order_id` string, required

## Response `200`

Successful Response

- ResolvedTaskGroupChrtGroundProviderRates1[]
  - `task_group` TaskGroup1, required
    - `schema_version` 1, required
    - `_id` string, required
    - `order_id` string, required
    - `order_short_id` string, required
    - `order_off_chrt_reference_id` string, nullable — Must be a URL-safe string of 1-64 characters. Allowed characters: A-Z, a-z, 0-9, '.', '_', '~', '-' (RFC 3986 unreserved).
    - `task_ids` string[]
    - `created_by_user_id` string, nullable — Must be a string starting with `user_`
    - `created_by_org_id` string, required — Must be a string starting with `org_`
    - `shipper_org_id` string, nullable — Must be a string starting with `org_`
    - `off_chrt_shipper_org_data_id` string, nullable
    - `coordinator_org_id` string, nullable — Must be a string starting with `org_`
    - `executor_org_id` string, nullable — Must be a string starting with `org_`
    - `off_chrt_executor_org_data_id` string, nullable
    - `driver_id` string, nullable
    - `task_group_s3_object_metadata_ids` string[]
    - `status` 'draft' | 'staged' | 'in_progress' | 'completed' | 'skipped' | 'cancelled' | 'exception'
    - `draft_started_at_timestamp` string, date-time, required
    - `staged_at_timestamp` string, date-time, nullable
    - `in_progress_at_timestamp` string, date-time, nullable
    - `completed_at_timestamp` string, date-time, nullable
    - `skipped_at_timestamp` string, date-time, nullable
    - `cancelled_at_timestamp` string, date-time, nullable
    - `exception_at_timestamp` string, date-time, nullable
    - `task_group_type` 'chrt_ground_provider' | 'cargo_on_flight' | 'onboard_courier', required
    - `vehicle_type` 'sedan' | 'suv' | 'cargo_van' | 'box_truck' | 'flatbed' | 'semi_truck' | 'airplane'
    - `coordinator_setup_notes` string, nullable
    - `flight_setup_notes` string, nullable
    - `mileage_estimated` number, nullable
    - `wait_time_total_minutes` number, nullable
    - `flight_leg_ids` string[]
    - `messages` TaskGroupMessage1[]
      - `message` string, required
      - `user_id` string, required — Must be a string starting with `user_`
      - `org_id` string, required — Must be a string starting with `org_`
      - `timestamp` string, date-time, required
  - `accounts_payable_rate_sheets` ChrtGroundProviderRates1[]
    - `schema_version` 1, required
    - `archived` boolean
    - `name` string, nullable
    - `comments` string, nullable
    - `invoice_type` 'accounts_receivable' | 'accounts_payable', required
    - `from_payables` FromPayables1
      - `sage_item_id` string, nullable
      - `markup` number, nullable
      - `margin` number, nullable
      - `combine` boolean
    - `currency_code` 'USD' | 'CAD' | 'EUR' | 'GBP' | 'MXN' | 'AUD' | 'JPY' | 'CNY' | 'CHF' | 'INR' | 'XXX', required
    - `service_line` 'on_demand' | 'routed'
    - `counterparty_org_id` string, nullable — Must be a string starting with `org_`
    - `counterparty_off_chrt_org_data_id` string, nullable
    - `counterparty_driver_id` string, nullable
    - `shipper_account_id` string, nullable
    - `vehicle_types` VehicleTypeEnum[]
    - `cargo_types` CargoTypeEnum1[]
    - `flat_fee` FlatFeeRate1
      - `sage_item_id` string, nullable
      - `rate_per_instance` number, required
    - `base_mileage` BaseMileageRate1
      - `sage_item_id` string, nullable
      - `included_distance_miles` number, required
      - `rate_per_instance` number, required
    - `additional_mileage` AdditionalMileageRate1
      - `sage_item_id` string, nullable
      - `starts_at_total_distance_miles` number, required
      - `ends_at_total_distance_miles` number, required
      - `rate_per_mile` number, required
    - `long_distance_surcharge` LongDistanceSurchargeRate1
      - `sage_item_id` string, nullable
      - `starts_at_total_distance_miles` number, required
      - `rate_per_mile` number, required
    - `fuel_surcharge` FuelSurchargeRate1
      - `sage_item_id` string, nullable
      - `rate_per_mile` number, required
    - `wait_time` WaitTimeRate1
      - `sage_item_id` string, nullable
      - `included_minutes` number, required
      - `rate_per_minute` number, required
    - `extra_stop` ExtraStopRate1
      - `sage_item_id` string, nullable
      - `rate_per_instance` number, required
    - `attempt` AttemptRate1
      - `sage_item_id` string, nullable
      - `rate_per_instance` number, required
    - `pick_and_hold` PickAndHoldRate1
      - `sage_item_id` string, nullable
      - `rate_per_instance` number, required
    - `dangerous_goods` DangerousGoodsRate1
      - `sage_item_id` string, nullable
      - `rate_per_instance` number, required
    - `after_hours` AfterHoursRate1
      - `sage_item_id` string, nullable
      - `rate_per_instance` number, required
    - `weekend` WeekendRate1
      - `sage_item_id` string, nullable
      - `rate_per_instance` number, required
    - `holiday` HolidayRate1
      - `sage_item_id` string, nullable
      - `rate_per_instance` number, required
    - `tax_1` TaxRate1
      - `sage_item_id` string, nullable
      - `name` string, required
      - `note` string, nullable
      - `percentage` number, required
    - `tax_2` TaxRate1
      - `sage_item_id` string, nullable
      - `name` string, required
      - `note` string, nullable
      - `percentage` number, required
    - `tax_3` TaxRate1
      - `sage_item_id` string, nullable
      - `name` string, required
      - `note` string, nullable
      - `percentage` number, required
    - `_id` string, required
    - `owned_by_org_id` string, required — Must be a string starting with `org_`
    - `created_at_timestamp` string, date-time, required
    - `updated_at_timestamp` string, date-time, required
  - `accounts_receivable_rate_sheets` ChrtGroundProviderRates1[]
    - `schema_version` 1, required
    - `archived` boolean
    - `name` string, nullable
    - `comments` string, nullable
    - `invoice_type` 'accounts_receivable' | 'accounts_payable', required
    - `from_payables` FromPayables1
      - `sage_item_id` string, nullable
      - `markup` number, nullable
      - `margin` number, nullable
      - `combine` boolean
    - `currency_code` 'USD' | 'CAD' | 'EUR' | 'GBP' | 'MXN' | 'AUD' | 'JPY' | 'CNY' | 'CHF' | 'INR' | 'XXX', required
    - `service_line` 'on_demand' | 'routed'
    - `counterparty_org_id` string, nullable — Must be a string starting with `org_`
    - `counterparty_off_chrt_org_data_id` string, nullable
    - `counterparty_driver_id` string, nullable
    - `shipper_account_id` string, nullable
    - `vehicle_types` VehicleTypeEnum[]
    - `cargo_types` CargoTypeEnum1[]
    - `flat_fee` FlatFeeRate1
      - `sage_item_id` string, nullable
      - `rate_per_instance` number, required
    - `base_mileage` BaseMileageRate1
      - `sage_item_id` string, nullable
      - `included_distance_miles` number, required
      - `rate_per_instance` number, required
    - `additional_mileage` AdditionalMileageRate1
      - `sage_item_id` string, nullable
      - `starts_at_total_distance_miles` number, required
      - `ends_at_total_distance_miles` number, required
      - `rate_per_mile` number, required
    - `long_distance_surcharge` LongDistanceSurchargeRate1
      - `sage_item_id` string, nullable
      - `starts_at_total_distance_miles` number, required
      - `rate_per_mile` number, required
    - `fuel_surcharge` FuelSurchargeRate1
      - `sage_item_id` string, nullable
      - `rate_per_mile` number, required
    - `wait_time` WaitTimeRate1
      - `sage_item_id` string, nullable
      - `included_minutes` number, required
      - `rate_per_minute` number, required
    - `extra_stop` ExtraStopRate1
      - `sage_item_id` string, nullable
      - `rate_per_instance` number, required
    - `attempt` AttemptRate1
      - `sage_item_id` string, nullable
      - `rate_per_instance` number, required
    - `pick_and_hold` PickAndHoldRate1
      - `sage_item_id` string, nullable
      - `rate_per_instance` number, required
    - `dangerous_goods` DangerousGoodsRate1
      - `sage_item_id` string, nullable
      - `rate_per_instance` number, required
    - `after_hours` AfterHoursRate1
      - `sage_item_id` string, nullable
      - `rate_per_instance` number, required
    - `weekend` WeekendRate1
      - `sage_item_id` string, nullable
      - `rate_per_instance` number, required
    - `holiday` HolidayRate1
      - `sage_item_id` string, nullable
      - `rate_per_instance` number, required
    - `tax_1` TaxRate1
      - `sage_item_id` string, nullable
      - `name` string, required
      - `note` string, nullable
      - `percentage` number, required
    - `tax_2` TaxRate1
      - `sage_item_id` string, nullable
      - `name` string, required
      - `note` string, nullable
      - `percentage` number, required
    - `tax_3` TaxRate1
      - `sage_item_id` string, nullable
      - `name` string, required
      - `note` string, nullable
      - `percentage` number, required
    - `_id` string, required
    - `owned_by_org_id` string, required — Must be a string starting with `org_`
    - `created_at_timestamp` string, date-time, required
    - `updated_at_timestamp` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) · [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chrt/chrt-fastapi/revisions/ea04e157edb3/schema)
