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

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
 
(не показано 7 промежуточных версий этого же участника)
Строка 1: Строка 1:
{{#seo:
|title=POST-запрос: трекинг посылок
|titlemode=append
|keywords=планфикс, POST-запросы, сценарии, трекинг посылок, СДЭК, Новая Почта
|description=POST-запрос: трекинг посылок
}}
Благодаря [[HTTP-запросы |HTTP-запросам]] в ПланФиксе можно отслеживать посылки транспортных компаний:
Благодаря [[HTTP-запросы |HTTP-запросам]] в ПланФиксе можно отслеживать посылки транспортных компаний:
*[[#СДЭК |СДЭК]]
*[[#СДЭК |СДЭК]]
Строка 5: Строка 11:


== СДЭК ==
== СДЭК ==
Настроим получение информации о номере заказа в СДЭК через аутентификацию по токену, используя API компании '''«СДЭК»'''.
Настроим получение информации о номере заказа через аутентификацию по токену, используя [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


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


Перейти