FAQ по API

From PonyExpress API Wiki
Jump to: navigation, search

Как заполняются поля описания

Поля описания заполняются следующим образом:

  • Примечание отправителя - заполняется из тега Unformalized, относящегося к Sender и тега Unformalized, относящегося к Recipient (соединённые через символ |);
  • Описание - заполняется из поля Unformalized, относящегося к самому сервису (DeliveryService);
  • Описание вложений - заполняется из тегов Description грузомест (Cargo). Все примечания к грузоместам соединяются в одну строку через символ «,».

Как получить список доступных тарифов

Калькулятор

Передача данных об НДС для товара и услуги доставки

Информация об НДС для товара и услуги доставки указывается в запросе OrderRequest в разделах CommodityItems и DeliveryItems соответственно, в теге VAT.

Информация об Url на страницу товара указывается в запросе OrderRequest в разделах CommodityItems, в теге Url.

<CommodityItem>
  <ItemId>3</ItemId>
  <Price>101.0000</Price>
  <Url>mycompany.com</Url>  <!--Url товара -->
  <VAT>  
    <VATGroupCode>1</VATGroupCode>      <!-- Номер налоговой группы -->
  </VAT>
</CommodityItem>
<DeliveryItem>
  <Price>308.0000</Price>
  <VAT>
    <VATGroupCode>1</VATGroupCode>      <!-- Номер налоговой группы -->
  </VAT>
</DeliveryItem>

Если НДС не передается, то тег <VAT> отсутствует вместе со вложенным тегом. Если передается тег VAT, то тег VATGroupCode является обязательным и должен содержать одно из значений:

  1 - НДС 20%
  2 - НДС 10% 
  3 - НДС 0% 
  4 - Без НДС 


Как определить тип ключа

  • Ключ типа ИМ - такой тип ключа необходимо выбрать в случае наличия услуги торгового посредничества;
  • Ключ типа Web - такой тип ключа необходимо выбрать в случае стандартной доставки (вызов курьера);
  • Ключ типа ТГ - такой тип ключа необходимо выбрать в случае доставки товаров из-за границы.

Как изменить способ взаиморасчеты Pony Express и интернет-магазина

Информация о взаиморасчетах интернет-магазина и Pony Express указывается в запросе OrderRequest в разделе Payment.

<Payment> <!--Информация об оплате -->
  <Mode>Bill</Mode> <!--Режим оплаты: Bill – безналичная по счету, BillBySender - по счёту отправителем, BillByRecepient - по счёту получателем, CashBySender – наличными отправителем, CashByRecipient – наличными получателем -->
  <PaymentContract> <!--Информация о договоре плательщика (обязательно только если оплата по счету третьей стороной) -->
    <Number>70-989</Number> <!-- Номер договора -->
  </PaymentContract>
</Payment>

Как для заказов интернет-магазина передать стоимость, которую курьер должен взять с получателя

Необходимую информацию можно найти в разделе:

Как узнать, какие товары выкуплены для интернет-магазина

В случае, если Mode заполнен как Partial, у покупателя появится возможность частичного выкупа. А потом, когда произойдет само событие выкупа или отказа, в StatusList будут автоматически добавлены статусы: Sold - "некоторые лоты проданы покупателю" Refused – "некоторые лоты возвращены покупателем" Какие именно лоты проданы или возвращены, можно будет посмотреть во вложенном в статус LotList

<Service xsi:type="SalesMediationService">
  <StatusList>
    <ServiceStatus xsi:type="SalesMediationStatus">
      <Description>Commodities have been sold. Lots: 1</Description>
      <Date>2013-11-21T21:22:30.0887813+04:00</Date>
      <Code>Sold</Code>
      <LotList>
        <string>1</string>
      </LotList>
    </ServiceStatus>
    <ServiceStatus xsi:type="SalesMediationStatus">
      <Description>Commodities have been refused. Lots: 2</Description>
      <Date>2013-11-21T21:22:30.0887813+04:00</Date>
      <Code>Refused</Code>
      <LotList>
        <string>2</string>
      </LotList>
    </ServiceStatus>
  </StatusList>
</Service>

Как создать заказ в доп. услугами

Чтобы активировать возможность передачи доп. услуг, необходимо связаться с персональным менеджером. Менеджер инициирует процесс настройки возможных и обязательных услуг для договора. После этого, можно воспользоваться примером со страницы Сценарий создания заказа с доп. услугами