BlueGastro exporty do Ekonomických systémov

Typy exportov

• Denný export tržieb – DailyExportBG – xml alebo SOAP webová služba
• Export tržieb podľa fiskálnych uzávierok -svkBowaFiscalTypeClosingsSales – platí pre SVK a fiskál BOWA - SAOP webová služba
• Mesačný export sumáru skladových pohybov - MonthlyExport – mesačný sumár pohybov na jednotlivých skladoch - xml alebo SAOP webová služba
• Skladové doklady – StockTransfers – zoznam vybraných typov pohybových dokladov realizovaných v BlueGastre s ich položkami - xml alebo SAOP webová služba
• Skladové doklady agregované – StockTransfersAgr – len ako xml výstup
• Export tržieb agregovaný podľa denných systémových uzávierok – systemClosingsSales – len SOAP webová služba

Denný export BlueGastro tržieb – DailyExportBG

V dennom exporte sa nachádzajú všetky zaplatené účty v členení podľa uzávierok a pokladní, kde boli vytvorené. Pre každý deň sa generuje samostatné XML. Vstupný parameter (date) predstavuje účtovný dátum uzávierky. Export obsahuje:

• číselníky
• denné účty – členené po uzávierkach a pokladniach
• doklady o úhrade faktúr – včlenené na úroveň denných účtov

Denné účty sú generované v štruktúre:

• hlavička dokladu – obsahuje základná údaje o doklade
• položky dokladu – jednotlivé PLU
• daňová rekapitulácia dokladu
• rekapitulácia platieb dokladu

Hlavička dokladu

• Version – verzia denného exportu, verzia exportu sa zvyšuje pri každej zmene (nezávisle na ostatných exportoch do ekonomiky)
• fileId – názov súboru nesie informáciu o ID systému v hexa tvare a deň za ktorý je dávka vytvorená
• generatedDateTime - dátum kedy bola dávka vytvorená
• sysName="BlueGastro" – vždy BlueGastro
• sysId – inštalačné číslo systému – jedinečný identifikátor
• firm – názov firmy
• department – názov prevádzky
• ID – ICO, alebo iný identifikátor firmy
• versionBlueGastro – verzia BlueGastra v čase exportu
• economyExportVersion - spoločná verzia exportov pre ekonomiku (čísluje sa spoločne pre všetky výstupy do ekonomiky, práve tato verzia sa nastavuje na externom systéme v BlueGastre)
• xsi:noNamespaceSchemaLocation – verzia schémy

Položky dokladu

• cashDailySales - Identifikácia pokladne
  • cashId – Id pokladne
  • closingSales – uzávierka
  • closingSaleId – ID uzávierky pokladne
  • closedAt – dátum a čas vytvorenia uzávierky
• account - Identifikácia účtu
  • account number – číslo účtu
  • date – dátum vystavenia účtu. Pozor dátum vystavenia účtu a dátum uzávierky môžu byť odlišné !!!
  • fiscal – či je to účet fiskálny, alebo nefiskálny
  • annul
  • accountHeader:
    • createdBy – meno účtujúceho
    • totalSum - suma celkom
    • currency - mena v ktorej bol účet vystavený
    • currencyHome – aktuálna mena systému
    • currencyUnit – jednotka meny
    • currencyRate - kurz
  • items - položky účtu
    • PLUId – ID PLU
    • amount - množstvo
    • pricePerUnitExclVAT - jednotková cena bez DPH
    • pricePerUnitInclVAT - jednotkové cena s DPH
    • price – celková cena bez Dph
    • priceInclVat – celková cena s Dph
    • VATRate – sadzba Dph
    • DPTId – ID DPT
    • centreId – ID strediska, do ktorého tržba patrí
    • priceWithDiscountInclVat – celková cena s DPH po zľave

Rekapitulácia DPH a Rekapitulácia spôsobov platieb

resumeVat - Rekapitulácia Dph

• VATRate – sadzba DPH alebo "NON" pre riadok typu "bez DPH
• exclVAT – suma bez DPH , atribut nie je nenaplnený len ak sadzba="NON"
• VAT - DPH ... atribut je nenaplneny len ak sadzba="NON"
• total – suma s Dph

paymentType - Rekapitulácia platieb

• paymentTypeId – ID použitej platby
• sum – sumár za platby na účte

Verzia 1.8

bola doplnená o úhrady faktúr. Nachádza sa v closingSales, sem sa dostanú všetky úhrady ktoré spadajú do rozmedzia dátumov vytvorenia predchádzajúcej a aktuálnej dennej uzávierky.

