Описание стандартного протокола интеграции — различия между версиями
Johny (обсуждение | вклад) м |
Johny (обсуждение | вклад) м |
||
| Строка 15: | Строка 15: | ||
Даты указываются в формате «DD.MM.YYYY», время указывается в формате «HH:MM», Разделитель целой и дробной частей чисел – точка (.) | Даты указываются в формате «DD.MM.YYYY», время указывается в формате «HH:MM», Разделитель целой и дробной частей чисел – точка (.) | ||
| − | Формат передачи данных о заказе | + | |
| + | == Формат передачи данных о заказе == | ||
| + | |||
Поля 1-16 – описание корреспонденции: | Поля 1-16 – описание корреспонденции: | ||
| Строка 100: | Строка 102: | ||
|} | |} | ||
Примечания: | Примечания: | ||
| − | Тип оплаты: 0 | + | |
| + | '''Тип оплаты:''' | ||
| + | {| | ||
| + | !Значение | ||
| + | !Описание | ||
| + | |- | ||
| + | |0 | ||
| + | |Наличными при получении | ||
| + | |- | ||
| + | |1 | ||
| + | |Оплата картой | ||
| + | |- | ||
| + | |2 | ||
| + | |Инкассация не требуется | ||
| + | |} | ||
| + | |||
| + | '''Возврат:''' | ||
| + | {| | ||
| + | !Значение | ||
| + | !Описание | ||
| + | |- | ||
| + | |0 | ||
| + | |Не требуется | ||
| + | |- | ||
| + | |1 | ||
| + | |Требуется поездка обратно | ||
| + | |- | ||
| + | |2 | ||
| + | |Только поездка обратно. В этом случае поля контактов получателя описывают контакты отправителя. | ||
| + | |} | ||
Поля 20-26 - Зарезервированы | Поля 20-26 - Зарезервированы | ||
| Строка 138: | Строка 169: | ||
Описание содержимого загружается в систему, если заполнено поле 30 (количество). В случае наличия описания содержимого, поля 14, 15, 17 игнорируется, и соответствующие значения рассчитываются на основании описания содержимого. | Описание содержимого загружается в систему, если заполнено поле 30 (количество). В случае наличия описания содержимого, поля 14, 15, 17 игнорируется, и соответствующие значения рассчитываются на основании описания содержимого. | ||
| − | Формат передачи данных о статусе заказа | + | |
| + | == Формат передачи данных о статусе заказа == | ||
| + | |||
{| | {| | ||
!Номер поля | !Номер поля | ||
Версия 22:23, 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 - требуется поездка обратно, 2 - только поездка обратно) | 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 | Доставлен частично |
Инфо о доставке – Фамилия получившего человека, либо причина недоставки.
