Sitoo API Release Notes

2024-10-15

• New endpoints
  • Settings
  • Plugins

2024-08-27

• New values added to the vouchertype property for Voucher
  • 320 (PackageDiscountM)
• Added validation for endpoints Add Voucher and Update Voucher to ensure that all SKUs are unique among all productoptions in Voucher. Now has the same behaviour as when using product IDs.
• New endpoints
  • Add POS Payment Type
  • Get POS Payment Type
  • Update POS Payment Type
  • Delete POS Payment Type
• New properties for POSPaymentType
  • sortorder
• New parameters for Get POS Payment Types
  • fields
• New parameters for Get Products
  • productid for filtering on product ID (array of IDs is allowed)
• Fixed endpoints Add Sales Tax and Update Sales Tax to allow empty array for productgrouprules

2024-04-02

• New payment method added for POS Payment Types.
  • 2120 Card (Adyen Tap to Pay)

2024-03-12

• Query parameter updates for the Get Shipments endpoint
  • Added any_warehouseid filter
  • Updated sender_warehouseid and receiver_warehouseid filters to allow an array of IDs to be provided for them

2024-02-20

• New payment method added for POS Payment Types.
  • 800 Vipps MobilePay (720 Vipps and 730 MobilePay will be deprecated and should not be used for new systems)

2024-02-06

• New additionaldata system keys for OrderItem
  • item-imei
  • item-imei2
  • item-serial

2023-10-10

• New type values for reasoncode
  • 170 ClosingCashDiff
  • 180 SalesTaxExemption
• New properties for PosZReport
  • cashdiff_reasoncode
  • cashdiff_reasoncomment

2023-09-28

• New additionaldata system keys for OrderPayment
  • foreign-currency-amount
  • foreign-currency-code
  • foreign-currency-exchange-rate
• New payment method added to OrderPaymentadditionaldata system key payment-method
  • foreign-currency
• New payment method added for POS Payment Types
  • 3000 Foreign Currency
• New objects
  • ZReportCurrencyConversion
• New properties for PosZReport
  • currencyconversions
• New properties for StoreZReportData
  • currencyconversions

2023-08-08

• New parameters for Get Influencer Codes
  • active
  • code
  • name
  • redeemable
  • vouchername
  • voucherpassword
  • datestart_from
  • datestart_to
  • dateend_from
  • dateend_to
  • datelastused_from
  • datelastused_to
  • sort

2023-06-27

• New endpoints
  • Update Order Delivery
  • Get All Order Deliveries
• The parameter ignorestock for the Add Order Delivery endpoint has been deprecated in favor of the ignorestock property for the order delivery.
• New objects
  • OrderLogItemDeliverySource
  • OrderDeliveryState
• New additionaldata system keys for Order
  • delivery-type
  • delivery-pack-type
• New properties for OrderDelivery
  • state
  • ignorestock
  • binlocation
• Property changes for OrderDelivery
  • The datedelivery property can now be null and when set it indicates the date that an order delivery state was set to delivered.
• New orderlogtype values for OrderLogItem
  • 72 (DeliveryUpdated)
• Property changes for OrderLogItem
  • strvalue can now contain the JSON representation of OrderLogItemDeliverySource for all delivery related order log types.

NOTE! These changes to the API will not be affecting existing POS clients or integrations as long they are following the guidelines for API updates.

2023-04-25

• New orderlogtype values for orderlogitem
  • 950 (EmailReceipt) This log type entry requires a custom solution for sending email receipts and will only be available with backend configuration changes.

2023-04-12

• New properties for Store
  • additional_data
• New additionaldata system keys for Order
  • pos-staff-userid-helpers
  • pos-refund-initiation-mode

2023-03-21

• New properties for User
  • active

2023-03-01

• New properties for Voucher
  • use_discounted_price
• New properties for User
  • posallstores
• New parameters for Get Users
  • userid
• New additionaldata system keys for Order
  • delivery-entire-order
• New additionaldata system keys for OrderItem
  • dashboard-ignore

2023-02-07

