Reporting

February 28, 2024


This is a complete list of all API calls that provide "reports" — or any aggregated data, in one form or another.

Sales

getSalesReport

Produces a "Sales report" (which, in addition to net sales, also reports VAT or sales tax) or a "Cost of Goods Sold" report (which reports costs and sales margins). Offers many different aggregation options.

getCustomerBalances

Returns all customers who have any unpaid invoices (or prepayments, or store credit), and their current balance.

getAccountStatements

Same as previous — but additionally, for each customer, returns a link to a payment reminder letter (PDF), and links to all unpaid invoices (PDF).

getCostOfGoodsSold

Returns the cost of each sold item in the specified time period. The same information can be retrieved from API call getSalesReport, too.

getTaxExemptions

Returns a list of sales documents to which tax exemption has been applied. (For more specific use cases.)

getRoundedSales

Returns a list of invoices to which rounding has been applied. (For more specific use cases.)

  1. getSalesTotalsByEmployeeAndDay
  2. getSalesTotalsByEmployeeAndMonth
  3. getSalesTotalsByWarehouseAndDay
  4. getSalesTotalsByWarehouseAndMonth

Inventory

getProductStock

Returns current inventory quantities on hand (at the moment, or on a specific date), reserved quantities, weighted average cost, Reorder Points and Restock Levels.

getSummaryInventoryReport

Returns total value of inventory by location, on a specific date.

getAmountsOnOrder

Returns the quantities that have already been ordered from suppliers (but have not been delivered yet). When deciding on how much to reorder, the already-ordered quantities must be factored in to prevent double ordering.

getReservedStock

Returns only a list of reserved product quantities (ie. all products that have been reserved with a Sales Order, Prepayment Invoice, or a Sales Quote). The same information is also available from API call "getProductStock", but a standalone call may be sometimes more efficient (less output to process).

syncTotalProductStock

For a specific use case: if an application wants to synchronize the total inventory quantity across all locations. Use it if your application only stores a total inventory quantity for each product (not separate quantities per store), and wants to stay up-to-date with all changes made in Erply.

Order Fulfilment

getFulfillableOrders

Returns sales orders that can be fulfilled with the current quantity in stock. (The report arranges unfulfilled sales orders in chronological order, starting with the oldest, and prints out those for which it can allocate inventory.)

Purchases and Inventory Transfers

  1. getPurchaseReport
  2. getInventoryTransferReport

Point of Sale Operations

getPointOfSaleDayTotals

For the "day closing" procedure. Returns the total of all sales transactions taken place during the cashier's shift, grouped by payment method.

getReports

Returns an "X Report" or "Z Report".

  1. getEmployeeStats

Recurring Billing

getBilledUntilDate

Returns all recurring billings and the "billed until" date for each one. This is necessary for deciding which customers need to be issued a new (monthly, yearly) bill — and what period must it cover.

Pricing

  1. getAppliedPromotionRecords

Gift Cards, Coupons, Reward Points

  1. getGiftCardRedeemings
  2. getRedeemedCoupons
  3. getUsedRewardPointRecords
  4. getEarnedRewardPointRecords

Metadata

  1. getUserOperationsLog