1452
правки
Изменения
Новая страница: «Описание стандартного протокола интеграции системы «Курьерская служба 2008» с внешними с…»
Описание стандартного протокола интеграции системы «Курьерская служба 2008» с внешними системами
Передача данных об осуществляется путем передачи CSV-файлов ([http://ru.wikipedia.org/wiki/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
|Доставлен частично
|}
Инфо о доставке – Фамилия получившего человека, либо причина недоставки.
Передача данных об осуществляется путем передачи CSV-файлов ([http://ru.wikipedia.org/wiki/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
|Доставлен частично
|}
Инфо о доставке – Фамилия получившего человека, либо причина недоставки.
