Añadir nuevo producto

Añadir un nuevo producto.

POST /api/rest_admin/products

Parámetros

post

{
    "product_description": {
        "2": {
            "name": "product1",
            "description": "product1 description",
            "meta_title": "product1",
            "meta_description": "product1 meta description",
            "meta_keyword": "product1 keywords",
            "canonical": "p1-canonical"
        }
    },
    "image": "",
    "model": "x",
    "sku": "",
    "upc": "",
    "ean": "",
    "jan": "",
    "isbn": "",
    "mpn": "",
    "location": "",
    "price": "",
    "tax_class_id": "11",
    "quantity": "1000",
    "minimum": "1",
    "subtract": "1",
    "stock_status_id": "6",
    "shipping": "1",
    "keyword": {
        "2": "cat1-seo"
    },
    "date_available": "2020-09-30",
    "length": "",
    "width": "",
    "height": "",
    "length_class_id": "1",
    "weight": "2",
    "weight_class_id": "1",
    "status": "1",
    "sort_order": "1",
    "tag": "",
    "manufacturer": "Apple",
    "manufacturer_id": "8",
    "category": "",
    "product_category": {
        "0": "66",
        "1": "67"
    },
    "filter": "",
    "product_store": {
        "0": "0"
    },
    "download": "",
    "related": "",
    "option": "",
    "product_image": {
        "0": {
            "image": "catalog/ipod_touch_7.jpg",
            "sort_order": 1
        }
    },
    "points": "",
    "product_related": {
        "0": "75"
    },
    "product_attribute": {
        "0": {
            "name": "idclient1",
            "attribute_id": "1",
            "product_attribute_description": {
                "2": {
                    "text": "26"
                }
            }
        }
    },
    "product_option": {
        "0": {
            "product_option_id": "",
            "name": "Checkbox",
            "option_id": "2",
            "type": "checkbox",
            "required": "1",
            "product_option_value": {
                "0": {
                    "option_value_id": "23",
                    "quantity": "1",
                    "subtract": "1",
                    "price_prefix": "+",
                    "price": "10",
                    "points_prefix": "+",
                    "points": "",
                    "weight_prefix": "+",
                    "weight": ""
                },
                "1": {
                    "option_value_id": "24",
                    "quantity": "2",
                    "subtract": "1",
                    "price_prefix": "+",
                    "price": "20",
                    "points_prefix": "+",
                    "points": "",
                    "weight_prefix": "+",
                    "weight": ""
                }
            }
        }
    },
    "product_discount": {
        "0": {
            "customer_group_id": "1",
            "quantity": "5",
            "priority": "",
            "price": "95",
            "date_start": "2020-10-01",
            "date_end": "2020-09-30"
        }
    },
    "product_special": {
        "0": {
            "customer_group_id": "1",
            "priority": "1",
            "price": "90",
            "date_start": "2020-11-01",
            "date_end": "2020-11-10"
        }
    }
}

