ReferenciaProductosActualizar Stock

POST

Actualizar Stock

Endpoint

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

UpdateStock. Actualiza el stock de tus productos en tu bodega principal o en todas las bodegas que tengas configuradas.

Puedes enviar stock de un producto directamente a una bodega específica o asignarlo a tu bodega por defecto. No es posible usar esta API para agregar stock a bodegas de Fulfillment by Falabella.

¿Cómo obtener el SellerWarehouseId o FacilityId?

Para poder obtener el SellerWarehouseId o el FacilityId de tus bodegas recuerda que puedes utilizar el método GetWarehouse.

Si solo cuentas con una bodega, no debes enviar el SellerWarehouseId ni el FacilityId en la solicitud.

Datos de la solicitud

<?xml version="1.0" encoding="UTF-8" ?>  
<Request>
    <Warehouse>
        <Stock>
            <GSCFacilityId>477584939</GSCFacilityId>
            <SellerSku>abc02</SellerSku>
            <Quantity>234</Quantity>
        </Stock>
        <Stock>
            <GSCFacilityId>4775849395</GSCFacilityId>
            <SellerSku>abc02</SellerSku>
            <Quantity>230</Quantity>
        </Stock>
    </Warehouse>
</Request>

<?xml version="1.0" encoding="UTF-8" ?>  
<Request>
    <Warehouse>
        <Stock>
            <SellerWarehouseId>477584939</SellerWarehouseId>
            <SellerSku>abc02</SellerSku>
            <Quantity>234</Quantity>
        </Stock>
        <Stock>
            <SellerWarehouseId>4775849395</SellerWarehouseId>
            <SellerSku>abc02</SellerSku>
            <Quantity>230</Quantity>
        </Stock>
    </Warehouse>
</Request>

<?xml version="1.0" encoding="UTF-8" ?>  
<Request>
    <Warehouse>
        <Stock>
            <SellerSku>abc02</SellerSku>
            <Quantity>234</Quantity>
        </Stock>
        <Stock>
            <SellerSku>abc03</SellerSku>
            <Quantity>230</Quantity>
        </Stock>
    </Warehouse>
</Request>

Parámetros

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

Format

string

Requerido

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

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: XML. XML

Body Params

SellerSKU

string

Requerido

Código utilizado por el Seller para identificar un producto.

Quantity

integer

Requerido

Unidades de stock asignados a la bodega (facility)

GSCFacilityId

string

Opcional

ID único de bodega asignado por Falabella. (Opcional)

SellerWarehouseId

string

Opcional

ID único de bodega asignado por el Seller. (Opcional)

Respuesta 200

<?xml version="1.0" encoding="UTF-8"?>
<SuccessResponse>
    <Head>
        <RequestId/>
        <RequestAction>
            UpdateStock
        </RequestAction>
        <ResponseType/>
        <Timestamp>
            2025-08-08T08:23:57-0400
        </Timestamp>
    </Head>
    <Body>
        <Stocks>
            <feed>
                0c0ff17b-281f-4781-8d0a-954e57e22b18
            </feed>
        </Stocks>
    </Body>
</SuccessResponse>

Importante

En caso de no incluir GSCFacilityID o SellerWarehouseId, se tomará por defecto la bodega principal. Vendedores que poseen solamente una bodega no es necesario que lo incluyan. Recuerda que solo debes incluir FacilityID o SellerWarehouseId, el uso de ambos en un mismo requerimiento, generará error. Se recomienda procesar lotes de hasta 500 registros por actualización, con un máximo permitido de 1.000 registros. A diferencia de otros endpoints POST para productos, el identificador `RequestId` utilizado para el seguimiento de la actualización se encuentra dentro del campo `<feed>`.

Errores comunes y su mitigación

Código de error	Mensaje de error	Mitigación
1000	00: Internal application error	Corregir estructura del payload.
1000	02:Format Error Detected: The limit of SellerSkus is 500	Crear o actualizar igual o menos de 500 SKU
1000	03:Format Error Detected: Facility in Stock	Generar ticket a soporte
1000	04:Format Error Detected: SellerSku in Node	Consultar por SKU que este asociado a las bodegas o validar que se está escribiendo correctamente el SKU
1000	05:Format Error Detected: Quantity in Node	Agregar valor de stock en request