Skip to main content
POST
Products Update
Use this endpoint to update an existing product in your PIC product library.

PIC - Update Product with French Eco-Score requirements

Download our Postman collection example for product creation here.

Request body properties

Implementation details

  • Partial updates: Most fields are optional. Providing them will update the value; omitting them usually leaves the existing value (standard PATCH/Update behavior), though the API treats this as a command object.
  • Purchase order logic: The update logic for purchase orders is complex. You can add, update, and remove purchase orders in a single call.
    • addPurchaseOrder: Appends new purchase orders.
    • updatePurchaseOrder: Matches by _id and updates fields.
    • removePurchaseOrder: Removes purchase orders by _id.
  • FEM assessment IDs: When adding or updating purchase orders with assembly data, ensure you use valid FEM assessment IDs for the femId field.

Authorizations

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

Path Parameters

productId
string
required

Body

application/json
name
string | null
weight
number<double> | null
weightMeasureUnit
enum<string>
Available options:
kilograms,
grams,
milligram,
pound,
ounce
weightIsPrimaryData
boolean | null
taxonomyId
string | null
size
string | null
productCategory
string | null
categoryExpansionId
string | null
packaging
object[] | null
materials
object[] | null
components
object[] | null
addPurchaseOrder
object[] | null
updatePurchaseOrder
object[] | null
removePurchaseOrder
string[] | null
frenchLabelCountry
object

Determines what country this product was made in, for the French Label Eco-Scores.

frenchLabelDyeingCountry
object

Determines what country this product was dyed in, for the French Label Eco-Scores.

frenchLabelFabricCountry
object

Determines what country this product was woven or knitted in, for the French Label Eco-Scores.

frenchLabelOptionalFields
object

Optional durability fields for the French Label Eco-Score, gated by EnableFrenchEcoOptionalFields config key.

isMaterialWeight
boolean | null
identifier
string | null
identifierType
enum<string>
Available options:
GTIN,
SKU,
UPC,
OTHER
tags
string[] | null

Response

200 - application/json

Ok

API light version of a CorpRepProductEntity for the API. Ideally we would do this with a Pick or Omit, but tsoa doesn't recognice those

_id
string
required
name
string
required
weightInformation
object
required

corpRep weight information

type
string
required
createdOn
object
required
user
object
required

This interface was referenced by Exports's JSON-Schema via the definition "userRef".

account
object
required

This interface was referenced by Exports's JSON-Schema via the definition "accountRef".

materials
object[]
required
materialImpact
number<double>
required
tier1Impact
number<double>
required
packagingImpact
number<double>
required
logisticsImpactsUpstreamTD
number<double>
required
logisticsImpactsDTImpact
number<double>
required
logisticsImpactsDCImpact
number<double>
required
logisticsImpactsRetailImpact
number<double>
required
productCareImpacts
number<double>
required
endOfUseImpact
number<double>
required
_rev
string | null
version
string | null
productType
string | null
productCategory
string | null
packagingWeight
object

corpRep weight information

modelNumber
string | null
barcodes
string[] | null
dataSource
string | null
modifiedOn
object | null
deleted
boolean | null
modifiedBy
object

This interface was referenced by Exports's JSON-Schema via the definition "userRef".

deletedBy
object

This interface was referenced by Exports's JSON-Schema via the definition "userRef".

defaultProduct
object | null
components
object[] | null
packaging
object[] | null
notes
string | null
purchaseOrder
object[] | null
purchaseOrderImpactsTotal
object

corpRep weight information

componentImpact
number<double> | null
upstreamTransportation
number<double> | null
downstreamTransportationRetail
number<double> | null
downstreamTransportationConsumer
number<double> | null
distributionCenterUnOwned
number<double> | null
retailEnergyUnOwned
number<double> | null
frenchLabelManufacturingCountry
object

Determines what country this product was made in, for the French Label Eco-Scores.

frenchLabelFabricCountry
object

Determines what country this product was woven or knitted in, for the French Label Eco-Scores.

frenchLabelDyeingCountry
object

Determines what country this product was dyed in, for the French Label Eco-Scores.

frenchLabelOptionalFields
object

Optional durability fields for the French Label Eco-Score, gated by EnableFrenchEcoOptionalFields config key.

frenchLabelEligibility
object

Store information on whether a product is eligible for French Label Eco-Scores.

frenchLabelEcoScore
object

Determines the environmental impacts of a product based on mass, composition, place of manufacture, etc. (See https://ecobalyse.beta.gouv.fr/#/api)

identifier
string | null
identifierType
enum<string>
Available options:
GTIN,
SKU,
UPC,
OTHER
tags
string[] | null