Page tree
Skip to end of metadata
Go to start of metadata

Ключ

Заказ категории WEB (вызов курьера) создаётся с ключом категории 4.

Особенности

Это обычная доставка из пункта A в пункт B. Сценарии взаимодействия в случае создания заказа категории WEB здесь.

География 

Доставка осуществляется по России и СНГ, а также из России (или СНГ) в дальнее зарубежье.

На что обратить внимание

В случае успешного создания заказа ответ API будет содержать статус  заказа Processing, а также номер накладной (Waybill->Number) и номер заказа ПЭ (PerformersNumber).

Рекомендуется передавать не более 50 заказов в одном запросе, - иначе запрос будет обрабатываться долго, и клиентское приложение получит ошибку таймаута, несмотря на то, что заказы будут созданы.

Спецификация

Ниже приведён пример создания заказа WEB. Перед использованием рекомендуется изменить поле ClientsNumber, т.к. клиентский номер заказа должен быть уникален в рамках используемого ключа доступа.

Описание типов данных здесь.

Request
Request code
<?xml version="1.0" encoding="utf-8"?>
<Request xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="OrderRequest">
  <Id>1</Id> <!--Optional-->
  <Mode>Order</Mode> <!--Required-->
  <OrderList> <!--Required-->
    <Order> <!--Required-->
      <ClientsNumber>test0005572</ClientsNumber> <!--Optional-->
      <Payment> <!--Required-->
        <Mode>BillBySender</Mode> <!--Required-->
      </Payment>
      <ServiceList> <!--Required-->
        <Service xsi:type="DeliveryService"> <!--Required-->
		  <PickupDate>2021-11-18T00:00:00+04:00</PickupDate> <!--Optional-->
          <Mode>Express</Mode> <!--Optional-->
          <Sender> <!--Required-->
            <Address> <!--Required-->
              <Country>Россия</Country> <!--Optional-->
              <Region> </Region> <!--Optional-->
              <District> </District> <!--Optional-->
              <PostCode>127023</PostCode> <!--Optional-->
              <City>Москва</City> <!--Required-->
              <StreetAddress>ул.Строителей, д.13</StreetAddress> <!--Required-->
            </Address>
            <Company> <!--Required-->
              <Name>ОАО "Компания"</Name> <!--Required-->
            </Company>
            <PersonList> <!--Required-->
              <Person> <!--Required at least one-->
                <Name>Петров Игорь Иванович</Name> <!--Required-->
                <PhoneList> <!--Required-->
                  <string>+7 495 342-3422</string> <!--Required at least one-->
                  <string>12-44</string>
                </PhoneList>
              </Person>
              <Person>
                <Name>Иванов Семен</Name>
                <PhoneList>
                  <string>+7 910 456-7895</string>
                </PhoneList>
              </Person>
            </PersonList>
            <Unformalized>Или любому другому лицу в компании</Unformalized> <!--Optional-->
          </Sender>
          <Recipient> <!--Required-->
            <Address> <!--Required-->
              <Country>Россия</Country> <!--Optional-->
              <Region>Красноярcкий край</Region> <!--Optional-->
              <District> </District> <!--Optional-->
              <PostCode>660013</PostCode> <!--Optional-->
              <City>Красноярск</City> <!--Required-->
              <StreetAddress>ул.Взлетная, д.1</StreetAddress> <!--Required-->
            </Address>
            <Company> <!--Optional-->
              <Name>ОАО "Самолет"</Name> <!--Required if parent node present-->
            </Company>
            <PersonList> <!--Required-->
              <Person> <!--Required at least one-->
                <Name>Шпак Геннадий Семенович</Name> <!--Required-->
                <PhoneList> <!--Required-->
                  <string>+3912 34-23-12</string> <!--Required at least one-->
                  <string>11-4</string>
                </PhoneList>
              </Person>
            </PersonList>
          </Recipient>
          <CargoList> <!--Required-->
            <Cargo> <!--Required at least one-->
              <Id>1</Id> <!--Optional-->
              <Barcode>12345234</Barcode> <!--Required if CargoList contain more than one Cargo-->
              <Description>Пимпачки и помпочки</Description> <!--Optional-->
              <Packing> <!--Optional-->
                <Type>Box</Type> <!--Required if parent node present-->
              </Packing>
              <Dimentions> <!--Optional-->
                <Length>350</Length> <!--Required if parent node present-->
                <Width>500</Width> <!--Required if parent node present-->
                <Height>300</Height> <!--Required if parent node present-->
              </Dimentions>
              <Weight>1400</Weight> <!--Required-->
              <Cost>5000</Cost> <!--Optional-->
            </Cargo>
            <Cargo>
              <Id>2</Id>
              <Barcode>12345235</Barcode>
              <Description>Штучки</Description>
              <Packing>
                <Type>Box</Type>
              </Packing>
              <Dimentions>
                <Length>250</Length>
                <Width>300</Width>
                <Height>200</Height>
              </Dimentions>
              <Weight>800</Weight>
              <Cost>10000</Cost>
            </Cargo>
          </CargoList>
          <Unformalized>Доставка запчастей</Unformalized> <!--Optional-->
         <AdditionalServices> <!--Optional--> 
            <DeliveryAdditionalService> <!--Optional-->
              <Code>1015</Code> <!--Required if parent node present-->
            </DeliveryAdditionalService>
            <DeliveryAdditionalService>
              <Code>1017</Code>
            </DeliveryAdditionalService>
            <DeliveryAdditionalService> <!--Optional-->
              <Code>1019</Code> <!--Required if parent node present-->
              <Parameters> <!--Optional-->
                <ServiceParameter xsi:type="CountParameter"> <!--Optional-->
                  <Count>10</Count> <!--Required if parent node present-->
                </ServiceParameter>
              </Parameters>
            </DeliveryAdditionalService>           
            <DeliveryAdditionalService>
              <Code>1013</Code>
              <Parameters>
                <ServiceParameter xsi:type="AddressParameter">
                  <Country>Россия</Country>
                  <Region>Московская область</Region>
                  <District>Одинцовский</District>
                  <PostCode>111631</PostCode>
                  <City>Одинцово</City>
                  <StreetAddress>Белорусская 4 -125</StreetAddress>
                </ServiceParameter>
              </Parameters>
            </DeliveryAdditionalService>               
          </AdditionalServices>
        </Service>
      </ServiceList>
    </Order>
  </OrderList>
