📄 MIPYME Documents
Creates a new product
POST
Endpoint URL
https://apifacto.com/v1/products
Adds a new product with the provided details.
Merchandise or service: the product is created as merchandise (with inventory control) when type = 1 or when inventories are sent; otherwise it is created as a service.
Ecommerce sync: if the account has an active ecommerce integration (WooCommerce, Shopify or Jumpseller), active products with a SKU are sent to the store (matched by SKU), and the initial stock is synchronized too. Use ecommerce_status = draft to create the product as a draft in WooCommerce.
Merchandise or service: the product is created as merchandise (with inventory control) when type = 1 or when inventories are sent; otherwise it is created as a service.
Ecommerce sync: if the account has an active ecommerce integration (WooCommerce, Shopify or Jumpseller), active products with a SKU are sent to the store (matched by SKU), and the initial stock is synchronized too. Use ecommerce_status = draft to create the product as a draft in WooCommerce.
Parameters
No parameters.
Request body — fields
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Always required | Product name. |
invoicing_details | string | Optional | — |
additional_details | string | Optional | — |
model | string | Optional | — |
brand | string | Optional | — |
status | integer | Optional | 1 = Active, 0 = Inactive. Only active products are synchronized with the ecommerce integration. |
sku | string | Optional | Product SKU. Must be unique among active products. Required to synchronize the product with the ecommerce integration. |
barcode | string | Optional | — |
measure_unit | string | Optional | — |
type | integer | Always required | 0 = Standard product 1 = Variable product master With type = 1 the product is always created as merchandise. |
embedded_quantity_barcode | integer | Optional | — |
embedded_quantity_barcode_decimals | integer | Optional | — |
additional_data_1 | string | Optional | — |
additional_data_2 | string | Optional | — |
additional_data_3 | string | Optional | — |
favorite | integer | Optional | — |
ecommerce_status | enum(publish, draft) | Optional | Optional. Status used when the product is created in the WooCommerce store: publish (default) or draft. |
product_category_id | integer | Optional | Product category ID (see /product_categories). |
cost | object | Optional | Product cost. Stored for merchandise. |
cost.currency_id | integer | Optional | — |
cost.value | number | Optional | — |
price | array<object> | Optional | — |
price[].product_price_list_id | integer | Optional | Price list ID (see /product_price_lists). To synchronize the product with the ecommerce integration it must have a price in price list 1. |
price[].unit_net | number | Optional | — |
price[].unit_tax | number | Optional | — |
price[].unit_total | number | Optional | — |
price[].currency_id | integer | Optional | — |
price[].sales_commission_percentage | number | Optional | — |
price[].taxes | array<object> | Optional | — |
price[].taxes[].tax_type_id | string | Optional | — |
price[].taxes[].tax_percentage | number | Optional | — |
price[].taxes[].tax_amount | number | Optional | — |
inventories | object | Optional | Initial stock per product location. When sent, the product is created as merchandise. |
inventories.total_available | number | Optional | — |
inventories.total_reserved | number | Optional | — |
inventories.details | array<object> | Optional | — |
inventories.details[].product_location_id | string | Optional | Product location (warehouse) ID (see /product_locations). |
inventories.details[].available_quantity | number | Optional | — |
inventories.details[].reserved_quantity | number | Optional | — |
Request body — JSON example
{
"name": "string",
"invoicing_details": "string",
"additional_details": "string",
"model": "string",
"brand": "string",
"status": 0,
"sku": "string",
"barcode": "string",
"measure_unit": "string",
"type": 0,
"embedded_quantity_barcode": 0,
"embedded_quantity_barcode_decimals": 0,
"additional_data_1": "string",
"additional_data_2": "string",
"additional_data_3": "string",
"favorite": 0,
"ecommerce_status": "string",
"product_category_id": 0,
"cost": {
"currency_id": 0,
"value": 0
},
"price": [
{
"product_price_list_id": 0,
"unit_net": 0,
"unit_tax": 0,
"unit_total": 0,
"currency_id": 0,
"sales_commission_percentage": 0,
"taxes": [
{
"tax_type_id": "...",
"tax_percentage": "...",
"tax_amount": "..."
}
]
}
],
"inventories": {
"total_available": 0,
"total_reserved": 0,
"details": [
{
"product_location_id": "string",
"available_quantity": 0,
"reserved_quantity": 0
}
]
}
}
Responses
201
Product created successfully.