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

Әкімшіге

Құжат схемалары

Тапсырыс, төлем, стор-чек пен қарыз өрістері және бас бөліктер мен жолдардың байланыстары.

Тапсырыстарды, төлемдерді және стор-чектерді мобильді қосымша жасайды. Ол таңдалған өрістерді алмасу профилі арқылы жібереді, ал бухгалтерлік есеп жүйесі XML-құжаттарды inbox ішінен алады. Қарыздар кері бағытта — бухгалтерлік есеп жүйесінен құрылғыға жіберіледі.

Құжат кестелері

ҚұжатБас бөлігіКестелік бөлігіБағыты
Тапсырысdoc_ordersdoc_orders_productsҚұрылғы → бухгалтерлік есеп жүйесі; стандартты профильдегі атауы — order.
Төлемdoc_invoicesЖоқ.Құрылғы → бухгалтерлік есеп жүйесі; стандартты профильдегі атауы — invoice.
Стор-чекdoc_storechecksdoc_storechecks_productsҚұрылғы → бухгалтерлік есеп жүйесі; стандартты профильдегі атауы — storecheck.
Қарызdoc_debtsdoc_debts_productsБухгалтерлік есеп жүйесі → құрылғы.

Бұл бет қосымша кестелерінің өрістерін сипаттайды. Шығыс XML-ге кіретін өрістер exchange.xml файлында бөлек беріледі. Олардың жиыны толық схемадан аз болуы мүмкін.

Бас бөліктің ортақ өрістері

ӨрісТүріМақсаты
numberTEXTҚұжат нөмірі.
date_timeINT64Құжаттың күні мен уақыты: 1970-01-01T00:00:00Z мезетінен бастап өткен миллисекундтар саны.
save_date_timeINT64Сол пішімдегі сақтау күні мен уақыты.
customer_codeTEXTref_customers.code ішіндегі клиент коды.
customer_nameTEXTҚұжатта сақталған клиент атауы.
infoTEXTТүсініктеме.

Тапсырыстарда, төлемдерде және стор-чектерде қосымша мыналар бар:

ӨрісТүріМақсаты
send_statusINTEGERЖіберу күйі. Стандартты профильде 0 — жіберілмеген, 1 — жіберілген.
latitude, longitudeREALҚолжетімді болса, қосымша тіркеген координаттар.

Бос координаттар пішім қатесі емес. Олардың болуы орналасқан жерді анықтау рұқсаттары мен баптауларына байланысты.

Тапсырыстар

Бас бөлігі — doc_orders

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

ӨрісТүріМақсаты
trade_pointTEXTvl_trade_points.value ішіндегі сауда нүктесінің коды.
cat_priceTEXTБаға санатының коды.
pay_typeTEXTТөлем түрінің коды.
deliveryINT64Unix дәуірінің басынан бастап миллисекундпен берілген жеткізу күні.
delivery_typeTEXTЖеткізу түрінің коды.
sum_no_discountREALЖеңілдікке дейінгі сома.
discountREALҚұжатқа берілген жеңілдік сомасы.
sumREALЖеңілдіктен кейінгі қорытынды сома.
weightREALТауар салмақтары берілген болса, олардың жалпы салмағы.

Жолдар — doc_orders_products

ӨрісТүріМақсаты
doc_idINTEGERҚұрылғыдағы тапсырыстың бас бөлігімен байланыс.
numINTEGERЖол нөмірі.
codeTEXTref_products.code ішіндегі тауар коды.
nameTEXTҚұжаттағы тауар атауы.
countREALЕнгізілген сан.
koefREALБір енгізілген бірліктегі базалық бірліктер саны. Даналап таңдағанда — 1.
priceREALЖеңілдікке дейінгі базалық бірліктің бағасы.
price_discountREALЖеңілдіктен кейінгі базалық бірліктің бағасы.
sum_no_discountREALЖеңілдікке дейінгі жол сомасы: count × koef × price, ақшалай дәлдікке дейін дөңгелектеледі.
discountREALЖолға берілген жеңілдік сомасы.
sumREALЖеңілдіктен кейінгі жол сомасы.
weightREALЖолдағы тауардың жалпы салмағы.

Баға 42.5, сан 2, коэффициент 1 және жеңілдік 5 болса, жеңілдікке дейінгі сома 85, ал кейінгі сома 80 болады. Мұндағы discount — пайыз емес, ақшалай сома.

