Файл: Процесс работы с api 4v Изменения Добавлен реквизит Статус в выгрузку Интеграцияэдо.docx
ВУЗ: Не указан
Категория: Не указан
Дисциплина: Не указана
Добавлен: 26.10.2023
Просмотров: 67
Скачиваний: 1
ВНИМАНИЕ! Если данный файл нарушает Ваши авторские права, то обязательно сообщите нам.
БлокНоменклатура>
3. БлокКонтрагенты
В этом блоке должны быть перечислены все точки (контрагенты), в которых была реализована номенклатура за период формирования файла.
В качестве атрибутов необходимо заполнить <Код> (уникальный код из вашей базы), <Наименование>, <ПолноеНаименование>, <ЮрНазвание>, <ФактАдрес>, <Канал> (возможные варианты: Опт, Розница, Сети, пусто), <ИНН>, <КПП>, <ЮрАдрес>.
Если в вашей базе адреса хранятся в отдельном справочнике, то для атрибута <Код> используйте связку КодКонтрагента_КодАдреса, где КодКонтрагента - уникальный код контрагента из вашей базы, КодАдреса - уникальный код адреса из вашей базы.
Структура:
<БлокКонтрагенты>
<СтрокаКонтрагент Код="" Наименование="" ПолноеНаименование="" ЮрНазвание="" ФактАдрес="" Канал="" ИНН="" КПП="" ЮрАдрес=""/>
БлокКонтрагенты>
Пример блока:
<БлокКонтрагенты>
<СтрокаКонтрагент Код="TEST01" Наименование="Истринское РАЙПО Первомайская" ПолноеНаименование="Истринское РАЙПО" ЮрНазвание="Истринское РАЙПО" ФактАдрес="111111, Московская обл, Истра, Первомайский бульвар, д. 30" Канал="Опт" ИНН="1122131231" КПП="22131231" ЮрАдрес="100001, Московская обл, Дмиторв, Ленина улица, д. 12"/>
БлокКонтрагенты>
4. БлокСупервайзеры
В этом блоке должны быть перечислены все ваши Супервайзеры.
В качестве атрибутов необходимо заполнить <Код> (уникальный код из вашей базы), <Наименование> (полное наименование из вашей базы), <Фамилия>, <Имя>, <Отчество>. Если в вашей базе нет разделения на Фамилию, Имя, Отчество – в этом случае заполните только поле Фамилия.
Структура:
<БлокСупервайзеры>
<СтрокаСупервайзер Код="" Наименование="" Фамилия="" Имя="" Отчество=""/>
БлокСупервайзеры>
Пример блока:
<БлокСупервайзеры>
<СтрокаСупервайзер Код="6" Наименование="Иванов Иван" Фамилия="Иванов Иван" Имя="" Отчество=""/>
<СтрокаСупервайзер Код="7" Наименование="Иванов Иван Иванович" Фамилия="Иванов" Имя="Иван" Отчество="Иванович"/>
БлокСупервайзеры>
5. БлокМенеджеры
В этом блоке должны быть перечислены все ваши Торговые Представители (Менеджеры).
В качестве атрибутов необходимо заполнить <Код> (уникальный код из вашей базы), <Тип>, <Наименование>, <Статус>,<Фамилия>, <Имя>, <Отчество> (Если в вашей базе нет разделения на Фамилию, Имя, Отчество – в этом случае заполните только поле Фамилия), <СупервайзерКод> (уникальный код супервайзера из вашей базы).
<Тип> может содержать значения либо «ЭТК» (Эксклюзивный торговый представитель), либо «ОП» (Общий Прайс), либо «МИКС» (Миксовая команда), либо пусто.
Торгпред может делать предварительный сбор (pre-selling), либо с колес (van-selling). Поэтому в поле <Статус> пишем либо ”P” (Pre-selling), либо ”V” (Van-selling).
Если нет привязки ТП к Супервайзеру, то поле <СупервайзерКод> оставляем пустым.
Структура:
<БлокМенеджеры>
<СтрокаМенеджер Код="" Наименование="" СупервайзерКод="" Тип="" Статус="" Фамилия="" Имя="" Отчество=""/>
БлокМенеджеры>
Пример блока:
<БлокМенеджеры>
<СтрокаМенеджер Код="635" Наименование="Иванов Иван" Супервайзер="9" Тип="" Статус="V" Фамилия="Иванов Иван" Имя="" Отчество=""/>
<СтрокаМенеджер Код="43" Наименование="Иванов Иван Иванович" Супервайзер="1" Тип="ОП" Статус="P" Фамилия="Иванов" Имя="Иван" Отчество="Иванович"/>
БлокМенеджеры>
6. БлокПродажи
В этом блоке должны быть перечислены все продажи и возвраты наших номенклатур за период формирования файла. Количество товара должно быть указано только в «штуках». В качестве атрибутов необходимо заполнить <ДатаДокумента>, <НомерДокумента>, <СупервайзерКод>, <ТПКод>, <КонтрагентКод>, <НоменклатураКод>, <Колво>, <ЦенаЗаОднуШтукуСНДС>, <ЦенаЗаОднуШтукуБезНДС>, <ВидПродажи>, <Статус>.
<ДатаДокумента> - дата создания документа. Дата должна быть в формате «yyyyMMdd», где yyyy – год, MM – месяц, dd – день.
<НомерДокумента> - ваш внутренний номер документа.
<СупервайзерКод> - код вашего супервайзера.
<ТПКод> - код вашего торгпреда.
<КонтрагентКод> - код вашего контрагента.
<НоменклатураКод> - код номенклатуры.
<Колво> - Количество проданной номенклатуры, в штуках.
<ЦенаЗаОднуШтукуСНДС> - цена за одну штуку с НДС.
<ЦенаЗаОднуШтукуБезНДС> - цена за одну штуку без НДС.
<ВидПродажи> - вид продажи: П – обычная продажа, А - акция.
<Статус> - статус документа: У – помечен на удаление; З – записан, но не проведен;
П – проведен.
Если произошел возврат от вашего покупателя вам – значение <Колво> должно быть отрицательным.
Структура:
<БлокПродажи>
<СтрокаПродажи ДатаДокумента="" НомерДокумента="" СупервайзерКод="" ТПКод="" КонтрагентКод="" ВидПродажи="" НоменклатураКод="" Колво="" ЦенаЗаОднуШтукуСНДС="" ЦенаЗаОднуШтукуБезНДС="" Статус=""/>
БлокПродажи>
Пример блока: продажи от 01.10.2012
<БлокПродажи>
<СтрокаПродажи ДатаДокумента="20121001" НомерДокумента="324234234" СупервайзерКод="" ТПКод="650" КонтрагентКод=" TTT4444" ВидПродажи="П" НоменклатураКод="034324234" Колво="120" ЦенаЗаОднуШтукуСНДС="29.48" ЦенаЗаОднуШтукуБезНДС="27.32" Статус="П"/>
<СтрокаПродажи ДатаДокумента="20121001" НомерДокумента="324234234" СупервайзерКод="" ТПКод="650" КонтрагентКод=" TTT4444" ВидПродажи="П" НоменклатураКод="324234234" Колво="120" ЦенаЗаОднуШтукуСНДС="29.48" ЦенаЗаОднуШтукуБезНДС="27.32" Статус="П"/>
<СтрокаПродажи ДатаДокумента="20121001" НомерДокумента="324234235" СупервайзерКод="" ТПКод="650" КонтрагентКод=" TTT4444" ВидПродажи="П" НоменклатураКод="12354433" Колво="-120" ЦенаЗаОднуШтукуСНДС="44.68" ЦенаЗаОднуШтукуБезНДС="42.44" Статус="У"/>
БлокПродажи>
7. Блок ОстаткиНаСкладах
В этом блоке должны быть перечислены остатки наших номенклатур на ваших складах на конец каждого дня внутри отчетного периода. Количество товара должно быть указано только в «штуках».
В качестве атрибутов необходимо заполнить <ДатаВыгрузки>, <НоменклатураКод>, <Колво>.
<ДатаВыгрузки> - дата, входящая в отчетный период. Дата должна быть в формате «yyyyMMdd», где yyyy – год, MM – месяц, dd – день.
<НоменклатураКод> - код номенклатуры.
<Колво> - Количество номенклатуры на складах, в штуках.
Структура:
<БлокОстаткиНаСкладах>
<СтрокаОстатки ДатаВыгрузки="" НоменклатураКод="" Колво=""/>
БлокОстаткиНаСкладах>
Пример блока на 01.10.2012.
<БлокОстаткиНаСкладах>
<СтрокаОстатки ДатаВыгрузки="20121001" НоменклатураКод="034324234" Колво="12"/>
<СтрокаОстатки ДатаВыгрузки="20121001" НоменклатураКод="12354433" Колво="12"/>
БлокОстаткиНаСкладах>
8. Блок ПриемкиНашегоТовараНаСклад
В этом блоке должно быть описано поступление наших товаров на ваш склад. Количество товара должно быть указано только в штуках. В качестве атрибутов необходимо заполнить
<ДатаДокумента>, <НомерВашегоДокумента>, <НомерНашегоДокумента>>, <Статус>, <НоменклатураКод>, <Колво>.
<ДатаДокумента> - дата приемки товара на склад. Дата должна быть в формате «yyyyMMdd», где yyyy – год, MM – месяц, dd – день.
<НомерВашегоДокумента> - внутренний номер вашего документа
<НомерНашегоДокумента> - номер нашего документа
<Статус> - статус документа: У – помечен на удаление; З – записан, но не проведен;
П – проведен.
<НоменклатураКод> - код номенклатуры.
<Колво> - Принятое количество номенклатуры на склад, в штуках.
Структура:
<БлокПриемкиНашегоТовараНаСклад>
<СтрокаПриемка ДатаДокумента="" НомерВашегоДокумента="" НомерНашегоДокумента ="" Статус="" НоменклатураКод="" Колво=""/>
БлокПриемкиНашегоТовараНаСклад>
Пример. Приехала фура с товаром 01.10.2012
<БлокПриемкиНашегоТовараНаСклад>
<СтрокаПриемка ДатаДокумента="20121001" НомерВашегоДокумента="ДП123213123" НомерНашегоДокумента ="ВГ12312312" Статус="З" НоменклатураКод="034324234" Колво="12"/>
<СтрокаПриемка ДатаДокумента="20121001" НомерВашегоДокумента="ДП123213123" НомерНашегоДокумента ="ВГ12312312" Статус="З" НоменклатураКод="12354433" Колво="12"/>
БлокПриемкиНашегоТовараНаСклад>
9. Блок Инвентаризация
В этом блоке должно быть описаны списания и оприходования наших товаров на ваших складах. Количество товара должно быть указано только в штуках. В качестве атрибутов необходимо заполнить <ДатаСписания>, <НомерДокумента>, <Статус>,
<НоменклатураКод>, <Колво>
<ДатаСписания> - дата списания товара. Дата должна быть в формате «yyyyMMdd», где yyyy – год, MM – месяц, dd – день.
<НомерДокумента> - ваш внутренний номер документа.
<Статус> - статус документа: У – помечен на удаление; З – записан, но не проведен;
П – проведен.
<НоменклатураКод> - ваш код номенклатуры.
<Колво> - Количество оприходованной\списанной номенклатуры, в штуках. Оприходованная продукция должна быть со знаком +, списанная со знаком -
Структура:
<БлокИнвентаризация>
<СтрокаИнвентаризация ДатаСписания="" НомерДокумента="" Статус="" НоменклатураКод="" Колво=""/>
БлокПродажи>
Пример блока: инвентаризация от 01.10.2012
<БлокИнвентаризация>
<СтрокаИнвентаризация ДатаСписания="20121001" НомерДокумента="авава44" Статус="З" НоменклатураКод="034324234" Колво="21"/>
<СтрокаИнвентаризация ДатаСписания="20121001" НомерДокумента="авава12" Статус="П" НоменклатураКод="034324299" Колво="-19"/>
БлокИнвентаризация>
Полная структура:
<ДанныеДокумента>
<СтрокаДанные НаименованиеОрганизации="" АдресОрганизации="" ДатаНачалаФормированияФайла="" ДатаКонецФормированияФайла=""/>
ДанныеДокумента>
<БлокНоменклатура>
<СтрокаНоменклатура Код="" Наименование="" ПолноеНаименование=""/>
БлокНоменклатура>
<БлокКонтрагенты>
<СтрокаКонтрагент Код="" Наименование="" ПолноеНаименование="" ЮрНазвание="" ФактАдрес="" Канал="" ИНН="" КПП="" ЮрАдрес=""/>
БлокКонтрагенты>
<БлокСупервайзеры>
<СтрокаСупервайзер Код="" Наименование="" Фамилия="" Имя="" Отчество=""/>
БлокСупервайзеры>
<БлокМенеджеры>
<СтрокаМенеджер Код="" Наименование="" СупервайзерКод="" Тип="" Статус="" Фамилия="" Имя="" Отчество=""/>
БлокМенеджеры>
<БлокПродажи>
<СтрокаПродажи ДатаДокумента="" НомерДокумента="" Статус="" СупервайзерКод="" ТПКод="" КонтрагентКод="" НоменклатураКод="" Колво="" ЦенаЗаОднуШтукуСНДС="" ЦенаЗаОднуШтукуБезНДС="" ВидПродажи=""/>
БлокПродажи>
<БлокОстаткиНаСкладах>
<СтрокаОстатки ДатаВыгрузки="" НоменклатураКод="" Колво=""/>
БлокОстаткиНаСкладах>
<БлокПриемкиНашегоТовараНаСклад>
<СтрокаПриемка ДатаДокумента="" НомерВашегоДокумента="" НомерНашегоДокумента="" Статус="" НоменклатураКод="" Колво=""/>
БлокПриемкиНашегоТовараНаСклад>
<БлокИнвентаризация>
<СтрокаИнвентаризация ДатаСписания="" НомерДокумента="" Статус="" НоменклатураКод="" Колво=""/>
БлокИнвентаризация>