API ReferenceSDK & PluginsFAQsContact Us
API Reference
Start typing to search…

Creación de Productos

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

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.

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:

CampoTipoDescripciónObligatorioSección
SellerSkuStringIdentificador único del producto dentro del sistema.SíProduct
ParentSKUStringEs 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
NameStringNombre del producto mostrado al cliente.SíProduct
PrimaryCategoryIntegerID de la categoría principal. Se obtiene del endpoint GetCategoryTree, donde se llama CategoryId.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
BusinessUnitsSubsectionSección que contiene stock, precios y operador asociado.SíProduct
OperatorCodeStringCódigo del operador. Ejemplo: facl, fape, faco.SíBusinessUnits.BusinessUnit
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
ProductDataSubsectionContiene atributos extendidos del producto definidos por categoría.SíProduct
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

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 .

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.

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

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 errorMensaje
1000Could not save product: %s (No se pudo guardar el producto)
1000Format 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>
Language