Logo PopinaPopina API

Models

Models

ButtonGroupEntity

Object containing the following properties:

PropertyType
idstring (uuid)
name (*)string (max length: 255)
isRoot (*)boolean
layout (*)'5-Cols' | '4-Cols' | '3-Cols' | '2-Cols' | 'Folder' | 'SelectionFolder' | 'MealsFolder'
rows (*)number (int)
cols (*)number (int)
buttons (*)Array of objects:
  • id (*): string (uuid)
  • type (*): 'buttonGroup' | 'product' | 'meal'
  • objectId (*): string (uuid)
  • index (*): number (int, ≥0)
  • color (*): never
  • brightness: 'light' | 'normal' | 'dark'
  • fontSize: number (int, ≥0)
  • icon: string

(*) Required.

CashMovementReasonEntity

Object containing the following properties:

PropertyType
idstring (uuid)
name (*)string

(*) Required.

DiscountEntity

Object containing the following properties:

PropertyType
idstring (uuid)
name (*)string
indexnumber (int, ≥0)
type (*)'percentage' | 'amount'
value (*)number
targetPrice (*)'unit' | 'total'

(*) Required.

EmployeeEntity

Object containing the following properties:

PropertyType
idstring (uuid)
colorBlind (*)boolean
isOwner (*)boolean
keyDallasCode (*)string (nullable)
name (*)string
password (*)string (length: 4) (nullable)
qrCode (*)string (nullable)
drawerOpenOnPaid (*)boolean
canOpenCashDrawer (*)boolean
canSwitchHappyHour (*)boolean
canPayCustomerAccount (*)boolean
canPayOrders (*)boolean
canCancelOrders (*)boolean
canChangeOwnership (*)boolean
canChangePricing (*)boolean
canUseCustomPrice (*)boolean
canChangePayment (*)boolean
canUseDiscount (*)boolean
canUseCustomDiscount (*)boolean
canManageCatalog (*)boolean
canManageCustomers (*)boolean
canManageEmployees (*)boolean
canManagePrinters (*)boolean
canAccessAllOrders (*)boolean
canAccessReport (*)boolean
canAccessAllStats (*)boolean
canCloseTill (*)boolean
canStartAndStopTill (*)boolean
canTransferProductsBetweenOrders (*)boolean
canPrintProofOfPayment (*)boolean
canCancelAfterBillPrint (*)boolean
canModifyAfterBillPrint (*)boolean

(*) Required.

LocationSettingsEntityV4

Object containing the following properties:

PropertyTypeDefault
idstring (uuid)
locationName (*)string
currencyLocalestring'fr_FR'
timezone'Africa/Abidjan' | 'Africa/Accra' | 'Africa/Addis_Ababa' | 'Africa/Algiers' | 'Africa/Asmara' | 'Africa/Asmera' | 'Africa/Bamako' | 'Africa/Bangui' | 'Africa/Banjul' | 'Africa/Bissau' | 'Africa/Blantyre' | 'Africa/Brazzaville' | 'Africa/Bujumbura' | 'Africa/Cairo' | 'Africa/Casablanca' | 'Africa/Ceuta' | 'Africa/Conakry' | 'Africa/Dakar' | 'Africa/Dar_es_Salaam' | 'Africa/Djibouti' | ...
establishmentNamestring''
address1string''
address2 (*)string (nullable)''
customHeaderstring''
siretCodestring''
phoneNumberstring''
zipCodestring''
citystring''
countrystring'France'
websitestring''
nafCodestring''
tvaCodestring''
customFooterstring''
companyNamestring''
cutBetweenStepsbooleantrue
printOnlyFirstPrepaReceiptbooleanfalse
enablePreparationCallbooleantrue
detailedReportbooleantrue
doNotPrintClaimbooleanfalse
closeAfterOrderCallbooleantrue
qrCodeLoginbooleanfalse
printOnPaybooleanfalse
prepaStepsCountnumber (≤10, ≥0)3
askForInitialCashFloatbooleanfalse
groupProductsOnPrepaReceiptbooleantrue
printClaimWithoutDetailbooleanfalse
allowGapInTillStatsbooleanfalse
allowCatalogEditOnPosbooleantrue
printMenuWithDetailbooleanfalse
groupProductsOnOrderbooleanfalse
printMenuNameOnPrepaReceiptbooleanfalse
printModifierGroupOnPrepaReceiptbooleanfalse
menuButtonsCountnumber (≥4, ≤16)8
closeFiscalYearDateDate (nullable)
logoUrlstring (nullable)''

(*) Required.

MealButtonEntity

Object containing the following properties:

PropertyType
idstring (uuid)
amount (*)number
indexnumber (int, ≥0)
fontSize (*)number
courseId (*)string (uuid)
productId (*)string (uuid)

(*) Required.

MealCourseEntity

Object containing the following properties:

PropertyType
idstring (uuid)
name (*)string
indexnumber (int, ≥0)
stepIndex (*)number (≥-1, ≤9)
amountToSubtractnumber
mealId (*)string (uuid)

