Skip to content

Create manufactured product

Request

Use this endpoint to create the product that your manufacturer has sold to you. This is different from your own brand product data, which you send via POST /brand-products.

Traceability collection: to link purchased inputs for Fairly Made supplier data collection, reference them via purchasedItems (each purchased item must include a purchaseOrder on POST /purchased-items). Links made only through usedComponents or usedProducts are not taken into account for that analysis.

Bodyapplication/jsonrequired
uniqueIdentifierstringrequired

This identifier will make each product unique in our systems.

ownerKindstring
Value:"SUPPLIER"
ownerIdstring, (uuid)

System UUID of the manufacturing supplier. Provide exactly one of ownerId or ownerUniqueIdentifier (with ownerKind = SUPPLIER), or use address instead — not both owner and address.

ownerUniqueIdentifierstring

Client uniqueIdentifier of the manufacturing supplier. Requires ownerKind = SUPPLIER. Mutually exclusive with ownerId and with address.

addressobject(Address)

Postal address of an entity.

categorystringrequired

Product category taxonomy. Values.

Enum:"ACCESSORIES""APRONS""BACKPACKS""BATHROBES""BATH_MATS""BATH_TOWELS""BEACH_BAGS""BEACH_TOWELS""BEANIES""BELTS"
stepsArray of objects(ProductStep)
purchasedItemsArray of objects(PurchasedItemUsage)

Purchased items used in this product. If the purchased item is a component, usageCategory is mandatory. Only applicable when the entity is linked with an owner (ownerKind with ownerId or ownerUniqueIdentifier); not used when providing a processing step address. Sum of purchased items and used items usagePercentage must equal 100. For Fairly Made traceability / supplier data collection, use purchasedItems (each related purchased item must have a purchaseOrder). Links made only through usedComponents or usedProducts are not taken into account for that analysis.

usedProductsArray of objects(UsedProduct)

Other manufactured products used as inputs. Counts toward the same 100% total as purchasedItems and usedComponents (sum of all usagePercentage must equal 100). Not taken into account for Fairly Made supplier data collection — use purchasedItems instead.

usedComponentsArray of objects(UsedComponent)

Components used as inputs for this product. Not taken into account for Fairly Made supplier data collection — use purchasedItems instead.

Creation of a product with a supplier as owner. Owner is specified via ownerKind and ownerId; no processing step address.

curl -i -X POST \
  https://doc.api.fairlymade.com/_mock/swagger-fairlymadeapi-v3/manufactured-products \
  -H 'Content-Type: application/json' \
  -d '{
    "uniqueIdentifier": "FM-PRODUCT-SHIRT-0001",
    "ownerKind": "SUPPLIER",
    "ownerId": "f0b5fb65-f065-432e-9e96-c52692931626",
    "category": "SHIRTS"
  }'

Responses

Manufactured product created

Bodyapplication/json
manufacturedProductIdstring, (uuid)

Identifier of the created manufactured product. UUID v4 format.

Response
{
  "manufacturedProductId": "06dee5c1-8885-4d10-bf9a-14a0957b1487"
}