product_description object	Descripción.
produc_description > 2 object	Idioma de la descripción. Ver tabla de idiomas e Id de idioma.
product_description > 2 name string	Nombre.
product_description > 2 description string	Descripción del producto.
product_description > 2 meta_title string	Meta título.
product_description > 2 meta_description string	Meta descripción.
product_description > 2 meta_keyword string	Palabras clave.
product_description > 2 canonical string	Url canonical. CAdena de carácteres sin espacions en blanco.
image string	Nombre de la imágen principal, con la ruta completa.
model string	Modelo del producto.
sku string	Código sku del producto.
upc string	Código upc del producto.
ean string	Código ean del producto.
jan string	Código jan del producto.
isbn string	Código isbn del producto.
mpn string	Código mpn del producto.
location string
price decimal	Precio del producto.
tax_class_id integer	Código del impuesto a aplicar al precio del producto. Ver tabl de impuestos y códigos de impuestos.
quantity integer	Número de productos disponibles.
minimum integer	Unidades mínimas del productos que se permiten comprar.
subtract integer	Indica si se descuentan las unidades del stock de productos cuando se realiza una compra (1 si se descuenta; 0 no se descuenta)
stock_status_id integer	Estado en que se visualiza el producto cuando está fuera de stock. Ver table de estados de stock.
shipping integer	Indica si el producte requiere envío o no (1 requiere envío; 0 no requiere envío)
keywords	Url amigable.
keywords > 2 string	Url amigable del idioma con Id 2. Poner una url para cada idioma.
date_available date	Fecha a partir de la cual el producto está disponible. (Formato AAAA-MM-DD)
length decimal	Medida de largo.
width decimal	Medida de ancho.
height decial	Medida de alto.
length_class_id integer	Id de la unidad de medida utilizada para medir el largo, alto y alto del producto. Ver table de unidades de longitud.
weight decimal	Peso del producto.
weight_class_id integer	Id de la unidades de medida del peso. Ver tabla de unidades de peso.
status integer	Estado del producto (1 acivado; o desactivado)
sort_order integer	Orden de classificación del producto. Por defecte 1.
tag string	Dejar vacio.
manufacturer string	Nombre del fabricante o marca del producto.
manufacturer_id intger	Id del fabricante del producto. Consultar en la lista de marcas desde el panel de administración de la tienda.
category string	Vacio por defecto.
product_category object	Lista de Id de categorias associadas al producto.
product_catgory > 0 integer	Id de la priera categoria associada al producto.
filter object	Lista de Id de filtros associados al producto.
product_store object	Lista de tiendas dónde es visible el producto.
product_store > 0 integer	Simpre 0, el Id de la tienda por defecto.
download object	Lista de Id de elementos descargables.
related string	VAcio por defecto.
option object	Lista de Id de opciones del producto.
product_image object	Objeto que contiene las imágenes adicionales associadas al producto.
product_image > 0 > image string	Nombre de la imágen número 0, con la ruta completa.
product_image > 0 > sort_order integer	Order de classificación de la imágen número 0.
points integer	Número de puntos necesarios para comprar el producto, en la compra por puntos. Por defecto vacio.
product_related object	List de Id de los productos relacionados.
product_related > 0 integer	Id del producto relacionado número 0.
product_attribute object	Lista de atributos del producto.
product_attribute > 0 > name string	Nombre del atributo.
product_attribute > 0 > attribute_id integer	Id del atributo.
product_attribute > 0 > product_attribute_description object	Descripción del atributo
product_attribute > 0 > product_attribute_description > 2 object	Idioma de la descripción del atributo.
product_attribute > 0 > product_attribute_description > 2 > text string	Descripción del atributo.
product_option object	Lista de opciones del producto.
product_option > 0 > product_option_id integer
product_option > 0 > name string	Nombre de la opción.
product_option > 0 > option_id integer
product_option > 0 > type string	Tipo de opción: checkbox, date, date&time, deliverydate, file.
product_option > 0 > required	Si es oblegatorio o no (1 obligatorio; 2 no obligatorio).
product_option > 0 > product_option_value > 0 > option_value_id integer	Id del valor.
product_option > 0 > product_option_value > 0 > quantity integer	Cantidad de productor.
product_option > 0 > product_option_value > 0 > subtract integer	Si se resta del stock (1 retar; 0 no restar).
product_option > 0 > product_option_value > 0 > price_prefix character	Si añade el importe al precio o lo quita (+ añade; - resta).
product_option > 0 > product_option_value > 0 > price decimal	Precio de la copción. Este se añade o se quita al precio final del producto.
product_option > 0 > product_option_value > 0 > points_prefix character	Si añaden los puntos o se quitan (+ añade; - resta).
product_option > 0 > product_option_value > 0 > points decimal	Puntos a añadir o quitar.
product_option > 0 > product_option_value > 0 > weight_prefix character	Si añade peso o se quita (+ añade; - quita).
product_option > 0 > product_option_value > 0 > weight decimal	Peso a añadir o quitar.
product_discount object	Lista de descuentos.
product_discount > 0 > customer_group_id integer	Id del grupo de clientes al que aplicar el descuento. Grupo por defecto 1.
product_discount > 0 > priority integer	Prioridad del descuento. Por defecto 1.
product_discount > 0 > price decimal	Precio del descuento.
product_discount > 0 > date_start date	Fecha en que empieza el descuento. (Formato: AAAA-MM-DD)
product_discount > 0 > date_end date	Fecha en que finaliza el descuento. (Formato: AAAA-MM-DD)
product_special object	Precio especial.
product_special > 0 > customer_group_id integer	Id del grupo de clientes al que aplicar el precio especial. Grupo por defecto 1.
product_special > 0 > priority integer	Prioridad del precio especial. Por defecto 1.
product_special > 0 > price decimal	Precio especial.
product_special > 0 > date_start date	Fecha en que empieza el precio especial. (Formato: AAAA-MM-DD)
product_special > 0 > date_end date	Fecha en que finaliza el precio especial. (Formato: AAAA-MM-DD )

