### Get Seller Account Balance Info (API Request Example)

Source: https://my.digiseller.com/inside/api_account

Example of how to make a GET request to the Digiseller API to retrieve seller account balance information. This requires an access token for authentication. The response is in JSON format.

```http
GET https://api.digiseller.com/api/sellers/account/balance/info?token={token} 
Accept: text/json
```

--------------------------------

### Example API Request (XML)

Source: https://my.digiseller.com/inside/api_general

This snippet illustrates how to make a GET request to the Digiseller API for payment verification, specifying XML as the desired response format. It highlights the URL and necessary headers.

```HTTP
GET https://api.digiseller.com/api/purchases/unique-code/{unique-code}?token={token} Accept: text/xml
```

--------------------------------

### Example API Request (JSON)

Source: https://my.digiseller.com/inside/api_general

This snippet demonstrates how to construct a GET request to the Digiseller API to retrieve payment details using a unique code and an access token. It shows the URL structure and expected parameters.

```HTTP
GET https://api.digiseller.com/api/purchases/unique-code/{unique-code}?token={token} Accept: application/json
```

--------------------------------

### XML API Response Example

Source: https://my.digiseller.com/inside/api_goods

Example of an XML API response format for a successful operation, indicating a return value of 0 and providing a product ID.

```xml
<response>
  <retval>0</retval>
  <retdesc></retdesc>
  <errors/>
  <content>
    <product_id>2338757</product_id>
  </content>
</response>
```

--------------------------------

### JSON API Response Example

Source: https://my.digiseller.com/inside/api_goods

Example of a JSON API response format for a successful operation, indicating a return value of 0 and providing a product ID.

```json
{
  "retval": 0,
  "retdesc": "",
  "errors": null,
  "content": {
    "product_id": 2338757
  }
}
```

--------------------------------

### Add Product to Marketplace Subcategory (Example)

Source: https://my.digiseller.com/inside/api_goods

Adds a specific product to a marketplace subcategory. This method is exclusive to the Plati.Market platform. It requires the product ID, category ID, and a valid access token.

```bash
curl -X GET "https://api.digiseller.com/api/product/platform/category/add/{product_id}/{category_id}?token={token}"
```

--------------------------------

### Digiseller API Response Examples (JSON and XML)

Source: https://my.digiseller.com/inside/api_goods

Illustrates the expected JSON and XML response formats for API requests. These examples show the structure of success and error responses, including fields like retval, retdesc, errors, and content.

```json
{
  "retval": 0,
  "retdesc": "",
  "errors": null,
  "content": {
    "product_id": 2338757
  }
}
```

```xml
<response>
  <retval>0</retval>
  <retdesc></retdesc>
  <errors/>
  <content>
    <product_id>2338757</product_id>
  </content>
</response>
```

--------------------------------

### POST /api/product/clone/{product_id}

Source: https://my.digiseller.com/inside/api_catgoods

Creates a copy of a product description (cloning without contents). You can specify various options to control what gets copied.

```APIDOC
## POST /api/product/clone/{product_id}

### Description
Creates a copy of a product description (cloning without contents). You can specify various options to control what gets copied.

### Method
POST

### Endpoint
https://api.digiseller.com/api/product/clone/{product_id}

### Parameters
#### Path Parameters
- **product_id** (integer) - Required - The ID of the product to clone.

#### Query Parameters
- **token** (string) - Required - Access token. Minimum permission required: [ Products ]: _Create_.

#### Request Body
- **count** (integer) - Optional - Number of copies to create (maximum 5). Defaults to 1.
- **categories** (boolean) - Optional - Create copies in the same categories as the original product. Defaults to false.
- **notify** (boolean) - Optional - Copy the notification settings. Defaults to false.
- **discounts** (boolean) - Optional - Copy the discount settings. Defaults to false.
- **options** (boolean) - Optional - Copy settings for advanced parameters. Defaults to false.
- **comissions** (boolean) - Optional - Copy compensation settings. Defaults to false.
- **gallery** (boolean) - Optional - Copy images and videos from the gallery. Defaults to false.

### Request Example
```json
{
  "count": 1,
  "categories": true,
  "notify": true,
  "discounts": true,
  "options": true,
  "comissions": true,
  "gallery": true
}
```

### Response
#### Success Response (200)
- **retval** (integer) - Result code: 0 for success, 1 for error. Detailed information in the 'errors' field.
- **retdesc** (string) - Description of the result code.
- **errors** (array) - Null if no errors. Contains an array of error objects if the request is invalid.
  - **errors.code** (string) - Error code.
  - **errors.message** (string) - Description of the error code.
- **content** (object) - Response body.
  - **content.products** (array) - Array of created item IDs.

#### Response Example
```json
{
  "retval": 0,
  "retdesc": "",
  "errors": null,
  "content": {
    "products": [
      23387571,
      23387572,
      23387573
    ]
  }
}
```
```

