o tBhp@sPddlmZddlmZddlmZddlmZddlm Z GdddeZ dS) ) deprecated) APIHelper) ApiResponse)BaseApi)OAuth2cseZdZdZdfdd ZeddZddZed d Zed d Z ed dZ ddZ ddZ ddZ eddZddZddZ  d ddZe  d ddZZS)! InventoryApiz3A Controller to access Endpoints in the square API.Ncstt|||dSN)superr__init__)selfconfig call_back __class__o/var/www/html/riverr-enterprise-integrations-main/venv/lib/python3.10/site-packages/square/api/inventory_api.pyr szInventoryApi.__init__c Cd}t|d|ddi}|j}||7}t|}ddi}|jjj||d}t|j|| |}t |j }t |t urF|d} nd } t||| d } | S) aXDoes a GET request to /v2/inventory/adjustment/{adjustment_id}. Deprecated version of [RetrieveInventoryAdjustment]($e/Inventory/RetrieveInventoryAdjustment) after the endpoint URL is updated to conform to the standard convention. Args: adjustment_id (string): ID of the [InventoryAdjustment]($m/InventoryAdjustment) to retrieve. Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. z(/v2/inventory/adjustment/{adjustment_id} adjustment_idTvalueencodeacceptapplication/jsonheaderserrorsNbodyrr#append_url_with_template_parametersr get_base_uri clean_url http_clientgetrapplyexecute_requestjson_deserializetexttypedictr r r _url_path_query_builder _query_url_headers_request _responsedecoded_errors_resultrrr(deprecated_retrieve_inventory_adjustments$       z5InventoryApi.deprecated_retrieve_inventory_adjustmentc Cr) aDoes a GET request to /v2/inventory/adjustments/{adjustment_id}. Returns the [InventoryAdjustment]($m/InventoryAdjustment) object with the provided `adjustment_id`. Args: adjustment_id (string): ID of the [InventoryAdjustment]($m/InventoryAdjustment) to retrieve. Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. z)/v2/inventory/adjustments/{adjustment_id}rTrrrrrNrrr*rrrretrieve_inventory_adjustmentF$       z*InventoryApi.retrieve_inventory_adjustmentc Cd}|j}||7}t|}ddd}|jjj||t|d}t|j|| |}t |j }t |t ur@|d} nd} t||| d} | S)aDoes a POST request to /v2/inventory/batch-change. Deprecated version of [BatchChangeInventory]($e/Inventory/BatchChangeInventory) after the endpoint URL is updated to conform to the standard convention. Args: body (BatchChangeInventoryRequest): An object containing the fields to POST for the request. See the corresponding object definition for field details. Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. z/v2/inventory/batch-changerrz Content-Typer parametersrNrr r rr!r"postjson_serializerr$r%r&r'r(r)r#r r rr+r,r-r.r/r0r1r2r3rrr!deprecated_batch_change_inventoryx       z.InventoryApi.deprecated_batch_change_inventoryc Cr7)aDoes a POST request to /v2/inventory/batch-retrieve-changes. Deprecated version of [BatchRetrieveInventoryChanges]($e/Inventory/BatchRetrieveInventoryChan ges) after the endpoint URL is updated to conform to the standard convention. Args: body (BatchRetrieveInventoryChangesRequest): An object containing the fields to POST for the request. See the corresponding object definition for field details. Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. z$/v2/inventory/batch-retrieve-changesrr8r9rNrr;r>rrr+deprecated_batch_retrieve_inventory_changesr@z8InventoryApi.deprecated_batch_retrieve_inventory_changesc Cr7)aDoes a POST request to /v2/inventory/batch-retrieve-counts. Deprecated version of [BatchRetrieveInventoryCounts]($e/Inventory/BatchRetrieveInventoryCount s) after the endpoint URL is updated to conform to the standard convention. Args: body (BatchRetrieveInventoryCountsRequest): An object containing the fields to POST for the request. See the corresponding object definition for field details. Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. z#/v2/inventory/batch-retrieve-countsrr8r9rNrr;r>rrr*deprecated_batch_retrieve_inventory_countsr@z7InventoryApi.deprecated_batch_retrieve_inventory_countsc Cr7)aDoes a POST request to /v2/inventory/changes/batch-create. 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. Args: body (BatchChangeInventoryRequest): An object containing the fields to POST for the request. See the corresponding object definition for field details. Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. z"/v2/inventory/changes/batch-createrr8r9rNrr;r>rrrbatch_change_inventorys       z#InventoryApi.batch_change_inventoryc Cr7)a\Does a POST request to /v2/inventory/changes/batch-retrieve. 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. Args: body (BatchRetrieveInventoryChangesRequest): An object containing the fields to POST for the request. See the corresponding object definition for field details. Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. z$/v2/inventory/changes/batch-retrieverr8r9rNrr;r>rrr batch_retrieve_inventory_changesGs       z-InventoryApi.batch_retrieve_inventory_changesc Cr7)a2Does a POST request to /v2/inventory/counts/batch-retrieve. Returns current counts for the provided [CatalogObject]($m/CatalogObject)s at the requested [Location]($m/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. Args: body (BatchRetrieveInventoryCountsRequest): An object containing the fields to POST for the request. See the corresponding object definition for field details. Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. z#/v2/inventory/counts/batch-retrieverr8r9rNrr;r>rrrbatch_retrieve_inventory_counts}s #      z,InventoryApi.batch_retrieve_inventory_countsc Cr) aDoes a GET request to /v2/inventory/physical-count/{physical_count_id}. Deprecated version of [RetrieveInventoryPhysicalCount]($e/Inventory/RetrieveInventoryPhysical Count) after the endpoint URL is updated to conform to the standard convention. Args: physical_count_id (string): ID of the [InventoryPhysicalCount]($m/InventoryPhysicalCount) to retrieve. Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. z0/v2/inventory/physical-count/{physical_count_id}physical_count_idTrrrrrNrr r rFr+r,r-r.r/r0r1r2r3rrr,deprecated_retrieve_inventory_physical_counts$       z9InventoryApi.deprecated_retrieve_inventory_physical_countc Cr) a1Does a GET request to /v2/inventory/physical-counts/{physical_count_id}. Returns the [InventoryPhysicalCount]($m/InventoryPhysicalCount) object with the provided `physical_count_id`. Args: physical_count_id (string): ID of the [InventoryPhysicalCount]($m/InventoryPhysicalCount) to retrieve. Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. z1/v2/inventory/physical-counts/{physical_count_id}rFTrrrrrNrrrGrrr!retrieve_inventory_physical_counts$       z.InventoryApi.retrieve_inventory_physical_countc Cr) aDoes a GET request to /v2/inventory/transfers/{transfer_id}. Returns the [InventoryTransfer]($m/InventoryTransfer) object with the provided `transfer_id`. Args: transfer_id (string): ID of the [InventoryTransfer]($m/InventoryTransfer) to retrieve. Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. z%/v2/inventory/transfers/{transfer_id} transfer_idTrrrrrNrr) r rJr+r,r-r.r/r0r1r2r3rrrretrieve_inventory_transfer!r6z(InventoryApi.retrieve_inventory_transfercCd}t|d|ddi}|j}||7}||d}t||}t|}ddi}|jjj||d} t |j| | | } t | j } t | turQ| d } nd } t| | | d } | S) aDoes a GET request to /v2/inventory/{catalog_object_id}. Retrieves the current calculated stock count for a given [CatalogObject]($m/CatalogObject) at a given set of [Location]($m/Location)s. Responses are paginated and unsorted. For more sophisticated queries, use a batch endpoint. Args: catalog_object_id (string): ID of the [CatalogObject]($m/CatalogObject) to retrieve. location_ids (string, optional): The [Location]($m/Location) IDs to look up as a comma-separated list. An empty list queries all locations. cursor (string, optional): 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-a pis/pagination) guide for more information. Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. z!/v2/inventory/{catalog_object_id}catalog_object_idTr location_idscursorrrrrNrrrr r append_url_with_query_parametersr!r"r#rr$r%r&r'r(r)rr rMrOrPr+r,_query_parametersr-r.r/r0r1r2r3rrrretrieve_inventory_countSs2$       z%InventoryApi.retrieve_inventory_countcCrL) aDoes a GET request to /v2/inventory/{catalog_object_id}/changes. Returns a set of physical counts and inventory adjustments for the provided [CatalogObject]($m/CatalogObject) at the requested [Location]($m/Location)s. You can achieve the same result by calling [BatchRetrieveInventoryChanges]($e/Inventory/BatchRetrieveInventoryChan ges) and having the `catalog_object_ids` list contain a single element of the `CatalogObject` ID. 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. Args: catalog_object_id (string): ID of the [CatalogObject]($m/CatalogObject) to retrieve. location_ids (string, optional): The [Location]($m/Location) IDs to look up as a comma-separated list. An empty list queries all locations. cursor (string, optional): 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-a pis/pagination) guide for more information. Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. z)/v2/inventory/{catalog_object_id}/changesrMTrrNrrrrNrrQrSrrrretrieve_inventory_changess20       z'InventoryApi.retrieve_inventory_changesr)NN)__name__ __module__ __qualname____doc__r rr4r5r?rArBrCrDrErHrIrKrUrV __classcell__rrrrr s4 42 3 3 336; 534 FrN) deprecationrsquare.api_helperrsquare.http.api_responsersquare.api.base_apirsquare.http.auth.o_auth_2rrrrrrs