# Delete Partner Sale

### Description

This service allows an authenticated partner to delete a specific sale record.

> Important Identification Note: The sale must be identified by the Thalamus Sale ID, not by your internal partner transaction/sale ID.

***

### Request

#### Restrictions

* Authentication: Requires a successful partner login.
* Authorization: The sale record must belong to the logged-in partner.

#### Endpoint

```
DELETE https://<server-url>/api/v4/partner/sale/{sale_id}
```

#### Path Parameters

| **Parameter** | **Type** | **Description**                                   |
| ------------- | -------- | ------------------------------------------------- |
| `sale_id`     | Integer  | The unique Thalamus ID of the sale to be deleted. |

#### Parameters

| **Parameter** | **Location**   | **Description**                                                                        |
| ------------- | -------------- | -------------------------------------------------------------------------------------- |
| `touchpoint`  | Query / Header | The identifier for the touchpoint. Use `Thalamus-Touchpoint` for the header.           |
| `token`       | Query / Header | The authentication token for the partner session. Use `Thalamus-Token` for the header. |

#### Full URL Example

```
https://<server-url>/api/v4/partner/sale/17895?touchpoint=test&token=...
```

***

### Response

#### ✅ Successful Response: `200 OK`

The sale record has been successfully removed.

JSON

```
{
	"message": "OK"
}
```

***

### ❌ Unsuccessful Response

#### `400 Bad Request`

The following errors may be returned in the `errors` object:

| **Error Code**              | **Field** | **Description**                                                                                                             |
| --------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------- |
| `InvalidRoleForLoggedParty` | `partner` | The authenticated user does not have the "Partner" role.                                                                    |
| `notFound`                  | `saleId`  | The specified `sale_id` does not exist in the system.                                                                       |
| `cannotDelete`              | `saleId`  | The sale cannot be deleted (e.g., it may be locked, already processed for billing, or outside the allowed deletion window). |