ES | EN

📄 MIPYME Documents

Creates a new product

POST
Endpoint URL https://apifacto.com/v1/products
Adds a new product with the provided details.

Parameters

No parameters.

Request body — fields

FieldTypeRequiredDescription
namestringAlways required—
invoicing_detailsstringOptional—
additional_detailsstringOptional—
modelstringOptional—
brandstringOptional—
statusintegerAlways required—
skustringOptional—
barcodestringOptional—
measure_unitstringOptional—
typeintegerOptional—
embedded_quantity_barcodeintegerOptional—
embedded_quantity_barcode_decimalsintegerOptional—
additional_data_1stringOptional—
additional_data_2stringOptional—
additional_data_3stringOptional—
favoriteintegerOptional—
product_category_idintegerAlways required—
costobjectAlways required—
cost.currency_idintegerOptional—
cost.valuenumberOptional—
pricearray<object>Always required—
price[].price_list_idintegerOptional—
price[].unit_netnumberOptional—
price[].unit_taxnumberOptional—
price[].unit_totalnumberOptional—
price[].currency_idintegerOptional—
price[].sales_commission_percentagenumberOptional—
price[].taxesarray<object>Optional—
price[].taxes[].tax_type_idstringOptional—
price[].taxes[].tax_percentagenumberOptional—
price[].taxes[].tax_amountnumberOptional—
inventoriesobjectOptional—
inventories.total_availablenumberOptional—
inventories.total_reservednumberOptional—
inventories.detailsarray<object>Optional—
inventories.details[].product_location_idstringOptional—
inventories.details[].available_quantitynumberOptional—
inventories.details[].reserved_quantitynumberOptional—

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,
    "product_category_id": 0,
    "cost": {
        "currency_id": 0,
        "value": 0
    },
    "price": [
        {
            "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.