</Request>

Response

Response code
<?xml version="1.0" encoding="utf-8"?>
<Response xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
	<RequestId>1</RequestId>
	<OrderList>
		<Order>
			<Guid>d719a299-5497-491f-ae6c-cb249cf6c272</Guid>
			<ClientsNumber>test0005572</ClientsNumber>
			<PerformersNumber>MOW35257729</PerformersNumber>
			<OrderType>Regular</OrderType>
			<Payment>
				<Mode>BillBySender</Mode>
			</Payment>
			<ServiceList>
				<Service xsi:type="DeliveryService">
					<StatusList />
					<PickupDate>2021-11-17T00:00:00</PickupDate>
					<OriginPickupDate>2021-11-17T23:00:00</OriginPickupDate>
					<PlannedDeliveryDate>2021-11-19T00:00:00</PlannedDeliveryDate>
					<Mode>Express</Mode>
					<Waybill>
						<Number>24-4103-7060</Number>
					</Waybill>
					<Sender>
						<Address>
							<Country>Россия</Country>
							<Region> </Region>
							<District> </District>
							<PostCode>127023</PostCode>
							<City>Москва</City>
							<StreetAddress>ул.Строителей, д.13</StreetAddress>
						</Address>
						<Company>
							<Name>ОАО "Компания"</Name>
						</Company>
						<PersonList>
							<Person>
								<Name>Иванов Семен</Name>
								<PhoneList>
									<string>+7 910 456-7895</string>
								</PhoneList>
							</Person>
							<Person>
								<Name>Петров Игорь Иванович</Name>
								<PhoneList>
									<string>+7 495 342-3422</string>
									<string>12-44</string>
								</PhoneList>
							</Person>
						</PersonList>
						<Node>MOW</Node>
						<Unformalized>Или любому другому лицу в компании</Unformalized>
					</Sender>
					<Recipient>
						<Address>
							<Country>Россия</Country>
							<Region>Красноярcкий край</Region>
							<District> </District>
							<PostCode>660013</PostCode>
							<City>Красноярск</City>
							<StreetAddress>ул.Взлетная, д.1</StreetAddress>
						</Address>
						<Company>
							<Name>ОАО "Самолет"</Name>
						</Company>
						<PersonList>
							<Person>
								<Name>Шпак Геннадий Семенович</Name>
								<PhoneList>
									<string>+3912 34-23-12</string>
									<string>11-4</string>
								</PhoneList>
							</Person>
						</PersonList>
						<Node>KJA</Node>
					</Recipient>
					<CargoList>
						<Cargo>
							<Id>2</Id>
							<Barcode>12345235</Barcode>
							<Description>Штучки</Description>
							<Packing>
								<Type>Box</Type>
							</Packing>
							<Dimentions>
								<Length>250</Length>
								<Width>300</Width>
								<Height>200</Height>
							</Dimentions>
							<Weight>800</Weight>
							<VolumeWeight>3000</VolumeWeight>
							<Cost>10000.0000</Cost>
						</Cargo>
						<Cargo>
							<Id>1</Id>
							<Barcode>12345234</Barcode>
							<Description>Пимпачки и помпочки</Description>
							<Packing>
								<Type>Box</Type>
							</Packing>
							<Dimentions>
								<Length>350</Length>
								<Width>500</Width>
								<Height>300</Height>
							</Dimentions>
							<Weight>1400</Weight>
							<VolumeWeight>10500</VolumeWeight>
							<Cost>5000.0000</Cost>
						</Cargo>
					</CargoList>
					<ItemList />
					<PackItemList />
					<DocumentList />
					<Unformalized>Доставка запчастей</Unformalized>
					<AdditionalServices>
						<DeliveryAdditionalService>
							<Code>1015</Code>
							<IncludingType>Declined</IncludingType>
						</DeliveryAdditionalService>
						<DeliveryAdditionalService>
							<Code>1019</Code>
							<IncludingType>Declined</IncludingType>
							<Parameters>
								<ServiceParameter xsi:type="CountParameter">
									<Count>10</Count>
								</ServiceParameter>
							</Parameters>
						</DeliveryAdditionalService>
						<DeliveryAdditionalService>
							<Code>1017</Code>
							<IncludingType>Declined</IncludingType>
						</DeliveryAdditionalService>
						<DeliveryAdditionalService>
							<Code>1013</Code>
							<IncludingType>Declined</IncludingType>
							<Parameters>
								<ServiceParameter xsi:type="AddressParameter">
									<Country>Россия</Country>
									<Region>Московская область</Region>
									<District>Одинцовский</District>
									<PostCode>111631</PostCode>
									<City>Одинцово</City>
									<StreetAddress>Белорусская 4 -125</StreetAddress>
								</ServiceParameter>
							</Parameters>
						</DeliveryAdditionalService>
					</AdditionalServices>
				</Service>
			</ServiceList>
			<StatusList>
				<OrderStatus>
					<Description>Order has been received</Description>
					<Date>2019-09-03T16:10:19.643</Date>
					<Code>Received</Code>
				</OrderStatus>
				<OrderStatus>
					<Description>Order has been checked</Description>
					<Date>2019-09-03T16:10:20.04</Date>
					<Code>Checked</Code>
				</OrderStatus>
				<OrderStatus>
					<Description>Order is in processing</Description>
					<Date>2019-09-03T16:10:20.483</Date>
					<Code>Processing</Code>
				</OrderStatus>
			</StatusList>
			<ExternalDataList />
		</Order>
	</OrderList>
	<MessageList />
</Response>



  • No labels