Описание стандартного протокола интеграции — различия между версиями

Материал из Меасофт
Перейти к: навигация, поиск
м (Формат передачи данных о заказе)
м
Строка 1: Строка 1:
Описание стандартного протокола интеграции системы «Курьерская служба 2008» с внешними системами
+
Описание стандартного протокола интеграции системы «Курьерская служба 2008» с внешними системами.
 +
 
 +
Вы можете скачать пример файла с заказами [http://www.courierexe.ru/download/SPM-ORD-20120924130044.CSV здесь]
  
 
Передача данных об осуществляется путем передачи CSV-файлов ([http://ru.wikipedia.org/wiki/CSV RFC 4180], разделитель – точка с запятой (;), кодировка – win1251 ) через FTP-сервер.  
 
Передача данных об осуществляется путем передачи CSV-файлов ([http://ru.wikipedia.org/wiki/CSV RFC 4180], разделитель – точка с запятой (;), кодировка – win1251 ) через FTP-сервер.  

Версия 14:14, 25 января 2013

Описание стандартного протокола интеграции системы «Курьерская служба 2008» с внешними системами.

Вы можете скачать пример файла с заказами здесь

Передача данных об осуществляется путем передачи CSV-файлов (RFC 4180, разделитель – точка с запятой (;), кодировка – win1251 ) через FTP-сервер.

Формат имен файлов:

Файл заказов: Префикс-ORD-YYYYMMDDHHMMSS.CSV

Файл ответов: Префикс-RPT-YYYYMMDDHHMMSS.CSV

Где «Префикс» - согласованный префикс компании, в которой сформирован файл, YYYYMMDDHHMMSS – дата/время формирования файла. Пример наименования: EVS-ORD-20120205221632.CSV

Формат передачи данных

Даты указываются в формате «DD.MM.YYYY», время указывается в формате «HH:MM», Разделитель целой и дробной частей чисел – точка (.)


Формат передачи данных о заказе

Поля 1-16 – описание корреспонденции:

Номер поля Описание Имя столбца при открытии Excel'ем
1 ID - код заказа по учетной системе заказчика a
2 Штрих-код отправления b
3 Компания-получатель c
4 Конт. лицо получателя d
5 Адрес доставки e
6 Телефон получателя f
7 Вложение - описание содержимого g
8 Регион получателя h
9 Населенный пункт получателя i
10 Стоимость отправления j
11 Дата доставки план k
12 Время вручения "С" l
13 Время вручения "До" m
14 Масса отправления n
15 Кол-во мест по накладной o
16 Возврат p
17 Сумма, подлежащая инкассации с получателя q
18 Тип оплаты r
19 Комментарий s

Примечания:

Тип оплаты:

Значение Описание
0 Наличными при получении
1 Оплата картой
2 Инкассация не требуется

Возврат:

Значение Описание
0 Не требуется
1 Требуется поездка обратно
2 Только поездка обратно. В этом случае поля контактов получателя описывают контакты отправителя.

Поля 20-26 - Зарезервированы

Поля 27-30 – Описание содержимого:

Номер поля Описание Имя столбца при открытии Excel'ем
27 Артикул aa
28 Наименование товара ab
29 Масса единицы ac
30 Количество ad
31 Цена единицы (с учетом скидок/наценок, если есть) ae


В случае наличия нескольких срок содержания заказа строки добавляются вертикально, при этом для 2-й и последующих строк заказа поля 1-26 дублируются.

Заказ загружается в систему, если заполнены поля 1(ID) и 5 (адрес доставки), и в системе отсутствует ранее загруженный заказ с этим же ID (поле 1).

Описание содержимого загружается в систему, если заполнено поле 30 (количество). В случае наличия описания содержимого, поля 14, 15, 17 игнорируется, и соответствующие значения рассчитываются на основании описания содержимого.

Формат передачи данных о статусе заказа

Номер поля Описание Имя столбца при открытии Excel'ем
1 ID Отправления a
2 Дата вручения b
3 Время вручения c
4 Инфо о доставке d
5 Статус e
6 Цена доставки f
7 Инкассированная сумма g

Примечания:

Типы статусов:

DELIVERY Доставляется
COMPLETE Доставлен
CANCELED Не доставлен
PARTIALLY Доставлен частично

Инфо о доставке – Фамилия получившего человека, либо причина недоставки.