(*) Required.

MealEntity

Object containing the following properties:

PropertyType
idstring (uuid)
indexnumber (int, ≥0)
name (*)string

(*) Required.

MealPriceEntity

Object containing the following properties:

PropertyType
idstring (uuid)
amount (*)number
mealId (*)string (uuid)
pricingId (*)string (uuid)

(*) Required.

ModifierEntity

Object containing the following properties:

PropertyType
idstring (uuid)
indexnumber (int, ≥0)
name (*)string
price (*)number
groupId (*)string (uuid)

(*) Required.

ModifierGroupEntity

Object containing the following properties:

PropertyType
idstring (uuid)
required (*)boolean
maxSelect (*)number (≥0)
name (*)string
type (*)'special' | 'shared'
indexnumber (int, ≥0)

(*) Required.

Object containing the following properties:

PropertyType
idstring (uuid)
modifierGroupId (*)string (uuid)
productId (*)string (uuid)

(*) Required.

PaymentEntity

Object containing the following properties:

PropertyType
idstring (uuid)
indexnumber (int, ≥0)
enabled (*)boolean
mode (*)'cash' | 'card' | 'restaurantCheck' | 'check' | 'amex' | 'credit' | 'custom' | 'iZettle' | 'debt' | 'foxOrder' | 'restoFlash' | 'mews' | 'barnaby' | 'uberEats' | 'deposit' | 'deliveroo' | 'bananaSplit' | 'qoodosCashback' | 'hubrise' | 'keytchens' | ...
name (*)string
tips (*)boolean
voucher (*)boolean
openCashDrawer (*)boolean

(*) Required.

Object containing the following properties:

PropertyType
idstring (uuid)
stationId (*)string (uuid)
productId (*)string (uuid)

(*) Required.

PreparationStationEntity

Object containing the following properties:

PropertyTypeDefault
idstring (uuid)
name (*)string
printerIdstring (uuid) (nullable)
recapPrepa (*)boolean
printUnknownItems (*)boolean
mainStationIdstring (uuid) (nullable)
relatedStationsArray<string (_uuid_)>[]

(*) Required.

PriceEntity

Object containing the following properties:

PropertyType
idstring (uuid)
amount (*)number
productId (*)string (uuid)
taxId (*)string (uuid)
pricingId (*)string (uuid)

(*) Required.

PricingEntity

Object containing the following properties:

PropertyType
idstring (uuid)
enabled (*)boolean
name (*)string
type (*)'custom' | 'normal' | 'happyHour' | 'bar' | 'takeOut' | 'terrace' | 'special' | 'weightPrice' | 'event0' | 'event1' | 'event2' | 'event3' | 'event4' | 'event5' | 'event6' | 'delivery'

(*) Required.

PricingEventEntity

Object containing the following properties:

PropertyType
idstring (uuid)
dateBegin (*)Date
dateEnd (*)Date
enabled (*)boolean
pricingId (*)string (uuid)

(*) Required.

PrinterEntity

Object containing the following properties:

PropertyTypeDefault
idstring (uuid)
workerDeviceIdstring (nullable)
uniqueIdentifierstring (nullable)
localAddressstring (nullable)
customerDisplay (*)boolean
reversePrint (*)boolean
modelNamestring (nullable)
manufacturerstring (nullable)
name (*)string
portnumber (nullable)
interface'bluetooth' | 'internal' | 'network' | 'virtual''network'

(*) Required.

ProductEntity

Object containing the following properties:

PropertyType
idstring (uuid)
barCodestring (nullable)
isCustomPrice (*)boolean
isPricedByWeight (*)boolean
name (*)string
prepStationNamestring (nullable)
layoutButtonNamestring (nullable)
stepIndex (*)number (≥-1, ≤9)
skustring (nullable)
plunumber (int, ≥0) (nullable)
imagestring (nullable)
tarenumber (≥0) (nullable)

(*) Required.

RoomEntity

Object containing the following properties:

PropertyTypeDefault
idstring (uuid)
indexnumber (int, ≥0)
name (*)string
enabled (*)boolean
type (*)'room' | 'bar' | 'takeOut' | 'extOrder'
pricingId (*)string (uuid)
enableBeepersbooleanfalse
additionalReceiptCountnumber (≥0, ≤4)0
askGuestsbooleanfalse
showOwnerbooleanfalse
logoutAfterPaymentbooleanfalse
logoutAfterOrderCallbooleanfalse
openNewOrderAfterPaymentbooleanfalse
orderCallAfterClosingbooleanfalse
orderCallAfterPaymentbooleanfalse

(*) Required.

TableEntity

Object containing the following properties:

PropertyTypeDefault
idstring (uuid)
name (*)string
seatCountnumber (≥0)0
roomId (*)string (uuid)
positionX (*)number (≥0)
positionY (*)number (≥0)
shape (*)'square' | 'circle'

(*) Required.

TaxEntity

Object containing the following properties:

PropertyType
idstring (uuid)
name (*)string
rate (*)number (int, ≥0)

(*) Required.