ReferenciaProductosCreación de Productos

POST

Creación de Productos

Endpoint

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

Permite la creación de uno o varios productos, esta API es asincrónica y genera la creación de un Feed.

Advertencia

Siempre revisa los detalles del feed para confirmar si el producto fue creado correctamente o si presenta advertencias o rechazos.

Importante para el modelo internacional

Para los sellers que operan bajo el modelo internacional, es obligatorio incluir el nombre en el idioma local (NameEn = EE.UU., NameCN = China) al crear productos, además del nombre de publicación (Name), debido a los requisitos aduaneros para la importación de productos.

Cada categoría incluye un conjunto específico de atributos obligatorios y opcionales relacionados con su tipo. Sin embargo, existe un conjunto base de atributos comunes a todas las categorías en Falabella, que se detalla a continuación:

Campo	Tipo	Descripción	Obligatorio	Sección
SellerSku	String	Identificador único del producto dentro del sistema.	Sí	Product
ParentSKU	String	Es el SKU de uno de los productos del grupo a crear que se considerará como padre de la variación.	Condicional, solo si existen variaciones.	Product
Name	String	Nombre del producto mostrado al cliente.	Sí	Product
PrimaryCategory	Integer	ID de la categoría principal. Se obtiene del endpoint GetCategoryTree, donde se llama CategoryId.	Sí	Product
Description	String	Descripción HTML del producto. Entre 6 y 25.000 caracteres.	Sí	Product
Brand	String	Marca del producto.	Sí	Product
ProductId	Numberfield	Código armonizado (EAN, UPC, ISBN).	No	Product
BusinessUnits	Subsection	Sección que contiene stock, precios y operador asociado.	Sí	Product
OperatorCode	String	Código del operador. Ejemplo: facl, fape, faco.	Sí	BusinessUnits.BusinessUnit
Price	Decimal	Precio del producto.	Sí	BusinessUnits.BusinessUnit
SpecialPrice	Decimal	Precio con descuento. Obligatorio si se proporcionan fechas de oferta.	No	BusinessUnits.BusinessUnit
SpecialFromDate	DateTime	Fecha de inicio de la oferta. Formato: `YYYY-MM-DD HH:MM:SS`. Obligatorio si se envía SpecialPrice.	Condicional, solo si se envía SpecialPrice	BusinessUnits.BusinessUnit
SpecialToDate	DateTime	Fecha de fin de la oferta. Formato: `YYYY-MM-DD HH:MM:SS`. Obligatorio si se envía SpecialPrice.	Condicional, solo si se envía SpecialPrice	BusinessUnits.BusinessUnit
Stock	Integer	Cantidad de stock disponible.	Sí	BusinessUnits.BusinessUnit
Status	String	Estado del producto por operador: `active` o `inactive`.	Sí	BusinessUnits.BusinessUnit
ProductData	Subsection	Contiene atributos extendidos del producto definidos por categoría.	Sí	Product
ConditionType	String	Condición del producto; valor depende de la categoría, por ejemplo, `New`.	Sí	ProductData
PackageHeight	Integer	Altura del paquete (en cm).	Sí	ProductData
PackageWidth	Integer	Ancho del paquete (en cm).	Sí	ProductData
PackageLength	Integer	Largo del paquete (en cm).	Sí	ProductData
PackageWeight	Decimal	Peso del paquete (en kg).	Sí	ProductData
TaxPercentage	String	Porcentaje de impuesto del producto.	Condicional (Obligatorio solo en Colombia)	ProductData

Recuerda que puedes consultar los atributos asociados a una categoría usando el endpoint GetCategoryAttributes y adicionalmente verificar qué atributos contribuyen al puntaje mediante el endpoint GetContentScore .

Para conocer el resultado final del proceso:

●Utiliza el `RequestId` devuelto para consultar el estado mediante la API FeedStatus.
●También puedes configurar un webhook que te notifique automáticamente cuando finalice el procesamiento del feed.

Para más detalles sobre el flujo completo, revisa la documentación del endpoint FeedStatus.

¿Qué es una categoría con múltiples variaciones?

Una de las consideraciones más importantes al momento de crear productos es identificar si la categoría permite multivariaciones. Las categorías con soporte para multivariación permiten agrupar productos similares (por ejemplo, por talla o color) en una única publicación dentro de Falabella.com, como se muestra en la siguiente imagen:

Existen categorías, como vestuario, calzado o accesorios, que permiten crear productos con múltiples variaciones (por ejemplo, color y talla). Estas variaciones deben estructurarse correctamente a nivel de producto para que se publiquen correctamente.

¿Cómo saber si una categoría admite múltiples variaciones?

Debes consultar la API `GetCategoryAttributes`.

●Si la respuesta incluye un atributo con `FeedName = "Variation"`, entonces la categoría no admite múltiples variaciones.
●Si ese atributo no aparece, la categoría sí admite múltiples variaciones.

¿Cómo identificar los atributos que generan variaciones?

Una vez confirmado que la categoría admite múltiples variaciones, los atributos que las generan deben cumplir ambas condiciones:

●`IsGlobalAttribute = 0`
●`GroupName = "Variation"`

Todos estos atributos deben declararse a nivel de `Product`, no dentro de `ProductData`.

Ejemplo de atributo que genera variación en GetCategoryAttributes:

<Attribute>
  <Label>Color básico variant</Label>
  <Name>color_basico_variant</Name>
  <FeedName>ColorBasicoVariant</FeedName>
  <GlobalIdentifier>ATT000003974</GlobalIdentifier>
  <GroupName>Variation</GroupName>
  <isMandatory>1</isMandatory>
  <IsGlobalAttribute>0</IsGlobalAttribute>
  <Description>Basic color of the variant</Description>
  <ProductType>simple</ProductType>
  <InputType>dropdown</InputType>
  <AttributeType>option</AttributeType>
  <ExampleValue></ExampleValue>
  <MaxLength></MaxLength>
</Attribute>

¿Cómo estructurar múltiples variaciones?

Todas las variaciones deben vincularse a un mismo `ParentSku`, que corresponde al `SellerSku` del producto considerado como padre.

Debes especificar el`ParentSku` al crear cada variación. Al crear un grupo de productos, deberás elegir cuál de los SKUs será el producto padre. Todos los productos del grupo deberán compartir el mismo ParentSKU

Ejemplo XML de creación 2 SKU con variación.

<?xml version="1.0" encoding="UTF-8"?>
<Request>
  <Product>
    <SellerSku>SKU1</SellerSku>
    <ParentSku>SKU1</ParentSku>
    <Name>PRODUCT TEST - TEST - TEST</Name>
    <PrimaryCategory>811</PrimaryCategory>
    <Description>Lorem ipsum dolor sit amet, consectetur adipiscing elit...</Description>
    <Brand>EPATE</Brand>
    <ProductId>430450</ProductId>
    <Color>Blanco</Color>
    <ColorBasico>Blanco</ColorBasico>
    <Talla>39</Talla>
    <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>36</Stock>
        <Status>active</Status>
      </BusinessUnit>
    </BusinessUnits>
    <ProductData>
      <ConditionType>Nuevo</ConditionType>
      <PackageHeight>10</PackageHeight>
      <PackageWidth>10</PackageWidth>
      <PackageLength>10</PackageLength>
      <PackageWeight>1</PackageWeight>
      <DisciplinaZapatillas>Tenis</DisciplinaZapatillas>
      <Genero>Mujer</Genero>
    </ProductData>
  </Product>

  <Product>
    <SellerSku>SKU2</SellerSku>
    <ParentSku>SKU1</ParentSku>
    <Name>PRODUCT TEST - TEST - TEST</Name>
    <PrimaryCategory>811</PrimaryCategory>
    <Description>Lorem ipsum dolor sit amet, consectetur adipiscing elit...</Description>
    <Brand>EPATE</Brand>
    <ProductId>888888</ProductId>
    <Color>Blanco</Color>
    <ColorBasico>Blanco</ColorBasico>
    <Talla>39</Talla>
    <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>36</Stock>
        <Status>active</Status>
      </BusinessUnit>
    </BusinessUnits>
    <ProductData>
      <ConditionType>Nuevo</ConditionType>
      <PackageHeight>10</PackageHeight>
      <PackageWidth>10</PackageWidth>
      <PackageLength>10</PackageLength>
      <PackageWeight>1</PackageWeight>
      <DisciplinaZapatillas>Tenis</DisciplinaZapatillas>
      <Genero>Mujer</Genero>
    </ProductData>
  </Product>
</Request>

Ejemplo de diferentes llamados

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.

ℹ️ Nota:

Estos ejemplos son solo referenciales. Siempre se deben considerar los campos obligatorios y opcionales según el endpoint GetCategoryAttributes.\ Para más detalles, consulta la documentación: GetCategoryAttributes.

