@augno/sdk 0.18.1 → 0.19.0

package/src/resources/operations/machine-downtime-events.ts

@@ -6,6 +6,7 @@ import * as RequestLogsAPI from '../core/request-logs';
 import * as BlocksAPI from '../messaging/blocks';
 import * as OperationsAPI from './operations';
 import * as APIKeysAPI from '../auth/api-keys/api-keys';
+import * as InventoryAPI from '../catalog/items/inventory';
 import * as ItemsAPI from '../catalog/items/items';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
@@ -61,9 +62,11 @@ export class MachineDowntimeEvents extends APIResource {
   /**
    * Logs a machine downtime event.
    *
-   * Omit `ended_at` while the machine is still down. A machine can only have one
-   * open event at a time, so logging a second open stoppage against a machine that
-   * is already down is rejected until the first is closed.
+   * Give the stoppage an end either as `ended_at` or as a `duration` counted in a
+   * unit of time — sending both is rejected. Omit `ended_at` while the machine is
+   * still down. A machine can only have one open event at a time, so logging a
+   * second open stoppage against a machine that is already down is rejected until
+   * the first is closed.
    *
    * The department is taken from the machine, the business day is taken from
    * `started_at`, the event is attributed to the credentials that made the request,
@@ -96,10 +99,12 @@ export class MachineDowntimeEvents extends APIResource {
   /**
    * Closes or corrects a machine downtime event.
    *
-   * Only the fields provided in the request are changed. Setting `ended_at` closes
-   * the event and calculates its duration; sending it as null reopens an event
-   * closed by mistake, which is rejected when the machine already has another open
-   * stoppage. The machine an event belongs to cannot be changed.
+   * Only the fields provided in the request are changed. Setting `ended_at` — or a
+   * `duration`, which says the same thing as a length of time from the start —
+   * closes the event and calculates how long it lasted; sending either as null
+   * reopens an event closed by mistake, which is rejected when the machine already
+   * has another open stoppage. Moving the event to another machine re-resolves the
+   * department the stoppage is charged to.
    *
    * This endpoint requires the permission: `machine_downtime:update`.
    *
@@ -187,6 +192,14 @@ export interface CreateMachineDowntimeEventRequest {
    */
   batch_id?: string;
 
+  /**
+   * An amount together with the unit it is expressed in.
+   *
+   * The unit may be a currency, so money amounts such as a credit limit are written
+   * the same way as physical amounts like weights or counts.
+   */
+  duration?: InventoryAPI.QuantityInput;
+
   /**
    * When the machine started running again.
    *
@@ -382,6 +395,14 @@ export interface UpdateMachineDowntimeEventRequest {
    */
   batch_id?: string | null;
 
+  /**
+   * An amount together with the unit it is expressed in.
+   *
+   * The unit may be a currency, so money amounts such as a credit limit are written
+   * the same way as physical amounts like weights or counts.
+   */
+  duration?: InventoryAPI.QuantityInput | null;
+
   /**
    * When the machine started running again.
    *
@@ -398,6 +419,15 @@ export interface UpdateMachineDowntimeEventRequest {
    */
   item_id?: string | null;
 
+  /**
+   * ID of the machine that stopped.
+   *
+   * Moving an event to another machine re-resolves the department it is charged to,
+   * so past availability changes for both rooms. Rejected when the destination
+   * machine already has an open stoppage and this one is open too.
+   */
+  machine_id?: string;
+
   /**
    * Free-form notes about the stoppage.
    *
@@ -563,6 +593,14 @@ export interface MachineDowntimeEventCreateParams {
    */
   batch_id?: string;
 
+  /**
+   * Body param: An amount together with the unit it is expressed in.
+   *
+   * The unit may be a currency, so money amounts such as a credit limit are written
+   * the same way as physical amounts like weights or counts.
+   */
+  duration?: InventoryAPI.QuantityInput;
+
   /**
    * Body param: When the machine started running again.
    *
@@ -613,6 +651,14 @@ export interface MachineDowntimeEventUpdateParams {
    */
   batch_id?: string | null;
 
+  /**
+   * Body param: An amount together with the unit it is expressed in.
+   *
+   * The unit may be a currency, so money amounts such as a credit limit are written
+   * the same way as physical amounts like weights or counts.
+   */
+  duration?: InventoryAPI.QuantityInput | null;
+
   /**
    * Body param: When the machine started running again.
    *
@@ -629,6 +675,15 @@ export interface MachineDowntimeEventUpdateParams {
    */
   item_id?: string | null;
 
+  /**
+   * Body param: ID of the machine that stopped.
+   *
+   * Moving an event to another machine re-resolves the department it is charged to,
+   * so past availability changes for both rooms. Rejected when the destination
+   * machine already has an open stoppage and this one is open too.
+   */
+  machine_id?: string;
+
   /**
    * Body param: Free-form notes about the stoppage.
    *

package/src/resources/operations/operations.ts

@@ -132,6 +132,7 @@ import {
   ListProductionScheduleDerivedLine,
   ListProductionScheduleDeviation,
   ListProductionScheduleFinishedPolicy,
+  ListProductionScheduleFinishingLine,
   ListProductionScheduleItemPolicy,
   ListReleaseScheduleBatch,
   ListReleasedScheduleLine,
@@ -145,10 +146,12 @@ import {
   ProductionScheduleDerivedLine,
   ProductionScheduleDeviation,
   ProductionScheduleFinishedPolicy,
+  ProductionScheduleFinishingLine,
   ProductionScheduleItemPolicy,
   ProductionScheduleListParams,
   ProductionScheduleRetrieveDerivedLinesParams,
   ProductionScheduleRetrieveDeviationsParams,
+  ProductionScheduleRetrieveFinishingLinesParams,
   ProductionScheduleRetrieveWeekReleasePreviewParams,
   ProductionSchedules,
   ReleaseScheduleBatch,
@@ -157,6 +160,7 @@ import {
   ScheduleAppliedOverride,
   ScheduleAtRiskOrder,
   ScheduleDiagnostics,
+  ScheduleFinishingDiagnostics,
   ScheduleOrderCoverage,
   ScheduleOrderCoverageLine,
 } from './production-schedules/production-schedules';
@@ -889,6 +893,7 @@ export declare namespace Operations {
     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,
@@ -900,6 +905,7 @@ export declare namespace Operations {
     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,
@@ -907,11 +913,13 @@ export declare namespace Operations {
     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/operations/production-schedule-settings/production-schedule-settings.ts

@@ -206,8 +206,9 @@ export interface ProductionScheduleSettings {
   /**
    * Calendar days between an order being issued and it being due to ship.
    *
-   * The last resort in the ship-by chain: a lead time set on the customer, or on the
-   * customer's account group, takes precedence. Zero means same-day shipping.
+   * The last resort in the ship-by chain: a lead time set on the customer, on its
+   * parent account, or on the customer's account group takes precedence. Zero means
+   * same-day shipping.
    */
   default_customer_lead_time_days: number;
 
@@ -481,11 +482,11 @@ export interface UpdateProductionScheduleSettingsRequest {
   /**
    * Calendar days between an order being issued and it being due to ship.
    *
-   * The last resort in the ship-by chain: a lead time set on the customer, or on the
-   * customer's account group, takes precedence. Zero commits the account to same-day
-   * shipping on every order that falls through to it, so this update replaces the
-   * whole settings object and omitting the field is not the same as leaving it
-   * alone.
+   * The last resort in the ship-by chain: a lead time set on the customer, on its
+   * parent account, or on the customer's account group takes precedence. Zero
+   * commits the account to same-day shipping on every order that falls through to
+   * it, so this update replaces the whole settings object and omitting the field is
+   * not the same as leaving it alone.
    */
   default_customer_lead_time_days: number;
 
@@ -741,11 +742,11 @@ export interface ProductionScheduleSettingUpdateParams {
   /**
    * Calendar days between an order being issued and it being due to ship.
    *
-   * The last resort in the ship-by chain: a lead time set on the customer, or on the
-   * customer's account group, takes precedence. Zero commits the account to same-day
-   * shipping on every order that falls through to it, so this update replaces the
-   * whole settings object and omitting the field is not the same as leaving it
-   * alone.
+   * The last resort in the ship-by chain: a lead time set on the customer, on its
+   * parent account, or on the customer's account group takes precedence. Zero
+   * commits the account to same-day shipping on every order that falls through to
+   * it, so this update replaces the whole settings object and omitting the field is
+   * not the same as leaving it alone.
    */
   default_customer_lead_time_days: number;
 

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,