API ReferenceSDK & PluginsFAQsContact Us
API Reference

Actualizar Productos

post
https://sellercenter-api.falabella.com/?Action=ProductUpdate

ProductUpdate. Permite la actualización de uno o más productos utilizando como llave el campo SellerSku.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

La respuesta del API es asincrónica y genera la creación de un Feed; recuerda siempre ver el detalle de un feed (consulta aquí) para revisar si el producto fue creado correctamente o bien tiene observaciones en el rechazo.

El cuerpo del request es un XML; aquellos campos que sean enviados con valor vacío no serán procesados y serán ignorados. Es posible actualizar uno o más productos.

❗️

Estructura mínima

Para realizar una actualización de producto, la estructura mínima del request debe incluir:

  • SellerSku
  • OperatorCode correspondiente al país (facl para Chile, fape para Perú, faco para Colombia), declarado dentro de BusinessUnit o BusinessUnits, según el formato utilizado.
  • Al menos un atributo que desees modificar.

Ten en cuenta que solo se actualizarán los campos incluidos en la solicitud. Los atributos que no se envíen permanecerán sin cambios.

Datos de la solicitud


⚠️

Tamaño de lote recomendado

Para un uso eficiente de los feeds, agrupa tus productos en lotes. Se recomienda enviar entre 500 y 1.000 productos por solicitud, dependiendo del tamaño y complejidad de los datos incluidos.

A continuación, te presentamos ejemplos de request de actualizaciones comunes que podrías realizar

<?xml version="1.0" encoding="UTF-8" ?>
<Request>
    <Product>
  
        <SellerSku>Test1</SellerSku>
        <ProductData />
        <BusinessUnits>
            <BusinessUnit>
              <OperatorCode>facl</OperatorCode>
              <Stock>40</Stock>
            </BusinessUnit>
        </BusinessUnits>
  </Product>
  <Product>
  
        <SellerSku>Test2</SellerSku>
        <ProductData />
        <BusinessUnits>
            <BusinessUnit>
              <OperatorCode>facl</OperatorCode>
              <Stock>20</Stock>
            </BusinessUnit>
        </BusinessUnits>
  </Product>
  <Product>
  
        <SellerSku>Test3</SellerSku>
        <ProductData />
        <BusinessUnits>
            <BusinessUnit>
              <OperatorCode>facl</OperatorCode>
              <Stock>132</Stock>
            </BusinessUnit>
        </BusinessUnits>
    </Product>

</Request>
<?xml version="1.0" encoding="UTF-8" ?>
<Request>
    <Product>
  
        <SellerSku>Test1</SellerSku>
        <BusinessUnits>
            <BusinessUnit>
              <OperatorCode>facl</OperatorCode>
               <Price>59990</Price>
               <SpecialPrice>35990</SpecialPrice>
               <SpecialFromDate>2023-05-26 00:00:00</SpecialFromDate>
               <SpecialToDate>2023-10-31 23:59:59</SpecialToDate>
            </BusinessUnit>
        </BusinessUnits>
  </Product>
  <Product>
        <SellerSku>Test2</SellerSku>
        <BusinessUnits>
            <BusinessUnit>
              <OperatorCode>facl</OperatorCode>
               <Price>59990</Price>
               <SpecialPrice>35990</SpecialPrice>
               <SpecialFromDate>2023-05-26 00:00:00</SpecialFromDate>
               <SpecialToDate>2023-10-31 23:59:59</SpecialToDate>       
            </BusinessUnit>
        </BusinessUnits>
  </Product>
</Request>

<?xml version="1.0" encoding="UTF-8" ?>
<Request>
	<Product>
		<SellerSku>SKU-TEST-12345</SellerSku>
		<Description>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</Description>
		<BusinessUnits>
			<BusinessUnit>
				<OperatorCode>facl</OperatorCode>
				<Stock>50</Stock>
				<Status>active</Status>
			</BusinessUnit>
		</BusinessUnits>
	</Product>
	<Product>
		<SellerSku>SKU-TEST-999999</SellerSku>
		<Name>PRODUCT TEST - TEST - TEST</Name>
		<Description>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</Description>
		<Color>Verde</Color>
		<ColorBasico>Rojo</ColorBasico>
		<BusinessUnits>
			<BusinessUnit>
				<OperatorCode>facl</OperatorCode>
				<Price>59990</Price>
				<SpecialPrice>35990</SpecialPrice>
				<SpecialFromDate>2023-05-26 00:00:00</SpecialFromDate>
				<SpecialToDate>2023-10-31 23:59:59</SpecialToDate>
				<Stock>40</Stock>
				<Status>inactive</Status>
			</BusinessUnit>
		</BusinessUnits>
		<ProductData>
			<ConditionType>Nuevo</ConditionType>
			<PackageHeight>11</PackageHeight>
			<PackageWidth>11</PackageWidth>
			<PackageLength>11</PackageLength>
			<PackageWeight>4</PackageWeight>
		</ProductData>
	</Product>

