POST-запрос: трекинг посылок: различия между версиями

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
 
(не показана 21 промежуточная версия этого же участника)
Строка 1: Строка 1:
{{#seo:
|title=POST-запрос: трекинг посылок
|titlemode=append
|keywords=планфикс, POST-запросы, сценарии, трекинг посылок, СДЭК, Новая Почта
|description=POST-запрос: трекинг посылок
}}
Благодаря [[HTTP-запросы |HTTP-запросам]] в ПланФиксе можно отслеживать посылки транспортных компаний:
Благодаря [[HTTP-запросы |HTTP-запросам]] в ПланФиксе можно отслеживать посылки транспортных компаний:
*[#https://planfix.ru/docs/POST-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81:_%D1%82%D1%80%D0%B5%D0%BA%D0%B8%D0%BD%D0%B3_%D0%BF%D0%BE%D1%81%D1%8B%D0%BB%D0%BE%D0%BA#.D0.A1.D0.94.D0.AD.D0.9A СДЭК]
*[[#СДЭК |СДЭК]]
 
*[[#Новая Почта |Новая Почта]]




== СДЭК ==
== СДЭК ==
Настроим получение информации о номере заказа в СДЭК через аутентификацию по токену.
Настроим получение информации о номере заказа через аутентификацию по токену, используя [https://www.cdek.ru/ru/integration#for_developers API] компании СДЭК.


Схема работы:  
Схема работы:  
Строка 25: Строка 31:
https://p.pfx.so/pf/p5/j5v4Om.png
https://p.pfx.so/pf/p5/j5v4Om.png


''Обратите внимание, полученный токен добавлен в заголовок основного запроса.''
*''Обратите внимание, полученный токен добавлен в заголовок основного запроса.''
*''Получить информацию можно и по трек-номеру: <nowiki>https://api.cdek.ru/v2/orders?cdek_number={{Задача.Трек-номер}}</nowiki>''




Строка 76: Строка 83:
*[[HTTP-запросы]]
*[[HTTP-запросы]]
*[[Автоматические сценарии]]
*[[Автоматические сценарии]]
*[[API ПланФикса]]

Текущая версия от 13:22, 24 февраля 2023

Благодаря HTTP-запросам в ПланФиксе можно отслеживать посылки транспортных компаний:


СДЭК

Настроим получение информации о номере заказа через аутентификацию по токену, используя API компании СДЭК.

Схема работы: 

1. Отправка предварительного POST-запроса
2. Получение токена в ответ
3. Добавление токена в заголовок основного запроса
4. Отправка основного запроса.


  • Шаг № 1 — отправляем предварительный запрос в СДЭК, проходим аутентификацию:

qKMEOZ.png


  • Шаг № 2 — разбираем ответ на предварительный запрос и получаем токен. Отправляем в СДЭК основной запрос для получения информации о номере заказа:

j5v4Om.png

  • Обратите внимание, полученный токен добавлен в заголовок основного запроса.
  • Получить информацию можно и по трек-номеру: https://api.cdek.ru/v2/orders?cdek_number={{Задача.Трек-номер}}


  • Шаг № 3 — разбираем полученную информацию от СДЭК о номере заказа и добавляем её в нужное поле:

biFKYv.png


Новая Почта

Получаем статус посылки от украинской транспортной компании «Новая Почта».

  • Добавляем в шаблон задачи два поля типа строка: «ТТН» и «Номер телефона».
  • Настраиваем кнопку, используя API «Новой Почты»:

f0AHu5.png 


{
    "modelName": "TrackingDocument",
    "calledMethod": "getStatusDocuments",
    "methodProperties": {
        "Documents": [
            {
                "DocumentNumber": "{{Задача.ТТН}}",
                "Phone":"{{Задача.Номер телефона}}"
            }
        ]
    }
}


  • Средствами ПланФикса разбираем ответ от «Новой Почты»:

rLwPEr.png


В итоге в задаче видим дату и статус отправления:

1ClUzS.png


Дополнительная информация


Перейти

Источник — http://planfix.com/ru/help/index.php?title=POST-запрос:_трекинг_посылок&oldid=42606