<fm_invoice id="1" create="2015-10-14T00:30:40.000+02:00" name="FA 01111111" sum="10.00" paymentTypeId="2" currency="EUR" createdBy="kristin"/>

Popis:

• fm_invoice id - interné ID systému BG - jednoznačný identifikátor – keďže obsluha môže zadať do názvu aj niekoľko krát to isté, zapisujeme aj ID
• created - dátum a čas zápisu úhrady
• name - názov resp. číslo FA ktoré zadá obsluha
• sum - suma FA ktoré zadá obsluha
• paymentTypeId - ID platby úhrady - platí ten istý číselník ako pri účtoch
• currency - kód meny
• createdBy - Meno používateľa čo vytvoril úhradu

Číselníky

Číselník typov platieb - paymentsTypes

Popis:

• paymentTypeId – Id platby
• code - kód platby, nemusí byť vyplnený
• name – názov platby
• internal – informácia či sa jedná o internú platbu, t.j. zúčtovanie v rámci
• paymentType – Typ platby môže byť Štandardná, Platba stravnými lístkami a Platba cudzou menou
• currency – pokiaľ je typ platby cudzou menou, uvádza sa aj mena

Pozn. Číselník typov platieb je užívateľsky prístupný, t.j. môže sa líšiť u rôznych zákazníkov.

Číselník pokladní

Popis:

• cash cashId – Id pokladne
• name - názov pokladne
• DKP - DKP je daňový kód pokladne, jednoznačný pre pokladne a udeľuje ho daňový úrad
• fiscalType – typ fiskalizácie
• newDayStartAt – nastavenie, ktorým sa určuje ukončenie účtovného dňa vykonaním systémovej dennej uzávierky. Prednastavené 00:00 znamená o polnoci. Zmenou prednastaveného času na inú hodnotu sa posúva aj ukončenie účtovného dňa v systéme Blue Gastro. Príklad: je nastavený čas 02:00, začiatok predaja je dňa 1.4. o 10:00, systémovú uzávierku vykonám 2.4.2013 o 1:55. Doklady, ktoré boli vystavené po polnoci do 01:55 hod. (resp. do času vykonania uzávierky)budú započítané v systémovej uzávierke do dňa 1.4.2013. Toto nastavenie neovplyvňuje posun účtovného dňa na fiskálnych tlačiarniach - tento je riadený priamo fiskálnym zariadením.

Číselník departmentov – tovarových skupín - DPT

Department identifikuje o aký druh tovaru sa jedná. Je to povinný údaj.

Popis:

• DPTId – ID departmentu
• Name – názov departmentu

Číselník PLU – predajných kódov

Popis:

• PLUId – ID PLU, vytvárané systémom
• code – číslo PLU na pokladni
• name – názov PLU
• DPTId – číslo DPT, do ktorého patrí
• deleted – informácia či je PLU už zmazané
• type – typ PLU
• categoryId - ID kategórie PLU
• categoryName - názov kategórie PLU
• accountingTypeId – ID účtovného druhu, pokiaľ nemá PLU vyplnený tento parameter, v exporte sa vynecháva

Číselník stredísk – centres'

Stredisko reprezentuje sklad, na ktorom sa evidujú stavy zásob.

Popis:

• centre number – číslo skladu, editovateľné užívateľom
• name – názov skladu
• centreId – ID skladu

Číselník účtovných druhov

Číselník účtovných druhov je paralelné triedenie tovarov. Využíva sa pri komunikácii s externými systémami napr. Horcom. Pri prenose tržby z reštauračného systému do hotelového, si tržba so sebou nesie informáciu o účtovnom druhu. Pokiaľ sa účtovný druh nepoužíva, v dennej dávke sa táto časť nenachádza.

Popis:

• accountingTypeId – ID účtovného druhu
• code – kód účtovného druhu
• name – názov účtovného druhu

Mesačný export BlueGastro - MonthlyExport – sumár skladových pohybov

V mesačnom exporte sa nachádza sumarizácia skladových pohybov na všetkých strediskách . Mesačný export obsahuje hlavičku, zvolený typ pohybov a číselníky.

Hlavička economyMonthlyExport

