Skip to content

Search is only available in production builds. Try building and previewing the site to test it out locally.

Data Models

This reference documents the data models used by the Mando API. Models are auto-generated from the model definitions.

Generated: 2026-02-09T12:43:30+02:00 Total Models: 431 Total Enums: 83


company_type

flowposmandomando_minirootreseller

stock_value_type

manualaveragelastfifo

invdiff_report

noneif_availablemandatory

additional_field_type

textnumberamounttextareadatedatetimeselectionmultiselectcheckboxmeasurementimage

companytree_type

companylocationpos

token_type

Customer identification token type

BARCODE - BarcodeQR - QR CodeNFC - NFC TagOTHER - OtherNYX - NYX Card

customer_type

Customer account type

private - Private Customercompany - Business Customer

customer_invoice_type

Customer invoicing preference

single - Single Invoice per Receiptsingle_automatic - Automatic Single Invoiceconsolidated_manual - Manual Consolidated Invoiceconsolidated_weekly - Weekly Consolidated Invoiceconsolidated_monthly - Monthly Consolidated Invoicenone - No Invoicing

send_type

manualfinvoice_xmlnetvisorprocountorfennoaapix

receipts_and_products

allreceipts_onlyproducts_grouped

payment_terms

immediate57101421283035456090

eft_mode

EFT payment terminal integration mode

Dummy - Ei maksupäätettäBaxi - Nets VikingBaxiBT - Nets Viking (Bluetooth)BaxiCloud - Nets Connect@CloudVerifone - Verifone TerminalVerifoneTcp - Verifone TCP/IPVerifoneSelfService - Verifone Self ServiceEPay2Evented - Seitatech EPay2Softpay - Softpay TerminalPoynt - Poynt/Nets MobilePoplaIP - Popla IP TerminalPoplaBT - Popla BluetoothPoplaCloud - Popla Cloud ServiceNpay1 - Npay (Mando tuotantopäätteet)Npay2 - Npay (Mando testipäätteet)Npay3 - Npay (Kassapolar)Npay4 - Npay (Tammerdata)Npay5 - Npay (Suomen ATK-Maahantuonti)Npay6 - Npay (Kassa- ja Toimistohuolto Häme)Npay - Npay Terminal (älä käytä)

customerdisplay_type

Customer display integration type

NONE - No DisplayTEXT - Text DisplayWEB - GraafinenWEB2 - Graafinen aina näkyvissä (ACT)GFX - Graphics Display (ei käytössä)

printer_control

Printer control protocol/driver type

A8 - Posbank A8ESCPOS - ESC/POS StandardSTAR - Star TSPCITIZEN - CitizenEPSON - Epson TM-T88CBM1000BAXI - Payment Terminal PrinterVF - Verifone PrinterA8_GFX - Posbank A8 GraphicsNETS_GFX - Payment Terminal GraphicsBROTHER_GFX - Brother QL GraphicsBROTHER_GFX_BW - Brother QL Graphics B/WSUNMI - SunMiSUNMI_GFX - SunMi GraphicsWIN - Windows PrinterCASTLES - Castles Terminal Printer

scale_type

Connected scale/weighing device type

NONE - No ScaleDIBAL - Dibal Scale

betting_type

Type of betting terminal integration

NONE - NoneOIVA - OivaEKI - Eki

pos2_login_type

POS 2026 login type

none - Ei kirjautumistalist - Valikkopin - PINnumber - Valikkonumber_and_pin - Numero ja PIN

postype_type

POS terminal platform type

flowpos - FlowPOS Windowscastles-pat - Castles Pay-at-Tablecastles - Castles Terminalcastles-pp - Castles Payment Pointcastles-upt - Castles UPT Terminalandroid - Android POSpos2 - POS 2026printer - Kuittikirjoitinkds - Keittiönäyttöorderdisplay - Tilausnäyttö

pos_network_type

standalonehostmobileselfservice

discount_order

Hinnan järjestys alennuksessa

PRICE_ASC - Alaspäin hinnan mukaanPRICE_DESC - Ylöspäin hinnan mukaan

discount_line_type

Alennusrivin tyyppi

PRICE - Uusi hintaAMOUNT - €-AlennusPERCENT - %-AlennusRECEIPT - Kuitti

invoicing_subscription_type

Laskutuksen tilaustyyppi

DISCOUNT_AMOUNT - AlennusmääräAMOUNT - SummaPERCENT - Prosentti

discount_pricetype

Alennuksen hintatyyppi

DISCOUNT_AMOUNT - AlennusmääräAMOUNT - SummaPERCENT - Prosentti

discount_type

Alennustyyppi

PLU_PCT_DISC - % Alennus tuotteestaTOTAL_PCT_DISC - % Alennus loppusummastaPLU_EUR_DISC - € Alennus tuotteestaTOTAL_EUR_DISC - € Alennus loppusummastaSET_PRICE - Uusi hinta tuotteelleMIXNMATCH - Mix'n'MatchBUNDLE - Niputus

subscription_type

Alennuksen tilaustapa

ALWAYS - AinaSUBSCRIBE - Valinnainen: PysyväCAMPAIGN - Valinnainen: Kampanja

discount_target

Alennuksen kohde

PLU - TuoteRECEIPT - KuittiTENDER - MaksutapaCUSTOMER - AsiakasCUSTOMERGROUP - Asiakasryhmä

external_status

Type of betting terminal integration

COMPLETE - Request completed successfullySENT_AND_REMOVED - Request sent but replaced with new oneSENT - Request sent successfullyHOLD - Request is on holdERROR - Error occurred during request

customerdisplay_element_type

EMPTYIMAGETEXTIMAGE_TEXT

customerdisplay_effect_type

NONEZOOMEXPLODE

customerdisplay_transition_type

NONEDISSOLVEFADESCROLL_LEFTRANDOM

customerdisplay_layout_type

FULLSCREENSPLIT_VERTICALSPLIT_HORIZONTAL

layout_page_layout_type

MASTERPAGEDPT_SELECTDPTSUBTOTALDISCOUNTPLUNORMAL

layout_background_type

NONEDEFAULTIMAGEIMAGE_REPEATIMAGE_COVER

layout_page_button_type

NORMALLEFT_RIGHTTOP_BOTTOMFREEFORM

pricegroup_type

basepricepricediscountpercentpurchaseprice

salestarget_type

TOTAL_SALES_AMOUNTAVG_SALES_AMOUNTTOTAL_CUSTOMERS_QTYPRODUCT_SALES_QTYDISCOUNT_SALES_QTY

plu_selection_type

OPEN_MENUCHANGE_PLUCHANGE_PRICECHANGE_PRICE_LEVELAPPLY_DISCOUNTCHANGE_QTYADD_MODIFIERREMOVE_MODIFIER

plu_selection_ui

TOGGLE_SELECTEDTOGGLE_UNSELECTEDTOGGLEBUTTON

pricing_type

BASE_PRICEPRICEAMOUNTPERCENT

unit_type

weightliquidpcslengthtime

refprice_type

weightliquid

time_units

SECMIN15MIN30MINHOURDAY

trend_direction

Sales trend direction

up - Sales increasingdown - Sales decreasingneutral - No significant change

menu_data_item_type

HIDDENPOPUPLISTFOLDABLELAYOUTPICKER

menu_data_choice_type

SINGLEWIZARDUPSELLCROSSSELL

stockevent_type

INVENTORYDELIVERYWASTAGETRANSFERUSAGEDAILY_TOTALS

stockevent_status

COMPLETECALCULATEDACTIVEWAITINGSTARTEDIN_TRANSFER

infocode_type

SELL_PRODUCTSELL_DPTSELL_GRPRECEIPT_STARTRECEIPT_ENDSUBTOTALRECEIPT_TRASHRECEIPT_REFUNDREFUNDOPEN_PRICESCHEDULEDRECEIPT_COMMENTTENDEREXTERNAL_PRODUCTEXTERNAL_PAYMENTEXTERNAL_DISCOUNT

infocode_input_type

textfunctionlisttextdatenumericproductcustomerstafffunctionbuttonsagelimitbuttonsandother

infocode_validation_type

minlenmaxlenminvalmaxvalrequired

infocode_printing_type

printpromptprintinputprinttype

tender_type

Maksutavan tyyppi

cash - Käteinencard - Korttimaksucard_selfservice - Korttimaksu itsepalvelulunchvoucher - Lounassetelivoucher - Lounasseteliepassi - ePassieazybreak - Eazybreakmobilepay - MobilePaymobilepay_selfservice - MobilePay itsepalveluprepaid - Etukäteen maksettuinvoice - Laskutusonly_invoice - Siirto laskulle, ei myyntiäother - Muu velkagiftcard - Lahjakortti

printout_type

Tulostustyyppi

receipt - Kuittino_receipt - Ei kuittiabill - Tositeinvoice - Lasku

tender_use

Maksutavan rajoitus

multiple - Monta maksua kuitillasingle - Vain yksi maksu per kuittionly_this - Ainoa maksutapa

cashdrawer_open

Kassalaatikon avaus

ignore - Ei vaikutustaforce_open - Avaa ainaforce_close - Älä avaa

change_type

Vaihtorahatyyppi

none - Eitender - Anna vaihtorahaaoverpay - Ylijäämäkäsittely

lunchvoucher_type

Lounassetelin tyyppi

none - Eiedenred - Edenred Setelismartum - Smartum Seteligeneric - Yleineneazybreak - Eazybreakedenred_mobile - Edenred Mobiilismartum_mobile - Smartum Mobiili

delivery_type

TAKE_OUTEAT_IN

card_payment_type

eftmobilepaymobilepay_refund

tender_line_type

TENDERCHANGEVOID

pos_action_name

OPEN_DRAWERPRINT_RECEIPTEMAIL_RECEIPTSMS_RECEIPTKITCHEN_PRINT

receipt_origin_type

split

receipt_type

SALESCASH_DROPCLOSE_DAYOPEN_DAYPAID_OUTRECEIVED_ON_ACCOUNTCASHIER_LOGINCASHIER_LOGOUTNO_SALESETTLEMENTPURCHASE_ORDERDELIVERYWASTAGE

receipt_status

voidedvoiding

tendersales_type

TENDER - Tender paymentCHANGE - Change givenVOID - Voided tender

invoice_language

fisven

invoice_receipts_type

allreceipts_onlyproducts_grouped

invoice_type

SALES_INVOICEPURCHASE_ORDERPURCHASE_INVOICE

invoice_status

COLLECTOPENREADYSENTPARTIALCOMPLETEREFUNDEDVOID

dashboard_widget_type

sales-summarytop-productsrecent-transactionsavg-transactioncustomers

dashboard_product_trend

updownstable

dashboard_sort_by

revenuequantity

businessday_event_type

CASHIER_LOGINCASHIER_LOGOUT

stock_transaction_type

INVENTORYDELIVERYUSAGEWASTAGETRANSFERADJUSTMENT

stock_transaction_status

DRAFTPENDINGPROCESSINGCOMPLETEDFAILEDCANCELLED

stock_count_type

FULLPARTIALCYCLESPOT

stock_count_status

DRAFTACTIVECOMPLETEDCANCELLED

stock_transfer_status

DRAFTPENDING_APPROVALAPPROVEDIN_PREPARATIONSHIPPEDIN_TRANSITRECEIVEDCOMPLETEDCANCELLED

stock_transfer_priority

LOWNORMALHIGHURGENT

stock_notification_type

low_stocknegative_stockinventory_variancetransfer_completedcount_session_completeddelivery_receivedcalculation_failedstock_adjustmentlarge_movementexpiry_warning

stock_notification_status

pendingdeliveredfailedcancelled

notification_delivery_method

emailsmswebhookslackpush_notification

attachment_type

Type of attachment

POS_BACKGROUND - Kassan taustakuvaPOS_LOGO - Kassan logoSELFSERVICE_LOGO1 - Kuitin taustakuvaCUSTOMER_DISPLAY - AsiakasnäyttöRECEIPT_LOGO0 - Kuitti [LOGO0]RECEIPT_LOGO1 - Kuitti [LOGO1]RECEIPT_LOGO2 - Kuitti [LOGO2]RECEIPT_LOGO3 - Kuitti [LOGO3]RECEIPT_LOGO4 - Kuitti [LOGO4]RECEIPT_LOGO5 - Kuitti [LOGO5]CASTLES_LOGO0 - Castles KuittiCASTLES_SPLASH - CASTLES SPLASHSELFSERVICE_LOGO2 - Itsepalvelukassan logo 2SELFSERVICE_LOGO3 - Itsepalvelukassan logo 3REPORT_TEMPLATE - RaporttipohjaPLU_IMAGE - TuotekuvaPLU_IMAGE_DEFAULT - Oletus tuotekuvaAREA_MAP - Pöytäkartan taustaINVOICE_LOGO - Laskun logoLAYOUT_IMAGE - Kassanäyttökuva

A

30 model(s)

address

FieldTypeRequiredDescription
line1stringRequiredAddress line 1
line2stringOptionalAddress line 2
postnumberstringRequiredPostal code (5 digits)
citystringRequiredCity name
countrystring?OptionalCountry code

apix_parameters

FieldTypeRequiredDescription
activebooleanOptionalUse APIX e-invoice integration
transfer_idstringOptionalAPIX transfer ID
transfer_keystringOptionalAPIX transfer key
api_addressurlOptionalAPIX API address (empty = default)

api_token

FieldTypeRequiredDescription
idguidRequired
companyguidRequired
hoststringRequired
validity_enddateRequired
tokenstringOptional

additional_field

FieldTypeRequiredDescription
idguidRequiredField unique id
namestringRequiredField name
groupstring?OptionalGroup name
typeenum:additional_field_typeRequiredField type
refstringOptionalReference to external system
descriptionstringOptionalField description
requiredbooleanOptionalIs field required

additional_fields

FieldTypeRequiredDescription
companyadditional_field[]OptionalAdditional fields for company
customeradditional_field[]OptionalAdditional fields for customer
pluadditional_field[]OptionalAdditional fields for plu
dptadditional_field[]OptionalAdditional fields for dpt
grpadditional_field[]OptionalAdditional fields for grp
locationadditional_field[]OptionalAdditional fields for location
posadditional_field[]OptionalAdditional fields for pos
salesorderadditional_field[]OptionalAdditional fields for sales orders

assortment

FieldTypeRequiredDescription
not_for_salestring[]Required
out_of_stockstring[]Required

accounting_data

FieldTypeRequiredDescription
dummystringOptional

accounting

has idtable
FieldTypeRequiredDescription
target_datedateRequired
serialnumnumberRequired
namestringRequired
invoice_idguidOptional
bankaccount_transaction_idguidOptional
dataaccounting_dataRequired

accounting_item

has idtable
FieldTypeRequiredDescription
accounting_idguidRequired
accounting_map_idguidRequired
typestringRequired
namestringRequired
valueamountRequired

accounting_map_data

FieldTypeRequiredDescription
dummystringOptional

accounting_map

has idtable
FieldTypeRequiredDescription
parent_map_idguidOptional
accountnumintRequired
namestringRequired
vat_typestringRequired
tax_idintRequired
dataaccounting_map_dataRequired

account

FieldTypeRequiredDescription
account_numintRequired
signintRequired
vatpctnumberRequired
descriptionstringOptional

additional_barcode

FieldTypeRequiredDescription
barcodestringRequiredadditional barcode
qtynumberOptionalcustom sales quantity for this barcode
pricenumberOptionalcustom price for this barcode

allergens

FieldTypeRequiredDescription
cereals_glutenbooleanOptionalCereals containing gluten (wheat, rye, barley, oats, spelt, kamut)
crustaceansbooleanOptionalCrustaceans and products thereof
eggsbooleanOptionalEggs and products thereof
fishbooleanOptionalFish and products thereof
peanutsbooleanOptionalPeanuts and products thereof
soybeansbooleanOptionalSoybeans and products thereof
milkbooleanOptionalMilk and products thereof (including lactose)
nutsbooleanOptionalTree nuts (almonds, hazelnuts, walnuts, cashews, etc.)
celerybooleanOptionalCelery and products thereof
mustardbooleanOptionalMustard and products thereof
sesamebooleanOptionalSesame seeds and products thereof
sulphitesbooleanOptionalSulphur dioxide and sulphites at concentrations >10mg/kg or >10mg/L
lupinbooleanOptionalLupin and products thereof
molluscsbooleanOptionalMolluscs and products thereof

api_token_create_response

API token creation response

FieldTypeRequiredDescription
idguidRequiredToken identifier (UUID)
validity_enddateRequiredToken expiration date (YYYY-MM-DD)
hoststringRequiredAllowed host for this token
companyguidRequiredCompany GUID this token belongs to
tokenstringRequiredJWT token for API authentication

ai_query_request

AI query request payload

FieldTypeRequiredDescription
querystringRequiredNatural language query text

ai_query_response

AI query response with result data

FieldTypeRequiredDescription
responsestringRequiredAI text response
outputTypestringRequiredOutput type: TABLE or CHART
dataanyRequiredResult data: HTML table string or ECharts options object

ai_company_info_response

AI service company information

FieldTypeRequiredDescription
companyIdguidRequiredCompany GUID
namestringRequiredCompany name
displayNamestringOptionalDisplay name
identstringOptionalCompany identifier
locationCountintRequiredNumber of locations
productCountintRequiredNumber of products
salesCountintRequiredNumber of sales records

ai_error_response

AI service error response

FieldTypeRequiredDescription
errorstringRequiredError code
messagestringRequiredError message
detailsstringOptionalAdditional error details

arnolds_ingredients_request

FieldTypeRequiredDescription
fileanyRequiredExcel file upload

arnolds_ingredients_response

FieldTypeRequiredDescription
successbooleanRequired
messagesstring[]Required
detailsanyRequired

attachment_upload_request

FieldTypeRequiredDescription
imageanyRequiredFile upload
ref_typestringOptional

attachment_response

FieldTypeRequiredDescription
idstringRequiredAttachment GUID

attachment_update_request

FieldTypeRequiredDescription
dataanyRequired

alert_request

FieldTypeRequiredDescription
whatstringRequired
titlestringRequired
datastringRequired

ack_alert_request

FieldTypeRequiredDescription
idstringRequired

accounting_day_request

FieldTypeRequiredDescription
idstringRequiredBusiness day GUID
locstringRequiredLocation GUID

attachment_upload

Upload metadata stored during file upload

FieldTypeRequiredDescription
headstringOptionalHTTP header from upload
namestringOptionalForm field name
typestringOptionalMIME type
filenamestringOptionalOriginal filename
tempfilestringOptionalTempfile reference (string representation)

attachment_data

Attachment metadata

FieldTypeRequiredDescription
checksumstringRequiredFile checksum (SHA1)
typestringRequiredAttachment type category
uploadattachment_uploadOptionalUpload metadata

attachment

has idhas activetablecompany-scopeddeletable

File attachment for images and documents

FieldTypeRequiredDescription
filenamestringRequiredOriginal filename
filetypestringRequiredMIME type of the file
ref_guidguidOptionalReference to related entity GUID
ref_typestringOptionalType of referenced entity
storagestringRequiredStorage location identifier
dataattachment_dataRequiredAttachment metadata

B

14 model(s)

bank_account

FieldTypeRequiredDescription
bankstringRequiredBank name
bicstringRequiredBank Identifier Code (BIC/SWIFT)
ibanstringRequiredInternational Bank Account Number

big_receipt_settings

Settings for large receipt display view

FieldTypeRequiredDescription
showTablebooleanOptionalShow table number on receipt
showDeliverybooleanOptionalShow delivery information
showReceiptNamebooleanOptionalShow receipt name/title
showLineDeliverybooleanOptionalShow delivery info per line item
showLineVatbooleanOptionalShow VAT per line item
showLineChairbooleanOptionalShow chair/seat number per line
showSinglePricebooleanOptionalShow unit price for single items
selfServicebooleanOptionalSelf-service mode enabled
collapseButtonbooleanOptionalShow collapse/expand button
fontSizestringOptionalFont size (small, normal, large)

bankaccount_data

FieldTypeRequiredDescription
dummystringOptional

bankaccount

has idhas activetable
FieldTypeRequiredDescription
valid_fromdateRequired
valid_todateRequired
bicstringRequired
ibanstringRequired
namestringRequired
databankaccount_dataRequired

bankaccount_transaction_data

FieldTypeRequiredDescription
dummystringOptional

bankaccount_transaction

has idtable
FieldTypeRequiredDescription
bankaccount_idstringRequired
target_datedateRequired
payment_datedateRequired
bookkeeping_datedateRequired
payerstringRequired
referencestringRequired
amountamountRequired
balanceamountRequired
databankaccount_transaction_dataRequired

businessday_data

Custom data for a business day

FieldTypeRequiredDescription
autogeneratebooleanRequired
timesheet_calculatedbooleanOptional
externalidOptional

businessday

has idtablecompany-scoped

A business day is a day when the store is open. Usually there is a single businessday per calendar day

FieldTypeRequiredDescription
pos_ididRequired
namedateRequired
open_timedatetimeRequired
close_timedatetime?Optional
databusinessday_dataRequired
date_yearintRequired
date_quarterintRequired
date_monthintRequired
date_weekintRequired
date_dowintRequired
date_dayintRequired

