3.1 Data Access Methodology

The API operates within the context of the authenticated user. Data retrieval is handled through the viewer object, which contains the account object. You do not need to specify the account ID within the GraphQL query itself to retrieve data for your account; the account is implicitly identified by the JSON Web Token.
 

3.2 Retrieving Services and Sites

The Account object contains lists of Service and Site objects. The Service object fields include serviceId (or Order ID), status, plannedDeliveryDate, readyForServiceDate, and technicalNote.

Example Query: RetrieveServicesAndSites

query RetrieveServicesAndSites($serviceId: String, $siteName: String) {
  viewer {
    account {
      accountId # Expereo Account ID
      name
      services(id: $serviceId) {
        serviceId # The Service ID (or Order ID)
        serviceName
        status # Order status (In progress or RFS)
        readyForServiceDate
        technicalNote # Includes comments about the service
        ...
      }
      sites(name: $siteName) {
        siteId
        name
        city
        country
        ...
      }
    }
  }
}

3.3 Retrieving Invoice Lines

The Account object contains the invoiceLines array. This functionality has been updated to allow customers to retrieve all their invoices.

Example Query: RetrieveInvoiceLinesForAccount

query RetrieveInvoiceLinesForAccount {
  viewer {
    account {
      accountId
      name
      invoiceLines { # List of InvoiceLine of an acccout for the current Month
        invoiceCurrency
        invoiceDate
        invoiceReference
        orderIDExpereo
        siteAddress
        sumInvoiceLineInvoiceCurrencyAmount
        ... (many other fields available: orderName, orderRFSDate, etc.)
      }
    }
  }
}