--------------------------------

### Create Software Product (JSON Request)

Source: https://my.digiseller.com/inside/api_goods

This snippet demonstrates how to construct a JSON request to create a software product. It includes essential fields like name, price, currency, categories, and description, with localization support. The `content_type` is set to 'text'.

```json
{
  "content_type": "text",
  "name": [
    {
      "locale": "ru-RU",
      "value": "Тестовый продукт №1"
    },
    {
      "locale": "en-US",
      "value": "Test product №1"
    }
  ],
  "price": {
    "price": 725,
    "currency": "RUB"
  },
  "comission_partner": 15,
  "categories": [
    {
      "owner": 0,
      "category_id": 7074
    },
    {
      "owner": 1,
      "category_id": 18162
    }
  ],
  "bonus": {
    "enabled": false,
    "percent": 5
  },
  "guarantee": {
    "enabled": true,
    "value": 5
  },
  "description": [
    {
      "locale": "ru-RU",
      "value": "Тестовое описание"
    },
    {
      "locale": "en-US",
      "value": "Test description"
    }
  ],
  "add_info": [
    {
      "locale": "ru-RU",
      "value": "Тестовая дополнительная информация"
    },
    {
      "locale": "en-US",
      "value": "Test additional information"
    }
  ],
  "address_required": false,
  "trial_url": "http://localhost",
  "instruction": {
    "type": "text",
    "locales": [
      {
        "locale": "ru-RU",
        "value": "Русская инструкция"
      },
      {
        "locale": "en-US",
        "value": "English instruction"
      }
    ]
  },
  "present_product_id": 123321,
  "online_checkout_name": "Тестовый продукт №1",
  "online_checkout_category": "Goods",
  "online_checkout_tax": "no_vat"
}
```

--------------------------------

### Product Creation and VAT Information

Source: https://my.digiseller.com/inside/api_goods

This section details the parameters for creating a product, including the type of good and VAT rate, and provides an example of the JSON response.

```APIDOC
## POST /api/products

### Description
This endpoint is used to create a new product within the My Digiseller system. It accepts various product types and allows specification of the VAT rate.

### Method
POST

### Endpoint
/api/products

### Parameters
#### Query Parameters
- **type** (String) - Required - Specifies the type of the product. Available values: Goods, ExciseGoods, Work, Service, GamblingBet, GamblingPrize, LotteryTicket, LotteryPrize, IntellectualPropertyGrant, Payment, AgencyFee, CompositeSubject, OtherSubject, PropertyRight, NonOperatingIncome, InsurancePremiums, TradeFee, ResortFee, Pledge.
- **online_checkout_tax** (String) - Optional - Specifies the VAT rate for generating an electronic receipt. Available values: vat20, vat10, vat110, vat120, vat0, no_vat.

### Request Example
```json
{
  "type": "Goods",
  "online_checkout_tax": "vat20"
}
```

### Response
#### Success Response (200)
- **retval** (Integer) - Result code: 0 for success, 1 for error.
- **retdesc** (String) - Description of the result code.
- **errors** (Array) - Null if no errors, otherwise an array of error objects.
  - **code** (String) - Error code.
  - **message** (String) - Description of the error.
- **content** (Object) - Response body.
  - **product_id** (Integer) - The ID of the created product.

#### Response Example
```json
{
  "retval": 0,
  "retdesc": "",
  "errors": null,
  "content": {
    "product_id": 2338757
  }
}
```
```

--------------------------------

### POST /api/product/content/add/files/{product_id}

