Описание стандартного протокола интеграции — различия между версиями
Johny (обсуждение | вклад) м |
Johny (обсуждение | вклад) м |
||
| (не показано 6 промежуточных версий этого же участника) | |||
| Строка 1: | Строка 1: | ||
| − | Описание стандартного протокола интеграции системы «Курьерская служба 2008» с внешними системами | + | Описание стандартного протокола интеграции системы «Курьерская служба 2008» с внешними системами. |
| + | |||
| + | Вы можете скачать пример файла с заказами [http://www.courierexe.ru/download/SPM-ORD-20120924130044.CSV здесь], пример файла с ответами - [http://www.courierexe.ru/download/SPM-RPT-20120814104542.CSV здесь] | ||
Передача данных об осуществляется путем передачи CSV-файлов ([http://ru.wikipedia.org/wiki/CSV RFC 4180], разделитель – точка с запятой (;), кодировка – win1251 ) через FTP-сервер. | Передача данных об осуществляется путем передачи CSV-файлов ([http://ru.wikipedia.org/wiki/CSV RFC 4180], разделитель – точка с запятой (;), кодировка – win1251 ) через FTP-сервер. | ||
| Строка 13: | Строка 15: | ||
Формат передачи данных | Формат передачи данных | ||
| − | Даты указываются в формате «DD.MM.YYYY», время указывается в формате «HH: | + | Даты указываются в формате «DD.MM.YYYY», время указывается в формате «HH:MM:SS», Разделитель целой и дробной частей чисел – точка (.) |
| Строка 19: | Строка 21: | ||
| − | Поля 1- | + | Поля 1-19 – описание корреспонденции: |
{| | {| | ||
!Номер поля | !Номер поля | ||
| Строка 86: | Строка 88: | ||
|- | |- | ||
|16 | |16 | ||
| − | |Возврат | + | |Возврат |
|p | |p | ||
|- | |- | ||
| Строка 135: | Строка 137: | ||
Поля 20-26 - Зарезервированы | Поля 20-26 - Зарезервированы | ||
| − | Поля 27- | + | Поля 27-31 – Описание содержимого: |
{| | {| | ||
!Номер поля | !Номер поля | ||
| Строка 168: | Строка 170: | ||
Описание содержимого загружается в систему, если заполнено поле 30 (количество). В случае наличия описания содержимого, поля 14, 15, 17 игнорируется, и соответствующие значения рассчитываются на основании описания содержимого. | Описание содержимого загружается в систему, если заполнено поле 30 (количество). В случае наличия описания содержимого, поля 14, 15, 17 игнорируется, и соответствующие значения рассчитываются на основании описания содержимого. | ||
| − | |||
== Формат передачи данных о статусе заказа == | == Формат передачи данных о статусе заказа == | ||
| Строка 210: | Строка 211: | ||
Типы статусов: | Типы статусов: | ||
{| | {| | ||
| + | |NEW | ||
| + | |Новый | ||
| + | |- | ||
| + | |ACCEPTED | ||
| + | |Получен складом | ||
| + | |- | ||
|DELIVERY | |DELIVERY | ||
|Доставляется | |Доставляется | ||
Текущая версия на 07:19, 16 мая 2013
Описание стандартного протокола интеграции системы «Курьерская служба 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 | Доставлен частично |
Инфо о доставке – Фамилия получившего человека, либо причина недоставки.