• version – verzia mesačného exportu, verzia exportu sa zvyšuje pri každej zmene (nezávisle na ostatných exportoch do ekonomiky)
• fileId – názov súboru nesie informáciu o ID systému v hexa tvare a mesiac za ktorý je dávka vytvorená
• generatedDateTime - dátum kedy bola dávka vytvorená
• exportMonthYear – mesiac, za ktorý bola dávka vytvorená
• sysName="BlueGastro" – vždy BlueGastro
• sysId – inštalačné číslo systému – jedinečný identifikátor
• firm – názov firmy
• department – názov prevádzky
• ID – ICO, alebo iný identifikátor firmy
• versionBlueGastro – verzia BlueGastra v čase exportu
• currency - mena v ktorej bol účet vystavený
• currencyHome – aktuálna mena systému
• currencyUnit – jednotka meny
• currencyRate - kurz
• economyExportVersion - spoločná verzia exportov pre ekonomiku (čísluje sa spoločne pre všetky výstupy do ekonomiky, práve tato verzia sa nastavuje na externom systéme v BlueGastre)
• xsi:noNamespaceSchemaLocation – verzia schémy

Číselníky

Číselník druhov pohybovPopis:

• transferTypeId – ID pohybu
• name – názov pohybu

Číselník stredísk

Číselník departmentov – tovarových skupín

Číselník účtovných druhov

Číselník typov platieb

Číselník pokladní

Mesačné pohyby na skladoch

Mesačné pohyby na jednotlivých skladoch sú generované podľa viacerých kritérií a je na zákazníkovi, ktorú časť exportu bude využívať.

TransfersCentres

druhu pohybu na stredisku sumárne

• TransfersCentreMonth - Identifikácia strediska
  • centre number – číslo strediska
  • name - názov strediska
  • centreId – ID strediska
• TransferSum – Sumár za pohyb
  • transferTypeId – ID pohybu
  • name - názov pohybu
  • sum - suma pohybu
  • transferDirection - smer pohybu určuje či sa jedná o výdaj(-1) alebo príjem(1) tovaru
  • materialSum - suma za materiál
  • serviceSum- suma za služby

Verzia 1.5

Bola doplnená o detail platný pre doklady číslo 56 a 57, konkrétne rozpočet na základe druhu odbytu. <transferSum> <transferType transferTypeId="57" name="Odbyty z akcií (limity)"/> <sum>-7.8948</sum> <detail> <item saleTypeId="12" purchaserId="1" sum="-7.8948"/> </detail> <transferDirection>-1</transferDirection> </transferSum>

• saleTypeId – druh odbytu, ID z číselníka
• puchaserId – odberateľ, ID z číselníka

TransfersCentresGM

druh pohybu na stredisku v členení podľa departmentov a účtovných druhov.

• TransfersCentreGM - Identifikácia strediska
  • centreId – ID strediska
• Transfer - Druh pohybu
  • transferTypeId – ID pohybu
  • transferDirection - smer pohybu určuje či sa jedná o výdaj(-1) alebo príjem(1) tovaru
• TransferDPT - Druh pohybu v členení podľa DPT
  • DPTId – ID departmentu
  • goodSum - suma za tovar
  • materialSum - suma za materiál
  • serviceSum - suma za služby
• TransfersAccountingTypes - Druh pohybu v členení podľa účtovného druhu
  • accountingTypeId – ID účtovného druhu
  • goodSum - suma za tovar
  • materialSum - suma za materiál
  • serviceSum- suma za služby

Mesačné tržby na skladoch

Rozdelenie mesačných tržieb na strediskách podľa spôsobu platby.

• IncomeCentre - Identifikácia strediska
  • centreId – ID strediska
• IncomeCash - Identifikácia pokladne
  • cashId - ID pokladne
• IncomePaymentType - Identifikácia spôsobu platby
  • paymentTypeId – ID typu platby
  • sum - suma

Pohybové doklady BlueGastro za zvolené obdobie

Existujú dve verzie metód pre stiahnutie zoznamu skladových dokladov:

1. stockTransfers - Tento typ exportu je možné generovať denne, alebo za uzavreté mesiace. Je nutné upozorniť, že všetky doklady za neuzavreté obdobie je možné v BG modifikovať – upravovať množstvá, cenu, tovary a podobne. Takéto doklady by sa mali opätovne vyexportovať a načítať do ekonomiky.Súčasťou dávky budú pohyby, ktoré sú vopred preddefinované.V tomto prípade sa doklady ťahajú podľa ich účtovného dátumu
2. stockTransfers_2 - Metóda, generuje zoznam pohybových dokladov v rovnakej štruktúre ako predchádzajúca verzia. Rozdiel je v tom, že vstupný parameter dátum predstavuje kalendárny dátum zápisu dokladu, pri storne, dátum stornovania. Dátum (string) sa uvádza vo formáte YYYY-MM-DD napr. 2016-04-01

