Get sales order info

Access details of a specific sales order with ease.

The GET SalesOrder/{SalesOrderID} endpoint allows you to retrieve detailed information about specific sales orders within the FincoEnergies platform. This endpoint is essential for tracking the status and details of your orders, ensuring that you have full visibility into your transactions at any time.

For our insetting credits, this endpoint goes a step further by providing comprehensive traceability information. You can access details such as feedstock type, vessel type, and bunkering date and location, offering unparalleled transparency into the lifecycle of your credits. Additionally, verified certificates associated with your insetting credits can be downloaded directly through this API, ensuring that you have all necessary documentation for compliance and reporting purposes.

Default request:

Parameters:

• SalesOrderID (required)

For example, use GET SalesOrder/CM000000 (our sales order numbers start with CM followed by 6 digits. 

Request body:

• No input fields needed

Default response:

200: Default response:

{
  "SalesOrder": {
    "Customer": "Example customer  1",
    "SalesOrderID": "CM000000",
    "Status": "AUDITED",
    "EmissionLifecycle": "WtW",
    "OrderDate": "2024-10-08T00:00:00.000Z",
    "FulfillmentDate": "2024-10-08T00:00:00.000Z",
    "AssuranceDate": "2024-01-20T00:00:00.000Z",
    "SalesOrderLines": [
      {
        "SalesOrderLineID": "T-CM000000-1",
        "Product": "GoodShipping Ocean",
        "PricePerUnitInEUR": 1,
        "AmountOfCredits": 5.005,
        "PriceInEUR": 5.005,
        "AllocationStatus": "Allocated (Verified)",
        "AllocationDate": "2024-10-08T00:00:00.000Z",
        "VerificationDate": "2024-10-08T00:00:00.000Z",
        "Traceability": [
          {
            "GHGReductionPercentage": 73.51,
            "GHGReductionWtW": 4,
            "GHGReductionTtW": 4.466,
            "VesselType": "Bulk carrier",
            "FeedstockName": "RawMaterial",
            "BunkerPort": "Amsterdam",
            "DateOfBunkering": "2024-03-31T22:00:00.000Z",
            "BiofuelVolumeM3": 100,
            "EnergyContentMJ": 390000000,
            "EnergyDensityMJM3": 3900000,
            "LastBookDate": "2023-10-14T22:00:00.000Z",
            "LastClaimDate": "2023-10-14T22:00:00.000Z"
          }
        ],
        "Certificate": {
          "Message": "Certficate available",
          "Base64String": "Base64 encoded string"
        }
      }
    ]
  }
}

• Certificate - appears as Base64 code only when the sales order status is "Audited"
• GHGReductionWtW and GHGReductionTtW are displayed in tCO2eq. 

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"
}