4.3.1 order/new

Описание метода Order/New

URL метода: order/new предоставляет Продавец специалистам Мегамаркета. ВАЖНО!
Запрос выполняется от Мегамаркета к Продавцу с информацией о новом заказе, оформленном на сайте Мегамаркета.
В поле quantity всегда указывается единица. Количество лотов передается по факту количеством элементов items. ВАЖНО!
Лот со стоимостью доставки указывается в отдельном itemindex'e. Его включать в запросы на комплектацию, выдачу и отмену не нужно.

Важно

При обработке запроса рекомендуется настраивать обратную совместимость

Важно

Уважаемые коллеги!
Обращаем внимание, что после 15.05 shipmentId и deliveryId перейдут на 13-значный формат.
Просим учесть данную информацию при проектировании методов.

Структура данных в теле запроса	Описание	Обязательность	Тип данных
1. data	Общий блок с данными	да	Object
1.2 merchantId	Идентификатор Продавца на стороне Мегамаркета	да	Integer
1.3 shipments	Данные об отправлениях	да	Array
1.3.1 shipmentId	Идентификатор отправления Мегамаркета	да	String
1.3.2 shipmentDate	Дата создания отправления	да	dateTime/String
1.3.3 items	Данные о лотах	да	Array
1.3.3.1 itemindex	Порядковый номер лота	да	String
1.3.3.2 goodsId	Идентификатор карточки товара Мегамаркета	да	String
1.3.3.3 offerId	Идентификатор оффера продавца	да	String
1.3.3.4 itemName	Наименование товара	да	String
1.3.3.5. price	Цена	да	Integer
1.3.3.6 finalPrice	Цена с учетом скидок	да	Integer
1.3.3.7 discounts	Описание скидок	да	Array
1.3.3.7.1 discountType	Тип скидки	нет	String
1.3.3.7.2 discountDescription	Наименование скидки	нет	String
1.3.3.7.3 discountAmount	Сумма скидки	нет	Integer
1.3.3.8 quantity	Количество	да	Integer
1.3.3.9 taxRate	Налоговая ставка	нет	Integer
1.3.3.10 reservationPerformed	Внутренний параметр резервации товара в системе Мегамаркета	да	Boolean
1.3.3.11 isDigitalMarkRequired	Для некоторых категорий товаров https://честныйзнак.рф/	да	Boolean
1.3.4 handover	Данные о дате выдачи и магазине выдачи	да	Object
1.3.4.1 packingDate	Дата, к которой необходимо скомплектовать отправление	да	dateTime/String
1.3.4.2 reserveExpirationDate	Дата истечения срока резерва в магазине	да	dateTime/String
1.3.4.3 outletId	Идентификатор магазина выдачи по системе продавца	да	String
1.3.4.4 serviceScheme	Идентификатор схемы. Для ДСМ всегда = DELIVERY_BY_MERCHANT.	да	String
1.3.4.5 depositedAmount	Сумма которую должен получить Мегамаркет по предоплате от покупателя (товар+доставка)	да	Integer
1.3.4.6 deliveryInterval	Интервал доставки	да	Object
1.3.4.6.1 id	id интервала доставки(может быть пустым)	да	uuid/String
1.3.4.6.2 dateFrom	Дата начала интервала доставки (начиная от какого времени будет доставлено)	да	dateTime/String
1.3.4.6.3 dateTo	Дата окончания интервала доставки (до какого времени будет доставлено)	да	dateTime/String
1.3.4.7 deliveryId	Номер доставки Мегамаркета	да	Integer
1.3.5 customer	Данные о покупателе	да	Object
1.3.5.1 customerFullName	ФИО Покупателя	да	String
1.3.5.2 phone	Номер телефона покупателя в формате 7xxxxxxxxxx	да	string
1.3.5.3 email	Email покупателя. Оставить пустым	да	string
1.3.5.4 address	Адрес	нет	Object
1.3.5.4.1 source	Источник	нет	String
1.3.5.4.2 postalCode	Почтовый индекс	нет	String
1.3.5.4.3 fias	Данные по ФИАС	нет	Object
1.3.5.4.3.1 regionId	Код региона	нет	String
1.3.5.4.3.2 destination	Пункт назначения	нет	String
1.3.5.4.4 geo	Гео данные	нет	Object
1.3.5.4.4.1 lat	Широта	нет	String
1.3.5.4.4.2 lon	Долгота	нет	String
1.3.5.4.5 access	Доступность	нет	Object
1.3.5.4.5.1 detachedHouse	Дом	нет	Boolean
1.3.5.4.5.2 entrance	Вход, подъезд	нет	String
1.3.5.4.5.3 floor	Этаж	нет	Integer
1.3.5.4.5.4 intercom	Домофон	нет	String
1.3.5.4.5.5 cargoElevator	Лифт	нет	Boolean
1.3.5.4.5.6 comment	Комментарий	нет	String
1.3.5.4.5.7 apartment	Квартира	нет	String
1.3.5.4.6.1 regionKladrId	Код региона	нет	String
1.3.5.4.6.2 house	Номер дома	нет	String
1.3.5.4.6.3 block	Номер строения	нет	String
1.3.5.4.6.4 flat	Номер квартиры	нет	String
1.3.5.4.6.5 regionWithType	Название региона	нет	String
1.3.5.4.6.6 cityWithType	Название города	нет	String
1.3.5.4.6.7 cityArea	Район города	нет	String
1.3.5.4.6.8 streetWithType	Название улицы	нет	String
1.3.6 flags	Флаг	нет	String
2. meta	Исходная информация от Продавца	да	Object
2.1 source	Источник данных	нет	String

Запрос Order/New

