Құжаттама/Деректер пішімдері

Әкімшіге

Анықтамалықтар мен бағыттар

Тауарлар, клиенттер, жеке бағалар мен бағыттардың схемалары және олардың байланыстары.

Анықтамалықтар құрылғыға тауарларды, клиенттерді және олармен байланысты деректерді жібереді. Бухгалтерлік есеп жүйесі әр кесте үшін outbox ішінде бөлек XML-файл дайындайды. Жалпы пішім XML-кестелер бетінде сипатталған.

Анықтамалықтардың ортақ өрістері

ref_products және ref_customers үшін келесі өрістер міндетті:

ӨрісТүріМақсаты
codeTEXT KEYТауардың, клиенттің немесе топтың тұрақты коды. Анықтамалық ішінде бірегей.
nameTEXTЭкрандағы атау.
parentTEXT KEYАта-аналық топтың коды; жоғарғы деңгей үшін бос мән.
groupINTEGER0 — элемент, нөлден өзге мән — топ. Мысалдарда топ үшін 1 қолданылады.

parent сол анықтамалықтағы топқа сілтеуі керек. Бос ата-аналық кодтың орнына 0 қолданбаңыз: ол коды 0 болатын топқа сілтейді.

Тауарлар — ref_products

Ортақ өрістерге packaging және price_ префиксі бар кемінде бір баға өрісін қосу керек.

ӨрісТүріМақсаты
packagingREALБір қаптамадағы базалық бірліктер саны. Даналап сатылатын тауар үшін — 1.
price_…REALКоды price_ префиксінен кейін жазылған санаттың бағасы: мысалы, price_Retail.
restREALТауар қалдығы. Қалдықты көрсету немесе қалдық сүзгісінде қолдану қажет болса қосыңыз.
measure_unitTEXTӨлшем бірлігі. Міндетті емес өріс.
weightREALТапсырыс салмағын есептеуге арналған тауардың базалық бірлігінің салмағы. Міндетті емес өріс.
colorINTEGERЖазба мәтінінің түсі. Міндетті емес өріс.

Мысалда G-001 тобы және оның ішіндегі P-001 тауары бар:

<?xml version="1.0" encoding="utf-8"?>
<table name="ref_products">
  <schema>
    <field name="code" type="TEXT KEY"/>
    <field name="name" type="TEXT"/>
    <field name="parent" type="TEXT KEY"/>
    <field name="group" type="INTEGER"/>
    <field name="packaging" type="REAL"/>
    <field name="price_Retail" type="REAL"/>
    <field name="rest" type="REAL"/>
    <field name="measure_unit" type="TEXT"/>
  </schema>
  <data>
    <record>
      <f>G-001</f>
      <f>Сусындар</f>
      <f/>
      <f>1</f>
      <f>1</f>
      <f>0</f>
      <f>0</f>
      <f/>
    </record>
    <record>
      <f>P-001</f>
      <f>Су 1 л</f>
      <f>G-001</f>
      <f>0</f>
      <f>6</f>
      <f>42.5</f>
      <f>120</f>
      <f>дана</f>
    </record>
  </data>
</table>

Осы мысал үшін баға санаттары тізімінде value="Retail" қолданыңыз. vl_cat_prices, price_… өрістерінде және клиент баптауларында бірдей санат кодтарын сақтаңыз.

Клиенттер — ref_customers

Ортақ өрістерге келесілерді қосуға болады:

ӨрісТүріМақсаты
cat_priceTEXTКлиентке қолжетімді баға санаттарының үтір арқылы бөлінген кодтары: Retail,Wholesale.
debtREALКлиенттің жалпы қарызы.
expired_debtREALМерзімі өткен қарыз. Жаңа тапсырыстарға тыйым салу үшін де қолданылады.
photo_requiredINTEGER1 — клиент үшін фото қажет, 0 — қажет емес. Тексеру қосымша баптауларында қосылады.
colorINTEGERЖазба мәтінінің түсі.
<?xml version="1.0" encoding="utf-8"?>
<table name="ref_customers">
  <schema>
    <field name="code" type="TEXT KEY"/>
    <field name="name" type="TEXT"/>
    <field name="parent" type="TEXT KEY"/>
    <field name="group" type="INTEGER"/>
    <field name="cat_price" type="TEXT"/>
    <field name="debt" type="REAL"/>
  </schema>
  <data>
    <record>
      <f>C-001</f>
      <f>«Дүкен» ЖШС</f>
      <f/>
      <f>0</f>
      <f>Retail</f>
      <f>850</f>
    </record>
  </data>
