Описание стандартного протокола интеграции
Описание стандартного протокола интеграции системы «Курьерская служба 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 |
| Штрих-код отправления | 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 | Доставлен частично |
Инфо о доставке – Фамилия получившего человека, либо причина недоставки.