<?xml version="1.0" encoding="UTF-8" ?>
<Request>
    <Product>
        <SellerSku>SKU-TEST-12345</SellerSku>
        <ParentSku>SKU-TEST-12345</ParentSku>
                <Name>PRODUCT TEST - TEST - TEST</Name>
                <PrimaryCategory>811</PrimaryCategory>
                <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>
                <Brand>EPATE</Brand>
                <ProductId>4066749430450</ProductId>
                <Color>Blanco</Color>
                <ColorBasico>Blanco</ColorBasico>
                <Talla>39</Talla>
                <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>36</Stock>
                        <Status>active</Status>
                    </BusinessUnit>
                </BusinessUnits>
                <ProductData>
                    <ConditionType>Nuevo</ConditionType>
                    <PackageHeight>10</PackageHeight>
                    <PackageWidth>10</PackageWidth>
                    <PackageLength>10</PackageLength>
                    <PackageWeight>1</PackageWeight>
                    <DisciplinaZapatillas>Tenis</DisciplinaZapatillas>
                    <Genero>Mujer</Genero>
                </ProductData>
            </Product>
        </Request>

<Request>
    <Product>
        <SellerSku>9087978897</SellerSku>
        <Name>Test 1</Name>
        <Variation>...</Variation>
        <ParentSku />
        <ProductId>9087978897</ProductId>
        <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>
        <Brand>2K GAMES</Brand>
        <PrimaryCategory>2723</PrimaryCategory>
        <BusinessUnits>
            <BusinessUnit>
                <OperatorCode>facl</OperatorCode>
                <Price>1600.00</Price>
                <SpecialPrice>1200.00</SpecialPrice>
                <SpecialFromDate>2025-06-20 00:00:00</SpecialFromDate>
                <SpecialToDate>2025-06-30 00:00:00</SpecialToDate>
                <Stock>50</Stock>
                <Status>active</Status>
            </BusinessUnit>
        </BusinessUnits>
        <ProductData>
            <PackageWidth>12</PackageWidth>
            <PackageLength>12</PackageLength>
            <PackageHeight>12</PackageHeight>
            <ConditionType>Nuevo</ConditionType>
            <PackageWeight>1</PackageWeight>

        </ProductData>
    </Product>
</Request>

<?xml version="1.0" encoding="UTF-8" ?>
<Request>
    <Product>
        <SellerSku>SKU-TEST-123456</SellerSku>
        <ParentSku>SKU-TEST-123456</ParentSku>
                <Name>PRODUCT TEST - TEST - TEST</Name>
                <PrimaryCategory>811</PrimaryCategory>
                <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>
                <Brand>EPATE</Brand>
                <Variation>US 7</Variation>
                <Color>Blanco</Color>
                <ColorBasico>Blanco</ColorBasico>
                <Talla>39</Talla>
                <BusinessUnits>
                    <BusinessUnit>
                        <OperatorCode>facl</OperatorCode>
                        <Price>59990</Price>
                        <SpecialPrice>35990</SpecialPrice>
                        <SpecialFromDate>2025-05-26 00:00:00</SpecialFromDate>
                        <SpecialToDate>2025-10-31 23:59:59</SpecialToDate>
                        <Stock>36</Stock>
                        <Status>active</Status>
                    </BusinessUnit>
                </BusinessUnits>
                <ProductData>
                    <ConditionType>Nuevo</ConditionType>
                    <PackageHeight>10</PackageHeight>
                    <PackageWidth>10</PackageWidth>
                    <PackageLength>10</PackageLength>
                    <PackageWeight>1</PackageWeight>
                    <DisciplinaZapatillas>Tenis</DisciplinaZapatillas>
                    <Genero>Mujer</Genero>
                </ProductData>
            </Product>
            <Product>
                <SellerSku>SKU-TEST-78905</SellerSku>
                <ParentSku>SKU-TEST-123456</ParentSku>
                        <Name>PRODUCT TEST - TEST - TEST</Name>
                        <PrimaryCategory>811</PrimaryCategory>
                        <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>
                        <Brand>EPATE</Brand>
                        <Variation>US 7</Variation>
                        <Color>Azul</Color>
                        <ColorBasico>Rojo</ColorBasico>
                        <Talla>38</Talla>
                        <BusinessUnits>
                            <BusinessUnit>
                                <OperatorCode>facl</OperatorCode>
                                <Price>59990</Price>
                                <SpecialPrice>35990</SpecialPrice>
                                <SpecialFromDate>2025-05-26 00:00:00</SpecialFromDate>
                                <SpecialToDate>2025-10-31 23:59:59</SpecialToDate>
                                <Stock>36</Stock>
                                <Status>active</Status>
                            </BusinessUnit>
                        </BusinessUnits>
                        <ProductData>
                            <ConditionType>Nuevo</ConditionType>
                            <PackageHeight>10</PackageHeight>
                            <PackageWidth>10</PackageWidth>
                            <PackageLength>10</PackageLength>
                            <PackageWeight>1</PackageWeight>
                            <DisciplinaZapatillas>Tenis</DisciplinaZapatillas>
                            <Genero>Mujer</Genero>
                        </ProductData>
                    </Product>
                </Request>