Zmeny vo verzií xsd_0_1_3

Aktuálna štruktúra bola doplnená o číselník druhov odbytov. Zároveň bola doplnená štruktúra hlavičky dokladu TransferDocument o saleTypeId t.j. id druhu odbytu a štruktúra položky nákupného dokladu stDocumentItem o centreId t.j. o stredisko na ktoré sa položka nákupného dokladu presúva.

Popis štruktúr stockTransfers

• version – verzia exportu pohybových dokladov, verzia exportu sa zvyšuje pri každej zmene (nezávisle na ostatných exportoch do ekonomiky)
• fileId – názov súboru nesie informáciu za aké obdobie bola dávka vytvorená
• generatedDateTime - dátum kedy bola dávka vytvorená
• sysName="BlueGastro" – vždy BlueGastro
• sysId – inštalačné číslo systému – jedinečný identifikátor
• firm – názov firmy
• department – názov prevádzky
• ICO – ICO, alebo iný identifikátor firmy
• gastroVersion – verzia BlueGastra v čase exportu
• currency - mena
• economyExportVersion - spoločná verzia exportov pre ekonomiku (čísluje sa spoločne pre všetky výstupy do ekonomiky, práve tato verzia sa nastavuje na externom systéme v BlueGastre)
• xsi:noNamespaceSchemaLocation – verzia schémy

Číselníky

• Číselník stredísk - centres
• Číselník departmentov – tovarových skupín - dpt
• Číselník účtovných druhov - accoutingTypes
• Číselník druhov pohybov - transferTypes
• Číselník tovarov - goods, číselník obsahuje iba tie tovary, ktoré sa nachádzajú vyexportovaných dokladoch. Popis:
  • id - ID tovaru
  • number – číslo tovaru
  • name – názov tovaru
  • idDpt – ID departmentu
  • idAccoutingType – id účtovného druhu
  • externalNumber – externé číslo, predstavuje identifikátor, ktorý zasiela CGD (central goods database)
• Číselník ekonomických objektov- economyObjects - Triedenie tovaru podľa typu z ekonomického pohľadu. Popis:
  • id -ID ekonomického objektu
  • code – kód tovaru
  • name – názov ekonomického objektu: Materiál, Tovar, Služba
• Číselník dodávateľov - supplier - Popis:
  • id -ID dodávateľa
  • name – názov dodávateľa
  • ico - IČO dodávateľa
  • dic – IČ DPH dodávateľa
• Číselník druhov odbytov - Popis:
  • Id – id typu odbytu
  • saleNumber – číslo typu odbytu
  • name – názov typu odbytu

Pohybové doklady

• TransferDocument – Hlavička dokladu
  • id – ID pohybového dokladu
  • transferTypeId – ID druhu pohybu
  • centreId – ID strediska
  • centreNumber – číslo dokladu na stredisku
  • date – dátum vytvorenia
  • userName - meno užívateľa
  • currency - mena v ktorej bol doklad vystavený
  • canceled – T ako true, F ako false
• Items - Položky dokladu
  • order – poradie položky dokladu
  • goodId – ID tovaru
  • ammount – množstvo tovaru
• rateVAT – sadzba Dph
• priceInclVAT – cena s Dph
• priceExclVAT – cena bez Dph
• economyObject – ID ekonomického objektu
• centreId – id strediska z číselníka stredísk, stredisko na ktoré sa položka presúva
• SummmaryVAT - Rekapitulácia Dph
  • rateVAT – sadzba Dph
  • sumExclVat – suma dokladu bez Dph
  • sumVAT - Dph
• SummaryDpt - Rekapitulácia podľa DPT
  • idDpt – ID departmentu
  • economyObject – ID ekonomického objektu
  • sumExclVAT – Suma bez DPH

Popis metódy svkBowaFiscalTypeClosingsSales

Metóda poskytuje tržby kumulované podľa denných fiskálnych uzávierok. Táto metóda garantuje správne výstupy len pri fiskálnych tlačiarňach BOWA. Sumy sú vypočítané z dokladov, ktoré odoslal systém BG pričom sa k dokladu po odoslaní podarilo stiahnuť aj údaje o fiskálnej uzávierke. Tieto údaje nie sú stiahnutá z fiskálnej tlačiarne. Ako vstupný parameter je dátum, pričom v prvom rade ide o prevádzkový dátum fiskálnej tlačiarne, ak nebol stiahnutý s uzávierkou, riadime sa dátumom systémovej uzávierky príslušnej pokladne.

Popis štruktúry

Návratové hodnoty:

• businessDate – prevádzkový (obchodný) deň
• closingSerialNumber – sériové číslo fiskálnej tlačiarne
• created – dátum a čas vytvorenia uzávierky
• dkp – daňový kód pokladne
• fmClosingId – číslo fiskálne uzávierky
• numberOfTheBill - počet účtov spadajúcich do uzávierky
• totalSum – celková suma uzávierky S DPH
• dphRecords – rozpis tržiep po DPH
  • vatRate – sadzba
  • vat – DPH
  • total – suma s DPH
  • base – základ

Popis exportu stockTransfersAgr

Tento výstup je možné získať len ako xml, nie je dostupný cez webové služby. Prakticky ide o totožný výstup ako je stockTransfers z pohľadu logiky jeho generovania. Obsahuje skladové pohybové doklady, no bez jednotlivých položiek.

Hlavička dokumentu

• Version - verzia
• fileId – názov dokumentu
• generated - generované
• system – vždy BlueGastro
• systemId – inštalačné číslo
• firm – názov firmy
• department – názov prevádzky
• ico - IČO
• gastroVersion – verzia BlueGastro
• stockCurrency – domáca mena skladu
• afterClosing – T – je generovaný za uzavretý mesiac, F – neuzavreté obdobie
• dateFrom - dátum obdobia od, formát: 1999-05-31
• dateTo - dátum obdobia do, formát: 1999-05-31

Číselníky

• Číselník stredísk - centres
• Číselník druhov pohybov - transferTypes
• Číselník dodávateľov - supplier - Popis:
  • id -ID dodávateľa
  • name – názov dodávateľa
  • ico - IČO dodávateľa
  • dic – IČ DPH dodávateľa
• Číselník druhov odbytov - Popis:
  • Id – id typu odbytu
  • saleNumber – číslo typu odbytu
  • name – názov typu odbytu

Popis štruktúry dokladu stTransferDocument

• Id – id dokladu
• transferTypuId – id druhu pohybu z číselníka druhov pohybov
• centreId – Id strediska z číselníka stredísk
• centreNumber – číslo dokladu na stredisku
• date – účtovný dátum dokladu
• invoiceNumber – číslo faktúry
• deliveryOrderNumber – číslo dokladu (dodací list)
• userName – používateľ ktorý doklad vytvoril
• note – poznamka na doklad
• discount – zľava na doklad v percentách
• currency – suma dokladu v skladovej mene
• supplierId – id z číselníka dodávateľov
• canceled – príznak stornovaný
• saleTypeId – id z číselníka druhu odbytov
• centreFromId – id strediska – zdrojové stredisko, odkiaľ sa zásoba presúva
• centreFromNumber – číslo dokladu párového dokladu

Popis metódy systemClosingsSales

Metóda poskytuje tržby kumulované podľa denných systémových uzávierok.

Vstupný parameter:

• Dátum (string – (YYYY-MM-DD)) – účtovný dátum systémovej uzávierky

Popis štruktúry

Návratové hodnoty:

• cashdeskNumber – číslo pokladne
• cashdeskName – názov pokladne
• closingNumber – číslo uzávierky
• date – dátum uzávierky
• created – vytvorená
• numberOfAllBills – počet účtov v uzávierke
• totalAmount – suma účtov
• billsSummaries: - sumár
  • billsSummary
    • billType – typ účtu, pričom F je fiskálny, I je interný, E je externý
    • count – počet účtov
    • totalAmount – suma
  • vatRecords
    • Base – základ DPH
    • Total – celkom
    • Vat – DPH
    • vatRate – sadzba DPH

Popis metódy SystemClosingsSales_2

Metóda kumuluje tržby za systémovú dennú uzávierku podobne ako verzia SystemClosingsSales no s inou návratovou štruktúrou.

Vstupný parameter:

• Dátum (string – (YYYY-MM-DD)) – účtovný dátum systémovej uzávierky

Návratová štruktúra:

• cashdeskNumber – číslo pokladne
• cashdeskName – názov pokladne
• closingNumber – číslo uzávierky
• date – dátum uzávierky
• created – vytvorená
• numberOfAllBills – počet účtov v uzávierke
• totalAmount – suma účtov
• saleSummaries:
  • AccountingType – id účtovného druhu
  • CenterID – id skladového strediska
  • VatRate – sadzba DPH
  • SumNoVat – suma bez DPH
  • Vat – suma DPH
  • Sum – suma s DPH
  • PaymentType – názov platby
  • PaymentTypeID – id platby
  • FiskalType – F/E/I – typ platby
  • Currency - mena