• The Vouchers API Endpoints now support identifying products using SKUs by using the product_identifier query parameter with a value of sku. This applies to the products attribute of the following objects
  • Voucher
  • VoucherDiscountOption
  • VoucherProductOption
• New values added to the vouchertype property for Voucher
  • 310 (PackageDiscountX)

2022-12-13

• New parameters for Get Warehouse Items
  • sort

2022-11-29

• New parameters for Get All Orders
  • warehouseid
  • creditorderid

2022-11-15

• New values added to the vouchertype property for Voucher
  • 265 (ProductBuyForMGetDiscountList)
• New properties for VoucherDiscountOption
  • productattributes
  • moneydiscounttotal

2022-10-25

• The Batch Update Products endpoint can now be used with either productid or sku as item identifier.

2022-06-08

• The query parameter sku for the Get Products endpoint has been updated to allow an array of SKUs to be provided for filtering
• New type values for reasoncode
  • 75 (ShipmentReceiveItems)

2022-03-31

• New additionaldata system keys for orderpayment
  • vipps-paymentid
  • vipps-orderid
  • vipps-transactionid

2022-03-10

• New endpoints
  • Z-Reports

2022-01-14

• New additionaldata system keys for orderpayment
  • adyen-amountcurrency
  • adyen-poiid

2021-11-30

• New vouchertype values for Voucher
  • 410 (PricelistActivateFinal)
• New properties for Voucher
  • productattributes
• New payment method added for POS Payment Types
  • 1400 (Custom Invoice)

2021-10-20

• New additionaldata system keys for order
  • crm-channelid

2021-09-14

• New endpoints
  • POS Payment Types
• New parameters for Get All Orders
  • receiptid

2021-08-23

• New parameters for Get Service Orders
  • sort
• New additionaldata system keys for orderitem
  • product-group-name
• New additionaldata system keys for orderpayment
  • mobilepay-paymentid

2021-06-16

• New parameters for Add Order Delivery
  • ignorestock
• New additionaldata system keys for order
  • delivery-ignore-stock

2021-06-08

• New additionaldata system keys for order
  • pos-staff-userid
  • pos-staffsales-userid
  • pos-staffsales-externalid
  • pos-staffsales-name

2021-05-25

• New endpoints
  • Service Orders
  • Product Custom Attributes
• New properties for product
  • customattributes

2021-05-06

• New endpoints

  • Get All Orders

• New properties for order

  • eshopid

2021-04-22

• New properties for poszreport.
  • eshopid
  • store_id
  • store_name
  • moneysalesnotdeliveredtotal
  • moneysalesnotdeliveredtotalnet
  • numsalesnotdelivered
  • numsalesnotdelivereditems
  • vatgroupssalesnotdelivered
  • productgroupssalesnotdelivered
  • moneysalestaxinadvance
  • discountssalesnotdelivered
• New properties for poszreportpayment
  • moneycaptured
  • moneyinadvance
  • moneyreserved
• New properties for poszreportsubpayment
  • moneycaptured
  • moneyinadvance
  • moneyreserved
• New properties for order
  • reservedpayments
• New properties for orderpayment
  • reservedpaymentid
• New objects
  • orderreservedpayment

2021-04-20

• New orderlogtype values for orderlogitem
  • 910 (PickupRejected)
• New type values for reasoncode
  • 160 (PickupRejected)

2021-04-07

• New filter for Get Warehouse Items
  • sku

2021-03-18

• New properties for Store
  • eshopid

2021-02-25

• New filter for Get Orders
  • orderid
• New filter for Get Warehouse Transactions and Get All Warehouse Transactions
  • warehousetransactionid
• New filter for Get Shipments
  • shipmentid
• New additionaldata system keys for order
  • customcrm-contactid
  • customcrm-membernumber
• New additionaldata system keys for orderpayment
  • bambora-host2t-internalreference
  • bambora-host2t-terminalid
  • custompayment-mobile
  • custompayment-paymentid
  • giftcard-cardnumber-display
  • izettle-sitooreference
  • klarnav2-id
  • nets-amount
  • nets-sitooreference
  • payment-method
  • pos-originalsales-payment-index
  • swish-paymentid
  • verifone-lpp-reference-number
  • verifone-card-masked-pan
  • virtual-payment