Cabeceras HTTP

X-Sushi-Token-Id

Token de autorización.

Respuesta

{
    "success": 1,
    "error": [],
    "data": {
        "product_id": 99
    }
}

success integer	0 si hay error, 1 si no hay error.
error string	Descripción del error.
data json object	Datos de respuesta.
product_id integer	Id del producto.

Ejemplos

cURL

curl --location --request POST 'http://sushi.loc/api/rest_admin/products' \
--header 'X-Sushi-Token-Id: i2u4f8avuue7if3tthflh32641' \
--header 'Content-Type: application/json' \
--data-raw '{
    "product_description": {
        "2": {
            "name": "product1",
            "description": "product1 description",
            "meta_title": "product1",
            "meta_description": "product1 meta description",
            "meta_keyword": "product1 keywords",
            "canonical": "p1-canonical"
        }
    },
    "image": "",
    "model": "x",
    "sku": "",
    "upc": "",
    "ean": "",
    "jan": "",
    "isbn": "",
    "mpn": "",
    "location": "",
    "price": "",
    "tax_class_id": "11",
    "quantity": "1000",
    "minimum": "1",
    "subtract": "1",
    "stock_status_id": "6",
    "shipping": "1",
    "keyword": {
        "2": "cat1-seo"
    },
    "date_available": "2020-09-30",
    "length": "",
    "width": "",
    "height": "",
    "length_class_id": "1",
    "weight": "2",
    "weight_class_id": "1",
    "status": "1",
    "sort_order": "1",
    "tag": "",
    "manufacturer": "Apple",
    "manufacturer_id": "8",
    "category": "",
    "product_category": {
        "0": "66",
        "1": "96"
    },
    "filter": "",
    "product_store": {
        "0": "0"
    },
    "download": "",
    "related": "",
    "option": "",
    "product_image": {
        "0": {
            "image": "catalog/ipod_touch_7.jpg",
            "sort_order": 1
        }
    },
    "points": "",
    "product_related": {
        "0": "97"
    },
    "product_attribute": {
        "0": {
            "name": "idclient1",
            "attribute_id": "1",
            "product_attribute_description": {
                "2": {
                    "text": "26"
                }
            }
        }
    },
    "product_option": {
        "0": {
            "product_option_id": "",
            "name": "Checkbox",
            "option_id": "2",
            "type": "checkbox",
            "required": "1",
            "product_option_value": {
                "0": {
                    "option_value_id": "23",
                    "quantity": "1",
                    "subtract": "1",
                    "price_prefix": "+",
                    "price": "10",
                    "points_prefix": "+",
                    "points": "",
                    "weight_prefix": "+",
                    "weight": ""
                },
                "1": {
                    "option_value_id": "24",
                    "quantity": "2",
                    "subtract": "1",
                    "price_prefix": "+",
                    "price": "20",
                    "points_prefix": "+",
                    "points": "",
                    "weight_prefix": "+",
                    "weight": ""
                }
            }
        }
    },
    "product_discount": {
        "0": {
            "customer_group_id": "1",
            "quantity": "5",
            "priority": "",
            "price": "95",
            "date_start": "2020-10-01",
            "date_end": "2020-09-30"
        }
    },
    "product_special": {
        "0": {
            "customer_group_id": "1",
            "priority": "1",
            "price": "90",
            "date_start": "2020-11-01",
            "date_end": "2020-11-10"
        }
    }
}'