businessday_op_request

FieldTypeRequiredDescription
idstringRequiredBusiness day GUID
locstringRequiredLocation GUID
opstringRequiredOperation: merge_sales, remove_day

businessday_cash

FieldTypeRequiredDescription
beginCashnumberRequiredcash in drawer at the beginning of day
endCashnumberRequiredcash in drawer at the end of day
cashDropsnumberRequiredcash reconciled from drawer
paidOutsnumberRequiredcash paid out

businessday_grp_sales

FieldTypeRequiredDescription
grp_numnumberRequiredgroup number
idstringRequiredgroup id
namestringRequiredgroup name
qtystringRequiredquantity sold
totalstringRequiredtotal sales

businessday_tax_sales

FieldTypeRequiredDescription
tax_numnumberRequiredtax number
namestringRequiredtax name
netsalesstringRequirednet sales
totalstringRequiredtotal sales

businessday_event

FieldTypeRequiredDescription
typeenum:businessday_event_typeRequiredtype of event
cashier_idguidRequiredcashier id
timestampstringRequiredtimestamp of event
cashier_namestringRequiredcashier name

businessday_report

FieldTypeRequiredDescription
idguidRequiredUnique identifier for this businessday
namestringRequiredDate of the businessday, YYYY-MM-DD
databusinessday_dataRequired
businessdaysguidRequiredDay name -> guid mapping for the week
cashbusinessday_cashRequiredcash reports
grp_salesbusinessday_grp_sales[]Requiredgroup sales
tax_salesbusinessday_tax_sales[]Requiredtax sales
cashdrop_receiptsguid[]Required??
paidout_receiptsguid[]Required??
open_receiptguidRequiredopen receipt
close_receiptguidRequiredclose receipt
customersnumberRequirednumber of customers
nextguidOptionalId of the next businessday
prevguidOptionalId of the previous businessday
openTimestringRequiredTime when the businessday was opened
closeTimestringRequiredTime when the businessday was closed
plu_countnumberRequirednumber of plu sold
salesnumberRequiredtotal sales without taxes
totalsalesnumberRequiredtotal sales with taxes
eventsbusinessday_event[]Requiredspecial transactions
externalsexternal[]Requiredexternal transfers

C

42 model(s)

contract_invoice_data

FieldTypeRequiredDescription
dummystringOptional

contract_invoice

has idtable
FieldTypeRequiredDescription
company_idguidRequired
contract_idguidRequired
typestringRequired
target_datestringRequired
referencestringRequired
datacontract_invoice_dataRequired

contract_data

FieldTypeRequiredDescription
contract_typestringRequired
our_refstringRequired
qtynumberRequired

contract

has idhas activetablecompany-scoped
FieldTypeRequiredDescription
valid_fromstringRequired
valid_tostringRequired
namestringRequired
datacontract_dataRequired

contract_type

FieldTypeRequiredDescription
idguidRequired
codestringRequired
namestringRequired
periodstringRequired
billingperiodstringRequired
pricenumberRequired

company_weeklyreport_parameters

FieldTypeRequiredDescription
refnumstringOptionalReference number for weekly reports

company_externals

FieldTypeRequiredDescription
idstringRequiredUnique id
locationguidOptional
prequisitesstringOptional
schedulestringOptional
titlestringOptional
typestringOptional
voucherclassstringOptional
voucherlinesvoucher_line[]Optional
calculationmodestringRequired
descriptionstringOptional
dimensionsexternal_dimension[]Required
generator_classstringRequired
remove_empty_linesbooleanOptionalRemove empty lines from voucher

customer_group_data

FieldTypeRequiredDescription
set_taxtypebooleanOptional
taxtypenumber_or_stringOptional

customer_group

FieldTypeRequiredDescription
idguidRequired
activebooleanRequired
namestringRequired
datacustomer_group_dataOptional

company_data

FieldTypeRequiredDescription
typeenum:company_typeOptional
rootbooleanOptionalis root company
resellerbooleanOptionalis reseller company
addressaddressOptional
weeklycompany_weeklyreport_parametersOptional
netvisornetvisor_parametersOptional
procountorprocountor_parametersOptional
fennoafennoa_parametersOptional
apixapix_parametersOptional
ecommerceecommerce_parametersOptional
nyxnyx_parametersOptional
shopifyshopify_parametersOptional
woocommercewoocommerce_parametersOptional
externalscompany_externals[]Optional
invoiceinvoice_parametersOptional
timesheetstimesheet_parametersOptionalTimesheet tracking configuration
display_namestringRequiredCompany display name
groupstringOptionalCompany grouping
customergroupscustomer_group[]Optional
kitchenprinterstring[]Optional
receipt_layoutspos_receipt_layout_data[]Optional
email_reportsemail_report_settingsOptional
card_contractsdeprecatedanyOptional
franchisingfranchising_parametersOptional
only_inherited_productsbooleanOptionalUse only inherited products from parent company
contractscontract_type[]Optional
default_tagsstring[]RequiredDefault tags for products
dimensionsdimension_data[]Optional
contactstringOptionalPrimary contact person
phonestringOptionalCompany phone number
admin_namestringOptionalAdministrator name
admin_emailstringOptionalAdministrator email address
giftcardgiftcard_dataOptionalGift card configuration
product_numberingstringOptionalProduct numbering template
reuse_product_numbersbooleanOptionalAllow reuse of inactive product numbers
versionnumberOptionalCompany data version
pos_namestringOptionalDefault POS name for company creation
location_namestringOptionalDefault location name for company creation
stock_value_typedeprecatedenum:stock_value_typeOptionalStock valuation method (purchase_price, running_average, fifo)
invdiff_reportdeprecatedenum:invdiff_reportOptionalInventory difference report mode (none, if_available, mandatory)
api_tokensapi_token[]Optional
receipthero_activebooleanOptionalUse Receipt Hero integration
additional_fieldsadditional_fieldsOptionalAdditional fields used by this company
sales_channelssales_channel[]OptionalSales channels used by this company
languagesstring[]OptionalAvailable languages for translations (e.g., ["en", "sv"]). Finnish is always the default source language.
internalanyOptional
hide_invoice_number_in_attachmentsbooleanOptionalHide invoice number in PDF attachments sent via email

company_big_data

FieldTypeRequiredDescription
dimensionsdimension_data[]Optional
receipt_layoutspos_receipt_layout_data[]Optional

company

has idhas activetable
FieldTypeRequiredDescription
namestringRequired
identstringRequired
parent_ididOptional
datacompany_dataRequired
sales_historysales_historyOptional
statestringRequired
bigdatacompany_big_data?Optional

companyextended

has idhas activetable
FieldTypeRequiredDescription
namestringRequired
identstringRequired
parent_ididOptional
datacompany_dataRequired
sales_historysales_historyOptional
statestringRequired
bigdatacompany_big_data?Optional
typeenum:companytree_typeOptional
childrenany[]Optional
locationsany[]Optional

customer_token

FieldTypeRequiredDescription
typeenum:token_typeRequiredtoken type
dataanyRequiredtoken value

customer_billing

FieldTypeRequiredDescription
address1stringRequiredCustomer address
address2stringOptionalCustomer address
postcodestringRequiredPostal code
citystringRequiredCity name
countrystringOptionalCountry code
phonestringOptionalCustomer phone number
emailemailOptionalCustomer email address
email_invoicingdeprecatedstringOptionalCustomer email address

customer_finvoice

FieldTypeRequiredDescription
addressstring?OptionalFinvoice address
operatorstring?OptionalFinvoice operator

customer_data

FieldTypeRequiredDescription
blockedbooleanOptional
can_invoicebooleanOptional
is_companydeprecatedbooleanOptional
groupsguid[]Optional
customergroupguidOptional
languagestringOptional
namestringRequiredCustomer name
additional_namestringOptionalCustomer additional name
typeenum:customer_typeRequiredCompany or individual person
identstringOptionalCustomer company identifier
contact_namestringOptionalCustomer contact person
our_refstringOptionalOur reference
your_refstringOptionalCustomer reference
billingcustomer_billingRequiredCustomer billing information
finvoicecustomer_finvoiceOptionalCustomer finvoice information
payment_termenum:payment_termsRequiredPayment terms
notesstring?OptionalInternal notes about customer
invoice_typeenum:customer_invoice_typeRequiredType of invoice
invoice_sendingenum:send_typeRequiredInvoice sending route
receipts_and_productsenum:receipts_and_productsRequiredInvoice row types
tokenscustomer_token[]OptionalCustomer identification tokens
discountsguid[]OptionalCustomer discounts
pricingguidOptionalCustomer special pricing
forbid_salesbooleanOptional
ask_referencebooleanOptionalAsk reference text at sales
is_defaultbooleanOptional
ext_idexternal_id[]Optional
additional_fieldsstringOptionalAdditional fields

customer

has idhas activetablecompany-scoped
FieldTypeRequiredDescription
customer_numnumberRequiredCustomer unique number
datacustomer_dataRequired

coordinates

FieldTypeRequiredDescription
latnumberOptional
lonnumberOptional

campaign_period

Reference period for campaign performance comparison

FieldTypeRequiredDescription
start_datedateRequiredPeriod start date for comparison analysis
end_datedateRequiredPeriod end date for comparison analysis
weightnumber_or_stringRequiredWeight factor for this reference period in calculations

campaign_discount

Discount configuration for campaign promotions

FieldTypeRequiredDescription
discount_idstring?RequiredID of the discount to apply during campaign
is_couponbooleanOptionalWhether this discount is automatic or manual (coupon)
start_datestringRequiredDiscount validity start date, must be within campaign period
end_datestringRequiredDiscount validity end date, must be within campaign period

campaign_report_dpt

Department filter for campaign reporting

FieldTypeRequiredDescription
dpt_idguid?RequiredDepartment ID to include in campaign reports

campaign_report_plu

Product filter for campaign reporting

FieldTypeRequiredDescription
plu_idguid?RequiredProduct ID to include in campaign reports

campaign_data

Campaign configuration data and settings

FieldTypeRequiredDescription
discountscampaign_discount[]RequiredList of discounts associated with this campaign
reference_periodscampaign_period[]RequiredHistorical periods for performance comparison
report_dptscampaign_report_dpt[]RequiredDepartments to include in campaign reports
report_pluscampaign_report_plu[]RequiredProducts to include in campaign reports
notesstringOptionalAdditional notes and comments about the campaign

campaign

has idhas activetablecompany-scoped

Marketing campaigns with promotions, targeting, and performance tracking

FieldTypeRequiredDescription
location_ididOptionalLocation where campaign is active (null for all locations)
namestringRequiredCampaign name and title
start_datedateRequiredCampaign start date
end_datedateOptionalCampaign end date (null for ongoing campaigns)
datacampaign_dataRequiredCampaign configuration, targeting, and reporting settings

cashier_data

FieldTypeRequiredDescription
trainingbooleanOptionalTraining user
managerbooleanOptionalManager privileges
passwordstringOptionalUser password (hashed)
company_identstringOptionalCompany identifier, if user is company
layout_pagenumberOptionalLayout page to select on login
pos_languagestringOptionalUser language
pos_layoutguidOptional
selfservicebooleanOptionaluse self-service features in pos
cardnumberstringOptionalcashier login card number
netvisor_worker_idstringOptionaltimesheet worker id
additional_fieldsstringOptionalAdditional fields

cashier

has idhas activetablecompany-scoped
FieldTypeRequiredDescription
cashier_numintRequiredcashier number
location_ididOptional
namestringRequiredcashier name
passwordstring?OptionalUser password (hashed)
datacashier_dataRequired
sales_historysales_history?Optional

customerdisplay_config

FieldTypeRequiredDescription
show_welcomebooleanRequired

customerdisplay_element

FieldTypeRequiredDescription
idguidRequired
typestringRequired
image_idguidOptional
textstringOptional
effectenum:customerdisplay_effect_typeRequired
effect_durationintOptional

customerdisplay_view_item

FieldTypeRequiredDescription
elementguidRequired
durationintRequired
transitionenum:customerdisplay_transition_typeRequired

customerdisplay_view

FieldTypeRequiredDescription
layoutenum:customerdisplay_layout_typeRequired
itemscustomerdisplay_view_item[]Required
randomizebooleanRequired

customerdisplay_schedule_item

FieldTypeRequiredDescription
dummystringOptional

customerdisplay_schedule

FieldTypeRequiredDescription
dummystringOptional

customerdisplay_data

FieldTypeRequiredDescription
viewscustomerdisplay_view[]Required
elementscustomerdisplay_element[]Required
schedulecustomerdisplay_schedule[]Required
configcustomerdisplay_configRequired
default_posclosedguid[]Required
default_posopenguid[]Required
default_receiptopenguid[]Required
default_salesguid[]Required
default_subtotalguid[]Required
default_paymentguid[]Required
default_receiptcloseguid[]Required

customerdisplay

has idhas activetablecompany-scoped
FieldTypeRequiredDescription
namestringRequired
datacustomerdisplay_dataRequired

card_payment

FieldTypeRequiredDescription
typeenum:card_payment_typeOptional
batchIdstringOptional
terminalTransIdstringOptional
authNumberstringOptional
cardNumberstringOptional
cardNamestringOptional
archiveIdstringOptional
entryMethodstringOptional
verificationstringOptional
customerReceiptstringRequired
controlReceiptstringOptional
aidstringOptional
tvrstringOptional
tsistringOptional
terminalNamestringOptional
terminalBatchstringOptional
attributesanyOptional

cardbatch_data

FieldTypeRequiredDescription
countnumberOptional

cardbatch

has idtablecompany-scoped
FieldTypeRequiredDescription
pos_ididOptional
namestringRequired
open_timedatetimeOptional
close_timedatetimeOptional
typestringRequired
referencestringRequired
totalnumberRequired
accountednumberRequired
datacardbatch_dataRequired

cardpayment_data

FieldTypeRequiredDescription
aidstring?Optional
tsistring?Optional
tvrstring?Optional
card_namestringRequired
attributesany?Optional
batch_typestring?Optional
auth_numberstring?Optional
card_numberstring?Optional
entry_methodstring?Optional
verificationstring?Optional
terminal_namestring?Optional
pos_entry_modestring?Optional
terminal_batchstringRequired
control_receiptstringRequired
customer_receiptstring?Optional

cardpayment

has idtablecompany-scoped
FieldTypeRequiredDescription
pos_ididOptional
batch_ididOptional
tendersales_ididOptional
receipt_numintRequired
timestampdatetimeRequired
transactionidstringRequired
archiveidstringRequired
cancelledbooleanOptional
original_transactionidstringRequired
referencestringRequired
amount_innumberRequired
amount_outnumberRequired
datacardpayment_dataRequired

chainstatus_response

FieldTypeRequiredDescription
reportsany[]Required

cashier_password_request

FieldTypeRequiredDescription
pwdstringRequiredNew password

D

29 model(s)

dimension_details

FieldTypeRequiredDescription
fennoakeystringOptional
namestringOptional
levelstringOptional
is_hiddenbooleanOptional
sortstringOptional
end_sortstringOptional
father_idstringOptional
codestringOptional

dimension_data

FieldTypeRequiredDescription
fennoakeystringOptional
netvisorkeystringOptional
codestringRequired
namestringRequired
is_hiddenbooleanOptional
detailsdimension_details[]Required
end_sortstringOptional
father_idstringOptional
levelstringOptional
parent_namestringOptional
sortstringOptional

daily_time_slot

FieldTypeRequiredDescription
idguidRequired
template_idguidOptional
start_timestringRequired
end_timestringRequired
descriptionstringRequired

daily_hours

FieldTypeRequiredDescription
open_timestringOptional
close_timestringOptional
is_closedbooleanOptional
time_slotsdaily_time_slot[]Optional

dashboard_widget

FieldTypeRequiredDescription
idstringRequired
xintRequired
yintRequired
widthintRequired
heightintRequired
componentNamestringRequired
settingsanyOptional

dashboard_settings

FieldTypeRequiredDescription
widthintRequired
heightintRequired
namestringOptional
descriptionstringOptional
updateFrequencyintOptional
widgetsany[]Required

discountline_discount

FieldTypeRequiredDescription
typeenum:discount_line_typeRequired
amountnumber?Required

discount_salesline

FieldTypeRequiredDescription
dptnumber_or_string[]Optional
plunumber_or_string[]Optional
grpstring[]Optional
deliveryenum:delivery_typeOptional
discountdiscountline_discountOptional
bundlingbooleanOptional
orderenum:discount_orderOptional
optionalbooleanOptional

discount_sellline

FieldTypeRequiredDescription
productIdstringOptional
productGuidguidOptional
qtynumberRequired

discount_match

FieldTypeRequiredDescription
orderenum:discount_orderOptional
applystringOptional
salesLinesdiscount_saleslineRequired
selldiscount_sellline[]Optional

discount_invoicing

FieldTypeRequiredDescription
activebooleanRequired
customer_idguidRequired
discount_price_typeenum:discount_line_typeRequired
invoice_amountamountRequired

discount_data

FieldTypeRequiredDescription
descriptionstringOptional
notesstringOptional
weekreportbooleanOptional
valid_fromdateOptional
valid_todateOptional
discount_typeenum:discount_typeOptional
manualbooleanOptional
targetenum:discount_targetOptional
percentdiscount_ask?Optional
prioritynumber?Optional
amountdiscount_ask?Optional
matchdiscount_match?Optional
tender_idstringOptional
subscription_typeenum:subscription_typeOptional
invoicingdiscount_invoicingOptional
time_restrictionstringOptional
hide_on_receiptbooleanOptionalPiilota kuitilta
additional_fieldsstringOptionalAdditional fields

discount

has idhas activetablecompany-scoped
FieldTypeRequiredDescription
namestringRequired
discount_codestringRequired
datadiscount_dataRequired
sales_historysales_history?Optional

dpt_data

FieldTypeRequiredDescription
sales_dptbooleanOptional
stock_dptbooleanOptional
ex_salebooleanOptional
fin_repbooleanOptional
default_taxnumber_or_stringOptional
colorstringOptional
foreground_colorstringOptional
marginnumber_or_stringOptional
kitchenprinterbooleanOptional
descriptionstringOptionalDepartment description for menu exports
image_urlstringOptionalImage URL for department/category
sort_ordernumberOptionalDisplay order in menu exports
accountingaccountOptional
ext_idexternal_id[]Optional
additional_fieldsstringOptionalAdditional fields

dpt

has idhas activetablecompany-scoped
FieldTypeRequiredDescription
dpt_numnumberRequiredUnique number for this department
grp_idid?RequiredMain group that is department belongs to
namestringRequired
datadpt_dataRequired
sales_historysales_history?Optional

discount_line

FieldTypeRequiredDescription
manualbooleanOptional
idstringOptional
namestringOptional
typestringOptional
amountamountOptional
originalAmountamountOptional
bundlablebooleanOptional
qtynumberOptional
productsPerDiscountintOptional
infocodesreceipt_infocode[]Optional

delivery_order_item

FieldTypeRequiredDescription
plu_idguidRequired
qtynumberRequired
unitstringRequired
costnumberOptional
countnumberOptional
valuenumberOptional

delivery_order

FieldTypeRequiredDescription
idguidRequired
supplier_idguidRequired
itemsdelivery_order_item[]Required

delivery_data

FieldTypeRequiredDescription
orderdelivery_orderRequired

discountsales

table
FieldTypeRequiredDescription
company_ididRequired
pos_ididRequired
discount_ididRequired
businessday_ididRequired
plusales_ididOptional
receipt_numintRequired
timestampdatetimeRequired
amountamountRequired
original_amountamountRequired
qtynumberRequired
sales_typestringRequiredE.g. null or INVOICE
sales_ididRequired

dashboard_widget_request_item

FieldTypeRequiredDescription
idstringRequiredWidget instance ID
componentNamestringRequiredWidget type
settingsdashboard_widget_settingsOptionalWidget settings

dashboard_widgets_request

Dashboard widgets data request - batch request for multiple widgets

FieldTypeRequiredDescription
widgetsdashboard_widget_request_item[]RequiredArray of widget configurations to fetch data for

dashboard_widget_response_item

Single widget data response

FieldTypeRequiredDescription
successbooleanRequiredWhether the widget data fetch succeeded
dataanyOptionalWidget-specific data payload
errorstringOptionalError message if failed
error_typestringOptionalError type/class name

dashboard_widget_settings

Common widget settings

FieldTypeRequiredDescription
startDatedateOptionalStart date for period
endDatedateOptionalEnd date for period
startTimestringOptionalStart time (HH:MM:SS)
endTimestringOptionalEnd time (HH:MM:SS)
showComparisonbooleanOptionalShow previous period comparison
limitintOptionalNumber of items to return
sortBystringOptionalSort by: revenue or quantity
showRevenuebooleanOptional
countintOptionalNumber of transactions
locationFilterguidOptionalFilter by location GUID
periodstringOptionalPeriod label for display

dashboard_sales_summary_data

Sales summary widget data