Source: https://my.digiseller.com/inside/api_content

Adds multiple files from a ZIP archive to a product. The ZIP archive should not contain internal folders.

```APIDOC
## POST /api/product/content/add/files/{product_id}

### Description
Adds multiple files from a ZIP archive to a product. The ZIP archive should not contain internal folders. Files in the ZIP-archive should not be in internal folders. Such files will be ignored.

### Method
POST

### Endpoint
`https://api.digiseller.com/api/product/content/add/files/{product_id}/{count?}?token={token}`

### Parameters
#### Path Parameters
- **product_id** (Integer) - Required - Item id
- **count** (Integer) - Optional - The number of files in the ZIP archive. If specified, it verifies the uncompressed file count against this value.

#### Query Parameters
- **token** (String) - Required - Access token with [ Content ]: _Adding_ permission.

#### Request Body
- **file** (File) - Required - The ZIP archive containing the files to be uploaded.

### Request Example
```json
{
  "example": "zip file upload"
}
```

### Response
#### Success Response (200)
- **retval** (Integer) - Result code (0 - success, 1 - error).
- **retdesc** (String) - Description of the result code.
- **errors** (Array) - An array of errors if the request is invalid. Null if no errors.
  - **errors.code** (String) - Error code.
  - **errors.message** (String) - Error description.
- **content** (Array) - Response body. Null if the request is invalid.
  - **content.content_id** (Integer) - New content id.
  - **content.filename** (String) - File name.

#### Response Example
```json
{
  "retval": 0,
  "retdesc": "",
  "errors": null,
  "content": [
    {
      "content_id": 6403229,
      "filename": "New Text Document.txt"
    },
    {
      "content_id": 6403230,
      "filename": "New Text Document 2.txt"
    }
  ]
}
```
```

--------------------------------

### GET /api/token/perms

Source: https://my.digiseller.com/inside/api_general

Retrieve the list of permissions associated with a given access token. This endpoint requires a GET request with the token as a path parameter.

```APIDOC
## GET /api/token/perms

### Description
Retrieve the list of permissions associated with a given access token. This endpoint requires a GET request with the token as a path parameter.

### Method
GET

### Endpoint
https://api.digiseller.com/api/token/perms?token={token}

### Parameters
#### Query Parameters
- **token** (string) - Required - The access token obtained from the /api/apilogin endpoint. Requires minimum permission: [ API tokens ]: _Permission list_.

### Response
#### Success Response (200)
- **Array of strings** - A list of permissions granted to the token. An empty array indicates no access (HTTP status 401 or 403).

#### Response Example
```json
[
  "token_get_perms",
  "description_view",
  "sales_statistics_view"
]
```
```

--------------------------------

### POST /api/product/create/software

Source: https://my.digiseller.com/inside/api_goods

Creates a new product of type 'Software' in the Digiseller platform. This endpoint allows for detailed configuration of the product, including pricing, localization, categories, and various optional settings like bonuses and guarantees.

```APIDOC
## POST /api/product/create/software

### Description
Creates a new product of type 'Software' in the Digiseller platform. This endpoint allows for detailed configuration of the product, including pricing, localization, categories, and various optional settings like bonuses and guarantees.

### Method
POST

### Endpoint
https://api.digiseller.com/api/product/create/software?token={token}

### Parameters
#### Path Parameters
- **token** (string) - Required - Access token with at least '[ Products ]: _Create_' permission.

#### Query Parameters
None

#### Request Body
- **content_type** (string) - Required - Item content type. Available values: 'text', 'url', 'file'.
- **name** (array) - Required - Item name with localization.
  - **locale** (string) - Required - Localization. Available values: 'ru-RU', 'en-US'.
  - **value** (string) - Required - Localization value.
- **price** (object) - Required - Product price.
  - **price** (number) - Required - The product cost for one unit. A fractional number with a dot as a separator.
  - **currency** (string) - Required - Product price currency. Available values: RUB, USD, EUR, UAH.
- **comission_partner** (integer) - Optional - Commission fee for partners. Minimum of 1% or 0 for excluded products. Defaults to 0.
- **categories** (array) - Required - Item categories.
  - **owner** (integer) - Required - Category owner. 0 - own store, 1 - Plati.Market, 2 - WMCENTRE, 3 - GGSell.
  - **category_id** (integer) - Required - Identifier of the category of own store or marketplace.
