Add line item to ad-hoc LIG

import { ChrtClient, ChrtEnvironment } from "@chrt-inc/typescript-sdk";
async function main() {
    const client = new ChrtClient({
        environment: ChrtEnvironment.Local,
        token: "YOUR_TOKEN_HERE",
    });
    await client.billing.lineItemGroups.adHoc.addLineItemV1("line_item_group_id", {
        item: "base_rate",
        quantity: 3.5,
        rate: 150.75,
    });
}
main();

{
  "schema_version": 1,
  "_id": "lig_9f8b7c6d5e4a3b2c1d0e",
  "line_items": [
    {
      "item": "base_rate",
      "quantity": 3.5,
      "rate": 150.75,
      "amount": 527.63,
      "schema_version": 1,
      "units": "usd",
      "comments": "Initial base rate for shipment",
      "adjustment": 0,
      "adjustment_comments": "No adjustments applied",
      "created_at_timestamp": "2024-04-20T14:45:00Z",
      "uuid_str": "uuid_123e4567-e89b-12d3-a456-426614174000"
    }
  ],
  "owned_by_org_id": "org_forwarder_001",
  "payment_vector_type": "shipper_pay_forwarder",
  "settlement_type": "stripe_connect",
  "task_group_id": "null",
  "rate_sheet_id": "rs_4a3b2c1d0e9f8b7c6d5e",
  "line_item_group_s3_object_metadata_ids": [
    "s3obj_20240420_001"
  ],
  "statement_id": "stmt_20240420_001",
  "payment_origin_org_id": "org_shipper_123",
  "payment_origin_off_chrt_shipper_org_id": "offchrt_shipper_456",
  "payment_destination_org_id": "org_forwarder_001",
  "payment_destination_driver_id": "driver_789",
  "status": "staged",
  "messages": [
    {
      "message": "Line item added successfully",
      "user_id": "user_abc123",
      "org_id": "org_forwarder_001",
      "timestamp": "2024-04-20T14:46:00Z"
    }
  ]
}

Adds a line item to an ad-hoc line item group. LIG must be ad-hoc (task_group_id is None) and ADJUSTABLE. | org_type=[courier, forwarder], min_org_role=operator, authz_personas=[lig_owner_operators] | (LineItemClientCreate1) -> (LineItemGroup1)

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

line_item_group_idstringRequired

Request

This endpoint expects an object.

itemenumRequired

quantitydoubleRequired

ratedoubleRequired

schema_versionintegerOptionalDefaults to 1

unitsenumOptional

Allowed values:

commentsstring or nullOptional

adjustmentdouble or nullOptional

adjustment_commentsstring or nullOptional

Response

Successful Response

schema_versioninteger

_idstring

line_itemslist of objects

owned_by_org_idstring

Must be a string starting with org_

payment_vector_typeenum

Allowed values:

settlement_typeenum

Allowed values:

task_group_idstring or null

rate_sheet_idstring or null

line_item_group_s3_object_metadata_idslist of strings or null

statement_idstring or null

payment_origin_org_idstring or null

payment_origin_off_chrt_shipper_org_idstring or null

payment_destination_org_idstring or null

payment_destination_driver_idstring or null

statusenum or null

messageslist of objects or null

Authentication

Path parameters

Request

Response

Errors