FieldTypeRequiredDescription
totalSalesnumberRequiredTotal sales amount
previousSalesnumberRequiredPrevious period sales
transactionCountintRequiredNumber of transactions
previousTransactionCountintRequired
customerCountintRequired
previousCustomerCountintRequired
averageTransactionnumberRequired
previousAverageTransactionnumberRequired

dashboard_top_product_item

FieldTypeRequiredDescription
rankintRequired
namestringRequired
categorystringRequired
quantityintRequired
revenuenumberRequired
trendenum:dashboard_product_trendRequired

dashboard_recent_transaction_item

FieldTypeRequiredDescription
idguidRequired
receiptNumberstringRequired
timestampdatetimeRequired
locationstringRequired
totalnumberRequired
paymentMethodstringRequired
itemCountintRequired
cashierstringRequired
isVoidedbooleanRequired

dashboard_metric_data

Simple metric widget data (avg-transaction, customers)

FieldTypeRequiredDescription
valuenumberRequiredCurrent period value
changenumberRequiredPercentage change from previous period
periodstringRequiredPeriod label

dashboard_widget_result

FieldTypeRequiredDescription
successbooleanRequired
dataanyOptionalWidget-specific data on success
errorstringOptionalError message on failure
error_typestringOptional

E

8 model(s)

external_id

FieldTypeRequiredDescription
idstringRequiredExternal system ID
dataanyRequiredExternal system data
systemstringRequiredExternal system name

ecommerce_parameters

FieldTypeRequiredDescription
enablebooleanOptionalEnable e-commerce integration
api_urlstringOptionalE-commerce API URL
api_keystringOptionalE-commerce API key
api_secretstringOptionalE-commerce API secret
customergroupguidOptionalCustomer group for e-commerce customers
prepaid_tenderguidOptionalTender for prepaid orders

external_dimension

FieldTypeRequiredDescription
namestringRequired
itemstringRequired

email_report_settings

FieldTypeRequiredDescription
activebooleanOptionalEnable email reporting
daily_emailsstringOptionalEmail addresses for daily reports

event

tablecompany-scoped
FieldTypeRequiredDescription
typestringRequired
object_guidguidRequired
timestampdatetimeRequired
pos_ididOptional
user_ididOptional
valuestringRequired

external_data

Additional data for external API request/response

FieldTypeRequiredDescription
dummystringOptional

external

has idtablecompany-scoped

External API request/response

FieldTypeRequiredDescription
location_idguidOptionalLocation of the request
pos_idguidOptionalPOS that made the request
targetstringOptionalTarget of the request, date or guid
timestampstringRequiredTime when the request was made
typestringRequiredType of the request
statusenum:external_statusRequiredStatus of the request
requeststringRequiredRequest data
responsestringRequiredResponse data
dataexternal_dataRequiredAdditional data

external_image_request

FieldTypeRequiredDescription
urlstringRequired
plu_idstringRequired

F

4 model(s)

fennoa_parameters

FieldTypeRequiredDescription
activebooleanOptionalUse Fennoa integration
customer_iddeprecatedstringOptional
customer_keydeprecatedstringOptional
userstringOptionalFennoa API username
passstringOptionalFennoa API password
max_roundingnumber_or_stringOptionalMax acceptable rounding in cents
sales_transferstringOptionalSales transfer mode (manual, daily, weeklyreport)
inventory_transferstringOptionalInventory transfer mode (manual, inventory)
statement_series_codestringOptionalStatement series code for vouchers
syncsync_settingsOptional

franchising_fee

FieldTypeRequiredDescription
namestringRequiredFee name
typestringRequiredFee calculation basis (turnover, part_turnover, profit)
accountnumber_or_stringRequiredAccount number for fee posting
percentnumber_or_stringRequiredFee percentage
valid_fromstringOptionalFee validity start date
valid_tostringOptionalFee validity end date

franchising_parameters

FieldTypeRequiredDescription
activebooleanRequiredEnable franchising
payment_accountstringOptionalIBAN account for franchise payments
root_companystringOptionalRoot company name for franchise payments
root_company_idstringOptionalRoot company business ID (Y-tunnus)
feesfranchising_fee[]OptionalFranchising fee structure

flags