- **bonus** (object) - Optional - For a favorable review of the purchase.
  - **enabled** (boolean) - Optional - Bonus enabled.
  - **percent** (float) - Optional - Percentage of the product price that will be issued to the buyer as a gift certificate.
- **guarantee** (object) - Optional - Refund.
  - **enabled** (boolean) - Optional - Guarantee enabled.
  - **value** (integer) - Optional - Guarantee in hours (for unique codes) or days (for other products).
- **description** (array) - Required - Item description with localization.
  - **locale** (string) - Required - Localization. Available values: 'ru-RU', 'en-US'.
  - **value** (string) - Required - Localization value.
- **add_info** (array) - Optional - Additional information with localization.
  - **locale** (string) - Required - Localization. Available values: 'ru-RU', 'en-US'.
  - **value** (string) - Required - Localization value.
- **address_required** (boolean) - Optional - Buyer must enter delivery address before paying.
- **trial_url** (string) - Optional - URL of trial version.
- **instruction** (object) - Optional - Usage instruction given to the buyer on the order description page.
  - **type** (string) - Required - Instruction type. Available values: 'url', 'text'.
  - **locales** (array) - Required - Usage instruction with localizations.
    - **locale** (string) - Required - Localization. Available values: 'ru-RU', 'en-US'.
    - **value** (string) - Required - Localization value.
- **present_product_id** (integer) - Optional - Item ID provided as a gift to the buyer. Defaults to 0.
- **online_checkout_name** (string) - Optional - Product name for online checkout.
- **online_checkout_category** (string) - Optional - Settlement item flag for online cash register. Available values: Goods, ExciseGoods, Work, Service, GamblingBet, GamblingPrize, LotteryTicket, LotteryPrize, IntellectualPropertyGrant, Payment, AgencyFee, CompositeSubject, OtherSubject, PropertyRight, NonOperatingIncome, InsurancePremiums, TradeFee, ResortFee, Pledge.
- **online_checkout_tax** (string) - Optional - VAT rate for generating an electronic receipt.

### Request Example
```json
{
  "content_type": "text",
  "name": [
    { "locale": "ru-RU", "value": "Тестовый продукт №1" },
    { "locale": "en-US", "value": "Test product №1" }
  ],
  "price": {
    "price": 725,
    "currency": "RUB"
  },
  "comission_partner": 15,
  "categories": [
    { "owner": 0, "category_id": 7074 },
    { "owner": 1, "category_id": 18162 }
  ],
  "bonus": {
    "enabled": false,
    "percent": 5
  },
  "guarantee": {
    "enabled": true,
    "value": 5
  },
  "description": [
    { "locale": "ru-RU", "value": "Тестовое описание" },
    { "locale": "en-US", "value": "Test description" }
  ],
  "add_info": [
    { "locale": "ru-RU", "value": "Тестовая дополнительная информация" },
    { "locale": "en-US", "value": "Test additional information" }
  ],
  "address_required": false,
  "trial_url": "http://localhost",
  "instruction": {
    "type": "text",
    "locales": [
      { "locale": "ru-RU", "value": "Русская инструкция" },
      { "locale": "en-US", "value": "English instruction" }
    ]
  },
  "present_product_id": 123321,
  "online_checkout_name": "Тестовый продукт №1",
  "online_checkout_category": "Goods",
  "online_checkout_tax": "no_vat"
}
```

### Response
#### Success Response (200)
- **product_id** (integer) - The unique identifier of the created product.
- **status** (string) - The status of the product creation request.

#### Response Example
```json
{
  "product_id": 12345,
  "status": "success"
}
```

#### Error Response
- **error_code** (integer) - The error code.
- **error_message** (string) - A message describing the error.

