@dsptch-work/api-client 0.49.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';
@@ -8872,6 +8878,15 @@ export type ProjectResponseObject = {
          */
         name: string;
     }>;
+    /**
+     * The project's structured address; null when unset.
+     */
+    project_address: {
+        /**
+         * Human-readable one-line address label.
+         */
+        label: string;
+    } | null;
     /**
      * Federal PWA tracking mode: `all` (prevailing wage + apprenticeship), `pw_only` (prevailing wage), `ap_only` (apprenticeship), or `none`.
      */
@@ -9040,6 +9055,59 @@ export type ProjectParameters = {
      * Complete desired set of unique nonblank manager user IDs. Omit to preserve the set; send an empty array to clear it. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before any project or relationship is saved. Each id must name a manager of the owning company.
      */
     manager_user_ids?: Array<string>;
+    /**
+     * The project's structured street address. Send an object to set it; null clears the association; omit the key to leave the stored address; an empty object is a no-op. A non-object answers 422; an unknown key inside it, `place_id` included, answers 422 at its pointer.
+     */
+    project_address_attributes?: {
+        /**
+         * ID of an existing address to update; null to create a new address.
+         */
+        id?: string | null;
+        /**
+         * Secondary address designator such as an apartment or suite number; null when unset.
+         */
+        sub_address_number?: string | null;
+        /**
+         * Street number of the address; null when unset.
+         */
+        address_number?: string | null;
+        /**
+         * Neighborhood of the address; null when unset.
+         */
+        neighborhood?: string | null;
+        /**
+         * City or municipality of the address; null when unset.
+         */
+        municipality?: string | null;
+        /**
+         * County or other sub-region of the address; null when unset.
+         */
+        sub_region?: string | null;
+        /**
+         * State or region of the address; null when unset.
+         */
+        region?: string | null;
+        /**
+         * Postal or ZIP code of the address; null when unset.
+         */
+        postal_code?: string | null;
+        /**
+         * Country of the address; null when unset.
+         */
+        country?: string | null;
+        /**
+         * Time zone of the address (e.g. US/Central); null when unset. A blank or unlisted name answers 422.
+         */
+        timezone?: string | null;
+        /**
+         * Whether the address has been verified. A boolean; null or any other type returns 422.
+         */
+        verified?: boolean;
+        /**
+         * Human-readable one-line address label; null derives it from the other fields.
+         */
+        label?: string | null;
+    } | null;
     /**
      * Schedule start date as an ISO8601 date (YYYY-MM-DD), or null; requires tz_name to be set. Any other string, a timestamp included, answers 422.
      */
@@ -9049,9 +9117,9 @@ export type ProjectParameters = {
      */
     end_date?: string | null;
     /**
-     * IANA time zone name, or null. Required when start_date is set. A blank or unlisted name answers 422.
+     * IANA time zone name, never null. A blank or unlisted name answers 422.
      */
-    tz_name?: string | null;
+    tz_name?: string;
     /**
      * Day of week billing starts, as an integer: 0 (Sunday) through 6 (Saturday), or null. Any other value, a numeric string included, answers 422.
      */
@@ -9149,6 +9217,59 @@ export type ProjectUpdateParameters = {
      * Complete desired set of unique nonblank manager user IDs. Omit to preserve the set; send an empty array to clear it. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before any project or relationship is saved. Each id must name a manager of the owning company.
      */
     manager_user_ids?: Array<string>;
+    /**
+     * The project's structured street address. Send an object to set it; null clears the association; omit the key to leave the stored address; an empty object is a no-op. A non-object answers 422; an unknown key inside it, `place_id` included, answers 422 at its pointer.
+     */
+    project_address_attributes?: {
+        /**
+         * ID of an existing address to update; null to create a new address.
+         */
+        id?: string | null;
+        /**
+         * Secondary address designator such as an apartment or suite number; null when unset.
+         */
+        sub_address_number?: string | null;
+        /**
+         * Street number of the address; null when unset.
+         */
+        address_number?: string | null;
+        /**
+         * Neighborhood of the address; null when unset.
+         */
+        neighborhood?: string | null;
+        /**
+         * City or municipality of the address; null when unset.
+         */
+        municipality?: string | null;
+        /**
+         * County or other sub-region of the address; null when unset.
+         */
+        sub_region?: string | null;
+        /**
+         * State or region of the address; null when unset.
+         */
+        region?: string | null;
+        /**
+         * Postal or ZIP code of the address; null when unset.
+         */
+        postal_code?: string | null;
+        /**
+         * Country of the address; null when unset.
+         */
+        country?: string | null;
+        /**
+         * Time zone of the address (e.g. US/Central); null when unset. A blank or unlisted name answers 422.
+         */
+        timezone?: string | null;
+        /**
+         * Whether the address has been verified. A boolean; null or any other type returns 422.
+         */
+        verified?: boolean;
+        /**
+         * Human-readable one-line address label; null derives it from the other fields.
+         */
+        label?: string | null;
+    } | null;
     /**
      * Schedule start date as an ISO8601 date (YYYY-MM-DD), or null; requires tz_name to be set. Any other string, a timestamp included, answers 422.
      */
@@ -9158,9 +9279,9 @@ export type ProjectUpdateParameters = {
      */
     end_date?: string | null;
     /**
-     * IANA time zone name, or null. Required when start_date is set. A blank or unlisted name answers 422.
+     * IANA time zone name, never null. A blank or unlisted name answers 422.
      */
-    tz_name?: string | null;
+    tz_name?: string;
     /**
      * Day of week billing starts, as an integer: 0 (Sunday) through 6 (Saturday), or null. Any other value, a numeric string included, answers 422.
      */
@@ -15654,6 +15775,10 @@ export type AssetsSiteResponseObject = {
      * Category of the backing Atlas site, taken from its site-type catalog; null when the location is not backed by a map site. Read-only — derived from the backing site.
      */
     site_type: string | null;
+    /**
+     * IDs of the users who answer for this location — a transfer sent to it is addressed to them, and they are notified and asked to accept it. Empty when nobody is named, in which case every admin and manager of the company answers.
+     */
+    responsible_user_ids: Array<string>;
     /**
      * When the record was created (ISO 8601).
      */
@@ -15679,6 +15804,10 @@ export type AssetsSiteParameters = {
      * Display name for the location. Required when no backing site_id is given; otherwise falls back to the backing Atlas site's name.
      */
     name?: string | null;
+    /**
+     * Unique nonblank IDs of the users who answer for this location; each must be an admin, manager, safety manager, or field lead of the company. Providing this replaces the entire set; an empty array clears it, leaving every admin and manager of the company to answer. Omit to name nobody or leave the set unchanged on update. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422. A user who cannot answer for the location answers 404.
+     */
+    responsible_user_ids?: Array<string>;
 };
 /**
  * Request body for updating an asset location. Every field is optional; send only the fields to change. The saved location must still have a name or a backing `site_id`.
@@ -15696,6 +15825,10 @@ export type AssetsSiteUpdateParameters = {
      * Display name for the location. `null` clears the direct name when a backing `site_id` supplies the display name.
      */
     name?: string | null;
+    /**
+     * Unique nonblank IDs of the users who answer for this location; each must be an admin, manager, safety manager, or field lead of the company. Providing this replaces the entire set; an empty array clears it, leaving every admin and manager of the company to answer. Omit to name nobody or leave the set unchanged on update. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422. A user who cannot answer for the location answers 404.
+     */
+    responsible_user_ids?: Array<string>;
 };
 /**
  * A company-level rule that auto-generates asset form assignments. When an item of one of its products changes custody (an assignment or unassignment), the rule creates or refreshes a form task for the chosen users, due on the configured schedule.
@@ -16918,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 = {
     /**
@@ -16930,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.
      */
@@ -16966,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.
      */
@@ -17000,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 = {
     /**
@@ -17039,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.
      */
@@ -17053,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.
  */
@@ -21668,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;
@@ -34600,7 +35022,7 @@ export type CreateProjectErrors = {
      */
     404: Problem;
     /**
-     * Unprocessable Content (invalid signed id)
+     * Unprocessable Content (unknown nested address key)
      */
     422: Problem;
 };