SalesKpis

Quick Links

Accounts Accounting Entries Products Customers Sales quotes Sales invoices Suppliers Purchase invoices

HTTP	Operation	Type	Object	DTO Why-DTOs?
POST	Read	⚙️ ActionThe action resource represents a type of object that differs from standard queries or mutations. For a query, it returns a result already prepared by Sage Active, with no possibility to add filters, sorts, or explore the data further, or it executes an action (e.g., sending an email). For a mutation, it executes a specific business action, also carried out by Sage Active, which will impact the data (e.g., generating a credit note from an invoice). (Query)	`salesKpis`	`SalesKpiInput`

The Sales KPIs service provides a set of commercial indicators (Key Performance Indicators) that can be retrieved for a given organization.
Each KPI corresponds to a standardized calculation based on the organization’s sales and related data.

Provides sales performance indicators such as incoming and outgoing payments, value of open quotes, number of customers, etc.
Includes KPIs related to quotes conversion through their related sales documents.
Supports retrieval of one or multiple KPIs in a single call.

Input Parameters

kpiTypes – Mandatory. One or several values from the enumeration SalesIndicatorType (see table below).

Response

The service returns a structured list of KPIs. Each KPI contains:

type – The KPI identifier (enum).
value – The numeric value of the KPI.
currency – The currency code (e.g. EUR).

Example response for MONEY_IN

{
  "data": {
    "salesKpis": [
      {
        "type": "MONEY_IN",
        "value": 79566.8,
        "currency": "EUR"
      }
    ]
  }
}

How to use the Sales KPIs service?

Query

query ($kpis: [SalesIndicatorType!]!) {
  salesKpis(input: { kpiTypes: $kpis }) {
    type
    value
    currency
  }
}

Variable for a single KPI

{
  "kpis": ["MONEY_IN"]
}

Response

{
  "data": {
    "salesKpis": [
      {
        "type": "MONEY_IN",
        "value": 79566.8,
        "currency": "EUR"
      }
    ]
  }
}

Variable for multiple KPIs

{
  "kpis": ["MONEY_IN", "MONEY_OUT"]
}