|
Een slimme, toekomstklare oplossing voor al uw kassapunten? CloudPOS past zich aan uw business aan.
|
|
Startende ondernemer, volop in een groeispurt of aan het uitbreiden naar nieuwe locaties: op belangrijke momenten voor uw onderneming moet uw kassasysteem u kunnen volgen. Met CloudPOS stelt u een pakket samen dat werkt vanaf dag één. Groeit u? Dan groeit CloudPOS mee. Vraag advies en u bent vertrokken.
|
| |
|
Aan de slag met CloudPOS |
|
Zo snel mogelijk aan de slag met uw CloudPOS-kassasysteem? Dat kan in 1-2-3.
|
|
$
|
Kies voor software op de groei. Gebruik de functionaliteiten die het u gemakkelijk maken. En gebruik er méér wanneer u groeit.
|
|
$
|
Laat u adviseren. Stel ons uw vragen rechtstreeks of neem contact op met een van onze vertrouwde verdelers.
|
|
$
|
Business as usual … but better. CloudPOS neemt u het werk uit handen. Minder administratie, meer tijd voor uw core business.
|
|
|
|
|
Vertrouwde verdelers
|
|
CloudPOS werkt samen met enkele ervaren partners voor de verdeling van ons digitale kassasysteem. Het voordeel van werken met een van onze partners? Altijd een helder antwoord op uw vragen, ondersteuning bij installatie en updates, en een aanspreekpunt wanneer uw onderneming groeit en uw noden veranderen.
|
|
API
|
Api V2
https://www.cloudpos.be/api-documentation/
Api V1 (krijgt geen updates meer)
voorbeelden
API voorbeelden
Request url : https://cloudpos.be/api/?licname=licentienaam&token=verkregentoken&get-products
Gebruik van https:// is vereist
Categorie, product, subproduct onderscheid : Bekijken
Limiet : 500 connecties per dag, indien er meer requests nodig zijn kan dit worden besproken met onze technische dienst, na 5 verkeerde inlogpogingen word het ip adres voor 30 min geblokkeerd
Logingegevens voor testdoeleinden of een operationele klant kan u aanvragen via info@cloudpos.be
Error :
"errorcode" = 1001 Token and name can not be empty
"errorcode" = 1002 Token or name not valid
"errorcode" = 1003 Limit of '500' requests per day reached, next request possible 'datetime'
"errorcode" = 1004 5 bad logins reached, your ip adress is blocked till 'datetime'
"errorcode" = 1005 No license for this module
|
|
|
Categorieen ophalen :
Functie : get-categories
Response :
“id” categorie id
“name” categorie naam
Ok
"success" = 1
Error
"errorcode" = 2000 No categories found
Producten ophalen :
Functie : get-products
Url filter :
&id=1 product id
&categorylink=1 categorie id
Response :
“id” product id
“name” product naam
“categorylink” id van de categorie waarin het product zit ondergebracht
“price” verkoopprijs
“purchaseprice” aankoopprijs
“quantity” product stock
“popup” product heeft popup subproducten
“menupopup” product heeft menu subproducten
“openprice” product heeft open prijs
“modtime” laatst aangepast, unix time stamp
Ok
"success" = 1
Error
"errorcode" = 2000 No products found
Subproducten ophalen :
Functie : get-subproducts
Url filter :
&id=1 subproduct id
&productlink=1 product id
Response :
“id” subproduct id
“name” subproduct naam
“price” subproduct prijs
“quantity” subproduct stock
“productlink” array van de product id's waaraan het subproduct is gekoppeld
“modtime” laatst aangepast, unix time stamp
Ok
"success" = 1
Error
"errorcode" = 2000 No subproducts found
Klanten ophalen :
Functie : get-customers
Response :
“id” klant id
“name” naam
“fistname” voornaam
“companyname” firmanaam
“street_number” Straat, nummer
“phone” telefoon
“zipcode” postcode
“town” gemeente
“vatnumber” btwnummer
“email” e-mail adres
“tagid” tag nummer
“tagtype” tag type, barcode of rfid
“tagfamid” tag familie koppeling id
“modtime” laatst aangepast, unix time stamp
Ok
"success" = 1
Error
"errorcode" = 2000 No customers found
Gebruikers ophalen :
Functie : get-users
Response :
“id” gebruiker id
“username” gebruikersnaam
“admin” 1 = admin, 0 = gebruiker
“secnr” rijksregisternummer, enkel in GKS modus
Ok
"success" = 1
Error
"errorcode" = 2000 No users found
Tafels ophalen :
Functie : get-tables
Response :
“id” tafel id
“table” tafelnummer
“status” 0 = niet in gebruik, 1 = in gebruik, 2 = wachten op betaling
Ok
"success" = 1
Error
"errorcode" = 2000 No tables found
Actieve betaalmiddelen ophalen :
Functie : get-payment
Response :
“id” betaalmiddel id
“payment” betaalmiddel naam
Ok
"success" = 1
Error
"errorcode" = 2000 No payment found
Printers ophalen :
Functie : get-printers
Response :
“id” printer id
“printername” printer naam
Ok
"success" = 1
Error
"errorcode" = 2000 No printers found
Orders ophalen :
Functie : get-orders
Url filter :
&start=1 begin bij order id
&end=5 stop bij order id
&date=2016-01-01 selecteer bepaalde datum
&clockinclockout enkel arbeid in en uit
Response :
“dbid” uniek database id
“id” ticket id
“customerid” klant id
“establishmentid” filiaal id
“kassaid” kassa id
“totalprice” totaal prijs incl btw
“user” aangemaakt door user id
“ordertime” datum + tijd
“clockin” Arbeid in
“clockout” Arbeid uit
“orderdetail” array van detail lijnen
{
“quantity” aantal
“productid” product id
“productprice” prijs incl btw
“producttax” btw tarief
“subproduct'1-10'id” subproduct id
“subproduct'1-10'price” subproduct incl btw
“subproduct'1-10'tax” subproduct btw tarief
}
“cashpayment” cash betaling
“bancontactpayment” bancontact betaling
“voucherpayment” kadobon betaling
“transferpayment” over te schrijven betaling
“visapayment” visa betaling
“chargecardpayment” oplaadkaart betaling
“luncheoncardpayment” maaltijdcheque betaling
“americanexpresspayment” americanexpress betaling
“mastercardpayment” mastercard betaling
Ok
"success" = 1
Error
"errorcode" = 2000 No orders found
Facturen ophalen :
Functie : get-invoices
Url filter :
&start=1 begin bij factuur id
&end=5 stop bij factuur id
&date=2016-01-01 selecteer bepaalde datum
Response :
“id” order id
“customerid” klant id
“totalprice” totaal prijs incl btw
“date” datum
“expirationdate” vervaldatum
“number” document nummer
“doctype” document type, 1 factuur, 2 offerte, 3 creditnota
“note” opmerking
“invoicedetail” array van detail lijnen
{
“quantity” aantal
“productname” productnaam
“productprice” prijs incl btw
“producttax” btw tarief
}
“docfromvatticket” 1 = ja, 0 = nee
Ok
"success" = 1
Error
"errorcode" = 2000 No invoices found
Weborder bevestigd :
Functie : get-confirmedweborder
Post filter :
"weborderid" = nummer van de aangemaakte weborder !!
Response :
"webordertime" = bevestigde tijd wanneer de weborder kan worden afgehaald of word geleverd
Ok
"success" = 1
Error
"errorcode" = 2001 weborder not confirmed
"errorcode" = 2002 weborderid can not be empty
"errorcode" = 2003 weborderid does not exist
Verkoopdocument ondertekend door fdm ophalen :
Functie : get-invoicesigned, get-offersigned, get-creditnotesigned
Post filter :
“documentnr” document nummer !!
Response :
"vatticket" = nummer van het aangemaakte BTW ticket
Ok
"success" = 1
Error
"errorcode" = 2000
"errorcode" = 2001 Document nr can not be empty
"errorcode" = 2002 Document nr already in use
Reservatie beschikbare personen ophalen :
Functie : get-reservationpersons
Post filter :
“date” datum !!
Response :
"persons" = array van aantal personen
Ok
"success" = 1
Error
"errorcode" = 2000
"errorcode" = 2001 Date can not be empty
Reservatie beschikbare uren ophalen :
Functie : get-reservationhours
Post filter :
“date” datum !!
“persons” aantal personen !!
Response :
"hours" = array van beschikbare uren
Ok
"success" = 1
Error
"errorcode" = 2001 Date can not be empty
"errorcode" = 2002 Persons can not be empty
Cadeaubonnen ophalen :
Functie : get-giftvoucher
Response :
“id” Cadeaubon id
“barcode” Barcode
“value” Waarde
“validfrom” Geldig van
“validuntil” Geldig tot
“modtime” Laatst aangepast, unix time stamp
Ok
"success" = 1
Error
"errorcode" = 2000 No vouchers found
Kortingsbonnen ophalen :
Functie : get-coupon
Url filter :
&start=1 begin bij kortingsbon id
&end=5 stop bij kortingsbon id
Response :
“id” Kortingsbon id
“barcode” Barcode
“value” Waarde
“valuetype” 1 geld waarde, 2 percent
“validfrom” Geldig van
“validuntil” Geldig tot
“used” gebruikt
Ok
"success" = 1
Error
"errorcode" = 2000 No coupons found
Klanten tegoed ophalen :
Functie : get-customercredits
Url filter :
&customerid=1 detail van alle tegoed toevoegingen per klant
Response :
“customerid” Klant id
“value” Waarde
“tagid” Tag nummer
“tagtype” Tag type, barcode of rfid
“id” Id (alleen bij customerid filter)
“productid” Product id (alleen bij customerid filter)
“categoryid” Category id (alleen bij customerid filter)
Ok
"success" = 1
Error
"errorcode" = 2000 No customercredits found
Z rapporten :
Functie : get-zreports
Url filter :
&start=1 begin bij Z rapport id
&end=5 stop bij Z rapport id
Response :
“id” Z rapport nummer
“startdate” Begin van Z periode
“enddate” Einde van Z rapport periode
“startticket” Begin ticket van Z periode
“endticket” Eind ticket van Z periode
“ticketcount” Aantal tickets
“totalexclvat” Totaal prijs excl btw
“totalinclvat” Totaal prijs incl btw
Ok
"success" = 1
Error
"errorcode" = 2000 No Z reports found
X rapport :
Functie : get-xreport
Response :
“id” Volgende Z rapport nummer
“startdate” Begin van volgende Z periode
“startticket” Begin ticket van volgende Z periode
“totalexclvat” Totaal prijs excl btw sinds laatste Z
“totalinclvat” Totaal prijs incl btw sinds laatste Z
Ok
"success" = 1
Error
"errorcode" = 2000 No X report data found
Filialen ophalen :
Functie : get-establishments
Response :
“id” filiaal id
“name” filiaal naam
Ok
"success" = 1
|
Categorie aanmaken :
Functie : post-category
“name” categorie naam !!
Response :
"id" = id van de nieuwe categorie
Ok
"success" = 1
Error
"errorcode" = 2001 name can not be empty
Product aanmaken :
Functie : post-product
“name” product naam !!
“categorylink” id van de categorie waarin het product zit ondergebracht !!
“price” product prijs !!
“tax” product btw tarief !!
“taxtable” product tafel btw tarief
“quantity” product stock
“barcode” product barcode
Response :
"id" = id van het nieuw product
“modtime” aangemaakte unix time stamp
Ok
"success" = 1
Error
"errorcode" = 2001 name can not be empty
"errorcode" = 2002 price can not be empty
"errorcode" = 2003 tax can not be empty
"errorcode" = 2004 categorylink can not be empty
Subproduct aanmaken :
Functie : post-subproduct
“name” subproduct naam !!
“price” subproduct prijs !!
“tax” subproduct btw tarief !!
“taxtable” subproduct tafel btw tarief
“quantity” subproduct stock
Response :
"id" = id van het nieuw subproduct
“modtime” aangemaakte unix time stamp
Ok
"success" = 1
Error
"errorcode" = 2001 name can not be empty
"errorcode" = 2002 price can not be empty
"errorcode" = 2003 tax can not be empty
Klant aanmaken :
Functie : post-customer
“name” “fistname” or “companyname” naam, voornaam of firmanaam !!
“street_number” Straat, nummer
“phone” telefoon
“zipcode” postcode
“town” gemeente
“vatnumber” btwnummer
“email” e-mail adres
“tagid” tag nummer
“tagtype” 1 barcode, 2 rfid
“tagfamid” tag familie koppeling id
Response :
"id" = id van de nieuwe klant
“modtime” aangemaakte unix time stamp
Ok
"success" = 1
Error
"errorcode" = 2001 name, firstname or companyname can not be empty
"errorcode" = 2002 companyname and firstname, name can not together
Weborder aanmaken :
Functie : post-weborder
"customerid" klant id!!
"delivery" afhalen = 0, leveren = 1, terplaatse = 2 !!
"onlinepaid" online betaald = 1
"discountamount" kortingsbedrag
"autoconfirmation" geen interactie met de klant nodig = 1
"plannedorder" directe order = 0 , geplande order = 1
"plannedorderdatetime" geplande order datumtijd 2021-01-01 12:00:00
"remark” opmerking
"weborderdetail" array van weborder detail
{
"productid" product id !!
"productprice" product prijs !!
"productvat" product btw tarief, 1.21, 1.12, 1.09, 1.06, 1.00 !!
"sub1id" subproduct id
"sub1price" subproduct prijs
"sub1vat" subproduct btw tarief, 1.21, 1.12, 1.09, 1.06, 1.00
"sub2id" subproduct id
"sub2price" subproduct prijs
"sub2vat" subproduct btw tarief, 1.21, 1.12, 1.09, 1.06, 1.00
"sub3id" subproduct id
"sub3price" subproduct prijs
"sub3vat" subproduct btw tarief, 1.21, 1.12, 1.09, 1.06, 1.00
"sub4id" subproduct id
"sub4price" subproduct prijs
"sub4vat" subproduct btw tarief, 1.21, 1.12, 1.09, 1.06, 1.00
"sub5id" subproduct id
"sub5price" subproduct prijs
"sub5vat" subproduct btw tarief, 1.21, 1.12, 1.09, 1.06, 1.00
"sub6id" subproduct id
"sub6price" subproduct prijs
"sub6vat" subproduct btw tarief, 1.21, 1.12, 1.09, 1.06, 1.00
"sub7id" subproduct id
"sub7price" subproduct prijs
"sub7vat" subproduct btw tarief, 1.21, 1.12, 1.09, 1.06, 1.00
"sub8id" subproduct id
"sub8price" subproduct prijs
"sub8vat" subproduct btw tarief, 1.21, 1.12, 1.09, 1.06, 1.00
"sub9id" subproduct id
"sub9price" subproduct prijs
"sub9vat" subproduct btw tarief, 1.21, 1.12, 1.09, 1.06, 1.00
"sub10id" subproduct id
"sub10price" subproduct prijs
"sub10vat" subproduct btw tarief, 1.21, 1.12, 1.09, 1.06, 1.00
"extrainfo" komma gescheiden, extra info voor op keukenticket
}
Response :
"weborderid" = aangemaakt weborder id
Ok
"success" = 1
Error
"errorcode" = 2001 customerid can not be empty
"errorcode" = 2002 delivery can not be empty
"errorcode" = 2003 the customerid id does not exist, the order is not stored
"errorcode" = 2004 an id in this weborder does not exist, the order is not stored
Verkoopdocument aanmaken :
Functie : post-invoice, post-offer, post-creditnote
“productlines” array van product lijnen
{
"quantity" aantal !!
"name" omschrijving !!
"vatpercent" btw tarief !!
"priceincvat" prijs inclusief btw !!
}
“documentnr” document nummer !!
“customerid” klant id
Response :
Ok
"success" = 1
Error
"errorcode" = 2001 Document nr can not be empty
"errorcode" = 2002 Document nr already in use
"errorcode" = 2003 Productlines array error
Reservatie inboeken :
Functie : post-reservationentry
“date” Datum !!
“persons” Aantal personen !!
“hour” Uur !!
“name” Naam
“phone” Telefoon
“confirmed” 1 always, 0 on shift setting
Response :
Ok
"success" = 1
Error
"errorcode" = 2001 Date can not be empty
"errorcode" = 2002 Persons can not be empty
"errorcode" = 2003 Hour can not be empty
"errorcode" = 2004 Hour is to short
Cadeaubon aanmaken :
Functie : post-giftvoucher
“barcode” Barcode !!
“value” Waarde !!
“validfrom” Geldig van, 2016-01-01 !!
“validuntil” Geldig tot, 2016-01-01 !!
“paymenttype” 1 cash, 2 transfer !!
Response :
“modtime” aangemaakte unix time stamp
Ok
"success" = 1
Error
"errorcode" = 2001 Barcode can not be empty
"errorcode" = 2002 Barcode must be a number
"errorcode" = 2003 Value can not be empty
"errorcode" = 2004 Value must be number
"errorcode" = 2005 Validfrom can not be empty
"errorcode" = 2006 Validuntil can not be empty
"errorcode" = 2007 Paymenttype can not be empty
"errorcode" = 2008 Paymenttype can only be 1 or 2
Kortingsbon aanmaken :
Functie : post-coupon
“barcode” Barcode !!
“value” Waarde !!
“valuetype” 1 geld waarde, 2 percent !!
“validfrom” Geldig van, 2016-01-01 !!
“validuntil” Geldig tot, 2016-01-01 !!
Response :
Ok
"success" = 1
Error
"errorcode" = 2001 Barcode can not be empty
"errorcode" = 2002 Barcode must be a number
"errorcode" = 2003 Value can not be empty
"errorcode" = 2004 Value must be number
"errorcode" = 2005 Validfrom can not be empty
"errorcode" = 2006 Validuntil can not be empty
"errorcode" = 2007 Paymenttype can not be empty
"errorcode" = 2008 Paymenttype can only be 1 or 2
Klant tegoed aanmaken :
Functie : post-customercredit
“customerid” Klant id !!
“value” Waarde !!
“productid” or “categoryid” Product id of categorie id
“paymenttype” 1 cash, 2 transfer !!
Response :
"id" = id van de nieuwe tegoed toevoeging
Ok
"success" = 1
Error
"errorcode" = 2001 Customerid can not be empty
"errorcode" = 2002 Customerid does not exist
"errorcode" = 2003 Value can not be empty
"errorcode" = 2004 Value must be a number
"errorcode" = 2005 Paymenttype can not be empty
"errorcode" = 2006 Paymenttype error
"errorcode" = 2007 Productid and categoryid can not together
"errorcode" = 2008 Productid or Categoryid not exists
Exact online order doorboeken :
Functie : post-eolorder
“ordernumber” order nummer !!
“date” datum !!
“customerid” klant id !!
“paymenttype” 1 cash, 2 transfer !!
“detail” array van detail !!
{
"productid" product id !!
"price" product prijs !!
"quantity" aantal !!
}
Response :
"success" = 1
Error
"errorcode" = 2001 Ordernumber can not be empty
"errorcode" = 2002 Date can not be empty
"errorcode" = 2003 Customerid can not be empty
"errorcode" = 2004 Paymenttype can not be empty
"errorcode" = 2005 Paymenttype can only be 1 or 2
"errorcode" = 2006 Detail can not be empty
"errorcode" = 2007 One of the productid's in the detail not exists
"errorcode" = 2008 Error in detail
|
Categorie aanpassen :
Functie : update-category
“id” product id !!
“name” categorie naam
Response :
Ok
"success" = 1
Error
"errorcode" = 2001 id can not be empty
Product aanpassen :
Functie : update-product
“id” product id !!
“name” product naam
“categorylink” id van de categorie waarin het product zit ondergebracht
“price” product prijs
“quantity” product stock
“tax” product btw tarief
“taxtable” product tafel btw tarief
“barcode” product barcode
Response :
“modtime” aangepaste unix time stamp
Ok
"success" = 1
Error
"errorcode" = 2001 id can not be empty
Subproduct aanpassen :
Functie : update-subproduct
“id” product id !!
“name” subproduct naam
“price” subproduct prijs
“quantity” subproduct stock
“tax” subproduct btw tarief
“taxtable” subproduct tafel btw tarief
Response :
“modtime” aangepaste unix time stamp
Ok
"success" = 1
Error
"errorcode" = 2001 id can not be empty
Klant aanpassen :
Functie : update-customer
“id” klant id !!
“name” “fistname” or “companyname” naam, voornaam of firmanaam !!
“street_number” Straat, nummer
“phone” telefoon
“zipcode” postcode
“town” gemeente
“vatnumber” btwnummer
“email” e-mail adres
“tagid” tag nummer
“tagtype” 1 barcode, 2 rfid
“tagfamid” tag familie koppeling id
Response :
“modtime” aangepaste unix time stamp
Ok
"success" = 1
Error
"errorcode" = 2001 id can not be empty
"errorcode" = 2002 companyname and firstname, name can not together
|
|
