Skip to main content
POST
Create Purchase Orders
Use this endpoint to create a new purchase order and associate it with an existing product in your PIC library. Purchase orders track sourcing records and enable Scope 3 impact calculations. Purchases can optionally be linked to a Tier 1 FEM assessment by providing the assessment identifier in the purchaseOrder.assembly.femId field.

PIC - Create a Purchase Order

Request body params

Implementation Details

  • Product association: The purchase order is added to the specified product. The product must exist and belong to your account.
  • FEM linking constraints: Products imported from the Higg Product Module cannot be linked to a FEM. This endpoint only accepts purchaseOrder.assembly.femId for FEM linking; any flags such as isDefault are derived by the server and may appear only in responses.
  • Date format: The expected format for purchaseDate is YYYY-MM-DD. The field is a plain string in the API contract.

Authorizations

x-api-key
string
header
required
x-developer-request-token
string
header
required

Body

application/json
productId
string
required
purchaseOrder
object
required

Response

200 - application/json

Ok

productId
string
required
purchaseOrder
object[]
required
createdOn
string
required