Changelog
API 2025-03 changelog
Changes in API version 2025-03. Open the 2025-03 API reference.
This API version is a major upgrade compared to the previous API. This document mentions the primary changes done.
Products API
Remove fields
in_stockbookedavailableandincomingfields have been removed. Instead you need to access the stock levels for the product to get the stock numbers.close_at_quantityis moved to stock levels since it should be applied at the warehouse and product level.lead_timehas been moved to the product-supplier relation. The API for product supplier relation is not exposed. You can set lead time using the Sumtracker UI.
Renamed fields
costhas been renamed towavg_landed_cost
Filter changes
- Filters using the removed fields are also removed.
Stock levels API
- Bundle stock levels now have a new endpoint of its own. The primary end for stock levels will not return bundle products.
Purchase orders API
Purchase orders API has a lot of changes. The primary change being now stock transfer can be done using the purchase orders API.
Stock transfers
- For stock transfers you need to provide
from_warehouse_idin creation instead of thecontact_id. - Stock transfers do not have the option to add
shipping_costandpack_sizein line items.
Async actions
- When you perform an action on the purchase order, the action is performed asynchronously
- The status of the async task is provided by the field
is_task_in_progress
Order dates
ship_by_timenow refers to the date by which the supplier is expected to ship the goods. Previously it referred to the date the goods were expected to arrive at the warehouse.expected_arrival_dateis a new field holding the date the goods are expected to arrive at the warehouse. This is the valueship_by_timeused to carry, so integrations that read or writeship_by_timefor arrival dates must switch toexpected_arrival_date.confirmation_dateis a new field holding the date the order was confirmed.- All three dates are optional and may be null. They can be set when creating an order and changed later with the update endpoint.
- Matching range filters are available:
confirmation_date_range,ship_by_time_range(now filtering on the ship-by date) andexpected_arrival_date_range.
New Contacts (Suppliers) API
- You can fetch the list of contacts for creating purchase orders.
Line errors
- PO lines have a new read only
errorfield. It isnullwhen the line is fine, and otherwise describes why the line is not ready, for example a quantity that is not a whole number of packs. - No action can be performed on a purchase order while any of its lines has an
error. - The PO lines list can be filtered with
error__isnull. Passfalseto list only the lines that have an error. - The line update API still rejects a
quantitythat is not a multiple ofpack_size, so this field is only set for lines added or edited in the Sumtracker app.
Stock adjustments
- Stock adjustments API
mark-completeaction is now async. - The status of the async action is provided by the field
is_task_in_progress
Last modified on