Описание стандартного протокола интеграции — различия между версиями
Johny (обсуждение | вклад) (Новая страница: «Описание стандартного протокола интеграции системы «Курьерская служба 2008» с внешними с…») |
Johny (обсуждение | вклад) м |
||
| Строка 27: | Строка 27: | ||
|a | |a | ||
|- | |- | ||
| − | 2 | + | |2 |
|Штрих-код отправления | |Штрих-код отправления | ||
|b | |b | ||
| Строка 174: | Строка 174: | ||
Примечания: | Примечания: | ||
| + | |||
Типы статусов: | Типы статусов: | ||
{| | {| | ||
Версия 22:13, 18 января 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 | Возврат (1 - требуется поездка обратно) | p |
| 17 | Сумма, подлежащая инкассации с получателя | q |
| 18 | Тип оплаты | r |
| 19 | Комментарий | s |
Примечания: Тип оплаты: 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 | Доставлен частично |
Инфо о доставке – Фамилия получившего человека, либо причина недоставки.
