Списки значень — Документація PalmOrder

На цій сторінці

Списки значень задають категорії цін, типи оплати, типи доставки та торгові точки. Облікова система формує для кожного списку окрему XML-таблицю і розміщує її в outbox.

Спільні поля

Поле	Тип	Призначення
`value`	`TEXT`	Код значення, який використовують довідники й документи.
`presentation`	`TEXT`	Назва, яку бачить користувач.

Обидва поля мають бути у схемі кожного списку. Значення value повинні бути унікальними в межах списку та залишатися сталими під час оновлення даних. Назву в presentation можна змінювати без зміни коду.

Стандартні списки

Таблиця	Призначення	Де використовується `value`
`vl_cat_prices`	Категорії цін.	У суфіксах `price_…` довідника товарів і полі `cat_price` клієнта або документа.
`vl_pay_types`	Типи оплати.	У полі `pay_type` замовлення.
`vl_delivery_types`	Типи доставки.	У полі `delivery_type` замовлення.
`vl_trade_points`	Торгові точки клієнтів.	У полі `trade_point` документа та `trade_point_value` маршруту.

Назва файла відповідає назві таблиці: наприклад, vl_pay_types.xml містить <table name="vl_pay_types">.

Приклад типів оплати

<?xml version="1.0" encoding="utf-8"?>
<table name="vl_pay_types">
  <schema>
    <field name="value" type="TEXT"/>
    <field name="presentation" type="TEXT"/>
  </schema>
  <data>
    <record>
      <f>cash</f>
      <f>Готівка</f>
    </record>
    <record>
      <f>bank</f>
      <f>Безготівкова оплата</f>
    </record>
  </data>
</table>

Якщо користувач вибере «Готівка», у pay_type замовлення буде cash, а не текст із presentation.

Категорії цін

Для категорії з value="Retail" у ref_products має бути поле price_Retail. Назва категорії в presentation може бути українською, наприклад «Роздрібна».

У ref_customers.cat_price передавайте Retail. Якщо клієнту доступні кілька категорій, перелічіть їх через кому без пробілів: Retail,Wholesale. Кожному коду має відповідати поле ціни в довіднику товарів. Використовуйте однакові коди категорій у списку цін, довіднику клієнтів і назвах полів цін товарів.

Структура товарів і клієнтів описана на сторінці Довідники та маршрути.

Торгові точки

vl_trade_points має додаткове обов'язкове поле customer_code типу TEXT. Воно пов'язує торгову точку з ref_customers.code.

<?xml version="1.0" encoding="utf-8"?>
<table name="vl_trade_points">
  <schema>
    <field name="value" type="TEXT"/>
    <field name="presentation" type="TEXT"/>
    <field name="customer_code" type="TEXT KEY"/>
  </schema>
  <data>
    <record>
      <f>TP-001</f>
      <f>Магазин на Центральній</f>
      <f>C-001</f>
    </record>
    <record>
      <f>TP-002</f>
      <f>Магазин на Київській</f>
      <f>C-001</f>
    </record>
  </data>
</table>

У прикладі обидві точки належать клієнту C-001. У документі вибрана точка передається кодом TP-001 або TP-002.

Передавання на пристрій

Додайте потрібні таблиці до <get><dbs> профілю в exchange.xml:

<dbs>
  <db name="vl_cat_prices"/>
  <db name="vl_pay_types"/>
  <db name="vl_delivery_types"/>
  <db name="vl_trade_points"/>
</dbs>

У стандартному exchange.xml ці списки вже входять до профілю Завантажити дані. Після обміну перевірте, що в документах доступні потрібні значення, а торгові точки відповідають вибраному клієнту.