#### Error Response Example
```json
{
  "error_code": 400,
  "error_message": "Invalid token provided."
}
```
```

--------------------------------

### Create Arbitrary Digital Product (JSON)

Source: https://my.digiseller.com/inside/api_goods

This snippet demonstrates how to create an 'Arbitrary digital product' using a POST request with a JSON payload. It includes essential fields like product name, price, currency, content type, and optional fields for categories, bonuses, and guarantees.

```json
{
  "content_type": "text",
  "name": [
    { "locale": "ru-RU", "value": "Тестовый продукт №1" },
    { "locale": "en-US", "value": "Test product №1" }
  ],
  "price": {
    "price": 725,
    "currency": "RUB"
  },
  "affiliate_program": 0,
  "comission_partner": 15,
  "categories": [
    { "owner": 0, "category_id": 7074 },
    { "owner": 1, "category_id": 18162 }
  ],
  "bonus": {
    "enabled": false,
    "percent": 5
  },
  "guarantee": {
    "enabled": true,
    "value": 5
  },
  "description": [
    { "locale": "ru-RU", "value": "Тестовое описание" },
    { "locale": "en-US", "value": "Test description" }
  ],
  "add_info": [
    { "locale": "ru-RU", "value": "Тестовая дополнительная информация" },
    { "locale": "en-US", "value": "Test additional information" }
  ],
  "address_required": false,
  "pay_as_you_want": true,
  "instruction": {
    "type": "text",
    "locales": [
      { "locale": "ru-RU", "value": "Русская инструкция" },
      { "locale": "en-US", "value": "English instruction" }
    ]
  },
  "present_product_id": 123321,
  "online_checkout_name": "Тестовый продукт №1",
  "online_checkout_category": "Goods",
  "online_checkout_tax": "no_vat"
}
```

--------------------------------

### Product Creation and Configuration

Source: https://my.digiseller.com/inside/api_goods

This endpoint facilitates the creation of a new product within the Digiseller system. It supports the configuration of various fees, including trade fees and resort fees, and allows for the specification of VAT rates for electronic receipts. The response includes a product ID upon successful creation or error details if the request fails.

```APIDOC
## POST /websites/my_digiseller_inside

### Description
Creates a new product with specified fees and VAT settings.

### Method
POST

### Endpoint
/websites/my_digiseller_inside

### Parameters
#### Query Parameters
- **TradeFee** (number) - Optional - The trade fee amount.
- **ResortFee** (number) - Optional - The resort fee amount.
- **Pledge** (string) - Optional - A string representing the pledge value.
- **online_checkout_tax** (string) - Optional - The VAT rate to be applied. Accepted values: "vat20", "vat10", "vat110", "vat120", "vat0", "no_vat".

### Request Example
```json
{
  "TradeFee": 10.50,
  "ResortFee": 5.00,
  "Pledge": "some_pledge_string",
  "online_checkout_tax": "vat20"
}
```

### Response
#### Success Response (200)
- **retval** (integer) - Result code (0 for success).
- **retdesc** (string) - Description of the result code.
- **errors** (array|null) - Null if no errors, otherwise an array of error objects.
- **content** (object) - The response body.
  - **product_id** (integer) - The ID of the created product.

#### Response Example
```json
{
  "retval": 0,
  "retdesc": "",
  "errors": null,
  "content": {
    "product_id": 2338757
  }
}
```

#### Error Response Example
```json
{
  "retval": 1,
  "retdesc": "Error occurred",
  "errors": [
    {
      "code": "INVALID_PARAMETER",
      "message": "The provided online_checkout_tax value is not valid."
    }
  ],
  "content": null
}
```
```

--------------------------------

### XML Response Example

Source: https://my.digiseller.com/inside/api_general

An example of an XML response from the Digiseller API for a payment query. This format is useful for systems that primarily process XML data, providing the same transaction details as the JSON response.

```XML
<response>
  <retval>0</retval>
  <retdesc></retdesc>
  <inv>123456789</inv>
  <id_goods>98765</id_goods>
  <amount>10.50</amount>
  <type_curr>WMZ</type_curr>
  <profit></profit>
  <amount_usd>10.50</amount_usd>
  <date_pay>2023-10-27 10:00:00</date_pay>
  <email>customer@example.com</email>
  <agent_id>0</agent_id>
  <agent_percent>0</agent_percent>
  <unit_goods>1</unit_goods>
  <cnt_goods>1</cnt_goods>
  <promo_code></promo_code>
  <bonus_code></bonus_code>
  <cart_uid></cart_uid>
  <unique_code_state>
    <state>3</state>
    <date_check>2023-10-27 10:05:00</date_check>
    <date_delivery>2023-10-27 10:10:00</date_delivery>
    <date_confirmed>2023-10-27 10:15:00</date_confirmed>
    <date_refuted></date_refuted>
  </unique_code_state>
  <options>
    <option id="1">
      <name>Color</name>
      <value>Blue</value>
      <variant_id>5</variant_id>
    </option>
  </options>
