Описание стандартного протокола интеграции

Материал из Меасофт
Перейти к: навигация, поиск

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

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

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

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

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

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

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

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

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


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

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

Номер поля Описание Имя столбца при открытии 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-31 – Описание содержимого:

Номер поля Описание Имя столбца при открытии 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

Примечания:

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

NEW Новый
ACCEPTED Получен складом
DELIVERY Доставляется
COMPLETE Доставлен
CANCELED Не доставлен
PARTIALLY Доставлен частично

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