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;