{
	"meta": {},
	"data": {
		"shipments": [{
			"shipmentId": "626114952",
			"shipmentDate": "2022-11-12T18:13:30+03:00",
			"handover": {
				"packingDate": "2022-11-13T14:00:00+03:00",
				"reserveExpirationDate": "2022-11-29T00:00:00+03:00",
				"outletId": "",
				"serviceScheme": "DELIVERY_BY_MERCHANT",
				"depositedAmount": 0,
				"deliveryInterval": {
					"dateFrom": "2022-11-15T09:00:00+03:00",
					"dateTo": "2022-11-29T21:00:00+03:00"
				},
				"deliveryId": 692620459
			},
			"customer": {
				"customerFullName": "Тест Тестович",
				"phone": "88888888888",
				"email": "",
				"address": {
					"source": "г Москва, ул Тестовая, д 1, кв. 58",
					"postalCode": "119019",
					"fias": {
						"regionId": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
						"destinationId": "4cbce9f3-6fd7-4162-962d-41268b75aadc"
					},
					"geo": {
						"lat": "55.751812",
						"lon": "37.599292"
					},
					"access": {
						"detachedHouse": false,
						"entrance": "1",
						"floor": 1,
						"intercom": "1",
						"cargoElevator": false,
						"comment": "Дверь справа",
						"apartment": "58"
					},
					"regionKladrId": "77",
					"house": "д 1",
					"block": null,
					"flat": "58",
					"regionWithType": "г Москва",
					"cityWithType": "г Москва",
					"cityArea": "Центральный",
					"streetWithType": "ул Арбат"
				}
			},
			"flags": [],
			"items": [{
				"itemIndex": "1",
				"goodsId": "100000572021",
				"offerId": "BV001950-k",
				"itemName": "Материнская плата Gigabyte GA-H110M-H",
				"price": 990,
				"finalPrice": 990,
				"discounts": [],
				"quantity": 1,
				"taxRate": "NOT",
				"reservationPerformed": true,
				"isDigitalMarkRequired": true
			}, {
				"itemIndex": "2",
				"goodsId": "100025325086",
				"offerId": "delivery",
				"itemName": "Доставка",
				"price": 200,
				"finalPrice": 200,
				"discounts": [],
				"quantity": 1,
				"taxRate": null,
				"reservationPerformed": true,
				"isDigitalMarkRequired": false
			}]
		}],
		"merchantId": 1111
	}
}

Запрос Order/New с применением Бонусных рублей СММ+СБЕРСпасибо Предоплата ДСМ

{
	"meta": {},
	"data": {
		"shipments": [{
			"shipmentId": "626114952",
			"shipmentDate": "2022-11-12T18:13:30+03:00",
			"handover": {
				"packingDate": "2022-11-13T14:00:00+03:00",
				"reserveExpirationDate": "2022-11-29T00:00:00+03:00",
				"outletId": "",
				"serviceScheme": "DELIVERY_BY_MERCHANT",
				"depositedAmount": 500,
				"deliveryInterval": {
					"dateFrom": "2022-11-15T09:00:00+03:00",
					"dateTo": "2022-11-29T21:00:00+03:00"
				},
				"deliveryId": 692620459
			},
			"customer": {
				"customerFullName": "Тест Тестович",
				"phone": "88888888888",
				"email": "",
				"address": {
					"source": "г Москва, ул Тестовая, д 1, кв. 58",
					"postalCode": "119019",
					"fias": {
						"regionId": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
						"destinationId": "4cbce9f3-6fd7-4162-962d-41268b75aadc"
					},
					"geo": {
						"lat": "55.751812",
						"lon": "37.599292"
					},
					"access": {
						"detachedHouse": false,
						"entrance": "1",
						"floor": 1,
						"intercom": "1",
						"cargoElevator": false,
						"comment": "Дверь справа",
						"apartment": "58"
					},
					"regionKladrId": "77",
					"house": "д 1",
					"block": null,
					"flat": "58",
					"regionWithType": "г Москва",
					"cityWithType": "г Москва",
					"cityArea": "Центральный",
					"streetWithType": "ул Арбат"
				}
			},
			"flags": [],
			"items": [{
				"itemIndex": "1",
				"goodsId": "100000572021",
				"offerId": "BV001950-k",
				"itemName": "Материнская плата Gigabyte GA-H110M-H",
				"price": 500,
				"finalPrice": 400,
				"discounts": [{
					"discountType": "LOY",
					"discountDescription": "МРЦ + Скидка БР",
					"discountAmount": 100
				}],
				"quantity": 1,
				"taxRate": "NOT",
				"reservationPerformed": true,
				"isDigitalMarkRequired": true
			}, {
				"itemIndex": "2",
				"goodsId": "100025325086",
				"offerId": "delivery",
				"itemName": "Доставка",
				"price": 200,
				"finalPrice": 100,
				"discounts": [{
					"discountType": "LOY",
					"discountDescription": "МРЦ + Скидка БР",
					"discountAmount": 100
				}],
				"quantity": 1,
				"taxRate": null,
				"reservationPerformed": true,
				"isDigitalMarkRequired": false
			}]
		}],
		"merchantId": 1111
	}
}

Бонусы будут автоматически распределяться по лотам заказа, стремясь к равному количеству на всех лотах. Однако в ряде случаев (например, количество бонусов не делится нацело на количество лотов) это невозможно, что может привести к ситуации, когда одинаковые товары в заказе будут иметь разный finalPrice - такая обработка все равно технически корректна.

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

{"success":1,"meta":{"source":"merchant_name"}}

Примечание

ВАЖНО! Система Мегамаркета примет заказ только если в ответе прислан 200 code с json телом запроса.