Here’s what’s news in API Release that’s been in production since June 03, 2024!
Breaking Changes:
Fixing the recalculating price
From July 01, we will deploy a fix where the invoice price price.toPay will be reduced by the proforma invoice price price.toPay when a proforma invoice is linked
Values of price.withVat, price.withoutVat, and price.vat will now not be affected by the linked proforma invoice as the proforma invoice is not a tax document
Please check the correctness of the logic on your side as well and report if any potential problem occurs.
Improvements:
Proforma invoice is enriched by partial payments
Proforma invoice detail, List of proforma invoices endpoints have been enriched with new attributes covering partial payment use cases
in response you can find new price.partialPaymentAmount and price.partialPaymentType
PLEASE NOTE:price.partialPaymentAmount can be expressed as a percentage or as an exact money value (up to two decimal places) – depends on partialPaymentType value
Throwing exception when proof payment document locked
Due to the logic of the proof payment documents, which can be related to a specific invoice, they are locked for further adjustments as these documents are sent to clients
From the latest release you will get an exception 409 ConflictProof payment with code “123” is closed. Unlock proof payment first.
this exception will take place on endpoints to update and delete these documents
Returning guid when responding on stock/movements
GET Stock movement now includes guid in the response to better identify movements on specific stock
New Features:
New customer webhooks ready to use
API is enriched by new webhook types:
customer:update which covers events when customer detail has been changed
customer:disableOrders and customer:enableOrders which together cover situation, when disabled the customer, and his future orders will be automatically cancelled or allowed again
PLEASE NOTE:customer:update and customer:enableOrders / customer:disableOrders webhooks combination throws 409 Conflict when try to register simultaneousl. Only one of these webhooks is allowed at a time.
all the other webhook event types can be found in our APIARY
Bugfixes:
Incorrect characteristic of the price list priceRatio attribute
We have corrected an error in the documentation where we historically stated the accuracy of priceRatio to 4 decimal places – however this was incorrect and we have modified the documentation to reflect this where we are returning the accuracy to 3 decimal places
