Импорт заказа и статусов позиций

Описание

Импортирует в маркет заказ, метод оплаты и статусы позиций.

URL-адрес

Метод: POST

https://example.com/api/v1.1/market/orders/import

Параметры запроса

Параметр	Тип	Пример	Обязательный	Описание
token	string	"abcdefghijklmnqrstuvwxyz"	Да	API токен Убедитесь, что для токена доступны роли, позволяющие работать с маркетом.
custom_fields	array of objects	"custom_fields": [   {    "external_id": "1234",    "name": "1234",    "entity_type": "line_order",    "required": false,    "value_type": "unicode",    "default_value": "data"   } ]	Нет	Создание новых дополнительных полей для сущностей: SKU продукт заказ позиция заказа Поля нужно создать до их использования в заказе.
custom_line_statuses	array of objects	"custom_line_statuses": [  {   "external_id": "1234",   "name": "Поступил в пункт выдачи",   "type": "in_process"  } ]	Нет	Кастомный статус позиции заказа. Необходимо передать идентификатор статуса (external_id), его название (name) и тип (type). Возможные значения поля type: delivered (доставлен) canceled (отменен) refunded (возврат) in_process (обрабатывается)
skip_triggers	bool	true	Нет	Пропустить запуск триггеров (по умолчанию – false)
data	array of objects	"data": [    {       "external_id": "123456",       "matching":"email",       "email":"johndoe@example.com"       "endpoint": "endpoint_external_id",       "status": "new",       "total_price": "3000",       "currency": "USD",       "create_time": "2022-01-02T15:04:05.141Z",       "lines": [          {             "external_id": "7777",             "status": "new",             "product": "product_external_id",             "base_price_per_item": "600",             "min_price_per_item": "300",             "final_price_per_item": "500",             "count": 5          }       ]    } ]	Да	Данные о заказе. В этом блоке можно указать значения для ранее созданных custom_fields

подсказка

Если необходимо задать значение для созданного дополнительного поля, передайте в объект custom_fields, где ключом будет external_id этого поля, а значением — требуемые данные.

Пример запроса

JSON

{
  "token": "abcdefghijklmnqrstuvwxyz",
  "custom_fields": [ 
    {
      "external_id": "order_field_id_123",
      "name": "Дополнительное поле заказа",
      "entity_type": "order",
      "required": false,
      "value_type": "unicode",
      "default_value": "значение тестового поля"
    },
    {
      "external_id": "line_field_id_123",
      "name": "Дополнительное поле позиции заказа",
      "entity_type": "line_order",
      "required": false,
      "value_type": "unicode",
      "default_value": "значение тестового поля"
    }
  ],
  "custom_line_statuses": [
    {
      "external_id": "status_id_123",
      "name": "Доставлен в пункт выдачи",
      "type": "in_process"
    }
  ],
  "skip_triggers": true,
  "data": [
    {
      "external_id": "1234000",
      "matching": "email",
      "email": "johndoe@example.com",
      "endpoint": "website",
      "tags": ["one", "two"],
      "status": "delivered",
      "delivery_cost": "100",
      "total_price": "1000",
      "currency": "USD",
      "create_time": "2022-01-02T15:04:05.141Z",
      "custom_fields": {            
        "order_field_id_123": "data"
      },
      "region": "region_YnCrJj8Y1",
      "lines": [
        {
          "external_id": "line_01",
          "status": "status_id_123",
          "product": "iphone_test_1",
          "base_price_per_item": "900",
          "min_price_per_item": "900",
          "final_price_per_item": "900",
          "count": 1,
          "custom_fields": { 
            "line_field_id_123": "data"
          }
        }
      ]
    }
  ]
}

XML

<xml>
<token>abcdefghijklmnqrstuvwxyz</token>
  <custom_fields>
    <external_id>order_field_id_123</external_id>
    <name>Дополнительное поле заказа</name>
    <entity_type>order</entity_type>
    <required>false</required>
    <value_type>unicode</value_type>
    <default_value>значение тестового поля</default_value>
  </custom_fields>
  <custom_fields>
    <external_id>line_field_id_123</external_id>
    <name>Дополнительное поле позиции заказа</name>
    <entity_type>line_order</entity_type>
    <required>false</required>
    <value_type>unicode</value_type>
    <default_value>значение тестового поля</default_value>
  </custom_fields>
  <custom_line_statuses>
    <external_id>status_id_123</external_id>
    <name>Доставлен в пункт выдачи</name>
    <type>in_process</type>
  </custom_line_statuses>
  <skip_triggers>true</skip_triggers>
  <data>
    <external_id>1234000</external_id>
    <matching>email</matching>
    <email>johndoe@example.com</email>
    <endpoint>website</endpoint>
    <tags>one</tags>
    <tags>two</tags>
    <status>delivered</status>
    <delivery_cost>100</delivery_cost>
    <total_price>1000</total_price>
    <currency>USD</currency>
    <create_time>2022-01-02T15:04:05.141Z</create_time>
    <custom_fields>
      <order_field_id_123>data</order_field_id_123>
    </custom_fields>
    <region>region_YnCrJj8Y1</region>
    <lines>
      <external_id>line_01</external_id>
      <status>status_id_123</status>
      <product>iphone_test_1</product>
      <base_price_per_item>900</base_price_per_item>
      <min_price_per_item>900</min_price_per_item>
      <final_price_per_item>900</final_price_per_item>
      <count>1</count>
      <custom_fields>
        <line_field_id_123>data</line_field_id_123>
      </custom_fields>
    </lines>
  </data>
</xml>

к сведению

custom_fields в корне запроса создаёт новые поля (массив), а в data — заполняет их значениями (объект "id_поля": "значение")

Возвращаемые параметры

Параметр	Тип	Описание
error	int	Код ошибки
error_text	string	Текст ошибки
result	array	Идентификаторы импортированных заказов

Пример ответа

JSON

{
  "error": 0,
  "error_text": "",
  "result": [
    {
      "error": 0,
      "external_id": "1234000"
    }
  ]
}

XML

<xml>
    <error>0</error>
    <error_text></error_text>
    <result>
        <error>0</error>
        <external_id>1234000</external_id>
    </result>
</xml>