@hardfin/cli 0.1.1-dev.64 → 0.1.1-dev.65

package/dist/{program-Bok0tZ8p.js → program-Dn5_vLMu.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="0c1ab267-116d-5cf2-b055-693453f0e766")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="d0ee2ed5-ee69-52ea-a9b8-71f6c3047c1a")}catch(e){}}();
 import { a as defineCommand, i as GLOBAL_FLAGS, r as ExitCode, t as toInvocation } from "./scrub-BZ0egWxC.js";
 import { n as toAnswer$1, r as toCompletion, t as PATH_VALUES } from "./completion-tree-DLC6ARLR.js";
 import { createRequire } from "node:module";
@@ -258,7 +258,7 @@ function toRelease(of) {
 //#endregion
 //#region src/config/settings.ts
 /** The API version this build was written against, sent on every request. */
-const API_VERSION = "2026-10-17";
+const API_VERSION = "2026-10-21";
 /** The file a local build reads its overrides from, in the working directory. */
 const CONFIG_FILE = "config.local.json";
 const DEFAULT_API_URL = "https://api.hardfin.com/v2";
@@ -1503,6 +1503,8 @@ function toDescribed(flag) {
 		elementTypes: sent.elementTypes,
 		elementLists: sent.elementLists,
 		elementMoney: sent.elementMoney,
+		elementEnums: sent.elementEnums,
+		elementPatterns: sent.elementPatterns,
 		together: sent.together
 	};
 	return Object.fromEntries(Object.entries(described).filter(([, value]) => value !== void 0 && value !== false));
@@ -1962,7 +1964,9 @@ function toElements(flag, values) {
 			const typed = isJSON ? toJSONValue(value, types ?? ["string"]) : toTyped(value, types);
 			if (typed === NOT_TAKEN && types?.some((type) => type === "object" || type === "array")) return /* @__PURE__ */ new Error(`--${flag.name} cannot carry ${key}, which holds more than one value. Send the request body with --input instead`);
 			if (typed === NOT_TAKEN) return /* @__PURE__ */ new Error(`--${flag.name} needs ${toNamedTypes(types ?? ["string"])} for ${key}, and ${value || "nothing"} is not one`);
-			set(element, key.split("."), typed);
+			const checked = toCheckedElementField(flag, key, typed);
+			if (checked instanceof Error) return checked;
+			set(element, key.split("."), checked);
 		}
 		for (const field of flag.elementMoney ?? []) {
 			const money = element[field];
@@ -1972,6 +1976,18 @@ function toElements(flag, values) {
 	}
 	return elements;
 }
+/**
+* toCheckedElementField holds one field of an element to the values or pattern the document
+* gives it. A listed value goes out in the document's spelling, whatever case it was typed in.
+*/
+function toCheckedElementField(flag, key, value) {
+	if (typeof value !== "string") return value;
+	const values = flag.elementEnums?.[key];
+	if (values) return values.find((allowed) => allowed.toLowerCase() === value.toLowerCase()) ?? /* @__PURE__ */ new Error(`--${flag.name} needs one of ${values.join(", ")} for ${key}, and ${value || "nothing"} is not one`);
+	const pattern = flag.elementPatterns?.[key];
+	if (pattern && !new RegExp(pattern).test(value)) return /* @__PURE__ */ new Error(`--${flag.name} does not accept ${JSON.stringify(value)} for ${key}`);
+	return value;
+}
 /** Marks text that is none of the types a field takes. */
 const NOT_TAKEN = Symbol("not taken");
 /**
@@ -3135,7 +3151,7 @@ function toFiles(directory) {
 //#endregion
 //#region src/command/types.generated.ts
 /** API_TYPES is the TypeScript hardfin types prints. */
-const API_TYPES = "// Types for the Hardfin API, version 2026-10-17, generated from its published document.\n// Regenerate them with hardfin types after upgrading the CLI.\n\n/** ApiError is one entry in a response's errors. */\nexport interface ApiError {\n    error: string;\n    statusCode: number;\n}\n\n/** ApiEnvelope is the shape every response takes, with the record or records in data. */\nexport interface ApiEnvelope<T> {\n    data: T;\n    metadata: {\n        errors?: ApiError[] | null;\n        requestId?: string;\n        requestTime?: string;\n        statusCode?: number;\n        pagination?: unknown;\n    };\n}\n\n/** Accepted in any case, and also as t, f, 1, 0, or 2 for all. The listed spelling is the one the API sends back. */\nexport type ArchivedState = \"all\" | \"false\" | \"true\";\n\nexport type Asset = SparseAsset & AssetLocationData & {\n    /** The asset's cost basis, depreciation, and accounting history. */\n    accounting?: AssetAccountingDetails;\n    /** The asset's recent events, such as shipments and deliveries. */\n    activity?: AssetEvent[];\n    /** A free-form description of the asset. */\n    description?: string | null;\n    /** The number of files attached to the asset. */\n    fileCount?: number;\n    /** The day the asset entered inventory. */\n    inInventoryDate?: string;\n    /** The asset's value for each custom field its item defines. */\n    metadata?: AssetMetadataFieldWrapper[];\n    /** Who owns the asset now. */\n    ownership?: AssetOwnership;\n    /** The project the asset is assigned to, or null when it is unassigned. */\n    project?: SparseProject | null;\n    /** How and when the asset was scrapped, or null when it has not been. */\n    scrappedContext?: AssetScrappedContext | null;\n    /** The number of tickets about the asset. */\n    ticketCount?: number;\n    /** The number of links attached to the asset. */\n    urlLinkCount?: number;\n};\n\nexport interface AssetAccountingDetails {\n    /** The asset's inventory cost basis, before deployment costs, which is what inventory is relieved by when the asset leaves it. */\n    acquisitionCogs?: string | null;\n    /** The asset's share of overhead. */\n    allocatedIndirect?: string | null;\n    /** The problems that keep the asset's accounting from being computed, such as a missing cost basis. */\n    assetExceptions?: AssetExceptionType[];\n    /** The parts cost. */\n    billOfMaterials?: string | null;\n    /** The cost basis on the books now, the acquisition basis in inventory and the deployed basis once the asset is a fixed asset. */\n    capitalizedCosts?: string | null;\n    /** The capitalizations and impairments made to the asset's cost after it was acquired. */\n    costAdjustments?: AssetCostAdjustment[];\n    /** The ISO 4217 code every cost amount on the asset is denominated in. */\n    costCurrencyCode?: CurrencyCode;\n    /** The method the asset is depreciated by. */\n    depreciationModel?: Depreciation;\n    /** The asset's book value month by month, from its inventory month, or null while it has an accounting exception. */\n    depreciationPeriods?: AssetDepreciationChartPeriod[] | null;\n    /** The labor cost to build the asset. */\n    directLabor?: string | null;\n    /** The shipping cost to receive the asset. */\n    freightInbound?: string | null;\n    /** The shipping cost to deploy the asset, a deployment cost. */\n    freightOutbound?: string | null;\n    /** The day the asset was put into service and began depreciating. */\n    inServiceDate?: string | null;\n    /** The cost to install the asset, a deployment cost. */\n    installation?: string | null;\n    /** The financing cost of the asset. */\n    interest?: string | null;\n    /** Whether the asset's cost currency can no longer be changed. */\n    isCostCurrencyLocked?: boolean;\n    /** Whether Hardfin sets the in-service date itself rather than keeping one a person entered. */\n    isInServiceDateManagedAutomatically?: boolean;\n    /** The value the asset keeps at the end of its useful life. */\n    salvageValue?: string | null;\n    /** A single cost entered in place of the cost components. */\n    simpleCostBasis?: string | null;\n    /** The import duty paid on the asset. */\n    tariffs?: string | null;\n    /** The tax paid on the asset. */\n    tax?: string | null;\n    /** The deployed cost basis, including deployment costs, which is what is capitalized once the asset is put into service. */\n    totalPotentialCOGS?: string | null;\n    /** The number of months the asset is depreciated over. */\n    usefulLife?: number | null;\n    /** The changes made to the asset's useful life. */\n    usefulLifeRevisions?: AssetUsefulLifeRevision[];\n}\n\nexport interface AssetCostAdjustment {\n    /** CAPITALIZATION to add to the cost basis, or IMPAIRMENT to write it down. */\n    adjustmentType?: CostAdjustmentType;\n    /** The size of the adjustment. */\n    amount?: string;\n    /** When the adjustment was recorded. */\n    createdAt?: string;\n    /** The person who recorded the adjustment. */\n    createdBy?: SparsePerson;\n    /** The day the adjustment takes effect. */\n    effectiveDate?: string;\n    /** The cost adjustment's key. */\n    key?: string;\n    /** Free-form detail about the adjustment. */\n    notes?: string | null;\n    /** Why the cost changed. */\n    reason?: CostAdjustmentReason;\n}\n\nexport interface AssetDepreciationChartPeriod {\n    /** The depreciation charged from the in-service date through the end of the period. */\n    accumulated?: string;\n    /** The asset's value on the books at the end of the period. */\n    bookValue?: string;\n    /** The last day of the month the period covers. */\n    date?: string;\n    /** The depreciation charged in the period. */\n    depreciation?: string;\n}\n\nexport interface AssetEvent {\n    /** When the event was recorded. */\n    createdAt?: string;\n    /** The IANA time zone the event's times were entered in. */\n    eventTimezone?: string;\n    /** When the event is expected to happen, or null when no one has said. */\n    expectedAt?: string | null;\n    /** The event's unique identifier. */\n    id?: string;\n    /** Whether the event has to happen for its group to complete. */\n    isRequired?: boolean;\n    /** When the event happened, or null while it has not. */\n    occurredAt?: string | null;\n    /** The day the event was promised to a customer, or null when none was. */\n    promiseDate?: string | null;\n    /** The event's values a person set, such as carrier tracking. */\n    properties?: AssetEventProperty[];\n    /** The event's position within its group. */\n    sequence?: number;\n    /** When someone marked the event as happened in Hardfin, or null while it has not happened. */\n    triggeredAt?: string | null;\n    /** What kind of event this is. */\n    type?: AssetEventType;\n}\n\nexport interface AssetEventConfiguration {\n    /** The properties an event of the type carries. */\n    properties?: AssetEventProperty[];\n    /** The kind of event the configuration describes. */\n    type?: AssetEventType;\n}\n\nexport interface AssetEventGroup {\n    /** The kind of group this is, and the events it carries. */\n    configuration?: AssetEventGroupConfiguration;\n    /** Where the movement ends, or null when the group does not move the asset. */\n    destination?: SparseLocationWithParent | null;\n    /** The events the group has recorded so far. */\n    events?: AssetEvent[];\n    /** The event group's unique identifier. */\n    id?: string;\n    /** The event group's key, which the event group endpoints take as eventGroupKey. */\n    key?: string;\n    /** Where the movement started, or null when the group does not move the asset. */\n    origin?: SparseLocationWithParent | null;\n    /** The shipment the movement travels on, or null when it travels on none. */\n    shipment?: SparseShipment | null;\n}\n\nexport interface AssetEventGroupConfiguration {\n    /** The events a group of the kind carries, in the order they happen. */\n    events?: AssetEventConfiguration[];\n    /** The configuration's unique identifier. */\n    id?: string;\n    /** The configuration's key. */\n    key?: string;\n    /** What the configuration is called, such as ship and deliver. */\n    name?: string;\n}\n\nexport interface AssetEventProperty {\n    /** The event property's unique identifier. */\n    id?: string;\n    /** Whether Hardfin sets the property itself rather than a person, which responses leave out. */\n    isSystemProperty?: boolean;\n    /** The property's display name. */\n    label?: string;\n    /** The kind of value the property holds, such as CARRIER_TRACKING or CACHED_LOCATION. */\n    type?: string;\n    /** The property's value, whose JSON shape depends on the property's type. */\n    value?: unknown[] | boolean | number | Record<string, unknown> | string | null;\n}\n\nexport interface AssetEventType {\n    /** The event type's unique identifier. */\n    id?: string;\n    /** The event type's name, such as Ship or Deliver. */\n    name?: string;\n    /** Whether an event of this type only happens as part of a group, such as a shipment. */\n    requiresEventGroup?: boolean;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type AssetExceptionType = \"DEPLOYMENT_WITHOUT_ACQUISITION\" | \"DISPOSAL_DATE_BEFORE_INVENTORY\" | \"FIRST_ASSIGNMENT_BEFORE_INVENTORY\" | \"FIRST_MOVEMENT_BEFORE_INVENTORY\" | \"FIRST_SALE_DATE_BEFORE_INVENTORY\" | \"IN_SERVICE_DATE_BEFORE_INVENTORY\" | \"MISSING_COST_BASIS\" | \"MISSING_USEFUL_LIFE\" | \"SALVAGE_EXCEEDS_50_PERCENT\" | \"UNKNOWN\";\n\nexport interface AssetFile {\n    /** The file's unique identifier. */\n    id?: string;\n    /** Whether the file is readable with any organization's API key. */\n    isPublic?: boolean;\n    /** The file's key, which the file endpoints take as fileKey. */\n    key?: string;\n    /** The file's media type, or an empty string when the upload named none. */\n    mimeType?: string;\n    /** The name the file had when it was uploaded. */\n    name?: string;\n    /** The file's size in bytes. */\n    size?: number;\n    /** The file type the file was uploaded as. */\n    type?: string;\n    /** When the file was uploaded. */\n    uploadedAt?: string;\n}\n\n/** Whether an asset works, is broken, awaits review, or has been scrapped. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type AssetFunctionalStatus = \"FUNCTIONAL\" | \"NEEDS_REVIEW\" | \"NON-FUNCTIONAL\" | \"SCRAPPED\";\n\nexport interface AssetFunctionalStatusHistoryItem {\n    /** When the asset left the status, or null while it still holds it. */\n    end?: string | null;\n    /** When the asset took the status. */\n    start?: string;\n    /** Whether the asset worked, was broken, awaited review, or had been scrapped through the period. */\n    status?: AssetFunctionalStatus;\n}\n\nexport interface AssetListing {\n    /** The page of records. */\n    results?: Asset[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\nexport interface AssetLocationData {\n    /** Where the asset is, or null while it is in transit. */\n    currentLocation?: SparseLocationWithParent | null;\n    /** Whether the asset has shipped and not yet been delivered. */\n    inTransit?: boolean;\n    /** Where a planned or in-progress move takes the asset, or null when none is planned. */\n    nextLocation?: SparseLocationWithParent | null;\n    /** The location the asset was at before its current one, or null when it has not moved. */\n    previousLocation?: SparseLocationWithParent | null;\n}\n\nexport interface AssetMetadataField {\n    /** The item field's unique identifier. */\n    id?: string;\n    /** The item field's key. */\n    key?: string;\n    /** The field's display name. */\n    label?: string;\n    /** The field's position within its section, starting at 0. */\n    order?: number;\n    /** The group the field is shown in, starting at 0. */\n    section?: number;\n    /** The kind of value the field holds, which decides the JSON type of its value. */\n    type?: ItemFieldType;\n}\n\nexport type AssetMetadataFieldWrapper = {\n    field?: {\n        type?: \"BOOLEAN\";\n    };\n    value?: boolean | null;\n} | {\n    field?: {\n        type?: \"DATE\";\n    };\n    value?: string | null;\n} | {\n    field?: {\n        type?: \"DATE_TIME\";\n    };\n    value?: string | null;\n} | {\n    field?: {\n        type?: \"INTEGER\";\n    };\n    value?: number | null;\n} | {\n    field?: {\n        type?: \"MULTILINE_TEXT\";\n    };\n    value?: string | null;\n} | {\n    field?: {\n        type?: \"NUMBER\";\n    };\n    value?: number | null;\n} | {\n    field?: {\n        type?: \"TEXT\";\n    };\n    value?: string | null;\n} | {\n    field?: {\n        type?: \"TIME\";\n    };\n    value?: string | null;\n};\n\nexport interface AssetMoveToPlan {\n    /** The ID of the asset to move. */\n    assetId: string;\n    /** When the asset reaches its destination, or null when the move only ships. */\n    deliverAt?: string | null;\n    /** The client's own name for the move, which the plan echoes back beside its answer. */\n    id: string;\n    /** When the asset leaves its origin, or null when the move only delivers. */\n    shipAt?: string | null;\n}\n\nexport interface AssetOwnership {\n    /** The customer that owns the asset, or null when your organization owns it. */\n    customer?: SparseCustomer | null;\n    /** The day the asset's current owner took ownership, or null when its ownership has never changed. */\n    ownershipChangeDate?: string | null;\n}\n\nexport interface AssetOwnershipHistoryItem {\n    /** When the segment was recorded. */\n    createdAt?: string;\n    /** The customer that owned the asset during the segment, or null when your organization did. */\n    customer?: SparseCustomer | null;\n    /** The day the segment's owner took ownership. */\n    date?: string;\n    /** The ownership segment's unique identifier. */\n    id?: string;\n    /** The ownership segment's key, which the segment endpoints take as segmentKey. */\n    key?: string;\n    /** When the segment was last changed. */\n    lastModifiedAt?: string;\n    /** What the owner paid for the asset, or null when no price was recorded. */\n    salePrice?: Currency | null;\n}\n\nexport interface AssetPlannedIntersection {\n    /** The ID of the event group the move would collide with, or null when none names one. */\n    aegId?: string | null;\n    /** The key of the event group the move would collide with, or null when none names one. */\n    aegKey?: string | null;\n    /** When the colliding movement ends, or null while it has no end. */\n    end?: string | null;\n    /** When the colliding movement starts. */\n    start?: string;\n}\n\nexport interface AssetPlannedMove {\n    /** The client's own name for the move, echoed from the plan it asked about. */\n    id?: string;\n    /** The movement the move would collide with, or null when it collides with none. */\n    intersection?: AssetPlannedIntersection | null;\n    /** Whether the move can be carried out as asked. */\n    isValid?: boolean;\n}\n\n/** A project assignment the asset list filters by. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type AssetProjectStatusFilter = \"ACTIVE\" | \"NONE\" | \"PAST\" | \"UPCOMING\";\n\nexport interface AssetProposedMultiMove {\n    /** The ID of the asset to move. */\n    assetId: string;\n    /** When the asset reaches its destination, and one of shipAt or deliverAt is required. */\n    deliverAt?: string | null;\n    /** The IANA time zone name the delivery time was entered in, such as America/Denver; when omitted, the delivery time's clock time is read in the organization's time zone. */\n    deliverAtTimezone?: string | null;\n    /** The ID of the location the asset arrives at. */\n    destinationId: string;\n    /** The ID of the location the asset leaves. */\n    originId: string;\n    /** When the asset leaves its origin, and one of shipAt or deliverAt is required. */\n    shipAt?: string | null;\n    /** The IANA time zone name the ship time was entered in, such as America/Denver; when omitted, the ship time's clock time is read in the organization's time zone. */\n    shipAtTimezone?: string | null;\n}\n\nexport interface AssetScrappedContext {\n    /** The day the asset was scrapped. */\n    disposalDate?: string;\n    /** What the scrapped asset was sold for, or null when it was not sold. */\n    disposalPrice?: Currency | null;\n    /** Why the asset was scrapped. */\n    disposalReason?: string | null;\n}\n\nexport interface AssetShippingData {\n    /** When Hardfin recorded the update. */\n    createdAt?: string;\n    /** The tracking update's unique identifier. */\n    id?: string;\n    /** The tracking update's key. */\n    key?: string;\n    /** Where the carrier reported the shipment, or null when it reported nowhere. */\n    location?: AssetShippingDataLocation | null;\n    /** When the carrier says the update happened. */\n    reportedAt?: string;\n    /** The carrier's status for the shipment at that point. */\n    status?: string;\n    /** What the carrier wrote about the update. */\n    statusText?: string;\n    /** The carrier's finer status, or null when it reported none. */\n    substatus?: string | null;\n    /** When Hardfin last changed the update. */\n    updatedAt?: string;\n}\n\nexport interface AssetShippingDataListing {\n    /** Who carries the shipment, or null when no carrier is named. */\n    carrier?: Carrier | null;\n    /** When the carrier now expects to deliver, or null when it says nothing. */\n    eta?: string | null;\n    /** When the carrier first expected to deliver, or null when it said nothing. */\n    originalEta?: string | null;\n    /** The carrier's name when it is one Hardfin does not track itself, or null. */\n    otherName?: string | null;\n    /** The carrier's service the shipment travels on, or null when it names none. */\n    serviceLevelName?: string | null;\n    /** What the carrier has reported, newest first. */\n    shippingHistory?: AssetShippingData[];\n    /** The number the carrier tracks the shipment by, or null when it has none. */\n    trackingNumber?: string | null;\n}\n\nexport interface AssetShippingDataLocation {\n    /** The city the carrier reported. */\n    city?: string;\n    /** The country the carrier reported. */\n    country?: string;\n    /** The state or region the carrier reported. */\n    state?: string;\n    /** The postal code the carrier reported. */\n    zip?: string;\n}\n\nexport interface AssetUpdateMetadataItem {\n    /** The ID of the item field to set on the asset. */\n    fieldId: string;\n    /** The field's new value, in the JSON type the field's type calls for, or null to clear it. */\n    value?: unknown[] | boolean | number | Record<string, unknown> | string | null;\n}\n\nexport interface AssetUsefulLifeRevision {\n    /** When the revision was recorded. */\n    createdAt?: string;\n    /** The person who recorded the revision. */\n    createdBy?: SparsePerson;\n    /** The day the new useful life takes effect. */\n    effectiveDate?: string;\n    /** The revision's key. */\n    key?: string;\n    /** Free-form detail about the revision. */\n    notes?: string | null;\n    /** Why the useful life changed. */\n    reason?: UsefulLifeRevisionReason;\n    /** The asset's new useful life in months. */\n    usefulLifeMonths?: number;\n}\n\n/** A machine-readable predicate describing why an entity needs attention. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type AttentionReason = \"DELIVERED_NOT_RECEIVED\" | \"OPEN_NOT_SHIPPED\" | \"SHIPPED_NOT_DELIVERED\";\n\n/** An ordinal severity for the needs-attention signal. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type AttentionSeverity = \"CRITICAL\" | \"NOTICE\" | \"WARNING\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type BillingFrequency = \"ANNUALLY\" | \"BIENNIALLY\" | \"BIWEEKLY\" | \"DAILY\" | \"MONTHLY\" | \"ONCE\" | \"QUADRENNIALLY\" | \"QUARTERLY\" | \"QUINQUENNIALLY\" | \"SEMIANNUALLY\" | \"TRIENNIALLY\" | \"WEEKLY\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type BillingSchedule = \"MILESTONE\" | \"PERIODIC\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type BillingTiming = \"ADVANCE\" | \"ARREARS\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type Carrier = \"airterra\" | \"apc_postal\" | \"apg\" | \"aramex\" | \"asendia_us\" | \"australia_post\" | \"axlehire\" | \"better_trucks\" | \"borderguru\" | \"boxberry\" | \"bring\" | \"canada_post\" | \"cdl\" | \"chronopost\" | \"colissimo\" | \"collect_plus\" | \"correios_br\" | \"correos_espana\" | \"couriersplease\" | \"deutsche_post\" | \"dhl_benelux\" | \"dhl_ecommerce\" | \"dhl_express\" | \"dhl_germany\" | \"dhl_germany_c2c\" | \"dpd_de\" | \"dpd_uk\" | \"estafeta\" | \"fastway_australia\" | \"fedex\" | \"globegistics\" | \"gls_us\" | \"gophr\" | \"gso\" | \"hermes_germany_b2c\" | \"hermes_uk\" | \"hongkong_post\" | \"la_poste\" | \"lasership\" | \"lso\" | \"mondial_relay\" | \"new_zealand_post\" | \"nippon_express\" | \"ontrac\" | \"orangeds\" | \"other\" | \"parcel\" | \"parcelforce\" | \"passport\" | \"pcf\" | \"pitney_bowes\" | \"poste_italiane\" | \"posti\" | \"purolator\" | \"royal_mail\" | \"royal_mail_sf\" | \"rr_donnelley\" | \"russian_post\" | \"sendle\" | \"shippo\" | \"skypostal\" | \"stuart\" | \"swyft\" | \"uds\" | \"ups\" | \"usps\" | \"veho\" | \"x_delivery\" | \"yodel\";\n\nexport interface Charge {\n    /** The moment the charge became billable, or null while it has not. */\n    actualBillableAt?: string | null;\n    /** The day the charge became billable, or null while it has not. */\n    billingEligibleDate?: string | null;\n    /** Why the charge was cancelled, or null when none was given or it is not cancelled. */\n    cancellationReason?: string | null;\n    /** The moment the charge was cancelled, or null when it is not cancelled. */\n    cancelledAt?: string | null;\n    /** The day the charge is planned to become billable, or null when it has no dates yet. */\n    expectedBillableDate?: string | null;\n    /** The charge's unique identifier. */\n    id?: string;\n    /** True when a person added, edited or split the charge, and false when it came from the line item's billing plan unchanged. */\n    isCustomModified?: boolean;\n    /** The charge's key. */\n    key?: string;\n    /** The charge's display name, such as the period it covers or the milestone it follows. */\n    label?: string;\n    /** PER_UNIT when the charge bills a unit price for each unit, or FIXED when it bills a flat amount. */\n    pricingMode?: PricingMode;\n    /** The number of units the charge bills. */\n    quantity?: number;\n    /** The charge's position among its line item's charges, in ascending order. */\n    sequence?: number;\n    /** The last day of the period the charge covers. */\n    servicePeriodEnd?: string | null;\n    /** The first day of the period the charge covers, or null when the charge has no dates yet. */\n    servicePeriodStart?: string | null;\n    /** PLANNED before the charge can be invoiced, BILLABLE once it can, INVOICED once it is on an invoice, or CANCELLED when it will not be billed. */\n    status?: ChargeStatus;\n    /** The amount the charge bills. */\n    totalPrice?: Currency;\n    /** TIME when the charge becomes billable on ExpectedBillableDate, or MANUAL when a person marks it billable. */\n    triggerType?: ChargeTriggerType;\n    /** The price of one unit behind the charge, or null when TotalPrice was not computed from one. */\n    unitPrice?: Currency | null;\n}\n\nexport interface ChargeListItem {\n    /** The moment the charge became billable, or null while it has not. */\n    actualBillableAt?: string | null;\n    /** Why the charge was cancelled, or null when none was given or it is not cancelled. */\n    cancellationReason?: string | null;\n    /** The moment the charge was cancelled, or null when it is not cancelled. */\n    cancelledAt?: string | null;\n    /** The line item's schedule: PERIODIC when its charges recur at a regular frequency, or MILESTONE when each follows a project milestone. */\n    chargeSchedule?: BillingSchedule;\n    /** The day the charge is planned to become billable, or null when it has no dates yet. */\n    expectedBillableDate?: string | null;\n    /** The charge's unique identifier. */\n    id?: string;\n    /** The item the charge's line item bills for. */\n    item?: SparseItem;\n    /** The charge's key. */\n    key?: string;\n    /** The charge's display name, such as the period it covers or the milestone it follows. */\n    label?: string;\n    /** CONFIRMED when the line item's charges carry dates, or PENDING when its activation date is not yet known, and a PERIODIC charge can be marked billable only once it is CONFIRMED. */\n    lineItemChargeMode?: ChargeMode;\n    /** The key of the line item the charge belongs to. */\n    lineItemKey?: string;\n    /** PER_UNIT when the charge bills a unit price for each unit, or FIXED when it bills a flat amount. */\n    pricingMode?: PricingMode;\n    /** The project the charge belongs to, which carries the charge's customer. */\n    project?: SparseProject;\n    /** The number of units the charge bills. */\n    quantity?: number;\n    /** The last day of the period the charge covers. */\n    servicePeriodEnd?: string | null;\n    /** The first day of the period the charge covers, or null when the charge has no dates yet. */\n    servicePeriodStart?: string | null;\n    /** The number of charges split from one charge, which is 1 for a charge that was never split. */\n    splitCount?: number;\n    /** The charge's position among the charges split from one charge, counted from 1. */\n    splitIndex?: number;\n    /** PLANNED before the charge can be invoiced, BILLABLE once it can, INVOICED once it is on an invoice, or CANCELLED when it will not be billed. */\n    status?: ChargeStatus;\n    /** The amount the charge bills. */\n    totalPrice?: Currency;\n    /** TIME when the charge becomes billable on ExpectedBillableDate, or MANUAL when a person marks it billable. */\n    triggerType?: ChargeTriggerType;\n    /** The price of one unit behind the charge, or null when TotalPrice was not computed from one. */\n    unitPrice?: Currency | null;\n}\n\nexport interface ChargeMarkedBillable {\n    /** The billable charge created for the quantity billed now, or null when the whole charge was billed. */\n    newCharge?: Charge | null;\n    /** The charge the request named, which keeps the quantity not billed when the charge was split. */\n    updatedCharge?: Charge;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ChargeMode = \"CONFIRMED\" | \"PENDING\";\n\nexport interface ChargePage {\n    /** The charges on this page. */\n    results?: ChargeListItem[];\n    /** The number of charges the filters match, across every page. */\n    totalCount?: number;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ChargeStatus = \"BILLABLE\" | \"CANCELLED\" | \"INVOICED\" | \"PLANNED\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ChargeTriggerType = \"EVENT\" | \"MANUAL\" | \"TIME\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type CompanyType = \"CUSTOMER\" | \"MANUFACTURER\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type CostAdjustmentReason = \"ADDITION\" | \"BETTERMENT\" | \"DAMAGE\" | \"INSTALLATION\" | \"LIFE_EXTENSION\" | \"MARKET_DECLINE\" | \"OBSOLESCENCE\" | \"OTHER\" | \"REGULATORY\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type CostAdjustmentType = \"CAPITALIZATION\" | \"IMPAIRMENT\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type CostBasisMode = \"ADVANCED\" | \"SIMPLE\" | null;\n\n/** The kind of credential a request was made with. Accepted in any case. The listed spelling is the one the API sends back. | Value | Description | | --- | --- | | `API_KEY` | An API key, for an integration that runs unattended | | `OAUTH` | An OAuth access token, issued to an application a person connected | | `SESSION` | A person signed in to Hardfin in a browser | */\nexport type CredentialType = \"API_KEY\" | \"OAUTH\" | \"SESSION\";\n\nexport interface Currency {\n    /** The value as a decimal string with two decimal places. */\n    amount?: string;\n    /** The value's ISO 4217 currency code. */\n    isoCode?: string;\n}\n\n/** An ISO 4217 alpha currency code. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type CurrencyCode = \"CAD\" | \"EUR\" | \"GBP\" | \"USD\";\n\nexport type Customer = SparseCustomer & {\n    /** The number of the customer's active projects. */\n    activeProjectCt?: number;\n    /** The number of assets the customer owns. */\n    assetCount?: number;\n    /** The number of assets at the customer's locations. */\n    assetsAtLocation?: number;\n    /** The address invoices are sent to. */\n    billingAddress?: string | null;\n    /** The person who receives the customer's invoices. */\n    billingContact?: CustomerBillingContact | null;\n    /** A free-form note about the customer. */\n    comment?: string | null;\n    /** The customer's web domain, used to look up its logo. */\n    domain?: string | null;\n    /** The customer's identifier in another system. */\n    externalId?: string | null;\n    /** The number of the customer's incomplete projects. */\n    incompleteProjectCt?: number;\n    /** The customer's links to integrated systems. */\n    integrations?: SharedIntegration[];\n    /** The number of the customer's locations. */\n    locationCount?: number;\n    /** The customer's locations. */\n    locations?: SparseLocationWithParent[];\n    /** The storage key of the customer's logo file. */\n    logoFileKey?: string | null;\n    /** The number of the customer's past projects. */\n    pastProjectCt?: number;\n    /** The number of the customer's upcoming projects. */\n    upcomingProjectCt?: number;\n};\n\nexport interface CustomerBillingContact {\n    /** The billing contact's email address. */\n    email?: string | null;\n    /** The billing contact's name. */\n    name?: string | null;\n    /** The billing contact's phone number. */\n    phone?: string | null;\n}\n\nexport interface CustomerListing {\n    /** The page of records. */\n    results?: Customer[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type Depreciation = \"DOUBLE_DECLINING\" | \"STRAIGHT_LINE\" | \"SUM_YEAR\" | \"UNIT_OF_PRODUCTION\" | null;\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type EntityType = \"ASSET\" | \"BILLING\" | \"BILLING_PLAN\" | \"CHARGE\" | \"CONTACT\" | \"COST\" | \"CUSTOMER\" | \"FULFILLMENT_ORDER\" | \"INVOICE\" | \"ITEM\" | \"LOCATION\" | \"ORGANIZATION\" | \"PERSON\" | \"PROJECT\" | \"PURCHASE_ORDER\" | \"RETURN_ORDER\" | \"SHIPMENT\" | \"TIME_RECORD\";\n\nexport interface Error {\n    error: string;\n    statusCode: number;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ExchangeGroupStatus = \"CANCELLED\" | \"COMPLETE\" | \"DRAFT\" | \"IN_PROGRESS\";\n\nexport interface File {\n    /** The file's unique identifier. */\n    id?: string;\n    /** The file's key, which the file endpoints take as fileKey. */\n    key?: string;\n    /** The file's media type, or empty when the upload named none. */\n    mimeType?: string;\n    /** The file's name as it was uploaded. */\n    name?: string;\n    /** The file's size in bytes. */\n    size?: number;\n    /** When the file was uploaded. */\n    uploadedAt?: string;\n}\n\nexport interface FileNewUpload {\n    /** The uploaded file's unique identifier. */\n    fileId?: string;\n    /** The uploaded file's key, which the file endpoints take as fileKey. */\n    fileKey?: string;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type FrontendItemType = \"BULK\" | \"DEVICE\" | \"SERVICE\";\n\nexport interface FulfillmentContactSnapshot {\n    /** The contact as the 3PL received it. */\n    data?: FulfillmentContactSnapshotData;\n    /** When the contact was copied. */\n    savedAt?: string;\n}\n\nexport interface FulfillmentContactSnapshotData {\n    /** The customer the contact belonged to when the order was sent, or null. */\n    company?: SparseCustomer | null;\n    /** The contact's email address when the order was sent, or null. */\n    email?: string | null;\n    /** The contact's first name when the order was sent, or null. */\n    firstName?: string | null;\n    /** The contact's last name when the order was sent, or null. */\n    lastName?: string | null;\n    /** The contact's phone number when the order was sent, or null. */\n    phone?: string | null;\n}\n\nexport interface FulfillmentCycleTime {\n    /** The days from the order's creation until it opened, or null while it has not opened. */\n    createdToOpenedDays?: string | null;\n    /** The days from the first shipment shipping until the order closed, or null until both happen. */\n    firstShipmentShippedToCloseDays?: string | null;\n    /** The days from the order opening until its first shipment shipped, or null until both happen. */\n    openToFirstShipmentShippedDays?: string | null;\n}\n\nexport interface FulfillmentItem {\n    /** The ID of the physical item the line asks for, which may appear on only one line. */\n    itemId: string;\n    /** How many units of the item the order asks for, above 0. */\n    requestedQuantity: number;\n}\n\nexport interface FulfillmentListing {\n    /** The page of records. */\n    results?: FulfillmentOrder[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\nexport interface FulfillmentOrder {\n    /** Why the order was cancelled, or null while it has not been. */\n    cancellationReason?: string | null;\n    /** When the order was cancelled, or null while it has not been. */\n    cancelledAt?: string | null;\n    /** Who cancelled the order, or null while it has not been cancelled. */\n    cancelledBy?: SparsePerson | null;\n    /** When the order closed, or null while it is open. */\n    closedAt?: string | null;\n    /** What closed the order: SHIPMENT_COMPLETE, MANUAL_CLOSE, THIRD_PARTY_FIN or CANCELLED, or null while it is open. */\n    closedAtSource?: FulfillmentOrderClosedAtSource | null;\n    /** Who closed the order by hand, or null when it closed on its own or is open. */\n    closedBy?: SparsePerson | null;\n    /** The person at the destination the order is for, or null. */\n    contact?: SparseContact | null;\n    /** When the order was created. */\n    createdAt?: string;\n    /** Who created the order. */\n    createdBy?: SparsePerson;\n    /** How long the order spent in each stage. */\n    cycleTime?: FulfillmentCycleTime;\n    /** The exchange the order is part of, or null when it is not part of one. */\n    exchangeGroup?: SparseExchangeGroup | null;\n    /** How many files are attached to the order. */\n    fileCount?: number;\n    /** When the order's first outbound shipment was created, cancelled shipments included, or null while it has none. */\n    firstShipmentOpenedAt?: string | null;\n    /** When the order's first outbound shipment shipped, cancelled shipments included, or null while none has. */\n    firstShipmentShippedAt?: string | null;\n    /** Where the order ships from. */\n    fromLocation?: SparseLocationWithIntegration | null;\n    /** The number the fulfillment order is known by. */\n    fulfillmentOrderNumber?: string;\n    /** The fulfillment order's unique identifier. */\n    id?: string;\n    /** The order's line items. */\n    items?: FulfillmentOrderItem[];\n    /** The fulfillment order's key, which the fulfillment endpoints take as fulfillmentKey. */\n    key?: string;\n    /** When the order's latest outbound shipment was created, cancelled shipments included, or null while it has none. */\n    lastShipmentOpenedAt?: string | null;\n    /** When the order's latest outbound shipment shipped, cancelled shipments included, or null while none has. */\n    lastShipmentShippedAt?: string | null;\n    /** When the order last changed. */\n    lastUpdatedAt?: string;\n    /** Who last changed the order. */\n    lastUpdatedBy?: SparsePerson;\n    /** When the order's latest shipment that is not cancelled was delivered, or null while none has been. */\n    mostRecentDeliveredAt?: string | null;\n    /** When the order's latest shipment that is not cancelled shipped, or null while none has. */\n    mostRecentShippedAt?: string | null;\n    /** When the order opened, which is when it was sent to a 3PL or when its first shipment was created, or null while it has not. */\n    openedAt?: string | null;\n    /** What Hardfin sent to a 3PL with the order, or null when it was never sent. */\n    orderDataSnapshot?: FulfillmentOrderDataSnapshot | null;\n    /** The note written about the order, or null. */\n    orderNotes?: string | null;\n    /** The project the order fills, or null when it fills none. */\n    project?: SparseProject | null;\n    /** The day the order is promised to arrive, or null when no one has said. */\n    promiseDeliveryDate?: string | null;\n    /** The day the order is promised to ship, or null when no one has said. */\n    promiseShipDate?: string | null;\n    /** Where the order stands: DRAFT, AWAITING_3PL, CANCELLED, or OPEN, SHIPPED or DELIVERED, each PARTIAL, FULL or OVERAGE against the requested quantities. */\n    status?: FulfillmentOrderStatus;\n    /** The order's fulfillment by a third-party logistics (3PL) provider and its sync state. */\n    thirdParty?: FulfillmentThirdParty;\n    /** Where the order ships to. */\n    toLocation?: SparseLocationWithIntegration | null;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type FulfillmentOrderClosedAtSource = \"CANCELLED\" | \"MANUAL_CLOSE\" | \"SHIPMENT_COMPLETE\" | \"THIRD_PARTY_FIN\";\n\nexport interface FulfillmentOrderDataSnapshot {\n    /** The contact as it stood when the order was sent to a 3PL, or null when the order named none. */\n    contact?: FulfillmentContactSnapshot | null;\n}\n\nexport interface FulfillmentOrderItem {\n    /** How many units are on shipments that have been delivered. */\n    deliveredQuantity?: number;\n    /** The line item's unique identifier. */\n    id?: string;\n    /** The item the line asks for. */\n    item?: SparseItem;\n    /** The line item's key. */\n    key?: string;\n    /** How many units sit on the order's outbound shipments that have not shipped. */\n    pendingQuantity?: number;\n    /** How many units a 3PL reported under a serial that conflicts with the asset record, held until someone resolves them. */\n    quarantinedQuantity?: number;\n    /** How many units of the item the order asks for. */\n    requestedQuantity?: number;\n    /** How many units are on shipments that have shipped and not yet been delivered. */\n    shippedQuantity?: number;\n    /** How far the line's units have got, such as OPEN_PARTIAL or DELIVERED_FULL, and DRAFT while the order is a draft. */\n    status?: FulfillmentOrderLineItemStatus;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type FulfillmentOrderLineItemStatus = \"DELIVERED_FULL\" | \"DELIVERED_OVERAGE\" | \"DELIVERED_PARTIAL\" | \"DRAFT\" | \"OPEN_FULL\" | \"OPEN_OVERAGE\" | \"OPEN_PARTIAL\" | \"SHIPPED_FULL\" | \"SHIPPED_OVERAGE\" | \"SHIPPED_PARTIAL\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type FulfillmentOrderStatus = \"AWAITING_3PL\" | \"CANCELLED\" | \"DELIVERED_FULL\" | \"DELIVERED_OVERAGE\" | \"DELIVERED_PARTIAL\" | \"DRAFT\" | \"OPEN_FULL\" | \"OPEN_OVERAGE\" | \"OPEN_PARTIAL\" | \"SHIPPED_FULL\" | \"SHIPPED_OVERAGE\" | \"SHIPPED_PARTIAL\";\n\nexport interface FulfillmentThirdParty {\n    /** Whether the last sync with the 3PL provider failed. */\n    hasSyncError?: boolean;\n    /** Whether the order was sent to a 3PL provider, which then ships it. */\n    isEnabled?: boolean;\n    /** When Hardfin last checked the order with its 3PL provider, or null when it has never checked. */\n    lastSyncedAt?: string | null;\n    /** When the 3PL provider last reported a change to the order, or null when it has reported none. */\n    lastUpdateAt?: string | null;\n    /** Why the last sync with the 3PL provider failed, or null when it did not. */\n    syncErrorMessage?: string | null;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type IntegrationCategory = \"CRM\" | \"ERP\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type IntegrationID = \"HUBSPOT\" | \"NETSUITE\" | \"NONE\" | \"QBO\" | \"SFDC\";\n\nexport interface Item {\n    /** Whether a BULK item records serial numbers on its units, which is false for SERVICE and DEVICE items. */\n    acceptsBulkSerials?: boolean;\n    /** The number of assets of a DEVICE item, and null for other types. */\n    assetCount?: number | null;\n    /** A free-form description of the item. */\n    description?: string | null;\n    /** The item's unique identifier. */\n    id?: string;\n    /** The item's links to integrated systems. */\n    integrations?: SharedIntegration[];\n    /** Whether the item is archived. */\n    isArchived?: boolean;\n    /** The item's key, which the item endpoints take as itemKey. */\n    key?: string;\n    /** When the item was last changed. */\n    lastUpdatedAt?: string | null;\n    /** The person who last changed the item. */\n    lastUpdatedBy?: SparsePerson;\n    /** The item's display name. */\n    name?: string;\n    /** Whether the item's units carry serial numbers, which is true for a DEVICE item and for a BULK item that accepts serials. */\n    shouldRenderSerialFields?: boolean;\n    /** The item's stock keeping unit, unique within your organization. */\n    sku?: string;\n    /** SERVICE for a non-physical item, DEVICE for a physical item tracked by serial number, or BULK for a part tracked by quantity. */\n    type?: FrontendItemType;\n}\n\nexport interface ItemAccounting {\n    /** The default share of overhead for one unit. */\n    allocatedIndirect?: string | null;\n    /** The default parts cost for one unit. */\n    billOfMaterials?: string | null;\n    /** The ISO 4217 code the default cost amounts are denominated in, or null when none is recorded. */\n    costCurrencyCode?: CurrencyCode | null;\n    /** The default method one unit is depreciated by. */\n    depreciationModel?: Depreciation;\n    /** The default labor cost to build one unit. */\n    directLabor?: string | null;\n    /** The default shipping cost to receive one unit. */\n    freightInbound?: string | null;\n    /** The default shipping cost to deliver one unit. */\n    freightOutbound?: string | null;\n    /** The default cost to install one unit. */\n    installation?: string | null;\n    /** The default financing cost for one unit. */\n    interest?: string | null;\n    /** The default value one unit keeps at the end of its useful life. */\n    salvageValue?: string | null;\n    /** A single default cost for one unit, used instead of the cost components. */\n    simpleCostBasis?: string | null;\n    /** The default import duty paid on one unit. */\n    tariffs?: string | null;\n    /** The default tax paid on one unit. */\n    tax?: string | null;\n    /** The default cost of goods sold for one unit, which is the simple cost basis when set and otherwise the sum of the cost components. */\n    totalCOGS?: string | null;\n    /** The default number of months one unit is depreciated over. */\n    usefulLife?: number | null;\n}\n\nexport interface ItemBOMItem {\n    /** The BULK part the bill of materials uses. */\n    item?: SparseItem;\n    /** The number of the part one unit of the item uses. */\n    quantity?: number;\n}\n\nexport interface ItemDetail {\n    /** Whether a BULK item records serial numbers on its units, which is false for SERVICE and DEVICE items. */\n    acceptsBulkSerials?: boolean;\n    /** The default costs and depreciation for a unit of a DEVICE or BULK item. */\n    accounting?: ItemAccounting;\n    /** The number of assets of a DEVICE item, and null for other types. */\n    assetCount?: number | null;\n    /** The bill of materials, the BULK parts one unit of the item is built from, or null when it has none. */\n    bom?: ItemBOMItem[] | null;\n    /** The pricing a project line item's billing plan starts from when it sells the item, or null when the item has none. */\n    defaultPricing?: ItemPricing | null;\n    /** A free-form description of the item. */\n    description?: string | null;\n    /** The custom fields each asset of a DEVICE item can hold. */\n    fields?: ItemField[];\n    /** Whether each unit of the item is tracked as its own asset, which is true for a DEVICE item. */\n    hasAssets?: boolean;\n    /** The item's unique identifier. */\n    id?: string;\n    /** The item's links to integrated systems. */\n    integrations?: SharedIntegration[];\n    /** The number of inventory movements of a BULK item, and null for other types. */\n    inventoryMovementCount?: number | null;\n    /** Whether the item is archived. */\n    isArchived?: boolean;\n    /** Whether the item is physical, which is true for DEVICE and BULK items. */\n    isPhysical?: boolean;\n    /** The item's key, which the item endpoints take as itemKey. */\n    key?: string;\n    /** When the item was last changed. */\n    lastUpdatedAt?: string | null;\n    /** The person who last changed the item. */\n    lastUpdatedBy?: SparsePerson;\n    /** The item's display name. */\n    name?: string;\n    /** Whether the item's units carry serial numbers, which is true for a DEVICE item and for a BULK item that accepts serials. */\n    shouldRenderSerialFields?: boolean;\n    /** The item's stock keeping unit, unique within your organization. */\n    sku?: string;\n    /** SERVICE for a non-physical item, DEVICE for a physical item tracked by serial number, or BULK for a part tracked by quantity. */\n    type?: FrontendItemType;\n}\n\nexport interface ItemField {\n    /** The field's unique identifier. */\n    id?: string;\n    /** The field's key, which the item field endpoints take as fieldKey. */\n    key?: string;\n    /** The field's display name. */\n    label?: string;\n    /** The number of assets that hold a value for the field. */\n    metadataCount?: number;\n    /** The field's position within its section, starting at 0. */\n    order?: number;\n    /** The group the field is shown in, starting at 0. */\n    section?: number;\n    /** The kind of value the field holds. */\n    type?: ItemFieldType;\n}\n\nexport interface ItemFieldOrderingUpdateItem {\n    /** The ID of the item field to move. */\n    fieldId: string;\n    /** The field's position within its section, starting at 0. */\n    order?: number;\n    /** The group the field is shown in, starting at 0. */\n    section?: number;\n}\n\n/** The kind of value an item's custom field holds. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ItemFieldType = \"BOOLEAN\" | \"DATE\" | \"DATE_TIME\" | \"INTEGER\" | \"MULTILINE_TEXT\" | \"NUMBER\" | \"TEXT\" | \"TIME\";\n\nexport interface ItemListing {\n    /** The page of records. */\n    results?: Item[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\nexport interface ItemPricing {\n    /** How often a PERIODIC charge recurs. */\n    chargeFrequency?: BillingFrequency | null;\n    /** PERIODIC to charge on a recurring cadence, or MILESTONE to charge when a milestone is reached. */\n    chargeSchedule?: BillingSchedule | null;\n    /** The default price for the whole line, used when pricingMode is FIXED. */\n    fixedPrice?: Currency | null;\n    /** How often the charges are invoiced. */\n    invoiceFrequency?: BillingFrequency | null;\n    /** ADVANCE to invoice a period before it starts, or ARREARS to invoice it after it ends. */\n    invoiceMode?: BillingTiming | null;\n    /** PER_UNIT to charge the unit price for each unit, or FIXED to charge the fixed price for the line whatever its quantity. */\n    pricingMode?: PricingMode | null;\n    /** The default price for each unit, used when pricingMode is PER_UNIT. */\n    unitPrice?: Currency | null;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ItemType = \"marked_bulk\" | \"service\" | \"tracked_device\" | \"unmarked_bulk\";\n\nexport type Location = SparseLocationWithIntegration & {\n    /** The number of active projects at the location. */\n    activeProjectCount?: number;\n    /** The number of assets currently at the location. */\n    assetCount?: number;\n    /** The number of incomplete projects at the location. */\n    incompleteProjectCount?: number;\n    /** The number of past projects at the location. */\n    pastProjectCount?: number;\n    /** The number of upcoming projects at the location. */\n    upcomingProjectCount?: number;\n};\n\nexport interface LocationListing {\n    /** The page of records. */\n    results?: Location[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type LocationType = \"SITE\" | \"ZONE\" | null;\n\nexport interface Metadata {\n    errors: Error[] | null;\n    /** What the client should know about its request, beside any error. A notice never fails a request. */\n    notices?: Notice[];\n    /** The identifier to quote when asking Hardfin about this request. */\n    requestId: string;\n    /** How long the server took to answer. */\n    requestTime: string;\n    statusCode: number;\n}\n\nexport interface MetadataLocationComponents {\n    /** The first line of the street address. */\n    addressLine1?: string | null;\n    /** The second line of the street address, such as a suite. */\n    addressLine2?: string | null;\n    /** The city. */\n    city?: string | null;\n    /** The country. */\n    country?: string | null;\n    /** The whole address on one line. */\n    formattedAddress?: string | null;\n    /** The postal or ZIP code. */\n    postalCode?: string | null;\n    /** The state or region. */\n    state?: string | null;\n}\n\nexport interface MetadataLocationSite {\n    /** The location's structured address, which a zone reads from its parent site. */\n    address?: MetadataLocationComponents | null;\n    /** Google's place ID for the address, when it was found through Google. */\n    googlePlaceId?: string | null;\n    /** The location's latitude, sent as a decimal string. */\n    latitude?: string | null;\n    /** The location's longitude, sent as a decimal string. */\n    longitude?: string | null;\n    /** The person or business that receives shipments at the location. */\n    shippingName?: string | null;\n}\n\nexport interface MetadataMilestonePhaseEntry {\n    /** The phase's name, which its charge takes as a label, 255 characters or less. */\n    name?: string;\n    /** The share of the line item's total the phase bills, from 0 to 100. */\n    percentage?: string | null;\n}\n\nexport interface MetadataMilestonePhases {\n    /** The phases, in order. */\n    entries?: MetadataMilestonePhaseEntry[];\n    /** PERCENTAGE, the only way a phase's share is expressed. */\n    mode?: string;\n}\n\nexport interface Notice {\n    /** What the notice is about. API_VERSION_OUTDATED means an earlier version of the endpoint answered, because X-API-Version is behind its last change. Ignore a code that is not recognized. */\n    code: string;\n    /** The X-API-Version to move to so the notice stops. */\n    latestVersion: string;\n    message: string;\n}\n\nexport interface PaymentTerm {\n    /** The payment term's identifier. */\n    id?: string;\n    /** The payment term's key. */\n    key?: string;\n    /** The payment term's name as people read it. */\n    label?: string;\n    /** The number of days after the invoice date that payment is due. */\n    netDays?: number;\n    /** The payment term's machine name. */\n    value?: string;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type PricingMode = \"FIXED\" | \"PER_UNIT\";\n\nexport type Project = SparseProject & {\n    /** The day the customer accepted the project. */\n    acceptanceDate?: string | null;\n    /** The workflow the project is on, with the project's current stage marked active, or null when it has no workflow. */\n    activeWorkflow?: SparseActiveWorkflow | null;\n    /** The project's annual recurring revenue, with one total for each currency its recurring line items are priced in. */\n    annualRecurringRevenue?: ProjectCurrencyAmount[];\n    /** The billing address the project's invoices use in place of the customer's. */\n    billingAddress?: string | null;\n    /** The billing contact email the project's invoices use in place of the customer's. */\n    billingContactEmail?: string | null;\n    /** The billing contact name the project's invoices use in place of the customer's. */\n    billingContactName?: string | null;\n    /** The billing contact phone number the project's invoices use in place of the customer's. */\n    billingContactPhone?: string | null;\n    /** The number of charges on the project's line items. */\n    chargeCount?: number;\n    /** What follows the project for its customer: it was renewed, the customer kept a later-ending project, or nothing followed. */\n    completionClassification?: ProjectCompletionClassification;\n    /** The day the contract was signed. */\n    contractSignedOn?: string | null;\n    /** The number of costs recorded against the project. */\n    costCount?: number;\n    /** The project's single currency and the field that established it, or null when no currency-bearing field is set. */\n    currency?: ProjectCurrency | null;\n    /** The customer the project is for. */\n    customer?: SparseCustomer | null;\n    /** The project's default location, which counts among its locations even when no line item names it. */\n    defaultLocation?: SparseLocationWithParent | null;\n    /** The project's description. */\n    description?: string | null;\n    /** The discount applied to the project. */\n    discount?: Currency | null;\n    /** The number of files attached to the project. */\n    fileCount?: number;\n    /** The day the project goes live. */\n    goLiveDate?: string | null;\n    /** The day of the installation. */\n    installDate?: string | null;\n    /** The number of the project's charges that have been invoiced. */\n    invoicedChargeCount?: number;\n    /** The project's line items, each an item the project sells or provides as a service. */\n    items?: ProjectLineItem[];\n    /** Every location the project names: the ones its line items ask for, and its default location. */\n    locations?: SparseLocationWithParent[];\n    /** The memo new invoices for the project carry. */\n    memo?: string | null;\n    /** The number of notes on the project. */\n    noteCount?: number;\n    /** The project's payment term. */\n    paymentTerm?: PaymentTerm | null;\n    /** The project this one renews. */\n    previousProject?: SparseProject | null;\n    /** Whether the items the project asks for have been fulfilled, judged across all of its line items. */\n    projectFulfillmentStatus?: ProjectFulfillmentStatus;\n    /** The customer's purchase order number, which new invoices for the project carry. */\n    purchaseOrderNumber?: string | null;\n    /** The day of the site visit. */\n    siteVisitDate?: string | null;\n    /** How the project relates to the customer's earlier projects: a renewal of a prior project, new business, or an expansion. */\n    startClassification?: ProjectStartClassification;\n    /** The number of tickets on the project. */\n    ticketCount?: number;\n    /** The number of time activities recorded against the project. */\n    timeActivityCount?: number;\n    /** The contract's total value, as entered on the project. */\n    totalContractValue?: Currency | null;\n    /** The day of the training. */\n    trainingDate?: string | null;\n    /** The number of URL links attached to the project. */\n    urlLinkCount?: number;\n};\n\nexport interface ProjectChargeRequestItem {\n    /** The day the charge is planned to become billable, or null when it has no dates yet. */\n    expectedBillableDate?: string | null;\n    /** The charge to update, or null to add a new one, and no two charges in the list send the same one. */\n    id?: string | null;\n    /** True when a person added, edited or split the charge, and false when it follows the line item's billing plan unchanged. */\n    isCustomModified?: boolean;\n    /** The charge's display name, such as the period it covers or the milestone it follows, which is required and 255 characters or less once the spaces around it are trimmed. */\n    label?: string;\n    /** PER_UNIT when the charge bills a unit price for each unit, or FIXED when it bills a flat amount. */\n    pricingMode?: PricingMode;\n    /** The number of units the charge bills, which is at least 1 when UnitPrice is sent and 2,147,483,647 or less. */\n    quantity?: number;\n    /** The charge's position among its line item's charges, in ascending order, which is zero or more and sent by one charge in the list. */\n    sequence?: number;\n    /** The last day of the period the charge covers, on or after ServicePeriodStart. */\n    servicePeriodEnd?: string | null;\n    /** The first day of the period the charge covers, or null when the charge has no dates yet. */\n    servicePeriodStart?: string | null;\n    /** The charge's status: PLANNED, BILLABLE, INVOICED or CANCELLED. */\n    status?: ChargeStatus;\n    /** The amount the charge bills, which equals UnitPrice times Quantity when UnitPrice is sent. */\n    totalPrice?: Currency;\n    /** TIME when the charge becomes billable on ExpectedBillableDate, or MANUAL when a person marks it billable, and is TIME when omitted. */\n    triggerType?: ChargeTriggerType;\n    /** The price of one unit, in the currency of TotalPrice, and is null on a FIXED charge. */\n    unitPrice?: Currency | null;\n}\n\n/** What follows a project for its customer when it ends. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ProjectCompletionClassification = \"CHURN\" | \"CONTRACTION\" | \"RENEWED\";\n\nexport interface ProjectCurrency {\n    /** The ISO 4217 code of the project's currency. */\n    isoCode?: CurrencyCode;\n    /** What fixed the project's currency: an invoiced charge, the contract value, the line items, or the discount. */\n    source?: ProjectCurrencySource;\n}\n\nexport interface ProjectCurrencyAmount {\n    /** The amount, in the currency IsoCode names. */\n    amount?: string;\n    /** The amount's ISO 4217 currency code. */\n    isoCode?: CurrencyCode;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ProjectCurrencySource = \"DISCOUNT\" | \"INVOICED_CHARGE\" | \"LINE_ITEMS\" | \"PROJECT_VALUE\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ProjectFulfillmentStatus = \"FULFILLED\" | \"OVER_FULFILLED\" | \"PARTIALLY_FULFILLED\" | \"UNFULFILLED\";\n\nexport interface ProjectItemBinding {\n    /** The day a periodic line item's charge schedule is anchored on, which defaults to StartOn. */\n    activationDate?: string | null;\n    /** The identifier that makes line items consecutive phases of one commitment when they send the same one, and is assigned when a new line item omits it. */\n    aggregationKey?: string;\n    /** The line item's single billing cadence, which fills ChargeFrequency and InvoiceFrequency on a periodic line item that omits them. */\n    billingFrequency?: BillingFrequency | null;\n    /** How often a periodic line item creates a charge, and is refused unless ChargeSchedule is PERIODIC. */\n    chargeFrequency?: BillingFrequency | null;\n    /** PERIODIC when charges recur at a regular frequency, or MILESTONE when each charge follows a project milestone. */\n    chargeSchedule?: BillingSchedule | null;\n    /** A free-form note about the line item, 65,536 characters or less. */\n    details?: string | null;\n    /** The last day of the line item's service window, on or after StartOn. */\n    endOn?: string | null;\n    /** The flat price when PricingMode is FIXED, and is not sent together with UnitPrice. */\n    fixedPrice?: Currency | null;\n    /** The line item to update, or omitted to add a new one. */\n    id?: string | null;\n    /** How often a periodic line item's charges are invoiced, which is never more often than ChargeFrequency. */\n    invoiceFrequency?: BillingFrequency | null;\n    /** ADVANCE to invoice a period before it starts, or ARREARS to invoice it after it ends, and is refused unless ChargeSchedule is PERIODIC. */\n    invoiceMode?: BillingTiming | null;\n    /** The catalog item the line item is for. */\n    itemId: string;\n    /** The location the line item is for. */\n    locationId?: string | null;\n    /** The named phases of a milestone line item and each one's share of its total. */\n    milestonePhases?: MetadataMilestonePhases | null;\n    /** PER_UNIT to charge the unit price for each unit, or FIXED to charge the fixed price whatever the quantity. */\n    pricingMode?: PricingMode | null;\n    /** The number of units the line item covers, which is zero or more. */\n    quantity?: number;\n    /** The first day of the line item's own service window, sent together with EndOn. */\n    startOn?: string | null;\n    /** A negotiated total for a periodic line item that replaces the computed one, in the project's currency. */\n    totalOverride?: Currency | null;\n    /** SALE to sell the item, which only a physical item allows, or SERVICE to provide it as a service. */\n    transactionType: TransactionType;\n    /** The price of one unit for each charge, and is not sent together with FixedPrice. */\n    unitPrice?: Currency | null;\n}\n\nexport interface ProjectLineItem {\n    /** The day a periodic line item's charge schedule is anchored on, or null while ChargeMode is PENDING and on a milestone line item. */\n    activationDate?: string | null;\n    /** The identifier shared by line items that are consecutive phases of one commitment, and unique to a line item that stands alone. */\n    aggregationKey?: string;\n    /** The line item's single billing cadence, which predates ChargeFrequency and InvoiceFrequency. */\n    billingFrequency?: BillingFrequency | null;\n    /** How often a periodic line item creates a charge, and is null on a milestone line item. */\n    chargeFrequency?: BillingFrequency | null;\n    /** CONFIRMED when the line item's charges carry dates, or PENDING when its activation date is not yet known and they do not. */\n    chargeMode?: ChargeMode;\n    /** PERIODIC when charges recur at a regular frequency, or MILESTONE when each charge follows a project milestone, and is null until the line item has a billing plan. */\n    chargeSchedule?: BillingSchedule | null;\n    /** The line item's charges, in Sequence order. */\n    charges?: Charge[];\n    /** A free-form note about the line item. */\n    details?: string | null;\n    /** The last day of the line item's service window. */\n    endOn?: string | null;\n    /** The flat price when PricingMode is FIXED: the amount of each charge on a periodic line item, and the total its phases split on a milestone one. */\n    fixedPrice?: Currency | null;\n    /** True when any of the line item's charges is invoiced, which stops the line item from being removed. */\n    hasInvoicedCharges?: boolean;\n    /** The line item's unique identifier. */\n    id?: string;\n    /** How often a periodic line item's charges are invoiced, which is never more often than ChargeFrequency. */\n    invoiceFrequency?: BillingFrequency | null;\n    /** ADVANCE to invoice a period before it starts, or ARREARS to invoice it after it ends, on a periodic line item. */\n    invoiceMode?: BillingTiming | null;\n    /** The catalog item the line item is for. */\n    item?: SparseItem;\n    /** The line item's key. */\n    key?: string;\n    /** The location the line item is for, or null when it has none. */\n    location?: SparseLocationWithParent | null;\n    /** The named phases of a milestone line item and each one's share of its total, or null on any other line item. */\n    milestonePhases?: MetadataMilestonePhases | null;\n    /** The line item's position among the line items sharing its AggregationKey, counted from 1 in order of StartOn. */\n    phaseRowNumber?: number;\n    /** PER_UNIT to charge the unit price for each unit, or FIXED to charge the fixed price whatever the quantity, and is null until the line item has a billing plan. */\n    pricingMode?: PricingMode | null;\n    /** The number of units the line item covers. */\n    quantity?: number | null;\n    /** The first day of the line item's own service window, or null when it has no dates. */\n    startOn?: string | null;\n    /** A negotiated total for a periodic line item that replaces the computed one, or null to use the computed total. */\n    totalOverride?: Currency | null;\n    /** SALE when the item is sold, or SERVICE when it is provided as a service. */\n    transactionType?: TransactionType;\n    /** The price of one unit for each charge, or null when the line item is priced at a fixed price. */\n    unitPrice?: Currency | null;\n}\n\nexport interface ProjectListing {\n    /** The page of records. */\n    results?: Project[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\n/** How a project relates to the customer's earlier projects when it starts. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ProjectStartClassification = \"EXPANSION\" | \"NEW_BUSINESS\" | \"RENEWAL\";\n\n/** Where a project stands against its dates, which is computed and never stored. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ProjectStatus = \"ACTIVE\" | \"DATE_RANGE_INCOMPLETE\" | \"PAST\" | \"UPCOMING\";\n\n/** A project status the project list and the fulfillment report filter by. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ProjectStatusFilter = \"ACTIVE\" | \"DATE_RANGE_INCOMPLETE\" | \"PAST\" | \"UPCOMING\";\n\nexport interface PurchaseOrder {\n    /** Why the order was cancelled, or null while it has not been. */\n    cancellationReason?: string | null;\n    /** When the order was cancelled, or null while it has not been. */\n    cancelledAt?: string | null;\n    /** Who cancelled the order, or null while it has not been cancelled. */\n    cancelledBy?: SparsePerson | null;\n    /** The carrier the supplier ships the order with, or null when none is named. */\n    carrier?: Carrier | null;\n    /** When the order was created. */\n    createdAt?: string;\n    /** Who created the order. */\n    createdBy?: SparsePerson;\n    /** The supplier's own number for the order, or null when it has none. */\n    externalPurchaseOrderNumber?: string | null;\n    /** The number of files attached to the order. */\n    fileCount?: number;\n    /** The location the supplier ships from, or null when none is on record. */\n    fromLocation?: SparseLocationWithIntegration | null;\n    /** The purchase order's unique identifier. */\n    id?: string;\n    /** The order's lines. */\n    items?: PurchaseOrderLineItem[];\n    /** The purchase order's key, which the purchase order endpoints take as purchaseOrderKey. */\n    key?: string;\n    /** When the order last changed. */\n    lastUpdatedAt?: string;\n    /** Who last changed the order. */\n    lastUpdatedBy?: SparsePerson;\n    /** When an inbound shipment for the order was last delivered, or null while none has been. */\n    mostRecentDeliveredAt?: string | null;\n    /** When an inbound shipment for the order was last received, or null while none has been. */\n    mostRecentReceivedAt?: string | null;\n    /** When an inbound shipment for the order last shipped, or null while none has. */\n    mostRecentShippedAt?: string | null;\n    /** A note about the order, or null. */\n    orderNotes?: string | null;\n    /** The carrier's name when Carrier is other, or null. */\n    otherCarrier?: string | null;\n    /** The day the supplier promised the order would arrive, or null when it has not said. */\n    promiseDeliveryDate?: string | null;\n    /** The day the supplier promised to ship the order, or null when it has not said. */\n    promiseShipDate?: string | null;\n    /** The number the purchase order is known by, which an inbound shipment names to fill it. */\n    purchaseOrderNumber?: string;\n    /** The number the carrier will track the shipment by, or null when it has none. */\n    referenceNumber?: string | null;\n    /** Where the order is in its life, by the furthest stage any of its lines has reached on the order's inbound shipments. */\n    status?: PurchaseOrderStatus;\n    /** The company the items are ordered from. */\n    supplier?: SparseCustomer;\n    /** The order's receiving by a third-party logistics (3PL) provider and its sync state. */\n    thirdParty?: PurchaseOrderThirdParty;\n    /** The location the order is delivered to. */\n    toLocation?: SparseLocationWithIntegration;\n}\n\nexport interface PurchaseOrderItem {\n    /** The ID of the physical item the line orders, which may appear on only one line. */\n    itemId: string;\n    /** How many units of the item to order, which must be greater than 0. */\n    requestedQuantity: number;\n}\n\nexport interface PurchaseOrderLineItem {\n    /** How many units are on the order's inbound shipments that have been delivered and not yet received. */\n    deliveredQuantity?: number;\n    /** The line's unique identifier. */\n    id?: string;\n    /** The item the line orders. */\n    item?: SparseItem;\n    /** The line's key. */\n    key?: string;\n    /** How many units are on the order's inbound shipments that have not yet shipped. */\n    openQuantity?: number;\n    /** How many units have been received on the order's inbound shipments. */\n    receivedQuantity?: number;\n    /** How many units of the item were ordered. */\n    requestedQuantity?: number;\n    /** How many units are on the order's inbound shipments that have shipped and not yet been delivered. */\n    shippedQuantity?: number;\n    /** The furthest stage the line's units have reached on the order's inbound shipments, and whether fewer, exactly, or more units than were ordered reached it. */\n    status?: PurchaseOrderLineItemStatus;\n}\n\n/** The status of a line item on a purchase order. Accepted in any case. The listed spelling is the one the API sends back. | Value | Description | | --- | --- | | `DELIVERED_FULL` | The ordered units have been delivered | | `DELIVERED_OVERAGE` | More units than were ordered have been delivered | | `DELIVERED_PARTIAL` | Fewer units than were ordered have been delivered | | `DRAFT` | None of the line's units are on a shipment yet | | `OPEN_FULL` | The ordered units are on shipments that have not left | | `OPEN_OVERAGE` | More units than were ordered are on shipments that have not left | | `OPEN_PARTIAL` | Fewer units than were ordered are on shipments that have not left | | `RECEIVED_FULL` | The ordered units have been received | | `RECEIVED_OVERAGE` | More units than were ordered have been received | | `RECEIVED_PARTIAL` | Fewer units than were ordered have been received | | `SHIPPED_FULL` | The ordered units have shipped | | `SHIPPED_OVERAGE` | More units than were ordered have shipped | | `SHIPPED_PARTIAL` | Fewer units than were ordered have shipped | */\nexport type PurchaseOrderLineItemStatus = \"DELIVERED_FULL\" | \"DELIVERED_OVERAGE\" | \"DELIVERED_PARTIAL\" | \"DRAFT\" | \"OPEN_FULL\" | \"OPEN_OVERAGE\" | \"OPEN_PARTIAL\" | \"RECEIVED_FULL\" | \"RECEIVED_OVERAGE\" | \"RECEIVED_PARTIAL\" | \"SHIPPED_FULL\" | \"SHIPPED_OVERAGE\" | \"SHIPPED_PARTIAL\";\n\nexport interface PurchaseOrderListing {\n    /** The page of records. */\n    results?: PurchaseOrder[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\nexport interface PurchaseOrderResync3PLFilesResult {\n    /** How many of those files the 3PL did not accept, which a later resync tries again. */\n    failedFiles?: number;\n    /** How many of those files the 3PL accepted. */\n    successfulFiles?: number;\n    /** How many of the order's files the 3PL had not yet received. */\n    totalFiles?: number;\n}\n\n/** The status of a purchase order. Accepted in any case. The listed spelling is the one the API sends back. | Value | Description | | --- | --- | | `AWAITING_3PL` | The order was sent to a third-party logistics provider, which has not yet reported a shipment | | `CANCELLED` | The order was cancelled | | `DELIVERED_FULL` | Every line's ordered units have been delivered | | `DELIVERED_OVERAGE` | Every line's ordered units have been delivered, and some line delivered more than was ordered | | `DELIVERED_PARTIAL` | Units have been delivered, and not every line has been delivered in full | | `DRAFT` | No units are on a shipment yet, and the order can still be edited or cancelled | | `OPEN_FULL` | Every line's ordered units are on shipments that have not left | | `OPEN_OVERAGE` | Every line's ordered units are on shipments that have not left, and some line has more than was ordered | | `OPEN_PARTIAL` | Units are on shipments that have not left, and not every line is there in full | | `RECEIVED_FULL` | Every line's ordered units have been received | | `RECEIVED_OVERAGE` | Every line's ordered units have been received, and some line received more than was ordered | | `RECEIVED_PARTIAL` | Units have been received, and not every line has been received in full | | `SHIPPED_FULL` | Every line's ordered units have shipped | | `SHIPPED_OVERAGE` | Every line's ordered units have shipped, and some line shipped more than was ordered | | `SHIPPED_PARTIAL` | Units have shipped, and not every line has shipped in full | */\nexport type PurchaseOrderStatus = \"AWAITING_3PL\" | \"CANCELLED\" | \"DELIVERED_FULL\" | \"DELIVERED_OVERAGE\" | \"DELIVERED_PARTIAL\" | \"DRAFT\" | \"OPEN_FULL\" | \"OPEN_OVERAGE\" | \"OPEN_PARTIAL\" | \"RECEIVED_FULL\" | \"RECEIVED_OVERAGE\" | \"RECEIVED_PARTIAL\" | \"SHIPPED_FULL\" | \"SHIPPED_OVERAGE\" | \"SHIPPED_PARTIAL\";\n\nexport interface PurchaseOrderThirdParty {\n    /** Whether the last sync with the 3PL provider failed. */\n    hasSyncError?: boolean;\n    /** Whether the order was sent to a 3PL provider, which then receives it and keeps it from being edited. */\n    isEnabled?: boolean;\n    /** When Hardfin last checked the order with its 3PL provider, or null when it has never checked. */\n    lastSyncedAt?: string | null;\n    /** When the 3PL provider last reported a change to the order, or null when it has reported none. */\n    lastUpdateAt?: string | null;\n    /** Why the last sync with the 3PL provider failed, or null when it did not. */\n    syncErrorMessage?: string | null;\n}\n\n/** The condition that stops a resolution the hold's type allows from running. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type QuarantineResolutionBlockReason = \"SERIAL_ALREADY_TAKEN\";\n\n/** How a user resolved a quarantined serial. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type QuarantineResolutionKind = \"ACCEPTED_SERIAL\" | \"CORRECTED_SERIAL\" | \"CREATED_ASSET\" | \"KEPT_HARDFIN_ITEM\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type QuarantineType = \"DUPLICATE_ALREADY_EXISTS\" | \"DUPLICATE_IN_ORDER\" | \"MISSING_SERIAL\" | \"SERIAL_PATTERN_MISMATCH\" | \"SKU_TRANSMUTATION\" | \"UNKNOWN_SERIAL\";\n\n/** The item type a request asks an item to become. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type RequestedItemType = \"BULK\" | \"DEVICE\" | \"SERVICE\";\n\n/** Accepted in any case, and also as t, f, 1, 0, or 2 for all. The listed spelling is the one the API sends back. */\nexport type ScrappedState = \"all\" | \"false\" | \"true\";\n\nexport interface SharedBool {\n    /** Whether the operation completed. */\n    success?: boolean;\n}\n\nexport interface SharedIntegration {\n    /** The Hardfin error code of the failed sync, or null when the sync did not fail. */\n    errorCode?: number | null;\n    /** The integrated system, such as SFDC or HUBSPOT. */\n    id?: IntegrationID;\n    /** Whether the last sync with the external system failed. */\n    inError?: boolean;\n    /** Whether a sync with the external system is pending. */\n    isSyncing?: boolean;\n    /** The system's display name. */\n    label?: string;\n    /** A URL to the linked record in the external system. */\n    link?: string | null;\n    /** Whether the record differs from the external system and needs a person to review it. */\n    needsReview?: boolean;\n    /** The kind of system, CRM or ERP. */\n    type?: IntegrationCategory;\n}\n\nexport interface Shipment {\n    /** Why the shipment was cancelled, or null while it has not been. */\n    cancellationReason?: string | null;\n    /** When the shipment was cancelled, or null while it has not been. */\n    cancelledAt?: string | null;\n    /** The ID of the user who cancelled the shipment, or null while it has not been cancelled. */\n    cancelledBy?: string | null;\n    /** Who carries the shipment, or null when no carrier is named. */\n    carrier?: Carrier | null;\n    /** When the shipment was created. */\n    createdAt?: string;\n    /** Who created the shipment. */\n    createdBy?: SparsePerson;\n    /** How long the shipment spent in each stage. */\n    cycleTime?: ShipmentCycleTime;\n    /** When the shipment arrived, or null while it has not. */\n    deliveredAt?: string | null;\n    /** The IANA time zone DeliveredAt was recorded in, or null when none was recorded. */\n    deliveredAtTimezone?: string | null;\n    /** The note written when the shipment was delivered, or null. */\n    deliveryNote?: string | null;\n    /** The sum of the lines' estimated values, or null when no line has an estimate. */\n    estimatedTotalValue?: string | null;\n    /** When the carrier now expects to deliver, or null when it says nothing. */\n    eta?: string | null;\n    /** The day the shipment is expected to arrive, or null when no one has said. */\n    expectedDeliveredOn?: string | null;\n    /** The day the shipment is expected to leave, or null when no one has said. */\n    expectedShippedOn?: string | null;\n    /** Where the shipment leaves from, or null when an inbound shipment names no origin. */\n    fromLocation?: SparseLocationWithIntegration | null;\n    /** The fulfillment order an outbound shipment fills, or null when it fills none. */\n    fulfillmentOrder?: SparseFulfillment | null;\n    /** The shipment's unique identifier. */\n    id?: string;\n    /** The shipment's line items. */\n    items?: ShipmentLineItem[];\n    /** The shipment's key, which the shipment endpoints take as shipmentKey. */\n    key?: string;\n    /** The carrier's name when Carrier is other, or null. */\n    otherCarrier?: string | null;\n    /** The purchase order an inbound shipment fills, or null when it fills none. */\n    purchaseOrder?: SparsePurchaseOrder | null;\n    /** The note written when the shipment was received, or null. */\n    receiptNote?: string | null;\n    /** When an inbound shipment's items were received, or null while they have not been. */\n    receivedAt?: string | null;\n    /** The IANA time zone ReceivedAt was recorded in, or null when none was recorded. */\n    receivedAtTimezone?: string | null;\n    /** The number the carrier tracks the shipment by, or null when it has none. */\n    referenceNumber?: string | null;\n    /** The return order an inbound shipment fills, or null when it fills none. */\n    returnOrder?: SparseReturnOrder | null;\n    /** The carrier's service the shipment travels on, or null when the carrier names none. */\n    serviceLevelName?: string | null;\n    /** The note written about the shipment itself, or null. */\n    shipmentNote?: string | null;\n    /** The number the shipment is known by. */\n    shipmentNumber?: string;\n    /** Whether the shipment is INBOUND to the organization or OUTBOUND from it. */\n    shipmentType?: ShipmentType | null;\n    /** When the shipment left, or null while it has not. */\n    shippedAt?: string | null;\n    /** The IANA time zone ShippedAt was recorded in, or null when none was recorded. */\n    shippedAtTimezone?: string | null;\n    /** What the shipment cost to send, or null when no cost is recorded. */\n    shippingCost?: Currency | null;\n    /** Where the shipment is in its life: OPEN, SHIPPED, DELIVERED, RECEIVED or CANCELLED. */\n    status?: ShipmentStatus;\n    /** Whether a third-party provider holds the shipment, which refuses changes made through the API. */\n    thirdPartyBound?: boolean;\n    /** How many days the shipment has held its status, or null once it is received or cancelled. */\n    timeInStatusDays?: string | null;\n    /** Where the shipment is going. */\n    toLocation?: SparseLocationWithIntegration;\n    /** What the shipment's assets are worth, or null when it has none to value. */\n    totalValue?: string | null;\n}\n\nexport interface ShipmentCycleTime {\n    /** The days from the shipment's creation to its ship time, or null while it has not shipped. */\n    createdToShippedDays?: string | null;\n    /** The days from the shipment's ship time to its delivery, or null while it has not been delivered. */\n    shippedToDeliveredDays?: string | null;\n}\n\nexport interface ShipmentItem {\n    /** The line's identifier in another system, or null when it has none. */\n    externalReference?: string | null;\n    /** The ID of the item the line carries. */\n    itemId?: string;\n    /** How many units the line ships, which an outbound shipment requires above 0 and an inbound shipment may leave null. */\n    quantity?: number | null;\n    /** The serial numbers of the units, for an item that is tracked by serial. */\n    serials?: string[];\n}\n\nexport interface ShipmentLineItem {\n    /** What the line was estimated to be worth while the shipment was open, or null when no estimate was made. */\n    estimatedValue?: string | null;\n    /** The line's identifier in the system that reported it, or null when it has none. */\n    externalReference?: string | null;\n    /** The item the line carries. */\n    item?: SparseItem;\n    /** The number of serial numbers in PendingSerials. */\n    pendingSerialCount?: number;\n    /** The serial numbers a third-party provider has reported but not yet confirmed as shipped. */\n    pendingSerials?: string[];\n    /** How many units the line ships, or null when the line was added without one. */\n    quantity?: number | null;\n    /** How many units arrived, or null until an inbound shipment is received. */\n    receivedQuantity?: number | null;\n    /** The number of serial numbers in Serials. */\n    serialCount?: number;\n    /** The serial numbers of the line's units, which is empty for an item that is not tracked by serial. */\n    serials?: string[];\n    /** What the line's assets are worth, or null when it has none to value. */\n    value?: string | null;\n}\n\nexport interface ShipmentListing {\n    /** The shipments on the page. */\n    results?: Shipment[];\n    /** The number of shipments the filters match, across every page. */\n    totalCount?: number;\n}\n\nexport interface ShipmentReceiveItem {\n    /** The line's identifier in another system, or null when it has none. */\n    externalReference?: string | null;\n    /** The ID of the item that arrived, which may be named once. */\n    itemId?: string;\n    /** How many units arrived, which is required and may be 0 for a line that did not arrive. */\n    quantity?: number | null;\n    /** The serial numbers of the units that arrived, for an item that is tracked by serial. */\n    serials?: string[];\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ShipmentStatus = \"CANCELLED\" | \"DELIVERED\" | \"OPEN\" | \"RECEIVED\" | \"SHIPPED\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ShipmentType = \"INBOUND\" | \"OUTBOUND\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type SortOrder = \"ASC\" | \"DESC\";\n\nexport interface SparseActiveWorkflow {\n    id?: string;\n    key?: string;\n    name?: string;\n    stages?: SparseWorkflowStage[];\n}\n\nexport interface SparseAsset {\n    /** Whether the asset works, is broken, awaits review, or has been scrapped. */\n    functionalStatus?: AssetFunctionalStatus;\n    /** The asset's unique identifier. */\n    id?: string;\n    /** The day the asset entered inventory. */\n    inInventoryDate?: string;\n    /** Whether the asset is archived. */\n    isArchived?: boolean;\n    /** Whether the asset has shipped and not yet been delivered. */\n    isInTransit?: boolean;\n    /** The catalog item the asset is a unit of. */\n    item?: SparseItem;\n    /** The asset's key, which the asset endpoints take as assetKey. */\n    key?: string;\n    /** The asset's serial number, unique within its item. */\n    serial?: string;\n}\n\nexport interface SparseContact {\n    /** A note about the contact, or null. */\n    comments?: string | null;\n    /** When the contact was created. */\n    createdAt?: string;\n    /** The customer the contact works for. */\n    customer?: SparseCustomer;\n    /** The contact's email address, or null. */\n    email?: string | null;\n    /** The contact's first name. */\n    firstName?: string;\n    /** The contact's unique identifier. */\n    id?: string;\n    /** Whether the contact is archived. */\n    isArchived?: boolean;\n    /** The contact's key. */\n    key?: string;\n    /** The contact's last name. */\n    lastName?: string;\n    /** The contact's phone number, or null. */\n    phone?: string | null;\n    /** The contact's job title, or null. */\n    title?: string | null;\n    /** When the contact last changed. */\n    updatedAt?: string;\n}\n\nexport interface SparseCustomer {\n    /** The customer's unique identifier. */\n    id?: string;\n    /** Whether the customer is archived. */\n    isArchived?: boolean;\n    /** Whether the company is a customer. */\n    isCustomer?: boolean;\n    /** Whether the company is a supplier. */\n    isSupplier?: boolean;\n    /** The customer's key, which the customer endpoints take as customerKey. */\n    key?: string;\n    /** The customer's display name. */\n    name?: string;\n}\n\nexport interface SparseExchangeGroup {\n    /** The number the exchange is known by. */\n    exchangeNumber?: string;\n    /** The fulfillment orders that send replacement units. */\n    fulfillmentOrders?: SparseExchangeGroupFulfillment[];\n    /** The exchange's unique identifier. */\n    id?: string;\n    /** The exchange's key. */\n    key?: string;\n    /** The return orders that bring units back. */\n    returnOrders?: SparseExchangeGroupReturnOrder[];\n    /** Where the exchange stands: DRAFT, IN_PROGRESS, COMPLETE or CANCELLED. */\n    status?: ExchangeGroupStatus;\n}\n\nexport interface SparseExchangeGroupFulfillment {\n    /** The number the fulfillment order is known by. */\n    fulfillmentOrderNumber?: string;\n    /** The fulfillment order's unique identifier. */\n    id?: string;\n    /** The fulfillment order's key. */\n    key?: string;\n}\n\nexport interface SparseExchangeGroupReturnOrder {\n    /** The return order's unique identifier. */\n    id?: string;\n    /** The return order's key. */\n    key?: string;\n    /** The number the return order is known by. */\n    returnOrderNumber?: string;\n}\n\nexport interface SparseFulfillment {\n    /** The number the fulfillment order is known by. */\n    fulfillmentOrderNumber?: string;\n    /** The fulfillment order's unique identifier. */\n    id?: string;\n    /** Whether a third-party provider fulfills the order. */\n    isThirdPartyFulfilled?: boolean;\n    /** The fulfillment order's key. */\n    key?: string;\n}\n\nexport interface SparseItem {\n    /** Whether each unit of the item is tracked as its own asset, which is true for a DEVICE item. */\n    hasAssets?: boolean;\n    /** The item's unique identifier. */\n    id?: string;\n    /** Whether the item is archived. */\n    isArchived?: boolean;\n    /** Whether the item is physical, which is true for DEVICE and BULK items. */\n    isPhysical?: boolean;\n    /** The item's key, which the item endpoints take as itemKey. */\n    key?: string;\n    /** The item's display name. */\n    name?: string;\n    /** Whether the item's units carry serial numbers, which is true for a DEVICE item and for a BULK item that accepts serials. */\n    shouldRenderSerialFields?: boolean;\n    /** The item's stock keeping unit, unique within your organization. */\n    sku?: string;\n    /** SERVICE for a non-physical item, DEVICE for a physical item tracked by serial number, or BULK for a part tracked by quantity. */\n    type?: FrontendItemType;\n    /** The unit the item's quantities are counted in. */\n    unitOfMeasure?: UnitOfMeasure;\n}\n\nexport type SparseLocation = MetadataLocationSite & {\n    /** The number of archived zones at a site. */\n    archivedZoneCount?: number;\n    /** The customer a zone is designated for, such as for reservations, provisioning or a 3PL. */\n    consignee?: SparseCustomer | null;\n    /** The customer the location is assigned to, which a zone reads from its parent site, or null for your organization's own locations. */\n    customer?: SparseCustomer | null;\n    /** A free-form description of a zone. */\n    description?: string | null;\n    /** The location's unique identifier. */\n    id?: string;\n    /** Whether Google resolved the site's address, which is always false for a zone. */\n    isAddressGeocoded?: boolean;\n    /** Whether the location is archived. */\n    isArchived?: boolean;\n    /** Whether assets at the location count as inventory for reporting. */\n    isInventory?: boolean;\n    /** Whether a zone sets its own isInventory rather than inheriting its parent site's. */\n    isInventoryOverride?: boolean;\n    /** Whether a third-party logistics (3PL) provider fulfills orders from the location. */\n    isThirdPartyEnabled?: boolean;\n    /** Whether assets make only occasional or temporary stops at the location, which hides it from location lists by default. */\n    isTransient?: boolean;\n    /** The location's key, which the location endpoints take as locationKey. */\n    key?: string;\n    /** The location's display name. */\n    name?: string;\n    /** The 3PL provider's identifier for the location. */\n    thirdPartyIdentifier?: string | null;\n    /** SITE for a site, or ZONE for a zone within a site. */\n    type?: LocationType;\n    /** The number of zones at a site. */\n    zoneCount?: number;\n    /** The site's zones. */\n    zones?: SparseZone[];\n};\n\nexport type SparseLocationWithIntegration = SparseLocationWithParent & {\n    /** The location's links to integrated systems. */\n    integrations?: SharedIntegration[];\n};\n\nexport type SparseLocationWithParent = SparseLocation & {\n    /** The site a zone belongs to, or null for a site. */\n    parentLocation?: SparseLocation | null;\n};\n\nexport interface SparseOrganization {\n    /** The organization's ID */\n    id?: string;\n    /** The public identifier that can be used in URLs */\n    key?: string;\n    /** The name of the organization */\n    name?: string;\n}\n\nexport interface SparsePerson {\n    /** The person's first name. */\n    firstName?: string | null;\n    /** The person's unique identifier. */\n    id?: string;\n    /** The person's key. */\n    key?: string;\n    /** The person's last name. */\n    lastName?: string | null;\n}\n\nexport interface SparseProject {\n    /** The customer the project is for. */\n    customer?: SparseCustomer | null;\n    /** The day the project ends. */\n    endOn?: string | null;\n    /** The project's unique identifier. */\n    id?: string;\n    /** The project's links to integrated systems. */\n    integrations?: SharedIntegration[];\n    /** Whether the project is archived. */\n    isArchived?: boolean;\n    /** The project's key. */\n    key?: string;\n    /** The project's display name. */\n    name?: string;\n    /** The name of the project's payment term. */\n    paymentTermLabel?: string | null;\n    /** The customer's purchase order number, which new invoices for the project carry. */\n    purchaseOrderNumber?: string | null;\n    /** The day the project starts. */\n    startOn?: string | null;\n    /** Whether the project is upcoming, active, or past, judged from its dates. */\n    status?: ProjectStatus;\n}\n\nexport interface SparsePurchaseOrder {\n    /** The supplier's own number for the purchase order, or null when it has none. */\n    externalPurchaseOrderNumber?: string | null;\n    /** The purchase order's unique identifier. */\n    id?: string;\n    /** The purchase order's key. */\n    key?: string;\n    /** The number the purchase order is known by. */\n    purchaseOrderNumber?: string;\n}\n\nexport interface SparseReturnOrder {\n    /** The return order's unique identifier. */\n    id?: string;\n    /** The return order's key. */\n    key?: string;\n    /** The number the return order is known by. */\n    returnOrderNumber?: string;\n}\n\nexport interface SparseShipment {\n    /** When the shipment arrived, or null while it has not. */\n    deliveredAt?: string | null;\n    /** The shipment's unique identifier. */\n    id?: string;\n    /** The shipment's key. */\n    key?: string;\n    /** The number the shipment is known by. */\n    shipmentNumber?: string;\n    /** What kind of movement the shipment carries. */\n    shipmentType?: string;\n    /** When the shipment left, or null while it has not. */\n    shippedAt?: string | null;\n}\n\nexport interface SparseWorkflowStage {\n    active?: boolean;\n    id?: string;\n    key?: string;\n    name?: string;\n    order?: number;\n}\n\nexport interface SparseZone {\n    /** The number of assets in the zone. */\n    assetCount?: number;\n    /** The customer the zone is designated for, such as for reservations, provisioning or a 3PL. */\n    consignee?: SparseCustomer | null;\n    /** A free-form description of the zone. */\n    description?: string | null;\n    /** The zone's unique identifier. */\n    id?: string;\n    /** Whether the zone is archived. */\n    isArchived?: boolean;\n    /** Whether assets in the zone count as inventory for reporting. */\n    isInventory?: boolean;\n    /** The zone's key. */\n    key?: string;\n    /** The zone's display name, unique within its site. */\n    name?: string;\n}\n\nexport interface Token {\n    /** When the API key was created, the application was connected, or the person signed in. */\n    createdAt?: string;\n    /** When the access token or session expires, or null for an API key, which does not. */\n    expiresAt?: string | null;\n    /** The API key's public identifier or the application's client_id, or null for a session. */\n    identifier?: string | null;\n    /** The API key's label or the application's name, or null when there is none. */\n    label?: string | null;\n    /** When the API key was last regenerated or the access token was issued, or null for a session. */\n    lastRegeneratedAt?: string | null;\n    /** The organization the credential acts in. */\n    organization?: SparseOrganization;\n    /** The person the credential acts for. */\n    person?: SparsePerson;\n    scopes?: string[];\n    /** The kind of credential. */\n    type?: CredentialType;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type TransactionType = \"SALE\" | \"SERVICE\";\n\n/** Accepted in any case, and also as t, f, 1, 0, or 2 for all. The listed spelling is the one the API sends back. */\nexport type TransientState = \"all\" | \"false\" | \"true\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type TransitStatus = \"IN_TRANSIT\" | \"IN_TRANSIT_TO_FIELD\" | \"IN_TRANSIT_TO_INVENTORY\" | \"NOT_IN_TRANSIT\";\n\nexport interface URLLink {\n    /** When the link was created. */\n    createdAt?: string;\n    /** The URL link's unique identifier. */\n    id?: string;\n    /** The URL link's key, which the URL link endpoints take as linkKey. */\n    key?: string;\n    /** The link's display name, or null when the link shows its address instead. */\n    name?: string | null;\n    /** When the link was last changed. */\n    updatedAt?: string;\n    /** The address the link points to. */\n    url?: string;\n}\n\n/** The unit a quantity is counted in, sent as its UNECE Recommendation 20 code. Accepted in any case. The listed spelling is the one the API sends back. | Value | Description | | --- | --- | | `BG` | Bag | | `BO` | Bottle | | `BX` | Box | | `C62` | Unit | | `CMK` | Square centimeter (cm2) | | `CMT` | Centimeter (cm) | | `CR` | Crate | | `CS` | Case | | `CT` | Carton | | `DMQ` | Cubic decimeter (dm3) | | `DR` | Drum | | `DZN` | Dozen (doz) | | `EA` | Each (ea) | | `EN` | Envelope | | `FOT` | Foot (ft) | | `FTK` | Square foot (ft2) | | `FTQ` | Cubic foot (ft3) | | `GLL` | Gallon (gal) | | `GRM` | Gram (g) | | `GRO` | Gross | | `H87` | Piece (pc) | | `INH` | Inch (in) | | `INK` | Square inch (in2) | | `INQ` | Cubic inch (in3) | | `KG` | Keg | | `KGM` | Kilogram (kg) | | `KMT` | Kilometer (km) | | `KT` | Kit | | `LBR` | Pound (lb) | | `LO` | Lot | | `LTR` | Liter (L) | | `MGM` | Milligram (mg) | | `MLT` | Milliliter (mL) | | `MMK` | Square millimeter (mm2) | | `MMT` | Millimeter (mm) | | `MTK` | Square meter (m2) | | `MTQ` | Cubic meter (m3) | | `MTR` | Meter (m) | | `ONZ` | Ounce (oz) | | `OZA` | Fluid ounce (fl oz) | | `PK` | Pack | | `PR` | Pair (pr) | | `PTI` | Pint (pt) | | `PX` | Pallet | | `QTI` | Quart (qt) | | `RL` | Reel | | `RO` | Roll | | `SET` | Set | | `SMI` | Mile (mi) | | `ST` | Sheet | | `STN` | Ton US (NT) | | `SV` | Skid | | `TNE` | Tonne metric (t) | | `TU` | Tube | | `YDK` | Square yard (yd2) | | `YDQ` | Cubic yard (yd3) | | `YRD` | Yard (yd) | */\nexport type UnitOfMeasure = \"BG\" | \"BO\" | \"BX\" | \"C62\" | \"CMK\" | \"CMT\" | \"CR\" | \"CS\" | \"CT\" | \"DMQ\" | \"DR\" | \"DZN\" | \"EA\" | \"EN\" | \"FOT\" | \"FTK\" | \"FTQ\" | \"GLL\" | \"GRM\" | \"GRO\" | \"H87\" | \"INH\" | \"INK\" | \"INQ\" | \"KG\" | \"KGM\" | \"KMT\" | \"KT\" | \"LBR\" | \"LO\" | \"LTR\" | \"MGM\" | \"MLT\" | \"MMK\" | \"MMT\" | \"MTK\" | \"MTQ\" | \"MTR\" | \"ONZ\" | \"OZA\" | \"PK\" | \"PR\" | \"PTI\" | \"PX\" | \"QTI\" | \"RL\" | \"RO\" | \"SET\" | \"SMI\" | \"ST\" | \"STN\" | \"SV\" | \"TNE\" | \"TU\" | \"YDK\" | \"YDQ\" | \"YRD\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type UsefulLifeRevisionReason = \"CHANGE_IN_USE\" | \"DAMAGE\" | \"OBSOLESCENCE\" | \"OTHER\" | \"REASSESSMENT\" | \"REFURBISHMENT\" | \"REGULATORY\";\n\nexport interface Workflow {\n    /** When the workflow was created. */\n    createdAt?: string;\n    /** The workflow's identifier. */\n    id?: string;\n    /** Whether this is the organization's default workflow. */\n    isDefault?: boolean;\n    /** The workflow's key. */\n    key?: string;\n    /** The workflow's name. */\n    name?: string;\n    /** The stages a project on this workflow moves through, in order. */\n    stages?: WorkflowStage[];\n    /** When the workflow was last changed. */\n    updatedAt?: string;\n}\n\nexport interface WorkflowStage {\n    /** When the stage was created. */\n    createdAt?: string;\n    /** The stage's identifier. */\n    id?: string;\n    /** The number of projects on the stage. */\n    inUseCount?: number;\n    /** The stage's key. */\n    key?: string;\n    /** The stage's name. */\n    name?: string;\n    /** The stage's position in its workflow. */\n    orderIndex?: number;\n    /** When the stage was last changed. */\n    updatedAt?: string;\n}\n";
+const API_TYPES = "// Types for the Hardfin API, version 2026-10-21, generated from its published document.\n// Regenerate them with hardfin types after upgrading the CLI.\n\n/** ApiError is one entry in a response's errors. */\nexport interface ApiError {\n    error: string;\n    statusCode: number;\n}\n\n/** ApiEnvelope is the shape every response takes, with the record or records in data. */\nexport interface ApiEnvelope<T> {\n    data: T;\n    metadata: {\n        errors?: ApiError[] | null;\n        requestId?: string;\n        requestTime?: string;\n        statusCode?: number;\n        pagination?: unknown;\n    };\n}\n\n/** Accepted in any case, and also as t, f, 1, 0, or 2 for all. The listed spelling is the one the API sends back. */\nexport type ArchivedState = \"all\" | \"false\" | \"true\";\n\nexport type Asset = SparseAsset & AssetLocationData & {\n    /** The asset's cost basis, depreciation, and accounting history. */\n    accounting?: AssetAccountingDetails;\n    /** The asset's recent events, such as shipments and deliveries. */\n    activity?: AssetEvent[];\n    /** A free-form description of the asset. */\n    description?: string | null;\n    /** The number of files attached to the asset. */\n    fileCount?: number;\n    /** The day the asset entered inventory. */\n    inInventoryDate?: string;\n    /** The asset's value for each custom field its item defines. */\n    metadata?: AssetMetadataFieldWrapper[];\n    /** Who owns the asset now. */\n    ownership?: AssetOwnership;\n    /** The project the asset is assigned to, or null when it is unassigned. */\n    project?: SparseProject | null;\n    /** How and when the asset was scrapped, or null when it has not been. */\n    scrappedContext?: AssetScrappedContext | null;\n    /** The number of tickets about the asset. */\n    ticketCount?: number;\n    /** The number of links attached to the asset. */\n    urlLinkCount?: number;\n};\n\nexport interface AssetAccountingDetails {\n    /** The asset's inventory cost basis, before deployment costs, which is what inventory is relieved by when the asset leaves it. */\n    acquisitionCogs?: Currency | null;\n    /** The asset's share of overhead. */\n    allocatedIndirect?: Currency | null;\n    /** The problems that keep the asset's accounting from being computed, such as a missing cost basis. */\n    assetExceptions?: AssetExceptionType[];\n    /** The parts cost. */\n    billOfMaterials?: Currency | null;\n    /** The cost basis on the books now, the acquisition basis in inventory and the deployed basis once the asset is a fixed asset. */\n    capitalizedCosts?: Currency | null;\n    /** The capitalizations and impairments made to the asset's cost after it was acquired. */\n    costAdjustments?: AssetCostAdjustment[];\n    /** The ISO 4217 code every cost amount on the asset is denominated in. */\n    costCurrencyCode?: CurrencyCode;\n    /** The method the asset is depreciated by. */\n    depreciationModel?: Depreciation;\n    /** The asset's book value month by month, from its inventory month, or null while it has an accounting exception. */\n    depreciationPeriods?: AssetDepreciationChartPeriod[] | null;\n    /** The labor cost to build the asset. */\n    directLabor?: Currency | null;\n    /** The shipping cost to receive the asset. */\n    freightInbound?: Currency | null;\n    /** The shipping cost to deploy the asset, a deployment cost. */\n    freightOutbound?: Currency | null;\n    /** The day the asset was put into service and began depreciating. */\n    inServiceDate?: string | null;\n    /** The cost to install the asset, a deployment cost. */\n    installation?: Currency | null;\n    /** The financing cost of the asset. */\n    interest?: Currency | null;\n    /** Whether the asset's cost currency can no longer be changed. Closing an accounting period, the first accounting true-up, or recording a cost adjustment locks it for good. A sale with a sale price, or a scrap with a disposal price, also locks it. That lock lifts when the sale is deleted, its sale price is cleared, or the asset is unscrapped, as long as no other priced sale or priced scrap remains. */\n    isCostCurrencyLocked?: boolean;\n    /** Whether Hardfin sets the in-service date itself rather than keeping one a person entered. */\n    isInServiceDateManagedAutomatically?: boolean;\n    /** The value the asset keeps at the end of its useful life. */\n    salvageValue?: Currency | null;\n    /** A single cost entered in place of the cost components. */\n    simpleCostBasis?: Currency | null;\n    /** The import duty paid on the asset. */\n    tariffs?: Currency | null;\n    /** The tax paid on the asset. */\n    tax?: Currency | null;\n    /** The deployed cost basis, including deployment costs, which is what is capitalized once the asset is put into service. */\n    totalPotentialCOGS?: Currency | null;\n    /** The number of months the asset is depreciated over. */\n    usefulLife?: number | null;\n    /** The changes made to the asset's useful life. */\n    usefulLifeRevisions?: AssetUsefulLifeRevision[];\n}\n\nexport interface AssetCostAdjustment {\n    /** CAPITALIZATION to add to the cost basis, or IMPAIRMENT to write it down. */\n    adjustmentType?: CostAdjustmentType;\n    /** The size of the adjustment. */\n    amount?: Currency;\n    /** When the adjustment was recorded. */\n    createdAt?: string;\n    /** The person who recorded the adjustment. */\n    createdBy?: SparsePerson;\n    /** The day the adjustment takes effect. */\n    effectiveDate?: string;\n    /** The cost adjustment's key. */\n    key?: string;\n    /** Free-form detail about the adjustment. */\n    notes?: string | null;\n    /** Why the cost changed. */\n    reason?: CostAdjustmentReason;\n}\n\nexport interface AssetDepreciationChartPeriod {\n    /** The depreciation charged from the in-service date through the end of the period. */\n    accumulated?: Currency;\n    /** The asset's value on the books at the end of the period. */\n    bookValue?: Currency;\n    /** The last day of the month the period covers. */\n    date?: string;\n    /** The depreciation charged in the period. */\n    depreciation?: Currency;\n}\n\nexport interface AssetEvent {\n    /** When the event was recorded. */\n    createdAt?: string;\n    /** The IANA time zone the event's times were entered in. */\n    eventTimezone?: string;\n    /** When the event is expected to happen, or null when no one has said. */\n    expectedAt?: string | null;\n    /** The event's unique identifier. */\n    id?: string;\n    /** Whether the event has to happen for its group to complete. */\n    isRequired?: boolean;\n    /** When the event happened, or null while it has not. */\n    occurredAt?: string | null;\n    /** The day the event was promised to a customer, or null when none was. */\n    promiseDate?: string | null;\n    /** The event's values a person set, such as carrier tracking. */\n    properties?: AssetEventProperty[];\n    /** The event's position within its group. */\n    sequence?: number;\n    /** When someone marked the event as happened in Hardfin, or null while it has not happened. */\n    triggeredAt?: string | null;\n    /** What kind of event this is. */\n    type?: AssetEventType;\n}\n\nexport interface AssetEventConfiguration {\n    /** The properties an event of the type carries. */\n    properties?: AssetEventProperty[];\n    /** The kind of event the configuration describes. */\n    type?: AssetEventType;\n}\n\nexport interface AssetEventGroup {\n    /** The kind of group this is, and the events it carries. */\n    configuration?: AssetEventGroupConfiguration;\n    /** Where the movement ends, or null when the group does not move the asset. */\n    destination?: SparseLocationWithParent | null;\n    /** The events the group has recorded so far. */\n    events?: AssetEvent[];\n    /** The event group's unique identifier. */\n    id?: string;\n    /** The event group's key, which the event group endpoints take as eventGroupKey. */\n    key?: string;\n    /** Where the movement started, or null when the group does not move the asset. */\n    origin?: SparseLocationWithParent | null;\n    /** The shipment the movement travels on, or null when it travels on none. */\n    shipment?: SparseShipment | null;\n}\n\nexport interface AssetEventGroupConfiguration {\n    /** The events a group of the kind carries, in the order they happen. */\n    events?: AssetEventConfiguration[];\n    /** The configuration's unique identifier. */\n    id?: string;\n    /** The configuration's key. */\n    key?: string;\n    /** What the configuration is called, such as ship and deliver. */\n    name?: string;\n}\n\nexport interface AssetEventProperty {\n    /** The event property's unique identifier. */\n    id?: string;\n    /** Whether Hardfin sets the property itself rather than a person, which responses leave out. */\n    isSystemProperty?: boolean;\n    /** The property's display name. */\n    label?: string;\n    /** The kind of value the property holds, such as CARRIER_TRACKING or CACHED_LOCATION. */\n    type?: string;\n    /** The property's value, whose JSON shape depends on the property's type. */\n    value?: unknown[] | boolean | number | Record<string, unknown> | string | null;\n}\n\nexport interface AssetEventType {\n    /** The event type's unique identifier. */\n    id?: string;\n    /** The event type's name, such as Ship or Deliver. */\n    name?: string;\n    /** Whether an event of this type only happens as part of a group, such as a shipment. */\n    requiresEventGroup?: boolean;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type AssetExceptionType = \"DEPLOYMENT_WITHOUT_ACQUISITION\" | \"DISPOSAL_DATE_BEFORE_INVENTORY\" | \"FIRST_ASSIGNMENT_BEFORE_INVENTORY\" | \"FIRST_MOVEMENT_BEFORE_INVENTORY\" | \"FIRST_SALE_DATE_BEFORE_INVENTORY\" | \"IN_SERVICE_DATE_BEFORE_INVENTORY\" | \"MISSING_COST_BASIS\" | \"MISSING_USEFUL_LIFE\" | \"SALVAGE_EXCEEDS_50_PERCENT\" | \"UNKNOWN\";\n\nexport interface AssetFile {\n    /** The file's unique identifier. */\n    id?: string;\n    /** Whether the file is readable with any organization's API key. */\n    isPublic?: boolean;\n    /** The file's key, which the file endpoints take as fileKey. */\n    key?: string;\n    /** The file's media type, or an empty string when the upload named none. */\n    mimeType?: string;\n    /** The name the file had when it was uploaded. */\n    name?: string;\n    /** The file's size in bytes. */\n    size?: number;\n    /** The file type the file was uploaded as. */\n    type?: string;\n    /** When the file was uploaded. */\n    uploadedAt?: string;\n}\n\n/** Whether an asset works, is broken, awaits review, or has been scrapped. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type AssetFunctionalStatus = \"FUNCTIONAL\" | \"NEEDS_REVIEW\" | \"NON-FUNCTIONAL\" | \"SCRAPPED\";\n\nexport interface AssetFunctionalStatusHistoryItem {\n    /** When the asset left the status, or null while it still holds it. */\n    end?: string | null;\n    /** When the asset took the status. */\n    start?: string;\n    /** Whether the asset worked, was broken, awaited review, or had been scrapped through the period. */\n    status?: AssetFunctionalStatus;\n}\n\nexport interface AssetListing {\n    /** The page of records. */\n    results?: Asset[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\nexport interface AssetLocationData {\n    /** Where the asset is, or null while it is in transit. */\n    currentLocation?: SparseLocationWithParent | null;\n    /** Whether the asset has shipped and not yet been delivered. */\n    inTransit?: boolean;\n    /** Where a planned or in-progress move takes the asset, or null when none is planned. */\n    nextLocation?: SparseLocationWithParent | null;\n    /** The location the asset was at before its current one, or null when it has not moved. */\n    previousLocation?: SparseLocationWithParent | null;\n}\n\nexport interface AssetMetadataField {\n    /** The item field's unique identifier. */\n    id?: string;\n    /** The item field's key. */\n    key?: string;\n    /** The field's display name. */\n    label?: string;\n    /** The field's position within its section, starting at 0. */\n    order?: number;\n    /** The group the field is shown in, starting at 0. */\n    section?: number;\n    /** The kind of value the field holds, which decides the JSON type of its value. */\n    type?: ItemFieldType;\n}\n\nexport type AssetMetadataFieldWrapper = {\n    field?: {\n        type?: \"BOOLEAN\";\n    };\n    value?: boolean | null;\n} | {\n    field?: {\n        type?: \"DATE\";\n    };\n    value?: string | null;\n} | {\n    field?: {\n        type?: \"DATE_TIME\";\n    };\n    value?: string | null;\n} | {\n    field?: {\n        type?: \"INTEGER\";\n    };\n    value?: number | null;\n} | {\n    field?: {\n        type?: \"MULTILINE_TEXT\";\n    };\n    value?: string | null;\n} | {\n    field?: {\n        type?: \"NUMBER\";\n    };\n    value?: number | null;\n} | {\n    field?: {\n        type?: \"TEXT\";\n    };\n    value?: string | null;\n} | {\n    field?: {\n        type?: \"TIME\";\n    };\n    value?: string | null;\n};\n\nexport interface AssetMoveToPlan {\n    /** The ID of the asset to move. */\n    assetId: string;\n    /** When the asset reaches its destination, or null when the move only ships. */\n    deliverAt?: string | null;\n    /** The client's own name for the move, which the plan echoes back beside its answer. */\n    id: string;\n    /** When the asset leaves its origin, or null when the move only delivers. */\n    shipAt?: string | null;\n}\n\nexport interface AssetOwnership {\n    /** The customer that owns the asset, or null when your organization owns it. */\n    customer?: SparseCustomer | null;\n    /** The day the asset's current owner took ownership, or null when its ownership has never changed. */\n    ownershipChangeDate?: string | null;\n}\n\nexport interface AssetOwnershipHistoryItem {\n    /** When the segment was recorded. */\n    createdAt?: string;\n    /** The customer that owned the asset during the segment, or null when your organization did. */\n    customer?: SparseCustomer | null;\n    /** The day the segment's owner took ownership. */\n    date?: string;\n    /** The ownership segment's unique identifier. */\n    id?: string;\n    /** The ownership segment's key, which the segment endpoints take as segmentKey. */\n    key?: string;\n    /** When the segment was last changed. */\n    lastModifiedAt?: string;\n    /** What the owner paid for the asset, or null when no price was recorded. */\n    salePrice?: Currency | null;\n}\n\nexport interface AssetPlannedIntersection {\n    /** The ID of the event group the move would collide with, or null when none names one. */\n    aegId?: string | null;\n    /** The key of the event group the move would collide with, or null when none names one. */\n    aegKey?: string | null;\n    /** When the colliding movement ends, or null while it has no end. */\n    end?: string | null;\n    /** When the colliding movement starts. */\n    start?: string;\n}\n\nexport interface AssetPlannedMove {\n    /** The client's own name for the move, echoed from the plan it asked about. */\n    id?: string;\n    /** The movement the move would collide with, or null when it collides with none. */\n    intersection?: AssetPlannedIntersection | null;\n    /** Whether the move can be carried out as asked. */\n    isValid?: boolean;\n}\n\n/** A project assignment the asset list filters by. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type AssetProjectStatusFilter = \"ACTIVE\" | \"NONE\" | \"PAST\" | \"UPCOMING\";\n\nexport interface AssetProposedMultiMove {\n    /** The ID of the asset to move. */\n    assetId: string;\n    /** When the asset reaches its destination, and one of shipAt or deliverAt is required. */\n    deliverAt?: string | null;\n    /** The IANA time zone name the delivery time was entered in, such as America/Denver; when omitted, the delivery time's clock time is read in the organization's time zone. */\n    deliverAtTimezone?: string | null;\n    /** The ID of the location the asset arrives at. */\n    destinationId: string;\n    /** The ID of the location the asset leaves. */\n    originId: string;\n    /** When the asset leaves its origin, and one of shipAt or deliverAt is required. */\n    shipAt?: string | null;\n    /** The IANA time zone name the ship time was entered in, such as America/Denver; when omitted, the ship time's clock time is read in the organization's time zone. */\n    shipAtTimezone?: string | null;\n}\n\nexport interface AssetScrappedContext {\n    /** The day the asset was scrapped. */\n    disposalDate?: string;\n    /** What the scrapped asset was sold for, or null when it was not sold. */\n    disposalPrice?: Currency | null;\n    /** Why the asset was scrapped. */\n    disposalReason?: string | null;\n}\n\nexport interface AssetShippingData {\n    /** When Hardfin recorded the update. */\n    createdAt?: string;\n    /** The tracking update's unique identifier. */\n    id?: string;\n    /** The tracking update's key. */\n    key?: string;\n    /** Where the carrier reported the shipment, or null when it reported nowhere. */\n    location?: AssetShippingDataLocation | null;\n    /** When the carrier says the update happened. */\n    reportedAt?: string;\n    /** The carrier's status for the shipment at that point. */\n    status?: string;\n    /** What the carrier wrote about the update. */\n    statusText?: string;\n    /** The carrier's finer status, or null when it reported none. */\n    substatus?: string | null;\n    /** When Hardfin last changed the update. */\n    updatedAt?: string;\n}\n\nexport interface AssetShippingDataListing {\n    /** Who carries the shipment and the number it is tracked by, or null when neither is named. */\n    carrier?: CarrierDetails | null;\n    /** When the carrier now expects to deliver, or null when it says nothing. */\n    eta?: string | null;\n    /** When the carrier first expected to deliver, or null when it said nothing. */\n    originalEta?: string | null;\n    /** The carrier's service the shipment travels on, or null when it names none. */\n    serviceLevelName?: string | null;\n    /** What the carrier has reported, newest first. */\n    shippingHistory?: AssetShippingData[];\n}\n\nexport interface AssetShippingDataLocation {\n    /** The city the carrier reported. */\n    city?: string;\n    /** The country the carrier reported. */\n    country?: string;\n    /** The state or region the carrier reported. */\n    state?: string;\n    /** The postal code the carrier reported. */\n    zip?: string;\n}\n\nexport interface AssetUpdateMetadataItem {\n    /** The ID of the item field to set on the asset. */\n    fieldId: string;\n    /** The field's new value, in the JSON type the field's type calls for, or null to clear it. */\n    value?: unknown[] | boolean | number | Record<string, unknown> | string | null;\n}\n\nexport interface AssetUsefulLifeRevision {\n    /** When the revision was recorded. */\n    createdAt?: string;\n    /** The person who recorded the revision. */\n    createdBy?: SparsePerson;\n    /** The day the new useful life takes effect. */\n    effectiveDate?: string;\n    /** The revision's key. */\n    key?: string;\n    /** Free-form detail about the revision. */\n    notes?: string | null;\n    /** Why the useful life changed. */\n    reason?: UsefulLifeRevisionReason;\n    /** The asset's new useful life in months. */\n    usefulLifeMonths?: number;\n}\n\n/** A machine-readable predicate describing why an entity needs attention. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type AttentionReason = \"DELIVERED_NOT_RECEIVED\" | \"OPEN_NOT_SHIPPED\" | \"SHIPPED_NOT_DELIVERED\";\n\n/** An ordinal severity for the needs-attention signal. It is advisory and non-blocking: it flags a record that has sat in a non-terminal state longer than expected. The ordinal ordering drives the attention sort. API responses use attention: null when no active attention finding exists. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type AttentionSeverity = \"CRITICAL\" | \"NOTICE\" | \"WARNING\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type BillingFrequency = \"ANNUALLY\" | \"BIENNIALLY\" | \"BIWEEKLY\" | \"DAILY\" | \"MONTHLY\" | \"ONCE\" | \"QUADRENNIALLY\" | \"QUARTERLY\" | \"QUINQUENNIALLY\" | \"SEMIANNUALLY\" | \"TRIENNIALLY\" | \"WEEKLY\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type BillingSchedule = \"MILESTONE\" | \"PERIODIC\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type BillingTiming = \"ADVANCE\" | \"ARREARS\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type Carrier = \"airterra\" | \"apc_postal\" | \"apg\" | \"aramex\" | \"asendia_us\" | \"australia_post\" | \"axlehire\" | \"better_trucks\" | \"borderguru\" | \"boxberry\" | \"bring\" | \"canada_post\" | \"cdl\" | \"chronopost\" | \"colissimo\" | \"collect_plus\" | \"correios_br\" | \"correos_espana\" | \"couriersplease\" | \"deutsche_post\" | \"dhl_benelux\" | \"dhl_ecommerce\" | \"dhl_express\" | \"dhl_germany\" | \"dhl_germany_c2c\" | \"dpd_de\" | \"dpd_uk\" | \"estafeta\" | \"fastway_australia\" | \"fedex\" | \"globegistics\" | \"gls_us\" | \"gophr\" | \"gso\" | \"hermes_germany_b2c\" | \"hermes_uk\" | \"hongkong_post\" | \"la_poste\" | \"lasership\" | \"lso\" | \"mondial_relay\" | \"new_zealand_post\" | \"nippon_express\" | \"ontrac\" | \"orangeds\" | \"other\" | \"parcel\" | \"parcelforce\" | \"passport\" | \"pcf\" | \"pitney_bowes\" | \"poste_italiane\" | \"posti\" | \"purolator\" | \"royal_mail\" | \"royal_mail_sf\" | \"rr_donnelley\" | \"russian_post\" | \"sendle\" | \"shippo\" | \"skypostal\" | \"stuart\" | \"swyft\" | \"uds\" | \"ups\" | \"usps\" | \"veho\" | \"x_delivery\" | \"yodel\";\n\nexport interface CarrierDetails {\n    /** The carrier's name, which is accepted only when type is other. */\n    name?: string | null;\n    /** The number the carrier tracks the shipment by, or null when it has none. */\n    trackingNumber?: string | null;\n    /** The carrier, or null when none is named. */\n    type?: Carrier | null;\n}\n\nexport interface Charge {\n    /** The moment the charge became billable, or null while it has not. */\n    actualBillableAt?: string | null;\n    /** The day the charge became billable, or null while it has not. */\n    billingEligibleDate?: string | null;\n    /** Why the charge was cancelled, or null when none was given or it is not cancelled. */\n    cancellationReason?: string | null;\n    /** The moment the charge was cancelled, or null when it is not cancelled. */\n    cancelledAt?: string | null;\n    /** The day the charge is planned to become billable, or null when it has no dates yet. */\n    expectedBillableDate?: string | null;\n    /** The charge's unique identifier. */\n    id?: string;\n    /** True when a person added, edited or split the charge, and false when it came from the line item's billing plan unchanged. */\n    isCustomModified?: boolean;\n    /** The charge's key. */\n    key?: string;\n    /** The charge's display name, such as the period it covers or the milestone it follows. */\n    label?: string;\n    /** PER_UNIT when the charge bills a unit price for each unit, or FIXED when it bills a flat amount. */\n    pricingMode?: PricingMode;\n    /** The number of units the charge bills. */\n    quantity?: number;\n    /** The charge's position among its line item's charges, in ascending order. */\n    sequence?: number;\n    /** The last day of the period the charge covers. */\n    servicePeriodEnd?: string | null;\n    /** The first day of the period the charge covers, or null when the charge has no dates yet. */\n    servicePeriodStart?: string | null;\n    /** PLANNED before the charge can be invoiced, BILLABLE once it can, INVOICED once it is on an invoice, or CANCELLED when it will not be billed. */\n    status?: ChargeStatus;\n    /** The amount the charge bills. */\n    totalPrice?: Currency;\n    /** TIME when the charge becomes billable on expectedBillableDate, or MANUAL when a person marks it billable. */\n    triggerType?: ChargeTriggerType;\n    /** The price of one unit behind the charge, or null when totalPrice was not computed from one. */\n    unitPrice?: Currency | null;\n}\n\nexport interface ChargeListItem {\n    /** The moment the charge became billable, or null while it has not. */\n    actualBillableAt?: string | null;\n    /** Why the charge was cancelled, or null when none was given or it is not cancelled. */\n    cancellationReason?: string | null;\n    /** The moment the charge was cancelled, or null when it is not cancelled. */\n    cancelledAt?: string | null;\n    /** The line item's schedule: PERIODIC when its charges recur at a regular frequency, or MILESTONE when each follows a project milestone. */\n    chargeSchedule?: BillingSchedule;\n    /** The day the charge is planned to become billable, or null when it has no dates yet. */\n    expectedBillableDate?: string | null;\n    /** The charge's unique identifier. */\n    id?: string;\n    /** The item the charge's line item bills for. */\n    item?: SparseItem;\n    /** The charge's key. */\n    key?: string;\n    /** The charge's display name, such as the period it covers or the milestone it follows. */\n    label?: string;\n    /** CONFIRMED when the line item's charges carry dates, or PENDING when its activation date is not yet known, and a PERIODIC charge can be marked billable only once it is CONFIRMED. */\n    lineItemChargeMode?: ChargeMode;\n    /** The key of the line item the charge belongs to. */\n    lineItemKey?: string;\n    /** PER_UNIT when the charge bills a unit price for each unit, or FIXED when it bills a flat amount. */\n    pricingMode?: PricingMode;\n    /** The project the charge belongs to, which carries the charge's customer. */\n    project?: SparseProject;\n    /** The number of units the charge bills. */\n    quantity?: number;\n    /** The last day of the period the charge covers. */\n    servicePeriodEnd?: string | null;\n    /** The first day of the period the charge covers, or null when the charge has no dates yet. */\n    servicePeriodStart?: string | null;\n    /** The number of charges split from one charge, which is 1 for a charge that was never split. */\n    splitCount?: number;\n    /** The charge's position among the charges split from one charge, counted from 1. */\n    splitIndex?: number;\n    /** PLANNED before the charge can be invoiced, BILLABLE once it can, INVOICED once it is on an invoice, or CANCELLED when it will not be billed. */\n    status?: ChargeStatus;\n    /** The amount the charge bills. */\n    totalPrice?: Currency;\n    /** TIME when the charge becomes billable on expectedBillableDate, or MANUAL when a person marks it billable. */\n    triggerType?: ChargeTriggerType;\n    /** The price of one unit behind the charge, or null when totalPrice was not computed from one. */\n    unitPrice?: Currency | null;\n}\n\nexport interface ChargeMarkedBillable {\n    /** The billable charge created for the quantity billed now, or null when the whole charge was billed. */\n    newCharge?: Charge | null;\n    /** The charge the request named, which keeps the quantity not billed when the charge was split. */\n    updatedCharge?: Charge;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ChargeMode = \"CONFIRMED\" | \"PENDING\";\n\nexport interface ChargePage {\n    /** The charges on this page. */\n    results?: ChargeListItem[];\n    /** The number of charges the filters match, across every page. */\n    totalCount?: number;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ChargeStatus = \"BILLABLE\" | \"CANCELLED\" | \"INVOICED\" | \"PLANNED\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ChargeTriggerType = \"EVENT\" | \"MANUAL\" | \"TIME\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type CompanyType = \"CUSTOMER\" | \"MANUFACTURER\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type CostAdjustmentReason = \"ADDITION\" | \"BETTERMENT\" | \"DAMAGE\" | \"INSTALLATION\" | \"LIFE_EXTENSION\" | \"MARKET_DECLINE\" | \"OBSOLESCENCE\" | \"OTHER\" | \"REGULATORY\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type CostAdjustmentType = \"CAPITALIZATION\" | \"IMPAIRMENT\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type CostBasisMode = \"ADVANCED\" | \"SIMPLE\" | null;\n\n/** The kind of credential a request was made with. Accepted in any case. The listed spelling is the one the API sends back. | Value | Description | | --- | --- | | `API_KEY` | An API key, for an integration that runs unattended | | `OAUTH` | An OAuth access token, issued to an application a person connected | | `SESSION` | A person signed in to Hardfin in a browser | */\nexport type CredentialType = \"API_KEY\" | \"OAUTH\" | \"SESSION\";\n\nexport interface Currency {\n    /** The exact value as a decimal string with at least two decimal places. */\n    amount?: string;\n    /** The value's ISO 4217 currency code. */\n    isoCode?: CurrencyCode;\n}\n\n/** An ISO 4217 alpha currency code. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type CurrencyCode = \"CAD\" | \"EUR\" | \"GBP\" | \"USD\";\n\nexport type Customer = SparseCustomer & {\n    /** The number of the customer's active projects. */\n    activeProjectCt?: number;\n    /** The number of assets the customer owns. */\n    assetCount?: number;\n    /** The number of assets at the customer's locations. */\n    assetsAtLocation?: number;\n    /** The address invoices are sent to. */\n    billingAddress?: string | null;\n    /** The person who receives the customer's invoices. */\n    billingContact?: CustomerBillingContact | null;\n    /** A free-form note about the customer. */\n    comment?: string | null;\n    /** The customer's web domain, used to look up its logo. */\n    domain?: string | null;\n    /** The customer's identifier in another system. */\n    externalId?: string | null;\n    /** The number of the customer's incomplete projects. */\n    incompleteProjectCt?: number;\n    /** The customer's links to integrated systems. */\n    integrations?: SharedIntegration[];\n    /** The number of the customer's locations. */\n    locationCount?: number;\n    /** The customer's locations. */\n    locations?: SparseLocationWithParent[];\n    /** The storage key of the customer's logo file. */\n    logoFileKey?: string | null;\n    /** The number of the customer's past projects. */\n    pastProjectCt?: number;\n    /** The number of the customer's upcoming projects. */\n    upcomingProjectCt?: number;\n};\n\nexport interface CustomerBillingContact {\n    /** The billing contact's email address. */\n    email?: string | null;\n    /** The billing contact's name. */\n    name?: string | null;\n    /** The billing contact's phone number. */\n    phone?: string | null;\n}\n\nexport interface CustomerListing {\n    /** The page of records. */\n    results?: Customer[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type Depreciation = \"DOUBLE_DECLINING\" | \"STRAIGHT_LINE\" | \"SUM_YEAR\" | \"UNIT_OF_PRODUCTION\" | null;\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type EntityType = \"ASSET\" | \"BILLING\" | \"BILLING_PLAN\" | \"CHARGE\" | \"CONTACT\" | \"COST\" | \"CUSTOMER\" | \"FULFILLMENT_ORDER\" | \"INVOICE\" | \"ITEM\" | \"LOCATION\" | \"ORGANIZATION\" | \"PERSON\" | \"PROJECT\" | \"PURCHASE_ORDER\" | \"RETURN_ORDER\" | \"SHIPMENT\" | \"TIME_RECORD\";\n\nexport interface Error {\n    error: string;\n    statusCode: number;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ExchangeGroupStatus = \"CANCELLED\" | \"COMPLETE\" | \"DRAFT\" | \"IN_PROGRESS\";\n\nexport interface File {\n    /** The file's unique identifier. */\n    id?: string;\n    /** The file's key, which the file endpoints take as fileKey. */\n    key?: string;\n    /** The file's media type, or empty when the upload named none. */\n    mimeType?: string;\n    /** The file's name as it was uploaded. */\n    name?: string;\n    /** The file's size in bytes. */\n    size?: number;\n    /** When the file was uploaded. */\n    uploadedAt?: string;\n}\n\nexport interface FileNewUpload {\n    /** The uploaded file's unique identifier. */\n    fileId?: string;\n    /** The uploaded file's key, which the file endpoints take as fileKey. */\n    fileKey?: string;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type FrontendItemType = \"BULK\" | \"DEVICE\" | \"SERVICE\";\n\nexport interface FulfillmentContactSnapshot {\n    /** The contact as the 3PL received it. */\n    data?: FulfillmentContactSnapshotData;\n    /** When the contact was copied. */\n    savedAt?: string;\n}\n\nexport interface FulfillmentContactSnapshotData {\n    /** The customer the contact belonged to when the order was sent, or null. */\n    company?: SparseCustomer | null;\n    /** The contact's email address when the order was sent, or null. */\n    email?: string | null;\n    /** The contact's first name when the order was sent, or null. */\n    firstName?: string | null;\n    /** The contact's last name when the order was sent, or null. */\n    lastName?: string | null;\n    /** The contact's phone number when the order was sent, or null. */\n    phone?: string | null;\n}\n\nexport interface FulfillmentCycleTime {\n    /** The days from the order's creation until it opened, or null while it has not opened. */\n    createdToOpenedDays?: string | null;\n    /** The days from the first shipment shipping until the order closed, or null until both happen. */\n    firstShipmentShippedToCloseDays?: string | null;\n    /** The days from the order opening until its first shipment shipped, or null until both happen. */\n    openToFirstShipmentShippedDays?: string | null;\n}\n\nexport interface FulfillmentItem {\n    /** The ID of the physical item the line asks for, which may appear on only one line. */\n    itemId: string;\n    /** How many units of the item the order asks for, above 0. */\n    requestedQuantity: number;\n}\n\nexport interface FulfillmentListing {\n    /** The page of records. */\n    results?: FulfillmentOrder[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\nexport interface FulfillmentOrder {\n    /** Why the order was cancelled, or null while it has not been. */\n    cancellationReason?: string | null;\n    /** When the order was cancelled, or null while it has not been. */\n    cancelledAt?: string | null;\n    /** Who cancelled the order, or null while it has not been cancelled. */\n    cancelledBy?: SparsePerson | null;\n    /** When the order closed, or null while it is open. */\n    closedAt?: string | null;\n    /** What closed the order: SHIPMENT_COMPLETE, MANUAL_CLOSE, THIRD_PARTY_FIN or CANCELLED, or null while it is open. */\n    closedAtSource?: FulfillmentOrderClosedAtSource | null;\n    /** Who closed the order by hand, or null when it closed on its own or is open. */\n    closedBy?: SparsePerson | null;\n    /** The person at the destination the order is for, or null. */\n    contact?: SparseContact | null;\n    /** When the order was created. */\n    createdAt?: string;\n    /** Who created the order. */\n    createdBy?: SparsePerson;\n    /** How long the order spent in each stage. */\n    cycleTime?: FulfillmentCycleTime;\n    /** The exchange the order is part of, or null when it is not part of one. */\n    exchangeGroup?: SparseExchangeGroup | null;\n    /** How many files are attached to the order. */\n    fileCount?: number;\n    /** When the order's first outbound shipment was created, cancelled shipments included, or null while it has none. */\n    firstShipmentOpenedAt?: string | null;\n    /** When the order's first outbound shipment shipped, cancelled shipments included, or null while none has. */\n    firstShipmentShippedAt?: string | null;\n    /** Where the order ships from. */\n    fromLocation?: SparseLocationWithIntegration | null;\n    /** The number the fulfillment order is known by. */\n    fulfillmentOrderNumber?: string;\n    /** The fulfillment order's unique identifier. */\n    id?: string;\n    /** The order's line items. */\n    items?: FulfillmentOrderItem[];\n    /** The fulfillment order's key, which the fulfillment endpoints take as fulfillmentKey. */\n    key?: string;\n    /** When the order's latest outbound shipment was created, cancelled shipments included, or null while it has none. */\n    lastShipmentOpenedAt?: string | null;\n    /** When the order's latest outbound shipment shipped, cancelled shipments included, or null while none has. */\n    lastShipmentShippedAt?: string | null;\n    /** When the order last changed. */\n    lastUpdatedAt?: string;\n    /** Who last changed the order. */\n    lastUpdatedBy?: SparsePerson;\n    /** When the order's latest shipment that is not cancelled was delivered, or null while none has been. */\n    mostRecentDeliveredAt?: string | null;\n    /** When the order's latest shipment that is not cancelled shipped, or null while none has. */\n    mostRecentShippedAt?: string | null;\n    /** When the order opened, which is when it was sent to a 3PL or when its first shipment was created, or null while it has not. */\n    openedAt?: string | null;\n    /** What Hardfin sent to a 3PL with the order, or null when it was never sent. */\n    orderDataSnapshot?: FulfillmentOrderDataSnapshot | null;\n    /** The note written about the order, or null. */\n    orderNotes?: string | null;\n    /** The project the order fills, or null when it fills none. */\n    project?: SparseProject | null;\n    /** The day the order is promised to arrive, or null when no one has said. */\n    promiseDeliveryDate?: string | null;\n    /** The day the order is promised to ship, or null when no one has said. */\n    promiseShipDate?: string | null;\n    /** Where the order stands: DRAFT, AWAITING_3PL, CANCELLED, or OPEN, SHIPPED or DELIVERED, each PARTIAL, FULL or OVERAGE against the requested quantities. */\n    status?: FulfillmentOrderStatus;\n    /** The order's fulfillment by a third-party logistics (3PL) provider and its sync state. */\n    thirdParty?: FulfillmentThirdParty;\n    /** Where the order ships to. */\n    toLocation?: SparseLocationWithIntegration | null;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type FulfillmentOrderClosedAtSource = \"CANCELLED\" | \"MANUAL_CLOSE\" | \"SHIPMENT_COMPLETE\" | \"THIRD_PARTY_FIN\";\n\nexport interface FulfillmentOrderDataSnapshot {\n    /** The contact as it stood when the order was sent to a 3PL, or null when the order named none. */\n    contact?: FulfillmentContactSnapshot | null;\n}\n\nexport interface FulfillmentOrderItem {\n    /** How many units are on shipments that have been delivered. */\n    deliveredQuantity?: number;\n    /** The line item's unique identifier. */\n    id?: string;\n    /** The item the line asks for. */\n    item?: SparseItem;\n    /** The line item's key. */\n    key?: string;\n    /** How many units sit on the order's outbound shipments that have not shipped. */\n    pendingQuantity?: number;\n    /** How many units a 3PL reported under a serial that conflicts with the asset record, held until someone resolves them. */\n    quarantinedQuantity?: number;\n    /** How many units of the item the order asks for. */\n    requestedQuantity?: number;\n    /** How many units are on shipments that have shipped and not yet been delivered. */\n    shippedQuantity?: number;\n    /** How far the line's units have got, such as OPEN_PARTIAL or DELIVERED_FULL, and DRAFT while the order is a draft. */\n    status?: FulfillmentOrderLineItemStatus;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type FulfillmentOrderLineItemStatus = \"DELIVERED_FULL\" | \"DELIVERED_OVERAGE\" | \"DELIVERED_PARTIAL\" | \"DRAFT\" | \"OPEN_FULL\" | \"OPEN_OVERAGE\" | \"OPEN_PARTIAL\" | \"SHIPPED_FULL\" | \"SHIPPED_OVERAGE\" | \"SHIPPED_PARTIAL\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type FulfillmentOrderStatus = \"AWAITING_3PL\" | \"CANCELLED\" | \"DELIVERED_FULL\" | \"DELIVERED_OVERAGE\" | \"DELIVERED_PARTIAL\" | \"DRAFT\" | \"OPEN_FULL\" | \"OPEN_OVERAGE\" | \"OPEN_PARTIAL\" | \"SHIPPED_FULL\" | \"SHIPPED_OVERAGE\" | \"SHIPPED_PARTIAL\";\n\nexport interface FulfillmentThirdParty {\n    /** Whether the last sync with the 3PL provider failed. */\n    hasSyncError?: boolean;\n    /** Whether the order was sent to a 3PL provider, which then ships it. */\n    isEnabled?: boolean;\n    /** When Hardfin last checked the order with its 3PL provider, or null when it has never checked. */\n    lastSyncedAt?: string | null;\n    /** When the 3PL provider last reported a change to the order, or null when it has reported none. */\n    lastUpdateAt?: string | null;\n    /** Why the last sync with the 3PL provider failed, or null when it did not. */\n    syncErrorMessage?: string | null;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type IntegrationCategory = \"CRM\" | \"ERP\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type IntegrationID = \"HUBSPOT\" | \"NETSUITE\" | \"NONE\" | \"QBO\" | \"SFDC\";\n\nexport interface Item {\n    /** Whether a BULK item records serial numbers on its units, which is false for SERVICE and DEVICE items. */\n    acceptsBulkSerials?: boolean;\n    /** The number of assets of a DEVICE item, and null for other types. */\n    assetCount?: number | null;\n    /** A free-form description of the item. */\n    description?: string | null;\n    /** The item's unique identifier. */\n    id?: string;\n    /** The item's links to integrated systems. */\n    integrations?: SharedIntegration[];\n    /** Whether the item is archived. */\n    isArchived?: boolean;\n    /** The item's key, which the item endpoints take as itemKey. */\n    key?: string;\n    /** When the item was last changed. */\n    lastUpdatedAt?: string | null;\n    /** The person who last changed the item. */\n    lastUpdatedBy?: SparsePerson;\n    /** The item's display name. */\n    name?: string;\n    /** Whether the item's units carry serial numbers, which is true for a DEVICE item and for a BULK item that accepts serials. */\n    shouldRenderSerialFields?: boolean;\n    /** The item's stock keeping unit, unique within your organization. */\n    sku?: string;\n    /** SERVICE for a non-physical item, DEVICE for a physical item tracked by serial number, or BULK for a part tracked by quantity. */\n    type?: FrontendItemType;\n}\n\nexport interface ItemAccounting {\n    /** The default share of overhead for one unit. */\n    allocatedIndirect?: Currency | null;\n    /** The default parts cost for one unit. */\n    billOfMaterials?: Currency | null;\n    /** The ISO 4217 code the default cost amounts are denominated in, or null when none is recorded. */\n    costCurrencyCode?: CurrencyCode | null;\n    /** The default method one unit is depreciated by. */\n    depreciationModel?: Depreciation;\n    /** The default labor cost to build one unit. */\n    directLabor?: Currency | null;\n    /** The default shipping cost to receive one unit. */\n    freightInbound?: Currency | null;\n    /** The default shipping cost to deliver one unit. */\n    freightOutbound?: Currency | null;\n    /** The default cost to install one unit. */\n    installation?: Currency | null;\n    /** The default financing cost for one unit. */\n    interest?: Currency | null;\n    /** The default value one unit keeps at the end of its useful life. */\n    salvageValue?: Currency | null;\n    /** A single default cost for one unit, used instead of the cost components. */\n    simpleCostBasis?: Currency | null;\n    /** The default import duty paid on one unit. */\n    tariffs?: Currency | null;\n    /** The default tax paid on one unit. */\n    tax?: Currency | null;\n    /** The default cost of goods sold for one unit, which is the simple cost basis when set and otherwise the sum of the cost components. */\n    totalCOGS?: Currency | null;\n    /** The default number of months one unit is depreciated over. */\n    usefulLife?: number | null;\n}\n\nexport interface ItemBOMItem {\n    /** The BULK part the bill of materials uses. */\n    item?: SparseItem;\n    /** The number of the part one unit of the item uses. */\n    quantity?: number;\n}\n\nexport interface ItemDetail {\n    /** Whether a BULK item records serial numbers on its units, which is false for SERVICE and DEVICE items. */\n    acceptsBulkSerials?: boolean;\n    /** The default costs and depreciation for a unit of a DEVICE or BULK item. */\n    accounting?: ItemAccounting;\n    /** The number of assets of a DEVICE item, and null for other types. */\n    assetCount?: number | null;\n    /** The bill of materials, the BULK parts one unit of the item is built from, or null when it has none. */\n    bom?: ItemBOMItem[] | null;\n    /** The pricing a project line item's billing plan starts from when it sells the item, or null when the item has none. */\n    defaultPricing?: ItemPricing | null;\n    /** A free-form description of the item. */\n    description?: string | null;\n    /** The custom fields each asset of a DEVICE item can hold. */\n    fields?: ItemField[];\n    /** Whether each unit of the item is tracked as its own asset, which is true for a DEVICE item. */\n    hasAssets?: boolean;\n    /** The item's unique identifier. */\n    id?: string;\n    /** The item's links to integrated systems. */\n    integrations?: SharedIntegration[];\n    /** The number of inventory movements of a BULK item, and null for other types. */\n    inventoryMovementCount?: number | null;\n    /** Whether the item is archived. */\n    isArchived?: boolean;\n    /** Whether the item is physical, which is true for DEVICE and BULK items. */\n    isPhysical?: boolean;\n    /** The item's key, which the item endpoints take as itemKey. */\n    key?: string;\n    /** When the item was last changed. */\n    lastUpdatedAt?: string | null;\n    /** The person who last changed the item. */\n    lastUpdatedBy?: SparsePerson;\n    /** The item's display name. */\n    name?: string;\n    /** Whether the item's units carry serial numbers, which is true for a DEVICE item and for a BULK item that accepts serials. */\n    shouldRenderSerialFields?: boolean;\n    /** The item's stock keeping unit, unique within your organization. */\n    sku?: string;\n    /** SERVICE for a non-physical item, DEVICE for a physical item tracked by serial number, or BULK for a part tracked by quantity. */\n    type?: FrontendItemType;\n}\n\nexport interface ItemField {\n    /** The field's unique identifier. */\n    id?: string;\n    /** The field's key, which the item field endpoints take as fieldKey. */\n    key?: string;\n    /** The field's display name. */\n    label?: string;\n    /** The number of assets that hold a value for the field. */\n    metadataCount?: number;\n    /** The field's position within its section, starting at 0. */\n    order?: number;\n    /** The group the field is shown in, starting at 0. */\n    section?: number;\n    /** The kind of value the field holds. */\n    type?: ItemFieldType;\n}\n\nexport interface ItemFieldOrderingUpdateItem {\n    /** The ID of the item field to move. */\n    fieldId: string;\n    /** The field's position within its section, starting at 0. */\n    order?: number;\n    /** The group the field is shown in, starting at 0. */\n    section?: number;\n}\n\n/** The kind of value an item's custom field holds. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ItemFieldType = \"BOOLEAN\" | \"DATE\" | \"DATE_TIME\" | \"INTEGER\" | \"MULTILINE_TEXT\" | \"NUMBER\" | \"TEXT\" | \"TIME\";\n\nexport interface ItemListing {\n    /** The page of records. */\n    results?: Item[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\nexport interface ItemPricing {\n    /** How often a PERIODIC charge recurs. */\n    chargeFrequency?: BillingFrequency | null;\n    /** PERIODIC to charge on a recurring cadence, or MILESTONE to charge when a milestone is reached. */\n    chargeSchedule?: BillingSchedule | null;\n    /** The default price for the whole line, used when pricingMode is FIXED. */\n    fixedPrice?: Currency | null;\n    /** How often the charges are invoiced. */\n    invoiceFrequency?: BillingFrequency | null;\n    /** ADVANCE to invoice a period before it starts, or ARREARS to invoice it after it ends. */\n    invoiceMode?: BillingTiming | null;\n    /** PER_UNIT to charge the unit price for each unit, or FIXED to charge the fixed price for the line whatever its quantity. */\n    pricingMode?: PricingMode | null;\n    /** The default price for each unit, used when pricingMode is PER_UNIT. */\n    unitPrice?: Currency | null;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ItemType = \"marked_bulk\" | \"service\" | \"tracked_device\" | \"unmarked_bulk\";\n\nexport type Location = SparseLocationWithIntegration & {\n    /** The number of active projects at the location. */\n    activeProjectCount?: number;\n    /** The number of assets currently at the location. */\n    assetCount?: number;\n    /** The number of incomplete projects at the location. */\n    incompleteProjectCount?: number;\n    /** The number of past projects at the location. */\n    pastProjectCount?: number;\n    /** The number of upcoming projects at the location. */\n    upcomingProjectCount?: number;\n};\n\nexport interface LocationListing {\n    /** The page of records. */\n    results?: Location[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type LocationType = \"SITE\" | \"ZONE\" | null;\n\nexport interface Metadata {\n    errors: Error[] | null;\n    /** What the client should know about its request, beside any error. A notice never fails a request. */\n    notices?: Notice[];\n    /** The identifier to quote when asking Hardfin about this request. */\n    requestId: string;\n    /** How long the server took to answer. */\n    requestTime: string;\n    statusCode: number;\n}\n\nexport interface MetadataLocationComponents {\n    /** The first line of the street address. */\n    addressLine1?: string | null;\n    /** The second line of the street address, such as a suite. */\n    addressLine2?: string | null;\n    /** The city. */\n    city?: string | null;\n    /** The country. */\n    country?: string | null;\n    /** The whole address on one line. */\n    formattedAddress?: string | null;\n    /** The postal or ZIP code. */\n    postalCode?: string | null;\n    /** The state or region. */\n    state?: string | null;\n}\n\nexport interface MetadataLocationSite {\n    /** The location's structured address, which a zone reads from its parent site. */\n    address?: MetadataLocationComponents | null;\n    /** Google's place ID for the address, when it was found through Google. */\n    googlePlaceId?: string | null;\n    /** The location's latitude, sent as a decimal string. */\n    latitude?: string | null;\n    /** The location's longitude, sent as a decimal string. */\n    longitude?: string | null;\n    /** The person or business that receives shipments at the location. */\n    shippingName?: string | null;\n}\n\nexport interface MetadataMilestonePhaseEntry {\n    /** The phase's name, which its charge takes as a label, 255 characters or less. */\n    name?: string;\n    /** The share of the line item's total the phase bills, from 0 to 100. */\n    percentage?: string | null;\n}\n\nexport interface MetadataMilestonePhases {\n    /** The phases, in order. */\n    entries?: MetadataMilestonePhaseEntry[];\n    /** PERCENTAGE, the only way a phase's share is expressed. */\n    mode?: string;\n}\n\nexport interface NonNegativeCurrency {\n    /** The exact value as a decimal string with at least two decimal places, which cannot be negative. */\n    amount?: string;\n    /** The value's ISO 4217 currency code. */\n    isoCode?: CurrencyCode;\n}\n\nexport interface Notice {\n    /** What the notice is about. API_VERSION_OUTDATED means an earlier version of the endpoint answered, because X-API-Version is behind its last change. Ignore a code that is not recognized. */\n    code: string;\n    /** The X-API-Version to move to so the notice stops. */\n    latestVersion: string;\n    message: string;\n}\n\nexport interface PaymentTerm {\n    /** The payment term's identifier. */\n    id?: string;\n    /** The payment term's key. */\n    key?: string;\n    /** The payment term's name as people read it. */\n    label?: string;\n    /** The number of days after the invoice date that payment is due. */\n    netDays?: number;\n    /** The payment term's machine name. */\n    value?: string;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type PricingMode = \"FIXED\" | \"PER_UNIT\";\n\nexport type Project = SparseProject & {\n    /** The day the customer accepted the project. */\n    acceptanceDate?: string | null;\n    /** The workflow the project is on, with the project's current stage marked active, or null when it has no workflow. */\n    activeWorkflow?: SparseActiveWorkflow | null;\n    /** The project's annual recurring revenue, with one total for each currency its recurring line items are priced in. */\n    annualRecurringRevenue?: Currency[];\n    /** The billing address the project's invoices use in place of the customer's. */\n    billingAddress?: string | null;\n    /** The billing contact email the project's invoices use in place of the customer's. */\n    billingContactEmail?: string | null;\n    /** The billing contact name the project's invoices use in place of the customer's. */\n    billingContactName?: string | null;\n    /** The billing contact phone number the project's invoices use in place of the customer's. */\n    billingContactPhone?: string | null;\n    /** The number of charges on the project's line items. */\n    chargeCount?: number;\n    /** What follows the project for its customer: it was renewed, the customer kept a later-ending project, or nothing followed. */\n    completionClassification?: ProjectCompletionClassification;\n    /** The day the contract was signed. */\n    contractSignedOn?: string | null;\n    /** The number of costs recorded against the project. */\n    costCount?: number;\n    /** The project's single currency and the field that established it, or null when no currency-bearing field is set. */\n    currency?: ProjectCurrency | null;\n    /** The customer the project is for. */\n    customer?: SparseCustomer | null;\n    /** The project's default location, which counts among its locations even when no line item names it. */\n    defaultLocation?: SparseLocationWithParent | null;\n    /** The project's description. */\n    description?: string | null;\n    /** The discount applied to the project. */\n    discount?: Currency | null;\n    /** The number of files attached to the project. */\n    fileCount?: number;\n    /** The day the project goes live. */\n    goLiveDate?: string | null;\n    /** The day of the installation. */\n    installDate?: string | null;\n    /** The number of the project's charges that have been invoiced. */\n    invoicedChargeCount?: number;\n    /** The project's line items, each an item the project sells or provides as a service. */\n    items?: ProjectLineItem[];\n    /** Every location the project names: the ones its line items ask for, and its default location. */\n    locations?: SparseLocationWithParent[];\n    /** The memo new invoices for the project carry. */\n    memo?: string | null;\n    /** The number of notes on the project. */\n    noteCount?: number;\n    /** The project's payment term. */\n    paymentTerm?: PaymentTerm | null;\n    /** The project this one renews. */\n    previousProject?: SparseProject | null;\n    /** Whether the items the project asks for have been fulfilled, judged across all of its line items. */\n    projectFulfillmentStatus?: ProjectFulfillmentStatus;\n    /** The customer's purchase order number, which new invoices for the project carry. */\n    purchaseOrderNumber?: string | null;\n    /** The day of the site visit. */\n    siteVisitDate?: string | null;\n    /** How the project relates to the customer's earlier projects: a renewal of a prior project, new business, or an expansion. */\n    startClassification?: ProjectStartClassification;\n    /** The number of tickets on the project. */\n    ticketCount?: number;\n    /** The number of time activities recorded against the project. */\n    timeActivityCount?: number;\n    /** The contract's total value, as entered on the project. */\n    totalContractValue?: Currency | null;\n    /** The day of the training. */\n    trainingDate?: string | null;\n    /** The number of URL links attached to the project. */\n    urlLinkCount?: number;\n};\n\nexport interface ProjectChargeRequestItem {\n    /** The day the charge is planned to become billable, or null when it has no dates yet. */\n    expectedBillableDate?: string | null;\n    /** The charge to update, or null to add a new one, and no two charges in the list send the same one. */\n    id?: string | null;\n    /** True when a person added, edited or split the charge, and false when it follows the line item's billing plan unchanged. */\n    isCustomModified?: boolean;\n    /** The charge's display name, such as the period it covers or the milestone it follows, which is required and 255 characters or less once the spaces around it are trimmed. */\n    label?: string;\n    /** PER_UNIT when the charge bills a unit price for each unit, or FIXED when it bills a flat amount. */\n    pricingMode?: PricingMode;\n    /** The number of units the charge bills, which is at least 1 when unitPrice is sent and 2,147,483,647 or less. */\n    quantity?: number;\n    /** The charge's position among its line item's charges, in ascending order, which is zero or more and sent by one charge in the list. */\n    sequence?: number;\n    /** The last day of the period the charge covers, on or after servicePeriodStart. */\n    servicePeriodEnd?: string | null;\n    /** The first day of the period the charge covers, or null when the charge has no dates yet. */\n    servicePeriodStart?: string | null;\n    /** The charge's status: PLANNED, BILLABLE, INVOICED or CANCELLED. A charge becomes billable, invoiced or cancelled only through its own actions, so a new charge must be sent as PLANNED and a stored charge may keep its status or go back to PLANNED, which clears its billable and cancellation details. */\n    status?: ChargeStatus;\n    /** The amount the charge bills, which equals unitPrice times quantity when unitPrice is sent. */\n    totalPrice?: NonNegativeCurrency;\n    /** TIME when the charge becomes billable on expectedBillableDate, or MANUAL when a person marks it billable, and is TIME when omitted. */\n    triggerType?: ChargeTriggerType;\n    /** The price of one unit, in the currency of totalPrice, and is null on a FIXED charge. */\n    unitPrice?: NonNegativeCurrency | null;\n}\n\n/** What follows a project for its customer when it ends. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ProjectCompletionClassification = \"CHURN\" | \"CONTRACTION\" | \"RENEWED\";\n\nexport interface ProjectCurrency {\n    /** The ISO 4217 code of the project's currency. */\n    isoCode?: CurrencyCode;\n    /** What fixed the project's currency: an invoiced charge, the contract value, the line items, or the discount. */\n    source?: ProjectCurrencySource;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ProjectCurrencySource = \"DISCOUNT\" | \"INVOICED_CHARGE\" | \"LINE_ITEMS\" | \"PROJECT_VALUE\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ProjectFulfillmentStatus = \"FULFILLED\" | \"OVER_FULFILLED\" | \"PARTIALLY_FULFILLED\" | \"UNFULFILLED\";\n\nexport interface ProjectItemBinding {\n    /** The day a periodic line item's charge schedule is anchored on, which defaults to startOn. */\n    activationDate?: string | null;\n    /** The identifier that makes line items consecutive phases of one commitment when they send the same one, and is assigned when a new line item omits it. */\n    aggregationKey?: string;\n    /** The line item's single billing cadence, which fills chargeFrequency and invoiceFrequency on a periodic line item that omits them. */\n    billingFrequency?: BillingFrequency | null;\n    /** How often a periodic line item creates a charge, and is refused unless chargeSchedule is PERIODIC. */\n    chargeFrequency?: BillingFrequency | null;\n    /** PERIODIC when charges recur at a regular frequency, or MILESTONE when each charge follows a project milestone. */\n    chargeSchedule?: BillingSchedule | null;\n    /** A free-form note about the line item, 65,536 characters or less. */\n    details?: string | null;\n    /** The last day of the line item's service window, on or after startOn. A line item's dates change only through the project, because the line item update does not take them. */\n    endOn?: string | null;\n    /** The flat price when pricingMode is FIXED, and is not sent together with unitPrice. */\n    fixedPrice?: NonNegativeCurrency | null;\n    /** The line item to update, or omitted to add a new one. */\n    id?: string | null;\n    /** How often a periodic line item's charges are invoiced, which is never more often than chargeFrequency. */\n    invoiceFrequency?: BillingFrequency | null;\n    /** ADVANCE to invoice a period before it starts, or ARREARS to invoice it after it ends, and is refused unless chargeSchedule is PERIODIC. */\n    invoiceMode?: BillingTiming | null;\n    /** The catalog item the line item is for. */\n    itemId: string;\n    /** The location the line item is for. */\n    locationId?: string | null;\n    /** The named phases of a milestone line item and each one's share of its total. */\n    milestonePhases?: MetadataMilestonePhases | null;\n    /** PER_UNIT to charge the unit price for each unit, or FIXED to charge the fixed price whatever the quantity. */\n    pricingMode?: PricingMode | null;\n    /** The number of units the line item covers, which is zero or more. */\n    quantity?: number;\n    /** The first day of the line item's own service window, sent together with endOn. A line item's dates change only through the project, because the line item update does not take them. */\n    startOn?: string | null;\n    /** A negotiated total for a periodic line item that replaces the computed one, in the project's currency. */\n    totalOverride?: NonNegativeCurrency | null;\n    /** SALE to sell the item, which only a physical item allows, or SERVICE to provide it as a service. */\n    transactionType: TransactionType;\n    /** The price of one unit for each charge, and is not sent together with fixedPrice. */\n    unitPrice?: NonNegativeCurrency | null;\n}\n\nexport interface ProjectLineItem {\n    /** The day a periodic line item's charge schedule is anchored on, or null while chargeMode is PENDING and on a milestone line item. */\n    activationDate?: string | null;\n    /** The identifier shared by line items that are consecutive phases of one commitment, and unique to a line item that stands alone. */\n    aggregationKey?: string;\n    /** The line item's single billing cadence, which predates chargeFrequency and invoiceFrequency. */\n    billingFrequency?: BillingFrequency | null;\n    /** How often a periodic line item creates a charge, and is null on a milestone line item. */\n    chargeFrequency?: BillingFrequency | null;\n    /** CONFIRMED when the line item's charges carry dates, or PENDING when its activation date is not yet known and they do not. */\n    chargeMode?: ChargeMode;\n    /** PERIODIC when charges recur at a regular frequency, or MILESTONE when each charge follows a project milestone, and is null until the line item has a billing plan. */\n    chargeSchedule?: BillingSchedule | null;\n    /** The line item's charges, in sequence order. */\n    charges?: Charge[];\n    /** A free-form note about the line item. */\n    details?: string | null;\n    /** The last day of the line item's service window. */\n    endOn?: string | null;\n    /** The flat price when pricingMode is FIXED: the amount of each charge on a periodic line item, and the total its phases split on a milestone one. */\n    fixedPrice?: Currency | null;\n    /** True when any of the line item's charges is invoiced, which stops the line item from being removed. */\n    hasInvoicedCharges?: boolean;\n    /** The line item's unique identifier. */\n    id?: string;\n    /** How often a periodic line item's charges are invoiced, which is never more often than chargeFrequency. */\n    invoiceFrequency?: BillingFrequency | null;\n    /** ADVANCE to invoice a period before it starts, or ARREARS to invoice it after it ends, on a periodic line item. */\n    invoiceMode?: BillingTiming | null;\n    /** The catalog item the line item is for. */\n    item?: SparseItem;\n    /** The line item's key. */\n    key?: string;\n    /** The location the line item is for, or null when it has none. */\n    location?: SparseLocationWithParent | null;\n    /** The named phases of a milestone line item and each one's share of its total, or null on any other line item. */\n    milestonePhases?: MetadataMilestonePhases | null;\n    /** The line item's position among the line items sharing its aggregationKey, counted from 1 in order of startOn. */\n    phaseRowNumber?: number;\n    /** PER_UNIT to charge the unit price for each unit, or FIXED to charge the fixed price whatever the quantity, and is null until the line item has a billing plan. */\n    pricingMode?: PricingMode | null;\n    /** The number of units the line item covers. */\n    quantity?: number | null;\n    /** The first day of the line item's own service window, or null when it has no dates. */\n    startOn?: string | null;\n    /** A negotiated total for a periodic line item that replaces the computed one, or null to use the computed total. */\n    totalOverride?: Currency | null;\n    /** SALE when the item is sold, or SERVICE when it is provided as a service. */\n    transactionType?: TransactionType;\n    /** The price of one unit for each charge, or null when the line item is priced at a fixed price. */\n    unitPrice?: Currency | null;\n}\n\nexport interface ProjectListing {\n    /** The page of records. */\n    results?: Project[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\n/** How a project relates to the customer's earlier projects when it starts. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ProjectStartClassification = \"EXPANSION\" | \"NEW_BUSINESS\" | \"RENEWAL\";\n\n/** Where a project stands against its dates, which is computed and never stored. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ProjectStatus = \"ACTIVE\" | \"DATE_RANGE_INCOMPLETE\" | \"PAST\" | \"UPCOMING\";\n\n/** A project status the project list and the fulfillment report filter by. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ProjectStatusFilter = \"ACTIVE\" | \"DATE_RANGE_INCOMPLETE\" | \"PAST\" | \"UPCOMING\";\n\nexport interface PurchaseOrder {\n    /** Why the order was cancelled, or null while it has not been. */\n    cancellationReason?: string | null;\n    /** When the order was cancelled, or null while it has not been. */\n    cancelledAt?: string | null;\n    /** Who cancelled the order, or null while it has not been cancelled. */\n    cancelledBy?: SparsePerson | null;\n    /** The carrier the supplier ships the order with, or null when none is named. */\n    carrier?: CarrierDetails | null;\n    /** When the order was created. */\n    createdAt?: string;\n    /** Who created the order. */\n    createdBy?: SparsePerson;\n    /** The supplier's own number for the order, or null when it has none. */\n    externalPurchaseOrderNumber?: string | null;\n    /** The number of files attached to the order. */\n    fileCount?: number;\n    /** The location the supplier ships from, or null when none is on record. */\n    fromLocation?: SparseLocationWithIntegration | null;\n    /** The purchase order's unique identifier. */\n    id?: string;\n    /** The order's lines. */\n    items?: PurchaseOrderLineItem[];\n    /** The purchase order's key, which the purchase order endpoints take as purchaseOrderKey. */\n    key?: string;\n    /** When the order last changed. */\n    lastUpdatedAt?: string;\n    /** Who last changed the order. */\n    lastUpdatedBy?: SparsePerson;\n    /** When an inbound shipment for the order was last delivered, or null while none has been. */\n    mostRecentDeliveredAt?: string | null;\n    /** When an inbound shipment for the order was last received, or null while none has been. */\n    mostRecentReceivedAt?: string | null;\n    /** When an inbound shipment for the order last shipped, or null while none has. */\n    mostRecentShippedAt?: string | null;\n    /** A note about the order, or null. */\n    orderNotes?: string | null;\n    /** The day the supplier promised the order would arrive, or null when it has not said. */\n    promiseDeliveryDate?: string | null;\n    /** The day the supplier promised to ship the order, or null when it has not said. */\n    promiseShipDate?: string | null;\n    /** The number the purchase order is known by, which an inbound shipment names to fill it. */\n    purchaseOrderNumber?: string;\n    /** Where the order is in its life, by the furthest stage any of its lines has reached on the order's inbound shipments. */\n    status?: PurchaseOrderStatus;\n    /** The company the items are ordered from. */\n    supplier?: SparseCustomer;\n    /** The order's receiving by a third-party logistics (3PL) provider and its sync state. */\n    thirdParty?: PurchaseOrderThirdParty;\n    /** The location the order is delivered to. */\n    toLocation?: SparseLocationWithIntegration;\n}\n\nexport interface PurchaseOrderItem {\n    /** The ID of the physical item the line orders, which may appear on only one line. */\n    itemId: string;\n    /** How many units of the item to order, which must be greater than 0. */\n    requestedQuantity: number;\n}\n\nexport interface PurchaseOrderLineItem {\n    /** How many units are on the order's inbound shipments that have been delivered and not yet received. */\n    deliveredQuantity?: number;\n    /** The line's unique identifier. */\n    id?: string;\n    /** The item the line orders. */\n    item?: SparseItem;\n    /** The line's key. */\n    key?: string;\n    /** How many units are on the order's inbound shipments that have not yet shipped. */\n    openQuantity?: number;\n    /** How many units have been received on the order's inbound shipments. */\n    receivedQuantity?: number;\n    /** How many units of the item were ordered. */\n    requestedQuantity?: number;\n    /** How many units are on the order's inbound shipments that have shipped and not yet been delivered. */\n    shippedQuantity?: number;\n    /** The furthest stage the line's units have reached on the order's inbound shipments, and whether fewer, exactly, or more units than were ordered reached it. */\n    status?: PurchaseOrderLineItemStatus;\n}\n\n/** The status of a line item on a purchase order. Accepted in any case. The listed spelling is the one the API sends back. | Value | Description | | --- | --- | | `DELIVERED_FULL` | The ordered units have been delivered | | `DELIVERED_OVERAGE` | More units than were ordered have been delivered | | `DELIVERED_PARTIAL` | Fewer units than were ordered have been delivered | | `DRAFT` | None of the line's units are on a shipment yet | | `OPEN_FULL` | The ordered units are on shipments that have not left | | `OPEN_OVERAGE` | More units than were ordered are on shipments that have not left | | `OPEN_PARTIAL` | Fewer units than were ordered are on shipments that have not left | | `RECEIVED_FULL` | The ordered units have been received | | `RECEIVED_OVERAGE` | More units than were ordered have been received | | `RECEIVED_PARTIAL` | Fewer units than were ordered have been received | | `SHIPPED_FULL` | The ordered units have shipped | | `SHIPPED_OVERAGE` | More units than were ordered have shipped | | `SHIPPED_PARTIAL` | Fewer units than were ordered have shipped | */\nexport type PurchaseOrderLineItemStatus = \"DELIVERED_FULL\" | \"DELIVERED_OVERAGE\" | \"DELIVERED_PARTIAL\" | \"DRAFT\" | \"OPEN_FULL\" | \"OPEN_OVERAGE\" | \"OPEN_PARTIAL\" | \"RECEIVED_FULL\" | \"RECEIVED_OVERAGE\" | \"RECEIVED_PARTIAL\" | \"SHIPPED_FULL\" | \"SHIPPED_OVERAGE\" | \"SHIPPED_PARTIAL\";\n\nexport interface PurchaseOrderListing {\n    /** The page of records. */\n    results?: PurchaseOrder[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\nexport interface PurchaseOrderResync3PLFilesResult {\n    /** How many of those files the 3PL did not accept, which a later resync tries again. */\n    failedFiles?: number;\n    /** How many of those files the 3PL accepted. */\n    successfulFiles?: number;\n    /** How many of the order's files the 3PL had not yet received. */\n    totalFiles?: number;\n}\n\n/** The status of a purchase order. Accepted in any case. The listed spelling is the one the API sends back. | Value | Description | | --- | --- | | `AWAITING_3PL` | The order was sent to a third-party logistics provider, which has not yet reported a shipment | | `CANCELLED` | The order was cancelled | | `DELIVERED_FULL` | Every line's ordered units have been delivered | | `DELIVERED_OVERAGE` | Every line's ordered units have been delivered, and some line delivered more than was ordered | | `DELIVERED_PARTIAL` | Units have been delivered, and not every line has been delivered in full | | `DRAFT` | No units are on a shipment yet, and the order can still be edited or cancelled | | `OPEN_FULL` | Every line's ordered units are on shipments that have not left | | `OPEN_OVERAGE` | Every line's ordered units are on shipments that have not left, and some line has more than was ordered | | `OPEN_PARTIAL` | Units are on shipments that have not left, and not every line is there in full | | `RECEIVED_FULL` | Every line's ordered units have been received | | `RECEIVED_OVERAGE` | Every line's ordered units have been received, and some line received more than was ordered | | `RECEIVED_PARTIAL` | Units have been received, and not every line has been received in full | | `SHIPPED_FULL` | Every line's ordered units have shipped | | `SHIPPED_OVERAGE` | Every line's ordered units have shipped, and some line shipped more than was ordered | | `SHIPPED_PARTIAL` | Units have shipped, and not every line has shipped in full | */\nexport type PurchaseOrderStatus = \"AWAITING_3PL\" | \"CANCELLED\" | \"DELIVERED_FULL\" | \"DELIVERED_OVERAGE\" | \"DELIVERED_PARTIAL\" | \"DRAFT\" | \"OPEN_FULL\" | \"OPEN_OVERAGE\" | \"OPEN_PARTIAL\" | \"RECEIVED_FULL\" | \"RECEIVED_OVERAGE\" | \"RECEIVED_PARTIAL\" | \"SHIPPED_FULL\" | \"SHIPPED_OVERAGE\" | \"SHIPPED_PARTIAL\";\n\nexport interface PurchaseOrderThirdParty {\n    /** Whether the last sync with the 3PL provider failed. */\n    hasSyncError?: boolean;\n    /** Whether the order was sent to a 3PL provider, which then receives it and keeps it from being edited. */\n    isEnabled?: boolean;\n    /** When Hardfin last checked the order with its 3PL provider, or null when it has never checked. */\n    lastSyncedAt?: string | null;\n    /** When the 3PL provider last reported a change to the order, or null when it has reported none. */\n    lastUpdateAt?: string | null;\n    /** Why the last sync with the 3PL provider failed, or null when it did not. */\n    syncErrorMessage?: string | null;\n}\n\n/** The condition that stops a resolution the hold's type allows from running. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type QuarantineResolutionBlockReason = \"SERIAL_ALREADY_TAKEN\";\n\n/** How a user resolved a quarantined serial. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type QuarantineResolutionKind = \"ACCEPTED_SERIAL\" | \"CORRECTED_SERIAL\" | \"CREATED_ASSET\" | \"KEPT_HARDFIN_ITEM\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type QuarantineType = \"DUPLICATE_ALREADY_EXISTS\" | \"DUPLICATE_IN_ORDER\" | \"MISSING_SERIAL\" | \"SERIAL_PATTERN_MISMATCH\" | \"SKU_TRANSMUTATION\" | \"UNKNOWN_SERIAL\";\n\n/** The item type a request asks an item to become. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type RequestedItemType = \"BULK\" | \"DEVICE\" | \"SERVICE\";\n\nexport interface ReturnOrder {\n    /** Why the order was cancelled, or null while it has not been. */\n    cancellationReason?: string | null;\n    /** When the order was cancelled, or null while it has not been. */\n    cancelledAt?: string | null;\n    /** Who cancelled the order, or null while it has not been cancelled. */\n    cancelledBy?: SparsePerson | null;\n    /** The carrier the items are returned with, or null when none is named. */\n    carrier?: CarrierDetails | null;\n    /** When the order was created. */\n    createdAt?: string;\n    /** Who created the order. */\n    createdBy?: SparsePerson;\n    /** The exchange the order belongs to, or null when it was not created as part of one. */\n    exchangeGroup?: SparseExchangeGroup | null;\n    /** The number of files attached to the order. */\n    fileCount?: number;\n    /** The location the items are returned from, or null when none is on record. */\n    fromLocation?: SparseLocationWithIntegration | null;\n    /** The return order's unique identifier. */\n    id?: string;\n    /** The order's lines. */\n    items?: ReturnOrderOrderItem[];\n    /** The return order's key, which the return order endpoints take as returnOrderKey. */\n    key?: string;\n    /** When the order last changed. */\n    lastUpdatedAt?: string;\n    /** Who last changed the order. */\n    lastUpdatedBy?: SparsePerson;\n    /** When a shipment for the order was last delivered, or null while none has been. */\n    mostRecentDeliveredAt?: string | null;\n    /** When a shipment for the order was last received, or null while none has been. */\n    mostRecentReceivedAt?: string | null;\n    /** When a shipment for the order last shipped, or null while none has. */\n    mostRecentShippedAt?: string | null;\n    /** A note about the order, or null. */\n    orderNotes?: string | null;\n    /** The day the items were promised to arrive, or null when none was promised. */\n    promiseDeliveryDate?: string | null;\n    /** The day the items were promised to ship, or null when none was promised. */\n    promiseShipDate?: string | null;\n    /** The number the return order is known by, which a shipment names to fill it. */\n    returnOrderNumber?: string;\n    /** A description of why the items are coming back, or null when none was given. */\n    returnReason?: string | null;\n    /** Why the items are coming back. */\n    returnType?: ReturnOrderType;\n    /** Where the order is in its life, by the furthest stage any of its lines has reached on the order's shipments. */\n    status?: ReturnOrderStatus;\n    /** The order's receiving by a third-party logistics (3PL) provider and its sync state. */\n    thirdParty?: ReturnOrderThirdParty;\n    /** The location the items are returned to. */\n    toLocation?: SparseLocationWithIntegration;\n}\n\nexport interface ReturnOrderItem {\n    /** The ID of the physical item the line returns, which may appear on only one line. */\n    itemId: string;\n    /** How many units of the item to return, which must be greater than 0. */\n    requestedQuantity: number;\n}\n\n/** The status of a line item on a return order. Accepted in any case. The listed spelling is the one the API sends back. | Value | Description | | --- | --- | | `DELIVERED_FULL` | The requested units have been delivered | | `DELIVERED_OVERAGE` | More units than were requested have been delivered | | `DELIVERED_PARTIAL` | Fewer units than were requested have been delivered | | `DRAFT` | None of the line's units are on a shipment yet | | `OPEN_FULL` | The requested units are on shipments that have not left | | `OPEN_OVERAGE` | More units than were requested are on shipments that have not left | | `OPEN_PARTIAL` | Fewer units than were requested are on shipments that have not left | | `RECEIVED_FULL` | The requested units have been received | | `RECEIVED_OVERAGE` | More units than were requested have been received | | `RECEIVED_PARTIAL` | Fewer units than were requested have been received | | `SHIPPED_FULL` | The requested units have shipped | | `SHIPPED_OVERAGE` | More units than were requested have shipped | | `SHIPPED_PARTIAL` | Fewer units than were requested have shipped | */\nexport type ReturnOrderLineItemStatus = \"DELIVERED_FULL\" | \"DELIVERED_OVERAGE\" | \"DELIVERED_PARTIAL\" | \"DRAFT\" | \"OPEN_FULL\" | \"OPEN_OVERAGE\" | \"OPEN_PARTIAL\" | \"RECEIVED_FULL\" | \"RECEIVED_OVERAGE\" | \"RECEIVED_PARTIAL\" | \"SHIPPED_FULL\" | \"SHIPPED_OVERAGE\" | \"SHIPPED_PARTIAL\";\n\nexport interface ReturnOrderListing {\n    /** The page of records. */\n    results?: ReturnOrder[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\nexport interface ReturnOrderOrderItem {\n    /** How many units are on the order's shipments that have been delivered and not yet received. */\n    deliveredQuantity?: number;\n    /** The line's unique identifier. */\n    id?: string;\n    /** The item the line returns. */\n    item?: SparseItem;\n    /** The line's key. */\n    key?: string;\n    /** How many units are on the order's shipments that have not yet shipped. */\n    openQuantity?: number;\n    /** How many units have been received on the order's shipments. */\n    receivedQuantity?: number;\n    /** How many units of the item are to come back. */\n    requestedQuantity?: number;\n    /** How many units are on the order's shipments that have shipped and not yet been delivered. */\n    shippedQuantity?: number;\n    /** The furthest stage the line's units have reached on the order's shipments, and whether fewer, exactly, or more units than were requested reached it. */\n    status?: ReturnOrderLineItemStatus;\n}\n\nexport interface ReturnOrderResync3PLFilesResult {\n    /** How many of those files the 3PL did not accept, which a later resync tries again. */\n    failedFiles?: number;\n    /** How many of those files the 3PL accepted. */\n    successfulFiles?: number;\n    /** How many of the order's files the 3PL had not yet received. */\n    totalFiles?: number;\n}\n\n/** The status of a return order. Accepted in any case. The listed spelling is the one the API sends back. | Value | Description | | --- | --- | | `AWAITING_3PL` | The order was sent to a third-party logistics provider, which has not yet reported a shipment | | `CANCELLED` | The order was cancelled | | `DELIVERED_FULL` | Every line's requested units have been delivered | | `DELIVERED_OVERAGE` | Every line's requested units have been delivered, and some line delivered more than was requested | | `DELIVERED_PARTIAL` | Units have been delivered, and not every line has been delivered in full | | `DRAFT` | No units are on a shipment yet, and the order can still be edited or cancelled | | `OPEN_FULL` | Every line's requested units are on shipments that have not left | | `OPEN_OVERAGE` | Every line's requested units are on shipments that have not left, and some line has more than was requested | | `OPEN_PARTIAL` | Units are on shipments that have not left, and not every line is there in full | | `RECEIVED_FULL` | Every line's requested units have been received | | `RECEIVED_OVERAGE` | Every line's requested units have been received, and some line received more than was requested | | `RECEIVED_PARTIAL` | Units have been received, and not every line has been received in full | | `SHIPPED_FULL` | Every line's requested units have shipped | | `SHIPPED_OVERAGE` | Every line's requested units have shipped, and some line shipped more than was requested | | `SHIPPED_PARTIAL` | Units have shipped, and not every line has shipped in full | */\nexport type ReturnOrderStatus = \"AWAITING_3PL\" | \"CANCELLED\" | \"DELIVERED_FULL\" | \"DELIVERED_OVERAGE\" | \"DELIVERED_PARTIAL\" | \"DRAFT\" | \"OPEN_FULL\" | \"OPEN_OVERAGE\" | \"OPEN_PARTIAL\" | \"RECEIVED_FULL\" | \"RECEIVED_OVERAGE\" | \"RECEIVED_PARTIAL\" | \"SHIPPED_FULL\" | \"SHIPPED_OVERAGE\" | \"SHIPPED_PARTIAL\";\n\nexport interface ReturnOrderThirdParty {\n    /** Whether the last sync with the 3PL provider failed. */\n    hasSyncError?: boolean;\n    /** Whether the order was sent to a 3PL provider, which then receives it and keeps it from being edited. */\n    isEnabled?: boolean;\n    /** When Hardfin last checked the order with its 3PL provider, or null when it has never checked. */\n    lastSyncedAt?: string | null;\n    /** When the 3PL provider last reported a change to the order, or null when it has reported none. */\n    lastUpdateAt?: string | null;\n    /** Why the last sync with the 3PL provider failed, or null when it did not. */\n    syncErrorMessage?: string | null;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ReturnOrderType = \"CUSTOMER_CANCELLATION\" | \"DAMAGED\" | \"DEFECTIVE\" | \"END_OF_SERVICE\" | \"INCORRECT_SPEC\" | \"NOT_NEEDED\" | \"OTHER\" | \"PROVISIONING\" | \"UPGRADE\" | \"WRONG_ITEM\";\n\n/** Accepted in any case, and also as t, f, 1, 0, or 2 for all. The listed spelling is the one the API sends back. */\nexport type ScrappedState = \"all\" | \"false\" | \"true\";\n\nexport interface SharedBool {\n    /** Whether the operation completed. */\n    success?: boolean;\n}\n\nexport interface SharedIntegration {\n    /** The Hardfin error code of the failed sync, or null when the sync did not fail. */\n    errorCode?: number | null;\n    /** The integrated system, such as SFDC or HUBSPOT. */\n    id?: IntegrationID;\n    /** Whether the last sync with the external system failed. */\n    inError?: boolean;\n    /** Whether a sync with the external system is pending. */\n    isSyncing?: boolean;\n    /** The system's display name. */\n    label?: string;\n    /** A URL to the linked record in the external system. */\n    link?: string | null;\n    /** Whether the record differs from the external system and needs a person to review it. */\n    needsReview?: boolean;\n    /** The kind of system, CRM or ERP. */\n    type?: IntegrationCategory;\n}\n\nexport interface Shipment {\n    /** Why the shipment was cancelled, or null while it has not been. */\n    cancellationReason?: string | null;\n    /** When the shipment was cancelled, or null while it has not been. */\n    cancelledAt?: string | null;\n    /** The ID of the user who cancelled the shipment, or null while it has not been cancelled. */\n    cancelledBy?: string | null;\n    /** Who carries the shipment, or null when no carrier is named. */\n    carrier?: CarrierDetails | null;\n    /** When the shipment was created. */\n    createdAt?: string;\n    /** Who created the shipment. */\n    createdBy?: SparsePerson;\n    /** How long the shipment spent in each stage. */\n    cycleTime?: ShipmentCycleTime;\n    /** When the shipment arrived, or null while it has not. */\n    deliveredAt?: string | null;\n    /** The IANA time zone deliveredAt was recorded in, or null when none was recorded. */\n    deliveredAtTimezone?: string | null;\n    /** The note written when the shipment was delivered, or null. */\n    deliveryNote?: string | null;\n    /** The sum of the lines' estimated values, or null when no line has an estimate. */\n    estimatedTotalValue?: string | null;\n    /** When the carrier now expects to deliver, or null when it says nothing. */\n    eta?: string | null;\n    /** The day the shipment is expected to arrive, or null when no one has said. */\n    expectedDeliveredOn?: string | null;\n    /** The day the shipment is expected to leave, or null when no one has said. */\n    expectedShippedOn?: string | null;\n    /** Where the shipment leaves from, or null when an inbound shipment names no origin. */\n    fromLocation?: SparseLocationWithIntegration | null;\n    /** The fulfillment order an outbound shipment fills, or null when it fills none. */\n    fulfillmentOrder?: SparseFulfillment | null;\n    /** The shipment's unique identifier. */\n    id?: string;\n    /** The shipment's line items. */\n    items?: ShipmentLineItem[];\n    /** The shipment's key, which the shipment endpoints take as shipmentKey. */\n    key?: string;\n    /** The purchase order an inbound shipment fills, or null when it fills none. */\n    purchaseOrder?: SparsePurchaseOrder | null;\n    /** The note written when the shipment was received, or null. */\n    receiptNote?: string | null;\n    /** When an inbound shipment's items were received, or null while they have not been. */\n    receivedAt?: string | null;\n    /** The IANA time zone receivedAt was recorded in, or null when none was recorded. */\n    receivedAtTimezone?: string | null;\n    /** The return order an inbound shipment fills, or null when it fills none. */\n    returnOrder?: SparseReturnOrder | null;\n    /** The carrier's service the shipment travels on, or null when the carrier names none. */\n    serviceLevelName?: string | null;\n    /** The note written about the shipment itself, or null. */\n    shipmentNote?: string | null;\n    /** The number the shipment is known by. */\n    shipmentNumber?: string;\n    /** Whether the shipment is INBOUND to the organization or OUTBOUND from it. */\n    shipmentType?: ShipmentType | null;\n    /** When the shipment left, or null while it has not. */\n    shippedAt?: string | null;\n    /** The IANA time zone shippedAt was recorded in, or null when none was recorded. */\n    shippedAtTimezone?: string | null;\n    /** What the shipment cost to send, or null when no cost is recorded. */\n    shippingCost?: Currency | null;\n    /** Where the shipment is in its life: OPEN, SHIPPED, DELIVERED, RECEIVED or CANCELLED. */\n    status?: ShipmentStatus;\n    /** Whether a third-party provider holds the shipment, which refuses changes made through the API. */\n    thirdPartyBound?: boolean;\n    /** How many days the shipment has held its status, or null once it is received or cancelled. */\n    timeInStatusDays?: string | null;\n    /** Where the shipment is going. */\n    toLocation?: SparseLocationWithIntegration;\n    /** What the shipment's assets are worth, or null when it has none to value. */\n    totalValue?: string | null;\n}\n\nexport interface ShipmentCycleTime {\n    /** The days from the shipment's creation to its ship time, or null while it has not shipped. */\n    createdToShippedDays?: string | null;\n    /** The days from the shipment's ship time to its delivery, or null while it has not been delivered. */\n    shippedToDeliveredDays?: string | null;\n}\n\nexport interface ShipmentItem {\n    /** The line's identifier in another system, or null when it has none. */\n    externalReference?: string | null;\n    /** The ID of the item the line carries. */\n    itemId?: string;\n    /** How many units the line ships, which an outbound shipment requires above 0 and an inbound shipment may leave null. */\n    quantity?: number | null;\n    /** The serial numbers of the units, for an item that is tracked by serial. */\n    serials?: string[];\n}\n\nexport interface ShipmentLineItem {\n    /** What the line was estimated to be worth while the shipment was open, or null when no estimate was made. */\n    estimatedValue?: string | null;\n    /** The line's identifier in the system that reported it, or null when it has none. */\n    externalReference?: string | null;\n    /** The item the line carries. */\n    item?: SparseItem;\n    /** The number of serial numbers in pendingSerials. */\n    pendingSerialCount?: number;\n    /** The serial numbers a third-party provider has reported but not yet confirmed as shipped. */\n    pendingSerials?: string[];\n    /** How many units the line ships, or null when the line was added without one. */\n    quantity?: number | null;\n    /** How many units arrived, or null until an inbound shipment is received. */\n    receivedQuantity?: number | null;\n    /** The number of serial numbers in serials. */\n    serialCount?: number;\n    /** The serial numbers of the line's units, which is empty for an item that is not tracked by serial. */\n    serials?: string[];\n    /** What the line's assets are worth, or null when it has none to value. */\n    value?: string | null;\n}\n\nexport interface ShipmentListing {\n    /** The shipments on the page. */\n    results?: Shipment[];\n    /** The number of shipments the filters match, across every page. */\n    totalCount?: number;\n}\n\nexport interface ShipmentReceiveItem {\n    /** The line's identifier in another system, or null when it has none. */\n    externalReference?: string | null;\n    /** The ID of the item that arrived, which may be named once. */\n    itemId?: string;\n    /** How many units arrived, which is required and may be 0 for a line that did not arrive. */\n    quantity?: number | null;\n    /** The serial numbers of the units that arrived, for an item that is tracked by serial. */\n    serials?: string[];\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ShipmentStatus = \"CANCELLED\" | \"DELIVERED\" | \"OPEN\" | \"RECEIVED\" | \"SHIPPED\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ShipmentType = \"INBOUND\" | \"OUTBOUND\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type SortOrder = \"ASC\" | \"DESC\";\n\nexport interface SparseActiveWorkflow {\n    id?: string;\n    key?: string;\n    name?: string;\n    stages?: SparseWorkflowStage[];\n}\n\nexport interface SparseAsset {\n    /** Whether the asset works, is broken, awaits review, or has been scrapped. */\n    functionalStatus?: AssetFunctionalStatus;\n    /** The asset's unique identifier. */\n    id?: string;\n    /** The day the asset entered inventory. */\n    inInventoryDate?: string;\n    /** Whether the asset is archived. */\n    isArchived?: boolean;\n    /** Whether the asset has shipped and not yet been delivered. */\n    isInTransit?: boolean;\n    /** The catalog item the asset is a unit of. */\n    item?: SparseItem;\n    /** The asset's key, which the asset endpoints take as assetKey. */\n    key?: string;\n    /** The asset's serial number, unique within its item. */\n    serial?: string;\n}\n\nexport interface SparseContact {\n    /** A note about the contact, or null. */\n    comments?: string | null;\n    /** When the contact was created. */\n    createdAt?: string;\n    /** The customer the contact works for. */\n    customer?: SparseCustomer;\n    /** The contact's email address, or null. */\n    email?: string | null;\n    /** The contact's first name. */\n    firstName?: string;\n    /** The contact's unique identifier. */\n    id?: string;\n    /** Whether the contact is archived. */\n    isArchived?: boolean;\n    /** The contact's key. */\n    key?: string;\n    /** The contact's last name. */\n    lastName?: string;\n    /** The contact's phone number, or null. */\n    phone?: string | null;\n    /** The contact's job title, or null. */\n    title?: string | null;\n    /** When the contact last changed. */\n    updatedAt?: string;\n}\n\nexport interface SparseCustomer {\n    /** The customer's unique identifier. */\n    id?: string;\n    /** Whether the customer is archived. */\n    isArchived?: boolean;\n    /** Whether the company is a customer. */\n    isCustomer?: boolean;\n    /** Whether the company is a supplier. */\n    isSupplier?: boolean;\n    /** The customer's key, which the customer endpoints take as customerKey. */\n    key?: string;\n    /** The customer's display name. */\n    name?: string;\n}\n\nexport interface SparseExchangeGroup {\n    /** The number the exchange is known by. */\n    exchangeNumber?: string;\n    /** The fulfillment orders that send replacement units. */\n    fulfillmentOrders?: SparseExchangeGroupFulfillment[];\n    /** The exchange's unique identifier. */\n    id?: string;\n    /** The exchange's key. */\n    key?: string;\n    /** The return orders that bring units back. */\n    returnOrders?: SparseExchangeGroupReturnOrder[];\n    /** Where the exchange stands: DRAFT, IN_PROGRESS, COMPLETE or CANCELLED. */\n    status?: ExchangeGroupStatus;\n}\n\nexport interface SparseExchangeGroupFulfillment {\n    /** The number the fulfillment order is known by. */\n    fulfillmentOrderNumber?: string;\n    /** The fulfillment order's unique identifier. */\n    id?: string;\n    /** The fulfillment order's key. */\n    key?: string;\n}\n\nexport interface SparseExchangeGroupReturnOrder {\n    /** The return order's unique identifier. */\n    id?: string;\n    /** The return order's key. */\n    key?: string;\n    /** The number the return order is known by. */\n    returnOrderNumber?: string;\n}\n\nexport interface SparseFulfillment {\n    /** The number the fulfillment order is known by. */\n    fulfillmentOrderNumber?: string;\n    /** The fulfillment order's unique identifier. */\n    id?: string;\n    /** Whether a third-party provider fulfills the order. */\n    isThirdPartyFulfilled?: boolean;\n    /** The fulfillment order's key. */\n    key?: string;\n}\n\nexport interface SparseItem {\n    /** Whether each unit of the item is tracked as its own asset, which is true for a DEVICE item. */\n    hasAssets?: boolean;\n    /** The item's unique identifier. */\n    id?: string;\n    /** Whether the item is archived. */\n    isArchived?: boolean;\n    /** Whether the item is physical, which is true for DEVICE and BULK items. */\n    isPhysical?: boolean;\n    /** The item's key, which the item endpoints take as itemKey. */\n    key?: string;\n    /** The item's display name. */\n    name?: string;\n    /** Whether the item's units carry serial numbers, which is true for a DEVICE item and for a BULK item that accepts serials. */\n    shouldRenderSerialFields?: boolean;\n    /** The item's stock keeping unit, unique within your organization. */\n    sku?: string;\n    /** SERVICE for a non-physical item, DEVICE for a physical item tracked by serial number, or BULK for a part tracked by quantity. */\n    type?: FrontendItemType;\n    /** The unit the item's quantities are counted in. */\n    unitOfMeasure?: UnitOfMeasure;\n}\n\nexport type SparseLocation = MetadataLocationSite & {\n    /** The number of archived zones at a site. */\n    archivedZoneCount?: number;\n    /** The customer a zone is designated for, such as for reservations, provisioning or a 3PL. */\n    consignee?: SparseCustomer | null;\n    /** The customer the location is assigned to, which a zone reads from its parent site, or null for your organization's own locations. */\n    customer?: SparseCustomer | null;\n    /** A free-form description of a zone. */\n    description?: string | null;\n    /** The location's unique identifier. */\n    id?: string;\n    /** Whether Google resolved the site's address, which is always false for a zone. */\n    isAddressGeocoded?: boolean;\n    /** Whether the location is archived. */\n    isArchived?: boolean;\n    /** Whether assets at the location count as inventory for reporting. */\n    isInventory?: boolean;\n    /** Whether a zone sets its own isInventory rather than inheriting its parent site's. */\n    isInventoryOverride?: boolean;\n    /** Whether a third-party logistics (3PL) provider fulfills orders from the location. */\n    isThirdPartyEnabled?: boolean;\n    /** Whether assets make only occasional or temporary stops at the location, which hides it from location lists by default. */\n    isTransient?: boolean;\n    /** The location's key, which the location endpoints take as locationKey. */\n    key?: string;\n    /** The location's display name. */\n    name?: string;\n    /** The 3PL provider's identifier for the location. */\n    thirdPartyIdentifier?: string | null;\n    /** SITE for a site, or ZONE for a zone within a site. */\n    type?: LocationType;\n    /** The number of zones at a site. */\n    zoneCount?: number;\n    /** The site's zones. */\n    zones?: SparseZone[];\n};\n\nexport type SparseLocationWithIntegration = SparseLocationWithParent & {\n    /** The location's links to integrated systems. */\n    integrations?: SharedIntegration[];\n};\n\nexport type SparseLocationWithParent = SparseLocation & {\n    /** The site a zone belongs to, or null for a site. */\n    parentLocation?: SparseLocation | null;\n};\n\nexport interface SparseOrganization {\n    /** The organization's ID */\n    id?: string;\n    /** The public identifier that can be used in URLs */\n    key?: string;\n    /** The name of the organization */\n    name?: string;\n}\n\nexport interface SparsePerson {\n    /** The person's first name. */\n    firstName?: string | null;\n    /** The person's unique identifier. */\n    id?: string;\n    /** The person's key. */\n    key?: string;\n    /** The person's last name. */\n    lastName?: string | null;\n}\n\nexport interface SparseProject {\n    /** The customer the project is for. */\n    customer?: SparseCustomer | null;\n    /** The day the project ends. */\n    endOn?: string | null;\n    /** The project's unique identifier. */\n    id?: string;\n    /** The project's links to integrated systems. */\n    integrations?: SharedIntegration[];\n    /** Whether the project is archived. */\n    isArchived?: boolean;\n    /** The project's key. */\n    key?: string;\n    /** The project's display name. */\n    name?: string;\n    /** The name of the project's payment term. */\n    paymentTermLabel?: string | null;\n    /** The customer's purchase order number, which new invoices for the project carry. */\n    purchaseOrderNumber?: string | null;\n    /** The day the project starts. */\n    startOn?: string | null;\n    /** Whether the project is upcoming, active, or past, judged from its dates. */\n    status?: ProjectStatus;\n}\n\nexport interface SparsePurchaseOrder {\n    /** The supplier's own number for the purchase order, or null when it has none. */\n    externalPurchaseOrderNumber?: string | null;\n    /** The purchase order's unique identifier. */\n    id?: string;\n    /** The purchase order's key. */\n    key?: string;\n    /** The number the purchase order is known by. */\n    purchaseOrderNumber?: string;\n}\n\nexport interface SparseReturnOrder {\n    /** The return order's unique identifier. */\n    id?: string;\n    /** The return order's key. */\n    key?: string;\n    /** The number the return order is known by. */\n    returnOrderNumber?: string;\n}\n\nexport interface SparseShipment {\n    /** When the shipment arrived, or null while it has not. */\n    deliveredAt?: string | null;\n    /** The shipment's unique identifier. */\n    id?: string;\n    /** The shipment's key. */\n    key?: string;\n    /** The number the shipment is known by. */\n    shipmentNumber?: string;\n    /** What kind of movement the shipment carries. */\n    shipmentType?: string;\n    /** When the shipment left, or null while it has not. */\n    shippedAt?: string | null;\n}\n\nexport interface SparseWorkflowStage {\n    active?: boolean;\n    id?: string;\n    key?: string;\n    name?: string;\n    order?: number;\n}\n\nexport interface SparseZone {\n    /** The number of assets in the zone. */\n    assetCount?: number;\n    /** The customer the zone is designated for, such as for reservations, provisioning or a 3PL. */\n    consignee?: SparseCustomer | null;\n    /** A free-form description of the zone. */\n    description?: string | null;\n    /** The zone's unique identifier. */\n    id?: string;\n    /** Whether the zone is archived. */\n    isArchived?: boolean;\n    /** Whether assets in the zone count as inventory for reporting. */\n    isInventory?: boolean;\n    /** The zone's key. */\n    key?: string;\n    /** The zone's display name, unique within its site. */\n    name?: string;\n}\n\nexport interface Token {\n    /** When the API key was created, the application was connected, or the person signed in. */\n    createdAt?: string;\n    /** When the access token or session expires, or null for an API key, which does not. */\n    expiresAt?: string | null;\n    /** The API key's public identifier or the application's client_id, or null for a session. */\n    identifier?: string | null;\n    /** The API key's label or the application's name, or null when there is none. */\n    label?: string | null;\n    /** When the API key was last regenerated or the access token was issued, or null for a session. */\n    lastRegeneratedAt?: string | null;\n    /** The organization the credential acts in. */\n    organization?: SparseOrganization;\n    /** The person the credential acts for. */\n    person?: SparsePerson;\n    scopes?: string[];\n    /** The kind of credential. */\n    type?: CredentialType;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type TransactionType = \"SALE\" | \"SERVICE\";\n\n/** Accepted in any case, and also as t, f, 1, 0, or 2 for all. The listed spelling is the one the API sends back. */\nexport type TransientState = \"all\" | \"false\" | \"true\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type TransitStatus = \"IN_TRANSIT\" | \"IN_TRANSIT_TO_FIELD\" | \"IN_TRANSIT_TO_INVENTORY\" | \"NOT_IN_TRANSIT\";\n\nexport interface URLLink {\n    /** When the link was created. */\n    createdAt?: string;\n    /** The URL link's unique identifier. */\n    id?: string;\n    /** The URL link's key, which the URL link endpoints take as linkKey. */\n    key?: string;\n    /** The link's display name, or null when the link shows its address instead. */\n    name?: string | null;\n    /** When the link was last changed. */\n    updatedAt?: string;\n    /** The address the link points to. */\n    url?: string;\n}\n\n/** The unit a quantity is counted in, sent as its UNECE Recommendation 20 code. A request may also name the unit or give its symbol, such as each or kg. See: https://unece.org/trade/uncefact/cl-recommendations Accepted in any case. The listed spelling is the one the API sends back. | Value | Description | | --- | --- | | `BG` | Bag | | `BO` | Bottle | | `BX` | Box | | `C62` | Unit | | `CMK` | Square centimeter (cm2) | | `CMT` | Centimeter (cm) | | `CR` | Crate | | `CS` | Case | | `CT` | Carton | | `DMQ` | Cubic decimeter (dm3) | | `DR` | Drum | | `DZN` | Dozen (doz) | | `EA` | Each (ea) | | `EN` | Envelope | | `FOT` | Foot (ft) | | `FTK` | Square foot (ft2) | | `FTQ` | Cubic foot (ft3) | | `GLL` | Gallon (gal) | | `GRM` | Gram (g) | | `GRO` | Gross | | `H87` | Piece (pc) | | `INH` | Inch (in) | | `INK` | Square inch (in2) | | `INQ` | Cubic inch (in3) | | `KG` | Keg | | `KGM` | Kilogram (kg) | | `KMT` | Kilometer (km) | | `KT` | Kit | | `LBR` | Pound (lb) | | `LO` | Lot | | `LTR` | Liter (L) | | `MGM` | Milligram (mg) | | `MLT` | Milliliter (mL) | | `MMK` | Square millimeter (mm2) | | `MMT` | Millimeter (mm) | | `MTK` | Square meter (m2) | | `MTQ` | Cubic meter (m3) | | `MTR` | Meter (m) | | `ONZ` | Ounce (oz) | | `OZA` | Fluid ounce (fl oz) | | `PK` | Pack | | `PR` | Pair (pr) | | `PTI` | Pint (pt) | | `PX` | Pallet | | `QTI` | Quart (qt) | | `RL` | Reel | | `RO` | Roll | | `SET` | Set | | `SMI` | Mile (mi) | | `ST` | Sheet | | `STN` | Ton US (NT) | | `SV` | Skid | | `TNE` | Tonne metric (t) | | `TU` | Tube | | `YDK` | Square yard (yd2) | | `YDQ` | Cubic yard (yd3) | | `YRD` | Yard (yd) | */\nexport type UnitOfMeasure = \"BG\" | \"BO\" | \"BX\" | \"C62\" | \"CMK\" | \"CMT\" | \"CR\" | \"CS\" | \"CT\" | \"DMQ\" | \"DR\" | \"DZN\" | \"EA\" | \"EN\" | \"FOT\" | \"FTK\" | \"FTQ\" | \"GLL\" | \"GRM\" | \"GRO\" | \"H87\" | \"INH\" | \"INK\" | \"INQ\" | \"KG\" | \"KGM\" | \"KMT\" | \"KT\" | \"LBR\" | \"LO\" | \"LTR\" | \"MGM\" | \"MLT\" | \"MMK\" | \"MMT\" | \"MTK\" | \"MTQ\" | \"MTR\" | \"ONZ\" | \"OZA\" | \"PK\" | \"PR\" | \"PTI\" | \"PX\" | \"QTI\" | \"RL\" | \"RO\" | \"SET\" | \"SMI\" | \"ST\" | \"STN\" | \"SV\" | \"TNE\" | \"TU\" | \"YDK\" | \"YDQ\" | \"YRD\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type UsefulLifeRevisionReason = \"CHANGE_IN_USE\" | \"DAMAGE\" | \"OBSOLESCENCE\" | \"OTHER\" | \"REASSESSMENT\" | \"REFURBISHMENT\" | \"REGULATORY\";\n\nexport interface Workflow {\n    /** When the workflow was created. */\n    createdAt?: string;\n    /** The workflow's identifier. */\n    id?: string;\n    /** Whether this is the organization's default workflow. At most one workflow is the default. */\n    isDefault?: boolean;\n    /** The workflow's key. */\n    key?: string;\n    /** The workflow's name. */\n    name?: string;\n    /** The stages a project on this workflow moves through, in order. */\n    stages?: WorkflowStage[];\n    /** When the workflow was last changed. */\n    updatedAt?: string;\n}\n\nexport interface WorkflowStage {\n    /** When the stage was created. */\n    createdAt?: string;\n    /** The stage's identifier. */\n    id?: string;\n    /** The number of projects on the stage. */\n    inUseCount?: number;\n    /** The stage's key. */\n    key?: string;\n    /** The stage's name. */\n    name?: string;\n    /** The stage's position in its workflow. A lower value comes first. */\n    orderIndex?: number;\n    /** When the stage was last changed. */\n    updatedAt?: string;\n}\n";
 //#endregion
 //#region src/command/types.ts
 const typesCommand = defineCommand({
@@ -4998,23 +5014,65 @@ const commands = [
 						{
 							name: "allocated-indirect",
 							jsonPath: ["allocatedIndirect"],
-							description: "One unit's share of overhead, a cost component",
-							valueName: "value",
+							description: "One unit's share of overhead, a cost component. Takes only null, which clears it",
+							valueName: "null",
 							nullable: true,
-							schema: z.string()
+							schema: z.null()
+						},
+						{
+							name: "allocated-indirect-value",
+							jsonPath: ["allocatedIndirect", "amount"],
+							description: "One unit's share of overhead, a cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --allocated-indirect-iso-code",
+							valueName: "value",
+							together: ["allocated-indirect-iso-code"],
+							schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
+						},
+						{
+							name: "allocated-indirect-iso-code",
+							jsonPath: ["allocatedIndirect", "isoCode"],
+							description: "One unit's share of overhead, a cost component: the value's ISO 4217 currency code, given with --allocated-indirect-value",
+							valueName: "value",
+							together: ["allocated-indirect-value"],
+							schema: toEnum([
+								"CAD",
+								"EUR",
+								"GBP",
+								"USD"
+							])
 						},
 						{
 							name: "bill-of-materials",
 							jsonPath: ["billOfMaterials"],
-							description: "The parts cost of one unit, a cost component",
-							valueName: "value",
+							description: "The parts cost of one unit, a cost component. Takes only null, which clears it",
+							valueName: "null",
 							nullable: true,
-							schema: z.string()
+							schema: z.null()
+						},
+						{
+							name: "bill-of-materials-value",
+							jsonPath: ["billOfMaterials", "amount"],
+							description: "The parts cost of one unit, a cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --bill-of-materials-iso-code",
+							valueName: "value",
+							together: ["bill-of-materials-iso-code"],
+							schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
+						},
+						{
+							name: "bill-of-materials-iso-code",
+							jsonPath: ["billOfMaterials", "isoCode"],
+							description: "The parts cost of one unit, a cost component: the value's ISO 4217 currency code, given with --bill-of-materials-value",
+							valueName: "value",
+							together: ["bill-of-materials-value"],
+							schema: toEnum([
+								"CAD",
+								"EUR",
+								"GBP",
+								"USD"
+							])
 						},
 						{
 							name: "cost-currency-code",
 							jsonPath: ["costCurrencyCode"],
-							description: "The ISO 4217 code the asset's costs are denominated in, which defaults to the item's accounting currency and then the organization's",
+							description: "The ISO 4217 code the asset's costs are denominated in, which defaults to the item's accounting currency and then the organization's, and which every cost amount must match",
 							valueName: "value",
 							schema: toEnum([
 								"CAD",
@@ -5026,7 +5084,7 @@ const commands = [
 						{
 							name: "depreciation-model",
 							jsonPath: ["depreciationModel"],
-							description: "The method one unit is depreciated by, or null to clear it",
+							description: "The method one unit is depreciated by, taken from the item when omitted, or null to leave it empty",
 							valueName: "value",
 							nullable: true,
 							schema: toEnum([
@@ -5047,26 +5105,89 @@ const commands = [
 						{
 							name: "direct-labor",
 							jsonPath: ["directLabor"],
-							description: "The labor cost to build one unit, a cost component",
-							valueName: "value",
+							description: "The labor cost to build one unit, a cost component. Takes only null, which clears it",
+							valueName: "null",
 							nullable: true,
-							schema: z.string()
+							schema: z.null()
+						},
+						{
+							name: "direct-labor-value",
+							jsonPath: ["directLabor", "amount"],
+							description: "The labor cost to build one unit, a cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --direct-labor-iso-code",
+							valueName: "value",
+							together: ["direct-labor-iso-code"],
+							schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
+						},
+						{
+							name: "direct-labor-iso-code",
+							jsonPath: ["directLabor", "isoCode"],
+							description: "The labor cost to build one unit, a cost component: the value's ISO 4217 currency code, given with --direct-labor-value",
+							valueName: "value",
+							together: ["direct-labor-value"],
+							schema: toEnum([
+								"CAD",
+								"EUR",
+								"GBP",
+								"USD"
+							])
 						},
 						{
 							name: "freight-inbound",
 							jsonPath: ["freightInbound"],
-							description: "The shipping cost to receive one unit, a cost component",
-							valueName: "value",
+							description: "The shipping cost to receive one unit, a cost component. Takes only null, which clears it",
+							valueName: "null",
 							nullable: true,
-							schema: z.string()
+							schema: z.null()
+						},
+						{
+							name: "freight-inbound-value",
+							jsonPath: ["freightInbound", "amount"],
+							description: "The shipping cost to receive one unit, a cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --freight-inbound-iso-code",
+							valueName: "value",
+							together: ["freight-inbound-iso-code"],
+							schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
+						},
+						{
+							name: "freight-inbound-iso-code",
+							jsonPath: ["freightInbound", "isoCode"],
+							description: "The shipping cost to receive one unit, a cost component: the value's ISO 4217 currency code, given with --freight-inbound-value",
+							valueName: "value",
+							together: ["freight-inbound-value"],
+							schema: toEnum([
+								"CAD",
+								"EUR",
+								"GBP",
+								"USD"
+							])
 						},
 						{
 							name: "freight-outbound",
 							jsonPath: ["freightOutbound"],
-							description: "The shipping cost to deploy one unit, a deployment cost component",
-							valueName: "value",
+							description: "The shipping cost to deploy one unit, a deployment cost component. Takes only null, which clears it",
+							valueName: "null",
 							nullable: true,
-							schema: z.string()
+							schema: z.null()
+						},
+						{
+							name: "freight-outbound-value",
+							jsonPath: ["freightOutbound", "amount"],
+							description: "The shipping cost to deploy one unit, a deployment cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --freight-outbound-iso-code",
+							valueName: "value",
+							together: ["freight-outbound-iso-code"],
+							schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
+						},
+						{
+							name: "freight-outbound-iso-code",
+							jsonPath: ["freightOutbound", "isoCode"],
+							description: "The shipping cost to deploy one unit, a deployment cost component: the value's ISO 4217 currency code, given with --freight-outbound-value",
+							valueName: "value",
+							together: ["freight-outbound-value"],
+							schema: toEnum([
+								"CAD",
+								"EUR",
+								"GBP",
+								"USD"
+							])
 						},
 						{
 							name: "functional-status",
@@ -5100,18 +5221,60 @@ const commands = [
 						{
 							name: "installation",
 							jsonPath: ["installation"],
-							description: "The cost to install one unit, a deployment cost component",
-							valueName: "value",
+							description: "The cost to install one unit, a deployment cost component. Takes only null, which clears it",
+							valueName: "null",
 							nullable: true,
-							schema: z.string()
+							schema: z.null()
+						},
+						{
+							name: "installation-value",
+							jsonPath: ["installation", "amount"],
+							description: "The cost to install one unit, a deployment cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --installation-iso-code",
+							valueName: "value",
+							together: ["installation-iso-code"],
+							schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
+						},
+						{
+							name: "installation-iso-code",
+							jsonPath: ["installation", "isoCode"],
+							description: "The cost to install one unit, a deployment cost component: the value's ISO 4217 currency code, given with --installation-value",
+							valueName: "value",
+							together: ["installation-value"],
+							schema: toEnum([
+								"CAD",
+								"EUR",
+								"GBP",
+								"USD"
+							])
 						},
 						{
 							name: "interest",
 							jsonPath: ["interest"],
-							description: "The financing cost of one unit, a cost component",
-							valueName: "value",
+							description: "The financing cost of one unit, a cost component. Takes only null, which clears it",
+							valueName: "null",
 							nullable: true,
-							schema: z.string()
+							schema: z.null()
+						},
+						{
+							name: "interest-value",
+							jsonPath: ["interest", "amount"],
+							description: "The financing cost of one unit, a cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --interest-iso-code",
+							valueName: "value",
+							together: ["interest-iso-code"],
+							schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
+						},
+						{
+							name: "interest-iso-code",
+							jsonPath: ["interest", "isoCode"],
+							description: "The financing cost of one unit, a cost component: the value's ISO 4217 currency code, given with --interest-value",
+							valueName: "value",
+							together: ["interest-value"],
+							schema: toEnum([
+								"CAD",
+								"EUR",
+								"GBP",
+								"USD"
+							])
 						},
 						{
 							name: "item-id",
@@ -5132,10 +5295,31 @@ const commands = [
 						{
 							name: "salvage-value",
 							jsonPath: ["salvageValue"],
-							description: "The value one unit keeps at the end of its useful life, or null to clear it",
-							valueName: "value",
+							description: "The value one unit keeps at the end of its useful life, taken from the item when omitted and the item's accounting currency is the asset's. Takes only null, which clears it",
+							valueName: "null",
 							nullable: true,
-							schema: z.string()
+							schema: z.null()
+						},
+						{
+							name: "salvage-value-value",
+							jsonPath: ["salvageValue", "amount"],
+							description: "The value one unit keeps at the end of its useful life, taken from the item when omitted and the item's accounting currency is the asset's: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --salvage-value-iso-code",
+							valueName: "value",
+							together: ["salvage-value-iso-code"],
+							schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
+						},
+						{
+							name: "salvage-value-iso-code",
+							jsonPath: ["salvageValue", "isoCode"],
+							description: "The value one unit keeps at the end of its useful life, taken from the item when omitted and the item's accounting currency is the asset's: the value's ISO 4217 currency code, given with --salvage-value-value",
+							valueName: "value",
+							together: ["salvage-value-value"],
+							schema: toEnum([
+								"CAD",
+								"EUR",
+								"GBP",
+								"USD"
+							])
 						},
 						{
 							name: "serial",
@@ -5148,31 +5332,94 @@ const commands = [
 						{
 							name: "simple-cost-basis",
 							jsonPath: ["simpleCostBasis"],
-							description: "A single cost for one unit, which cannot be sent together with the cost components",
-							valueName: "value",
+							description: "A single cost for one unit, which cannot be sent together with the cost components, and whose cluster is taken from the item when every cost field is omitted and the item's accounting currency is the asset's. Takes only null, which clears it",
+							valueName: "null",
 							nullable: true,
-							schema: z.string()
+							schema: z.null()
+						},
+						{
+							name: "simple-cost-basis-value",
+							jsonPath: ["simpleCostBasis", "amount"],
+							description: "A single cost for one unit, which cannot be sent together with the cost components, and whose cluster is taken from the item when every cost field is omitted and the item's accounting currency is the asset's: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --simple-cost-basis-iso-code",
+							valueName: "value",
+							together: ["simple-cost-basis-iso-code"],
+							schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
+						},
+						{
+							name: "simple-cost-basis-iso-code",
+							jsonPath: ["simpleCostBasis", "isoCode"],
+							description: "A single cost for one unit, which cannot be sent together with the cost components, and whose cluster is taken from the item when every cost field is omitted and the item's accounting currency is the asset's: the value's ISO 4217 currency code, given with --simple-cost-basis-value",
+							valueName: "value",
+							together: ["simple-cost-basis-value"],
+							schema: toEnum([
+								"CAD",
+								"EUR",
+								"GBP",
+								"USD"
+							])
 						},
 						{
 							name: "tariffs",
 							jsonPath: ["tariffs"],
-							description: "The import duty paid on one unit, a cost component",
-							valueName: "value",
+							description: "The import duty paid on one unit, a cost component. Takes only null, which clears it",
+							valueName: "null",
 							nullable: true,
-							schema: z.string()
+							schema: z.null()
+						},
+						{
+							name: "tariffs-value",
+							jsonPath: ["tariffs", "amount"],
+							description: "The import duty paid on one unit, a cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --tariffs-iso-code",
+							valueName: "value",
+							together: ["tariffs-iso-code"],
+							schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
+						},
+						{
+							name: "tariffs-iso-code",
+							jsonPath: ["tariffs", "isoCode"],
+							description: "The import duty paid on one unit, a cost component: the value's ISO 4217 currency code, given with --tariffs-value",
+							valueName: "value",
+							together: ["tariffs-value"],
+							schema: toEnum([
+								"CAD",
+								"EUR",
+								"GBP",
+								"USD"
+							])
 						},
 						{
 							name: "tax",
 							jsonPath: ["tax"],
-							description: "The tax paid on one unit, a cost component",
-							valueName: "value",
+							description: "The tax paid on one unit, a cost component. Takes only null, which clears it",
+							valueName: "null",
 							nullable: true,
-							schema: z.string()
+							schema: z.null()
+						},
+						{
+							name: "tax-value",
+							jsonPath: ["tax", "amount"],
+							description: "The tax paid on one unit, a cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --tax-iso-code",
+							valueName: "value",
+							together: ["tax-iso-code"],
+							schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
+						},
+						{
+							name: "tax-iso-code",
+							jsonPath: ["tax", "isoCode"],
+							description: "The tax paid on one unit, a cost component: the value's ISO 4217 currency code, given with --tax-value",
+							valueName: "value",
+							together: ["tax-value"],
+							schema: toEnum([
+								"CAD",
+								"EUR",
+								"GBP",
+								"USD"
+							])
 						},
 						{
 							name: "useful-life",
 							jsonPath: ["usefulLife"],
-							description: "The number of months one unit is depreciated over, from 1 to 480, or null to clear it",
+							description: "The number of months one unit is depreciated over, from 1 to 480, taken from the item when omitted, or null to leave it empty",
 							valueName: "number",
 							nullable: true,
 							schema: toNumber(z.number().int())
@@ -5385,10 +5632,10 @@ const commands = [
 							{
 								name: "allocated-indirect-value",
 								jsonPath: ["allocatedIndirect", "amount"],
-								description: "One unit's share of overhead, a cost component: the value as a decimal string with two decimal places, given with --allocated-indirect-iso-code",
+								description: "One unit's share of overhead, a cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --allocated-indirect-iso-code",
 								valueName: "value",
 								together: ["allocated-indirect-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "allocated-indirect-iso-code",
@@ -5414,10 +5661,10 @@ const commands = [
 							{
 								name: "bill-of-materials-value",
 								jsonPath: ["billOfMaterials", "amount"],
-								description: "The parts cost of one unit, a cost component: the value as a decimal string with two decimal places, given with --bill-of-materials-iso-code",
+								description: "The parts cost of one unit, a cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --bill-of-materials-iso-code",
 								valueName: "value",
 								together: ["bill-of-materials-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "bill-of-materials-iso-code",
@@ -5435,7 +5682,7 @@ const commands = [
 							{
 								name: "cost-currency-code",
 								jsonPath: ["costCurrencyCode"],
-								description: "The ISO 4217 code every cost amount is denominated in, which must match the amounts sent and cannot be null",
+								description: "The ISO 4217 code every cost amount is denominated in, which must match the amounts sent and cannot be null. It is the only way to change the currency. A change keeps the held amounts and relabels them without conversion, and an asset whose currency is locked refuses it",
 								valueName: "value",
 								schema: toEnum([
 									"CAD",
@@ -5468,10 +5715,10 @@ const commands = [
 							{
 								name: "direct-labor-value",
 								jsonPath: ["directLabor", "amount"],
-								description: "The labor cost to build one unit, a cost component: the value as a decimal string with two decimal places, given with --direct-labor-iso-code",
+								description: "The labor cost to build one unit, a cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --direct-labor-iso-code",
 								valueName: "value",
 								together: ["direct-labor-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "direct-labor-iso-code",
@@ -5497,10 +5744,10 @@ const commands = [
 							{
 								name: "freight-inbound-value",
 								jsonPath: ["freightInbound", "amount"],
-								description: "The shipping cost to receive one unit, a cost component: the value as a decimal string with two decimal places, given with --freight-inbound-iso-code",
+								description: "The shipping cost to receive one unit, a cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --freight-inbound-iso-code",
 								valueName: "value",
 								together: ["freight-inbound-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "freight-inbound-iso-code",
@@ -5526,10 +5773,10 @@ const commands = [
 							{
 								name: "freight-outbound-value",
 								jsonPath: ["freightOutbound", "amount"],
-								description: "The shipping cost to deploy one unit, a deployment cost component: the value as a decimal string with two decimal places, given with --freight-outbound-iso-code",
+								description: "The shipping cost to deploy one unit, a deployment cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --freight-outbound-iso-code",
 								valueName: "value",
 								together: ["freight-outbound-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "freight-outbound-iso-code",
@@ -5563,10 +5810,10 @@ const commands = [
 							{
 								name: "installation-value",
 								jsonPath: ["installation", "amount"],
-								description: "The cost to install one unit, a deployment cost component: the value as a decimal string with two decimal places, given with --installation-iso-code",
+								description: "The cost to install one unit, a deployment cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --installation-iso-code",
 								valueName: "value",
 								together: ["installation-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "installation-iso-code",
@@ -5592,10 +5839,10 @@ const commands = [
 							{
 								name: "interest-value",
 								jsonPath: ["interest", "amount"],
-								description: "The financing cost of one unit, a cost component: the value as a decimal string with two decimal places, given with --interest-iso-code",
+								description: "The financing cost of one unit, a cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --interest-iso-code",
 								valueName: "value",
 								together: ["interest-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "interest-iso-code",
@@ -5629,10 +5876,10 @@ const commands = [
 							{
 								name: "salvage-value-value",
 								jsonPath: ["salvageValue", "amount"],
-								description: "The value one unit keeps at the end of its useful life: the value as a decimal string with two decimal places, given with --salvage-value-iso-code",
+								description: "The value one unit keeps at the end of its useful life: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --salvage-value-iso-code",
 								valueName: "value",
 								together: ["salvage-value-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "salvage-value-iso-code",
@@ -5658,10 +5905,10 @@ const commands = [
 							{
 								name: "simple-cost-basis-value",
 								jsonPath: ["simpleCostBasis", "amount"],
-								description: "A single cost for one unit, which cannot be sent together with the cost components: the value as a decimal string with two decimal places, given with --simple-cost-basis-iso-code",
+								description: "A single cost for one unit, which cannot be sent together with the cost components: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --simple-cost-basis-iso-code",
 								valueName: "value",
 								together: ["simple-cost-basis-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "simple-cost-basis-iso-code",
@@ -5687,10 +5934,10 @@ const commands = [
 							{
 								name: "tariffs-value",
 								jsonPath: ["tariffs", "amount"],
-								description: "The import duty paid on one unit, a cost component: the value as a decimal string with two decimal places, given with --tariffs-iso-code",
+								description: "The import duty paid on one unit, a cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --tariffs-iso-code",
 								valueName: "value",
 								together: ["tariffs-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "tariffs-iso-code",
@@ -5716,10 +5963,10 @@ const commands = [
 							{
 								name: "tax-value",
 								jsonPath: ["tax", "amount"],
-								description: "The tax paid on one unit, a cost component: the value as a decimal string with two decimal places, given with --tax-iso-code",
+								description: "The tax paid on one unit, a cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --tax-iso-code",
 								valueName: "value",
 								together: ["tax-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "tax-iso-code",
@@ -5802,11 +6049,11 @@ const commands = [
 							{
 								name: "amount-value",
 								jsonPath: ["amount", "amount"],
-								description: "How much the adjustment changes the cost basis by, in the asset's cost currency, which must be greater than zero: the value as a decimal string with two decimal places, given with --amount-iso-code",
+								description: "How much the adjustment changes the cost basis by, in the asset's cost currency, which must be greater than zero: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --amount-iso-code",
 								valueName: "value",
 								required: true,
 								together: ["amount-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "amount-iso-code",
@@ -6050,15 +6297,15 @@ const commands = [
 								{
 									name: "sale-price-value",
 									jsonPath: ["salePrice", "amount"],
-									description: "What the customer paid for the asset, which cannot be negative: the value as a decimal string with two decimal places, given with --sale-price-iso-code",
+									description: "What the customer paid for the asset: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --sale-price-iso-code",
 									valueName: "value",
 									together: ["sale-price-iso-code"],
-									schema: z.string()
+									schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 								},
 								{
 									name: "sale-price-iso-code",
 									jsonPath: ["salePrice", "isoCode"],
-									description: "What the customer paid for the asset, which cannot be negative: the value's ISO 4217 currency code, given with --sale-price-value",
+									description: "What the customer paid for the asset: the value's ISO 4217 currency code, given with --sale-price-value",
 									valueName: "value",
 									together: ["sale-price-value"],
 									schema: toEnum([
@@ -6153,15 +6400,15 @@ const commands = [
 								{
 									name: "sale-price-value",
 									jsonPath: ["salePrice", "amount"],
-									description: "What the owner paid for the asset, which cannot be negative: the value as a decimal string with two decimal places, given with --sale-price-iso-code",
+									description: "What the owner paid for the asset: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --sale-price-iso-code",
 									valueName: "value",
 									together: ["sale-price-iso-code"],
-									schema: z.string()
+									schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 								},
 								{
 									name: "sale-price-iso-code",
 									jsonPath: ["salePrice", "isoCode"],
-									description: "What the owner paid for the asset, which cannot be negative: the value's ISO 4217 currency code, given with --sale-price-value",
+									description: "What the owner paid for the asset: the value's ISO 4217 currency code, given with --sale-price-value",
 									valueName: "value",
 									together: ["sale-price-value"],
 									schema: toEnum([
@@ -6231,10 +6478,10 @@ const commands = [
 							{
 								name: "disposal-price-value",
 								jsonPath: ["disposalPrice", "amount"],
-								description: "What the scrapped asset was sold for: the value as a decimal string with two decimal places, given with --disposal-price-iso-code",
+								description: "What the scrapped asset was sold for: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --disposal-price-iso-code",
 								valueName: "value",
 								together: ["disposal-price-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "disposal-price-iso-code",
@@ -6486,7 +6733,7 @@ const commands = [
 						{
 							name: "include-no-customer",
 							queryName: "includeNoCustomer",
-							description: "True to list the charges of projects that have no customer",
+							description: "True to list the charges of projects that have no customer. With customers it adds them to those customers' charges, and without customers it lists only them",
 							schema: z.boolean()
 						},
 						{
@@ -6500,14 +6747,14 @@ const commands = [
 						{
 							name: "bill-date-start",
 							queryName: "billDateStart",
-							description: "A day, and only charges whose ExpectedBillableDate is on or after it are listed",
+							description: "A day, and only charges whose expectedBillableDate is on or after it are listed",
 							valueName: "value",
 							schema: z.string()
 						},
 						{
 							name: "bill-date-end",
 							queryName: "billDateEnd",
-							description: "A day, and only charges whose ExpectedBillableDate is on or before it are listed",
+							description: "A day, and only charges whose expectedBillableDate is on or before it are listed",
 							valueName: "value",
 							schema: z.string()
 						},
@@ -6555,7 +6802,7 @@ const commands = [
 					bodyFlags: [{
 						name: "cancellation-reason",
 						jsonPath: ["cancellationReason"],
-						description: "Why the charge is cancelled, kept exactly as sent and 4,096 characters or less, or null for no reason",
+						description: "Why the charge is cancelled, kept exactly as sent and 4,096 characters or less, or null for no reason. Cancelling a cancelled charge again replaces its reason with a different one sent, and null keeps the reason it has",
 						valueName: "value",
 						nullable: true,
 						schema: z.string()
@@ -6577,7 +6824,7 @@ const commands = [
 						{
 							name: "billing-eligible-date",
 							jsonPath: ["billingEligibleDate"],
-							description: "The day the charge became billable, which is required and does not change its ExpectedBillableDate",
+							description: "The day the charge became billable, which is required and does not change its expectedBillableDate",
 							valueName: "value",
 							required: true,
 							schema: z.string()
@@ -6593,7 +6840,7 @@ const commands = [
 						{
 							name: "service-period-end",
 							jsonPath: ["servicePeriodEnd"],
-							description: "The last day of the period a milestone charge covers, on or after ServicePeriodStart",
+							description: "The last day of the period a milestone charge covers, on or after servicePeriodStart. It replaces and is ignored the same way as servicePeriodStart",
 							valueName: "value",
 							nullable: true,
 							schema: z.string()
@@ -6601,7 +6848,7 @@ const commands = [
 						{
 							name: "service-period-start",
 							jsonPath: ["servicePeriodStart"],
-							description: "The first day of the period a milestone charge covers",
+							description: "The first day of the period a milestone charge covers. On a milestone charge it replaces the charge's start, and omitting it leaves the charge with no start. A periodic charge ignores it",
 							valueName: "value",
 							nullable: true,
 							schema: z.string()
@@ -6617,10 +6864,10 @@ const commands = [
 						{
 							name: "total-price-override-value",
 							jsonPath: ["totalPriceOverride", "amount"],
-							description: "The amount to bill now when a FIXED charge is split, from 0 to the charge's total price, and is refused when the charge is not split or is priced PER_UNIT: the value as a decimal string with two decimal places, given with --total-price-override-iso-code",
+							description: "The amount to bill now when a FIXED charge is split, from 0 to the charge's total price, and is refused when the charge is not split or is priced PER_UNIT: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --total-price-override-iso-code",
 							valueName: "value",
 							together: ["total-price-override-iso-code"],
-							schema: z.string()
+							schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 						},
 						{
 							name: "total-price-override-iso-code",
@@ -6652,7 +6899,7 @@ const commands = [
 					bodyFlags: [{
 						name: "expected-billable-date",
 						jsonPath: ["expectedBillableDate"],
-						description: "The new day a periodic charge is planned to become billable, or omitted to keep the day it has",
+						description: "The new day a periodic charge is planned to become billable, or omitted to keep the day it has. A milestone charge, and a charge that is already planned, keep their day",
 						valueName: "value",
 						nullable: true,
 						schema: z.string()
@@ -7011,15 +7258,19 @@ const commands = [
 						{
 							name: "file-type",
 							jsonPath: ["fileType"],
-							description: "The kind of file uploaded, ASSET_FILE for an asset or PURCHASE_ORDER_FILE for a purchase order, the only kinds the API uploads",
+							description: "The kind of file uploaded, ASSET_FILE for an asset, PURCHASE_ORDER_FILE for a purchase order or RETURN_ORDER_FILE for a return order, the only kinds the API uploads",
 							valueName: "value",
 							required: true,
-							schema: toEnum(["ASSET_FILE", "PURCHASE_ORDER_FILE"])
+							schema: toEnum([
+								"ASSET_FILE",
+								"PURCHASE_ORDER_FILE",
+								"RETURN_ORDER_FILE"
+							])
 						},
 						{
 							name: "for-entity",
 							jsonPath: ["forEntity"],
-							description: "The ID of the asset or purchase order the file is attached to, which FileType names the kind of",
+							description: "The ID of the asset, purchase order or return order the file is attached to, which fileType names the kind of",
 							valueName: "uuid",
 							required: true,
 							schema: z.uuid()
@@ -7888,10 +8139,10 @@ const commands = [
 							{
 								name: "allocated-indirect-value",
 								jsonPath: ["allocatedIndirect", "amount"],
-								description: "One unit's share of overhead, a cost component: the value as a decimal string with two decimal places, given with --allocated-indirect-iso-code",
+								description: "One unit's share of overhead, a cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --allocated-indirect-iso-code",
 								valueName: "value",
 								together: ["allocated-indirect-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "allocated-indirect-iso-code",
@@ -7917,10 +8168,10 @@ const commands = [
 							{
 								name: "bill-of-materials-value",
 								jsonPath: ["billOfMaterials", "amount"],
-								description: "The parts cost of one unit, a cost component: the value as a decimal string with two decimal places, given with --bill-of-materials-iso-code",
+								description: "The parts cost of one unit, a cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --bill-of-materials-iso-code",
 								valueName: "value",
 								together: ["bill-of-materials-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "bill-of-materials-iso-code",
@@ -7938,7 +8189,7 @@ const commands = [
 							{
 								name: "cost-currency-code",
 								jsonPath: ["costCurrencyCode"],
-								description: "The ISO 4217 code every cost amount is denominated in, which must match the amounts sent and cannot be null",
+								description: "The ISO 4217 code every cost amount is denominated in, which must match the amounts sent and cannot be null. It is the only way to change the currency. A change keeps the held amounts and relabels them without conversion, and an asset whose currency is locked refuses it",
 								valueName: "value",
 								schema: toEnum([
 									"CAD",
@@ -7971,10 +8222,10 @@ const commands = [
 							{
 								name: "direct-labor-value",
 								jsonPath: ["directLabor", "amount"],
-								description: "The labor cost to build one unit, a cost component: the value as a decimal string with two decimal places, given with --direct-labor-iso-code",
+								description: "The labor cost to build one unit, a cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --direct-labor-iso-code",
 								valueName: "value",
 								together: ["direct-labor-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "direct-labor-iso-code",
@@ -8000,10 +8251,10 @@ const commands = [
 							{
 								name: "freight-inbound-value",
 								jsonPath: ["freightInbound", "amount"],
-								description: "The shipping cost to receive one unit, a cost component: the value as a decimal string with two decimal places, given with --freight-inbound-iso-code",
+								description: "The shipping cost to receive one unit, a cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --freight-inbound-iso-code",
 								valueName: "value",
 								together: ["freight-inbound-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "freight-inbound-iso-code",
@@ -8029,10 +8280,10 @@ const commands = [
 							{
 								name: "freight-outbound-value",
 								jsonPath: ["freightOutbound", "amount"],
-								description: "The shipping cost to deploy one unit, a deployment cost component: the value as a decimal string with two decimal places, given with --freight-outbound-iso-code",
+								description: "The shipping cost to deploy one unit, a deployment cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --freight-outbound-iso-code",
 								valueName: "value",
 								together: ["freight-outbound-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "freight-outbound-iso-code",
@@ -8058,10 +8309,10 @@ const commands = [
 							{
 								name: "installation-value",
 								jsonPath: ["installation", "amount"],
-								description: "The cost to install one unit, a deployment cost component: the value as a decimal string with two decimal places, given with --installation-iso-code",
+								description: "The cost to install one unit, a deployment cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --installation-iso-code",
 								valueName: "value",
 								together: ["installation-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "installation-iso-code",
@@ -8087,10 +8338,10 @@ const commands = [
 							{
 								name: "interest-value",
 								jsonPath: ["interest", "amount"],
-								description: "The financing cost of one unit, a cost component: the value as a decimal string with two decimal places, given with --interest-iso-code",
+								description: "The financing cost of one unit, a cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --interest-iso-code",
 								valueName: "value",
 								together: ["interest-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "interest-iso-code",
@@ -8116,10 +8367,10 @@ const commands = [
 							{
 								name: "salvage-value-value",
 								jsonPath: ["salvageValue", "amount"],
-								description: "The value one unit keeps at the end of its useful life: the value as a decimal string with two decimal places, given with --salvage-value-iso-code",
+								description: "The value one unit keeps at the end of its useful life: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --salvage-value-iso-code",
 								valueName: "value",
 								together: ["salvage-value-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "salvage-value-iso-code",
@@ -8145,10 +8396,10 @@ const commands = [
 							{
 								name: "simple-cost-basis-value",
 								jsonPath: ["simpleCostBasis", "amount"],
-								description: "A single cost for one unit, which cannot be sent together with the cost components: the value as a decimal string with two decimal places, given with --simple-cost-basis-iso-code",
+								description: "A single cost for one unit, which cannot be sent together with the cost components: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --simple-cost-basis-iso-code",
 								valueName: "value",
 								together: ["simple-cost-basis-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "simple-cost-basis-iso-code",
@@ -8174,10 +8425,10 @@ const commands = [
 							{
 								name: "tariffs-value",
 								jsonPath: ["tariffs", "amount"],
-								description: "The import duty paid on one unit, a cost component: the value as a decimal string with two decimal places, given with --tariffs-iso-code",
+								description: "The import duty paid on one unit, a cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --tariffs-iso-code",
 								valueName: "value",
 								together: ["tariffs-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "tariffs-iso-code",
@@ -8203,10 +8454,10 @@ const commands = [
 							{
 								name: "tax-value",
 								jsonPath: ["tax", "amount"],
-								description: "The tax paid on one unit, a cost component: the value as a decimal string with two decimal places, given with --tax-iso-code",
+								description: "The tax paid on one unit, a cost component: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --tax-iso-code",
 								valueName: "value",
 								together: ["tax-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "tax-iso-code",
@@ -9002,7 +9253,7 @@ const commands = [
 						{
 							name: "inherit-previous-line-items",
 							jsonPath: ["inheritPreviousLineItems"],
-							description: "Whether to copy the line items of the project this one renews, which applies only when PreviousProjectID is sent",
+							description: "Whether to copy the line items of the project this one renews, which applies only when previousProjectId is sent",
 							negatable: true,
 							nullable: true,
 							schema: z.boolean()
@@ -9087,55 +9338,126 @@ const commands = [
 								"totalOverride",
 								"unitPrice"
 							],
-							schema: z.array(z.string())
-						},
-						{
-							name: "name",
-							jsonPath: ["name"],
-							description: "The project's name, which no other project in the organization may share",
-							valueName: "value",
-							required: true,
-							schema: z.string()
-						},
-						{
-							name: "previous-project-id",
-							jsonPath: ["previousProjectId"],
-							description: "The ID of the project this one renews",
-							valueName: "uuid",
-							nullable: true,
-							schema: z.uuid()
-						},
-						{
-							name: "start-on",
-							jsonPath: ["startOn"],
-							description: "The day the project starts",
-							valueName: "value",
-							nullable: true,
-							schema: z.string()
-						},
-						{
-							name: "total-contract-value",
-							jsonPath: ["totalContractValue"],
-							description: "The contract's total value. Takes only null, which clears it",
-							valueName: "null",
-							nullable: true,
-							schema: z.null()
-						},
-						{
-							name: "total-contract-value-value",
-							jsonPath: ["totalContractValue", "amount"],
-							description: "The contract's total value: the value as a decimal string with two decimal places, given with --total-contract-value-iso-code",
-							valueName: "value",
-							together: ["total-contract-value-iso-code"],
-							schema: z.string()
-						},
-						{
-							name: "total-contract-value-iso-code",
-							jsonPath: ["totalContractValue", "isoCode"],
-							description: "The contract's total value: the value's ISO 4217 currency code, given with --total-contract-value-value",
-							valueName: "value",
-							together: ["total-contract-value-value"],
-							schema: toEnum([
+							elementEnums: {
+								"billingFrequency": [
+									"ANNUALLY",
+									"BIENNIALLY",
+									"BIWEEKLY",
+									"DAILY",
+									"MONTHLY",
+									"ONCE",
+									"QUADRENNIALLY",
+									"QUARTERLY",
+									"QUINQUENNIALLY",
+									"SEMIANNUALLY",
+									"TRIENNIALLY",
+									"WEEKLY"
+								],
+								"chargeFrequency": [
+									"ANNUALLY",
+									"BIENNIALLY",
+									"BIWEEKLY",
+									"DAILY",
+									"MONTHLY",
+									"ONCE",
+									"QUADRENNIALLY",
+									"QUARTERLY",
+									"QUINQUENNIALLY",
+									"SEMIANNUALLY",
+									"TRIENNIALLY",
+									"WEEKLY"
+								],
+								"chargeSchedule": ["MILESTONE", "PERIODIC"],
+								"fixedPrice.isoCode": [
+									"CAD",
+									"EUR",
+									"GBP",
+									"USD"
+								],
+								"invoiceFrequency": [
+									"ANNUALLY",
+									"BIENNIALLY",
+									"BIWEEKLY",
+									"DAILY",
+									"MONTHLY",
+									"ONCE",
+									"QUADRENNIALLY",
+									"QUARTERLY",
+									"QUINQUENNIALLY",
+									"SEMIANNUALLY",
+									"TRIENNIALLY",
+									"WEEKLY"
+								],
+								"invoiceMode": ["ADVANCE", "ARREARS"],
+								"pricingMode": ["FIXED", "PER_UNIT"],
+								"totalOverride.isoCode": [
+									"CAD",
+									"EUR",
+									"GBP",
+									"USD"
+								],
+								"transactionType": ["SALE", "SERVICE"],
+								"unitPrice.isoCode": [
+									"CAD",
+									"EUR",
+									"GBP",
+									"USD"
+								]
+							},
+							elementPatterns: {
+								"fixedPrice.amount": "^[^-]",
+								"totalOverride.amount": "^[^-]",
+								"unitPrice.amount": "^[^-]"
+							},
+							schema: z.array(z.string())
+						},
+						{
+							name: "name",
+							jsonPath: ["name"],
+							description: "The project's name, which no other project in the organization may share",
+							valueName: "value",
+							required: true,
+							schema: z.string()
+						},
+						{
+							name: "previous-project-id",
+							jsonPath: ["previousProjectId"],
+							description: "The ID of the project this one renews",
+							valueName: "uuid",
+							nullable: true,
+							schema: z.uuid()
+						},
+						{
+							name: "start-on",
+							jsonPath: ["startOn"],
+							description: "The day the project starts",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "total-contract-value",
+							jsonPath: ["totalContractValue"],
+							description: "The contract's total value. Takes only null, which clears it",
+							valueName: "null",
+							nullable: true,
+							schema: z.null()
+						},
+						{
+							name: "total-contract-value-value",
+							jsonPath: ["totalContractValue", "amount"],
+							description: "The contract's total value: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --total-contract-value-iso-code",
+							valueName: "value",
+							together: ["total-contract-value-iso-code"],
+							schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
+						},
+						{
+							name: "total-contract-value-iso-code",
+							jsonPath: ["totalContractValue", "isoCode"],
+							description: "The contract's total value: the value's ISO 4217 currency code, given with --total-contract-value-value",
+							valueName: "value",
+							together: ["total-contract-value-value"],
+							schema: toEnum([
 								"CAD",
 								"EUR",
 								"GBP",
@@ -9145,7 +9467,7 @@ const commands = [
 						{
 							name: "workflow-id",
 							jsonPath: ["workflowId"],
-							description: "The ID of the workflow to put the project on",
+							description: "The ID of the workflow to put the project on. A project created without one has no workflow",
 							valueName: "uuid",
 							nullable: true,
 							schema: z.uuid()
@@ -9262,10 +9584,10 @@ const commands = [
 						{
 							name: "discount-value",
 							jsonPath: ["discount", "amount"],
-							description: "The discount applied to the project: the value as a decimal string with two decimal places, given with --discount-iso-code",
+							description: "The discount applied to the project: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --discount-iso-code",
 							valueName: "value",
 							together: ["discount-iso-code"],
-							schema: z.string()
+							schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 						},
 						{
 							name: "discount-iso-code",
@@ -9315,7 +9637,7 @@ const commands = [
 						{
 							name: "line-item",
 							jsonPath: ["lineItems"],
-							description: "The project's line items. Takes activationDate=, aggregationKey=, billingFrequency=, chargeFrequency=, chargeSchedule=, details=, endOn=, fixedPrice=, fixedPrice.amount=, fixedPrice.isoCode=, id=, invoiceFrequency=, invoiceMode=, itemId=, locationId=, milestonePhases=, pricingMode=, quantity=, startOn=, totalOverride=, totalOverride.amount=, totalOverride.isoCode=, transactionType=, unitPrice=, unitPrice.amount=, unitPrice.isoCode=",
+							description: "The project's line items. The list sent replaces the project's line items. Takes activationDate=, aggregationKey=, billingFrequency=, chargeFrequency=, chargeSchedule=, details=, endOn=, fixedPrice=, fixedPrice.amount=, fixedPrice.isoCode=, id=, invoiceFrequency=, invoiceMode=, itemId=, locationId=, milestonePhases=, pricingMode=, quantity=, startOn=, totalOverride=, totalOverride.amount=, totalOverride.isoCode=, transactionType=, unitPrice=, unitPrice.amount=, unitPrice.isoCode=",
 							valueName: "field=value,...",
 							repeatable: true,
 							element: [
@@ -9376,6 +9698,77 @@ const commands = [
 								"totalOverride",
 								"unitPrice"
 							],
+							elementEnums: {
+								"billingFrequency": [
+									"ANNUALLY",
+									"BIENNIALLY",
+									"BIWEEKLY",
+									"DAILY",
+									"MONTHLY",
+									"ONCE",
+									"QUADRENNIALLY",
+									"QUARTERLY",
+									"QUINQUENNIALLY",
+									"SEMIANNUALLY",
+									"TRIENNIALLY",
+									"WEEKLY"
+								],
+								"chargeFrequency": [
+									"ANNUALLY",
+									"BIENNIALLY",
+									"BIWEEKLY",
+									"DAILY",
+									"MONTHLY",
+									"ONCE",
+									"QUADRENNIALLY",
+									"QUARTERLY",
+									"QUINQUENNIALLY",
+									"SEMIANNUALLY",
+									"TRIENNIALLY",
+									"WEEKLY"
+								],
+								"chargeSchedule": ["MILESTONE", "PERIODIC"],
+								"fixedPrice.isoCode": [
+									"CAD",
+									"EUR",
+									"GBP",
+									"USD"
+								],
+								"invoiceFrequency": [
+									"ANNUALLY",
+									"BIENNIALLY",
+									"BIWEEKLY",
+									"DAILY",
+									"MONTHLY",
+									"ONCE",
+									"QUADRENNIALLY",
+									"QUARTERLY",
+									"QUINQUENNIALLY",
+									"SEMIANNUALLY",
+									"TRIENNIALLY",
+									"WEEKLY"
+								],
+								"invoiceMode": ["ADVANCE", "ARREARS"],
+								"pricingMode": ["FIXED", "PER_UNIT"],
+								"totalOverride.isoCode": [
+									"CAD",
+									"EUR",
+									"GBP",
+									"USD"
+								],
+								"transactionType": ["SALE", "SERVICE"],
+								"unitPrice.isoCode": [
+									"CAD",
+									"EUR",
+									"GBP",
+									"USD"
+								]
+							},
+							elementPatterns: {
+								"fixedPrice.amount": "^[^-]",
+								"totalOverride.amount": "^[^-]",
+								"unitPrice.amount": "^[^-]"
+							},
 							schema: z.array(z.string())
 						},
 						{
@@ -9445,10 +9838,10 @@ const commands = [
 						{
 							name: "total-contract-value-value",
 							jsonPath: ["totalContractValue", "amount"],
-							description: "The contract's total value: the value as a decimal string with two decimal places, given with --total-contract-value-iso-code",
+							description: "The contract's total value: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --total-contract-value-iso-code",
 							valueName: "value",
 							together: ["total-contract-value-iso-code"],
-							schema: z.string()
+							schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 						},
 						{
 							name: "total-contract-value-iso-code",
@@ -9544,7 +9937,7 @@ const commands = [
 							{
 								name: "charge-frequency",
 								jsonPath: ["chargeFrequency"],
-								description: "How often a periodic line item creates a charge, and is refused unless ChargeSchedule is PERIODIC",
+								description: "How often a periodic line item creates a charge, and is refused unless chargeSchedule is PERIODIC",
 								valueName: "value",
 								nullable: true,
 								schema: toEnum([
@@ -9565,7 +9958,7 @@ const commands = [
 							{
 								name: "charge-mode",
 								jsonPath: ["chargeMode"],
-								description: "CONFIRMED when ActivationDate is sent, or PENDING when it is null, and a MILESTONE line item is CONFIRMED with no ActivationDate",
+								description: "CONFIRMED when activationDate is sent, or PENDING when it is null, and a MILESTONE line item is CONFIRMED with no activationDate",
 								valueName: "value",
 								nullable: true,
 								schema: toEnum(["CONFIRMED", "PENDING"])
@@ -9581,7 +9974,7 @@ const commands = [
 							{
 								name: "charge",
 								jsonPath: ["charges"],
-								description: "The line item's whole charge list, which replaces the charges it has, or omitted to leave them as they are. Takes expectedBillableDate=, id=, isCustomModified=, label=, pricingMode=, quantity=, sequence=, servicePeriodEnd=, servicePeriodStart=, status=, totalPrice.amount=, totalPrice.isoCode=, triggerType=, unitPrice=, unitPrice.amount=, unitPrice.isoCode=",
+								description: "The line item's whole charge list, which replaces the charges it has, or omitted to leave them as they are. An INVOICED charge stays as it is stored, whatever the list sends for it. Takes expectedBillableDate=, id=, isCustomModified=, label=, pricingMode=, quantity=, sequence=, servicePeriodEnd=, servicePeriodStart=, status=, totalPrice.amount=, totalPrice.isoCode=, triggerType=, unitPrice=, unitPrice.amount=, unitPrice.isoCode=",
 								valueName: "field=value,...",
 								repeatable: true,
 								element: [
@@ -9614,6 +10007,36 @@ const commands = [
 									"unitPrice": ["null"]
 								},
 								elementMoney: ["totalPrice", "unitPrice"],
+								elementEnums: {
+									"pricingMode": ["FIXED", "PER_UNIT"],
+									"status": [
+										"BILLABLE",
+										"CANCELLED",
+										"INVOICED",
+										"PLANNED"
+									],
+									"totalPrice.isoCode": [
+										"CAD",
+										"EUR",
+										"GBP",
+										"USD"
+									],
+									"triggerType": [
+										"EVENT",
+										"MANUAL",
+										"TIME"
+									],
+									"unitPrice.isoCode": [
+										"CAD",
+										"EUR",
+										"GBP",
+										"USD"
+									]
+								},
+								elementPatterns: {
+									"totalPrice.amount": "^[^-]",
+									"unitPrice.amount": "^[^-]"
+								},
 								schema: z.array(z.string())
 							},
 							{
@@ -9627,7 +10050,7 @@ const commands = [
 							{
 								name: "fixed-price",
 								jsonPath: ["fixedPrice"],
-								description: "The flat price when PricingMode is FIXED, and is not sent together with UnitPrice. Takes only null, which clears it",
+								description: "The flat price when pricingMode is FIXED, and is not sent together with unitPrice. Takes only null, which clears it",
 								valueName: "null",
 								nullable: true,
 								schema: z.null()
@@ -9635,15 +10058,15 @@ const commands = [
 							{
 								name: "fixed-price-value",
 								jsonPath: ["fixedPrice", "amount"],
-								description: "The flat price when PricingMode is FIXED, and is not sent together with UnitPrice: the value as a decimal string with two decimal places, given with --fixed-price-iso-code",
+								description: "The flat price when pricingMode is FIXED, and is not sent together with unitPrice: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --fixed-price-iso-code",
 								valueName: "value",
 								together: ["fixed-price-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "fixed-price-iso-code",
 								jsonPath: ["fixedPrice", "isoCode"],
-								description: "The flat price when PricingMode is FIXED, and is not sent together with UnitPrice: the value's ISO 4217 currency code, given with --fixed-price-value",
+								description: "The flat price when pricingMode is FIXED, and is not sent together with unitPrice: the value's ISO 4217 currency code, given with --fixed-price-value",
 								valueName: "value",
 								together: ["fixed-price-value"],
 								schema: toEnum([
@@ -9656,14 +10079,14 @@ const commands = [
 							{
 								name: "generate",
 								jsonPath: ["generate"],
-								description: "True to replace the line item's charges with the schedule its billing plan produces, and is not sent together with Charges",
+								description: "True to replace the line item's charges with the schedule its billing plan produces, and is not sent together with charges. A periodic plan needs its dates and its cadence, and generation is refused once a charge is INVOICED",
 								negatable: true,
 								schema: z.boolean()
 							},
 							{
 								name: "invoice-frequency",
 								jsonPath: ["invoiceFrequency"],
-								description: "How often a periodic line item's charges are invoiced, which is never more often than ChargeFrequency",
+								description: "How often a periodic line item's charges are invoiced, which is never more often than chargeFrequency",
 								valueName: "value",
 								nullable: true,
 								schema: toEnum([
@@ -9684,7 +10107,7 @@ const commands = [
 							{
 								name: "invoice-mode",
 								jsonPath: ["invoiceMode"],
-								description: "ADVANCE to invoice a period before it starts, or ARREARS to invoice it after it ends, and is refused unless ChargeSchedule is PERIODIC",
+								description: "ADVANCE to invoice a period before it starts, or ARREARS to invoice it after it ends, and is refused unless chargeSchedule is PERIODIC",
 								valueName: "value",
 								nullable: true,
 								schema: toEnum(["ADVANCE", "ARREARS"])
@@ -9757,10 +10180,10 @@ const commands = [
 							{
 								name: "total-override-value",
 								jsonPath: ["totalOverride", "amount"],
-								description: "A negotiated total for a periodic line item that replaces the computed one, in the project's currency: the value as a decimal string with two decimal places, given with --total-override-iso-code",
+								description: "A negotiated total for a periodic line item that replaces the computed one, in the project's currency: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --total-override-iso-code",
 								valueName: "value",
 								together: ["total-override-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "total-override-iso-code",
@@ -9786,7 +10209,7 @@ const commands = [
 							{
 								name: "unit-price",
 								jsonPath: ["unitPrice"],
-								description: "The price of one unit for each charge, and is not sent together with FixedPrice. Takes only null, which clears it",
+								description: "The price of one unit for each charge, and is not sent together with fixedPrice. Takes only null, which clears it",
 								valueName: "null",
 								nullable: true,
 								schema: z.null()
@@ -9794,15 +10217,15 @@ const commands = [
 							{
 								name: "unit-price-value",
 								jsonPath: ["unitPrice", "amount"],
-								description: "The price of one unit for each charge, and is not sent together with FixedPrice: the value as a decimal string with two decimal places, given with --unit-price-iso-code",
+								description: "The price of one unit for each charge, and is not sent together with fixedPrice: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --unit-price-iso-code",
 								valueName: "value",
 								together: ["unit-price-iso-code"],
-								schema: z.string()
+								schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 							},
 							{
 								name: "unit-price-iso-code",
 								jsonPath: ["unitPrice", "isoCode"],
-								description: "The price of one unit for each charge, and is not sent together with FixedPrice: the value's ISO 4217 currency code, given with --unit-price-value",
+								description: "The price of one unit for each charge, and is not sent together with fixedPrice: the value's ISO 4217 currency code, given with --unit-price-value",
 								valueName: "value",
 								together: ["unit-price-value"],
 								schema: toEnum([
@@ -9842,18 +10265,713 @@ const commands = [
 			]
 		},
 		{
-			name: "purchase-order",
-			summary: "Purchase order commands",
+			name: "purchase-order",
+			summary: "Purchase order commands",
+			arguments: [],
+			flags: [],
+			examples: [],
+			subcommands: [
+				defineOperation({
+					name: "list",
+					summary: "List purchase orders",
+					example: "hardfin purchase-order list --limit 10",
+					method: "GET",
+					path: "/purchase-order",
+					pathParameters: [],
+					queryFlags: [
+						{
+							name: "page",
+							queryName: "page",
+							description: "The page to return, starting at 1",
+							valueName: "number",
+							schema: toNumber(z.number().int())
+						},
+						{
+							name: "limit",
+							queryName: "limit",
+							description: "The number of records per page, from 1 to 100",
+							valueName: "number",
+							schema: toNumber(z.number().int().min(1).max(100))
+						},
+						{
+							name: "sort-by",
+							queryName: "sortBy",
+							description: "The field to sort by",
+							valueName: "value",
+							schema: toEnum([
+								"purchaseOrderNumber",
+								"status",
+								"promiseShipDate",
+								"promiseDeliveryDate"
+							])
+						},
+						{
+							name: "sort-order",
+							queryName: "sortOrder",
+							description: "The sort direction",
+							valueName: "value",
+							schema: toEnum(["ASC", "DESC"])
+						},
+						{
+							name: "archived",
+							queryName: "archived",
+							description: "Whether to return unarchived records, archived records, or all of them",
+							valueName: "value",
+							schema: toEnum([
+								"all",
+								"false",
+								"true"
+							])
+						},
+						{
+							name: "search",
+							queryName: "search",
+							description: "Text to find in the order's number, its status, its supplier's name, its locations' names, or its items' names and SKUs",
+							valueName: "value",
+							schema: z.string()
+						},
+						{
+							name: "purchase-order-keys",
+							queryName: "purchaseOrderKeys",
+							description: "The keys of the purchase orders to list, and an order named here or in purchaseOrderIds is listed",
+							valueName: "value",
+							repeatable: true,
+							schema: z.array(z.string())
+						},
+						{
+							name: "purchase-order-ids",
+							queryName: "purchaseOrderIds",
+							description: "The IDs of the purchase orders to list, and an order named here or in purchaseOrderKeys is listed",
+							valueName: "uuid",
+							repeatable: true,
+							schema: z.array(z.uuid())
+						},
+						{
+							name: "supplier-ids",
+							queryName: "supplierIds",
+							description: "The IDs of suppliers, and orders placed with one of them are listed",
+							valueName: "uuid",
+							repeatable: true,
+							schema: z.array(z.uuid())
+						},
+						{
+							name: "statuses",
+							queryName: "statuses",
+							description: "The statuses to list, as the order's status field spells them",
+							valueName: "value",
+							repeatable: true,
+							schema: z.array(toEnum([
+								"AWAITING_3PL",
+								"CANCELLED",
+								"DELIVERED_FULL",
+								"DELIVERED_OVERAGE",
+								"DELIVERED_PARTIAL",
+								"DRAFT",
+								"OPEN_FULL",
+								"OPEN_OVERAGE",
+								"OPEN_PARTIAL",
+								"RECEIVED_FULL",
+								"RECEIVED_OVERAGE",
+								"RECEIVED_PARTIAL",
+								"SHIPPED_FULL",
+								"SHIPPED_OVERAGE",
+								"SHIPPED_PARTIAL"
+							]))
+						},
+						{
+							name: "from-location-ids",
+							queryName: "fromLocationIds",
+							description: "The IDs of locations, and orders shipping from one of them are listed",
+							valueName: "uuid",
+							repeatable: true,
+							schema: z.array(z.uuid())
+						},
+						{
+							name: "to-location-ids",
+							queryName: "toLocationIds",
+							description: "The IDs of locations, and orders delivered to one of them are listed",
+							valueName: "uuid",
+							repeatable: true,
+							schema: z.array(z.uuid())
+						},
+						{
+							name: "from-customer-ids",
+							queryName: "fromCustomerIds",
+							description: "The IDs of customers, and orders shipping from a location assigned to one of them are listed",
+							valueName: "uuid",
+							repeatable: true,
+							schema: z.array(z.uuid())
+						},
+						{
+							name: "to-customer-ids",
+							queryName: "toCustomerIds",
+							description: "The IDs of customers, and orders delivered to a location assigned to one of them are listed",
+							valueName: "uuid",
+							repeatable: true,
+							schema: z.array(z.uuid())
+						},
+						{
+							name: "from-location-company-types",
+							queryName: "fromLocationCompanyTypes",
+							description: "The kind of site listed orders ship from, a CUSTOMER site or one of the organization's own MANUFACTURER sites, and naming both filters nothing",
+							valueName: "value",
+							repeatable: true,
+							schema: z.array(toEnum(["CUSTOMER", "MANUFACTURER"]))
+						},
+						{
+							name: "to-location-company-types",
+							queryName: "toLocationCompanyTypes",
+							description: "The kind of site listed orders are delivered to, a CUSTOMER site or one of the organization's own MANUFACTURER sites, and naming both filters nothing",
+							valueName: "value",
+							repeatable: true,
+							schema: z.array(toEnum(["CUSTOMER", "MANUFACTURER"]))
+						}
+					],
+					bodyFlags: []
+				}),
+				defineOperation({
+					name: "create",
+					summary: "Create purchase order",
+					example: "hardfin purchase-order create --item itemId=<value>,requestedQuantity=<value> --supplier-id <uuid> --to-location-id <uuid>",
+					method: "POST",
+					path: "/purchase-order",
+					pathParameters: [],
+					queryFlags: [],
+					bodyFlags: [
+						{
+							name: "carrier",
+							jsonPath: ["carrier"],
+							description: "The carrier the supplier ships the order with. Takes only null, which clears it",
+							valueName: "null",
+							nullable: true,
+							schema: z.null()
+						},
+						{
+							name: "carrier-name",
+							jsonPath: ["carrier", "name"],
+							description: "The carrier's name, which is accepted only when type is other",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "carrier-tracking-number",
+							jsonPath: ["carrier", "trackingNumber"],
+							description: "The number the carrier tracks the shipment by, or null when it has none",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "carrier-type",
+							jsonPath: ["carrier", "type"],
+							description: "The carrier, or null when none is named",
+							valueName: "value",
+							nullable: true,
+							schema: toEnum([
+								"airterra",
+								"apc_postal",
+								"apg",
+								"aramex",
+								"asendia_us",
+								"australia_post",
+								"axlehire",
+								"better_trucks",
+								"borderguru",
+								"boxberry",
+								"bring",
+								"canada_post",
+								"cdl",
+								"chronopost",
+								"colissimo",
+								"collect_plus",
+								"correios_br",
+								"correos_espana",
+								"couriersplease",
+								"deutsche_post",
+								"dhl_benelux",
+								"dhl_ecommerce",
+								"dhl_express",
+								"dhl_germany",
+								"dhl_germany_c2c",
+								"dpd_de",
+								"dpd_uk",
+								"estafeta",
+								"fastway_australia",
+								"fedex",
+								"globegistics",
+								"gls_us",
+								"gophr",
+								"gso",
+								"hermes_germany_b2c",
+								"hermes_uk",
+								"hongkong_post",
+								"la_poste",
+								"lasership",
+								"lso",
+								"mondial_relay",
+								"new_zealand_post",
+								"nippon_express",
+								"ontrac",
+								"orangeds",
+								"other",
+								"parcel",
+								"parcelforce",
+								"passport",
+								"pcf",
+								"pitney_bowes",
+								"poste_italiane",
+								"posti",
+								"purolator",
+								"royal_mail",
+								"royal_mail_sf",
+								"rr_donnelley",
+								"russian_post",
+								"sendle",
+								"shippo",
+								"skypostal",
+								"stuart",
+								"swyft",
+								"uds",
+								"ups",
+								"usps",
+								"veho",
+								"x_delivery",
+								"yodel"
+							])
+						},
+						{
+							name: "external-purchase-order-number",
+							jsonPath: ["externalPurchaseOrderNumber"],
+							description: "The supplier's own number for the order, or null when it has none",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "from-location-id",
+							jsonPath: ["fromLocationId"],
+							description: "The ID of the location the supplier ships from, or null when the supplier has no location on record",
+							valueName: "uuid",
+							nullable: true,
+							schema: z.uuid()
+						},
+						{
+							name: "item",
+							jsonPath: ["items"],
+							description: "The order's lines, from 1 to 50 of them, each naming a different item",
+							valueName: "itemId=,requestedQuantity=",
+							repeatable: true,
+							required: true,
+							element: ["itemId", "requestedQuantity"],
+							elementUuids: ["itemId"],
+							elementTypes: { "requestedQuantity": ["integer"] },
+							schema: z.array(z.string())
+						},
+						{
+							name: "order-notes",
+							jsonPath: ["orderNotes"],
+							description: "A note about the order, where blank text is stored as null",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "promise-delivery-date",
+							jsonPath: ["promiseDeliveryDate"],
+							description: "The day the supplier promised the order would arrive",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "promise-ship-date",
+							jsonPath: ["promiseShipDate"],
+							description: "The day the supplier promised to ship the order",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "supplier-id",
+							jsonPath: ["supplierId"],
+							description: "The ID of the company the items are ordered from, which must be a supplier",
+							valueName: "uuid",
+							required: true,
+							schema: z.uuid()
+						},
+						{
+							name: "to-location-id",
+							jsonPath: ["toLocationId"],
+							description: "The ID of the location the order is delivered to",
+							valueName: "uuid",
+							required: true,
+							schema: z.uuid()
+						}
+					]
+				}),
+				defineOperation({
+					name: "get",
+					summary: "Get purchase order",
+					example: "hardfin purchase-order get po_7hq2mx9pkr4stz8w",
+					method: "GET",
+					path: "/purchase-order/{purchaseOrderKey}",
+					pathParameters: [{
+						name: "purchaseOrderKey",
+						description: "The purchase order's key",
+						required: true
+					}],
+					queryFlags: [],
+					bodyFlags: []
+				}),
+				defineOperation({
+					name: "update",
+					summary: "Update purchase order",
+					example: "hardfin purchase-order update po_7hq2mx9pkr4stz8w --item itemId=<value>,requestedQuantity=<value>",
+					method: "PATCH",
+					path: "/purchase-order/{purchaseOrderKey}",
+					pathParameters: [{
+						name: "purchaseOrderKey",
+						description: "The purchase order's key",
+						required: true
+					}],
+					queryFlags: [],
+					bodyFlags: [
+						{
+							name: "carrier",
+							jsonPath: ["carrier"],
+							description: "The carrier the supplier ships the order with, where a field left out keeps its stored value and null clears the whole carrier. Takes only null, which clears it",
+							valueName: "null",
+							nullable: true,
+							schema: z.null()
+						},
+						{
+							name: "carrier-name",
+							jsonPath: ["carrier", "name"],
+							description: "The carrier's name, which is accepted only when type is other",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "carrier-tracking-number",
+							jsonPath: ["carrier", "trackingNumber"],
+							description: "The number the carrier tracks the shipment by, or null when it has none",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "carrier-type",
+							jsonPath: ["carrier", "type"],
+							description: "The carrier, or null when none is named",
+							valueName: "value",
+							nullable: true,
+							schema: toEnum([
+								"airterra",
+								"apc_postal",
+								"apg",
+								"aramex",
+								"asendia_us",
+								"australia_post",
+								"axlehire",
+								"better_trucks",
+								"borderguru",
+								"boxberry",
+								"bring",
+								"canada_post",
+								"cdl",
+								"chronopost",
+								"colissimo",
+								"collect_plus",
+								"correios_br",
+								"correos_espana",
+								"couriersplease",
+								"deutsche_post",
+								"dhl_benelux",
+								"dhl_ecommerce",
+								"dhl_express",
+								"dhl_germany",
+								"dhl_germany_c2c",
+								"dpd_de",
+								"dpd_uk",
+								"estafeta",
+								"fastway_australia",
+								"fedex",
+								"globegistics",
+								"gls_us",
+								"gophr",
+								"gso",
+								"hermes_germany_b2c",
+								"hermes_uk",
+								"hongkong_post",
+								"la_poste",
+								"lasership",
+								"lso",
+								"mondial_relay",
+								"new_zealand_post",
+								"nippon_express",
+								"ontrac",
+								"orangeds",
+								"other",
+								"parcel",
+								"parcelforce",
+								"passport",
+								"pcf",
+								"pitney_bowes",
+								"poste_italiane",
+								"posti",
+								"purolator",
+								"royal_mail",
+								"royal_mail_sf",
+								"rr_donnelley",
+								"russian_post",
+								"sendle",
+								"shippo",
+								"skypostal",
+								"stuart",
+								"swyft",
+								"uds",
+								"ups",
+								"usps",
+								"veho",
+								"x_delivery",
+								"yodel"
+							])
+						},
+						{
+							name: "external-purchase-order-number",
+							jsonPath: ["externalPurchaseOrderNumber"],
+							description: "The supplier's own number for the order, or null when it has none",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "from-location-id",
+							jsonPath: ["fromLocationId"],
+							description: "The ID of the location the supplier ships from, or null when the supplier has no location on record",
+							valueName: "uuid",
+							nullable: true,
+							schema: z.uuid()
+						},
+						{
+							name: "item",
+							jsonPath: ["items"],
+							description: "The 1 to 50 lines that replace the order's, each naming a different item",
+							valueName: "itemId=,requestedQuantity=",
+							repeatable: true,
+							element: ["itemId", "requestedQuantity"],
+							elementUuids: ["itemId"],
+							elementTypes: { "requestedQuantity": ["integer"] },
+							schema: z.array(z.string())
+						},
+						{
+							name: "order-notes",
+							jsonPath: ["orderNotes"],
+							description: "A note about the order, which is the one field that can change after the order leaves draft, until it is received or cancelled",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "promise-delivery-date",
+							jsonPath: ["promiseDeliveryDate"],
+							description: "The day the supplier promised the order would arrive",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "promise-ship-date",
+							jsonPath: ["promiseShipDate"],
+							description: "The day the supplier promised to ship the order",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "supplier-id",
+							jsonPath: ["supplierId"],
+							description: "The ID of the company the items are ordered from, which must be a supplier",
+							valueName: "uuid",
+							nullable: true,
+							schema: z.uuid()
+						},
+						{
+							name: "to-location-id",
+							jsonPath: ["toLocationId"],
+							description: "The ID of the location the order is delivered to, which cannot be cleared",
+							valueName: "uuid",
+							nullable: true,
+							schema: z.uuid()
+						}
+					]
+				}),
+				defineOperation({
+					name: "resync-3pl-files",
+					summary: "Resync 3PL files",
+					example: "hardfin purchase-order resync-3pl-files po_7hq2mx9pkr4stz8w",
+					method: "POST",
+					path: "/purchase-order/{purchaseOrderKey}/3pl/files/resync",
+					pathParameters: [{
+						name: "purchaseOrderKey",
+						description: "The purchase order's key",
+						required: true
+					}],
+					queryFlags: [],
+					bodyFlags: []
+				}),
+				defineOperation({
+					name: "cancel",
+					summary: "Cancel purchase order",
+					example: "hardfin purchase-order cancel po_7hq2mx9pkr4stz8w --cancellation-reason <value>",
+					method: "POST",
+					path: "/purchase-order/{purchaseOrderKey}/cancel",
+					pathParameters: [{
+						name: "purchaseOrderKey",
+						description: "The purchase order's key",
+						required: true
+					}],
+					queryFlags: [],
+					bodyFlags: [{
+						name: "cancellation-reason",
+						jsonPath: ["cancellationReason"],
+						description: "Why the order is cancelled, which is required",
+						valueName: "value",
+						required: true,
+						schema: z.string()
+					}]
+				}),
+				{
+					name: "file",
+					summary: "File commands",
+					arguments: [],
+					flags: [],
+					examples: [],
+					subcommands: [defineOperation({
+						name: "list",
+						summary: "Get purchase order files",
+						example: "hardfin purchase-order file list po_7hq2mx9pkr4stz8w",
+						method: "GET",
+						path: "/purchase-order/{purchaseOrderKey}/file",
+						pathParameters: [{
+							name: "purchaseOrderKey",
+							description: "The purchase order's key",
+							required: true
+						}],
+						queryFlags: [],
+						bodyFlags: []
+					}), defineOperation({
+						name: "delete",
+						summary: "Unlink purchase order file",
+						example: "hardfin purchase-order file delete po_7hq2mx9pkr4stz8w file_7hq2mx9pkr4stz8w",
+						method: "DELETE",
+						path: "/purchase-order/{purchaseOrderKey}/file/{fileKey}",
+						pathParameters: [{
+							name: "purchaseOrderKey",
+							description: "The purchase order's key",
+							required: true
+						}, {
+							name: "fileKey",
+							description: "The key of the file to detach",
+							required: true
+						}],
+						queryFlags: [],
+						bodyFlags: []
+					})]
+				},
+				defineOperation({
+					name: "resync",
+					summary: "Resync purchase order",
+					example: "hardfin purchase-order resync po_7hq2mx9pkr4stz8w",
+					method: "POST",
+					path: "/purchase-order/{purchaseOrderKey}/resync",
+					pathParameters: [{
+						name: "purchaseOrderKey",
+						description: "The purchase order's key",
+						required: true
+					}],
+					queryFlags: [],
+					bodyFlags: []
+				}),
+				defineOperation({
+					name: "send-to-3pl",
+					summary: "Send purchase order to 3PL",
+					example: "hardfin purchase-order send-to-3pl po_7hq2mx9pkr4stz8w",
+					method: "POST",
+					path: "/purchase-order/{purchaseOrderKey}/send-to-3pl",
+					pathParameters: [{
+						name: "purchaseOrderKey",
+						description: "The purchase order's key",
+						required: true
+					}],
+					queryFlags: [],
+					bodyFlags: []
+				}),
+				{
+					name: "url-link",
+					summary: "URL link commands",
+					arguments: [],
+					flags: [],
+					examples: [],
+					subcommands: [defineOperation({
+						name: "list",
+						summary: "Get purchase order URL links",
+						example: "hardfin purchase-order url-link list po_7hq2mx9pkr4stz8w",
+						method: "GET",
+						path: "/purchase-order/{purchaseOrderKey}/url-link",
+						pathParameters: [{
+							name: "purchaseOrderKey",
+							description: "The purchase order's key",
+							required: true
+						}],
+						queryFlags: [],
+						bodyFlags: []
+					}), defineOperation({
+						name: "create",
+						summary: "Create purchase order URL link",
+						example: "hardfin purchase-order url-link create po_7hq2mx9pkr4stz8w --url <value>",
+						method: "POST",
+						path: "/purchase-order/{purchaseOrderKey}/url-link",
+						pathParameters: [{
+							name: "purchaseOrderKey",
+							description: "The purchase order's key",
+							required: true
+						}],
+						queryFlags: [],
+						bodyFlags: [{
+							name: "name",
+							jsonPath: ["name"],
+							description: "The link's display name, or null to show the address instead",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						}, {
+							name: "url",
+							jsonPath: ["url"],
+							description: "The address the link points to",
+							valueName: "value",
+							required: true,
+							schema: z.string()
+						}]
+					})]
+				}
+			]
+		},
+		{
+			name: "return-order",
+			summary: "Return order commands",
 			arguments: [],
 			flags: [],
 			examples: [],
 			subcommands: [
 				defineOperation({
 					name: "list",
-					summary: "List purchase orders",
-					example: "hardfin purchase-order list --limit 10",
+					summary: "List return orders",
+					example: "hardfin return-order list --limit 10",
 					method: "GET",
-					path: "/purchase-order",
+					path: "/return-order",
 					pathParameters: [],
 					queryFlags: [
 						{
@@ -9876,8 +10994,9 @@ const commands = [
 							description: "The field to sort by",
 							valueName: "value",
 							schema: toEnum([
-								"purchaseOrderNumber",
+								"returnOrderNumber",
 								"status",
+								"returnType",
 								"promiseShipDate",
 								"promiseDeliveryDate"
 							])
@@ -9903,33 +11022,44 @@ const commands = [
 						{
 							name: "search",
 							queryName: "search",
-							description: "Text to find in the order's number, its status, its supplier's name, its locations' names, or its items' names and SKUs",
+							description: "Text to find in the order's number, its status, its return type, its locations' names, or its items' names and SKUs",
 							valueName: "value",
 							schema: z.string()
 						},
 						{
-							name: "purchase-order-keys",
-							queryName: "purchaseOrderKeys",
-							description: "The keys of the purchase orders to list, and an order named here or in PurchaseOrderIDs is listed",
+							name: "return-order-keys",
+							queryName: "returnOrderKeys",
+							description: "The keys of the return orders to list, and an order named here or in returnOrderIds is listed",
 							valueName: "value",
 							repeatable: true,
 							schema: z.array(z.string())
 						},
 						{
-							name: "purchase-order-ids",
-							queryName: "purchaseOrderIds",
-							description: "The IDs of the purchase orders to list, and an order named here or in PurchaseOrderKeys is listed",
+							name: "return-order-ids",
+							queryName: "returnOrderIds",
+							description: "The IDs of the return orders to list, and an order named here or in returnOrderKeys is listed",
 							valueName: "uuid",
 							repeatable: true,
 							schema: z.array(z.uuid())
 						},
 						{
-							name: "supplier-ids",
-							queryName: "supplierIds",
-							description: "The IDs of suppliers, and orders placed with one of them are listed",
-							valueName: "uuid",
+							name: "types",
+							queryName: "types",
+							description: "The return types to list, as the order's returnType field spells them",
+							valueName: "value",
 							repeatable: true,
-							schema: z.array(z.uuid())
+							schema: z.array(toEnum([
+								"CUSTOMER_CANCELLATION",
+								"DAMAGED",
+								"DEFECTIVE",
+								"END_OF_SERVICE",
+								"INCORRECT_SPEC",
+								"NOT_NEEDED",
+								"OTHER",
+								"PROVISIONING",
+								"UPGRADE",
+								"WRONG_ITEM"
+							]))
 						},
 						{
 							name: "statuses",
@@ -9958,7 +11088,7 @@ const commands = [
 						{
 							name: "from-location-ids",
 							queryName: "fromLocationIds",
-							description: "The IDs of locations, and orders shipping from one of them are listed",
+							description: "The IDs of locations, and orders returned from one of them are listed",
 							valueName: "uuid",
 							repeatable: true,
 							schema: z.array(z.uuid())
@@ -9966,7 +11096,7 @@ const commands = [
 						{
 							name: "to-location-ids",
 							queryName: "toLocationIds",
-							description: "The IDs of locations, and orders delivered to one of them are listed",
+							description: "The IDs of locations, and orders returned to one of them are listed",
 							valueName: "uuid",
 							repeatable: true,
 							schema: z.array(z.uuid())
@@ -9974,7 +11104,7 @@ const commands = [
 						{
 							name: "from-customer-ids",
 							queryName: "fromCustomerIds",
-							description: "The IDs of customers, and orders shipping from a location assigned to one of them are listed",
+							description: "The IDs of customers, and orders returned from a location assigned to one of them are listed",
 							valueName: "uuid",
 							repeatable: true,
 							schema: z.array(z.uuid())
@@ -9982,7 +11112,7 @@ const commands = [
 						{
 							name: "to-customer-ids",
 							queryName: "toCustomerIds",
-							description: "The IDs of customers, and orders delivered to a location assigned to one of them are listed",
+							description: "The IDs of customers, and orders returned to a location assigned to one of them are listed",
 							valueName: "uuid",
 							repeatable: true,
 							schema: z.array(z.uuid())
@@ -9990,7 +11120,7 @@ const commands = [
 						{
 							name: "from-location-company-types",
 							queryName: "fromLocationCompanyTypes",
-							description: "The kind of site listed orders ship from, a CUSTOMER site or one of the organization's own MANUFACTURER sites, and naming both filters nothing",
+							description: "The kind of site listed orders are returned from, a CUSTOMER site or one of the organization's own MANUFACTURER sites, and naming both filters nothing",
 							valueName: "value",
 							repeatable: true,
 							schema: z.array(toEnum(["CUSTOMER", "MANUFACTURER"]))
@@ -9998,7 +11128,7 @@ const commands = [
 						{
 							name: "to-location-company-types",
 							queryName: "toLocationCompanyTypes",
-							description: "The kind of site listed orders are delivered to, a CUSTOMER site or one of the organization's own MANUFACTURER sites, and naming both filters nothing",
+							description: "The kind of site listed orders are returned to, a CUSTOMER site or one of the organization's own MANUFACTURER sites, and naming both filters nothing",
 							valueName: "value",
 							repeatable: true,
 							schema: z.array(toEnum(["CUSTOMER", "MANUFACTURER"]))
@@ -10008,17 +11138,41 @@ const commands = [
 				}),
 				defineOperation({
 					name: "create",
-					summary: "Create purchase order",
-					example: "hardfin purchase-order create --item itemId=<value>,requestedQuantity=<value> --supplier-id <uuid> --to-location-id <uuid>",
+					summary: "Create return order",
+					example: "hardfin return-order create --from-location-id <uuid> --item itemId=<value>,requestedQuantity=<value> --return-type <value>",
 					method: "POST",
-					path: "/purchase-order",
+					path: "/return-order",
 					pathParameters: [],
 					queryFlags: [],
 					bodyFlags: [
 						{
 							name: "carrier",
 							jsonPath: ["carrier"],
-							description: "The carrier the supplier ships the order with",
+							description: "The carrier the items are returned with. Takes only null, which clears it",
+							valueName: "null",
+							nullable: true,
+							schema: z.null()
+						},
+						{
+							name: "carrier-name",
+							jsonPath: ["carrier", "name"],
+							description: "The carrier's name, which is accepted only when type is other",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "carrier-tracking-number",
+							jsonPath: ["carrier", "trackingNumber"],
+							description: "The number the carrier tracks the shipment by, or null when it has none",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "carrier-type",
+							jsonPath: ["carrier", "type"],
+							description: "The carrier, or null when none is named",
 							valueName: "value",
 							nullable: true,
 							schema: toEnum([
@@ -10093,20 +11247,12 @@ const commands = [
 								"yodel"
 							])
 						},
-						{
-							name: "external-purchase-order-number",
-							jsonPath: ["externalPurchaseOrderNumber"],
-							description: "The supplier's own number for the order, or null when it has none",
-							valueName: "value",
-							nullable: true,
-							schema: z.string()
-						},
 						{
 							name: "from-location-id",
 							jsonPath: ["fromLocationId"],
-							description: "The ID of the location the supplier ships from, or null when the supplier has no location on record",
+							description: "The ID of the location the items are returned from",
 							valueName: "uuid",
-							nullable: true,
+							required: true,
 							schema: z.uuid()
 						},
 						{
@@ -10129,18 +11275,10 @@ const commands = [
 							nullable: true,
 							schema: z.string()
 						},
-						{
-							name: "other-carrier",
-							jsonPath: ["otherCarrier"],
-							description: "The carrier's name, which is accepted only when Carrier is other",
-							valueName: "value",
-							nullable: true,
-							schema: z.string()
-						},
 						{
 							name: "promise-delivery-date",
 							jsonPath: ["promiseDeliveryDate"],
-							description: "The day the supplier promised the order would arrive",
+							description: "The day the items are promised to arrive",
 							valueName: "value",
 							nullable: true,
 							schema: z.string()
@@ -10148,31 +11286,42 @@ const commands = [
 						{
 							name: "promise-ship-date",
 							jsonPath: ["promiseShipDate"],
-							description: "The day the supplier promised to ship the order",
+							description: "The day the items are promised to ship",
 							valueName: "value",
 							nullable: true,
 							schema: z.string()
 						},
 						{
-							name: "reference-number",
-							jsonPath: ["referenceNumber"],
-							description: "The number the carrier will track the shipment by, where blank text is stored as null",
+							name: "return-reason",
+							jsonPath: ["returnReason"],
+							description: "A description of why the items are coming back, which is required when returnType is OTHER",
 							valueName: "value",
 							nullable: true,
 							schema: z.string()
 						},
 						{
-							name: "supplier-id",
-							jsonPath: ["supplierId"],
-							description: "The ID of the company the items are ordered from, which must be a supplier",
-							valueName: "uuid",
+							name: "return-type",
+							jsonPath: ["returnType"],
+							description: "Why the items are coming back",
+							valueName: "value",
 							required: true,
-							schema: z.uuid()
+							schema: toEnum([
+								"CUSTOMER_CANCELLATION",
+								"DAMAGED",
+								"DEFECTIVE",
+								"END_OF_SERVICE",
+								"INCORRECT_SPEC",
+								"NOT_NEEDED",
+								"OTHER",
+								"PROVISIONING",
+								"UPGRADE",
+								"WRONG_ITEM"
+							])
 						},
 						{
 							name: "to-location-id",
 							jsonPath: ["toLocationId"],
-							description: "The ID of the location the order is delivered to",
+							description: "The ID of the location the items are returned to",
 							valueName: "uuid",
 							required: true,
 							schema: z.uuid()
@@ -10181,13 +11330,13 @@ const commands = [
 				}),
 				defineOperation({
 					name: "get",
-					summary: "Get purchase order",
-					example: "hardfin purchase-order get po_7hq2mx9pkr4stz8w",
+					summary: "Get return order",
+					example: "hardfin return-order get ro_7hq2mx9pkr4stz8w",
 					method: "GET",
-					path: "/purchase-order/{purchaseOrderKey}",
+					path: "/return-order/{returnOrderKey}",
 					pathParameters: [{
-						name: "purchaseOrderKey",
-						description: "The purchase order's key",
+						name: "returnOrderKey",
+						description: "The return order's key",
 						required: true
 					}],
 					queryFlags: [],
@@ -10195,13 +11344,13 @@ const commands = [
 				}),
 				defineOperation({
 					name: "update",
-					summary: "Update purchase order",
-					example: "hardfin purchase-order update po_7hq2mx9pkr4stz8w --item itemId=<value>,requestedQuantity=<value>",
+					summary: "Update return order",
+					example: "hardfin return-order update ro_7hq2mx9pkr4stz8w --item itemId=<value>,requestedQuantity=<value>",
 					method: "PATCH",
-					path: "/purchase-order/{purchaseOrderKey}",
+					path: "/return-order/{returnOrderKey}",
 					pathParameters: [{
-						name: "purchaseOrderKey",
-						description: "The purchase order's key",
+						name: "returnOrderKey",
+						description: "The return order's key",
 						required: true
 					}],
 					queryFlags: [],
@@ -10209,7 +11358,31 @@ const commands = [
 						{
 							name: "carrier",
 							jsonPath: ["carrier"],
-							description: "The carrier the supplier ships the order with",
+							description: "The carrier the items are returned with, where a field left out keeps its stored value and null clears the whole carrier. Takes only null, which clears it",
+							valueName: "null",
+							nullable: true,
+							schema: z.null()
+						},
+						{
+							name: "carrier-name",
+							jsonPath: ["carrier", "name"],
+							description: "The carrier's name, which is accepted only when type is other",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "carrier-tracking-number",
+							jsonPath: ["carrier", "trackingNumber"],
+							description: "The number the carrier tracks the shipment by, or null when it has none",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "carrier-type",
+							jsonPath: ["carrier", "type"],
+							description: "The carrier, or null when none is named",
 							valueName: "value",
 							nullable: true,
 							schema: toEnum([
@@ -10284,18 +11457,10 @@ const commands = [
 								"yodel"
 							])
 						},
-						{
-							name: "external-purchase-order-number",
-							jsonPath: ["externalPurchaseOrderNumber"],
-							description: "The supplier's own number for the order, or null when it has none",
-							valueName: "value",
-							nullable: true,
-							schema: z.string()
-						},
 						{
 							name: "from-location-id",
 							jsonPath: ["fromLocationId"],
-							description: "The ID of the location the supplier ships from, or null when the supplier has no location on record",
+							description: "The ID of the location the items are returned from, which cannot be cleared",
 							valueName: "uuid",
 							nullable: true,
 							schema: z.uuid()
@@ -10314,15 +11479,7 @@ const commands = [
 						{
 							name: "order-notes",
 							jsonPath: ["orderNotes"],
-							description: "A note about the order, which is the one field that can change after the order leaves draft, until it is received or cancelled",
-							valueName: "value",
-							nullable: true,
-							schema: z.string()
-						},
-						{
-							name: "other-carrier",
-							jsonPath: ["otherCarrier"],
-							description: "The carrier's name, which is accepted only when the order's carrier is other",
+							description: "A note about the order, which can change after the order leaves draft until it is received or cancelled, unless a 3PL runs its destination",
 							valueName: "value",
 							nullable: true,
 							schema: z.string()
@@ -10330,7 +11487,7 @@ const commands = [
 						{
 							name: "promise-delivery-date",
 							jsonPath: ["promiseDeliveryDate"],
-							description: "The day the supplier promised the order would arrive",
+							description: "The day the items are promised to arrive",
 							valueName: "value",
 							nullable: true,
 							schema: z.string()
@@ -10338,31 +11495,42 @@ const commands = [
 						{
 							name: "promise-ship-date",
 							jsonPath: ["promiseShipDate"],
-							description: "The day the supplier promised to ship the order",
+							description: "The day the items are promised to ship",
 							valueName: "value",
 							nullable: true,
 							schema: z.string()
 						},
 						{
-							name: "reference-number",
-							jsonPath: ["referenceNumber"],
-							description: "The number the carrier will track the shipment by, where blank text is stored as null",
+							name: "return-reason",
+							jsonPath: ["returnReason"],
+							description: "A description of why the items are coming back, which the order must have while its type is OTHER",
 							valueName: "value",
 							nullable: true,
 							schema: z.string()
 						},
 						{
-							name: "supplier-id",
-							jsonPath: ["supplierId"],
-							description: "The ID of the company the items are ordered from, which must be a supplier",
-							valueName: "uuid",
+							name: "return-type",
+							jsonPath: ["returnType"],
+							description: "Why the items are coming back, which cannot be cleared",
+							valueName: "value",
 							nullable: true,
-							schema: z.uuid()
+							schema: toEnum([
+								"CUSTOMER_CANCELLATION",
+								"DAMAGED",
+								"DEFECTIVE",
+								"END_OF_SERVICE",
+								"INCORRECT_SPEC",
+								"NOT_NEEDED",
+								"OTHER",
+								"PROVISIONING",
+								"UPGRADE",
+								"WRONG_ITEM"
+							])
 						},
 						{
 							name: "to-location-id",
 							jsonPath: ["toLocationId"],
-							description: "The ID of the location the order is delivered to, which cannot be cleared",
+							description: "The ID of the location the items are returned to, which cannot be cleared",
 							valueName: "uuid",
 							nullable: true,
 							schema: z.uuid()
@@ -10372,12 +11540,12 @@ const commands = [
 				defineOperation({
 					name: "resync-3pl-files",
 					summary: "Resync 3PL files",
-					example: "hardfin purchase-order resync-3pl-files po_7hq2mx9pkr4stz8w",
+					example: "hardfin return-order resync-3pl-files ro_7hq2mx9pkr4stz8w",
 					method: "POST",
-					path: "/purchase-order/{purchaseOrderKey}/3pl/files/resync",
+					path: "/return-order/{returnOrderKey}/3pl/files/resync",
 					pathParameters: [{
-						name: "purchaseOrderKey",
-						description: "The purchase order's key",
+						name: "returnOrderKey",
+						description: "The return order's key",
 						required: true
 					}],
 					queryFlags: [],
@@ -10385,13 +11553,13 @@ const commands = [
 				}),
 				defineOperation({
 					name: "cancel",
-					summary: "Cancel purchase order",
-					example: "hardfin purchase-order cancel po_7hq2mx9pkr4stz8w --cancellation-reason <value>",
+					summary: "Cancel return order",
+					example: "hardfin return-order cancel ro_7hq2mx9pkr4stz8w --cancellation-reason <value>",
 					method: "POST",
-					path: "/purchase-order/{purchaseOrderKey}/cancel",
+					path: "/return-order/{returnOrderKey}/cancel",
 					pathParameters: [{
-						name: "purchaseOrderKey",
-						description: "The purchase order's key",
+						name: "returnOrderKey",
+						description: "The return order's key",
 						required: true
 					}],
 					queryFlags: [],
@@ -10412,26 +11580,26 @@ const commands = [
 					examples: [],
 					subcommands: [defineOperation({
 						name: "list",
-						summary: "Get purchase order files",
-						example: "hardfin purchase-order file list po_7hq2mx9pkr4stz8w",
+						summary: "Get return order files",
+						example: "hardfin return-order file list ro_7hq2mx9pkr4stz8w",
 						method: "GET",
-						path: "/purchase-order/{purchaseOrderKey}/file",
+						path: "/return-order/{returnOrderKey}/file",
 						pathParameters: [{
-							name: "purchaseOrderKey",
-							description: "The purchase order's key",
+							name: "returnOrderKey",
+							description: "The return order's key",
 							required: true
 						}],
 						queryFlags: [],
 						bodyFlags: []
 					}), defineOperation({
 						name: "delete",
-						summary: "Unlink purchase order file",
-						example: "hardfin purchase-order file delete po_7hq2mx9pkr4stz8w file_7hq2mx9pkr4stz8w",
+						summary: "Unlink return order file",
+						example: "hardfin return-order file delete ro_7hq2mx9pkr4stz8w file_7hq2mx9pkr4stz8w",
 						method: "DELETE",
-						path: "/purchase-order/{purchaseOrderKey}/file/{fileKey}",
+						path: "/return-order/{returnOrderKey}/file/{fileKey}",
 						pathParameters: [{
-							name: "purchaseOrderKey",
-							description: "The purchase order's key",
+							name: "returnOrderKey",
+							description: "The return order's key",
 							required: true
 						}, {
 							name: "fileKey",
@@ -10444,13 +11612,13 @@ const commands = [
 				},
 				defineOperation({
 					name: "resync",
-					summary: "Resync purchase order",
-					example: "hardfin purchase-order resync po_7hq2mx9pkr4stz8w",
+					summary: "Resync return order",
+					example: "hardfin return-order resync ro_7hq2mx9pkr4stz8w",
 					method: "POST",
-					path: "/purchase-order/{purchaseOrderKey}/resync",
+					path: "/return-order/{returnOrderKey}/resync",
 					pathParameters: [{
-						name: "purchaseOrderKey",
-						description: "The purchase order's key",
+						name: "returnOrderKey",
+						description: "The return order's key",
 						required: true
 					}],
 					queryFlags: [],
@@ -10458,13 +11626,13 @@ const commands = [
 				}),
 				defineOperation({
 					name: "send-to-3pl",
-					summary: "Send purchase order to 3PL",
-					example: "hardfin purchase-order send-to-3pl po_7hq2mx9pkr4stz8w",
+					summary: "Send return order to 3PL",
+					example: "hardfin return-order send-to-3pl ro_7hq2mx9pkr4stz8w",
 					method: "POST",
-					path: "/purchase-order/{purchaseOrderKey}/send-to-3pl",
+					path: "/return-order/{returnOrderKey}/send-to-3pl",
 					pathParameters: [{
-						name: "purchaseOrderKey",
-						description: "The purchase order's key",
+						name: "returnOrderKey",
+						description: "The return order's key",
 						required: true
 					}],
 					queryFlags: [],
@@ -10478,26 +11646,26 @@ const commands = [
 					examples: [],
 					subcommands: [defineOperation({
 						name: "list",
-						summary: "Get purchase order URL links",
-						example: "hardfin purchase-order url-link list po_7hq2mx9pkr4stz8w",
+						summary: "Get return order URL links",
+						example: "hardfin return-order url-link list ro_7hq2mx9pkr4stz8w",
 						method: "GET",
-						path: "/purchase-order/{purchaseOrderKey}/url-link",
+						path: "/return-order/{returnOrderKey}/url-link",
 						pathParameters: [{
-							name: "purchaseOrderKey",
-							description: "The purchase order's key",
+							name: "returnOrderKey",
+							description: "The return order's key",
 							required: true
 						}],
 						queryFlags: [],
 						bodyFlags: []
 					}), defineOperation({
 						name: "create",
-						summary: "Create purchase order URL link",
-						example: "hardfin purchase-order url-link create po_7hq2mx9pkr4stz8w --url <value>",
+						summary: "Create return order URL link",
+						example: "hardfin return-order url-link create ro_7hq2mx9pkr4stz8w --url <value>",
 						method: "POST",
-						path: "/purchase-order/{purchaseOrderKey}/url-link",
+						path: "/return-order/{returnOrderKey}/url-link",
 						pathParameters: [{
-							name: "purchaseOrderKey",
-							description: "The purchase order's key",
+							name: "returnOrderKey",
+							description: "The return order's key",
 							required: true
 						}],
 						queryFlags: [],
@@ -10701,7 +11869,31 @@ const commands = [
 						{
 							name: "carrier",
 							jsonPath: ["carrier"],
-							description: "Who carries the shipment, or null when no carrier is named",
+							description: "Who carries the shipment. Takes only null, which clears it",
+							valueName: "null",
+							nullable: true,
+							schema: z.null()
+						},
+						{
+							name: "carrier-name",
+							jsonPath: ["carrier", "name"],
+							description: "The carrier's name, which is accepted only when type is other",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "carrier-tracking-number",
+							jsonPath: ["carrier", "trackingNumber"],
+							description: "The number the carrier tracks the shipment by, or null when it has none",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "carrier-type",
+							jsonPath: ["carrier", "type"],
+							description: "The carrier, or null when none is named",
 							valueName: "value",
 							nullable: true,
 							schema: toEnum([
@@ -10779,7 +11971,7 @@ const commands = [
 						{
 							name: "delivered-at",
 							jsonPath: ["deliveredAt"],
-							description: "When the shipment arrived, which cannot be before ShippedAt, or null while it has not",
+							description: "When the shipment arrived, which cannot be before shippedAt, or null while it has not",
 							valueName: "value",
 							nullable: true,
 							schema: z.string()
@@ -10787,7 +11979,7 @@ const commands = [
 						{
 							name: "delivered-at-timezone",
 							jsonPath: ["deliveredAtTimezone"],
-							description: "The IANA time zone DeliveredAt is recorded in",
+							description: "The IANA time zone deliveredAt is recorded in",
 							valueName: "value",
 							nullable: true,
 							schema: z.string()
@@ -10795,7 +11987,7 @@ const commands = [
 						{
 							name: "expected-delivered-on",
 							jsonPath: ["expectedDeliveredOn"],
-							description: "The day the shipment is expected to arrive, which on an inbound shipment cannot be before ExpectedShippedOn",
+							description: "The day the shipment is expected to arrive, which on an inbound shipment cannot be before expectedShippedOn",
 							valueName: "value",
 							nullable: true,
 							schema: z.string()
@@ -10846,14 +12038,6 @@ const commands = [
 							elementLists: ["serials"],
 							schema: z.array(z.string())
 						},
-						{
-							name: "other-carrier",
-							jsonPath: ["otherCarrier"],
-							description: "The carrier's name when Carrier is other",
-							valueName: "value",
-							nullable: true,
-							schema: z.string()
-						},
 						{
 							name: "purchase-order-number",
 							jsonPath: ["purchaseOrderNumber"],
@@ -10862,14 +12046,6 @@ const commands = [
 							nullable: true,
 							schema: z.string()
 						},
-						{
-							name: "reference-number",
-							jsonPath: ["referenceNumber"],
-							description: "The number the carrier tracks the shipment by, or null when it has none",
-							valueName: "value",
-							nullable: true,
-							schema: z.string()
-						},
 						{
 							name: "return-order-number",
 							jsonPath: ["returnOrderNumber"],
@@ -10905,7 +12081,7 @@ const commands = [
 						{
 							name: "shipped-at-timezone",
 							jsonPath: ["shippedAtTimezone"],
-							description: "The IANA time zone ShippedAt is recorded in",
+							description: "The IANA time zone shippedAt is recorded in",
 							valueName: "value",
 							nullable: true,
 							schema: z.string()
@@ -10921,15 +12097,15 @@ const commands = [
 						{
 							name: "shipping-cost-value",
 							jsonPath: ["shippingCost", "amount"],
-							description: "What the shipment cost to send, which cannot be negative: the value as a decimal string with two decimal places, given with --shipping-cost-iso-code",
+							description: "What the shipment cost to send: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --shipping-cost-iso-code",
 							valueName: "value",
 							together: ["shipping-cost-iso-code"],
-							schema: z.string()
+							schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 						},
 						{
 							name: "shipping-cost-iso-code",
 							jsonPath: ["shippingCost", "isoCode"],
-							description: "What the shipment cost to send, which cannot be negative: the value's ISO 4217 currency code, given with --shipping-cost-value",
+							description: "What the shipment cost to send: the value's ISO 4217 currency code, given with --shipping-cost-value",
 							valueName: "value",
 							together: ["shipping-cost-value"],
 							schema: toEnum([
@@ -10979,7 +12155,31 @@ const commands = [
 						{
 							name: "carrier",
 							jsonPath: ["carrier"],
-							description: "Who carries the shipment, or null when no carrier is named",
+							description: "Who carries the shipment, where a field left out keeps its stored value and null clears the whole carrier. Takes only null, which clears it",
+							valueName: "null",
+							nullable: true,
+							schema: z.null()
+						},
+						{
+							name: "carrier-name",
+							jsonPath: ["carrier", "name"],
+							description: "The carrier's name, which is accepted only when type is other",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "carrier-tracking-number",
+							jsonPath: ["carrier", "trackingNumber"],
+							description: "The number the carrier tracks the shipment by, or null when it has none",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "carrier-type",
+							jsonPath: ["carrier", "type"],
+							description: "The carrier, or null when none is named",
 							valueName: "value",
 							nullable: true,
 							schema: toEnum([
@@ -11057,7 +12257,7 @@ const commands = [
 						{
 							name: "delivered-at",
 							jsonPath: ["deliveredAt"],
-							description: "When the shipment arrived, which cannot be before ShippedAt",
+							description: "When the shipment arrived, which cannot be before shippedAt",
 							valueName: "value",
 							nullable: true,
 							schema: z.string()
@@ -11065,7 +12265,7 @@ const commands = [
 						{
 							name: "delivered-at-timezone",
 							jsonPath: ["deliveredAtTimezone"],
-							description: "The IANA time zone DeliveredAt is recorded in",
+							description: "The IANA time zone deliveredAt is recorded in",
 							valueName: "value",
 							nullable: true,
 							schema: z.string()
@@ -11081,7 +12281,7 @@ const commands = [
 						{
 							name: "expected-delivered-on",
 							jsonPath: ["expectedDeliveredOn"],
-							description: "The day the shipment is expected to arrive, which on an inbound shipment cannot be before ExpectedShippedOn",
+							description: "The day the shipment is expected to arrive, which on an inbound shipment cannot be before expectedShippedOn",
 							valueName: "value",
 							nullable: true,
 							schema: z.string()
@@ -11131,14 +12331,6 @@ const commands = [
 							elementLists: ["serials"],
 							schema: z.array(z.string())
 						},
-						{
-							name: "other-carrier",
-							jsonPath: ["otherCarrier"],
-							description: "The carrier's name when Carrier is other",
-							valueName: "value",
-							nullable: true,
-							schema: z.string()
-						},
 						{
 							name: "purchase-order-number",
 							jsonPath: ["purchaseOrderNumber"],
@@ -11155,14 +12347,6 @@ const commands = [
 							nullable: true,
 							schema: z.string()
 						},
-						{
-							name: "reference-number",
-							jsonPath: ["referenceNumber"],
-							description: "The number the carrier tracks the shipment by, or null when it has none",
-							valueName: "value",
-							nullable: true,
-							schema: z.string()
-						},
 						{
 							name: "return-order-number",
 							jsonPath: ["returnOrderNumber"],
@@ -11190,7 +12374,7 @@ const commands = [
 						{
 							name: "shipped-at-timezone",
 							jsonPath: ["shippedAtTimezone"],
-							description: "The IANA time zone ShippedAt is recorded in",
+							description: "The IANA time zone shippedAt is recorded in",
 							valueName: "value",
 							nullable: true,
 							schema: z.string()
@@ -11206,15 +12390,15 @@ const commands = [
 						{
 							name: "shipping-cost-value",
 							jsonPath: ["shippingCost", "amount"],
-							description: "What the shipment cost to send, which cannot be negative: the value as a decimal string with two decimal places, given with --shipping-cost-iso-code",
+							description: "What the shipment cost to send: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --shipping-cost-iso-code",
 							valueName: "value",
 							together: ["shipping-cost-iso-code"],
-							schema: z.string()
+							schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 						},
 						{
 							name: "shipping-cost-iso-code",
 							jsonPath: ["shippingCost", "isoCode"],
-							description: "What the shipment cost to send, which cannot be negative: the value's ISO 4217 currency code, given with --shipping-cost-value",
+							description: "What the shipment cost to send: the value's ISO 4217 currency code, given with --shipping-cost-value",
 							valueName: "value",
 							together: ["shipping-cost-value"],
 							schema: toEnum([
@@ -11285,7 +12469,7 @@ const commands = [
 						{
 							name: "delivered-at-timezone",
 							jsonPath: ["deliveredAtTimezone"],
-							description: "The IANA time zone DeliveredAt is recorded in",
+							description: "The IANA time zone deliveredAt is recorded in",
 							valueName: "value",
 							nullable: true,
 							schema: z.string()
@@ -11369,7 +12553,7 @@ const commands = [
 						{
 							name: "received-at-timezone",
 							jsonPath: ["receivedAtTimezone"],
-							description: "The IANA time zone ReceivedAt is recorded in",
+							description: "The IANA time zone receivedAt is recorded in",
 							valueName: "value",
 							nullable: true,
 							schema: z.string()
@@ -11437,7 +12621,7 @@ const commands = [
 						{
 							name: "shipped-at-timezone",
 							jsonPath: ["shippedAtTimezone"],
-							description: "The IANA time zone ShippedAt is recorded in",
+							description: "The IANA time zone shippedAt is recorded in",
 							valueName: "value",
 							nullable: true,
 							schema: z.string()
@@ -11453,15 +12637,15 @@ const commands = [
 						{
 							name: "shipping-cost-value",
 							jsonPath: ["shippingCost", "amount"],
-							description: "What the shipment cost to send, which cannot be negative: the value as a decimal string with two decimal places, given with --shipping-cost-iso-code",
+							description: "What the shipment cost to send: the exact value as a decimal string with at least two decimal places, which cannot be negative, given with --shipping-cost-iso-code",
 							valueName: "value",
 							together: ["shipping-cost-iso-code"],
-							schema: z.string()
+							schema: z.string().regex(/* @__PURE__ */ new RegExp("^[^-]"))
 						},
 						{
 							name: "shipping-cost-iso-code",
 							jsonPath: ["shippingCost", "isoCode"],
-							description: "What the shipment cost to send, which cannot be negative: the value's ISO 4217 currency code, given with --shipping-cost-value",
+							description: "What the shipment cost to send: the value's ISO 4217 currency code, given with --shipping-cost-value",
 							valueName: "value",
 							together: ["shipping-cost-value"],
 							schema: toEnum([
@@ -11713,5 +12897,5 @@ async function toReported(error, isJSON, resolved, level = "error") {
 //#endregion
 export { toCli, toParseExitCode, toReported, wasReportAttempted, writeCrash };
 
-//# sourceMappingURL=program-Bok0tZ8p.js.map
-//# debugId=0c1ab267-116d-5cf2-b055-693453f0e766
+//# sourceMappingURL=program-Dn5_vLMu.js.map
+//# debugId=d0ee2ed5-ee69-52ea-a9b8-71f6c3047c1a