2021-01-07

• New additionaldata system keys for order
  • crm-customerid
  • pos-receiptid
  • store-name
• New properties for User
  • customernumber
• New parameters for Get Users
  • email
  • customernumber
  • personalid
  • mobile

2020-11-17

• Properties now writable for orderitem
  • orderitemtype
• New additionaldata system keys for orderpayment
  • adyen-txdate
• Limit headers now returned for all queries
• Fixed bug where money value was not validated correctly for product prices

2020-10-27

• New additionaldata system keys for order
  • pos-refundsales-orderid
• Properties now writable for order
  • creditorderid
• New properties for Voucher
  • vouchername1
  • vouchercode1
  • vouchername2
  • vouchercode2
• New vouchertype values for Voucher
  • 270 (ProductBuy3For2Or2For1AndAHalf)
• Minor bug fixes

2020-08-19

• New additionaldata system keys for order
  • pos-originalsales-orderid
  • pos-staff2-externalid
  • serviceorder-id
• New additionaldata system keys for orderitem
  • pos-originalsales-orderitemid
• New additionaldata system keys for orderpayment
  • klarna-klarnareference
  • klarna-merchantid
  • klarna-orderid
• New properties for poszreport
  • staffuserid

2020-06-30

• New properties for Store
  • phone
  • email
  • nearby_stores
• New properties for order
  • externalid
• New store type values for Store
  • 50 (Online)
• New parameters for Get Orders
  • externalid
• New endpoints
  • Add Order Delivery
• Deprecated endpoints
  • Get Order Delivery

2020-03-31

• New properties for User
  • pin
  • role
  • warehouses
  • posrefundcard
• New properties for product
  • categories
  • similar
  • related
  • accessories
• New parameters for Get User
  • fields
• Updated endpoints
  • Add User updated to Batch Add Users allowing for batch functionality
• New endpoints
  • Batch Update Users
• New type values for reasoncode
  • 100 (ItemManualPrice)
  • 110 (ItemManualDiscount)
  • 120 (ItemRefund)
  • 130 (ItemReclaim)
  • 140 (CashIn)
  • 150 (CashOut)
• New additionaldata system keys for orderitem
  • reasoncode-manualdiscount
  • reasoncode-manualprice
  • reasoncode-return
  • return-warehouseid
• New additionaldata system keys for orderpayment
  • izettle-panhash
  • mobile

2020-01-28

• New endpoints
  • Add Order Log Item
• New properties for order
  • orderlogitems
• New additionaldata system keys for order
  • pos-sourceorderid
• New orderlogtype values for orderlogitem
  • 900 (ReadyForPickup)
• New objects
  • VoucherDiscountOption
• New properties for Voucher
  • discountoptions
• New vouchertype values for Voucher
  • 260 (ProductBuyXGetDiscountList)

2019-11-19

• New data types
  • tags
• New endpoints
  • Get Price Lists Items
  • Batch Set Price Lists Items
  • Batch Delete Price Lists Items
• New objects
  • pricelistitem
  • volumepricelevel
• New properties for pricelist
  • active
  • externalid
  • currencycode
  • tags
• New properties for Store
  • tags
• New properties for Voucher
  • tags
  • pricelisttags
• New properties for User
  • voucherpasswords
• New properties for giftcardtransaction
  • transaction_reference
• New vouchertype values for Voucher
  • 250 (ProductBuyMinXDiscountY)
  • 400 (PricelistActivate)
• New vouchergrouptype values for Voucher
  • 40 (Pricelist)
• New additionaldata system keys for order
  • voyado-contactid
  • voyado-membernumber
• New additionaldata system keys for orderpayment
  • adyen-cardtype
  • adyen-paymentmethod
  • adyen-paymentmethodvariant
  • adyen-pspreference
  • adyen-tenderreference
• New additionaldata system keys for orderitem
  • customcrm-promotionid
  • customcrm-bonuscheckid
  • pricelist-externalid

2019-09-18

• New additionaldata system keys for order
  • pos-refund-receiptid
  • pos-refund-orderid

