ProductCreate

El cuerpo transmitido por el POST es una estructura XML. Las etiquetas que no encierran un valor se ignoran; por lo tanto, en el ejemplo siguiente, el endpoint ignorará ParentSku, aunque se proporcionó.

Puede crear varios productos especificando varias etiquetas de producto.

Esta llamada crea un feed, que luego es procesado por el sistema en segundo plano.

Datos de la solicitud

<?xml version="1.0" encoding="UTF-8" ?>
<Request>
	<Product>
		<SellerSku>TEST-SKU-12345</SellerSku>
		<Name>PRODUCT TEST - TEST - TEST</Name>
		<Variation>L</Variation>
		<Status>active</Status>
		<ParentSku/>
		<PrimaryCategory>13825</PrimaryCategory>
		<Categories>2,3,5</Categories>
		<Description><![CDATA[<div>la descripción <b>negrita</b></div>]]></Description>
		<Brand>Under Armour</Brand>
		<Price>139950</Price>
		<ProductId>9003324</ProductId>
		<TaxClass>IVA 19%</TaxClass>
		<Quantity>10</Quantity>
		<ProductData>
			<ShortDescription>TEST TEST TEST TEST</ShortDescription>
			<ConditionType>Nuevo</ConditionType>
			<PackageHeight>1</PackageHeight>
			<PackageWidth>1</PackageWidth>
			<PackageLength>1</PackageLength>
			<PackageWeight>2</PackageWeight>
			<ProductWeight>2</ProductWeight>
			<ProductMeasures>1 x 1 x 1</ProductMeasures>
		</ProductData>
	</Product>
</Request>

<?xml version="1.0" encoding="UTF-8" ?>
<Request>
	<Product>
		<SellerSku>TEST-SKU-12345</SellerSku>
		<Name>PRODUCT TEST - TEST - TEST</Name>
		<Variation>L</Variation>
		<Status>active</Status>
		<PrimaryCategory>13825</PrimaryCategory>
		<Categories>2,3,5</Categories>
		<Description>UA H Tank - Twist Camiseta Manga Sisa morado de mujer para entrenamiento</Description>
		<Brand>Under Armour</Brand>
		<Price>139950</Price>
		<ProductId>9003324</ProductId>
		<TaxClass>IVA 19%</TaxClass>
		<Quantity>10</Quantity>
		<ProductData>
			<ShortDescription>TEST TEST TEST TEST</ShortDescription>
			<ConditionType>Nuevo</ConditionType>
			<PackageHeight>1</PackageHeight>
			<PackageWidth>1</PackageWidth>
			<PackageLength>1</PackageLength>
			<PackageWeight>2</PackageWeight>
			<ProductWeight>2</ProductWeight>
			<ProductMeasures>1 x 1 x 1</ProductMeasures>
		</ProductData>
	</Product>
	<Product>
		<SellerSku>TEST-SKU-1066859</SellerSku>
		<Name>TEST - TEST - TEST PRODUCT</Name>
		<Variation>L</Variation>
		<Status>active</Status>
		<PrimaryCategory>12728</PrimaryCategory>
		<Categories>2,3,5</Categories>
		<Description>UA H Ssv - Twist Camiseta Manga Corta amarillo de mujer para entrenamiento</Description>
		<Brand>Under Armour</Brand>
		<Price>149950</Price>
		<ProductId>32403324</ProductId>
		<TaxClass>IVA 19%</TaxClass>
		<Quantity>10</Quantity>
		<ProductData>
			<ShortDescription>TEST TEST TEST TEST</ShortDescription>
			<ConditionType>Nuevo</ConditionType>
			<PackageHeight>1</PackageHeight>
			<PackageWidth>1</PackageWidth>
			<PackageLength>1</PackageLength>
			<PackageWeight>2</PackageWeight>
			<ProductWeight>2</ProductWeight>
			<ProductMeasures>1 x 1 x 1</ProductMeasures>
		</ProductData>
	</Product>
</Request>

Las etiquetas XML tienen el siguiente significado:

