Get the cost of goods sold for a given period. API returns an array of all sales document rows in the selected period, and the cost for each row.

Erply calculates cost according to FIFO principle.

Usage guidelines: Note that the COGS of any sale may change at any time — Erply does not freeze cost at the moment when sale takes place. Many kinds of operations may adjust it, eg. entering or correcting a purchase invoice at a later date, adding freight costs, deleting other documents etc. Find out what are the accounting principles in your company and pull COGS only when all adjustments for the given period are done — eg. at the end of month.

Input parameters

Parameter name Description Possible value Required
dateFrom Note that API's output capacity may be limited. If you experience errors, subdivide your period into smaller chunks and request separately. ISO date (yyyy-mm-dd)
dateTo ISO date (yyyy-mm-dd)


Field name Type Description
date Date Sales document date, eg. 2010-01-29.
invID Integer Sales document ID.
invNo String Sales document number.
wrhID Integer ID of the warehouse from which goods are sold.
prodID Integer ID of the product.
amount Decimal Sold amount.
price Decimal Net sales total. Does not include VAT / sales tax.
cost Decimal The cost of goods sold.