Описание стандартного протокола интеграции — различия между версиями

Материал из Меасофт
Перейти к: навигация, поиск
м
м
 
(не показано 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:MM», Разделитель целой и дробной частей чисел – точка (.)
+
Даты указываются в формате «DD.MM.YYYY», время указывается в формате «HH:MM:SS», Разделитель целой и дробной частей чисел – точка (.)
  
  
Строка 19: Строка 21:
  
  
Поля 1-16 – описание корреспонденции:
+
Поля 1-19 – описание корреспонденции:
 
{|
 
{|
 
!Номер поля
 
!Номер поля
Строка 86: Строка 88:
 
|-
 
|-
 
|16
 
|16
|Возврат (1 - требуется поездка обратно, 2 - только поездка обратно)
+
|Возврат
 
|p
 
|p
 
|-
 
|-
Строка 135: Строка 137:
 
Поля 20-26 - Зарезервированы
 
Поля 20-26 - Зарезервированы
  
Поля 27-30 – Описание содержимого:
+
Поля 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 Доставлен частично

Инфо о доставке – Фамилия получившего человека, либо причина недоставки.