Описание стандартного протокола интеграции

Описание стандартного протокола интеграции системы «Курьерская служба 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	Возврат	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	Доставлен частично

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