@augno/sdk 0.18.0 → 0.18.2

package/src/resources/operations/production-schedules/actions.ts

@@ -210,6 +210,14 @@ export class Actions extends APIResource {
    * released line records the run now carrying it, and a line that is already
    * released is never re-pointed.
    *
+   * Lots an earlier week already issued are carried forward rather than reissued.
+   * When a week fell short, the next plan asks for the shortfall — and the batches
+   * covering it are usually already printed and sitting on the floor. Those tickets
+   * are moved into this run and counted against the campaign, so only the genuinely
+   * new work is created. `carried_forward_batch_count` says how many arrived that
+   * way, and each one names the run it came off. Send `skip_carry_forward` to issue
+   * the whole week new instead.
+   *
    * Cancelled campaigns and campaigns planned at zero are left behind rather than
    * released. A week that would produce an implausible number of batches is rejected
    * outright, since that is far more likely to be a misconfigured lot size than a
@@ -679,6 +687,16 @@ export interface ReleaseProductionScheduleWeekRequest {
    * Applied to every batch this release creates, across all machines in the week.
    */
   scanning_station_id?: string;
+
+  /**
+   * Issue the whole week as new batches, leaving an earlier week's unworked lots
+   * where they are.
+   *
+   * Off unless you ask for it: reprinting a ticket the floor is already holding is
+   * exactly what carrying work forward exists to prevent, so it takes a deliberate
+   * choice to do it.
+   */
+  skip_carry_forward?: boolean;
 }
 
 /**
@@ -689,10 +707,18 @@ export interface ReleaseProductionScheduleWeekRequest {
  */
 export interface ReleaseScheduleWeekResult {
   /**
-   * How many batches were created across all campaigns.
+   * How many batches the run holds across all campaigns, created and carried forward
+   * together.
    */
   batch_count: number;
 
+  /**
+   * How many of `batch_count` were moved off an earlier run rather than created.
+   *
+   * Tickets for these are already printed and on the floor.
+   */
+  carried_forward_batch_count: number;
+
   /**
    * A single page of resources, together with the metadata needed to page through
    * the rest of the result set.
@@ -1116,6 +1142,16 @@ export interface ActionReleaseWeekParams {
    * Applied to every batch this release creates, across all machines in the week.
    */
   scanning_station_id?: string;
+
+  /**
+   * Issue the whole week as new batches, leaving an earlier week's unworked lots
+   * where they are.
+   *
+   * Off unless you ask for it: reprinting a ticket the floor is already holding is
+   * exactly what carrying work forward exists to prevent, so it takes a deliberate
+   * choice to do it.
+   */
+  skip_carry_forward?: boolean;
 }
 
 export declare namespace Actions {

package/src/resources/operations/production-schedules/index.ts

@@ -44,6 +44,7 @@ export {
   type ListProductionScheduleDerivedLine,
   type ListProductionScheduleDeviation,
   type ListProductionScheduleFinishedPolicy,
+  type ListProductionScheduleFinishingLine,
   type ListProductionScheduleItemPolicy,
   type ListReleaseScheduleBatch,
   type ListReleasedScheduleLine,
@@ -55,6 +56,7 @@ export {
   type ProductionScheduleDerivedLine,
   type ProductionScheduleDeviation,
   type ProductionScheduleFinishedPolicy,
+  type ProductionScheduleFinishingLine,
   type ProductionScheduleItemPolicy,
   type ReleaseScheduleBatch,
   type ReleaseScheduleWeekPreview,
@@ -62,11 +64,13 @@ export {
   type ScheduleAppliedOverride,
   type ScheduleAtRiskOrder,
   type ScheduleDiagnostics,
+  type ScheduleFinishingDiagnostics,
   type ScheduleOrderCoverage,
   type ScheduleOrderCoverageLine,
   type ProductionScheduleDeleteResponse,
   type ProductionScheduleListParams,
   type ProductionScheduleCreateParams,
+  type ProductionScheduleRetrieveFinishingLinesParams,
   type ProductionScheduleRetrieveDerivedLinesParams,
   type ProductionScheduleRetrieveDeviationsParams,
   type ProductionScheduleRetrieveWeekReleasePreviewParams,

package/src/resources/operations/production-schedules/lines.ts

@@ -425,9 +425,11 @@ export interface UpdateProductionScheduleLineRequest {
   /**
    * Units to build over the campaign.
    *
-   * Changing this does not re-derive `lots` or `run_hours` — send those alongside it
-   * when they should follow, or the campaign will keep claiming its old share of
-   * machine time.
+   * Changing this re-derives `lots` and `run_hours` from the rate and lot size this
+   * version was solved with, so the campaign never keeps claiming its old share of
+   * machine time; send either alongside it to override what is derived. A campaign
+   * builds something by definition, so use delete rather than a quantity of zero to
+   * take it off the plan.
    */
   quantity?: number;
 
@@ -587,9 +589,11 @@ export interface LineUpdateParams {
   /**
    * Body param: Units to build over the campaign.
    *
-   * Changing this does not re-derive `lots` or `run_hours` — send those alongside it
-   * when they should follow, or the campaign will keep claiming its old share of
-   * machine time.
+   * Changing this re-derives `lots` and `run_hours` from the rate and lot size this
+   * version was solved with, so the campaign never keeps claiming its old share of
+   * machine time; send either alongside it to override what is derived. A campaign
+   * builds something by definition, so use delete rather than a quantity of zero to
+   * take it off the plan.
    */
   quantity?: number;
 

package/src/resources/operations/production-schedules/production-schedules.ts

@@ -198,6 +198,48 @@ export class ProductionSchedules extends APIResource {
     return this._client.get(path`/v1/operations/production-schedules/${id}/finished-policies`, options);
   }
 
+  /**
+   * Returns the second stage of a schedule: how many of which finished good to make
+   * from the knitted parts, week by week.
+   *
+   * The constraint plan says how much greige to knit and deliberately does not say
+   * what to turn it into — a family's demand is pooled onto the greige precisely so
+   * the buffer can sit at the undifferentiated stage, where it is cheapest. These
+   * lines are where that pooling is undone, against each finished SKU's own stock
+   * position, its own orders, and the hours the rest of the factory has that week.
+   *
+   * Levelled, not merely allocated. Work that does not fit a week moves to the next
+   * one rather than being dropped, so the plan never asks the second stage for more
+   * hours than it has. Two things bound it, and they are reported separately in the
+   * schedule's diagnostics because they call for opposite responses: a SKU held back
+   * for want of greige is a knitting problem, and a SKU held back for want of hours
+   * is a finishing one.
+   *
+   * Everything is counted in the constraint item's unit, so `greige_consumed` here
+   * and `planned_quantity` on the constraint plan are directly comparable — which is
+   * what lets the two stages be reconciled rather than only read side by side.
+   *
+   * This endpoint requires the permission: `production_schedules:read`.
+   *
+   * @example
+   * ```ts
+   * const listProductionScheduleFinishingLine =
+   *   await client.operations.productionSchedules.retrieveFinishingLines(
+   *     'pnsc_m4zt3z8g8src',
+   *   );
+   * ```
+   */
+  retrieveFinishingLines(
+    id: string,
+    query: ProductionScheduleRetrieveFinishingLinesParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ListProductionScheduleFinishingLine> {
+    return this._client.get(path`/v1/operations/production-schedules/${id}/finishing-lines`, {
+      query,
+      ...options,
+    });
+  }
+
   /**
    * Returns the department work implied by a schedule's constraint plan.
    *
@@ -306,6 +348,11 @@ export class ProductionSchedules extends APIResource {
    * the release excludes them, so a week holding nothing but those previews as
    * empty.
    *
+   * Lots the floor is already holding are named as such. A batch with
+   * `carried_forward_from` set is a ticket an earlier week issued and nobody worked,
+   * which the release moves into the new run rather than reissuing, so nothing has
+   * to be reprinted.
+   *
    * This endpoint requires the permission: `production_schedules:read`.
    *
    * @example
@@ -497,6 +544,33 @@ export interface ListProductionScheduleFinishedPolicy {
   page_info: APIKeysAPI.PageInfo;
 }
 
+/**
+ * A single page of resources, together with the metadata needed to page through
+ * the rest of the result set.
+ */
+export interface ListProductionScheduleFinishingLine {
+  /**
+   * Resources in this page.
+   */
+  data: Array<ProductionScheduleFinishingLine>;
+
+  /**
+   * Resource type identifier.
+   */
+  object: 'list';
+
+  /**
+   * PageInfo describes where the current page sits within a paginated result set and
+   * how to move to the adjacent pages.
+   *
+   * Page a list by following the URLs below rather than assembling cursors yourself.
+   * For a top-level list endpoint the URL repeats the original request's query
+   * string with only the cursor swapped, so following it preserves the same filters,
+   * search term, and page size.
+   */
+  page_info: APIKeysAPI.PageInfo;
+}
+
 /**
  * A single page of resources, together with the metadata needed to page through
  * the rest of the result set.
@@ -1186,6 +1260,150 @@ export interface ProductionScheduleFinishedPolicy {
   weeks_of_cover: number;
 }
 
+/**
+ * One finished good's build in one week: the second stage of the plan.
+ *
+ * The constraint plan says how much greige to knit and deliberately does not say
+ * what to turn it into — a family's demand is pooled onto the greige precisely so
+ * the buffer can sit at the undifferentiated stage. These lines are where that
+ * pooling is undone: how many of which finished good to make from the knitted
+ * parts, decided against each SKU's own stock position, its own orders, and the
+ * hours the rest of the factory has that week.
+ *
+ * Quantities are counted in the constraint item's unit, so `greige_consumed` and
+ * the knit plan's `planned_quantity` are directly comparable. That is what lets
+ * the two stages be reconciled rather than merely read side by side.
+ */
+export interface ProductionScheduleFinishingLine {
+  /**
+   * Finishing line ID.
+   */
+  id: string;
+
+  /**
+   * Creation timestamp.
+   */
+  created_at: string;
+
+  /**
+   * Entity is a polymorphic reference to any resource in the system.
+   */
+  department: CoreAPI.Entity | null;
+
+  /**
+   * How much of the week's draw on this SKU is an order rather than a forecast.
+   */
+  firm_units: number;
+
+  /**
+   * Units of the constraint item this takes out of the greige buffer.
+   *
+   * Equal to `planned_quantity` unless a finishing yield loss means a finished unit
+   * costs more than one knitted one.
+   */
+  greige_consumed: number;
+
+  /**
+   * Entity is a polymorphic reference to any resource in the system.
+   */
+  greige_item: CoreAPI.Entity | null;
+
+  /**
+   * SKU of that constraint item.
+   */
+  greige_sku: string;
+
+  /**
+   * Whether the line sits inside the published frozen window.
+   */
+  is_frozen: boolean;
+
+  /**
+   * Entity is a polymorphic reference to any resource in the system.
+   */
+  item: CoreAPI.Entity | null;
+
+  /**
+   * Resource type identifier.
+   */
+  object: 'production_schedule_finishing_line';
+
+  /**
+   * Units in one lot.
+   */
+  planned_lot_units: number;
+
+  /**
+   * How many lots the quantity breaks into.
+   */
+  planned_lots: number;
+
+  /**
+   * Units of the finished good to make.
+   */
+  planned_quantity: number;
+
+  /**
+   * Hours of the second stage's capacity this line consumes.
+   */
+  planned_run_hours: number;
+
+  /**
+   * Entity is a polymorphic reference to any resource in the system.
+   */
+  production_schedule: CoreAPI.Entity | null;
+
+  /**
+   * Entity is a polymorphic reference to any resource in the system.
+   */
+  production_step: CoreAPI.Entity | null;
+
+  /**
+   * And after it lands.
+   */
+  projected_on_hand_after: number;
+
+  /**
+   * This SKU's own projected stock before the line lands.
+   */
+  projected_on_hand_before: number;
+
+  /**
+   * SKU of the finished good, as it stood when the plan was generated.
+   */
+  sku: string;
+
+  /**
+   * Whether the solver produced this line or a person did.
+   */
+  source: 'solver' | 'manual';
+
+  /**
+   * Where the line stands.
+   */
+  status: 'planned' | 'released' | 'in_progress' | 'complete' | 'cancelled';
+
+  /**
+   * Abbreviation of the unit everything on this line is counted in.
+   */
+  unit: string | null;
+
+  /**
+   * Last updated timestamp.
+   */
+  updated_at: string;
+
+  /**
+   * Zero-based week offset from the start of the horizon.
+   */
+  week_index: number;
+
+  /**
+   * First day of the week this is planned in.
+   */
+  week_starts_at: string;
+}
+
 /**
  * The per-item policy behind a schedule version.
  *
@@ -1432,6 +1650,15 @@ export interface ReleaseScheduleBatch {
    */
   batch: CoreAPI.Entity | null;
 
+  /**
+   * The number of the run this ticket came off, when the batch already existed.
+   *
+   * Present on a lot carried forward from an earlier week that the floor never
+   * worked. The ticket is already printed and on the floor, so the release moves it
+   * into the new run rather than issuing a replacement.
+   */
+  carried_forward_from: string | null;
+
   /**
    * Entity is a polymorphic reference to any resource in the system.
    */
@@ -1460,7 +1687,7 @@ export interface ReleaseScheduleBatch {
  */
 export interface ReleaseScheduleWeekPreview {
   /**
-   * How many batches would be created.
+   * How many batches the run would hold, created and carried forward together.
    */
   batch_count: number;
 
@@ -1472,6 +1699,11 @@ export interface ReleaseScheduleWeekPreview {
    */
   blocked_reason: string | null;
 
+  /**
+   * How many of `batch_count` would be moved off an earlier run rather than created.
+   */
+  carried_forward_batch_count: number;
+
   /**
    * Entity is a polymorphic reference to any resource in the system.
    */
@@ -1529,6 +1761,12 @@ export interface ReleasedScheduleLine {
    */
   batches: ListReleaseScheduleBatch | null;
 
+  /**
+   * How much of `planned_quantity` is covered by tickets an earlier week already
+   * issued.
+   */
+  carried_forward_quantity: number;
+
   /**
    * Entity is a polymorphic reference to any resource in the system.
    */
@@ -1722,6 +1960,33 @@ export interface ScheduleDiagnostics {
    */
   excluded_item_count: number;
 
+  /**
+   * How the second stage fared: what it could not make, and which of the two things
+   * it ran out of.
+   *
+   * The two starvation lists are the point of planning in two stages at all. A
+   * finished good held back for want of greige is a knitting problem — knit more of
+   * it, or knit it sooner — and one held back for want of hours is a finishing
+   * problem: another shift, or a different mix. A single "short" list would throw
+   * that distinction away, and it is the only thing this model knows that a
+   * one-stage plan does not.
+   */
+  finishing: ScheduleFinishingDiagnostics;
+
+  /**
+   * Whether the second stage's capacity was estimated rather than counted from
+   * machines.
+   */
+  finishing_capacity_is_estimated: boolean;
+
+  /**
+   * Machines outside the constraint department that the second stage was sized from.
+   *
+   * Zero means its capacity was estimated from the shift pattern alone rather than
+   * counted.
+   */
+  finishing_machine_count: number;
+
   /**
    * Outstanding order quantity this plan owes, expressed in the constraint item's
    * own unit.
@@ -1772,6 +2037,69 @@ export interface ScheduleDiagnostics {
   unschedulable_skus: Array<string>;
 }
 
+/**
+ * How the second stage fared: what it could not make, and which of the two things
+ * it ran out of.
+ *
+ * The two starvation lists are the point of planning in two stages at all. A
+ * finished good held back for want of greige is a knitting problem — knit more of
+ * it, or knit it sooner — and one held back for want of hours is a finishing
+ * problem: another shift, or a different mix. A single "short" list would throw
+ * that distinction away, and it is the only thing this model knows that a
+ * one-stage plan does not.
+ */
+export interface ScheduleFinishingDiagnostics {
+  /**
+   * Finished goods that had greige and never had hours.
+   */
+  capacity_starved_skus: Array<string>;
+
+  /**
+   * Finished goods that wanted building across the whole horizon and never had
+   * greige to build from.
+   */
+  greige_starved_skus: Array<string>;
+
+  /**
+   * Finished goods with no measured finishing rate, which cannot be levelled because
+   * the hours they cost are unknown.
+   */
+  items_without_run_rate: Array<string>;
+
+  /**
+   * How many finishing lines the plan holds.
+   */
+  line_count: number;
+
+  /**
+   * Hours the plan asks of it, week by week.
+   */
+  planned_hours_by_week: Array<number>;
+
+  /**
+   * Total finished units the stage plans across the horizon.
+   */
+  total_planned_units: number;
+
+  /**
+   * Constraint output the horizon never converts into anything.
+   *
+   * A large figure means the two stages are planned against different demand, which
+   * is worth looking at rather than leaving as an unexplained pile of greige.
+   */
+  unused_greige_units: number;
+
+  /**
+   * Those hours as a fraction of capacity, week by week.
+   */
+  utilisation_by_week: Array<number>;
+
+  /**
+   * Hours the second stage can work in one week.
+   */
+  weekly_capacity_hours: number;
+}
+
 /**
  * An order this schedule does not build in time, with the campaigns covering the
  * part it does.
@@ -1932,6 +2260,19 @@ export interface ProductionScheduleCreateParams {
   planning_as_of?: string;
 }
 
+export interface ProductionScheduleRetrieveFinishingLinesParams {
+  /**
+   * Only the finishing planned for this finished good.
+   */
+  item_id?: string;
+
+  /**
+   * Only the finishing planned for this week, zero-based from the start of the
+   * horizon.
+   */
+  week_index?: number;
+}
+
 export interface ProductionScheduleRetrieveDerivedLinesParams {
   /**
    * Only return work owned by these departments.
@@ -1976,6 +2317,14 @@ export interface ProductionScheduleRetrieveDeviationsParams {
 }
 
 export interface ProductionScheduleRetrieveWeekReleasePreviewParams {
+  /**
+   * Preview the week as if every batch were newly issued.
+   *
+   * By default the preview counts tickets an earlier week issued and the floor never
+   * worked against this week's campaigns, because that is what releasing would do.
+   */
+  skip_carry_forward?: boolean;
+
   /**
    * Zero-based week offset from the start of the horizon.
    */
@@ -1992,6 +2341,7 @@ export declare namespace ProductionSchedules {
     type ListProductionScheduleDerivedLine as ListProductionScheduleDerivedLine,
     type ListProductionScheduleDeviation as ListProductionScheduleDeviation,
     type ListProductionScheduleFinishedPolicy as ListProductionScheduleFinishedPolicy,
+    type ListProductionScheduleFinishingLine as ListProductionScheduleFinishingLine,
     type ListProductionScheduleItemPolicy as ListProductionScheduleItemPolicy,
     type ListReleaseScheduleBatch as ListReleaseScheduleBatch,
     type ListReleasedScheduleLine as ListReleasedScheduleLine,
@@ -2003,6 +2353,7 @@ export declare namespace ProductionSchedules {
     type ProductionScheduleDerivedLine as ProductionScheduleDerivedLine,
     type ProductionScheduleDeviation as ProductionScheduleDeviation,
     type ProductionScheduleFinishedPolicy as ProductionScheduleFinishedPolicy,
+    type ProductionScheduleFinishingLine as ProductionScheduleFinishingLine,
     type ProductionScheduleItemPolicy as ProductionScheduleItemPolicy,
     type ReleaseScheduleBatch as ReleaseScheduleBatch,
     type ReleaseScheduleWeekPreview as ReleaseScheduleWeekPreview,
@@ -2010,11 +2361,13 @@ export declare namespace ProductionSchedules {
     type ScheduleAppliedOverride as ScheduleAppliedOverride,
     type ScheduleAtRiskOrder as ScheduleAtRiskOrder,
     type ScheduleDiagnostics as ScheduleDiagnostics,
+    type ScheduleFinishingDiagnostics as ScheduleFinishingDiagnostics,
     type ScheduleOrderCoverage as ScheduleOrderCoverage,
     type ScheduleOrderCoverageLine as ScheduleOrderCoverageLine,
     type ProductionScheduleDeleteResponse as ProductionScheduleDeleteResponse,
     type ProductionScheduleListParams as ProductionScheduleListParams,
     type ProductionScheduleCreateParams as ProductionScheduleCreateParams,
+    type ProductionScheduleRetrieveFinishingLinesParams as ProductionScheduleRetrieveFinishingLinesParams,
     type ProductionScheduleRetrieveDerivedLinesParams as ProductionScheduleRetrieveDerivedLinesParams,
     type ProductionScheduleRetrieveDeviationsParams as ProductionScheduleRetrieveDeviationsParams,
     type ProductionScheduleRetrieveWeekReleasePreviewParams as ProductionScheduleRetrieveWeekReleasePreviewParams,

package/src/resources/sales/account-groups.ts

@@ -164,7 +164,8 @@ export interface AccountGroup {
 
   /**
    * Calendar days between an order being issued and it being due to ship, inherited
-   * by every customer in this group that has not set its own.
+   * by every customer in this group that has neither set its own nor inherited one
+   * from a parent account.
    */
   default_lead_time_days: number | null;
 

package/src/resources/sales/account-prices/account-prices.ts

@@ -537,7 +537,8 @@ export interface CustomerDefaults {
    * Calendar days between an order being issued and it being due to ship.
    *
    * Sets each order's `ship_by_date` when it is issued. With none set here the
-   * customer inherits its account group's lead time, then the account default.
+   * customer inherits its parent account's lead time, then its account group's, then
+   * the account default.
    */
   lead_time_days: number | null;
 
@@ -561,6 +562,15 @@ export interface CustomerDefaults {
    */
   priority: Priority | null;
 
+  /**
+   * The operating calendar naming the days this customer's dock accepts freight.
+   *
+   * A promised delivery date is worked back from a day the customer can actually
+   * receive on. With none set here the customer inherits its account group's
+   * calendar, then the account default, then Monday to Friday.
+   */
+  receive_calendar_id: string | null;
+
   /**
    * A user's membership in an account, carrying the account-specific status, role,
    * and department.

package/src/resources/sales/addresses.ts

@@ -171,6 +171,12 @@ export interface AddressInput {
    */
   postal_code?: string;
 
+  /**
+   * The operating calendar naming the days this dock accepts freight, overriding the
+   * customer's own.
+   */
+  receive_calendar_id?: string;
+
   /**
    * State or administrative area.
    */
@@ -263,6 +269,12 @@ export interface UpdateAddressRequest {
    */
   postal_code?: string;
 
+  /**
+   * The operating calendar naming the days this dock accepts freight, overriding the
+   * customer's own. Clearing it returns this address to the customer's own calendar.
+   */
+  receive_calendar_id?: string | null;
+
   /**
    * State or administrative area.
    */
@@ -351,6 +363,12 @@ export interface AddressCreateParams {
    */
   postal_code?: string;
 
+  /**
+   * The operating calendar naming the days this dock accepts freight, overriding the
+   * customer's own.
+   */
+  receive_calendar_id?: string;
+
   /**
    * State or administrative area.
    */
@@ -411,6 +429,12 @@ export interface AddressUpdateParams {
    */
   postal_code?: string;
 
+  /**
+   * The operating calendar naming the days this dock accepts freight, overriding the
+   * customer's own. Clearing it returns this address to the customer's own calendar.
+   */
+  receive_calendar_id?: string | null;
+
   /**
    * State or administrative area.
    */