Open invoice

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.statements.openInvoiceV1("statement_id", {});
}
main();

{
  "schema_version": 1,
  "_id": "stmt_9f8b7c6d5e4a3b2c1d0e",
  "settlement_type": "stripe_connect",
  "owned_by_org_id": "org_7f6e5d4c3b2a1908",
  "payment_vector_type": "shipper_pay_forwarder",
  "line_item_group_ids": [
    "lig_123abc456def789ghi"
  ],
  "amount": 125000,
  "units": "usd_cents",
  "staged_by_user_id": "user_42a7f9d8c3e1b6a5",
  "payment_origin_org_id": "org_1a2b3c4d5e6f7g8h",
  "payment_origin_off_chrt_shipper_org_id": "offchrt_shipper_001",
  "payment_destination_org_id": "org_9h8g7f6e5d4c3b2a",
  "payment_destination_driver_id": "driver_5d4c3b2a1f0e9d8c",
  "status": "staged",
  "stripe_invoice_id": "in_1J2K3L4M5N6O7P8Q9R",
  "stripe_invoice_url": "https://dashboard.stripe.com/invoices/in_1J2K3L4M5N6O7P8Q9R",
  "stripe_invoice_created_by_user_id": "user_42a7f9d8c3e1b6a5",
  "stripe_invoice_status": "draft",
  "staged_at_timestamp": "2024-01-15T09:30:00Z",
  "opened_at_timestamp": "2024-01-15T10:00:00Z",
  "paid_at_timestamp": "2024-01-20T15:45:00Z",
  "uncollectible_at_timestamp": "2024-02-01T12:00:00Z",
  "marked_open_by_user_id": "user_7b8c9d0e1f2a3b4c",
  "marked_paid_by_user_id": "user_8c9d0e1f2a3b4c5d",
  "marked_uncollectible_by_user_id": "user_9d0e1f2a3b4c5d6e"
}

Opens a Stripe Connect invoice for a statement and attempt to send via email. Org must have a Stripe Connect account. | authz: org_type=[courier, forwarder], min_org_role=operator, authz_personas=[statement_owner_operators], statement_status=STAGED, line_item_groups_status=FINALIZED | (OpenInvoiceReq) -> (Statement1)

Authentication

AuthorizationBearer

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

Path parameters

statement_idstringRequired

Request

This endpoint expects an object.

days_until_dueintegerOptionalDefaults to 30

Days until invoice is due

descriptionstringOptionalDefaults to Delivery Statement

Description for the invoice

Response

Successful Response

schema_versioninteger

_idstring

settlement_typeenum

Allowed values:

owned_by_org_idstring

Must be a string starting with org_

payment_vector_typeenum

Allowed values:

line_item_group_idslist of strings or null

amountinteger or null

unitsenum or null

Allowed values:

staged_by_user_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

Allowed values:

stripe_invoice_idstring or null

stripe_invoice_urlstring or null

stripe_invoice_created_by_user_idstring or null

stripe_invoice_statusenum or null

staged_at_timestampstring or nullformat: "date-time"

opened_at_timestampstring or nullformat: "date-time"

paid_at_timestampstring or nullformat: "date-time"

uncollectible_at_timestampstring or nullformat: "date-time"

marked_open_by_user_idstring or null

marked_paid_by_user_idstring or null

marked_uncollectible_by_user_idstring or null

Authentication

Path parameters

Request

Response

Errors