2019-09-04

• New additionaldata system keys for orderpayment
  • coiney-transactionref
• New additionaldata system keys for orderitem
  • orderitem-moneyrowdiscount

2019-06-24

• New endpoints
  • Stores
  • Reason Codes
  • Add Warehouse
  • Update Warehouse
  • Delete Warehouse
  • Batch Add Warehouse Transactions
  • Get Warehouses
• New parameters for Get Warehouses
  • fields
• New objects
  • Store
  • reasoncode
• New properties for warehouse
  • usetype
  • storeid
  • sellable
• Deprecated endpoints
  • Warehouse Reason Codes is deprecated. (Replaced by Reason Codes)
• New data types
  • decimal degrees
• New additionaldata system keys for order
  • store-externalid
  • store-externalgroupid

2019-05-14

• New additionaldata system keys for order
  • delivery-pickup-externalid
  • delivery-pickup-warehouseid

2019-02-26

• New objects
  • poszreportdiscount
• New properties for poszreport
  • discountssales
  • discountsrefund
• New additionaldata system keys for orderpayment
  • nets-issuer
  • nets-terminalid

2019-02-18

• New endpoints
  • Influencer Codes
  • Influencer Vouchers
• New objects
  • influencercode
  • influencervoucher
  • influencervouchertransaction
  • influencervouchertransactionresponse
• New properties for User
  • externalid
• New additionaldata system keys for order
  • influencer-influencercode
  • influencer-influencername
  • pos-staff-externalid

2019-02-12

• New properties for order
  • additionaldata
• New properties for orderitem
  • additionaldata
• New properties for orderpayment
  • externalid
  • additionaldata

2019-02-01

• New properties for poszreport
  • dateopened

2019-01-25

• New properties for order
  • currencycode
• New properties for poszreport
  • currencycode
• New properties for product
  • barcodealiases
• New properties for productvariant
  • barcodealiases

2018-12-04

• New properties for order
  • creditorderid
• New properties for warehouse
  • warehousetype
• Updated endpoint Batch Set Warehouse Items with fields allowed to set for warehouse with warehousetype Virtual
  • decimaltotal
  • moneytotal

2018-11-14

• New endpoints
  • Sales Taxes
• New objects
  • orderitemsalestax
  • poszreportsalestax
  • salestax
  • salestaxgroup
  • salestaxproductgrouprule
• New parameters for Get Warehouse Items
  • datelastmodifiedfrom
  • datelastmodifiedto
• New properties for order
  • moneyfinal_salestax
• New properties for orderitem
  • salestaxes
• New properties for posregister
  • state
  • salestaxgroupid
• New properties for poszreport
  • salestaxessales
  • salestaxessales
  • moneysummarysubtotal
  • moneysummarysalestax

2018-10-16

• New endpoints
  • Gift Cards
• New objects
  • giftcard
  • giftcardresponse
  • giftcardtransaction
• New properties for posregister
  • receiptlanguagetag

2018-09-17

• New endpoints
  • Warehouse Reason Codes
• New objects
  • poszreportsubpayment
  • warehousereasoncode
• New properties for poszreportpayment
  • subpayments
• New properties for warehousebatch
  • reasoncode
• New properties for warehousetransaction
  • reasoncode

2018-09-03

• New properties for warehousebatch
  • shipmentid
  • externalid
• New properties for warehousetransaction
  • shipmentid
  • externalid

2018-07-25

• New endpoints
  • Shipments
• New objects
  • shipment
  • shipmentpackage
  • shipmentitem

2018-07-13

• New objects
  • VoucherProductOption
• New properties for Voucher
  • productoptions
• New properties for warehouse
  • externalid

2018-05-03

• New endpoints
  • Get All Warehouse Transactions
• New parameters for Get Warehouse Transactions
  • warehousetransactionidfrom
  • warehousetransactionidto
  • datecreatedfrom
  • datecreatedto
  • transactiontype
  • sort
• New parameters for Get Orders
  • orderidfrom
  • orderidto
  • sort
• New objects
  • orderpayment
• New properties for order
  • payments