Etiqueta	Tipo	Descripción
SellerSku	String	Un identificador único para el producto dentro de la instancia de Seller Center que se agregará al sistema. Este identificador suele asignarse libremente. Los identificadores armonizados, como UPC o EAN, se pueden configurar a través de ProductId. Obligatorio
ParentSku	String	El identificador único de un producto con el que se debe asociar este producto. [Función ParentSku de nomenclatura libre habilitada] Si se proporciona ParentSku, elegirá el ParentSku definido; de lo contrario, utilizará el SellerSku de la primera variación. Opcional
Status	String	Uno de los siguientes valores: 'active', 'inactive' o 'deleted'. Opcional, predeterminado en 'active'.
Name	String	El nombre del producto que se muestra al usuario final. Obligatorio. Debe tener entre 2 y 255 caracteres.
Variation	String	Si un producto está disponible en múltiples variaciones (por ejemplo, colores o tamaños), éste es el valor de la variación. Por ejemplo, si el producto es una chaqueta que viene en diferentes tamaños, este sería el tamaño de la variación de la chaqueta que se agrega con la llamada (por ejemplo, 'Extra Small').
PrimaryCategory	Integer	El ID de la categoría principal de su producto. Para obtener el ID de cada una de las categorías del sistema, llame a GetCategoryTree. Obligatorio
Categories	String	Una lista separada por comas de una de las tres subcategorías a las que pertenece el producto. Cada una de las subcategorías dadas debe descender de la categoría especificada por el parámetro PrimaryCategory. Opcional
BrowseNodes	String	Una lista separada por comas de una o dos categorías adicionales que no están necesariamente relacionadas con PrimaryCategory. Opcional
Description	String	La descripción del producto, como se muestra al usuario final. 6 a 25000 caracteres. Se permite agregar determinadas etiquetas HTML, pero se deben utilizar como caracteres de escape (ver más abajo). Obligatorio
Brand	String	La marca del producto. Obligatorio
Price	Decimal	El precio del producto. No es realmente un valor de tipo Double, sino Decimal. Obligatorio
SalePrice	Decimal	El precio del producto mientras está en oferta debe ser más bajo que el precio. Si se especifica SalePrice, se debe especificar SaleStartDate o SaleEndDate; viceversa, si se especifica al menos uno de SaleStartDate o SaleEndDate, SalePrice es obligatorio.
SaleStartDate	DateTime	Hora y fecha de comienzo de la oferta del del producto. Si se pasa, SalePrice se vuelve obligatorio.
SaleEndDate	DateTime	Hora y fecha de finalización de la oferta del del producto. Si se pasa, SalePrice se vuelve obligatorio.
TaxClass	String	La clase fiscal a la que pertenece el producto. Las clases de impuestos disponibles dependen de la instalación específica contra la que se ejecuta la llamada. Opcional
ShipmentType	String	Indica si el producto se envía directamente al recibirlo ('crossdocking') o se envía directamente ('dropshipping'). Los tipos de envío permitidos dependen de lo que esté configurado para un vendedor específico. Opcional
ProductId	String	Un código armonizado para el producto, como el Código de producto universal (UPC), el Número de artículo internacional (EAN), el Número de artículo comercial global (GTIN) o el Número de libro estándar internacional (ISBN). Opcional
ConditionType	String	Indica si el producto es nuevo o usado. Uno de "new" (nuevo), "used" (usado) o "refurbished" (reacondicionado). Opcional
ProductData	Subsection	Atributos adicionales del producto, depende de la categoría principal. Opcional
Quantity	Integer	El nivel actual de inventario de este producto. Opcional
VolumetricWeight	Number `DECIMAL(10,2)`
ProductGroup	String	El nombre del grupo

Datos de la respuesta

Utilice la información de respuesta generada para recuperar más detalles del Feed a través de otra llamada a la API FeedStatus . Consulte los detalles de la respuesta a través de FeedList. Tenga en cuenta que mientras realiza la llamada ProductCreate, sólo hacemos una validación básica. Se realizará una validación completa mientras se procesa el feed, por lo que puede ser posible que al agregar 100 productos, sólo se creen 90 de ellos.

Éxito

