📄 MIPYME Documents
Creates a new product
POST
URL del endpoint
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.
Parámetros
Sin parámetros.
Cuerpo de la solicitud — campos
| Campo | Tipo | Obligatoriedad | Descripción |
|---|---|---|---|
name | string | Siempre obligatorio | Product name. |
invoicing_details | string | Opcional | — |
additional_details | string | Opcional | — |
model | string | Opcional | — |
brand | string | Opcional | — |
status | integer | Opcional | 1 = Active, 0 = Inactive. Only active products are synchronized with the ecommerce integration. |
sku | string | Opcional | Product SKU. Must be unique among active products. Required to synchronize the product with the ecommerce integration. |
barcode | string | Opcional | — |
measure_unit | string | Opcional | — |
type | integer | Siempre obligatorio | 0 = Standard product 1 = Variable product master With type = 1 the product is always created as merchandise. |
embedded_quantity_barcode | integer | Opcional | — |
embedded_quantity_barcode_decimals | integer | Opcional | — |
additional_data_1 | string | Opcional | — |
additional_data_2 | string | Opcional | — |
additional_data_3 | string | Opcional | — |
favorite | integer | Opcional | — |
ecommerce_status | enum(publish, draft) | Opcional | Optional. Status used when the product is created in the WooCommerce store: publish (default) or draft. |
product_category_id | integer | Opcional | Product category ID (see /product_categories). |
cost | object | Opcional | Product cost. Stored for merchandise. |
cost.currency_id | integer | Opcional | — |
cost.value | number | Opcional | — |
price | array<object> | Opcional | — |
price[].product_price_list_id | integer | Opcional | 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 | Opcional | — |
price[].unit_tax | number | Opcional | — |
price[].unit_total | number | Opcional | — |
price[].currency_id | integer | Opcional | — |
price[].sales_commission_percentage | number | Opcional | — |
price[].taxes | array<object> | Opcional | — |
price[].taxes[].tax_type_id | string | Opcional | — |
price[].taxes[].tax_percentage | number | Opcional | — |
price[].taxes[].tax_amount | number | Opcional | — |
inventories | object | Opcional | Initial stock per product location. When sent, the product is created as merchandise. |
inventories.total_available | number | Opcional | — |
inventories.total_reserved | number | Opcional | — |
inventories.details | array<object> | Opcional | — |
inventories.details[].product_location_id | string | Opcional | Product location (warehouse) ID (see /product_locations). |
inventories.details[].available_quantity | number | Opcional | — |
inventories.details[].reserved_quantity | number | Opcional | — |
Ejemplo JSON del cuerpo
{
"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
}
]
}
}
Respuestas
201
Product created successfully.