Төлем — doc_invoices

Ортақ өрістерден бөлек, төлемде REAL түріндегі sum — төлем сомасы және TEXT түріндегі base_doc — таңдалған негіз құжаттың нөмірі бар.

Алмасу профиліндегі invoice атауы төлемге сәйкес келеді. Стандартты профильде оны payment деп ауыстырмаңыз: бухгалтерлік есеп жүйесі нақты <docs name="invoice"> мәнін тануы керек.

Төлемде кестелік бөлік жоқ.

Стор-чек

doc_storechecks бас бөліктің ортақ өрістерін және TEXT түріндегі trade_point — сауда нүктесінің кодын қамтиды.

Жолдар doc_storechecks_products ішінде сақталады:

ӨрісТүріМақсаты
doc_idINTEGERҚұрылғыдағы стор-чектің бас бөлігімен байланыс.
numINTEGERЖол нөмірі.
codeTEXTТауар коды.
nameTEXTТауар атауы.
priceREALТіркелген баға.
countREALТіркелген сан.

Қарыздар

Бухгалтерлік есеп жүйесі doc_debts.xml және doc_debts_products.xml дайындайды. Стандартты exchange.xml файлында екі кесте де Завантажити дані (Деректерді жүктеу) профиліне кіреді.

Бас бөлігі — doc_debts

Схемада number, date_time, save_date_time, customer_code, customer_name, info ортақ өрістері және келесілер болуы керек:

ӨрісТүріМақсаты
sumREALҚұжат сомасы.
trade_pointTEXTСауда нүктесінің коды.
cat_priceTEXTБаға санатының коды.
pay_typeTEXTТөлем түрінің коды.
deliveryINT64Unix дәуірінің басынан бастап миллисекундпен берілген жеткізу күні.
delivery_typeTEXTЖеткізу түрінің коды.

Қажет болса, REAL түріндегі debt — құжат бойынша ағымдағы қарызды қосыңыз. Өріс қолданылмаса, құжат сомасы sum ішінде қалады.

Жолдар — doc_debts_products

Схема INTEGER түріндегі doc_id және num, TEXT түріндегі code және name, сондай-ақ REAL түріндегі price, count, koef, discount және sum өрістерін қамтиды.

doc_id құрылғыдағы doc_debts бас бөлігінің идентификаторына сәйкес келуі керек. XML-ге шығару кезінде бас бөліктердің идентификаторлары жазбалар ретіне сәйкес келеді: бірінші <record> — 1, екіншісі — 2 және әрі қарай. Сондықтан бірінші қарыздың жолдарында doc_id=1 болады.

Екі файлды бір келісілген жиын ретінде дайындап, бірге жіберіңіз. Бас бөліктердің ретін өзгертсеңіз, жолдардағы doc_id мәндерін қайта есептеңіз. Бірінші id немесе _id өрісіндегі бухгалтерлік есеп жүйесінің коды бұл нөмірлеуді ауыстырмайды.

Келісілген жиын мысалы: doc_debts.xml және doc_debts_products.xml. Онда C-001 клиентінің екі қарызы және әрқайсысында P-001 тауарының бір жолы бар. doc_id=1 жолы РН-001 құжатына, ал doc_id=2 жолы РН-002 құжатына тиесілі. Клиент пен тауар Анықтамалықтар мен бағыттар бетіндегі мысалдарға сәйкес келеді.

Бухгалтерлік есеп жүйесіне не жіберу керек

Интегратор бас бөлік өрістерін <docHead>, ал жол өрістерін <docTable> ішінде таңдайды. Мысалы, бухгалтерлік есеп жүйесі жолдың жеңілдігі мен қорытынды сомасын алуы үшін тапсырыстың бар <docTable> бөлігіне мына өрістерді қосыңыз:

<docTable tableName="doc_orders_products">
  <!-- Кестелік бөліктің басқа өрістері -->
  <field name="discount"/>
  <field name="sum"/>
</docTable>

Шығыс XML-де жолдар мен бас бөліктің байланысы ішкі құрылыммен беріледі: <row> элементтері өз <doc> ішінде орналасады. Тек осы байланысты қалпына келтіру үшін doc_id жіберу қажет емес.

Импорт ережелері мен қайталаудан қорғау Құрылғыдан келетін құжаттар бетінде сипатталған.