FieldTypeRequiredDescription
askpricebooleanOptionalask price on sale
kitchenprinterbooleanOptionalprint to kitchen printer
kitchenprinter2booleanOptionalprint to kitchen printer 2
kitchenprinter3booleanOptionalprint to kitchen printer 3
nosellbooleanOptionalnot sellable
nobuybooleanOptionalnot purchasable
kitcheninfobooleanOptionalask kitchen info
no_discountbooleanOptionalno discounts allowed
no_price_on_receiptbooleanOptionaldo not print price on receipt
not_on_receiptbooleanOptionaldo not print this item on receipt
no_groupbooleanOptionaldo not group this item on receipt
no_customer_displaybooleanOptionaldo not show item on customer display
linked_itembooleanOptionalthis is a linked item
alcoholbooleanOptionalage restricted alcohol item
no_creditcardbooleanOptionaldo not allow credit card payments for this item
modifierbooleanOptionalthis item is a modifier
pack_pricebooleanOptionalthis item has pack pricing
giftcardbooleanOptionalthis item is a gift card
start_meal_definitionbooleanOptionalthis item starts a meal definition
no_dpt_buttonbooleanOptionaldo not show this item on dpt button layout
scalebooleanOptionalscale product
time_based_pricebooleanOptionaltime based pricing
bettingbooleanOptionalInterface to Veikkaus "Elite-S" machine
used_in_appbooleanOptionalthis item is used in mobile app ordering (proprietary

G

3 model(s)

giftcard_data

FieldTypeRequiredDescription
activebooleanOptionalEnable gift card functionality
numberingstringOptionalGift card numbering template

grp_data

FieldTypeRequiredDescription
sales_grpbooleanOptionaltrue if contains sales departments
stock_grpbooleanOptionaltrue if contains stock departments
descriptionstringOptionalGroup description for menu exports
image_urlstringOptionalImage URL for group/category
sort_ordernumberOptionalDisplay order in menu exports
ext_idexternal_id[]Optional
additional_fieldsstringOptionalAdditional fields

grp

has idhas activetablecompany-scoped
FieldTypeRequiredDescription
grp_numintRequiredunique number of this group
namestringRequiredname of this group
datagrp_dataRequired
sales_historysales_history?Optional

H

3 model(s)

help_text

has idtable
FieldTypeRequiredDescription
namestringRequired
langstringRequired
helptextstringRequired

hourlysalesrequest

FieldTypeRequiredDescription
posliststring[]Required
date_fromdateRequired
date_todateRequired

hourlysalesresponse

FieldTypeRequiredDescription
date_fromdateRequired
date_todateRequired

I

18 model(s)

interval

FieldTypeRequiredDescription
valid_fromstringOptionalValidity start date
valid_tostringOptionalValidity end date

invoice_parameters

FieldTypeRequiredDescription
banksbank_account[]RequiredBank accounts for invoice payments
home_citystringOptionalCompany home city for invoice
contact_emailemailOptionalInvoice contact email address
contact_personstringOptionalInvoice contact person name
contact_phonestringOptionalInvoice contact phone number
interestnumberOptionalLate payment interest rate (percentage)
overdue_feenumberOptionalOverdue fee amount
title1stringOptionalInvoice title line 1
title2stringOptionalInvoice title line 2
title_typestringOptionalInvoice title type (logo, logo_and_text, text_only, none)
pdf_typestringOptionalInvoice PDF template type

infocode_data

FieldTypeRequiredDescription
subscription_typestringRequired
promptstringRequired
descriptionstringRequired
input_typeenum:infocode_input_typeRequired
datastringOptional
validationenum:infocode_validation_typeOptional
frequencystringOptional
once_per_receiptbooleanOptional
prioritynumberOptional
printingenum:infocode_printing_typeOptional
linkstringOptional
defaultstringOptional
plu_idguidOptional
dpt_idguidOptional
grp_idguidOptional
tender_idguidOptional
additional_fieldsstringOptionalAdditional fields

infocode

has idhas activetablecompany-scoped
FieldTypeRequiredDescription
namestringRequired
typeenum:infocode_typeRequired
datainfocode_dataRequired

infocodeuses

table
FieldTypeRequiredDescription
company_ididRequired
pos_ididRequired
infocode_ididRequired
businessday_ididRequired
receipt_numnumberRequired
timestampdatetimeRequired
targetstringRequired
valuestringRequired
plusaless_ididOptional
tendersales_ididOptional
discountsales_ididOptional

invoice_purchase_list

FieldTypeRequiredDescription
skustringRequired
eanstringRequired
qtynumberRequired
batch_namestringRequired
batch_sizenumberRequired
batch_valuenumberRequired

invoice_item_data

FieldTypeRequiredDescription
supplyinvoice_purchase_list[]Optional
receipt_idguidOptional

invoice_item

table
FieldTypeRequiredDescription
linenumintRequired
dpt_ididOptional
plu_ididOptional
tax_ididOptional
qtynumber_or_stringRequired
pricenumber_or_stringRequired
totalnumber_or_stringRequired
profitnumber_or_stringRequired
descriptionstringOptional
price_with_taxnumber_or_stringRequired
total_with_taxnumber_or_stringRequired
datainvoice_item_dataRequired

invoice_sales_receipt

FieldTypeRequiredDescription
idguidRequired
pos_idguidRequired
timestampdatetimeRequired
cashierguidOptional
receipt_numintRequired

invoice_payment

FieldTypeRequiredDescription
payment_datedateOptional
account_datedateRequired
amountamountRequired
payment_idstringOptional
accountstringOptional
archive_idstringOptional
referencestringRequired
namestringOptional

invoice_external

FieldTypeRequiredDescription
netvisor_keyintOptional

invoice_data

FieldTypeRequiredDescription
versionintOptional
languageenum:invoice_language?Optional
sales_receiptsinvoice_sales_receipt[]Optional
receipts_and_productsenum:invoice_receipts_typeOptional
paymentsinvoice_payment[]Optional
ext_idexternal_id[]Optional
your_refstringOptional
our_refstringOptional
notesstringOptional
additional_fieldsstringOptionalAdditional fields
externalinvoice_externalOptional

invoice

has idhas activetablecompany-scoped
FieldTypeRequiredDescription
location_ididRequired
customer_ididOptional
supplier_idid?Optional
typeenum:invoice_typeRequired
invoice_numintRequiredunique number of this invoice
statusenum:invoice_statusRequired
invoice_datedate?Optional
due_datedate?Optional
entry_datedate?Optional
payment_datedate?Optional
referencestring?Optional
datainvoice_dataRequired
itemsinvoice_item[]Required
salesorderssalesorder[]Optional

invoice_status_customer_invoice

FieldTypeRequiredDescription
namestringRequiredCustomer name
invoice_numintRequiredInvoice number
invoice_datedateRequiredInvoice date
totalamountRequiredTotal amount without tax
total_with_taxamountRequiredTotal amount with tax

invoice_status_customer_total

FieldTypeRequiredDescription
namestringRequiredCustomer name
countintRequiredNumber of invoices
totalamountRequiredTotal amount without tax
total_with_taxamountRequiredTotal amount with tax

invoice_status_monthly_sale

FieldTypeRequiredDescription
dintRequiredMonth offset from current date (0 = current month)
dddateRequiredDate representing the month
countintRequiredNumber of invoices
totalamountRequiredTotal amount without tax
total_with_taxamountRequiredTotal amount with tax

invoice_status_response

Invoice status summary and statistics

FieldTypeRequiredDescription
invoices_collectinginvoice_status_customer_invoice[]RequiredList of invoices in COLLECT status
invoices_readyinvoice_status_customer_invoice[]RequiredList of invoices in READY status
invoices_sentinvoice_status_customer_invoice[]RequiredList of invoices in SENT status
invoices_overdueinvoice_status_customer_invoice[]RequiredList of overdue invoices
total_collectinginvoice_status_customer_total[]RequiredTotals by customer for COLLECT status invoices
total_readyinvoice_status_customer_total[]RequiredTotals by customer for READY status invoices
total_sentinvoice_status_customer_total[]RequiredTotals by customer for SENT status invoices
total_overdueinvoice_status_customer_total[]RequiredTotals by customer for overdue invoices
monthly_salesinvoice_status_monthly_sale[]RequiredMonthly sales data for the past 12 months

inventory_excel_request

FieldTypeRequiredDescription
fileanyRequiredExcel file upload
locationstringRequiredLocation GUID
datedateOptional
monthstringOptional

L

19 model(s)

location_data_table_wall

FieldTypeRequiredDescription
idstringRequired
xnumberRequired
ynumberRequired
wnumberRequired
hnumberRequired
rotationnumberRequired
colorstringOptional
typestringOptional

location_data_table

FieldTypeRequiredDescription
idguidRequired
namestringRequired
seatsnumberRequired
shapestringRequired
xnumberRequired
ynumberRequired
wnumberRequired
hnumberRequired
rotationnumberRequired
colorstringOptional
seats_topnumberRequired
seats_leftnumberRequired
seats_rightnumberRequired
seats_bottomnumberRequired
opacitynumberOptional

location_data_table_area

FieldTypeRequiredDescription
namestringRequired
wallslocation_data_table_wall[]Required
tableslocation_data_table[]Required
imagestringOptional

location_data_tables

FieldTypeRequiredDescription
areaslocation_data_table_area[]Required
use_mapbooleanOptional

location_data_pos

FieldTypeRequiredDescription
default_deliverystringRequired
background_image_urlstringOptional
logo_image_urlstringOptional

location_email_report

FieldTypeRequiredDescription
activebooleanOptional
daily_emailsstringOptional
weekly_emailsstringOptional
weekly_report_daystringOptional
include_comparisonsbooleanOptional
include_recommendationsbooleanOptional
pdf_attachmentbooleanOptional

location_data_table_map_area

FieldTypeRequiredDescription
namestringRequired
itemslocation_data_table[]Required

location_data_table_maps

FieldTypeRequiredDescription
maximumAmountOfTablesnumberRequired
areaslocation_data_table_map_area[]Required

location_stock_settings

Stock v2 settings for a location

FieldTypeRequiredDescription
auto_update_stockbooleanOptionalAutomatically update stock levels on transactions (deliveries, wastage, transfers)
low_stock_thresholdnumberOptionalThreshold for low stock alerts
negative_stock_allowedbooleanOptionalAllow stock to go negative
inventory_reminder_daysnumberOptionalDays between inventory reminder notifications
wastage_approval_requiredbooleanOptionalRequire approval for wastage transactions
transfer_auto_completebooleanOptionalAuto-complete transfers after shipping
delivery_auto_receivebooleanOptionalAuto-receive deliveries after saving
cost_calculation_methodstringOptionalCost calculation method: fifo, average, last, manual
notification_emailstringOptionalEmail for stock notifications

location_data

FieldTypeRequiredDescription
addressaddressOptional
positionpositionOptional
emailemailOptional
phonestringOptional
ext_idexternal_id[]Optional
opening_hoursopening_hoursOptional
time_slot_templatestime_slot_template[]Optional
sales_locationbooleanOptionalLocation processes sales transactions
stock_locationbooleanOptionalLocation manages inventory/stock
weeklyreport_locationbooleanOptionalLocation generates weekly reports
calculate_stockbooleanOptionalCalculate stock levels and movements
calculate_wastagebooleanOptionalTrack and calculate food wastage
calculate_profitbooleanOptionalCalculate profit margins and costs
calculate_stock_valuesbooleanOptionalCalculate stock values using FIFO
calculate_labor_metricsbooleanOptionalTrack labor costs and productivity
track_table_turnoverbooleanOptionalMonitor table utilization and turnover
track_customer_metricsbooleanOptionalTrack customer behavior and satisfaction
tableslocation_data_tablesOptional
tableMapslocation_data_table_mapsOptional
stock_locationsstring[]Optional
not_in_stockguid[]Optional
assortmentassortmentOptional
weeklyweeklyreport_parametersOptional
descriptionstringOptional
poslocation_data_posOptional
day_start_timestringOptional
home_deliverybooleanOptional
coordinatescoordinatesOptional
default_deliverystringOptional
transfer_sourcestringOptional
pricetags_printedstringOptional
email_reportslocation_email_reportOptional
purchaseinvoicematchingpurchase_invoice_matchingOptional
service_periodsservice_period[]Optional
woltwolt_dataOptional
stock_settingslocation_stock_settingsOptional
arnolds_appanyOptionalproprietary Arnold's app integration data
tempanyOptionalFIXME

location

has idhas activetablecompany-scoped
FieldTypeRequiredDescription
namestringRequired
parent_idid?Optional
datalocation_dataRequired
sales_historysales_history?Optional
receipt_image_iddeprecatedstring?Optional

layout_button

FieldTypeRequiredDescription
pagenumberRequired
xnumberRequired
ynumberRequired
plustringOptional
plu_idguidOptional
tender_idguidOptional
discount_idguidOptional
dpt_idguidOptional
span_xnumberOptional
span_ynumberOptional
text1stringOptional
text2stringOptional
text3stringOptional
imagestringOptional
foregroundstringRequired
backgroundstringRequired
menunumberOptional
font_size1number?Optional
font_size2number?Optional
font_size3number?Optional
pad1numberOptional
actionstringOptional
dataanyOptional
pricenumberOptional
page_changestringOptional
multipliernumberOptional

layout_page

FieldTypeRequiredDescription
idnumberRequired
labelstringOptional
hiddenbooleanRequired
backgroundstringOptional
foregroundstringOptional
columnsnumberOptional
rowsnumberOptional

layout_data

FieldTypeRequiredDescription
buttonslayout_button[]Required
pageslayout_page[]Optional

layout2_textline

FieldTypeRequiredDescription
textstringRequired
fontstringOptional
font_sizenumber?Optional
overflowstringOptional
font_stylestringOptional
alignstringOptional

layout2_button

FieldTypeRequiredDescription
xintRequired
yintRequired
span_xintRequired
span_yintRequired
actionstringRequired
object_idanyOptional
tender_iddeprecatedanyOptional
datastringRequired
pricenumberOptional
page_changestringOptional
multipliernumberOptional
text1layout2_textlineRequired
text2layout2_textlineRequired
text3layout2_textlineRequired
imagestringOptional
iconstringOptional
icon_sizestringOptional
icon_posstringOptional
stylestringRequired
foregroundstringRequired
backgroundstringRequired
text_paddingintRequired
passwordbooleanOptional
price_textstringOptional

layout2_page

FieldTypeRequiredDescription
idintRequired
labelstringRequired
layout_typeenum:layout_page_layout_typeRequired
layout_objectstringOptional
columnsintRequired
rowsintRequired
typeenum:layout_page_button_typeOptional
foregroundanyOptional
backgroundanyOptional
background_typestringOptional
hiddenbooleanRequired
scroll_xbooleanOptional
scroll_ybooleanOptional
show_pricesbooleanOptional
prices_in_buttonsdeprecatedbooleanOptional
buttonslayout2_button[]Required
user_editablebooleanOptional
sort_alphabooleanOptional
imageguidOptional

layout2_data

FieldTypeRequiredDescription
aspect_rationumberOptional
pageslayout2_page[]Required

layout

has idhas activetablecompany-scoped
FieldTypeRequiredDescription
namestringRequired
datalayout2_dataRequired

M

7 model(s)

mobilepay_data_response

FieldTypeRequiredDescription
store_infoanyRequired

mobilepay_register_request

FieldTypeRequiredDescription
namestringRequired
storestringRequired
qrstringOptional

metasearch_request

FieldTypeRequiredDescription
termstringRequiredSearch term

N

6 model(s)

netvisor_parameters

FieldTypeRequiredDescription
activebooleanOptionalUse Netvisor integration
customer_idstringOptionalNetvisor customer ID
customer_keystringOptionalNetvisor customer key
max_roundingnumber_or_stringOptionalMax acceptable rounding in cents
sales_transferstringOptionalSales transfer mode (manual, daily, weeklyreport)
inventory_transferstringOptionalInventory transfer mode (manual, inventory)
test_envbooleanOptionalUse Netvisor test environment
syncsync_settingsOptional

nyx_parameters

FieldTypeRequiredDescription
activebooleanOptionalUse NYX customer loyalty integration
apikeystringOptionalNYX API key

nutrition_value

FieldTypeRequiredDescription
unitstringOptionalUnit of measurement (g, mg, etc.)
valuenumberRequiredNumeric value

nutrition_information

FieldTypeRequiredDescription
serving_sizestringOptionalServing size basis (default: per_100_grams)
energy_kcalnutrition_valueOptionalEnergy in kilocalories
energy_kjnutrition_valueOptionalEnergy in kilojoules
fatsnutrition_valueOptionalTotal fat content
saturated_fatsnutrition_valueOptionalSaturated fat content
mono_unsaturated_fatsnutrition_valueOptionalMonounsaturated fat content
poly_unsaturated_fatsnutrition_valueOptionalPolyunsaturated fat content
carbohydratenutrition_valueOptionalTotal carbohydrate content
sugarnutrition_valueOptionalSugar content
starchnutrition_valueOptionalStarch content
polyolsnutrition_valueOptionalPolyols content
proteinnutrition_valueOptionalProtein content
fibresnutrition_valueOptionalDietary fiber content
saltnutrition_valueOptionalSalt content
sodiumnutrition_valueOptionalSodium content
potassiumnutrition_valueOptionalPotassium content
calciumnutrition_valueOptionalCalcium content
magnesiumnutrition_valueOptionalMagnesium content
chloridenutrition_valueOptionalChloride content
fluoridenutrition_valueOptionalFluoride content
cholesterolnutrition_valueOptionalCholesterol content (for Google Business Profile)
vitamin_cnutrition_valueOptionalVitamin C content
alcohol_percentagenumberOptionalAlcohol percentage (e.g., 5.0 for 5%)
caffeine_mg_per_100gnumberOptionalCaffeine content in mg per 100g

number_response

FieldTypeRequiredDescription
resultnumberRequired

notification_delivery_result

FieldTypeRequiredDescription
methodstringRequiredDelivery method used
successbooleanRequiredWhether delivery was successful
timestampdatetimeRequiredWhen delivery was attempted
response_codestringOptionalResponse code from delivery service
error_messagestringOptionalError message if delivery failed
external_idstringOptionalExternal service message ID

O

1 model(s)

opening_hours

FieldTypeRequiredDescription
mondaydaily_hoursOptional
tuesdaydaily_hoursOptional
wednesdaydaily_hoursOptional
thursdaydaily_hoursOptional
fridaydaily_hoursOptional
saturdaydaily_hoursOptional
sundaydaily_hoursOptional

P

57 model(s)

position

FieldTypeRequiredDescription
latnumberRequiredLatitude coordinate
lngnumberRequiredLongitude coordinate

procountor_parameters

FieldTypeRequiredDescription
activebooleanOptionalUse Procountor integration
test_envbooleanOptionalUse Procountor test environment
max_roundingnumber_or_stringOptionalMax acceptable rounding in cents
sales_transferstringOptionalSales transfer mode (manual, daily, weeklyreport)
inventory_transferstringOptionalInventory transfer mode (manual, inventory)
purchase_invoice_counternumberOptionalLast fetched purchase invoice number
access_tokenstringOptionalOAuth access token
apikeystringOptionalAPI key
codestringOptionalOAuth authorization code
expires_innumberOptionalToken expiration time
refresh_tokenstringOptionalOAuth refresh token
syncsync_settingsOptional

pos_receipt_partial

FieldTypeRequiredDescription
namestringRequired
templatestringRequired
precompiledstringOptional

pos_receipt_layout_data

FieldTypeRequiredDescription
namestringRequired
typestringRequired
activebooleanRequired
partialspos_receipt_partial[]Required
templatestringRequired
precompiledstringOptional

purchase_invoice_matching

FieldTypeRequiredDescription
activebooleanOptional
name_regexstringOptional

pos_image

POS image/asset reference

FieldTypeRequiredDescription
idguidRequiredUnique identifier for the image
typestring?RequiredImage type (logo, background, etc.)
filenamestringOptionalFilename or path of the image
mimetypestringRequiredMIME type of the image
checksumstringOptionalFile checksum for cache validation

pos_settings

General POS display and behavior settings

FieldTypeRequiredDescription
languagestringOptionalUI language code
autoLogoutbooleanOptionalAuto-logout after transaction
bigReceiptbig_receipt_settingsOptionalBig receipt view settings
beepTypestringOptionalSound feedback type (0-5)
fontSizestringOptionalGlobal font size setting
cashierSidebarbooleanOptionalShow cashier sidebar
cashierSidebarExtendedbooleanOptionalExtended cashier sidebar mode

postype_posagent

POS agent configuration for hardware and integrations

FieldTypeRequiredDescription
EFTModeenum:eft_modeOptionalPayment terminal mode
EFTDatastringOptionalEFT configuration data (COM port, terminal ID, etc.)
EFTIdlestringOptionalIdle screen configuration for payment terminal
EFTDebugbooleanOptionalEnable EFT debug logging
EFTTypedeprecatedstringOptionalLegacy EFT type field
HostUrlstringOptionalBackend host URL for POS agent
DebugModebooleanOptionalEnable general debug mode
EnvironmentstringOptionalEnvironment identifier (prod, test)
PrinterNamestringRequiredMain receipt printer URI
PrinterTypeenum:printer_controlRequiredMain printer control type
UpdateChannelstringOptionalSoftware update channel
CustomerDisplayTypeenum:customerdisplay_typeOptionalCustomer display type
CustomerDisplayNamestringOptionalCustomer display connection name
ScaleTypeenum:scale_typeOptionalConnected scale type
ScalePortstringOptionalScale serial port
BettingTypeenum:betting_typeOptionalBetting terminal integration
BettingPortstringOptionalBetting terminal serial port
ReceiptDeliverystringOptionalReceipt delivery method configuration
BackupUrlstringOptionalBackup server URL
UpdateUrlstringOptionalSoftware update server URL
UseRollbarbooleanOptionalEnable Rollbar error reporting
CustomerDisplaystringOptionalLegacy customer display field
KitchenPrinterNamestringOptionalKitchen printer 1 URI
KitchenPrinterTypeenum:printer_controlOptionalKitchen printer 1 control type
KitchenPrinterName2stringOptionalKitchen printer 2 URI
KitchenPrinterType2enum:printer_controlOptionalKitchen printer 2 control type
KitchenPrinterName3stringOptionalKitchen printer 3 URI
KitchenPrinterType3enum:printer_controlOptionalKitchen printer 3 control type
stemmi_tagstring?OptionalDefault Stemmi tag for products
CloudUserstringOptionalCloud service username
CloudPasswordstringOptionalCloud service password
CloudIDstringOptionalCloud service terminal ID
ApiKeystringOptionalAPI key for external services
Rollbardeprecatedstring?OptionalLegacy Rollbar token field

postype_hourlyreport_settings

Hourly report configuration

FieldTypeRequiredDescription
hoursstringOptionalHours to include in report (comma-separated)
dptliststring[]OptionalDepartment IDs to include

postype_flowpos

FlowPOS-specific feature flags and settings

FieldTypeRequiredDescription
pluginsstring[]OptionalEnabled plugin identifiers
no_default_receiptbooleanOptionalDisable automatic receipt printing
background_imgstringOptionalBackground image URL/path
display_layoutstringOptionalUI layout variant (left, middle)
logo_imgstringOptionalLogo image URL/path
hourlyreportpostype_hourlyreport_settingsOptionalHourly report settings
beep_on_touchbooleanOptionalEnable touch feedback sounds
businessday_dialogbooleanOptionalShow business day dialog on login
customer_systembooleanOptionalEnable customer management
delivery_systembooleanOptionalEnable delivery management
tax_systembooleanOptionalEnable tax-free sales
sales_ordersbooleanOptionalEnable sales order functionality
keyboardbooleanOptionalShow on-screen keyboard
wastagebooleanOptionalEnable wastage tracking
deliverybooleanOptionalEnable delivery mode
show_historybooleanOptionalShow transaction history
product_infobooleanOptionalShow product info button
eft_eodbooleanOptionalEnable EFT end-of-day processing
order_numbersbooleanOptionalEnable order number system
table_salesbooleanOptionalEnable table service mode
kitchen_print_autobooleanOptionalAutomatic kitchen slip printing
kitchen_print_allbooleanOptionalPrint all items to kitchen
kitchen_print_ordersbooleanOptionalKitchen print for order numbers only
show_pricingbooleanOptionalShow pricing information
show_stockbooleanOptionalShow stock levels
login_timesheetsbooleanOptionalShow timesheet on login
login_cash_declarationbooleanOptionalRequire cash declaration on login
assortmentsbooleanOptionalEnable assortment filtering
email_receiptbooleanOptionalEnable email receipt option
barcode_customerbooleanOptionalEnable customer barcode scanning
barcode_nyxbooleanOptionalEnable NYX barcode format
barcode_stockmannbooleanOptionalEnable Stockmann barcode format
barcode_cashierbooleanOptionalUse barcode/NFC for cashier login
table_mapsbooleanOptionalEnable table map view
cash_declarationbooleanOptionalEnable cash declaration
permanent_pricegroupbooleanOptionalKeep price group across transactions
table_seatsbooleanOptionalEnable seat-level ordering
immediate_loginbooleanOptionalSkip login screen

postype_castles

Castles payment terminal specific settings

FieldTypeRequiredDescription
direct_paybooleanOptionalEnable direct payment mode
local_urlstringOptionalLocal terminal URL
direct_sellbooleanOptionalEnable direct sell mode

postype_pat

Pay-at-table terminal settings

FieldTypeRequiredDescription
direct_paybooleanOptionalEnable direct payment mode
local_urlstringOptionalLocal terminal URL
direct_sellbooleanOptionalEnable direct sell mode

pos_peripheral

Generic peripheral device configuration

FieldTypeRequiredDescription
typestringRequiredPeripheral type (printer, scale, display)
modelstringRequiredDevice model identifier
driverstringRequiredDriver/protocol to use
configurationanyRequiredDevice-specific configuration

pos2_menu_settings

POS 2026 menus active

FieldTypeRequiredDescription
salesbooleanOptionalEnable sales menu
tablesbooleanOptionalEnable tables menu
ordersbooleanOptionalEnable orders menu
reportsbooleanOptionalEnable reports menu
goalsbooleanOptionalEnable goals menu
archivebooleanOptionalEnable archive menu
deliverybooleanOptionalEnable delivery menu
wastagebooleanOptionalEnable wastage menu
stockbooleanOptionalEnable stock menu
inventorybooleanOptionalEnable inventory menu
settingsbooleanOptionalEnable settings menu

pos2_settings

POS 2026 terminal settings

FieldTypeRequiredDescription
menuspos2_menu_settingsRequired
login_typeenum:pos2_login_typeRequired

postype_receipt_templates

Receipt template assignments for different receipt types

FieldTypeRequiredDescription
control_receiptstring?OptionalControl/merchant receipt template
customer_receiptstring?OptionalCustomer receipt template
kitchen_printstring?OptionalKitchen order slip template
special_txstring?OptionalSpecial transaction receipt template
subtotal_billstring?OptionalSubtotal/interim bill template
reportstring?OptionalReport printout template
invoicestring?OptionalInvoice receipt template
sales_orderstring?OptionalSales order receipt template
warrantystring?OptionalWarranty receipt template

postype_data

POS type configuration data container

FieldTypeRequiredDescription
typeenum:postype_typeOptionalTerminal platform type
admin_passwordstringOptionalAdministrator password
preferred_versionstringOptionalPreferred software version
agent_versionstringOptionalRequired agent version
peripheralspos_peripheral[]OptionalConnected peripheral devices
posagentpostype_posagentOptionalPOS agent configuration
flowpospostype_flowposOptionalFlowPOS feature settings
castlespostype_castlesOptionalCastles terminal settings
pos2pos2_settingsOptionalPOS2 settings
payattablepostype_patOptionalPay-at-table settings
settingspos_settingsOptionalGeneral POS settings
receipt_templatespostype_receipt_templatesOptionalReceipt template assignments

postype

has idhas activetablecompany-scoped

POS type definition - configuration template for POS terminals

FieldTypeRequiredDescription
layout_ididOptionalDefault layout for this POS type
namestringRequiredPOS type name
datapostype_dataRequiredConfiguration data

pos_subscriptions

FieldTypeRequiredDescription
tendersguid[]Optional
pricingsguid[]Optional
discountsguid[]Optional
infocodesguid[]Optional

pos_mobilepay_config

FieldTypeRequiredDescription
pos_idguidRequired
store_idguidRequired
beacon_idstringRequired
environmentstringOptional
merchant_vatstringRequired

pos_vipps_config

FieldTypeRequiredDescription
mssstringOptional
namestringOptional
testbooleanOptional
use_readerbooleanOptional

pos_data

FieldTypeRequiredDescription
receiptreceipt_dataOptional
textsanyOptional
subscriptionspos_subscriptionsRequired
eftstringOptional
test_devicebooleanOptional
pos_networkbooleanOptional
live_parametersbooleanOptional
hostnamestringOptional
languagestring?Optional
lock_codestringOptional
monitor_typestringOptional
update_groupsstringOptional
monitor_updatesbooleanOptional
monitor_locationstringOptional
activation_codestringOptional
mobilepaypos_mobilepay_configOptional
vippspos_vipps_configOptional
ext_idexternal_id[]Optional
preferred_swstringOptional
update_channelstringOptional
automatic_closestringOptional
descriptionstringOptional
network_hostguidOptional
network_typeenum:pos_network_typeOptional
automatic_openstringOptional
automatic_open_cashierintOptional
no_automatic_close_receiptbooleanOptional
sales_channelsstring[]Optionalsales channels for this pos
opening_hoursdeprecatedanyOptional

pos

has idhas activetablecompany-scoped
FieldTypeRequiredDescription
namestringRequired
location_ididRequired
postype_ididRequired
datapos_dataRequired
sales_historysales_history?Optional

pos_discount_usage_response

FieldTypeRequiredDescription
pos_guidguidRequiredPOS system GUID identifier
discountsguid[]OptionalArray of discount GUIDs this POS is subscribed to

posdata_pos

FieldTypeRequiredDescription
idguidRequired
activebooleanOptional
location_ididOptional
namestringRequired
emailstringOptional
typestringOptional
company_idguidRequired
company_namestringOptional
datapos_dataRequired
postypepostypeRequired
peersstring[]Optional
location_datalocation_dataOptional
receipt_layoutspos_receipt_layout_dataRequired
imagespos_image[]Optional
sales_historysales_historyOptional
settlementsstring[]Optionalsettlement methods for this pos
max_receipt_numberintOptionalmaximum receipt number before rolling over to 1
network_typestringOptionalnetwork type of this pos

pricing_data

FieldTypeRequiredDescription
typeenum:pricegroup_typeRequired
taxtypeguidOptional
set_taxtypebooleanOptional
shortnamestringOptional

pricing

has idhas activetablecompany-scoped
FieldTypeRequiredDescription
namestringRequired
datapricing_dataRequired

plu_recipe

FieldTypeRequiredDescription
plustringOptional
plu_idguidOptionallink to plu
multipliernumber_or_stringRequiredmultiplier of base unit for this recipe item
pricenumberRequiredfractional price of this recipe item
vat_pricenumberOptionalfractional vat price of this recipe item
tax_idguidOptionaltax id for this recipe item

plu_selection

FieldTypeRequiredDescription
typeenum:plu_selection_typeRequiredselection type
namestringOptionalname of selection
descriptionstringOptionaladditional description of selection
target_pluguidOptionaltarget plu
target_menuguidOptionaltarget plu
target_priceamountOptionaltarget price
target_price_levelguidOptionaltarget price level
target_discountguidOptionaltarget discount
target_qtynumberOptionaltarget quantity
optionalbooleanOptionaloptional selection
selection_uienum:plu_selection_uiOptionalui element for selection
recipe_changesplu_recipe[]Optionalrecipe changes

plu_pricing

FieldTypeRequiredDescription
typeenum:pricing_typeRequiredpricing type
amountnumber_or_stringOptionalamount for AMOUNT type

plu_supply

information about suppliers where is plu can be ordered

FieldTypeRequiredDescription
activebooleanRequiredThis supplier is active
batch_namestringRequiredName of ordering unit
batch_sizenumber_or_stringRequiredmultiplier of base unit
batch_valuenumber_or_stringRequiredtaxless price of whole supply unit
skustringRequiredsuppliers product code
eanstringOptionalordering EAN code
supplierguidOptionallink to supplier

pricetag_data

FieldTypeRequiredDescription
tagsstringOptional
line1stringOptional
line2stringOptional

plu_data

FieldTypeRequiredDescription
stk_typedeprecatedstringOptional
stock_typedeprecatedstringOptional
unit_typeenum:unit_typeOptional
sales_unitnumberOptionalsales amount in base units, for stock products (6)
flagsflagsOptionalmisc boolean flags for plu
menudeprecatedanyOptional
menu_countdeprecatednumber_or_stringOptional
stock_unitsstock_unit[]Optionallist of stock units for this plu
warning_limitnumberOptionalwarning limit for sales quantity
barcodestringOptionalmain barcode for this plu
barcodesadditional_barcode[]Optionaladditional barcodes for this plu
supplyplu_supply[]Optionallist of suppliers for this plu
allergiesdeprecatedstring[]Optionallist of allergens (EU codes) - DEPRECATED
allergensallergensOptionalEU 14 allergen information (boolean flags for each allergen)
nutritionnutrition_informationOptionalcomplete nutritional information including alcohol and caffeine
weight_gramsnumberOptionalproduct weight in grams
age_limitnumberOptionalage limit for this plu
coursestringOptionaldefault course for this plu
linked_pluguidOptionalsell also this PLU when this PLU is sold
pricesplu_pricingOptionalpricegroups for this plu
recipeplu_recipe[]Optionalrecipe items for this plu
tagsstring[]Optionalcustom tags for this plu
ext_idexternal_id[]Optionalexternal system ids for this plu
button_numberstringOptionalbutton number for pos
pricetagpricetag_dataOptionalpricetag data for this plu
modified_atstringOptionalModification timestamp, used in pricetag printing
cost_pricenumber_or_stringOptionalcost price for this plu
stock_qty_warningnumberOptionalwarning limit for stock quantity
foregroundstringOptionalforeground color for button
backgroundstringOptionalbackground color for button
use_own_colorbooleanOptionaluse foreground/background colors for button, otherwise use dpt colors
refprice_sizenumberOptionalreference price size for weight/liquid products
refprice_typeenum:refprice_typeOptionalreference price type for weight/liquid products
tarenumberOptionaltare weight for weight products
time_unitenum:time_unitsOptionaltime unit for time products
additional_imagesstring[]Optionalproduct image gallery (attachment IDs), independent of image_id field, supports multiple images with drag-and-drop reordering
additional_fieldsstringOptionalAdditional fields
menu_itemsguid[]Optionallist of menu items to add as components
selectionsplu_selection[]Optionalselections for this plu
sales_channelsstring[]Optionalsales channels for this plu

plu

has idhas activetablecompany-scoped
FieldTypeRequiredDescription
productidstringRequiredproduct id
namestringRequiredproduct internal name
taxtypedeprecatedanyOptionaldeprecated, use tax_id instead
tax_idid?Optionallink to tax
typeintRequiredproduct type
receipt_namestringOptionalproduct name on receipt
base_pricenumberOptionalbase price
dpt_ididRequiredlink to dpt
imagestringOptionallink to image in attachments
image_idstring?Optionalprimary product image (attachment ID), independent of data.additional_images
image_urlstringOptional
image_thumbstringOptional
memostringOptionalfree text description for this product
dataplu_dataRequired
sales_historysales_historyOptional

product_statistics_summary

Aggregate KPIs for the product

FieldTypeRequiredDescription
total_revenueamountRequiredTotal gross sales revenue (EUR)
total_quantitynumberRequiredTotal units sold
total_profitamountRequiredTotal profit (EUR)
average_marginnumberRequiredAverage margin percentage (0-100)
average_priceamountRequiredAverage selling price per unit (EUR)
average_qty_per_daynumberRequiredAverage units sold per day
transaction_countnumberRequiredNumber of transactions
customer_countnumberRequiredNumber of unique customers
discount_totalamountRequiredTotal discounts given (EUR)
discount_countnumberRequiredNumber of discounted sales
department_percentagenumberRequiredPercentage of department sales

product_statistics_target

Sales target comparison

FieldTypeRequiredDescription
target_qtynumberOptionalTarget quantity for period
target_revenueamountOptionalTarget revenue for period
achievement_qtynumberOptionalAchievement percentage (qty)
achievement_revenuenumberOptionalAchievement percentage (revenue)

product_statistics_trend

Sales trend compared to previous period

FieldTypeRequiredDescription
directionenum:trend_directionRequiredTrend direction
percentagenumberRequiredPercentage change from previous period
previous_revenueamountOptionalPrevious period revenue
previous_quantitynumberOptionalPrevious period quantity

product_statistics_daily_sales

Daily sales breakdown

FieldTypeRequiredDescription
datedateRequiredDate (YYYY-MM-DD)
location_idguidOptionalLocation GUID (null for total)
location_namestringOptionalLocation name
quantitynumberRequiredUnits sold
revenueamountRequiredRevenue (EUR)
profitamountRequiredProfit (EUR)
marginnumberRequiredMargin percentage
customer_countnumberRequiredNumber of customers

product_statistics_daily_stock

Daily stock levels

FieldTypeRequiredDescription
datedateRequiredDate (YYYY-MM-DD)
location_idguidOptionalLocation GUID
location_namestringOptionalLocation name
quantitynumberRequiredStock quantity
valueamountRequiredStock value (EUR)

product_statistics_inventory

Inventory metrics

FieldTypeRequiredDescription
current_stocknumberRequiredCurrent stock quantity
current_valueamountRequiredCurrent stock value (EUR)
turnover_ratenumberRequiredInventory turnover rate (annual)
days_of_stocknumberOptionalEstimated days of stock remaining

product_statistics_wastage

Wastage/shrinkage data per location

FieldTypeRequiredDescription
location_idguidOptionalLocation GUID
location_namestringOptionalLocation name
quantitynumberRequiredWasted quantity
valueamountRequiredWastage value (EUR)

product_statistics_price

Price point frequency

FieldTypeRequiredDescription
priceamountRequiredSelling price
countnumberRequiredNumber of sales at this price

product_statistics

Product statistics response for ProductEditor StatisticsTab

FieldTypeRequiredDescription
period_startdateRequiredStatistics period start
period_enddateRequiredStatistics period end
summaryproduct_statistics_summaryRequiredAggregate KPIs
targetproduct_statistics_targetOptionalSales target comparison
trendproduct_statistics_trendRequiredTrend vs previous period
ranknumberOptionalProduct rank by sales qty (1 = top)
total_productsnumberOptionalTotal products for rank context
last_sale_datedateOptionalDate of most recent sale
inventoryproduct_statistics_inventoryOptionalInventory metrics
daily_salesproduct_statistics_daily_sales[]OptionalDaily sales data
daily_stockproduct_statistics_daily_stock[]OptionalDaily stock data
wastageproduct_statistics_wastage[]OptionalWastage per location
related_productsproduct_statistics_related[]RequiredTop products bought together
price_distributionproduct_statistics_price[]OptionalPrice frequency

pos_action

FieldTypeRequiredDescription
idstringRequired
nameenum:pos_action_nameRequired
dataanyRequired
extraanyOptional

plusales

table
FieldTypeRequiredDescription
company_ididRequired
pos_ididRequired
dpt_ididRequired
tax_iddeprecatedidRequired
plu_ididRequired
businessday_ididRequired
receipt_numintRequired
timestampdatetimeRequired
qtynumberRequired
priceamountRequired
totalamountRequired
profitamountRequired
deliverystringOptional
sales_typestringRequired
sales_ididRequired

pos_pricing_data

FieldTypeRequiredDescription
idguidRequired
validity_startstringOptional
validity_endstringOptional
valid_fromstringOptional
valid_tostringOptional
tokenstokensOptional
descriptionstringOptional
grpgrp[]Required
dptdpt[]Required
pricingpricing[]Required
pluplu[]Required
taxtax[]Required
tenderstender[]Required
posposdata_posRequired
cashierscashier[]Required
supplierssupplier[]Required
layoutlayout[]Required
discountsdiscount[]Required
customerscustomer[]Optional
infocodesinfocode[]Required
sales_targetssalestarget[]Required
menusmenu[]Required

pricelists_response

FieldTypeRequiredDescription
pricelistsany[]Required

password_change_request

FieldTypeRequiredDescription
oldpwdstringRequired
newpwd1stringRequired
newpwd2stringRequired

password_result

FieldTypeRequiredDescription
resultstringRequired

procountor_op_request

FieldTypeRequiredDescription
idstringRequiredInvoice GUID
statestringRequiredOperation type (dimension, etc.)

purchase_fetch_list_response

FieldTypeRequiredDescription
invoicesany[]Required

purchase_fetch_response

FieldTypeRequiredDescription
invoiceanyRequired

pricetag_request

FieldTypeRequiredDescription
liststringRequiredProduct list
templatestringRequiredTemplate type

pricelist_request

FieldTypeRequiredDescription
valid_fromdateRequiredValidity start date
descriptionstringRequiredPrice list description

pricelist

FieldTypeRequiredDescription
dummystringOptional

R

34 model(s)

receipt_data

FieldTypeRequiredDescription
headerstringOptional
footerstringOptional
imagestringOptional

receipt_infocode

FieldTypeRequiredDescription
idguidRequired
typestringRequired
targetstringOptional
valuestringOptional

receipt_customer

FieldTypeRequiredDescription
idguidRequired
namestringRequired
numberstringOptional
identstringOptional
tokencustomer_tokenOptional
identified_bystringOptional
ask_referencebooleanOptional

receipt_origin

FieldTypeRequiredDescription
idstringRequired
receiptNumbernumberOptional
tableguidOptional
typeenum:receipt_origin_typeOptional

receipt_debuginfo_data

FieldTypeRequiredDescription
itemsany[]Required

receipt_debuginfo

FieldTypeRequiredDescription
datareceipt_debuginfo_dataRequired

receipt_cashier

has active
FieldTypeRequiredDescription
idguidRequiredUnique identifier of the cashier
cashier_numintRequiredcashier number
location_ididOptional
namestringRequiredcashier name
passwordstring?OptionalUser password (hashed)
datacashier_dataRequired
sales_historysales_history?Optional

receipt_serialized

FieldTypeRequiredDescription
idguidRequiredUnique identifier of the receipt
typeenum:receipt_typeRequiredType of the receipt
statusenum:receipt_statusOptionalStatus of the receipt
timestampdatetimeRequiredTimestamp of the receipt, usually the time of the monetary transaction
companyguidRequiredCompany id that the receipt belongs to
posguidRequiredPOS id that the receipt belongs to
pricingDataguidOptionalPricing data id that is used in pricing of the receipt
businessDayguidOptionalBusiness day id that the receipt belongs to
receiptNumberintOptionalReceipt number, unique within the POS
orderNumberintOptionalOrder number, unique within the POS and businessday
originreceipt_originOptionalOriginal table/receipt that this receipt is based on
originalReceiptNumberintOptionalOriginal receipt number, if the receipt is a return
voidbooleanRequiredtrue if the receipt is voided (not valid at all)
commentstringOptionalComment for the receipt, entered at the POS
topCommentstringOptionalTop comment for the receipt, entered at the POS
deliverystringOptionalDelivery method
salesOrderguidOptionalSales order id that the receipt belongs to
age_verifiedbooleanOptionaltrue if the customer age has been verified
tableguidOptionalTable id that the receipt belongs to
seatsnumberOptionalNumber of seats reserved at the table
tableSessionguidOptionalUnique table session id that the receipt belongs to
tableOpstable_statechange[]OptionalTable state changes
seatnumberOptionalSeat number of this receipt from the table
tableStatestringOptionalState of the table at the time of the receipt
totalSalesamountOptionalTotal monetary sales amount of the receipt
cashierreceipt_cashierOptionalCashier that processed the receipt
customerreceipt_customerOptionalCustomer that the receipt belongs to
salesLinessales_line[]OptionalList of sales lines in the receipt
taxestax_line[]OptionalList of tax lines in the receipt
discountsdiscount_line[]OptionalList of total discount lines in the receipt
tenderLinestender_line[]OptionalList of tender lines in the receipt
infocodesreceipt_infocode[]OptionalList of infocodes in the receipt
tenderDataanyOptionalMisc. tender data for the receipt
printableListstringOptionalList of receipts that can be printed
posActionspos_action[]OptionalList of actions that the POS should perform after the receipt has been processed
debugInfoanyOptional

report_generator_product_sale

Individual product sale entry with tax breakdown

FieldTypeRequiredDescription
product_guidguidRequiredProduct GUID
product_idstringRequiredProduct ID/code
product_namestringRequiredProduct name
barcodestringOptionalProduct barcode
product_tagsanyOptionalProduct tags as JSON array
grp_namestringRequiredProduct group name
dpt_namestringRequiredDepartment name
qty_sumnumberRequiredTotal quantity sold
gross_sumamountRequiredTotal gross sales amount
cost_sumamountRequiredTotal cost amount
net_sumamountRequiredTotal net sales amount (after tax deductions)
profit_sumamountRequiredTotal profit amount
profit_pctnumberRequiredProfit percentage (0-1)
tax_breakdownany[]OptionalTax breakdown by rate

report_generator_product_sales_totals

Totals for product sales report

FieldTypeRequiredDescription
qty_sumnumberRequiredTotal quantity sold
net_sumamountRequiredTotal net sales amount
gross_sumamountRequiredTotal gross sales amount
cost_sumamountRequiredTotal cost amount
profit_sumamountRequiredTotal profit amount
profit_pctnumberRequiredOverall profit percentage (0-1)

report_generator_product_sales_response

Product sales report with tax breakdown

FieldTypeRequiredDescription
rowsreport_generator_product_sale[]RequiredProduct sales data rows
totalsreport_generator_product_sales_totalsRequiredSummary totals
cursorany?OptionalPagination cursor (not used)
has_morebooleanRequiredWhether more data is available
metaanyOptionalMetadata including generation timestamp and execution time

report_generator_tender_sale

Individual tender sale entry

FieldTypeRequiredDescription
tender_idguidRequiredTender GUID
tender_namestringRequiredTender name
tender_typestringOptionalTender type
qtyintRequiredNumber of transactions
totalamountRequiredTotal amount in EUR
overpayamountRequiredTotal overpayment amount in EUR

report_generator_tender_sales_totals

Totals for tender sales report

FieldTypeRequiredDescription
qtyintRequiredTotal number of transactions
totalamountRequiredTotal amount in EUR
overpayamountRequiredTotal overpayment amount in EUR

report_generator_tender_sales_response

Tender sales report

FieldTypeRequiredDescription
rowsreport_generator_tender_sale[]RequiredTender sales data rows
totalsreport_generator_tender_sales_totalsRequiredSummary totals
cursorany?OptionalPagination cursor (not used)
has_morebooleanRequiredWhether more data is available
metaanyOptionalMetadata including generation timestamp and execution time

report_generator_tender_fix

Individual tender fix entry

FieldTypeRequiredDescription
tender_idguidOptionalTender GUID (if available)
tender_namestringRequiredTender name
qtyintRequiredNumber of corrections
totalamountRequiredTotal correction amount in EUR

report_generator_tender_fixes_totals

Totals for tender fixes report

FieldTypeRequiredDescription
qty_sumintRequiredTotal number of corrections
total_sumamountRequiredTotal correction amount in EUR

report_generator_tender_fixes_response

Tender fixes report (manual tender corrections)

FieldTypeRequiredDescription
rowsreport_generator_tender_fix[]RequiredTender fix data rows
totalsreport_generator_tender_fixes_totalsRequiredSummary totals
cursorany?OptionalPagination cursor (not used)
has_morebooleanRequiredWhether more data is available
metaanyOptionalMetadata including generation timestamp and execution time

report_generator_action

Individual operational action entry

FieldTypeRequiredDescription
idguidRequiredSales record ID
timestampdatetimeRequiredAction timestamp
typestringRequiredAction type (PAID_OUT, RECEIVED_ON_ACCOUNT, SALES, NO_SALE, etc.)
voidbooleanRequiredWhether the sale was voided
receiptanyRequiredRaw receipt JSON data
amount_euramountRequiredAction amount in EUR

report_generator_actions_totals

Totals for actions report

FieldTypeRequiredDescription
paid_out_sumamountRequiredTotal PAID_OUT amount
received_on_account_sumamountRequiredTotal RECEIVED_ON_ACCOUNT amount
voided_sales_sumamountRequiredTotal voided sales amount
no_sale_countintRequiredTotal NO_SALE count

report_generator_actions_response

Operational actions report (PAID_OUT, RECEIVED_ON_ACCOUNT, voided sales, NO_SALE, etc.)

FieldTypeRequiredDescription
rowsreport_generator_action[]RequiredAction data rows
totalsreport_generator_actions_totalsRequiredSummary totals by action type
cursorany?OptionalPagination cursor (not used)
has_morebooleanRequiredWhether more data is available
metaanyOptionalMetadata including generation timestamp and execution time

report_generator_group_sale

Individual group sale entry with tax breakdown

FieldTypeRequiredDescription
dpt_idguidRequiredDepartment GUID
dpt_namestringRequiredDepartment name
tax_namestringRequiredTax name
tax_ratenumberRequiredTax rate (0-1)
line_qtynumberRequiredTotal quantity sold
line_totalamountRequiredTotal amount including tax

report_generator_group_sales_totals

Totals for group sales report

FieldTypeRequiredDescription
line_qtynumberRequiredTotal quantity sold
line_totalamountRequiredTotal amount including tax

report_generator_group_sales_response

Group sales report aggregated by department and tax rate

FieldTypeRequiredDescription
rowsreport_generator_group_sale[]RequiredGroup sales data rows with tax breakdown
totalsreport_generator_group_sales_totalsRequiredSummary totals
cursorany?OptionalPagination cursor (not used)
has_morebooleanRequiredWhether more data is available
metaanyOptionalMetadata including generation timestamp and execution time

report_generator_tax_summary

Individual tax summary entry

FieldTypeRequiredDescription
tax_namestringRequiredTax name
tax_ratenumberRequiredTax rate (0-1)
taxless_amountamountRequiredTotal amount without tax
tax_amountamountRequiredTotal tax amount
total_amountamountRequiredTotal amount including tax

report_generator_tax_summary_totals

Totals for tax summary report

FieldTypeRequiredDescription
taxless_amountamountRequiredTotal amount without tax
tax_amountamountRequiredTotal tax amount
total_amountamountRequiredTotal amount including tax

report_generator_tax_summary_response

Tax summary report aggregated by tax rate

FieldTypeRequiredDescription
rowsreport_generator_tax_summary[]RequiredTax summary data rows
totalsreport_generator_tax_summary_totalsRequiredSummary totals
cursorany?OptionalPagination cursor (not used)
has_morebooleanRequiredWhether more data is available
metaanyOptionalMetadata including generation timestamp and execution time

report_generator_daily_sale

Individual daily sales entry

FieldTypeRequiredDescription
daystampdateRequiredDate of sales (YYYY-MM-DD)
qty_sumnumberRequiredTotal quantity sold
gross_sumamountRequiredTotal gross sales amount
cost_sumamountRequiredTotal cost amount
net_sumamountRequiredTotal net sales amount (after tax)
profit_sumamountRequiredTotal profit amount
profit_pctnumberRequiredProfit percentage (0-1)
receipt_countintRequiredNumber of receipts

report_generator_daily_sales_totals

Totals for daily sales report

FieldTypeRequiredDescription
qty_sumnumberRequiredTotal quantity sold
net_sumamountRequiredTotal net sales amount
gross_sumamountRequiredTotal gross sales amount
cost_sumamountRequiredTotal cost amount
profit_sumamountRequiredTotal profit amount
profit_pctnumberRequiredOverall profit percentage (0-1)

report_generator_daily_sales_response

Daily sales report aggregated by day

FieldTypeRequiredDescription
rowsreport_generator_daily_sale[]RequiredDaily sales data rows
totalsreport_generator_daily_sales_totalsRequiredSummary totals
cursorany?OptionalPagination cursor (not used)
has_morebooleanRequiredWhether more data is available
metaanyOptionalMetadata including generation timestamp

report_generator_hourly_sale

Individual hourly sales entry

FieldTypeRequiredDescription
hourstampstringRequiredHour timestamp (YYYY-MM-DD-HH)
qty_sumnumberRequiredTotal quantity sold
gross_sumamountRequiredTotal gross sales amount
receipt_countintRequiredNumber of receipts

report_generator_hourly_sales_totals

Totals for hourly sales report

FieldTypeRequiredDescription
qty_sumnumberRequiredTotal quantity sold
gross_sumamountRequiredTotal gross sales amount
receipt_countintRequiredTotal receipts

report_generator_hourly_sales_response

Hourly sales report aggregated by hour

FieldTypeRequiredDescription
rowsreport_generator_hourly_sale[]RequiredHourly sales data rows
totalsreport_generator_hourly_sales_totalsRequiredSummary totals
cursorany?OptionalPagination cursor (not used)
has_morebooleanRequiredWhether more data is available
metaanyOptionalMetadata including generation timestamp

receipt_search_request

FieldTypeRequiredDescription
querystringOptionalSearch terms
startDatedateOptional
endDatedateOptional
posstringOptionalComma-separated POS IDs
cashierstringOptionalComma-separated cashier IDs
receiptStatusstringOptionalVOID or VALID
orderstringOptionalASC or DESC
limitnumberOptionalMax results

report_generator_request

FieldTypeRequiredDescription
queryTypestringRequiredproduct, group, tendersales, actions, customer, tenderfixes
startDatedateOptional
startTimestringOptional
endDatedateOptional
endTimestringOptional
locationstringOptionalComma-separated location IDs
posstringOptionalComma-separated POS IDs
cashierstringOptionalComma-separated cashier IDs
grpstringOptionalComma-separated group IDs
dptstringOptionalComma-separated department IDs
plustringOptionalComma-separated product IDs
customerstringOptionalComma-separated customer numbers
tagsstringOptionalComma-separated tags

S

82 model(s)

sales_history_customers

FieldTypeRequiredDescription
datestringRequiredDate of customer count
cnumberRequiredNumber of customers

sales_history_month

FieldTypeRequiredDescription
datestringRequiredMonth date
qtystring?RequiredTotal quantity sold
totalstring?RequiredTotal sales amount

sales_history

FieldTypeRequiredDescription
customerssales_history_customers[]OptionalCustomer count history
month_salessales_history_month[]OptionalMonthly sales history

sync_options

FieldTypeRequiredDescription
sync_activebooleanRequiredEnable synchronization
sync_createbooleanRequiredSync create operations
sync_updatebooleanRequiredSync update operations
sync_deletebooleanRequiredSync delete operations

sync_settings

FieldTypeRequiredDescription
dpt_from_syncsync_optionsRequiredDepartment sync from external system
dpt_to_syncsync_optionsRequiredDepartment sync to external system
plu_from_syncsync_optionsRequiredProduct sync from external system
plu_to_syncsync_optionsRequiredProduct sync to external system
customer_from_syncsync_optionsRequiredCustomer sync from external system
customer_to_syncsync_optionsRequiredCustomer sync to external system

shopify_parameters

FieldTypeRequiredDescription
activebooleanOptionalEnable Shopify integration
shop_namestringOptionalShopify shop name
client_idstringOptionalShopify API key
client_secretstringOptionalShopify API password
access_tokenstringOptionalShopify access token
syncsync_settingsOptional
customergroup_idguidOptionalCustomer group for e-commerce customers
customer_idguidOptionalCommon Customer for e-commerce customers
prepaid_tenderguidOptionalTender for prepaid orders

sales_channel

FieldTypeRequiredDescription
idguidRequiredUnique id
activebooleanRequiredSales Channel active
namestringRequiredSales Channel name
typestringRequiredSales Channel type
additional_fieldsadditional_fieldsOptionalAdditional fields used by this sales channel

service_period

FieldTypeRequiredDescription
idguidRequired
namestringRequiredName of the service period, for example "Breakfast", "Lunch"
start_timestringRequiredStart time of the service period in "HH:MM" format
end_timestringRequiredEnd time of the service period in "HH:MM" format
descriptionstringOptionalOptional description of the service period
weekdaysstring[]OptionalList of weekdays when the service period is active, e.g. ["MON", "TUE"]
colorcolorOptionalColor associated with the service period, for UI representation

supplier_data

FieldTypeRequiredDescription
codestringOptional
identstringOptionalSupplier company identification
descriptionstringOptionalSupplier description
ext_idexternal_id[]Optional
citystringOptional
emailemailOptional
addressstringOptional
api_addrstringOptional
postcodestringOptional
order_typestringOptional
order_headerstringOptional
customer_numberstringOptional

supplier

has idhas activetablecompany-scoped
FieldTypeRequiredDescription
supplier_numnumberRequiredSupplier number for internal use
namestringRequiredSupplier name
datasupplier_dataRequired
sales_historysales_history[]?Optional

sw_data

FieldTypeRequiredDescription
changelogstringOptional

sw

has idhas activetable
FieldTypeRequiredDescription
namestringRequired
is_prodbooleanRequired
is_betabooleanRequired
is_devbooleanRequired
datasw_dataRequired

salesorder_item_option_deposit

FieldTypeRequiredDescription
gross_pricenumber_or_stringRequiredTotal deposit amount
net_pricenumber_or_stringRequiredNet deposit amount
vat_percentagenumberRequiredVAT percentage

salesorder_item_option

FieldTypeRequiredDescription
namestringRequiredOption category (e.g., Toppings, Size)
valuestringRequiredSelected option value
pricenumber_or_stringRequiredAdditional cost for this option
pos_idstringOptionalPOS identifier for option
value_pos_idstringOptionalPOS identifier for option value
depositsalesorder_item_option_depositOptionalOption deposit information

salesorder_item_deposit

FieldTypeRequiredDescription
gross_pricenumber_or_stringRequiredTotal deposit amount
net_pricenumber_or_stringRequiredNet deposit amount
vat_percentagenumberRequiredVAT percentage

salesorder_item

FieldTypeRequiredDescription
qtynumberRequiredQuantity
namestringRequiredItem name
pricenumber_or_stringRequiredUnit price
totalnumber_or_stringRequiredLine total before tax
plu_idguidOptionalReference to PLU
commentstring?OptionalItem comment/special instructions
productidstringRequiredProduct ID
linenumnumberOptionalLine number
price_overridebooleanOptionalWhether price was overridden
total_with_taxnumber_or_stringRequiredLine total including tax
woocommerce_variantnumberOptionalWooCommerce variant ID
skustringOptionalStock keeping unit
gtinstringOptionalGlobal Trade Item Number
base_pricenumber_or_stringOptionalBase price before modifications
is_bundle_offerbooleanOptionalWhether item is a bundle offer
category_idstringOptionalCategory identifier
category_namestringOptionalCategory name
optionssalesorder_item_option[]OptionalItem modifiers/options
depositsalesorder_item_depositOptionalDeposit information

salesorder_contact

FieldTypeRequiredDescription
emailemailOptionalContact email
phonestringOptionalContact phone
namestringOptionalContact name

salesorder_external

FieldTypeRequiredDescription
woocommerce_keystringOptionalWooCommerce order key
shopify_keynumberOptionalShopify order ID
wolt_idstringOptionalWolt order ID
wolt_order_numberstringOptionalWolt order number
attribution_idstringOptionalWolt attribution/campaign ID
venue_idstringOptionalWolt venue identifier
external_venue_idstringOptionalPartner venue ID

salesorder_payment

FieldTypeRequiredDescription
totalnumber_or_stringRequiredPayment amount
linenumnumberRequiredLine number
overpaynumberRequiredOverpayment amount
tender_idguidRequiredReference to tender type
tender_typestringRequiredTender type

salesorder_shipping

FieldTypeRequiredDescription
namestringOptionalRecipient name
companystringOptionalCompany name
address_1stringOptionalAddress line 1
address_2stringOptionalAddress line 2
citystringOptionalCity
postcodestringOptionalPostal code
countrystringOptionalCountry code
emailemail?OptionalShipping email
phonestring?OptionalShipping phone

salesorder_delivery

FieldTypeRequiredDescription
statusstringOptionalDelivery status (estimated, delivered, etc.)
typestringOptionalDelivery type (homedelivery, takeaway)
timestringOptionalExpected delivery timestamp
feenumber_or_stringOptionalDelivery cost
small_order_surchargenumber_or_stringOptionalSmall order surcharge
self_deliverybooleanOptionalWhether venue handles delivery
pickup_etastringOptionalCourier pickup ETA
street_addressstringOptionalStreet address
apartmentstringOptionalApartment/unit number
citystringOptionalCity
countrystringOptionalCountry code
latitudenumberOptionalGPS latitude
longitudenumberOptionalGPS longitude
formatted_addressstringOptionalFull formatted address

salesorder_payment_details

FieldTypeRequiredDescription
cash_amountnumber_or_stringOptionalCash payment amount
cash_to_expectnumber_or_stringOptionalExpected cash amount
paid_by_other_methodsnumber_or_stringOptionalAmount paid by non-cash methods
company_tax_idstringOptionalCompany tax ID for business billing
loyalty_card_numberstringOptionalCustomer loyalty card number
is_wolt_plusbooleanOptionalWolt Plus subscription status
balance_to_pay_in_venuenumber_or_stringOptionalAmount to be paid at venue

salesorder_pricing

FieldTypeRequiredDescription
total_before_discountsnumber_or_stringOptionalTotal before discounts
subtotal_basket_discountsnumber_or_stringOptionalBasket-level discounts
subtotal_item_discountsnumber_or_stringOptionalItem-level discounts
totalnumber_or_stringOptionalTotal order amount
currencystringOptionalCurrency code (EUR, USD, etc.)

salesorder_order_type_info

FieldTypeRequiredDescription
typestringOptionalOrder type (instant, preorder)
preorder_timestringOptionalPreorder preparation time
preorder_statusstringOptionalPreorder status
preparation_time_secondsnumberOptionalPreparation time in seconds
preparation_time_sourcestringOptionalSource of preparation time (venue_default, forecasted_by_wolt, etc.)
acceptance_statusstringOptionalAcceptance status (to_be_accepted_by_venue, auto_accepted_by_wolt, etc.)
courier_arrivalstringOptionalCourier arrival notification status

salesorder_venue

FieldTypeRequiredDescription
idstringOptionalWolt venue ID
namestringOptionalVenue name
external_venue_idstringOptionalPartner external venue ID

salesorder_group_participant

FieldTypeRequiredDescription
namestringOptionalParticipant name
commentstringOptionalParticipant comment
payment_methodstringOptionalPayment method
payment_statusstringOptionalPayment status
item_idsstring[]OptionalOrder item IDs for this participant

salesorder_data

FieldTypeRequiredDescription
itemssalesorder_item[]OptionalOrder items
notesstringOptionalOrder notes
contactsalesorder_contactOptionalContact information
externalsalesorder_externalOptionalExternal system references
paymentssalesorder_payment[]OptionalPayment information
shippingsalesorder_shippingOptionalShipping address
woocommerceanyOptionalFull WooCommerce order data
delivery_methodstringOptionalDelivery method
deliverysalesorder_deliveryOptionalWolt delivery information
payment_detailssalesorder_payment_detailsOptionalWolt payment details
pricingsalesorder_pricingOptionalWolt pricing breakdown
order_type_infosalesorder_order_type_infoOptionalWolt order type and handling info
venuesalesorder_venueOptionalWolt venue information
group_participantssalesorder_group_participant[]OptionalWolt group order participants
woltanyOptionalFull Wolt order data
ext_idexternal_id[]OptionalExternal system IDs
additional_fieldsstringOptionalAdditional fields

salesorder

has idhas activetablecompany-scoped
FieldTypeRequiredDescription
order_datestringRequired
delivery_datestringRequired
payment_datestringRequired
referencestringRequired
statusstringRequired
customer_ididRequired
order_numnumberRequired
datasalesorder_dataRequired

salestarget_data_types

Configuration for sales target scope by product hierarchy

FieldTypeRequiredDescription
pluguid[]OptionalSpecific product IDs to include in target
dptguid[]OptionalDepartment IDs to include in target
grpguid[]OptionalGroup IDs to include in target

salestarget_data

Sales target configuration data structure

FieldTypeRequiredDescription
targetsalestarget_data_typesOptionalTarget scope configuration
campaignstringOptionalMarketing campaign associated with this target
multipliernumberOptionalMultiplier for target calculation (e.g., for discounts)
discount_ididOptionalSpecific discount ID to apply for this target

salestarget

has idhas activetablecompany-scoped

Sales targets for tracking performance against goals by location and time period

FieldTypeRequiredDescription
namestringRequiredDescriptive name for this sales target
location_ididRequiredLocation this target applies to
start_datedateRequiredTarget period start date
end_datedateOptionalTarget period end date (null for ongoing)
typeenum:salestarget_typeRequiredTarget type (daily, weekly, monthly, etc.)
datasalestarget_dataRequiredTarget configuration and scope settings

sales_target_data

tablecompany-scoped

Sales targets for each day

FieldTypeRequiredDescription
salestarget_ididRequiredSales target this data belongs to
businssday_ididRequiredBusiness day this target data applies to
target_datedateRequiredDate for this sales target data
grp_ididOptionalGroup ID for this target data
dpt_ididOptionalDepartment ID for this target data
plu_ididOptionalProduct ID for this target data
target_amountnumberRequiredTarget amount for this day
total_amountnumberRequiredTotal sales amount achieved for this day
dataanyOptionalAdditional data for this target (not used yet)

stock_unit

stock unit description, plu can have multiple stock units

FieldTypeRequiredDescription
namestringRequiredStock unit name
eanstringOptionalStock unit EAN code
multipliernumber_or_stringRequiredStock unit multiplier from base unit
stocknumber_or_stringOptionalNumber of units in stock
valuenumber_or_stringOptionalValue of single unit in stock
batch_valuenumber_or_stringOptionalValue of single unit in stock
balance_unitbooleanOptionalis this unit the main balance unit
inventory_unitbooleanOptionalis this unit used in inventory management
wastage_unitbooleanOptionalis this unit used to report wastage
order_unitbooleanOptionalis this unit used for ordering
supplier_namestringOptionalName of supplier (only for internal use)

stockeventitem_data_item

FieldTypeRequiredDescription
costamountRequired
unitstringRequired
stocknumberRequired
valueamountRequired
multipliernumberRequired

stockeventitem_dpt

FieldTypeRequiredDescription
idguidRequired
namestringRequired
dpt_numnumberRequired

stockeventitem_plu

FieldTypeRequiredDescription
idguidRequired
namestringRequired
productidstringRequired

stockeventitem_data

FieldTypeRequiredDescription
itemsstockeventitem_data_item[]Optional
valuenumberOptional
dptstockeventitem_dptOptional
plustockeventitem_pluOptional

stockeventitem

has idtable
FieldTypeRequiredDescription
stockevent_ididRequired
plu_ididRequired
timestampdatetimeRequired
original_qtynumberOptional
inventory_qtynumberOptional
delivered_qtynumberOptional
adjusted_qtynumberOptional
datastockeventitem_dataRequired

stocklist_item

FieldTypeRequiredDescription
idguidRequired
namestringRequired
typestringRequired
locationstringRequired
stock_unitsstock_unit[]Required
enteredbooleanRequired
current_stockstringOptional
eanstringOptional

stockevent_source

FieldTypeRequiredDescription
idstringRequired
typestringRequired

stockevent_currentstock

FieldTypeRequiredDescription
current_stocknumberRequired
default_unitstringRequired
default_multipliernumberRequired

stockevent_data

FieldTypeRequiredDescription
monthnumberOptional
liststocklist_item[]Optional
locationsstring[]Optional
sourcestockevent_sourceOptional
versionnumberOptional
current_stockstockevent_currentstockOptional
generateddatetimeOptional
destinationstringOptional
descriptionstringOptionaluser supplied description of this event
valueamountOptionalmonetary value of this stock event

stockevent

has idhas activetablecompany-scoped
FieldTypeRequiredDescription
location_ididOptional
supplier_ididOptional
timestampdatetimeRequired
typeenum:stockevent_typeRequired
statusenum:stockevent_statusRequired
datastockevent_dataRequired

sub_code

FieldTypeRequiredDescription
namestringRequired
descriptionstringRequired
functionstringRequired
targetstringRequired
amountnumberRequired

sales_line

FieldTypeRequiredDescription
idstringRequired
productIdstringRequired
qtynumberRequired
pricenumberRequired
taxguidRequired
amountTaxamountOptional
amountWithoutTaxamountOptional
productNamestringRequired
productGuidguidRequired
priceOverridebooleanOptional
commentstringOptional
seatintOptional
coursestringOptional
sentToKitchenbooleanOptional
isLinkedItembooleanOptional
priceKeyedInbooleanOptional
quantityKeyedInbooleanOptional
voidedbooleanOptional
descriptionstringOptional
deliveryenum:delivery_typeOptional
no_groupbooleanOptional
discountsdiscount_line[]Optional
no_discountbooleanOptional
infocodesreceipt_infocode[]Optional
modifiersstring[]Optional
pricingguidOptional
forceModifierbooleanOptional
topLevelPricebooleanOptional
startTimedatetimeOptional
endTimedatetimeOptional
menuItemguidOptional
taxSalestax_sales_line[]Optional

sales_data_plu

FieldTypeRequiredDescription
dpt_idguidRequired
tax_idguidRequired
plu_idguidRequired
qtynumberRequired
pricenumberRequired
totalnumberRequired
profitnumberRequired
deliverystringOptional

sales_data_tender

FieldTypeRequiredDescription
tender_idguidRequired
typestringRequired
totalnumberRequired
overpaynumberRequired

sales_data_discount

FieldTypeRequiredDescription
discount_idguidRequired
amountnumberRequired
original_amountnumberRequired
qtynumberRequired

sales_data_infocode

FieldTypeRequiredDescription
infocode_idguidRequired
targetstringRequired
valuestringRequired

sales_data

FieldTypeRequiredDescription
plusales_data_plu[]Required
tendersales_data_tender[]Required
discountsales_data_discount[]Required
infocodesales_data_infocode[]Required

sales

has idtablecompany-scoped
FieldTypeRequiredDescription
pos_ididRequired
cashier_ididRequired
customer_ididOptional
businessday_ididRequired
receipt_numintRequired
timestampdatetimeRequired
typestringRequired
voidbooleanRequired
editedbooleanRequired
receiptreceipt_serializedOptional

sales_target_data_request

Request model for updating sales target data

FieldTypeRequiredDescription
sales_target_idstringRequiredGUID of the sales target to update
target_datedateRequiredDate for which to update the target data
target_amountnumberRequiredTarget amount for the specified date
dataanyOptionalAdditional data for this target entry

stockevent_update_request

FieldTypeRequiredDescription
dataanyRequiredStock event data

sync_result

FieldTypeRequiredDescription
resultstringRequired
detailsanyOptional

stock_transaction_item

has idtable

Individual line item within a stock transaction

FieldTypeRequiredDescription
stock_transaction_idguid?OptionalParent transaction (set by backend)
product_idguidRequiredProduct being transacted
stock_unitstringRequiredUnit of measure
quantity_beforenumber?OptionalQuantity before transaction (calculated by backend)
quantity_changenumber?OptionalQuantity change (positive or negative)
quantity_afternumber?OptionalQuantity after transaction (calculated by backend)
quantitynumber?OptionalQuantity entered by user (converted to quantity_change by backend)
unit_costnumber?OptionalUnit cost for this transaction (in euros)
total_costamount?OptionalTotal cost for this line
dataanyOptionalAdditional item data (original entry unit, wastage reason, etc.)

stock_transaction

has idtablecompany-scoped

Stock transaction for inventory changes

FieldTypeRequiredDescription
location_idguidRequiredLocation where transaction occurs
supplier_idguid?OptionalSupplier for delivery transactions
transaction_typeenum:stock_transaction_typeRequiredType of stock transaction
statusenum:stock_transaction_statusRequiredCurrent transaction status
timestampdateRequiredWhen transaction occurred
business_datedateRequiredBusiness date for reporting
reference_numberstring?OptionalExternal reference number
descriptionstring?OptionalTransaction description
reasonstring?OptionalReason for transaction (e.g., wastage reason)
dataanyRequiredAdditional transaction data
wastage_reasonstring?OptionalWastage reason extracted from data
notesstring?OptionalNotes extracted from data
itemsstock_transaction_item[]OptionalTransaction line items

stock_state_v2

has idtablecompany-scoped

Real-time stock state tracking per product per location per unit

FieldTypeRequiredDescription
location_idguidRequiredLocation for this stock state
product_idguidRequiredProduct being tracked
stock_unitstringRequiredUnit of measure
current_quantitynumberRequiredCurrent available quantity
reserved_quantitynumberRequiredQuantity reserved for transfers/orders
unit_costamountOptionalCurrent unit cost
total_valueamountOptionalTotal inventory value
last_movement_datedatetimeOptionalLast stock movement date
last_transaction_idguidOptionalLast transaction that affected this state
versionintRequiredVersion for optimistic locking

stock_cost_layer

has idtablecompany-scoped

Cost layers for FIFO/LIFO stock valuation methods

FieldTypeRequiredDescription
location_idguidRequiredLocation for this cost layer
product_idguidRequiredProduct in this layer
stock_unitstringRequiredUnit of measure
layer_datedateRequiredDate this layer was created
remaining_quantitynumberRequiredRemaining quantity in this layer
unit_costamountRequiredUnit cost for this layer
source_transaction_idguidOptionalTransaction that created this layer

stock_reservation

has idtablecompany-scoped

Tracks stock reservations for pending transfers and orders

FieldTypeRequiredDescription
location_idguidRequiredLocation where stock is reserved
product_idguidRequiredProduct being reserved
stock_unitstringRequiredUnit of measure
reserved_quantitynumberRequiredQuantity reserved
reference_idguidRequiredReference to the entity requiring reservation
reference_typestringRequiredType of entity (transfer_request, sales_order, etc.)
reservation_datedatetimeRequiredWhen reservation was made
expiry_datedatetimeOptionalWhen reservation expires
notesstringOptionalReservation notes
statusstringRequiredReservation status (active, fulfilled, expired, cancelled)

stock_count_scope

FieldTypeRequiredDescription
dpt_idsguid[]OptionalDepartment IDs to include
grp_idsguid[]OptionalGroup IDs to include
product_idsguid[]OptionalSpecific product IDs
abc_classesstring[]OptionalABC classification classes
min_valueamountOptionalMinimum inventory value
max_valueamountOptionalMaximum inventory value
movement_period_daysintOptionalInclude products with movement in last N days
storage_locationsstring[]OptionalStorage locations to include
exclude_zero_stockbooleanOptionalExclude products with zero stock
exclude_negative_stockbooleanOptionalExclude products with negative stock

stock_count_progress

FieldTypeRequiredDescription
total_itemsintRequiredTotal items to count
counted_itemsintRequiredItems already counted
variance_itemsintRequiredItems with variance
completion_percentagenumberRequiredCompletion percentage
estimated_time_remainingintOptionalEstimated minutes remaining

stock_count_session

has idtablecompany-scoped

Physical inventory counting session

FieldTypeRequiredDescription
location_idguidRequiredLocation being counted
session_namestringOptionalName/description of count session
count_typeenum:stock_count_typeRequiredType of inventory count
statusenum:stock_count_statusOptionalCurrent status
scheduled_datedateOptionalScheduled count date
started_atdatetimeOptionalWhen counting started
completed_atdatetime?OptionalWhen counting completed
scope_criteriaany?OptionalCriteria for what to count

stock_count_item

has idtable

Individual product count within a count session

FieldTypeRequiredDescription
count_session_idguidRequiredParent count session
product_idguidRequiredProduct being counted
stock_unitstringRequiredUnit being counted
expected_quantitynumberRequiredExpected quantity from system
counted_quantitynumberOptionalActual counted quantity
variancenumberOptionalDifference between expected and counted
variance_percentagenumberOptionalVariance as percentage
unit_costamountOptionalUnit cost at time of count (snapshotted)
variance_valueamountOptionalMonetary value of variance
count_datedatetimeOptionalWhen this item was counted
counter_user_idguidOptionalUser who counted this item
notesstringOptionalNotes about this count
requires_recountbooleanOptionalWhether item needs recount due to large variance

stock_count_variance_summary

FieldTypeRequiredDescription
total_items_countedintRequiredTotal items counted
items_with_varianceintRequiredItems with variance
positive_variance_itemsintRequiredItems with positive variance
negative_variance_itemsintRequiredItems with negative variance
total_variance_valueamountRequiredTotal monetary variance
largest_variance_itemguidOptionalProduct with largest variance
largest_variance_amountamountOptionalLargest variance amount
accuracy_percentagenumberRequiredOverall count accuracy percentage

stock_transfer_approval

FieldTypeRequiredDescription
approved_byguidRequiredUser who approved
approved_atdatetimeRequiredWhen approval was given
approval_notesstringOptionalApproval notes
conditionsstringOptionalAny conditions on approval

stock_transfer_shipping

FieldTypeRequiredDescription
shipped_byguidOptionalUser who shipped
shipped_atdatetimeOptionalWhen shipment occurred
carrierstringOptionalShipping carrier
tracking_numberstringOptionalShipment tracking number
estimated_arrivaldatetimeOptionalEstimated arrival time
shipping_notesstringOptionalShipping notes

stock_transfer_receiving

FieldTypeRequiredDescription
received_byguidOptionalUser who received
received_atdatetimeOptionalWhen receipt occurred
condition_on_arrivalstringOptionalCondition of goods on arrival
damage_notesstringOptionalAny damage noted
receiving_notesstringOptionalReceiving notes

stock_transfer_request

has idtablecompany-scoped

Request to transfer stock between locations

FieldTypeRequiredDescription
from_location_idguidRequiredSource location
to_location_idguidRequiredDestination location
request_numberstringRequiredUnique request number
statusenum:stock_transfer_statusRequiredCurrent status
priorityenum:stock_transfer_priorityOptionalTransfer priority
requested_datedateRequiredDate transfer was requested
required_datedateOptionalDate transfer is required by
notesstringOptionalTransfer request notes

stock_transfer_request_item

has idtable

Individual product item in a transfer request

FieldTypeRequiredDescription
transfer_request_idguidRequiredParent transfer request
product_idguidRequiredProduct being transferred
stock_unitstringRequiredUnit of transfer
requested_quantitynumberRequiredOriginally requested quantity
approved_quantitynumberOptionalApproved quantity for transfer
shipped_quantitynumberOptionalActually shipped quantity
received_quantitynumberOptionalActually received quantity
unit_costamountOptionalUnit cost for valuation

stock_transfer_batch

has idtable

Batch tracking for transfer items

FieldTypeRequiredDescription
transfer_item_idguidRequiredParent transfer item
batch_numberstringRequiredBatch/lot number
quantitynumberRequiredQuantity from this batch
expiry_datedateOptionalBatch expiry date
received_conditionstringOptionalCondition when received

stock_transfer_summary

FieldTypeRequiredDescription
total_requestsintRequiredTotal transfer requests
completed_transfersintRequiredCompleted transfers
pending_approvalintRequiredTransfers pending approval
in_transitintRequiredTransfers in transit
total_value_transferredamountRequiredTotal value of transfers
average_completion_timenumberOptionalAverage completion time in hours
variance_itemsintRequiredItems with shipping/receiving variance

stock_notification_data

FieldTypeRequiredDescription
company_idguidOptionalRelated company
location_idguidOptionalRelated location
product_idguidOptionalRelated product
current_stocknumberOptionalCurrent stock level
warning_limitnumberOptionalWarning threshold
previous_stocknumberOptionalPrevious stock level
transaction_idguidOptionalRelated transaction
movement_amountnumberOptionalStock movement amount
movement_valueamountOptionalMonetary value of movement
count_session_idguidOptionalRelated count session
variance_countintOptionalNumber of items with variance
total_variance_valueamountOptionalTotal variance value
error_typestringOptionalType of error
error_detailsstringOptionalDetailed error information
affected_recordsintOptionalNumber of affected records
severitystringOptionalNotification severity (low, medium, high, critical)
custom_fieldsanyOptionalAdditional custom data

stock_notification

has idtable

Stock system event notifications

FieldTypeRequiredDescription
typestringRequiredType of notification
recipientstringRequiredNotification recipient (email, phone, webhook URL, etc.)
subjectstringRequiredNotification subject/title
bodystringRequiredNotification message body
dataanyRequiredNotification data payload
delivery_methodsany[]RequiredDelivery methods to use
statusstringRequiredCurrent notification status
delivery_resultsanyOptionalDelivery attempt results
delivered_atdatetimeOptionalWhen notification was delivered
retry_countintOptionalNumber of delivery retry attempts
max_retriesintOptionalMaximum retry attempts allowed
next_retry_atdatetimeOptionalWhen to attempt next retry

stock_notification_rule

has idtablecompany-scoped

Rules for automatic stock notification generation

FieldTypeRequiredDescription
rule_namestringRequiredHuman readable rule name
descriptionstringOptionalRule description
notification_typestringRequiredType of notification this rule generates
location_idsany[]OptionalLocations this rule applies to
product_idsany[]OptionalProducts this rule applies to
dpt_idsany[]OptionalDepartments this rule applies to
conditionsanyRequiredJSON conditions that trigger this rule
threshold_valuesanyOptionalThreshold values for conditions
recipientsany[]RequiredDefault recipients for notifications
delivery_methodsany[]RequiredDelivery methods to use
message_templatestringOptionalCustom message template
subject_templatestringOptionalCustom subject template
immediate_notificationbooleanOptionalSend notification immediately
digest_frequencystringOptionalDigest frequency (hourly, daily, weekly)
quiet_hours_startstringOptionalStart of quiet hours (HH:MM)
quiet_hours_endstringOptionalEnd of quiet hours (HH:MM)
activebooleanRequiredWhether rule is active
created_byguidOptionalUser who created rule

stock_notification_subscription

has idtable

User subscriptions to stock notifications

FieldTypeRequiredDescription
user_idguidRequiredSubscribing user
company_idguidRequiredCompany context
location_idsany[]OptionalLocations user is interested in
notification_typesany[]RequiredTypes of notifications to receive
delivery_methodsany[]RequiredPreferred delivery methods
email_addressstringOptionalEmail address for notifications
phone_numberstringOptionalPhone number for SMS
slack_channelstringOptionalSlack channel for notifications
immediate_notificationsbooleanOptionalReceive immediate notifications
digest_frequencystringOptionalDigest frequency preference
quiet_hours_startstringOptionalPersonal quiet hours start
quiet_hours_endstringOptionalPersonal quiet hours end
activebooleanRequiredWhether subscription is active

stock_daily_snapshot

has idtablecompany-scoped

Daily snapshot of stock movements and quantities for reporting

FieldTypeRequiredDescription
location_idguidRequiredLocation for this snapshot
product_idguidRequiredProduct being tracked
business_datedateRequiredBusiness date for this snapshot
stock_unitstringRequiredUnit of measure
opening_quantitynumberRequiredOpening stock quantity at start of day
closing_quantitynumberRequiredClosing stock quantity at end of day
deliveries_qtynumberRequiredTotal deliveries quantity
sales_qtynumberRequiredTotal sales quantity
wastage_qtynumberRequiredTotal wastage quantity
transfers_in_qtynumberRequiredTotal transfers in quantity
transfers_out_qtynumberRequiredTotal transfers out quantity
adjustments_qtynumberRequiredTotal adjustments quantity
inventory_adjustments_qtynumberRequiredTotal inventory adjustments quantity
opening_valueamountOptionalOpening stock value
closing_valueamountOptionalClosing stock value
deliveries_valueamountRequiredTotal deliveries value
sales_valueamountRequiredTotal sales value
wastage_valueamountRequiredTotal wastage value
transfers_in_valueamountRequiredTotal transfers in value
transfers_out_valueamountRequiredTotal transfers out value
adjustments_valueamountRequiredTotal adjustments value
inventory_adjustments_valueamountRequiredTotal inventory adjustments value
weighted_avg_costamountOptionalWeighted average cost
cost_layers_snapshotanyOptionalSnapshot of cost layers
transaction_countintRequiredNumber of transactions processed
last_calculated_atdatetimeOptionalWhen snapshot was last calculated
created_atdatetimeOptionalWhen snapshot was created

stock_movement_summary

Summary of stock movements for reporting

FieldTypeRequiredDescription
company_idguidRequiredCompany
location_idguidRequiredLocation
product_idguidRequiredProduct
summary_datedateRequiredDate of summary
summary_periodstringRequiredSummary period (daily, weekly, monthly)
opening_balancenumberRequiredOpening stock balance
deliveriesnumberRequiredTotal deliveries
usagenumberRequiredTotal usage/consumption
wastagenumberRequiredTotal wastage
transfers_innumberRequiredTransfers into location
transfers_outnumberRequiredTransfers out of location
adjustmentsnumberRequiredInventory adjustments
closing_balancenumberRequiredClosing stock balance
opening_valueamountOptionalOpening stock value
closing_valueamountOptionalClosing stock value
average_costamountOptionalAverage cost during period
total_movementsintRequiredTotal number of movements
delivery_countintRequiredNumber of delivery transactions
usage_countintRequiredNumber of usage transactions
adjustment_countintRequiredNumber of adjustment transactions

stock_aging_band

FieldTypeRequiredDescription
band_namestringRequiredAge band name (e.g., "0-30 days")
min_daysintRequiredMinimum age in days
max_daysintOptionalMaximum age in days (null for last band)
quantitynumberRequiredQuantity in this age band
valueamountRequiredValue in this age band
percentage_of_totalnumberRequiredPercentage of total stock

stock_aging_analysis

Stock aging analysis for inventory management

FieldTypeRequiredDescription
company_idguidRequiredCompany
location_idguidRequiredLocation
product_idguidRequiredProduct
analysis_datedateRequiredDate of analysis
current_quantitynumberRequiredCurrent stock quantity
current_valueamountRequiredCurrent stock value
average_age_daysnumberRequiredAverage age of stock in days
oldest_stock_daysintRequiredAge of oldest stock in days
age_bandsstock_aging_band[]RequiredStock broken down by age bands
slow_movingbooleanRequiredFlagged as slow moving stock
obsolete_riskbooleanRequiredAt risk of becoming obsolete
recommended_actionstringOptionalRecommended action

stock_forecast_data

FieldTypeRequiredDescription
forecast_datedateRequiredDate of forecast
forecasted_demandnumberRequiredForecasted demand quantity
confidence_levelnumberRequiredConfidence level (0-1)
lower_boundnumberOptionalLower confidence bound
upper_boundnumberOptionalUpper confidence bound
seasonal_factornumberOptionalSeasonal adjustment factor

stock_forecast

Stock demand forecasting

FieldTypeRequiredDescription
company_idguidRequiredCompany
location_idguidRequiredLocation
product_idguidRequiredProduct
forecast_periodstringRequiredForecast period (weekly, monthly)
generated_atdatetimeRequiredWhen forecast was generated
historical_periodsintRequiredNumber of historical periods used
data_quality_scorenumberRequiredQuality of historical data (0-1)
forecast_datastock_forecast_data[]RequiredForecast data points
average_demandnumberRequiredAverage forecasted demand
peak_demandnumberRequiredPeak forecasted demand
demand_volatilitynumberRequiredDemand volatility measure
recommended_reorder_pointnumberOptionalRecommended reorder point
recommended_order_quantitynumberOptionalRecommended order quantity
recommended_safety_stocknumberOptionalRecommended safety stock

stock_kpi

Key Performance Indicators for stock management

FieldTypeRequiredDescription
company_idguidRequiredCompany
location_idguidOptionalLocation (null for company-wide)
kpi_datedateRequiredDate of KPI calculation
kpi_periodstringRequiredKPI period (daily, weekly, monthly)
inventory_turnover_rationumberOptionalInventory turnover ratio
days_of_inventorynumberOptionalDays of inventory on hand
stockout_incidentsintRequiredNumber of stockout incidents
stockout_duration_hoursnumberOptionalTotal hours of stockouts
inventory_accuracy_percentagenumberOptionalInventory accuracy percentage
cycle_count_accuracynumberOptionalCycle count accuracy percentage
shrinkage_percentagenumberOptionalInventory shrinkage percentage
carrying_cost_percentagenumberOptionalInventory carrying cost percentage
obsolete_inventory_valueamountOptionalValue of obsolete inventory
slow_moving_inventory_valueamountOptionalValue of slow-moving inventory
fill_rate_percentagenumberOptionalOrder fill rate percentage
perfect_order_percentagenumberOptionalPerfect order percentage
receiving_efficiencynumberOptionalReceiving process efficiency
counting_efficiencynumberOptionalInventory counting efficiency
transfer_completion_ratenumberOptionalTransfer completion rate

T

27 model(s)

timesheet_wage

FieldTypeRequiredDescription
idstringOptionalWage type ID
namestringRequiredWage type name
otherstringRequiredAdditional wage information
time_fromstringRequiredStart time for wage calculation
time_tostringRequiredEnd time for wage calculation
daysboolean[]RequiredDays of week when wage applies

timesheet_parameters

FieldTypeRequiredDescription
activebooleanOptionalEnable timesheet tracking
add_minutes_after_shiftnumberOptionalMinutes to add after shift ends
sub_minutes_before_shiftnumberOptionalMinutes to subtract before shift starts
wagestimesheet_wage[]OptionalWage calculation rules

time_slot_template

FieldTypeRequiredDescription
idguidRequired
start_timestringRequired
end_timestringRequired
descriptionstringRequired

tax

has idhas activetable

Tax rates

FieldTypeRequiredDescription
namestringRequiredName of the tax rate
taxnumberRequiredTax rate as a decimal number (e.g. 0.14 for 14%)
tax_numintRequiredTax number, used for tax reporting
validitystartdateRequiredStart date of the tax rate validity
validityenddate?OptionalEnd date of the tax rate validity, if applicable

tender_data

FieldTypeRequiredDescription
tender_typeenum:tender_typeOptional
printout_typeenum:printout_typeOptional
tender_useenum:tender_useOptional
cashdrawerenum:cashdrawer_openOptional
change_typeenum:change_typeOptional
change_tenderguidOptional
lunch_voucherenum:lunchvoucher_typeOptional
commission_tenderstringOptional
commission_percentagestringOptional
eftbooleanOptional
roundingnumber?Optional
over_tenderbooleanOptional
under_tenderbooleanOptional
require_commentbooleanOptional
reportstringOptional
invoice_customerguidOptional
invoice_customergroupguidOptional
additional_fieldsstringOptionalAdditional fields

tender_sales_history_month

FieldTypeRequiredDescription
datedateRequired
countnumber?Required
totalstring?Required

tender_sales_history

FieldTypeRequiredDescription
month_salestender_sales_history_month[]Required

tender

has idhas activetablecompany-scoped
FieldTypeRequiredDescription
tender_numnumberRequiredtender number
namestringRequiredtender name
datatender_dataRequired
sales_historytender_sales_history?Optional

timesheet_wages

FieldTypeRequiredDescription
endstringRequired
costnumberRequired
namestringRequired
wagestringRequired
hoursnumberRequired
startstringRequired

timesheet_data

FieldTypeRequiredDescription
locationguidOptional
login_trxstringOptional
login_timestringRequired
logoff_trxstringOptional
logoff_timestringOptional
wagestimesheet_wages[]Optional
close_day_trxstringOptional

timesheet

has idtablecompany-scoped
FieldTypeRequiredDescription
cashier_ididRequired
businessday_ididRequired
statestringRequired
hoursnumberRequired
log_onstringRequired
log_offstringRequired
editedbooleanRequired
datatimesheet_dataRequired

tax_sales_line

FieldTypeRequiredDescription
taxguidRequired
taxAmountamountRequired
taxlessAmountamountRequired
totalAmountamountRequired

tax_line

FieldTypeRequiredDescription
taxGuidguidRequired
taxNamestringRequired
taxPercentnumberRequired
taxAmountamountRequired
taxlessAmountamountRequired
totalAmountamountRequired

tender_line

FieldTypeRequiredDescription
idstringRequired
voidedbooleanOptional
tenderIdstringRequired
tenderTypeenum:tender_line_typeRequired
tenderGuidguidRequired
tenderNamestringRequired
qtynumberRequired
amountamountRequired
totalamountRequired
overTenderamountRequired
cardPaymentcard_paymentOptional
infocodesreceipt_infocode[]Optional

table_statechange

FieldTypeRequiredDescription
newStatestringRequired
timestampdatetimeRequired
operationstringOptional
totalnumberOptional

tendersales

table
FieldTypeRequiredDescription
company_ididRequired
pos_ididRequired
tender_ididRequired
businessday_ididRequired
receipt_numintRequired
timestampdatetimeRequired
typeenum:tendersales_typeRequired
totalamountRequired
overpayamountRequired
sales_ididRequired

taxsales

table
FieldTypeRequiredDescription
company_ididRequired
pos_ididRequired
businessday_ididRequired
tax_ididRequired
plu_ididRequired
plusales_ididRequired
tax_amountamountRequired
taxless_amountamountRequired
total_amountamountRequired

tokens

FieldTypeRequiredDescription
authstringOptional

totp_enable_response

TOTP enable response with QR code

FieldTypeRequiredDescription
secretstringRequiredBase32-encoded TOTP secret
qrCodeUrlstringRequiredData URL for QR code image
otpauthUrlstringRequiredotpauth:// URI for manual entry

totp_verify_request

TOTP verification request

FieldTypeRequiredDescription
tokenstringRequired6-digit TOTP code

totp_verify_response

TOTP verification response

FieldTypeRequiredDescription
resultstringRequiredOperation result (OK/FAIL)
errorstringOptionalError message if failed

totp_status_response

TOTP status response

FieldTypeRequiredDescription
enabledbooleanRequiredWhether TOTP is enabled
backup_codes_countintRequiredNumber of remaining backup codes

totp_backup_codes_response

Generated backup codes

FieldTypeRequiredDescription
resultstringRequiredOperation result (OK/FAIL)
codesstring[]OptionalArray of backup codes
errorstringOptionalError message if failed

totp_disable_response

TOTP disable response

FieldTypeRequiredDescription
resultstringRequiredOperation result (OK/FAIL)

tender_change_list_response

FieldTypeRequiredDescription
changesany[]Required

token_response

FieldTypeRequiredDescription
idstringRequired
validity_endstringRequired
hoststringRequired
companystringRequired
tokenstringRequired

task_list_response

FieldTypeRequiredDescription
tasksany[]Required

U

7 model(s)

user_webauthn

FieldTypeRequiredDescription
dummystringOptional

user_settings

FieldTypeRequiredDescription
themestringOptional
languagestringOptional
adminModeboolean?Optional
resellerModeboolean?Optional
component_sizestringOptional
entry_variantstringOptional
date_formatstringOptional
date_range_pickerstringOptional
dashboardsdashboard_settingsOptional

user_data

FieldTypeRequiredDescription
skypestringOptional
phonestringOptional
picturestringOptional
featuresstringRequired
webauthnuser_webauthn[]Optional
sitestringOptional
settingsuser_settingsOptional
totp_enabledboolean?OptionalIs TOTP 2FA enabled for this user?
totp_secretstringOptionalTOTP secret for 2FA, if TOTP is enabled. base32 encoded.
totp_backup_codesstring[]OptionalList of TOTP backup codes for this user.

user_company

has id
FieldTypeRequiredDescription
namestringRequired
display_namestring?Required
groupstring?Required
statestring?Required

user

has idhas activetable
FieldTypeRequiredDescription
emailemailRequired
passstringRequired
namestringRequired
lockedbooleanRequired
datauser_dataRequired
admindataanyRequired
adminboolean?OptionalIs this user admin?
resellerboolean?OptionalIs this user a reseller?
companiesuser_company[]Optional

user_companies_request

FieldTypeRequiredDescription
user_idstringRequiredUser GUID
companiesany[]RequiredList of company objects with id and checked fields

user_create_request

FieldTypeRequiredDescription
namestringRequired
emailemailRequired

V

2 model(s)

voucher_line

FieldTypeRequiredDescription
idstringOptional
signstringOptional
valuestringOptional
vatcodestringOptional
vatpercentnumberOptional
descriptionstringOptional
accountnumbernumber_or_stringOptional
dimensionsexternal_dimension[]Optional

vipps_list_response

FieldTypeRequiredDescription
paymentsany[]Required

W

38 model(s)

woocommerce_parameters

FieldTypeRequiredDescription
activebooleanOptionalEnable WooCommerce integration
store_urlurlOptionalWooCommerce store URL
consumer_keystringOptionalWooCommerce consumer key
consumer_secretstringOptionalWooCommerce consumer secret
syncsync_settingsOptional

weeklyreport_data_availability

Feature flags indicating what data is available for weekly reports

FieldTypeRequiredDescription
has_margins_databooleanOptionalProduct margin/cost data is available
has_stock_databooleanOptionalInventory/stock tracking data is available
has_profit_databooleanOptionalProfit calculation data is available
has_campaigns_databooleanOptionalMarketing campaign data is available
has_sales_targets_databooleanOptionalSales target tracking data is available
has_discount_databooleanOptionalDiscount/promotion tracking data is available
has_labor_databooleanOptionalLabor cost and scheduling data is available
has_staff_databooleanOptionalStaff/cashier performance data is available
has_table_turnover_databooleanOptionalTable turnover and seating data is available
has_kitchen_performance_databooleanOptionalKitchen efficiency and timing data is available
has_customer_databooleanOptionalCustomer information and profiles are available
has_loyalty_databooleanOptionalCustomer loyalty program data is available
has_feedback_databooleanOptionalCustomer feedback and rating data is available
has_sustainability_databooleanOptionalWaste tracking and sustainability metrics are available
has_energy_databooleanOptionalEnergy consumption data is available
has_waste_trackingbooleanOptionalFood waste tracking data is available

weeklyreport_parameters

Weekly report configuration parameters

FieldTypeRequiredDescription
refnumnumberOptionalReference number for the report
email_recipientsstringOptionalEmail addresses for automated report delivery
auto_deliverybooleanOptionalEnable automatic report delivery
report_formatstringOptionalReport output format: pdf, excel, dashboard, email
report_schedulestringOptionalAutomated delivery schedule: monday_morning, sunday_evening, etc.
dashboard_refresh_intervalnumberOptionalDashboard auto-refresh interval in minutes
data_availabilityweeklyreport_data_availabilityOptionalFlags indicating what data is available for reporting
include_recommendationsbooleanOptionalInclude AI-generated recommendations in report
include_forecastbooleanOptionalInclude predictive analytics and forecasting
compare_to_previous_periodsbooleanOptionalInclude period-over-period comparisons
include_staff_performancebooleanOptionalInclude detailed staff performance metrics
include_customer_analyticsbooleanOptionalInclude customer behavior and loyalty analytics
include_sustainability_metricsbooleanOptionalInclude sustainability and waste tracking
include_marketing_roibooleanOptionalInclude marketing campaign ROI analysis
include_campaign_performancebooleanOptionalInclude active campaign performance tracking
include_sales_target_analysisbooleanOptionalInclude sales target achievement analysis
custom_kpisany[]OptionalCustom KPIs and metrics to include
alert_thresholdsanyOptionalCustom alert thresholds for key metrics

wolt_data

FieldTypeRequiredDescription
activebooleanOptionalWolt data is active
is_test_modebooleanOptionalIndicates if the Wolt integration uses test environment
venue_idstringOptionalWolt venue identifier
access_tokenstringOptionalWolt API access token
expires_atdatetimeOptionalExpiration time of the Wolt access token
refresh_tokenstringOptionalWolt API refresh token
is_onlinebooleanOptionalIndicates if the location is currently online on Wolt
prep_time_durationintOptionalPreparation time duration in minutes for Wolt orders
pre_order_pre_time_durationintOptionalPre-order preparation time duration in minutes for Wolt orders
max_acceptance_prep_time_durationintOptionalMaximum acceptance preparation time duration in minutes for Wolt orders
sales_channelguidOptionalReference to the sales channel used for Wolt orders
tender_idguidOptionalReference to the tender used for Wolt payments
supported_languagesstring[]OptionalList of supported languages for Wolt orders
last_syncdatetimeOptionalTimestamp of the last synchronization with Wolt

weeklyreport_cash

V1: Cash handling and reconciliation metrics

FieldTypeRequiredDescription
endCashnumberRequiredCash amount at end of business period
paidOutsnumberRequiredTotal paid out amounts during period
beginCashnumberRequiredCash amount at start of business period
cashDropsnumberRequiredCash drops/safe deposits during period

weeklyreport_daysales

V1: Daily sales performance and transaction metrics

FieldTypeRequiredDescription
countnumberRequiredTotal number of transactions
totalnumberRequiredTotal sales amount
eat_innumberRequiredDine-in sales amount
take_outnumberRequiredTakeout/delivery sales amount
avg_ticketnumberOptionalAverage transaction value (ATV)
peak_hourstringOptionalHour with highest sales volume
peak_hour_salesnumberOptionalSales amount during peak hour
comparison_previous_weeknumberOptionalPercentage change vs previous week
comparison_previous_yearnumberOptionalPercentage change vs same period last year
gross_salesnumberOptionalGross sales before discounts/taxes
net_salesnumberOptionalNet sales after discounts/taxes
target_amountnumberOptionalSales target for the day
target_variancenumberOptionalVariance from sales target (%)
target_achievement_percentagenumberOptionalTarget achievement percentage
active_campaignsany[]OptionalActive campaigns affecting this day sales
campaign_attributed_salesnumberOptionalSales attributed to active campaigns

weeklyreport_taxsales

V1: Tax collection and compliance reporting

FieldTypeRequiredDescription
namestringRequiredTax category name
totalnumberRequiredTotal tax amount collected
tax_numnumberRequiredTax category number/identifier
netsalesnumberRequiredNet sales amount for this tax category
tax_ratenumberOptionalTax rate percentage
taxable_amountnumberOptionalTaxable amount before tax application

weeklyreport_tendersales

V1: Payment method analysis and transaction breakdown

FieldTypeRequiredDescription
guidguidRequiredUnique identifier for tender type
namestringRequiredPayment method name (cash, card, etc.)
totalnumberRequiredTotal amount processed via this payment method
overpaynumberRequiredOverpay amount (change given)
transaction_countnumberOptionalNumber of transactions using this payment method
avg_transactionnumberOptionalAverage transaction amount for this payment method

weeklyreport_category_sales

Product category performance and trend analysis

FieldTypeRequiredDescription
dpt_ididRequiredDepartment ID for the category
categorystringRequiredProduct category name (appetizers, mains, beverages, etc.)
totalnumberRequiredTotal sales amount for this category
percentagenumberRequiredPercentage of total sales this category represents
profit_marginnumberOptionalProfit margin percentage for this category
quantity_soldnumberOptionalTotal quantity of items sold in this category
avg_item_pricenumberOptionalAverage price per item in this category
trend_directionstringOptionalTrend direction: up, down, stable
target_amountnumberOptionalSales target for this category
target_achievementnumberOptionalTarget achievement percentage
campaign_impactanyOptionalImpact of active campaigns on this category

weeklyreport_category_sales_per_day

Daily breakdown of sales by category to identify weekday patterns

FieldTypeRequiredDescription
dpt_ididRequiredDepartment ID for the category
categorystringRequiredProduct category name
weekdaystringRequiredDay of week (monday, tuesday, wednesday, etc.)
datestringRequiredActual date (YYYY-MM-DD format)
totalnumberRequiredTotal sales amount for this category on this day
quantity_soldnumberOptionalQuantity of items sold in this category on this day
transaction_countnumberOptionalNumber of transactions containing items from this category
percentage_of_week_totalnumberOptionalPercentage of the weeks total for this category
avg_item_pricenumberOptionalAverage item price for this category on this day

weeklyreport_top_item

Menu item performance analysis and ranking

FieldTypeRequiredDescription
plu_ididRequiredProduct lookup code/ID
namestringRequiredItem name
quantitynumberRequiredQuantity sold
totalnumberRequiredTotal revenue from this item
profitnumberOptionalProfit amount from this item
trendnumberOptionalPercentage change vs previous week
profit_margin_percentnumberOptionalProfit margin as percentage
dpt_ididRequiredDepartment ID for the category
categorystringOptionalItem category
daypart_performanceanyOptionalPerformance by meal period (breakfast, lunch, dinner)
recommendationstringOptionalMenu engineering recommendation (star, puzzle, plow, dog)

weeklyreport_hourly_sales

Hourly sales patterns and peak period analysis

FieldTypeRequiredDescription
hourstringRequiredHour of the day (24-hour format)
totalnumberRequiredTotal sales amount for this hour
countnumberRequiredNumber of transactions in this hour
avg_receipt_valuenumberOptionalAverage transaction value for this hour
kitchen_volumenumberOptionalKitchen order volume correlation
staff_countnumberOptionalNumber of staff working during this hour
sales_per_staffnumberOptionalSales per staff member ratio

weeklyreport_labor

Labor cost analysis and efficiency metrics

FieldTypeRequiredDescription
total_hoursnumberRequiredTotal labor hours worked during period
total_costnumberRequiredTotal labor cost for the period
percentage_of_salesnumberRequiredLabor cost as percentage of sales
sales_per_labor_hournumberRequiredSales generated per labor hour
daily_breakdownany[]OptionalDay-by-day labor analysis
overtime_hoursnumberOptionalTotal overtime hours
overtime_costnumberOptionalTotal overtime cost
peak_vs_slow_efficiencyanyOptionalLabor efficiency during peak vs slow periods
forecast_next_weekanyOptionalProjected labor needs for upcoming week

weeklyreport_recommendation

Data-driven business recommendations and action items

FieldTypeRequiredDescription
categorystringRequiredRecommendation category: staffing, menu, promotion, operations, etc.
descriptionstringRequiredDetailed recommendation description
impactstringRequiredExpected impact level: high, medium, low
action_itemstringOptionalSpecific action to take
prioritynumberOptionalPriority ranking (1=highest)
responsible_rolestringOptionalRole responsible for implementation
timelinestringOptionalSuggested implementation timeline
data_sourcestringOptionalData that led to this recommendation
expected_roinumberOptionalExpected return on investment

weeklyreport_table_turnover

Table utilization and turnover optimization metrics

FieldTypeRequiredDescription
table_typestringRequiredTable type or size category
avg_dining_durationnumberRequiredAverage dining duration in minutes
turnover_ratenumberRequiredNumber of turns per day/period
revenue_per_seat_hournumberRequiredRevPASH - Revenue per available seat hour
utilization_percentagenumberRequiredTable utilization as percentage
bottleneck_typestringOptionalPrimary bottleneck: kitchen, service, seating
peak_period_performanceanyOptionalPerformance during peak hours
recommendationsstring[]OptionalTurnover optimization recommendations

weeklyreport_kitchen_performance

Kitchen efficiency and order preparation metrics

FieldTypeRequiredDescription
avg_prep_time_by_categoryanyRequiredAverage preparation time by menu category
kds_metricsanyOptionalKitchen Display System performance metrics
order_accuracy_ratenumberRequiredPercentage of orders prepared correctly
ticket_time_trendsanyRequiredTicket time analysis during different periods
peak_period_avg_timenumberRequiredAverage preparation time during peak periods
slow_period_avg_timenumberRequiredAverage preparation time during slow periods
workflow_bottlenecksstring[]OptionalIdentified kitchen workflow issues
improvement_opportunitiesstring[]OptionalKitchen workflow improvement suggestions

weeklyreport_inventory_analysis

Inventory management and waste analysis

FieldTypeRequiredDescription
key_ingredient_usageanyRequiredUsage rates for key ingredients
theoretical_vs_actualanyRequiredVariance between theoretical and actual usage
stockoutsany[]OptionalStock-out incidents and sales impact
wastage_reportanyRequiredFood waste tracking with cost impact
ingredient_price_trendsanyOptionalPrice trend alerts for key ingredients
ordering_suggestionsany[]OptionalAuto-generated ordering recommendations
inventory_turnovernumberOptionalInventory turnover rate
carrying_costnumberOptionalInventory carrying cost

weeklyreport_customer_loyalty

Customer loyalty and retention analysis

FieldTypeRequiredDescription
repeat_customer_percentagenumberRequiredPercentage of customers who are repeat visitors
new_customer_percentagenumberRequiredPercentage of customers who are new
avg_visit_frequencynumberRequiredAverage visits per customer per period
customer_lifetime_valuenumberOptionalEstimated customer lifetime value
loyalty_tier_performanceany[]OptionalPerformance by loyalty program tiers
churn_risk_customersnumberOptionalNumber of customers at risk of churning
retention_ratenumberOptionalCustomer retention rate percentage

weeklyreport_customer_feedback

Customer satisfaction and feedback metrics

FieldTypeRequiredDescription
avg_food_ratingnumberRequiredAverage food quality rating
avg_service_ratingnumberRequiredAverage service quality rating
avg_ambiance_ratingnumberRequiredAverage ambiance rating
overall_satisfactionnumberRequiredOverall customer satisfaction score
sentiment_analysisanyOptionalSentiment analysis of written feedback
trending_topicsstring[]OptionalTrending topics or concerns from feedback
issue_resolution_ratenumberOptionalRate of customer issue resolution
nps_scorenumberOptionalNet Promoter Score

weeklyreport_forecast_daily_prediction

Individual daily prediction with confidence intervals

FieldTypeRequiredDescription
datestringRequiredForecast date (YYYY-MM-DD)
day_of_weekstringRequiredDay of the week (Monday, Tuesday, etc.)
predictionnumberRequiredPrimary forecast value
lower_boundnumberRequiredLower confidence interval bound
upper_boundnumberRequiredUpper confidence interval bound
confidence_levelstringOptionalConfidence level: high, medium, low

weeklyreport_forecast_sales

14-day sales forecasting with daily breakdowns and confidence intervals

FieldTypeRequiredDescription
daily_forecastsweeklyreport_forecast_daily_prediction[]Required14 days of daily sales forecasts
week1_total_predictionnumberRequiredTotal predicted sales for first forecast week
week1_lower_boundnumberRequiredLower bound for first week sales
week1_upper_boundnumberRequiredUpper bound for first week sales
week2_total_predictionnumberRequiredTotal predicted sales for second forecast week
week2_lower_boundnumberRequiredLower bound for second week sales
week2_upper_boundnumberRequiredUpper bound for second week sales
total_14_day_predictionnumberRequiredTotal predicted sales for entire 14-day period
total_14_day_lower_boundnumberRequiredLower bound for 14-day total
total_14_day_upper_boundnumberRequiredUpper bound for 14-day total
average_daily_salesnumberRequiredAverage daily sales across forecast period
trend_directionstringOptionalOverall trend: increasing, decreasing, stable
forecast_methodstringOptionalForecasting method used: prophet, trend_based, simple
confidence_scorenumberOptionalOverall forecast confidence (0-100)

weeklyreport_forecast_customers

14-day customer count forecasting for staffing optimization

FieldTypeRequiredDescription
daily_forecastsweeklyreport_forecast_daily_prediction[]Required14 days of daily customer count forecasts
week1_total_customersnumberRequiredTotal predicted customers for first forecast week
week1_avg_daily_customersnumberRequiredAverage daily customers for first week
week2_total_customersnumberRequiredTotal predicted customers for second forecast week
week2_avg_daily_customersnumberRequiredAverage daily customers for second week
peak_day_predictionstringOptionalPredicted busiest day of the forecast period
peak_day_customersnumberOptionalPredicted customer count for busiest day
staffing_recommendationsstring[]OptionalStaffing recommendations based on forecast

weeklyreport_forecast_category

Category-specific sales forecasting for inventory planning

FieldTypeRequiredDescription
dpt_ididRequiredDepartment ID for the category
category_namestringRequiredProduct category name
daily_predictionsweeklyreport_forecast_daily_prediction[]RequiredDaily EUR sales forecasts for this category
week1_total_eurnumberRequiredPredicted EUR sales for first week
week1_lower_boundnumberRequiredLower bound EUR sales for first week
week1_upper_boundnumberRequiredUpper bound EUR sales for first week
week2_total_eurnumberRequiredPredicted EUR sales for second week
week2_lower_boundnumberRequiredLower bound EUR sales for second week
week2_upper_boundnumberRequiredUpper bound EUR sales for second week
total_14_day_eurnumberRequiredTotal predicted EUR sales for 14-day period
category_trendstringOptionalCategory-specific trend direction
inventory_recommendationsstring[]OptionalInventory planning recommendations

weeklyreport_forecast_summary

Overall forecast summary and metadata

FieldTypeRequiredDescription
forecast_generated_atstringRequiredTimestamp when forecast was generated (ISO 8601)
forecast_horizon_daysnumberRequiredNumber of days forecasted (should be 14)
historical_data_pointsnumberRequiredNumber of historical data points used for forecasting
historical_data_startstringOptionalStart date of historical data used
historical_data_endstringOptionalEnd date of historical data used
api_service_usedstringOptionalExternal forecasting service used (prophet-api, fallback, etc.)
overall_confidence_levelstringRequiredOverall forecast confidence: high, medium, low
seasonal_factors_detectedbooleanOptionalWhether seasonal patterns were detected and used
holiday_adjustments_appliedbooleanOptionalWhether holiday adjustments were applied
forecast_accuracy_notesstringOptionalNotes about forecast accuracy and limitations

weeklyreport_forecast_comprehensive

Comprehensive 14-day forecasting system for sales, customers, and categories

FieldTypeRequiredDescription
sales_forecastweeklyreport_forecast_salesRequiredTotal sales forecasting for 14-day period
customer_forecastweeklyreport_forecast_customersRequiredCustomer count forecasting for staffing
category_forecastsweeklyreport_forecast_category[]OptionalIndividual category forecasts for inventory planning
summaryweeklyreport_forecast_summaryRequiredForecast metadata and confidence information
current_week_remaining_daysnumberOptionalNumber of days remaining in current week (if mid-week)
current_week_completion_forecastanyOptionalForecast for completing the current week

weeklyreport_staff_performance

Individual staff performance and productivity metrics

FieldTypeRequiredDescription
staff_idstringOptionalStaff member identifier
staff_namestringOptionalStaff member name
sales_per_hournumberRequiredSales generated per hour worked
avg_check_sizenumberRequiredAverage transaction amount for this staff member
upselling_effectivenessnumberOptionalUpselling success rate percentage
order_accuracy_ratenumberRequiredOrder accuracy percentage
customer_satisfaction_scorenumberOptionalCustomer satisfaction rating for this staff member
hours_workednumberRequiredTotal hours worked during period
total_salesnumberRequiredTotal sales attributed to this staff member
training_recommendationsstring[]OptionalSuggested training areas

weeklyreport_marketing_roi

Marketing campaign effectiveness and ROI analysis

FieldTypeRequiredDescription
campaign_ididOptionalReference to campaign entity
campaign_namestringRequiredMarketing campaign or promotion name
campaign_costnumberRequiredTotal cost of the campaign
incremental_revenuenumberRequiredAdditional revenue generated
roi_percentagenumberRequiredReturn on investment percentage
customer_acquisition_costnumberOptionalCost to acquire each new customer
campaign_effectivenessstringOptionalOverall campaign effectiveness rating
daypart_performanceanyOptionalCampaign performance by time of day
channel_performanceanyOptionalPerformance across different marketing channels
discount_performanceany[]OptionalPerformance metrics for each discount in the campaign
target_vs_actualanyOptionalCampaign targets vs actual performance

weeklyreport_campaign_performance

Active campaign performance during the reporting period

FieldTypeRequiredDescription
campaign_ididRequiredReference to campaign entity
campaign_namestringRequiredCampaign name for reporting
start_datedateRequiredCampaign start date
end_datedateOptionalCampaign end date
total_revenuenumberRequiredTotal revenue generated during campaign period
revenue_attributionnumberOptionalRevenue directly attributable to campaign
discount_redemptionsnumberOptionalNumber of discount redemptions
discount_valuenumberOptionalTotal value of discounts applied
target_products_performanceany[]OptionalPerformance of targeted products/departments
comparison_to_reference_periodanyOptionalPerformance vs reference periods
customer_engagement_metricsanyOptionalCustomer engagement with campaign

weeklyreport_sales_target_performance

Sales target tracking and achievement analysis

FieldTypeRequiredDescription
target_ididOptionalReference to sales target entity
target_namestringRequiredSales target name/description
target_typestringRequiredType of target (TOTAL_SALES_AMOUNT, PRODUCT_SALES_QTY, etc.)
target_amountnumberRequiredTarget amount/quantity to achieve
actual_amountnumberRequiredActual amount/quantity achieved
achievement_percentagenumberRequiredAchievement percentage (actual/target * 100)
variancenumberRequiredVariance from target (positive = over target)
variance_percentagenumberRequiredVariance as percentage of target
daily_progressany[]OptionalDay-by-day progress toward target
contributing_factorsstring[]OptionalFactors contributing to performance
corrective_actionsstring[]OptionalRecommended corrective actions if under-performing

weeklyreport_sustainability

Sustainability metrics and environmental impact tracking

FieldTypeRequiredDescription
food_waste_amountnumberRequiredTotal food waste in kg/lbs
food_waste_valuenumberRequiredMonetary value of food waste
energy_consumptionnumberOptionalEnergy consumption metrics
packaging_usageanyOptionalPackaging usage analysis
sustainable_product_salesnumberOptionalSales of sustainable/eco-friendly products
carbon_footprint_estimatenumberOptionalEstimated carbon footprint
waste_reduction_initiativesstring[]OptionalActive waste reduction initiatives
sustainability_scorenumberOptionalOverall sustainability performance score

weeklyreport_v2

Enhanced sales and category reporting

FieldTypeRequiredDescription
category_salesweeklyreport_category_sales[]OptionalSales breakdown by product categories
category_sales_per_dayweeklyreport_category_sales_per_day[]OptionalDaily sales breakdown by product categories
top_itemsweeklyreport_top_item[]OptionalTop performing menu items
low_performing_itemsweeklyreport_top_item[]OptionalUnderperforming menu items
hourly_salesweeklyreport_hourly_salesOptionalSales by hour (day x hour matrix)
laborweeklyreport_laborOptionalLabor cost and efficiency analysis
table_turnoverweeklyreport_table_turnover[]OptionalTable turnover and utilization metrics
kitchen_performanceweeklyreport_kitchen_performanceOptionalKitchen efficiency and performance metrics
inventory_analysisweeklyreport_inventory_analysisOptionalInventory usage and waste analysis
discountsany[]OptionalDiscount and promotion effectiveness analysis
refundsany[]OptionalRefunds and voids analysis with categorization
customer_loyaltyweeklyreport_customer_loyaltyOptionalCustomer loyalty and retention analysis
customer_feedbackweeklyreport_customer_feedbackOptionalCustomer satisfaction and feedback metrics
weather_dataany[]OptionalWeather correlation data for sales analysis
staff_performanceweeklyreport_staff_performance[]OptionalIndividual staff performance metrics
marketing_roiweeklyreport_marketing_roi[]OptionalMarketing campaign ROI analysis
sustainabilityweeklyreport_sustainabilityOptionalSustainability and waste tracking metrics
campaign_performanceweeklyreport_campaign_performance[]OptionalActive campaign performance during reporting period
sales_target_performanceweeklyreport_sales_target_performance[]OptionalSales target achievement and variance analysis
recommendationsweeklyreport_recommendation[]OptionalData-driven recommendations and action items
previous_week_comparisonanyOptionalWeek-over-week performance comparison
previous_year_comparisonanyOptionalYear-over-year performance comparison
forecast_next_weekdeprecatedanyOptionalLegacy forecast field - use forecast_comprehensive instead
forecast_comprehensiveweeklyreport_forecast_comprehensiveOptionalComprehensive 14-day forecast for sales, customers, and categories

weeklyreport_data

Complete weekly report data structure including v1 and v2 models

FieldTypeRequiredDescription
week_numnumberRequiredWeek number in the year
businessdaysstring[]OptionalList of business day identifiers for the week
pos_listanyOptionalWeeklyreport v1
companyanyOptionalWeeklyreport v1
billinganyOptionalWeeklyreport v1
cashweeklyreport_cash[]OptionalWeeklyreport v1
feesdeprecatedanyOptionalWeeklyreport v1
daysalesweeklyreport_daysales[]OptionalWeeklyreport v1
taxsalesweeklyreport_taxsales[]OptionalWeeklyreport v1
marketingdeprecatedany[]RequiredWeeklyreport v1
tendersalesweeklyreport_tendersalesOptionalWeeklyreport v1
working_hoursnumberRequiredWeeklyreport v1
netsales_totalnumberOptionalWeeklyreport v1
editsdeprecatedany[]?RequiredWeeklyreport v1
weeklyreport_v2weeklyreport_v2Optional

weeklyreport

has idtablecompany-scoped

Main weekly report entity for restaurant and cafeteria operations

FieldTypeRequiredDescription
location_ididRequiredReference to the location this report covers
weekstartstringRequiredStart date of the reporting week
weekendstringRequiredEnd date of the reporting week
openbooleanRequiredWhether the report period is still open for modifications
dataweeklyreport_dataRequiredComprehensive weekly report data structure

wastage_item

FieldTypeRequiredDescription
unitstringRequired
multipliernumberRequired
countnumberRequired
valuenumberOptional

wastage_line

FieldTypeRequiredDescription
plu_idguidRequired
unitstringRequired
countnumberRequired
multipliernumberRequired

wastage_data_entry

FieldTypeRequiredDescription
plu_idguidRequired
itemswastage_item[]Required

wastage_data

FieldTypeRequiredDescription
reasonstringOptional
lineswastage_line[]Optional
datawastage_data_entry[]Optional

wolt_oauth_access_response

FieldTypeRequiredDescription
urlstringRequiredOAuth URL to redirect user to