Algunos ejemplos de atributos que podrías modificar:


CampoTipoDescripciónObligatorioSección
SellerSkuStringIdentificador único del producto dentro del sistema.SíProduct
NameStringNombre del producto mostrado al cliente.SíProduct
DescriptionStringDescripción HTML del producto. Entre 6 y 25.000 caracteres.SíProduct
BrandStringMarca del producto.SíProduct
ProductIdNumberfieldCódigo armonizado (EAN, UPC, ISBN).NoProduct
PriceDecimalPrecio del producto.SíBusinessUnits.BusinessUnit
SpecialPriceDecimalPrecio con descuento. Obligatorio si se proporcionan fechas de oferta.NoBusinessUnits.BusinessUnit
SpecialFromDateDateTimeFecha de inicio de la oferta. Formato: YYYY-MM-DD HH:MM:SS. Obligatorio si se envía SpecialPrice.Condicional, solo si se envía SpecialPriceBusinessUnits.BusinessUnit
SpecialToDateDateTimeFecha de fin de la oferta. Formato: YYYY-MM-DD HH:MM:SS. Obligatorio si se envía SpecialPrice.Condicional, solo si se envía SpecialPriceBusinessUnits.BusinessUnit
StockIntegerCantidad de stock disponible.SíBusinessUnits.BusinessUnit
StatusStringEstado del producto por operador: active o inactive.SíBusinessUnits.BusinessUnit
ConditionTypeStringCondición del producto; valor depende de la categoría, por ejemplo, New.SíProductData
PackageHeightIntegerAltura del paquete (en cm).SíProductData
PackageWidthIntegerAncho del paquete (en cm).SíProductData
PackageLengthIntegerLargo del paquete (en cm).SíProductData
PackageWeightDecimalPeso del paquete (en kg).SíProductData
TaxPercentageStringPorcentaje de impuesto del producto.Condicional (Obligatorio solo en Colombia)ProductData

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 ProductUpdate, 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 enviar 100 actualizaciones de productos, sólo 90 de ellas se actualicen realmente.

Errores

Código de errorMensaje
1000Could not save product: %s (No se pudo guardar el producto)
1000Format Error Detected (Error de formato detectado)
8888Feed rows exceeded, max size allowed is %d and you uploaded %d items. Please next time try to upload less items (Se superó el tamaño máximo de filas de Feeds. Tratar de subir menos elementos la próxima vez)

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>
Body Params
string
Defaults to ProductUpdate

Nombre de la función que se va a llamar. Obligatorio y debe ser 'ProductUpdate' en este caso. Si se omite, se devuelve un error 'E001: Parameter Action is mandatory' (El parámetro Action es obligatorio). Si se proporciona una cadena de función desconocida, se devuelve un mensaje de error 'E008: Invalid Action' (Acción no válida).

string
Defaults to XML

Si se proporciona, debe ser 'JSON' o 'XML'. Si no se proporciona, se asume 'XML'.

date

La hora actual en formato ISO8601 relativa a UTC (p. Ej., Marca de tiempo = 2015-04-01T10: 00: 00 + 02: 00 para Berlín), de modo que las llamadas no puedan ser reproducidas por un tercero que espíe (es decir, aquellas llamadas demasiado lejos en el pasado o en el futuro producen un mensaje de error). Obligatorio. Si no se proporciona, aparece el mensaje de error 'E001: La marca de tiempo del parámetro es obligatoria'. Si la marca de tiempo es demasiado antigua o está en el futuro, se devuelve un mensaje de error "E003: Timestamp has expired" (Timestamp expiró).

string

El ID del usuario que realiza la llamada. La lista de usuarios autorizados se mantiene en la interfaz web del Centro de vendedores en Configuración general / Administrar usuarios.

string

La versión de API contra la que se ejecutará esta llamada, en formato mayor-punto-menor. Actualmente debe ser 1.0, aunque la versión real de la API es 2.6.20. Si se omite, se devuelve un mensaje de error "E001: Parameter Version is mandatory" (El parámetro Version es obligatorio).

string

La firma criptográfica que autentica la solicitud. Una persona que llama debe crear este valor calculando el hash SHA256 de la solicitud, utilizando la clave API del usuario especificado en el parámetro UserID. Obligatorio. Si se omite, se devuelve un mensaje de error "E001: Parameter Signature is mandatory" (El parámetro Signature es obligatorio). Si la firma es incorrecta, un 'E007: Login failed' (Error de inicio de sesión). Se devuelve el mensaje de error de discrepancia de firma.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Response

Updated 7 months ago

Language
LoadingLoading…
Response
Choose an example:
application/xml
application/json

Updated 7 months ago