@dsptch-work/api-client 0.50.0 → 0.51.0

package/dist/gen/types.gen.d.ts

@@ -3955,6 +3955,9 @@ export type PayPeriodConfigHistoryCorrectionObject = {
     start_day_of_week: number;
     tz_name: string;
     currency: string;
+    /**
+     * New schedules return pending while pay periods are generated. Synced means pay periods were generated for the requested versions and time card synchronization was successfully requested; asynchronous time card jobs may still be queued. Poll until synced or failed. Failed means generation or the synchronization request failed.
+     */
     status: 'synced' | 'pending' | 'failed';
     payroll_mode: 'none' | 'base' | 'aggregate' | null;
     time_mode: 'none' | 'base' | 'aggregate';
@@ -3981,6 +3984,9 @@ export type PayPeriodConfigHistoryVersionObject = {
     start_day_of_week: number;
     tz_name: string;
     currency: string;
+    /**
+     * New schedules return pending while pay periods are generated. Synced means pay periods were generated for the requested versions and time card synchronization was successfully requested; asynchronous time card jobs may still be queued. Poll until synced or failed. Failed means generation or the synchronization request failed.
+     */
     status: 'synced' | 'pending' | 'failed';
     payroll_mode: 'none' | 'base' | 'aggregate' | null;
     time_mode: 'none' | 'base' | 'aggregate';
@@ -17045,7 +17051,7 @@ export type AssetsSubLocationUpdateParameters = {
     code?: string;
 };
 /**
- * A completed movement of item stock between two holders, each a site, a user, or a container. Each line moves one item; applying the transfer records paired outbound and inbound transactions and updates the on-hand, custody, and containment counts. Transfers created through this API are always completed. One-sided moves (placing or removing an item with only one endpoint) record transactions but no transfer, and so are not represented by this resource.
+ * A movement of item stock between two holders, each a site, a user, or a container. Each line names one item. A completed transfer has applied paired outbound and inbound transactions and updated on-hand, custody, and containment counts. A pending transfer has not moved stock; it waits to be accepted, declined, or cancelled. One-sided moves (placing or removing an item with only one endpoint) record transactions but no transfer, and so are not represented by this resource.
  */
 export type AssetsTransferResponseObject = {
     /**
@@ -17057,9 +17063,9 @@ export type AssetsTransferResponseObject = {
      */
     company_id: string;
     /**
-     * Lifecycle state of the transfer: one of pending, in_transit, completed, or cancelled. Transfers created through this API are always completed.
+     * Lifecycle state of the transfer. The published values are the model's status keys, including declined.
      */
-    status: 'pending' | 'in_transit' | 'completed' | 'cancelled';
+    status: 'pending' | 'in_transit' | 'completed' | 'declined' | 'cancelled';
     /**
      * ID of the source site; null when the source is a user or container.
      */
@@ -17093,9 +17099,17 @@ export type AssetsTransferResponseObject = {
      */
     initiated_by_user_id: string;
     /**
-     * When the transfer was applied (ISO 8601); null for a transfer that is not yet completed.
+     * ID of the user who completed, declined, or cancelled the transfer; null while it is unresolved.
+     */
+    resolved_by_user_id: string | null;
+    /**
+     * When the transfer was applied (ISO 8601); null unless status is completed. Same instant as resolved_at when completed.
      */
     completed_at: string | null;
+    /**
+     * When the transfer was completed, declined, or cancelled (ISO 8601); null while it is unresolved.
+     */
+    resolved_at: string | null;
     /**
      * The item movements in this transfer, one entry per item.
      */
@@ -17127,7 +17141,7 @@ export type AssetsTransferResponseObject = {
     updated_at: string;
 };
 /**
- * Move item stock. Each endpoint is a site, a user, or a container — give at most one per side; more than one on a side, or no endpoint at all, answers 422. With both a source and a destination this is a two-sided transfer (returns the created transfer, 201). With a single open end it is a one-sided move — placing an unplaced item (destination only) or removing it from its holder (source only) — which records transactions but no transfer and returns 204. Moves are applied immediately, so the source must hold enough of each item.
+ * Move item stock. Each endpoint is a site, a user, or a container — give at most one per side; more than one on a side, or no endpoint at all, answers 422. With both a source and a destination this is a two-sided transfer (returns the created transfer, 201). Omit status or send completed to apply it immediately; send pending to persist without moving stock. A pending create requires both endpoints (one endpoint answers 422). With a single open end and completed (or omitted) status it is a one-sided move — placing an unplaced item (destination only) or removing it from its holder (source only) — which records transactions but no transfer and returns 204. A completed create applies immediately, so the source must hold enough of each item.
  */
 export type AssetsTransferParameters = {
     /**
@@ -17166,6 +17180,10 @@ export type AssetsTransferParameters = {
      * ID of the user this move is performed on behalf of, recorded as its initiator. Omission answers 400; supplied null, a blank ID, or a wrong type answers 422. A user outside the company that owns the API key answers 422.
      */
     performed_by_user_id: string;
+    /**
+     * Optional. pending persists the transfer without moving stock. completed (the default when omitted) applies the move immediately. A pending create requires both a source and a destination; one endpoint answers 422. Any other value answers 422.
+     */
+    status?: 'pending' | 'completed';
     /**
      * The items and quantities to move, as a list of row objects; at least one is required. Omission answers 400, and null, an empty list, or a value that is not a list answers 422. A row missing a field answers 400 naming it, and an unknown or wrongly typed row field answers 422 at that row.
      */
@@ -17180,6 +17198,83 @@ export type AssetsTransferParameters = {
         quantity: number;
     }>;
 };
+/**
+ * Answer a transfer — decline, cancel, or reopen it. The named filer is recorded on the step. An optional note is the step comment.
+ */
+export type AssetsTransferCommandParameters = {
+    /**
+     * ID of the user this answer is performed on behalf of, recorded on the step. Omission answers 400; supplied null, a blank ID, or a wrong type answers 422. A user outside the company that owns the API key answers 422.
+     */
+    performed_by_user_id: string;
+    /**
+     * Optional comment recorded with the step. Omit to leave the step without a comment.
+     */
+    note?: string;
+};
+/**
+ * Accept a pending transfer and move its stock. The named filer is recorded on the step. An optional note is the step comment. Optional placements put individual lines away at the destination; a line without a placement lands in the destination holder's own bucket.
+ */
+export type AssetsTransferAcceptanceParameters = {
+    /**
+     * ID of the user this acceptance is performed on behalf of, recorded on the step. Omission answers 400; supplied null, a blank ID, or a wrong type answers 422. A user outside the company that owns the API key answers 422.
+     */
+    performed_by_user_id: string;
+    /**
+     * Optional comment recorded with the step. Omit to leave the step without a comment.
+     */
+    note?: string;
+    /**
+     * Optional list of per-line put-aways at the destination. Omit or send an empty list to land every line in the destination holder's own bucket. A placement that names a line not on the transfer answers 422.
+     */
+    placements?: Array<{
+        /**
+         * ID of the transfer line to put away. A blank ID or a wrong type answers 422 at its row.
+         */
+        line_id: string;
+        /**
+         * Optional. ID of a container at the destination to put this line into. Omit or send null for the destination holder's own bucket. A blank ID or a wrong type answers 422 at its row.
+         */
+        container_id?: string | null;
+        /**
+         * Optional. ID of a storage location at the destination (or inside the named container) to put this line into. Omit or send null for the holder's or container's unbinned bucket. A blank ID or a wrong type answers 422 at its row.
+         */
+        sub_location_id?: string | null;
+    }>;
+};
+/**
+ * Add a line to a pending transfer. The item is identified the same way create's line_items are, under this transfer's source holder. Stock stays with the sender until the transfer is accepted. A resolved transfer answers 422.
+ */
+export type AssetsTransferLineParameters = {
+    /**
+     * ID of the asset item to add. A blank ID or a wrong type answers 422, and an item outside the company that owns the API key answers 404. The source holder must currently hold the item, or the matching bucket answers 404.
+     */
+    assets_item_id: string;
+    /**
+     * Number of units of the item to add, as an integer of 1 or more. Any other value, a fraction or a numeric string included, answers 422.
+     */
+    quantity: number;
+    /**
+     * Optional. The storage location within the source site or container this line's stock draws from. Omit or send null for the source's unbinned stock. A blank ID or a wrong type answers 422, a storage location outside the company that owns the API key answers 404, and one named against a user source answers 422.
+     */
+    from_assets_sub_location_id?: string | null;
+    /**
+     * Optional. The storage location within the destination site or container this line will land in when accepted. Omit to leave the line in the destination holder's own bucket. Send null for the same. A blank ID or a wrong type answers 422, and a storage location outside the company that owns the API key answers 404.
+     */
+    to_assets_sub_location_id?: string | null;
+};
+/**
+ * Change a pending transfer line's quantity and/or destination storage location. A resolved transfer answers 422. A line that is not on this transfer answers 404.
+ */
+export type AssetsTransferLineUpdateParameters = {
+    /**
+     * Optional. The new quantity, as an integer of 1 or more. Any other value, a fraction or a numeric string included, answers 422.
+     */
+    quantity?: number;
+    /**
+     * Optional. The storage location within the destination site or container this line will land in when accepted. Send null to land it in the destination holder's own bucket. A blank ID or a wrong type answers 422, and a storage location outside the company that owns the API key answers 404.
+     */
+    to_assets_sub_location_id?: string | null;
+};
 /**
  * Add stock of a bulk product to a holder — a site, a user's custody, or a container — recording a receive transaction. Name the holder with exactly one of assets_site_id, user_id, or container_item_id; several answer 422 at each named key, and none answers 422. Bulk products only.
  */
@@ -21795,6 +21890,206 @@ export type GetTransferResponses = {
     200: AssetsTransferResponseObject;
 };
 export type GetTransferResponse = GetTransferResponses[keyof GetTransferResponses];
+export type AcceptTransferData = {
+    body: AssetsTransferAcceptanceParameters;
+    path: {
+        transfer_id: string;
+    };
+    query?: never;
+    url: '/api/v1/assets/transfers/{transfer_id}/acceptance';
+};
+export type AcceptTransferErrors = {
+    /**
+     * Bad Request (missing performed_by_user_id)
+     */
+    400: Problem;
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
+    /**
+     * Unprocessable Content
+     */
+    422: Problem;
+};
+export type AcceptTransferError = AcceptTransferErrors[keyof AcceptTransferErrors];
+export type AcceptTransferResponses = {
+    /**
+     * Created
+     */
+    201: AssetsTransferResponseObject;
+};
+export type AcceptTransferResponse = AcceptTransferResponses[keyof AcceptTransferResponses];
+export type DeclineTransferData = {
+    body: AssetsTransferCommandParameters;
+    path: {
+        transfer_id: string;
+    };
+    query?: never;
+    url: '/api/v1/assets/transfers/{transfer_id}/decline';
+};
+export type DeclineTransferErrors = {
+    /**
+     * Forbidden
+     */
+    403: Problem;
+};
+export type DeclineTransferError = DeclineTransferErrors[keyof DeclineTransferErrors];
+export type DeclineTransferResponses = {
+    /**
+     * Created
+     */
+    201: AssetsTransferResponseObject;
+};
+export type DeclineTransferResponse = DeclineTransferResponses[keyof DeclineTransferResponses];
+export type CancelTransferData = {
+    body: AssetsTransferCommandParameters;
+    path: {
+        transfer_id: string;
+    };
+    query?: never;
+    url: '/api/v1/assets/transfers/{transfer_id}/cancellation';
+};
+export type CancelTransferErrors = {
+    /**
+     * Forbidden
+     */
+    403: Problem;
+};
+export type CancelTransferError = CancelTransferErrors[keyof CancelTransferErrors];
+export type CancelTransferResponses = {
+    /**
+     * Created
+     */
+    201: AssetsTransferResponseObject;
+};
+export type CancelTransferResponse = CancelTransferResponses[keyof CancelTransferResponses];
+export type ReopenTransferData = {
+    body: AssetsTransferCommandParameters;
+    path: {
+        transfer_id: string;
+    };
+    query?: never;
+    url: '/api/v1/assets/transfers/{transfer_id}/reopening';
+};
+export type ReopenTransferErrors = {
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Unprocessable Content
+     */
+    422: Problem;
+};
+export type ReopenTransferError = ReopenTransferErrors[keyof ReopenTransferErrors];
+export type ReopenTransferResponses = {
+    /**
+     * Created
+     */
+    201: AssetsTransferResponseObject;
+};
+export type ReopenTransferResponse = ReopenTransferResponses[keyof ReopenTransferResponses];
+export type CreateTransferLineData = {
+    body: AssetsTransferLineParameters;
+    path: {
+        transfer_id: string;
+    };
+    query?: never;
+    url: '/api/v1/assets/transfers/{transfer_id}/lines';
+};
+export type CreateTransferLineErrors = {
+    /**
+     * Bad Request
+     */
+    400: Problem;
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
+    /**
+     * Unprocessable Content
+     */
+    422: Problem;
+};
+export type CreateTransferLineError = CreateTransferLineErrors[keyof CreateTransferLineErrors];
+export type CreateTransferLineResponses = {
+    /**
+     * Created
+     */
+    201: AssetsTransferResponseObject;
+};
+export type CreateTransferLineResponse = CreateTransferLineResponses[keyof CreateTransferLineResponses];
+export type DeleteTransferLineData = {
+    body?: never;
+    path: {
+        transfer_id: string;
+        line_id: string;
+    };
+    query?: never;
+    url: '/api/v1/assets/transfers/{transfer_id}/lines/{line_id}';
+};
+export type DeleteTransferLineErrors = {
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Unprocessable Content
+     */
+    422: Problem;
+};
+export type DeleteTransferLineError = DeleteTransferLineErrors[keyof DeleteTransferLineErrors];
+export type DeleteTransferLineResponses = {
+    /**
+     * No Content
+     */
+    204: void;
+};
+export type DeleteTransferLineResponse = DeleteTransferLineResponses[keyof DeleteTransferLineResponses];
+export type UpdateTransferLineData = {
+    body: AssetsTransferLineUpdateParameters;
+    path: {
+        transfer_id: string;
+        line_id: string;
+    };
+    query?: never;
+    url: '/api/v1/assets/transfers/{transfer_id}/lines/{line_id}';
+};
+export type UpdateTransferLineErrors = {
+    /**
+     * Bad Request
+     */
+    400: Problem;
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
+    /**
+     * Unprocessable Content
+     */
+    422: Problem;
+};
+export type UpdateTransferLineError = UpdateTransferLineErrors[keyof UpdateTransferLineErrors];
+export type UpdateTransferLineResponses = {
+    /**
+     * Success
+     */
+    200: AssetsTransferResponseObject;
+};
+export type UpdateTransferLineResponse = UpdateTransferLineResponses[keyof UpdateTransferLineResponses];
 export type ListVendorsData = {
     body?: never;
     path?: never;