</response>
```

--------------------------------

### Product Type and Parameters

Source: https://my.digiseller.com/inside/api_catgoods

Define the product type (text or file) and its associated parameters.

```APIDOC
## GET /websites/my_digiseller_inside/product/type

### Description
Specifies the type of the product and its associated parameters.

### Method
GET

### Endpoint
/websites/my_digiseller_inside/product/type

### Response
#### Success Response (200)
- **type** (string) - The type of the item ('product' as text or 'file' as file).

#### Response Example
```json
{
  "type": "text"
}
```

## GET /websites/my_digiseller_inside/product/text

### Description
Provides parameters for products of type 'text'.

### Method
GET

### Endpoint
/websites/my_digiseller_inside/product/text

### Response
#### Success Response (200)
- **date** (string) - The date of publishing in 'DD.MM.YYYY h:mm:ss' format.
- **size** (integer) - The number of symbols.

#### Response Example
```json
{
  "date": "25.10.2023 10:30:00",
  "size": 1500
}
```

## GET /websites/my_digiseller_inside/product/file

### Description
Provides parameters for products of type 'file'.

### Method
GET

### Endpoint
/websites/my_digiseller_inside/product/file

### Response
#### Success Response (200)
- **date** (string) - The date of publishing in 'DD.MM.YYYY h:mm:ss' format.
- **size** (integer) - The file size in bytes.
- **name** (string) - The file name.
- **trial** (string) - The URL of the trial version of the product.

#### Response Example
```json
{
  "date": "25.10.2023 10:30:00",
  "size": 1024000,
  "name": "document.pdf",
  "trial": "https://example.com/trial.pdf"
}
```
```

--------------------------------

### JSON Response Example

Source: https://my.digiseller.com/inside/api_general

An example of a successful JSON response from the Digiseller API when querying payment details by a unique code. It includes fields for transaction status, product information, and customer details.

```JSON
{
  "retval": 0,
  "retdesc": "",
  "inv": 123456789,
  "id_goods": 98765,
  "amount": 10.50,
  "type_curr": "WMZ",
  "profit": "",
  "amount_usd": 10.50,
  "date_pay": "2023-10-27 10:00:00",
  "email": "customer@example.com",
  "agent_id": 0,
  "agent_percent": 0,
  "unit_goods": 1,
  "cnt_goods": 1,
  "promo_code": "",
  "bonus_code": "",
  "cart_uid": "",
  "unique_code_state": {
    "state": 3,
    "date_check": "2023-10-27 10:05:00",
    "date_delivery": "2023-10-27 10:10:00",
    "date_confirmed": "2023-10-27 10:15:00",
    "date_refuted": ""
  },
  "options": [
    {
      "id": 1,
      "name": "Color",
      "value": "Blue",
      "variant_id": 5
    }
  ]
}
```

--------------------------------

### GET /api/purchase/info/{invoice_id}

Source: https://my.digiseller.com/inside/api_general

Retrieves detailed sales information for a specific order using its invoice ID. This endpoint allows you to get comprehensive data about a purchase, including item details, payment status, and buyer information.

```APIDOC
## GET /api/purchase/info/{invoice_id}

### Description
Retrieves detailed sales information for a specific order using its invoice ID. This endpoint allows you to get comprehensive data about a purchase, including item details, payment status, and buyer information.

### Method
GET

### Endpoint
https://api.digiseller.com/api/purchase/info/{invoice_id}

### Parameters
#### Path Parameters
- **invoice_id** (integer) - Required - Digiseller order number

#### Query Parameters
- **token** (string) - Required - Access token with minimum permission: [ Operations ]: _Invoice details_. See method for creating access token.

#### Request Body
This endpoint does not accept a request body.

