# Dispute Manager API The **Dispute Manager API** enables partners to track and manage disputed orders for common clients across multiple platforms. This API provides: - **Disputed Order Data**: Retrieves details of disputed orders, including their current status (approved, denied, or expired) and the total number of orders eligible for dispute. - **Dispute Resolution Methods**: 1. **AI Auto Disputes** – Automate the dispute process by enabling AI-powered dispute submission for all locations. 2. **Manual Disputes** – Manually select and submit disputes for specific orders as needed. This API streamlines dispute management, ensuring accurate tracking and efficient resolution of charge discrepancies. ## Get All Disputed Orders - [GET /disputed-manger/orders](https://api.voosh.ai/main/dispute-manager-api/getalldisputedorders.md): This endpoint retrieves disputed orders based on the provided query parameters. #### Request - Method: GET - URL: - Query Parameters: - limit (integer, optional): The maximum number of orders to retrieve. - offset (integer, optional): The offset for paginating through a large result set. - clientId (string, required): The unique identifier of the client. - { "startDate": "YYYY-MM-DD", "endDate": "YYYY-MM-DD", "listingIds": \["string"\], "channel": \["string"\]} - startDate (string): The start date for the order search. - endDate (string): The end date for the order search. - listingIds (array of strings): The IDs of the listings to filter the orders. - channel (array of strings): The channels to filter the orders. #### Response The response for this request can be represented as a JSON schema: ## Get Auto Dispute Configurations - [GET /disputed-manger/auto-dispute/configs](https://api.voosh.ai/main/dispute-manager-api/getautodisputeconfigurations.md): ### Request This endpoint makes an HTTP GET request to retrieve auto-dispute configurations for a specific client. The request should include the client_id as a query parameter in the URL. The last call to this request used the following payload with the raw request body type: ### Response The response will include a status, status code, message, and a result array containing auto-dispute configurations. Each configuration in the result array includes the following details: - id (string): The identifier for the auto-dispute configuration. - channel (string): The channel for which the configuration is applicable. - stores (string): The stores associated with the configuration. - error (string): Any error associated with the configuration. - reason (string): The reason for the dispute. - description (string): Additional description for the configuration. - isActive (integer): Indicates if the configuration is active. - refundPercentage (integer): The refund percentage associated with the configuration. - manuallyCreated (integer): Indicates if the configuration was manually created. - createdAt (string): The date and time when the configuration was created. ### Example Response ## Set Ai Auto Dispute - [POST /disputed-manger/auto-dispute/set-auto-dispute](https://api.voosh.ai/main/dispute-manager-api/setaiautodispute.md): This endpoint allows the user to set an auto dispute for a specific client and channel. #### Request Body - (string) - The channel for which the auto dispute is to be set. - (array) - An array of store IDs for which the auto dispute is to be set. Example: #### Response - (boolean) - Indicates the status of the request. - (integer) - The status code of the response. - (string) - A message related to the response. - (object) - The result of the request. - (boolean) - Indicates the status of the result. - (string) - A message related to the result. - (null) - Indicates any error in the response. Example: ## Raise Manual Dispute - [POST /disputed-manger/manual-raise](https://api.voosh.ai/main/dispute-manager-api/raisemanualdispute.md): This endpoint allows users to manually raise a dispute by providing the delivery UUID, reason for the dispute, and an optional description. - (string): The unique identifier for the delivery. - (string): The reason for raising the dispute. - (string, optional): Additional description for the dispute. - (boolean): Indicates the status of the request. - (integer): The status code of the response. - (string): A message related to the response status. - (object): An object containing the status and message. - (null): Indicates the absence of any error in the response. ## Set Manual Dispute Configurations - [POST /disputed-manger/auto-dispute/manual-config](https://api.voosh.ai/main/dispute-manager-api/setmanualdisputeconfigurations.md): This endpoint allows you to manually configure auto-dispute settings for a specific client. #### Request Body - (string) - The channel for which the dispute configuration is being set. - (string) - The reason for the dispute configuration. - (string) - The error type for which the dispute configuration is being set. - (string) - Additional description for the dispute configuration. - (string) - The specific store(s) for which the dispute configuration is being set. - (string) - The percentage of refund for the dispute configuration. #### Response - (boolean) - Indicates the status of the request. - (integer) - The status code of the response. - (string) - A message related to the status of the request. - (object) - The result of the request, including its status and message. - (null) - Any error message, if applicable. Example Response: ## Get Manual Dispute Config Parameters - [GET /disputed-manger/auto-dispute/get-config-details](https://api.voosh.ai/main/dispute-manager-api/getmanualdisputeconfigparameters.md): This endpoint retrieves the configuration details for auto-dispute functionality based on the provided client ID. #### Request - Method: GET - URL: - Query Parameters: - client_id (string, required): The unique client ID for which the configuration details are requested. #### Response The response will contain the following fields: - (number): The number of listings. - (array): An array of objects containing and . - (array): An array of channels. - (object): An object containing configuration details for different channels such as DOORDASH and UBEREATS. - (object): Configuration details for the DOORDASH channel. - (array): Array of reasons for entirely wrong orders. - (array): Array of reasons for wrong orders. - (array): Array of reasons for ingredient errors. - (array): Array of reasons for incorrect sizes. - (array): Array of reasons for incorrect quantities. - (array): Array of reasons for missing side items. - (object): Configuration details for the UBEREATS channel. - (array): Array of reasons for partially missing items. - (array): Array of reasons for items never received. - (array): Array of miscellaneous reasons. - (array): Array of reasons for missing items. - (array): Array of reasons for wrong orders. - (array): Array of reasons for missing items. - (array): Array of reasons for incomplete orders. - (array): Array of reasons for damaged food. - (string): Additional information.