COcoevera
Product

Create a product

Creates one product and answers 201 with the record. name and unit_symbol are required, and sku must be unique.

post/entities/Products

Request

Query parameters

validation-levelinteger

Bit mask that relaxes validation on this write. 0 (the default) validates everything. Bits: 2 skip unchanged fields, 4 skip admin-defined validations, 8 allow read-only fields, 16 skip relation checks, 32 skip value checks, 64 skip invalid recalculations, 128 skip step-checklist gates, 256 add conditional field requirements, 512 skip uniqueness checks. Add bits together (20 = 4 + 16); member names and comma lists such as 4,16 work too. A value with an internal-only bit is refused with HTTP 400, code 117.

Request body

modifiedstring date-time

Last modification time.

createdstring date-time

Creation time.

allowed_pipelines1 | 2

Whether this product can be added to all pipelines or only the explicitly linked subset (see product_pipeline_relations).

Integer enum value: 1 - All, 2 - Selected

currency_exchange_rates_list_idstring uuid

Id of the currency exchange rate list applied to this product.

descriptionstring

Free-form description of the product.

namestring required

Name of the product, shown in catalogues and pickers.

picture_idstring uuid

Id of the product picture document.

product_category_idstring uuid

Id of the product category this product belongs to, or empty when it is not categorized.

product_type_idstring uuid

Id of the product type that classifies this product.

skustring

Stock-keeping unit (SKU) of the product, unique in the space: a second product with the same sku is refused with HTTP 400. A deleted product's sku can be used again.

unit_symbolstring required

Unit of measure shown next to product quantities, such as pcs, kg or hours; required on create.

revisioninteger

Revision when entity was lastly changed.

picture_source_urlstring

URL of an image to use as the product picture. The image is downloaded from this URL and checked; only pictures are supported.

Example request

{
  "modified": "2019-01-01T00:00:00",
  "created": "2019-01-01T00:00:00",
  "allowed_pipelines": 1,
  "currency_exchange_rates_list_id": "01234567-abcd-dcba-ffff-000000000000",
  "description": "string",
  "name": "string",
  "picture_id": "01234567-abcd-dcba-ffff-000000000000",
  "product_category_id": "01234567-abcd-dcba-ffff-000000000000",
  "product_type_id": "01234567-abcd-dcba-ffff-000000000000",
  "sku": "string",
  "unit_symbol": "string",
  "revision": 1,
  "product_pipelines": {
    "allowed_pipelines": 1
  },
  "picture_source_url": "string"
}

Response

The created Product record.

successboolean

True when the request succeeded; false on error.

Example response

{
  "success": true,
  "data": {
    "id": "01234567-abcd-dcba-ffff-000000000000",
    "modified": "2019-01-01T00:00:00",
    "created": "2019-01-01T00:00:00",
    "allowed_pipelines": 1,
    "currency_exchange_rates_list_id": "01234567-abcd-dcba-ffff-000000000000",
    "description": "string",
    "name": "string",
    "picture_id": "01234567-abcd-dcba-ffff-000000000000",
    "product_category_id": "01234567-abcd-dcba-ffff-000000000000",
    "product_type_id": "01234567-abcd-dcba-ffff-000000000000",
    "sku": "string",
    "unit_symbol": "string",
    "revision": 1,
    "product_pipelines": {
      "allowed_pipelines": 1
    },
    "formatted_name": "string",
    "oppty_product_relation_type_id": "01234567-abcd-dcba-ffff-000000000000"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.