### Request Example
```
GET https://api.digiseller.com/api/purchase/info/123456789?token=YOUR_ACCESS_TOKEN
```

### Response
#### Success Response (200)
- **retval** (integer) - Result code (0 for success, 1 for error).
- **retdesc** (string) - Description of the result code.
- **errors** (array) - Array of errors (null if no errors).
- **content** (object) - Contains the detailed sales information.
  - **item_id** (integer) - Paid product identifier.
  - **cart_uid** (string) - Cart UID (if purchased via shopping cart).
  - **name** (string) - The invoice name.
  - **amount** (number) - Amount credited to your account.
  - **currency_type** (string) - Currency of payment (e.g., WMT, WMZ, WME, WMU).
  - **invoice_state** (integer) - State of the invoice (1: payment expected, 2: cancellation, 3: successful payment, 4: overdue, 35: refund not completed, 5: refund).
  - **purchase_date** (string) - Date and time of the order.
  - **date_pay** (string) - Payment confirmation date (optional).
  - **agent_id** (integer) - Partner ID (if sale was through a partner).
  - **agent_percent** (number) - Partner commission.
  - **query_string** (string) - Base64-encoded string of additional parameters passed from your site.
  - **unit_goods** (number) - Unit of purchased product (for non-fixed price products).
  - **cnt_goods** (number) - Number of units of purchased product (for non-fixed price products).
  - **promo_code** (string) - Promo code used by customer.
  - **bonus_code** (string) - Promo code given to buyer as a bonus.
  - **feedback** (object) - Feedback left by buyer.
    - **deleted** (boolean) - Flag indicating if feedback is deleted.
    - **feedback** (string) - Text content of feedback.
    - **feedback_type** (string) - Type of feedback ("positive" or "negative").
    - **comment** (string) - Seller comment.
  - **unique_code_state** (object) - Unique code status and verification dates.
    - **state** (integer) - Transaction status (1: not verified, 2: delivered/not confirmed/refuted, 3: delivered/confirmed, 4: delivered/refuted, 5: verified/not delivered).
    - **date_check** (string) - Verification date (optional).
    - **date_delivery** (string) - Delivery date (optional).
  - **options** (array) - Array of options associated with the purchase.
  - **buyer_info** (object) - Information about the buyer.
    - **payment_method** (string) - Payment method used.
    - **payment_aggregator** (string) - Payment aggregator.
    - **account** (string) - Buyer's account (optional).
    - **email** (string) - Buyer's email.
    - **phone** (string) - Buyer's phone number (optional).
    - **skype** (string) - Buyer's Skype ID (optional).
    - **whatsapp** (string) - Buyer's WhatsApp ID (optional).
    - **info** (string) - Additional buyer information (optional).
    - **ip_address** (string) - Buyer's IP address (optional).
  - **owner** (integer) - Owner identifier.
  - **day_lock** (integer) - Day lock value.
  - **lock_state** (string) - Lock state.
  - **profit** (number) - Profit amount (optional).
  - **agent_fee** (number) - Agent fee (optional).
  - **content_id** (integer) - Content ID.
  - **external_order_id** (string) - External order ID (optional).

#### Response Example (JSON)
```json
{
  "retval": 0,
  "retdesc": null,
  "errors": null,
  "content": {
    "item_id": 0,
    "cart_uid": null,
    "name": "",
    "amount": 0,
    "currency_type": "",
    "invoice_state": 0,
    "purchase_date": "",
    "date_pay": null,
    "agent_id": null,
    "agent_percent": null,
    "query_string": null,
    "unit_goods": null,
    "cnt_goods": null,
    "promo_code": null,
    "bonus_code": null,
    "feedback": {
      "deleted": false,
      "feedback": "",
      "feedback_type": "",
      "comment": ""
    },
    "unique_code_state": {
      "state": 0,
      "date_check": null,
      "date_delivery": null,
      "date_refuted": null,
      "date_confirmed": null
    },
    "options": [
      {"id":"","name":"","user_data":"", "user_data_id": 123123},
      {"id":"","name":"","user_data":"", "user_data_id": null}
    ],
    "buyer_info": {
      "payment_method": "",
      "payment_aggregator": "",
      "account": null,
      "email": "",
      "phone": null,
      "skype": null,
      "whatsapp": null,
      "info": null,
      "ip_address": null
    },
    "owner": 0,
    "day_lock": 0,
    "lock_state": "",
    "profit": null,
    "agent_fee": null,
    "content_id": 0,
    "external_order_id": null
  }
}
```

