New features
1. Input parameters "jdoc", "rowJDoc#" have been added to API call savePurchaseDocument.
Now it is possible to attach extra information to the purchase document and the purchase document row, in JSON format.
To ensure interoperability, only certain JSON properties, defined by Erply, are allowed. The contents of the field are validated using a JSON schema, and the schema is globally the same for all Erply accounts. Thus, this field is best suited for standard applications that get used on many accounts.
The general pattern is that each application, integration or workflow stores its data under its own top-level object (a namespace). All custom properties added by Brazil POS are under BrazilPOS.*, for example.
API clients that modify existing documents and add data to JSON must take care to preserve the data created by other applications, too.
This is the same data that can be retrieved and saved using standalone calls in JSON API.
2. The ability to add extra costs to purchase document rows has been added to API call savePurchaseDocument. Use the parameter “rowJDoc#”, for example: rowJDoc1 = '{"extraCosts":{"extraCost":10.5}}'. The API will add this value to the item cost.
3. New flag "doNotCreateInventoryTransaction" has been added to API call saveSalesDocument.
4. New field "lastInventoryInTransactionDate" has been added to API call getProductStock. To retrieve this field, use the input flag "getLastInventoryInTransactionDate = 1".
5. New field "lastInventoryOutTransactionDate" has been added to API call getProductStock. To retrieve this field, use the input flag "getLastInventoryOutTransactionDate = 1".
Improvements
1. New option "WEIGHT" for the parameter "dividedBy" has been added to API call updatePurchaseDocumentAdditionalCosts.
2. API call getProductStock allows to omit input parameter "warehouseID" and retrieve information across all warehouses.
3. API calls getSalesDocuments, getPurchaseDocuments, getInventoryRegistrations, and getInventoryWriteOffs now respect the configuration parameter "users_can_see_only_own_warehouse_documents".