<?xml version="1.0" encoding="UTF-8" ?>
<Request>
   <Product>
        <SellerSku>9087978897</SellerSku>
        <Name>Test 1</Name>
        <Variation>...</Variation>
        <ParentSku />
        <ProductId>9087978897</ProductId>
        <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>
        <Brand>2K GAMES</Brand>
        <PrimaryCategory>2723</PrimaryCategory>
        <BusinessUnits>
            <BusinessUnit>
                <OperatorCode>facl</OperatorCode>
                <Price>1600.00</Price>
                <SpecialPrice>1200.00</SpecialPrice>
                <SpecialFromDate>2025-06-20 00:00:00</SpecialFromDate>
                <SpecialToDate>2025-06-30 00:00:00</SpecialToDate>
                <Stock>50</Stock>
                <Status>active</Status>
            </BusinessUnit>
        </BusinessUnits>
        <ProductData>
            <PackageWidth>12</PackageWidth>
            <PackageLength>12</PackageLength>
            <PackageHeight>12</PackageHeight>
            <ConditionType>Nuevo</ConditionType>
            <PackageWeight>1</PackageWeight>

        </ProductData>
    </Product>
       <Product>
        <SellerSku>9087978898</SellerSku>
        <Name>Test 1</Name>
        <Variation>...</Variation>
        <ParentSku />
        <ProductId>9087978898</ProductId>
        <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>
        <Brand>2K GAMES</Brand>
        <PrimaryCategory>2723</PrimaryCategory>
        <BusinessUnits>
            <BusinessUnit>
                <OperatorCode>facl</OperatorCode>
                <Price>1600.00</Price>
                <SpecialPrice>1200.00</SpecialPrice>
                <SpecialFromDate>2025-06-20 00:00:00</SpecialFromDate>
                <SpecialToDate>2025-06-30 00:00:00</SpecialToDate>
                <Stock>50</Stock>
                <Status>active</Status>
            </BusinessUnit>
        </BusinessUnits>
        <ProductData>
            <PackageWidth>12</PackageWidth>
            <PackageLength>12</PackageLength>
            <PackageHeight>12</PackageHeight>
            <ConditionType>Nuevo</ConditionType>
            <PackageWeight>1</PackageWeight>

        </ProductData>
    </Product>
</Request>

É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>

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>

Headers

accept

string

Opcional

Generado a partir de los tipos de contenido de respuesta disponibles. Valores permitidos: application/xml, application/json. application/json

content-type

string

Opcional

Generado a partir de los tipos de contenido de solicitud disponibles. Valores permitidos: application/x-www-form-urlencoded, application/json. application/json

Body Params

Action

string

Requerido

Nombre de la función que se va a llamar. Obligatorio y debe ser 'ProductCreate' 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). ProductCreate

Format

string

Opcional

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

Timestamp

date

Requerido

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ó).

UserID

string

Requerido

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.

Version

string

Requerido

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).

Datos de la Solicitud

El cuerpo de la solicitud debe enviarse en formato XML. Los campos con valores vacíos serán ignorados y no se procesarán.\ Para optimizar el uso del feed, se recomienda agrupar los productos en lotes. El tamaño sugerido comienza en 500 productos por solicitud y puede ajustarse según la complejidad de los datos y los tiempos de respuesta esperados por el seller, hasta un máximo de 1.000 productos por lote.

Datos de la respuesta

Recuerda que esta API funciona de forma asíncrona. Aunque recibas una respuesta 200 OK, esto solo indica que la solicitud fue aceptada, no que los productos fueron creados con éxito.

Respuesta 200

<?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)