Версия обработки 1.9.1
Подбор автозапчастей, проценка у поставщиков и оформление заказа в 1С.
Снято на конфигурации «Розница 8. Магазин автозапчастей, ред. 3.0» (релиз 3.0.13.357). В других конфигурациях экраны те же, отличаются только поля, которые эта конфигурация называет по-своему — такие места отмечены в тексте.
Обработка FAPI_Кроссы приходит одним файлом .epf. Она внешняя: в конфигурацию её не встраивают, а открывают файлом.
Пользователю, который будет с ней работать, нужно право «Интерактивное открытие внешних отчётов и обработок». Без него 1С откажет ещё до первого экрана:
Право выдаёт администратор в конфигураторе — списком пользователей или ролью. Подробнее — в разделе Частые вопросы.
Кнопка «Сервис и настройки» в правом верхнем углу окна 1С → Файл → Открыть… → выбрать файл FAPI_Кроссы_Розница_Автозапчасти_3.epf.
Быстрее — сочетание Ctrl+O: оно открывает тот же диалог выбора файла.
Откроется рабочий экран продавца — «FAPI v.3»:
Пока настройки не заполнены, поиск работать не будет: обработка не знает ни ключа доступа, ни того, куда класть найденный товар.
Кнопка «Настройки» в верхнем ряду. Настройки хранятся у КАЖДОГО пользователя свои: у второго продавца на этом же компьютере они будут пустыми, их придётся заполнить ещё раз.
Разделы сворачиваются и разворачиваются щелчком по заголовку.
Куда обработка кладёт товар, который вы создаёте из корзины, и по какой цене продаёт.
| Поле | Что означает |
|---|---|
| Группа номенклатуры | группа справочника, в которой будет создан новый товар. Пусто — товар ложится в корень справочника |
| Вид номенклатуры | ⚠️ в этой конфигурации поле предлагает виды цен, а не виды номенклатуры — известная особенность сборки. Оставьте пустым: создание товара из корзины работает и так (проверено) |
| Основная цена продажи | вид цены, по которой товар пойдёт в документ продажи |
| Магазин | структурная единица (склад, подразделение), от лица которой оформляется продажа |
| Поле | Что означает |
|---|---|
| Сервер | адрес каталога FAPI, обычно https://fapi.iisis.ru. Менять не нужно |
| Рейтинг аналогов | порог, ниже которого аналоги не показываются. 0 — показывать все |
| Поле | Что означает |
|---|---|
| Сервер | выбирается из списка. У вас должен стоять «Боевой сервер (fapi.iisis.ru/apg)». Пустой адрес = проценка выключена |
| Подробный лог обмена | включайте только когда разбираетесь с проблемой: лог замедляет работу |
Ключа доступа в настройках нет: он один на каталог и поставщиков, обработка получает его сама при первом запуске и в настройках не показывает. Если ключ перестал подходить, его меняет поддержка.
Номер сборки обработки — его первым спросит поддержка. У выпущенной сборки рядом стоит и дата, когда её собрали.
Кнопка «Удалить ключ доступа...» стирает ключ из базы. Перед этим обработка спрашивает, и ответ по умолчанию — «Нет»: случайный Enter ключ не сотрёт. В вопросе перечислено, что произойдёт:
Вернуть удалённый ключ из обработки нельзя. Если ключ мог попасть к посторонним, сообщите в поддержку: отозвать его может только она.
Кнопка «Настройки поставщиков» открывает список поставщиков — это следующий шаг, раздел 2.
При закрытии формы настроек — кнопкой «Закрыть». Пока форма открыта, изменения живут только на экране: если параллельно открыть список поставщиков, он ещё не будет знать нового сервера. Закройте настройки и возвращайтесь к поставщикам.
⚠️ Не выходите из 1С с открытой формой настроек. Закройте сначала форму — тогда настройки запишутся, — и только потом программу.
Поставщики живут не в 1С, а на сервере проценки APG. Обработка только показывает их и передаёт ваш логин. Поэтому: пока у базы нет ключа доступа (обработка получает его при первом запуске, раздел 1) или не выбран сервер APG, список поставщиков будет пустым.
Открыть: Настройки → Настройки поставщиков.
| Колонка | Что означает |
|---|---|
| Код, Поставщик, Имя в APG | как поставщик называется у нас и как — на сервере |
| Подключён | у вас заведена учётная запись у этого поставщика |
| Логин | логин этой учётной записи |
| Есть пароль / Есть токен | что именно сохранено на сервере. Сами пароль и токен обратно не показываются никогда |
| Включён | опрашивать ли этого поставщика при поиске |
| Кроссы | искать ли у него аналоги, а не только точный артикул |
| Параметры | дополнительные настройки, которых требует именно этот поставщик |
Кнопка «Обновить» перечитывает список с сервера APG. Кнопка «Подключение» — меню команд над выбранной строкой:
| Команда | Что делает |
|---|---|
| Подключить / изменить учётку | открывает карточку учётной записи |
| Включить / отключить | опрашивать этого поставщика или нет |
| Кроссы вкл / выкл | искать ли у него аналоги |
| Бюджет времени | сколько ждать его ответ |
| Квота учётки | потолок обращений в минуту и в сутки |
| Способ обращения | какой «дверью» к нему ходить, если их несколько |
| Проверить учётку | сходить к поставщику и убедиться, что доступ рабочий |
| Удалить подключение | стереть учётку на сервере APG |
Выделите строку поставщика и выберите Подключение → Подключить / изменить учётку. Карточка открывается и просто щелчком по строке.
Заполняются только те поля, которых требует этот поставщик — одному нужен логин с паролем, другому токен, третьему и то и другое. Что именно нужно, объявляет сам поставщик: лишние поля в карточке просто не показываются.
| Поле | Что означает |
|---|---|
| Логин, Пароль | доступ, который поставщик выдал вам для обмена данными. Если не знаете его — спрашивайте своего менеджера у поставщика, мы этих доступов не выдаём |
| Включён | опрашивать ли поставщика. Снимите галку, чтобы временно отключить его, не удаляя учётку |
| Бюджет времени, мс | сколько ждать ответ. 0 — по умолчанию поставщика. Ставьте своё значение, только если поставщик отвечает медленно и тормозит весь поиск |
| Квота, обращений в минуту / в сутки | потолок, который вы сами себе ставите, чтобы не упереться в лимит поставщика. 0 — без потолка |
| Таблица настроек внизу | параметры конкретного поставщика. В колонке «Пояснение» написано, что это такое; «Обязательна» — без чего он не ответит |
Кнопка «Записать» сохраняет учётку на сервере APG.
У части поставщиков несколько «дверей»: разные протоколы или разные площадки под одним именем. Тогда в карточке первым появляется поле способа обращения, и выбрать его надо раньше логина: логин действителен для конкретной двери.
Если такого поля в карточке нет — у этого поставщика вход один, и выбирать нечего.
Выделите строку поставщика → Подключение → Проверить учётку. Обработка сходит к поставщику через APG и вернёт результат. Ошибку — покажет текстом.
Проверять стоит сразу после записи учётки: пустая проценка через неделю — это дороже, чем десять секунд сейчас.
Дальше: кого опрашивать в каждом поиске.
Профиль отвечает на один вопрос: кого опрашивать в этом поиске. Подключённых поставщиков может быть десять, но продавцу на кассе нужны трое быстрых, а при подборе редкой детали — все.
Открыть: Настройки → Настройки поставщиков → вкладка «Профили».
| Колонка | Что означает |
|---|---|
| Рабочий | профиль, который применяется прямо сейчас |
| Профиль | название, его выбирает продавец на основном экране |
| Аналоги | искать ли у этих поставщиков аналоги или только точный артикул |
| Опрашивает | кто входит в профиль |
| Подключено | сколько из них реально подключено. 1 из 3 значит, что двое в профиле есть, а учётной записи у них нет — и они молчат |
Кнопки: Создать, Изменить, Удалить, Сделать рабочим.
Состав отмечается галками по списку подключений — набирать имена руками не нужно. Отдельным флагом задаётся «опрашивать всех»: такой профиль автоматически включает нового поставщика, как только его подключат, и его не надо переделывать после каждого подключения.
На основном экране, поле «Поставщики» рядом с полем артикула:
По умолчанию там «все подключённые». Рядом с названием профиля показано, сколько его участников подключено — быстрый (1 из 1). Выбранный профиль действует до следующего переключения.
Смысл в скорости: полный опрос всех поставщиков занимает секунды, и когда за прилавком очередь, это заметно. Узкий профиль отвечает быстрее.
Цена, которую продавец видит в колонке «Выход», — это цена поставщика («Вход») плюс наценка. Наценку считает сервер APG, а не 1С: правила живут на сервере и общие для всех рабочих мест магазина.
Открыть: Настройки → Настройки поставщиков → вкладка «Наценка».
| Колонка | Что означает |
|---|---|
| Место | порядок просмотра. Правила читаются сверху вниз, побеждает первое подошедшее |
| Условие | при каких обстоятельствах правило работает |
| Код поставщика | только для этого поставщика. Пусто — любой |
| Бренд | только для этого бренда. Пусто — любой |
| Закупка от ₽ / Закупка до ₽ | диапазон закупочной цены; обе границы включаются |
| Наценка, % | процент к цене закупки. Отрицательный процент — скидка |
| Надбавка, ₽ | фиксированная сумма, которая начисляется после процента |
Условия соединяются по И: правило с поставщиком и брендом сработает только там, где совпало и то и другое. Правило вообще без условий — «на всё остальное».
Считается так: цена закупки → плюс процент → плюс надбавка. Порядок важен: «+20 % и ещё 150 ₽» и «+150 ₽ и ещё 20 %» дают разные суммы, продукт делает первое.
Бренд сверяется через справочник производителей FAPI, а не буквально: правило на HYUNDAI/KIA поймает и MOBIS. Одно исключение — аналоги поблажки не получают: аналог судится по своему собственному бренду.
Кнопки: Записать правило сохраняет строку на сервере, Переставить меняет порядок (а значит и то, какое правило сработает первым), Удалить правило, Обновить — перечитать правила с сервера.
Дешёвая мелочёвка обычно требует большего процента, чем дорогой узел, — поэтому правила и делят по диапазону закупки. Типичный набор: одно общее правило на все закупки и несколько частных — на дорогие позиции, на конкретного поставщика, на бренд.
Порядок важнее содержания: если общее правило стоит первым, до частных дело не дойдёт никогда.
Основной экран — «FAPI v.3». Он делится на четыре части: поиск справа вверху, проценка слева вверху, корзина слева внизу, карточка детали справа внизу.
Вкладка «Выбор бренда», поле «Арт:» — введите артикул и нажмите «Найти».
Артикул можно вводить как угодно: w753, W 75/3, W-753 — обработка сама приводит его к единому виду. Регистр и разделители значения не имеют.
Приходит список брендов, у которых есть деталь с таким артикулом. Один и тот же номер у разных производителей — это разные детали, поэтому бренд выбираете вы, а не программа.
Поле «Поставщики» рядом задаёт, у кого спрашивать: «все подключённые» или один из сохранённых профилей опроса.
Кнопка с часами справа — история: последние запросы, чтобы вернуться к ним не набирая заново.
Иногда внизу появляется сообщение вида «Скрыто строк: N — бренд не сопоставлен со справочником FAPI, и APG деталь не опознал». Это значит, что предложение пришло, но опознать деталь не удалось ни по каталогу, ни по данным поставщика — такие строки прячутся, чтобы не путать.
Щёлкните нужный бренд — обработка опросит поставщиков и заполнит таблицу слева.
| Колонка | Что означает |
|---|---|
| Бренд, Артикул | что за деталь предлагают |
| Описание | название детали так, как его пишет поставщик |
| Количество | сколько есть у поставщика |
| Вход | цена поставщика |
| Выход | ваша цена продажи — её считает сервер по правилам наценки |
| Поставщик / склад | у кого и с какого склада |
| Срок | за сколько дней приедет |
Число найденных строк показано сверху: «Строк: 4575».
Поле «Отбор» сверху — сохранённый набор условий, профиль отбора. Рядом — быстрые условия, которые можно включить прямо сейчас:
Сортировка собрана в одно подменю «Сортировка» над таблицей. Выбранный пункт отмечен, а в заголовке подменю написан текущий порядок — например, «Сортировка: дешевле»:
Любой пункт сортирует внутри группы: своё наличие остаётся сверху, под ним — чужие предложения в выбранном порядке. Если в табло отсортировать кликом по шапке, заголовок подменю покажет «Сортировка: вручную».
Кнопка «Сбросить» рядом с подменю снимает все условия сразу.
Кнопка «Табло» переключает вид таблицы — раздел 8.
Справа внизу — то, что известно о выбранной детали.
Если продавцу нужно свериться «та ли это деталь» — сверяются здесь, до того как класть в корзину.
Дальше: корзина и заказ.
Нужной детали нет в наличии или она дорогая — значит, нужен аналог. Аналоги показываются там же, где характеристики: справа внизу, вкладка «Аналоги».
Корень — бренд, который вы выбрали. Внутри — бренды, у которых есть заменитель этой детали: 1A FIRST AUTOMOTIVE, 888, A-GRESSOR, A.L. FILTER, ABSEL, AC DELCO… Ветка раскрывается значком +, внутри — артикулы этого бренда.
Дерево строится из каталога кроссов FAPI: это не «похожие товары», а объявленные взаимозаменяемости.
Насколько глубоко показывать аналоги, задаёт «Рейтинг аналогов» в настройках: чем выше порог, тем меньше сомнительных замен попадёт в дерево. 0 — показывать все.
Голосование и есть то, чем каталог кроссов чинится. Если аналог заведомо не подходит — отметьте его неверным, и следующему продавцу он уже не помешает.
Один и тот же номер разные производители ставят на разные детали. Поэтому поиск по артикулу сначала спрашивает бренд, а уже потом идёт к поставщикам. Если бренд выбран неверно — в проценке окажется не та деталь, и никакой фильтр этого не исправит.
Второй способ найти деталь: не от артикула, а от машины. Нужен, когда клиент говорит «Тойота Аурис 2008, масляный фильтр», а номера детали нет ни у кого.
Открывается кнопкой «Каталог» на основном экране.
Экран делится на две вкладки: «Автомобиль» — определяем машину, «Автозапчасти» — выбираем узел и деталь. Пока машина не определена, вторая вкладка пуста.
Марки перечислены слева, список длинный. Над ним поле фильтра: наберите в нём первую букву марки — список перескочит к ней.
Марку нужно выбрать: двойной щелчок или Enter. Одиночный щелчок только подсвечивает строку и ничего не загружает.
После выбора марки в средней таблице появляются модели с годами выпуска. Модель раскрывается в модификации — двигатели, приводы, мощность в кВт:
Справа внизу показывается фотография выбранной машины — заодно и проверка, что это она.
Модификацию тоже нужно выбрать двойным щелчком или Enter. Именно модификация, а не модель: у 1.4 и 2.0 фильтры разные.
Вкладка «Автозапчасти» откроется сама. Слева — дерево узлов именно этой машины: Кузов, Двигатель, Система выпуска ОГ, Фильтр, Тормозная система, Подвеска и так далее. Раскройте узел и выберите деталь:
Выбранная позиция попадает в таблицу «Деталь / Артикул» посередине. Дальше всё как в поиске по артикулу: характеристики и аналоги справа, проценка поставщиков внизу, кнопка «Создать заказ».
Поле «Арт:» над таблицей деталей и кнопка «Расширенный поиск» позволяют сузить выдачу, не возвращаясь к дереву.
Справа вверху вкладки «Автомобиль» — поле VIN. По нему машина определяется точнее, чем по марке и модели: снимается вопрос о комплектации и годе.
Каталог и основной экран — два входа в один и тот же поиск, и это сделано намеренно: кто-то работает от артикула, кто-то от машины. Правильного ответа нет, работайте где удобнее.
Три вещи, которые экономят продавцу время на каждом втором запросе.
Поле «Отбор» в левом верхнем углу основного экрана — сохранённый набор условий и сортировки. На снимках это Своё наличие, затем дешёвое: сначала то, что уже лежит на складе, потом чужое по возрастанию цены.
Не путайте с профилем опроса: профиль опроса решает, у кого спрашивать, профиль отбора — что показать из отвеченного.
Список профилей открывается кнопкой справа от поля «Отбор» (значок открытия, рядом со стрелкой выбора).
У профиля три части: название, условие (то, что в запросе идёт после «ГДЕ») и порядок (то, что после «УПОРЯДОЧИТЬ ПО»). Пишутся они на языке запросов 1С по коротким именам колонок подбора:
| Колонка подбора | Имя в условии |
|---|---|
| Своё наличие | o |
| Бренд | mfd |
| Артикул | n |
| Описание | dt |
| Поставщик / склад | pr |
| Количество | q |
| Цена поставщика | p |
| Цена продажи | p1 |
| Срок поставки, дней | dpd |
| Кратность | mo |
Пример условия прямо из подсказки формы: o = 1 И p1 <= 1000 — только своё наличие и только дешевле тысячи.
Кнопки: Добавить заводит профиль, стрелки ↑↓ меняют порядок в списке, Записать сохраняет, Вернуть умолчание возвращает исходный набор профилей.
Кнопка «Табло» переключает проценку из плоского списка в сгруппированный вид.
Сверху — указатель производителей: все бренды, которые нашлись по запросу. Ниже — сами предложения, собранные по брендам, а в конце отдельным блоком «Аналоги».
Список удобнее, когда нужна самая дешёвая строка. Табло удобнее, когда нужно окинуть взглядом, кто вообще делает эту деталь. Кнопка при включённом табло называется «Списком» и возвращает обратно.
Кнопка с часами справа от «Найти».
Первое нажатие показывает список прошлых запросов: бренд, артикул, деталь. Повторное нажатие возвращает найденные по ним детали.
Это то, ради чего не надо набирать артикул заново, когда клиент вернулся к позиции, которую смотрели пять минут назад.
Двойной щелчок по строке проценки — строка уходит в корзину, панель внизу слева.
| Колонка | Что означает |
|---|---|
| Бренд, Артикул, Описание | что кладём |
| Номенклатура | ссылка на товар в справочнике 1С. Пусто — такого товара у вас ещё нет |
| Количество | сколько. Правится прямо в корзине |
| Выход | цена продажи за единицу |
| Сумма | количество × выход |
Строк в корзине может быть сколько угодно и из разных поисков: корзина не сбрасывается, когда вы ищете следующую деталь.
Пока в колонке «Номенклатура» пусто, продавать нечего: документу нужна ссылка на справочник. Кнопка «Создать номенклатуру» заводит товар по данным поставщика.
Обработка сначала ищет товар в справочнике по бренду и артикулу и спрашивает, только если не нашла. Ответ «Да» создаёт товар: артикул, наименование, производитель, единица измерения; группа — та, что указана в настройках.
Найденный или созданный товар подставляется в колонку «Номенклатура».
Кнопка «Создать заказ» — из корзины получается документ «Заказ покупателя».
Строки, количество и цены переносятся из корзины. Дальше документ обычный, 1С-овский: укажите покупателя, при необходимости дату отгрузки и оплаты, и проведите его кнопкой «Провести и закрыть».
Незаполненный покупатель — единственное, что придётся добавить руками: обработка не знает, кому вы продаёте.
У пользователя нет права «Интерактивное открытие внешних отчётов и обработок». Это настройка 1С, а не обработки: её выдаёт администратор в конфигураторе — пользователю ИБ или роли, в которую он входит.
Право начинает действовать со следующего входа в программу: выдали — перезайдите.
Проверяйте по порядку, сверху вниз — каждый следующий пункт имеет смысл только если предыдущий в порядке.
N из M — сколько участников профиля реально подключены.Сообщение приходит на каждое обращение к APG — поэтому их несколько — и выглядит так: «APG не принял ключ доступа этой базы: API-ключ не открывает этот сервис (ответ 403, ключ …, GET /api/v1/suppliers, идентификатор запроса …). Ключ один на каталог и поставщиков, в обработке он не меняется — обратитесь в поддержку».
Ключ в сообщении показан маской — первые и последние знаки, — по ней поддержка поймёт, какой ключ у базы. Идентификатор запроса нужен ей же: по нему запрос находится в журнале сервера. Пересылайте сообщение целиком. На снимке маска ключа скрыта.
Ключ у базы есть, но сервер APG его не признал. Ключ один на каталог и поставщиков, и в обработке он не меняется — поля ключа в настройках нет. Две частые причины:
Если раздел настроек свёрнут, кнопки внутри него для 1С «невидимы» и не работают. Разверните раздел щелчком по заголовку.
Один и тот же артикул разные производители ставят на разные детали. Проверьте, что выбран правильный бренд в списке слева: поиск идёт по паре «артикул + бренд», и ошибка в бренде даёт чужую деталь с правильным номером.
Сверяйтесь с вкладкой «Характеристики» и фотографией — они относятся к выбранной детали.
Предложение от поставщика пришло, но опознать деталь не удалось ни по каталогу FAPI, ни по данным поставщика. Такие строки прячутся намеренно: показать их значило бы выдать за проценку то, про что неизвестно, та ли это деталь.
Это не ошибка и чинить её на своей стороне нечем.
Так и должно быть: настройки обработки хранятся у каждого пользователя свои. Новый продавец на том же компьютере заполняет их заново — кроме тех, что живут на сервере APG (поставщики, профили опроса, правила наценок): эти общие.
Полный текст: «Нет номенклатуры у строк: JSI JSM142. Создайте её кнопкой "Создать номенклатуру" в корзине — иначе в заказ уедет пустая строка».
Строка в корзине не связана с товаром в справочнике 1С, а документу нужна именно ссылка на справочник. Нажмите «Создать номенклатуру» в корзине — обработка найдёт товар или заведёт новый, — и повторите «Создать заказ».
Сообщение называет конкретные строки: бренд и артикул. Если их несколько — номенклатура нужна каждой.
Строки переносятся из корзины не мгновенно — иногда окно документа успевает открыться раньше. Подождите секунду, они появятся.