# API для заказов

## Формат CommerceML 2.0 

Данный метод возвращает все заказы за сутки в формате commerceML 2.0.

```jsx
GET: "https://europe-west1-kaspi-2e75a.cloudfunctions.net/backend/api/v1/commerceml2/orders?client_id=68e2fa3d-3432-45cb-3123-4dcb5fa575bc"
// headers
X-API-KEY: "nx5kjZxJUYlLBDpdsyVi3t0dEVBcV60x5kjZxJUYlLBDpdsyVi3t0dEVBcV60x"
```

<table data-full-width="true"><thead><tr><th>Параметр</th><th>Описание</th><th>Доступные значения</th></tr></thead><tbody><tr><td>platform</td><td>С какиз маркетплейсов получать заказы. Можно указать несколько:<br><code>&#x26;platform=ozon&#x26;platform=kaspi</code></td><td>kaspi, ozon</td></tr><tr><td>limit</td><td>максимальное количество заказов в ответе. Например 5</td><td>Любое число от 1 до 100</td></tr><tr><td>state</td><td>Какие статусы заказов получать, можно указать несколько<br></td><td>NEW, ACCEPTED, BANK_APPROVED, COMPLETED, CANCELLED</td></tr><tr><td>days</td><td>количество дней за которые были получены заказы</td><td>Любое число от 1 до 5</td></tr><tr><td>format</td><td>Формат ответа</td><td>commerceml, json</td></tr></tbody></table>

<details>

<summary>Пример ответа</summary>

```xml
<?xml version="1.0" encoding="utf-8"?>
<Заказы>
	<Документ>
		<Ид>Mjk4NzUyMzU3</Ид>
		<Номер>298752357</Номер>
		<Дата>Wed Nov 08 2023 15:33:52 GMT+0000 (Coordinated Universal Time)</Дата>
		<ХозОперация>Заказ товара</ХозОперация>
		<Роль>Продавец</Роль>
		<Валюта>KZT</Валюта>
		<Курс>1.0000</Курс>
		<Сумма>79950.00</Сумма>
		<Время>Wed Nov 08 2023 15:33:52 GMT+0000 (Coordinated Universal Time)</Время>
		<Комментарий></Комментарий>
		<Контрагент>
			<Ид>Nzc1Mjk4ODk3OQ</Ид>
			<Наименование>Нурбек Ибраев</Наименование>
			<Роль>Покупатель</Роль>
			<ПолноеНаименование>Нурбек Ибраев</ПолноеНаименование>
			<Имя>Нурбек</Имя>
			<Фамилия>Курбанбаев</Фамилия>
			<AдресРегистрации>
				<АдресноеПоле>
					<Тип>Город</Тип>
					<Значение></Значение>
				</АдресноеПоле><АдресноеПоле>
					<Тип>Улица</Тип>
					<Значение></Значение>
				</АдресноеПоле>
				<АдресноеПоле>
					<Тип>Номер</Тип>
					<Значение></Значение>
				</АдресноеПоле>
				<АдресноеПоле>
					<Тип>Квартира</Тип>
					<Значение></Значение>
				</АдресноеПоле>
				<АдресноеПоле>
					<Тип>Адрес</Тип>
					<Значение></Значение>
				</АдресноеПоле>
			</AдресРегистрации>
			<Контакты>
				<Контакт>
					<Тип>Телефон</Тип>
					<Значение>77532342479</Значение>
				</Контакт>
			</Контакты>
		</Контрагент>
		<Товары>
			<Товар>
				<Ид>104580589</Ид>
				<СерийныйНомер>2001991214856</СерийныйНомер>
				<Артикул>ВБ000003266</Артикул>
				<Наименование>OPPO A55 4 ГБ/64 ГБ черный</Наименование>
				<ЦенаЗаЕдиницу>79950.00</ЦенаЗаЕдиницу>
				<Количество>1</Количество>
				<Сумма>79950.00</Сумма>
				<Склад>24753e40-d02c-11ea-9bd9-983b8f96a176</Склад>
			</Товар>
		</Товары>
		<ЗначенияРеквизитов>
			<ЗначениеРеквизита>
				<Наименование>Статус</Наименование>
				<Значение>APPROVED_BY_BANK</Значение>
			</ЗначениеРеквизита>
			<ЗначениеРеквизита>
				<Наименование>Состояние</Наименование>
				<Значение>NEW</Значение>
			</ЗначениеРеквизита>
			<ЗначениеРеквизита>
				<Наименование>Маркетплейс</Наименование>
				<Значение>OZON</Значение>
			</ЗначениеРеквизита>
		</ЗначенияРеквизитов>
	</Документ>
</Заказы>
```

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.marketradar.kz/api-marketradar/api-dlya-zakazov.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.