getChangedDataSince

Get information about what items have been created, updated or deleted in the server since the given timestamp.

Function output lists the various modules (data tables) in the system, whether there have been additions/updates, and whether there have been deletions in the particular module.

Input parameters

Parameter name Description Possible value Required
changedSince Timestamp. If this parameter is supplied, server returns information about all modules. You may also use the input parameters below, to get information about certain modules only.

Note that server clock may be different from yours. To ensure that data is exchanged correctly, server timestamps should always be used. (Server returns its timestamp with each API call, see the "requestUnixTime" attribute in response header.)
Integer
customersChangedSince Integer
employeesChangedSince Integer
suppliersChangedSince Integer
addressesChangedSince Integer
currenciesChangedSince Integer
customerGroupsChangedSince Integer
emailAccountsChangedSince Integer
giftCardsChangedSince Integer
pointsOfSaleChangedSince Integer
priceListsChangedSince Integer
productGroupsChangedSince Integer
productCategoriesChangedSince Integer
productsChangedSince Integer
servicesChangedSince Integer
supplierGroupsChangedSince Integer
usersChangedSince Integer
eventsChangedSince Integer
purchaseDocumentsChangedSince Integer
salesDocumentsChangedSince Integer
campaignsChangedSince Integer
couponsChangedSince Integer
warehousesChangedSince Integer
vatRatesChangedSince Integer
inventoryRegistrationsChangedSince Integer
inventoryTransfersChangedSince Integer
inventoryWriteOffsChangedSince Integer
paymentsChangedSince Integer

Response

Field name Type Description
tableName String Possible values: "customers", "employees", "suppliers", "addresses", "currencies", "customerGroups", "emailAccounts", "giftCards", "pointsOfSale", "priceLists", "productGroups", "productCategories", "products", "services", "supplierGroups", "users", "warehouses", "vatRates", "events", "purchaseDocuments", "salesDocuments", "inventoryRegistrations", "inventoryTransfers", "inventoryWriteOffs", "payments".
updated Integer (0 or 1) A value of 1 indicates that there have been new items added or existing items have been updated since the given timestamp.

Calling an appropriate getZZZ API function (such as getCustomers, getProducts), with the same changedSince timestamp, will give a list of changed items.
The corresponding functions are as follows:
customersgetCustomers
employees or usersgetEmployees
suppliersgetSuppliers
addressesgetAddresses
currenciesgetCurrencies
customerGroupsgetCustomerGroups
emailAccountsgetEmailAccounts
giftCardsgetGiftCards
pointsOfSalegetPointsOfSale
priceListsgetPriceLists
productGroupsgetProductGroups
productsgetProducts
servicesgetServices
supplierGroupsgetSupplierGroups
warehousesgetWarehouses
vatRatesgetVatRates
eventsgetEvents
purchaseDocumentsgetPurchaseDocuments
salesDocumentsgetSalesDocuments
inventoryRegistrationsgetInventoryRegistrations
inventoryTransfersgetInventoryTransfers
inventoryWriteOffsgetInventoryWriteOffs
paymentsgetPayments
deleted Integer (0 or 1) A value of 1 indicates that there have been items deleted since the given timestamp.

Calling API function getUserOperationsLog with the same timestamp and tableName will return the list of deleted IDs.