Link Search Menu Expand Document

Actualizar producto

Añadir un producto.


PUT /api/rest_admin/products/:id

Parámetros

get

id integerId del producto.

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 objectDescripción.
produc_description > 2 objectIdioma de la descripción. Ver tabla de idiomas e Id de idioma.
product_description > 2 name stringNombre.
product_description > 2 description stringDescripción del producto.
product_description > 2 meta_title stringMeta título.
product_description > 2 meta_description stringMeta descripción.
product_description > 2 meta_keyword stringPalabras clave.
product_description > 2 canonical stringUrl canonical. CAdena de carácteres sin espacions en blanco.
image stringNombre de la imágen principal, con la ruta completa.
model stringModelo del producto.
sku stringCódigo sku del producto.
upc stringCódigo upc del producto.
ean stringCódigo ean del producto.
jan stringCódigo jan del producto.
isbn stringCódigo isbn del producto.
mpn stringCódigo mpn del producto.
location string 
price decimalPrecio del producto.
tax_class_id integerCódigo del impuesto a aplicar al precio del producto. Ver tabl de impuestos y códigos de impuestos.
quantity integerNúmero de productos disponibles.
minimum integerUnidades mínimas del productos que se permiten comprar.
subtract integerIndica 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 integerEstado en que se visualiza el producto cuando está fuera de stock. Ver table de estados de stock.
shipping integerIndica si el producte requiere envío o no (1 requiere envío; 0 no requiere envío)
keywordsUrl amigable.
keywords > 2 stringUrl amigable del idioma con Id 2. Poner una url para cada idioma.
date_available dateFecha a partir de la cual el producto está disponible. (Formato AAAA-MM-DD)
length decimalMedida de largo.
width decimalMedida de ancho.
height decialMedida de alto.
length_class_id integerId de la unidad de medida utilizada para medir el largo, alto y alto del producto. Ver table de unidades de longitud.
weight decimalPeso del producto.
weight_class_id integerId de la unidades de medida del peso. Ver tabla de unidades de peso.
status integerEstado del producto (1 acivado; o desactivado)
sort_order integerOrden de classificación del producto. Por defecte 1.
tag stringDejar vacio.
manufacturer stringNombre del fabricante o marca del producto.
manufacturer_id intgerId del fabricante del producto. Consultar en la lista de marcas desde el panel de administración de la tienda.
category stringVacio por defecto.
product_category objectLista de Id de categorias associadas al producto.
product_catgory > 0 integerId de la priera categoria associada al producto.
filter objectLista de Id de filtros associados al producto.
product_store objectLista de tiendas dónde es visible el producto.
product_store > 0 integerSimpre 0, el Id de la tienda por defecto.
download objectLista de Id de elementos descargables.
related stringVAcio por defecto.
option objectLista de Id de opciones del producto.
product_image objectObjeto que contiene las imágenes adicionales associadas al producto.
product_image > 0 > image stringNombre de la imágen número 0, con la ruta completa.
product_image > 0 > sort_order integerOrder de classificación de la imágen número 0.
points integerNúmero de puntos necesarios para comprar el producto, en la compra por puntos. Por defecto vacio.
product_related objectList de Id de los productos relacionados.
product_related > 0 integerId del producto relacionado número 0.
product_attribute objectLista de atributos del producto.
product_attribute > 0 > name stringNombre del atributo.
product_attribute > 0 > attribute_id integerId del atributo.
product_attribute > 0 > product_attribute_description objectDescripción del atributo
product_attribute > 0 > product_attribute_description > 2 objectIdioma de la descripción del atributo.
product_attribute > 0 > product_attribute_description > 2 > text stringDescripción del atributo.
product_option objectLista de opciones del producto.
product_option > 0 > product_option_id integer 
product_option > 0 > name stringNombre de la opción.
product_option > 0 > option_id integer 
product_option > 0 > type stringTipo de opción: checkbox, date, date&time, deliverydate, file.
product_option > 0 > requiredSi es oblegatorio o no (1 obligatorio; 2 no obligatorio).
product_option > 0 > product_option_value > 0 > option_value_id integerId del valor.
product_option > 0 > product_option_value > 0 > quantity integerCantidad de productor.
product_option > 0 > product_option_value > 0 > subtract integerSi se resta del stock (1 retar; 0 no restar).
product_option > 0 > product_option_value > 0 > price_prefix characterSi añade el importe al precio o lo quita (+ añade; - resta).
product_option > 0 > product_option_value > 0 > price decimalPrecio 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 characterSi añaden los puntos o se quitan (+ añade; - resta).
product_option > 0 > product_option_value > 0 > points decimalPuntos a añadir o quitar.
product_option > 0 > product_option_value > 0 > weight_prefix characterSi añade peso o se quita (+ añade; - quita).
product_option > 0 > product_option_value > 0 > weight decimalPeso a añadir o quitar.
product_discount objectLista de descuentos.
product_discount > 0 > customer_group_id integerId del grupo de clientes al que aplicar el descuento. Grupo por defecto 1.
product_discount > 0 > priority integerPrioridad del descuento. Por defecto 1.
product_discount > 0 > price decimalPrecio del descuento.
product_discount > 0 > date_start dateFecha en que empieza el descuento. (Formato: AAAA-MM-DD)
product_discount > 0 > date_end dateFecha en que finaliza el descuento. (Formato: AAAA-MM-DD)
product_special objectPrecio especial.
product_special > 0 > customer_group_id integerId del grupo de clientes al que aplicar el precio especial. Grupo por defecto 1.
product_special > 0 > priority integerPrioridad del precio especial. Por defecto 1.
product_special > 0 > price decimalPrecio especial.
product_special > 0 > date_start dateFecha en que empieza el precio especial. (Formato: AAAA-MM-DD)
product_special > 0 > date_end dateFecha en que finaliza el precio especial. (Formato: AAAA-MM-DD )
date_modified datetimeFecha de modificación (Formato: AAAA-MM-DD hh:mm:ss). Es opcional, solo aplica si existe y si el formato es correcto.

Cabeceras HTTP

X-Sushi-Token-IdToken de autorización.

Respuesta

{
    "success": 1,
    "error": [],
    "data": ""
}
success integer0 si hay error, 1 si no hay error.
error stringDescripción del error.
data json objectDatos de respuesta.

Ejemplos

cURL
curl --location --request PUT 'http://sushi.loc/api/rest_admin/products/93' \
--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"
    },
    "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": "idclient",
            "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/93",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  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    },\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\": \"75\"\n    },\n    \"product_attribute\": {\n        \"0\": {\n            \"name\": \"idclient\",\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;