PHP - cURL

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "http://sushi.loc/api/rest_admin/products",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS =>"{\n    \"product_description\": {\n        \"2\": {\n            \"name\": \"product1\",\n            \"description\": \"product1 description\",\n            \"meta_title\": \"product1\",\n            \"meta_description\": \"product1 meta description\",\n            \"meta_keyword\": \"product1 keywords\",\n            \"canonical\": \"p1-canonical\"\n        }\n    },\n    \"image\": \"\",\n    \"model\": \"x\",\n    \"sku\": \"\",\n    \"upc\": \"\",\n    \"ean\": \"\",\n    \"jan\": \"\",\n    \"isbn\": \"\",\n    \"mpn\": \"\",\n    \"location\": \"\",\n    \"price\": \"\",\n    \"tax_class_id\": \"11\",\n    \"quantity\": \"1000\",\n    \"minimum\": \"1\",\n    \"subtract\": \"1\",\n    \"stock_status_id\": \"6\",\n    \"shipping\": \"1\",\n    \"keyword\": {\n        \"2\": \"cat1-seo\"\n    },\n    \"date_available\": \"2020-09-30\",\n    \"length\": \"\",\n    \"width\": \"\",\n    \"height\": \"\",\n    \"length_class_id\": \"1\",\n    \"weight\": \"2\",\n    \"weight_class_id\": \"1\",\n    \"status\": \"1\",\n    \"sort_order\": \"1\",\n    \"tag\": \"\",\n    \"manufacturer\": \"Apple\",\n    \"manufacturer_id\": \"8\",\n    \"category\": \"\",\n    \"product_category\": {\n        \"0\": \"66\",\n        \"1\": \"96\"\n    },\n    \"filter\": \"\",\n    \"product_store\": {\n        \"0\": \"0\"\n    },\n    \"download\": \"\",\n    \"related\": \"\",\n    \"option\": \"\",\n    \"product_image\": {\n        \"0\": {\n            \"image\": \"catalog/ipod_touch_7.jpg\",\n            \"sort_order\": 1\n        }\n    },\n    \"points\": \"\",\n    \"product_related\": {\n        \"0\": \"97\"\n    },\n    \"product_attribute\": {\n        \"0\": {\n            \"name\": \"idclient1\",\n            \"attribute_id\": \"1\",\n            \"product_attribute_description\": {\n                \"2\": {\n                    \"text\": \"26\"\n                }\n            }\n        }\n    },\n    \"product_option\": {\n        \"0\": {\n            \"product_option_id\": \"\",\n            \"name\": \"Checkbox\",\n            \"option_id\": \"2\",\n            \"type\": \"checkbox\",\n            \"required\": \"1\",\n            \"product_option_value\": {\n                \"0\": {\n                    \"option_value_id\": \"23\",\n                    \"quantity\": \"1\",\n                    \"subtract\": \"1\",\n                    \"price_prefix\": \"+\",\n                    \"price\": \"10\",\n                    \"points_prefix\": \"+\",\n                    \"points\": \"\",\n                    \"weight_prefix\": \"+\",\n                    \"weight\": \"\"\n                },\n                \"1\": {\n                    \"option_value_id\": \"24\",\n                    \"quantity\": \"2\",\n                    \"subtract\": \"1\",\n                    \"price_prefix\": \"+\",\n                    \"price\": \"20\",\n                    \"points_prefix\": \"+\",\n                    \"points\": \"\",\n                    \"weight_prefix\": \"+\",\n                    \"weight\": \"\"\n                }\n            }\n        }\n    },\n    \"product_discount\": {\n        \"0\": {\n            \"customer_group_id\": \"1\",\n            \"quantity\": \"5\",\n            \"priority\": \"\",\n            \"price\": \"95\",\n            \"date_start\": \"2020-10-01\",\n            \"date_end\": \"2020-09-30\"\n        }\n    },\n    \"product_special\": {\n        \"0\": {\n            \"customer_group_id\": \"1\",\n            \"priority\": \"1\",\n            \"price\": \"90\",\n            \"date_start\": \"2020-11-01\",\n            \"date_end\": \"2020-11-10\"\n        }\n    }\n}",
  CURLOPT_HTTPHEADER => array(
    "X-Sushi-Token-Id: i2u4f8avuue7if3tthflh32641",
    "Content-Type: application/json"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;