Search

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 nameDescriptionPossible valueRequired
changedSinceTimestamp. 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
customersChangedSinceInteger
employeesChangedSinceInteger
suppliersChangedSinceInteger
addressesChangedSinceInteger
currenciesChangedSinceInteger
customerGroupsChangedSinceInteger
emailAccountsChangedSinceInteger
giftCardsChangedSinceInteger
pointsOfSaleChangedSinceInteger
priceListsChangedSinceInteger
productGroupsChangedSinceInteger
productCategoriesChangedSinceInteger
productsChangedSinceInteger
servicesChangedSinceInteger
supplierGroupsChangedSinceInteger
usersChangedSinceInteger
eventsChangedSinceInteger
purchaseDocumentsChangedSinceInteger
salesDocumentsChangedSinceInteger
campaignsChangedSinceInteger
couponsChangedSinceInteger
warehousesChangedSinceInteger
vatRatesChangedSinceInteger
inventoryRegistrationsChangedSinceInteger
inventoryTransfersChangedSinceInteger
inventoryWriteOffsChangedSinceInteger
paymentsChangedSinceInteger

Response

Field nameTypeDescription
tableNameStringPossible 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".
updatedInteger (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
deletedInteger (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.