</table>

Мекенжайды, телефонды және басқа деректерді бөлек өрістер ретінде қосуға болады. Олардың атаулары мен кестеде көрсетілуін құрылғыдағы баған баптауларында немесе tables_columns.xml арқылы баптауға болады.

Жеке бағалар — customer_product_data

Кесте клиенттер үшін тауарлардың жеке бағаларын анықтайды. Әр жазба бір клиентті бір тауармен байланыстырады. customer_code және product_code жұбы бірегей болуы керек.

ӨрісТүріМақсаты
customer_codeTEXT KEYref_customers.code коды. Міндетті өріс.
product_codeTEXT KEYref_products.code коды. Міндетті өріс.
priceREALЖеке баға. Нөлден өзге мән санат бағасынан басым болады.
price_multiplierREALНөлден өзге жеке баға болмағандағы санат бағасының көбейткіші. Мысалы, 0.95 бағаны 5%-ға азайтады.
order_countREALАнықтама үшін берілетін алдыңғы тапсырыс саны.
preorder_countREALТауар таңдау кезінде көрсетуге болатын қосымша анықтамалық сан өрісі.

Міндетті емес өрістерді қажет болғанда ғана қосыңыз. Жеке баға бос немесе 0 болса, қосымша нөлден өзге price_multiplier мәнін, ал ол болмаған жағдайда санат бағасын қолданады. Бұл өрістердегі 0 тауарды тегін етпейді.

<?xml version="1.0" encoding="utf-8"?>
<table name="customer_product_data">
  <schema>
    <field name="customer_code" type="TEXT KEY"/>
    <field name="product_code" type="TEXT KEY"/>
    <field name="price" type="REAL"/>
    <field name="order_count" type="REAL"/>
  </schema>
  <data>
    <record>
      <f>C-001</f>
      <f>P-001</f>
      <f>40</f>
      <f>12</f>
    </record>
  </data>
</table>

Бағыттар — routes

Бір жазба клиентке баруды белгілейді. Кестеде customer_code және кемінде бір кестелеу өрісі — date немесе week_day болуы керек.

ӨрісТүріМақсаты
customer_codeTEXT KEYref_customers.code коды.
dateTEXTYYYY-MM-DD пішіміндегі нақты күн, мысалы 2026-11-05.
week_dayINTEGERАпта күні: 1 — дүйсенбі, …, 7 — жексенбі.
trade_point_valueTEXTvl_trade_points.value ішіндегі сауда нүктесінің коды. Міндетті емес өріс.

Схемада date болса, қосымша бағытты сол өріс бойынша таңдайды; бұл жағдайда week_day қолданылмайды. Апталық кесте үшін date өрісін қоспаңыз.

<?xml version="1.0" encoding="utf-8"?>
<table name="routes">
  <schema>
    <field name="customer_code" type="TEXT KEY"/>
    <field name="week_day" type="INTEGER"/>
    <field name="trade_point_value" type="TEXT"/>
  </schema>
  <data>
    <record>
      <f>C-001</f>
      <f>1</f>
      <f>TP-001</f>
    </record>
    <record>
      <f>C-001</f>
      <f>4</f>
      <f>TP-002</f>
    </record>
  </data>
</table>

Мысалда барулар дүйсенбі мен бейсенбіге жоспарланған. Клиент пен сауда нүктелері сол құрылғыға жүктелуі керек.

Байланыстарды тексеру

Алмасудан кейін құрылғыдағы журналды, содан соң деректерді тексеріңіз:

  • топтар ашылады, тауарлар мен клиенттер тиісті деңгейлерде орналасқан;
  • клиенттің баға санаты бар price_… өрісіне сәйкес келеді;
  • жеке баға тек қажетті клиент пен тауар жұбына қолданылады;
  • бағыт таңдалған күндегі клиенттерді және олардың сауда нүктелерін көрсетеді.

Осы кестелердің барлығы стандартты exchange.xml файлының Завантажити дані (Деректерді жүктеу) профилінде көрсетілген.