<?xml version="1.0" encoding="UTF-8"?>
<SuccessResponse>
    <Head>
        <RequestId>cb106552-87f3-450b-aa8b-412246a24b34</RequestId>
        <RequestAction>ProductCreate</RequestAction>
        <ResponseType/>
        <Timestamp>2016-06-22T04:40:14+0200</Timestamp>
    </Head>
    <Body/>
</SuccessResponse>

Errores

<?xml version="1.0" encoding="UTF-8"?>
<ErrorResponse>
    <Head>
        <RequestAction>ProductCreate</RequestAction>
        <ErrorType>Platform</ErrorType>
        <ErrorCode>1000</ErrorCode>
        <ErrorMessage>Could not save product: An exact match of the document is being processed, cb106552-87f3-450b-aa8b-412246a24b34</ErrorMessage>
    </Head>
    <Body/>
</ErrorResponse>

Código de error	Mensaje
1000	Could not save product: %s (No se pudo guardar el producto)
1000	Format Error Detected (Error de formato detectado)

Marcado en la descripción

La descripción del producto puede ser texto sin formato así:

<Description>la descripción</Description>

También puede contener ciertas etiquetas HTML, incluidas ul, li y span. Si HTML está incrustado, debe escaparse como datos de caracteres, así:

<Description><![CDATA[<div>la descripción <b>negrita</b></div>]]></Description>

Crear múltiples variaciones

Para poder crear múltiples variaciones de un producto, debe completar el ParentSku para asociar el producto. Si se pasa un ParentSku, se crea una nueva variación de un producto existente.

[Función ParentSku de nomenclatura libre habilitada] Si no se proporciona ningún ParentSku, se creará un nuevo producto basado en el SellerSKU. Si se proporciona ParentSku y es diferente de un ParentSku existente, se creará un nuevo producto.

También puede utilizar el ParentSku de un producto que se genera con la misma solicitud de API, consulte el ejemplo a continuación.

<?xml version="1.0" encoding="UTF-8"?>
<Request>
	<Product>
		<SellerSku>TEST-SKU-1066859</SellerSku>
		<Name>PRODUCT TEST - TEST - TEST</Name>
		<Variation>XXL</Variation>
		<Status>active</Status>
		<PrimaryCategory>13825</PrimaryCategory>
		<Categories>2,3,5</Categories>
		<Description>UA H Tank - Twist Camiseta Manga Sisa morado de mujer para entrenamiento</Description>
		<Brand>Under Armour</Brand>
		<Price>139950</Price>
		<ProductId>8803324</ProductId>
		<TaxClass>IVA 19%</TaxClass>
		<Quantity>10</Quantity>
		<ProductData>
			<ShortDescription>TEST TEST TEST TEST</ShortDescription>
			<ConditionType>Nuevo</ConditionType>
			<PackageHeight>1</PackageHeight>
			<PackageWidth>1</PackageWidth>
			<PackageLength>1</PackageLength>
			<PackageWeight>2</PackageWeight>
			<ProductWeight>2</ProductWeight>
			<ProductMeasures>1 x 1 x 1</ProductMeasures>
		</ProductData>
	</Product>
	<Product>
		<SellerSku>TEST-SKU-678799999</SellerSku>
		<Name>PRODUCT TEST - TEST - TEST</Name>
		<ParentSku>TEST-SKU-1066859</ParentSku>
		<Variation>M</Variation>
		<Status>active</Status>
		<PrimaryCategory>13825</PrimaryCategory>
		<Categories>2,3,5</Categories>
		<Description>UA H Tank - Twist Camiseta Manga Sisa ROJA de mujer</Description>
		<Brand>Under Armour</Brand>
		<Price>139950</Price>
		<ProductId>8803324</ProductId>
		<TaxClass>IVA 19%</TaxClass>
		<Quantity>10</Quantity>
		<ProductData>
			<ShortDescription>TEST TEST TEST TEST</ShortDescription>
			<ConditionType>Nuevo</ConditionType>
			<PackageHeight>1</PackageHeight>
			<PackageWidth>1</PackageWidth>
			<PackageLength>1</PackageLength>
			<PackageWeight>2</PackageWeight>
			<ProductWeight>2</ProductWeight>
			<ProductMeasures>1 x 1 x 1</ProductMeasures>
		</ProductData>
	</Product>
</Request>