100sp предлагает функцию доставки любых ваших товаров через свою сеть пунктов выдачи (подробнее о доставке любых товаров). Для автоматического расчета стоимости и срока доставки вы можете воспользоваться специальным API.
Интерфейс калькулятора доставки находится по адресу https://www.100sp.ru/express/apiCreate и принимает POST-запрос с типом содержимого form-data либо json. Запрос имеет следующую структуру:
| Параметр | Тип | Описание |
|---|---|---|
| from | INT | Код пункта выдачи, куда будет сдан товар. Как узнать код ПВ можно узнать в статье "API для получения доступных пунктов выдачи". |
| didFrom | INT | Идентификатор пункта выдачи, может использоваться вместо параметра from. |
| to | INT | Код пункта выдачи, куда будет доставлен товар. Как узнать код ПВ можно узнать в статье "API для получения доступных пунктов выдачи". |
| didTo | INT | Идентификатор пункта выдачи, может использоваться вместо параметра from. |
| recipientLastName | STRING | Фамилия получателя. |
| recipientFirstName | STRING | Имя получателя. |
| recipientPhone | STRING | Телефон получателя в формате 7XXXXXXX. |
| estimatedCost | INT | Оценочная стоимость товара в рублях. Необязательный параметр. |
| content | STRING | Опись вложения. |
| outerOrderId | STRING | Внешний номер заказа. Не обязательный параметр, нужен для указания внутренного номера заказа вашего склада или внешнего поставщика. Отображается на стикере. |
| tariff | STRING | Название тарифа доставки для данного груза. Тариф можно узнать через API, описанное в статье "API для расчета стоимости доставки любых заказов". Если вы не знаете, каким тарифом нужно доставить груз, вы можете указать размеры и вес товара, тариф будет подобран автоматически. |
| length | FLOAT | Длина (метры). |
| width | FLOAT | Ширина (метры). Необязательный параметр. |
| height | FLOAT | Высота (метры). |
| weight | FLOAT | Вес (килограммы). |
В ответе содержится json следующего формата:
| requestId | INT | Идентификатор заявки на доставку. |
| orderId | INT | Идентификатор заказа. |
| error | STRING | Ошибка, если заказ не был создан. |
| orderLink | STRING | Ссылка для просмотра состава заказа без авторизации. Не отправляйте ссылку третьим лицам. |