Get a list with sales orders

Review all your sales orders in one place.

The GET SalesOrderList endpoint allows users to retrieve a comprehensive list of all sales orders placed within the FincoEnergies platform. This feature will enable you to efficiently track and manage multiple orders, providing a clear overview of your transactions. While this endpoint is not yet live, it is designed to streamline order management by offering quick access to order histories and statuses in one consolidated view. Stay tuned for updates as we prepare to launch this valuable addition to our API suite.

Default request:

Parameters (optional):

If desired, the user can add a parameter to the url to obtain a filtered sales order list on "Sales Order Status". The different sales order statuses available are:

• 'quotation' → Quotation - This concerns a draft quotation that has not been submitted by the user yet.

• 'quotationsubmitted' → Quotation submitted - this concerns a quotation that has been submitted to FincoEnergies. Next step: the commercial team of FincoEnergies converts this quotation into a sales order.

• 'awaitingsignature' → Quotation confirmed, awaiting signature - this concerns a quotation that has been confirmed by FincoEnergies. Next step: the quotation needs to be signed by the user to convert it into a sales order.

• 'invoicing' → Invoicing - an invoice from FincoEnergies team is sent out to the user. The invoice has not yet been paid.

• 'awaitingtobefulfilled' → Awaiting to be fulfilled. The invoice has been paid, waiting for FincoEnergies to fulfill the sales order.

• 'fulfilled' → Fulfilled - the FincoEnergies team has fulfilled the concerning sales order. Awaiting auditing by third party.

• 'audited' → Audited - FincoEnergies' assurance partner has now verified the sales order. The verified client certificate will be released to your sales order.

Request body:

• No input fields needed

Default response:

200: Default response

{
  "SalesOrders": [
    {
      "Customer": "Example customer 1",
      "SalesOrderID": "CM000001",
      "Reference": "First Sales Order",
      "Status": "Audited",
      "EmissionLifecycle": "WtW",
      "OrderDate": "2024-06-17T09:50:43.431Z",
      "AmountOfCredits": 1,
      "ProductCategory": "GoodShipping Ocean",
      "TotalPriceInEUR": 1
    },
    {
      "Customer": "Example customer 2",
      "SalesOrderID": "CM000001",
      "Reference": "Second Sales Order",
      "Status": "Confirmed - awaiting signature",
      "EmissionLifecycle": "WtW",
      "OrderDate": "2024-06-17T11:43:28.916Z",
      "AmountOfCredits": 11,
      "ProductCategory": "Dutch Methane Recovery Project",
      "TotalPriceInEUR": 1
    }
  ]
}

404: No SalesOrders found

{
  "Message": "No SalesOrders found"
}

422: Validation error response

{
  "error": "Description of validation error."
}

500: Default error response

{
  "error": "Description of the error(s) that occurred."
}

504: Timeout error response

{
  "error": "Timeout waiting for response"
}