#### Response Example (XML)
```xml
<root>
  <retval>0</retval>
  <retdesc></retdesc>
  <errors></errors>
  <content>
    <item_id>0</item_id>
    <cart_uid></cart_uid>
    <name></name>
    <amount>0</amount>
    <currency_type></currency_type>
    <invoice_state>0</invoice_state>
    <purchase_date></purchase_date>
    <date_pay></date_pay>
    <agent_id></agent_id>
    <agent_percent></agent_percent>
    <query_string></query_string>
    <unit_goods></unit_goods>
    <cnt_goods></cnt_goods>
    <promo_code></promo_code>
    <bonus_code></bonus_code>
    <feedback>
      <deleted>false</deleted>
      <feedback></feedback>
      <feedback_type></feedback_type>
      <comment></comment>
    </feedback>
    <unique_code_state>
      <state>0</state>
      <date_check></date_check>
      <date_delivery></date_delivery>
      <date_refuted></date_refuted>
      <date_confirmed></date_confirmed>
    </unique_code_state>
    <options>
      <option>
        <id></id>
        <name></name>
        <user_data></user_data>
        <user_data_id>123123</user_data_id>
      </option>
      <option>
        <id></id>
        <name></name>
        <user_data></user_data>
        <user_data_id></user_data_id>
      </option>
    </options>
    <buyer_info>
      <payment_method></payment_method>
      <payment_aggregator></payment_aggregator>
      <account></account>
      <email></email>
      <phone></phone>
      <skype></skype>
      <whatsapp></whatsapp>
      <info></info>
      <ip_address></ip_address>
    </buyer_info>
    <owner>0</owner>
    <day_lock>0</day_lock>
    <lock_state></lock_state>
    <profit></profit>
    <agent_fee></agent_fee>
    <content_id>0</content_id>
    <external_order_id></external_order_id>
  </content>
</root>
```
```

--------------------------------

### Edit Software Product - XML Request Example

Source: https://my.digiseller.com/inside/api_goods

This snippet demonstrates the XML format for editing a software product. It includes common fields like product name, price, commission, categories, and descriptions, all localized for different regions.

```xml
<product>
  <enabled>true</enabled>
  <name>
    <locale>ru-RU</locale>
    <value>Тестовый продукт №1</value>
  </name>
  <name>
    <locale>en-US</locale>
    <value>Test product №1</value>
  </name>
  <price>
    <price>725</price>
    <currency>RUB</currency>
  </price>
  <comission_partner>15</comission_partner>
  <categories>
    <owner>0</owner>
    <category_id>7074</category_id>
  </categories>
  <categories>
    <owner>1</owner>
    <category_id>18162</category_id>
  </categories>
  <bonus>
    <enabled>false</enabled>
    <percent>5</percent>
  </bonus>
  <guarantee>
    <enabled>true</enabled>
    <value>5</value>
  </guarantee>
  <description>
    <locale>ru-RU</locale>
    <value>Тестовое описание</value>
  </description>
  <description>
    <locale>en-US</locale>
    <value>Test description</value>
  </description>
  <add_info>
    <locale>ru-RU</locale>
    <value>Тестовая дополнительная информация</value>
  </add_info>
  <add_info>
    <locale>en-US</locale>
    <value>Test additional information</value>
  </add_info>
  <address_required>false</address_required>
  <trial_url>http://localhost</trial_url>
  <instruction>
    <type>text</type>
    <locales>
      <locale>ru-RU</locale>
      <value>Русская инструкция</value>
    </locales>
    <locales>
      <locale>en-US</locale>
      <value>English instruction</value>
    </locales>
  </instruction>
  <present_product_id>123321</present_product_id>
  <online_checkout_name>Тестовый продукт №1</online_checkout_name>
  <online_checkout_category>Goods</online_checkout_category>
  <online_checkout_tax>no_vat</online_checkout_tax>
</product>
```