com.squareup.square.api

Interface InventoryApi

All Known Implementing Classes:

DefaultInventoryApi

public interface InventoryApi

This interface lists all the endpoints of the group. This can be overridden for the mock calls.

Method Summary

Modifier and Type	Method and Description
BatchChangeInventoryResponse	batchChangeInventory(BatchChangeInventoryRequest body) Applies adjustments and counts to the provided item quantities.
CompletableFuture<BatchChangeInventoryResponse>	batchChangeInventoryAsync(BatchChangeInventoryRequest body) Applies adjustments and counts to the provided item quantities.
BatchRetrieveInventoryChangesResponse	batchRetrieveInventoryChanges(BatchRetrieveInventoryChangesRequest body) Returns historical physical counts and adjustments based on the provided filter criteria.
CompletableFuture<BatchRetrieveInventoryChangesResponse>	batchRetrieveInventoryChangesAsync(BatchRetrieveInventoryChangesRequest body) Returns historical physical counts and adjustments based on the provided filter criteria.
BatchRetrieveInventoryCountsResponse	batchRetrieveInventoryCounts(BatchRetrieveInventoryCountsRequest body) Returns current counts for the provided [CatalogObject](#type-catalogobject)s at the requested [Location](#type-location)s.
CompletableFuture<BatchRetrieveInventoryCountsResponse>	batchRetrieveInventoryCountsAsync(BatchRetrieveInventoryCountsRequest body) Returns current counts for the provided [CatalogObject](#type-catalogobject)s at the requested [Location](#type-location)s.
RetrieveInventoryAdjustmentResponse	retrieveInventoryAdjustment(String adjustmentId) Returns the [InventoryAdjustment](#type-inventoryadjustment) object with the provided `adjustment_id`.
CompletableFuture<RetrieveInventoryAdjustmentResponse>	retrieveInventoryAdjustmentAsync(String adjustmentId) Returns the [InventoryAdjustment](#type-inventoryadjustment) object with the provided `adjustment_id`.
RetrieveInventoryChangesResponse	retrieveInventoryChanges(String catalogObjectId, String locationIds, String cursor) Returns a set of physical counts and inventory adjustments for the provided [CatalogObject](#type-catalogobject) at the requested [Location](#type-location)s.
CompletableFuture<RetrieveInventoryChangesResponse>	retrieveInventoryChangesAsync(String catalogObjectId, String locationIds, String cursor) Returns a set of physical counts and inventory adjustments for the provided [CatalogObject](#type-catalogobject) at the requested [Location](#type-location)s.
RetrieveInventoryCountResponse	retrieveInventoryCount(String catalogObjectId, String locationIds, String cursor) Retrieves the current calculated stock count for a given [CatalogObject](#type-catalogobject) at a given set of [Location](#type-location)s.
CompletableFuture<RetrieveInventoryCountResponse>	retrieveInventoryCountAsync(String catalogObjectId, String locationIds, String cursor) Retrieves the current calculated stock count for a given [CatalogObject](#type-catalogobject) at a given set of [Location](#type-location)s.
RetrieveInventoryPhysicalCountResponse	retrieveInventoryPhysicalCount(String physicalCountId) Returns the [InventoryPhysicalCount](#type-inventoryphysicalcount) object with the provided `physical_count_id`.
CompletableFuture<RetrieveInventoryPhysicalCountResponse>	retrieveInventoryPhysicalCountAsync(String physicalCountId) Returns the [InventoryPhysicalCount](#type-inventoryphysicalcount) object with the provided `physical_count_id`.

Method Detail

retrieveInventoryAdjustment

RetrieveInventoryAdjustmentResponse retrieveInventoryAdjustment(String adjustmentId)
                                                         throws ApiException,
                                                                IOException

Returns the [InventoryAdjustment](#type-inventoryadjustment) object with the provided `adjustment_id`.

Parameters:

adjustmentId - Required parameter: ID of the [InventoryAdjustment](#type-inventoryadjustment) to retrieve.

Returns:

Returns the RetrieveInventoryAdjustmentResponse response from the API call

Throws:

ApiException

IOException

retrieveInventoryAdjustmentAsync

CompletableFuture<RetrieveInventoryAdjustmentResponse> retrieveInventoryAdjustmentAsync(String adjustmentId)

Returns the [InventoryAdjustment](#type-inventoryadjustment) object with the provided `adjustment_id`.

Parameters:

adjustmentId - Required parameter: ID of the [InventoryAdjustment](#type-inventoryadjustment) to retrieve.

Returns:

Returns the RetrieveInventoryAdjustmentResponse response from the API call

batchChangeInventory

BatchChangeInventoryResponse batchChangeInventory(BatchChangeInventoryRequest body)
                                           throws ApiException,
                                                  IOException

Applies adjustments and counts to the provided item quantities. On success: returns the current calculated counts for all objects referenced in the request. On failure: returns a list of related errors.

Parameters:

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the BatchChangeInventoryResponse response from the API call

Throws:

ApiException

IOException

batchChangeInventoryAsync

CompletableFuture<BatchChangeInventoryResponse> batchChangeInventoryAsync(BatchChangeInventoryRequest body)

Applies adjustments and counts to the provided item quantities. On success: returns the current calculated counts for all objects referenced in the request. On failure: returns a list of related errors.

Parameters:

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the BatchChangeInventoryResponse response from the API call

batchRetrieveInventoryChanges

BatchRetrieveInventoryChangesResponse batchRetrieveInventoryChanges(BatchRetrieveInventoryChangesRequest body)
                                                             throws ApiException,
                                                                    IOException

Returns historical physical counts and adjustments based on the provided filter criteria. Results are paginated and sorted in ascending order according their `occurred_at` timestamp (oldest first). BatchRetrieveInventoryChanges is a catch-all query endpoint for queries that cannot be handled by other, simpler endpoints.

Parameters:

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the BatchRetrieveInventoryChangesResponse response from the API call

Throws:

ApiException

IOException

batchRetrieveInventoryChangesAsync

CompletableFuture<BatchRetrieveInventoryChangesResponse> batchRetrieveInventoryChangesAsync(BatchRetrieveInventoryChangesRequest body)

Returns historical physical counts and adjustments based on the provided filter criteria. Results are paginated and sorted in ascending order according their `occurred_at` timestamp (oldest first). BatchRetrieveInventoryChanges is a catch-all query endpoint for queries that cannot be handled by other, simpler endpoints.

Parameters:

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the BatchRetrieveInventoryChangesResponse response from the API call

batchRetrieveInventoryCounts

BatchRetrieveInventoryCountsResponse batchRetrieveInventoryCounts(BatchRetrieveInventoryCountsRequest body)
                                                           throws ApiException,
                                                                  IOException

Returns current counts for the provided [CatalogObject](#type-catalogobject)s at the requested [Location](#type-location)s. Results are paginated and sorted in descending order according to their `calculated_at` timestamp (newest first). When `updated_after` is specified, only counts that have changed since that time (based on the server timestamp for the most recent change) are returned. This allows clients to perform a "sync" operation, for example in response to receiving a Webhook notification.

Parameters:

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the BatchRetrieveInventoryCountsResponse response from the API call

Throws:

ApiException

IOException

batchRetrieveInventoryCountsAsync

CompletableFuture<BatchRetrieveInventoryCountsResponse> batchRetrieveInventoryCountsAsync(BatchRetrieveInventoryCountsRequest body)

Returns current counts for the provided [CatalogObject](#type-catalogobject)s at the requested [Location](#type-location)s. Results are paginated and sorted in descending order according to their `calculated_at` timestamp (newest first). When `updated_after` is specified, only counts that have changed since that time (based on the server timestamp for the most recent change) are returned. This allows clients to perform a "sync" operation, for example in response to receiving a Webhook notification.

Parameters:

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the BatchRetrieveInventoryCountsResponse response from the API call

retrieveInventoryPhysicalCount

RetrieveInventoryPhysicalCountResponse retrieveInventoryPhysicalCount(String physicalCountId)
                                                               throws ApiException,
                                                                      IOException

Returns the [InventoryPhysicalCount](#type-inventoryphysicalcount) object with the provided `physical_count_id`.

Parameters:

physicalCountId - Required parameter: ID of the [InventoryPhysicalCount](#type-inventoryphysicalcount) to retrieve.

Returns:

Returns the RetrieveInventoryPhysicalCountResponse response from the API call

Throws:

ApiException

IOException

retrieveInventoryPhysicalCountAsync

CompletableFuture<RetrieveInventoryPhysicalCountResponse> retrieveInventoryPhysicalCountAsync(String physicalCountId)

Returns the [InventoryPhysicalCount](#type-inventoryphysicalcount) object with the provided `physical_count_id`.

Parameters:

physicalCountId - Required parameter: ID of the [InventoryPhysicalCount](#type-inventoryphysicalcount) to retrieve.

Returns:

Returns the RetrieveInventoryPhysicalCountResponse response from the API call

retrieveInventoryCount

RetrieveInventoryCountResponse retrieveInventoryCount(String catalogObjectId,
                                                      String locationIds,
                                                      String cursor)
                                               throws ApiException,
                                                      IOException

Retrieves the current calculated stock count for a given [CatalogObject](#type-catalogobject) at a given set of [Location](#type-location)s. Responses are paginated and unsorted. For more sophisticated queries, use a batch endpoint.

Parameters:

catalogObjectId - Required parameter: ID of the [CatalogObject](#type-catalogobject) to retrieve.

locationIds - Optional parameter: The [Location](#type-location) IDs to look up as a comma-separated list. An empty list queries all locations.

cursor - Optional parameter: A pagination cursor returned by a previous call to this endpoint. Provide this to retrieve the next set of results for the original query. See the [Pagination](https://developer.squareup.com/docs/docs/working-with-apis/pagination) guide for more information.

Returns:

Returns the RetrieveInventoryCountResponse response from the API call

Throws:

ApiException

IOException

retrieveInventoryCountAsync

CompletableFuture<RetrieveInventoryCountResponse> retrieveInventoryCountAsync(String catalogObjectId,
                                                                              String locationIds,
                                                                              String cursor)

Retrieves the current calculated stock count for a given [CatalogObject](#type-catalogobject) at a given set of [Location](#type-location)s. Responses are paginated and unsorted. For more sophisticated queries, use a batch endpoint.

Parameters:

catalogObjectId - Required parameter: ID of the [CatalogObject](#type-catalogobject) to retrieve.

locationIds - Optional parameter: The [Location](#type-location) IDs to look up as a comma-separated list. An empty list queries all locations.

cursor - Optional parameter: A pagination cursor returned by a previous call to this endpoint. Provide this to retrieve the next set of results for the original query. See the [Pagination](https://developer.squareup.com/docs/docs/working-with-apis/pagination) guide for more information.

Returns:

Returns the RetrieveInventoryCountResponse response from the API call

retrieveInventoryChanges

RetrieveInventoryChangesResponse retrieveInventoryChanges(String catalogObjectId,
                                                          String locationIds,
                                                          String cursor)
                                                   throws ApiException,
                                                          IOException

Returns a set of physical counts and inventory adjustments for the provided [CatalogObject](#type-catalogobject) at the requested [Location](#type-location)s. Results are paginated and sorted in descending order according to their `occurred_at` timestamp (newest first). There are no limits on how far back the caller can page. This endpoint can be used to display recent changes for a specific item. For more sophisticated queries, use a batch endpoint.

Parameters:

catalogObjectId - Required parameter: ID of the [CatalogObject](#type-catalogobject) to retrieve.

locationIds - Optional parameter: The [Location](#type-location) IDs to look up as a comma-separated list. An empty list queries all locations.

cursor - Optional parameter: A pagination cursor returned by a previous call to this endpoint. Provide this to retrieve the next set of results for the original query. See the [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination) guide for more information.

Returns:

Returns the RetrieveInventoryChangesResponse response from the API call

Throws:

ApiException

IOException

retrieveInventoryChangesAsync

CompletableFuture<RetrieveInventoryChangesResponse> retrieveInventoryChangesAsync(String catalogObjectId,
                                                                                  String locationIds,
                                                                                  String cursor)

Returns a set of physical counts and inventory adjustments for the provided [CatalogObject](#type-catalogobject) at the requested [Location](#type-location)s. Results are paginated and sorted in descending order according to their `occurred_at` timestamp (newest first). There are no limits on how far back the caller can page. This endpoint can be used to display recent changes for a specific item. For more sophisticated queries, use a batch endpoint.

Parameters:

catalogObjectId - Required parameter: ID of the [CatalogObject](#type-catalogobject) to retrieve.

locationIds - Optional parameter: The [Location](#type-location) IDs to look up as a comma-separated list. An empty list queries all locations.

cursor - Optional parameter: A pagination cursor returned by a previous call to this endpoint. Provide this to retrieve the next set of results for the original query. See the [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination) guide for more information.

Returns:

Returns the RetrieveInventoryChangesResponse response from the API call