Falabella Seller Center

Falabella Seller Center

This connector calls the Falabella Seller Center API (sellercenter-api.falabella.com) for one seller on falabella.com in Chile, Colombia or Peru: products, stock, brands, categories and their attributes, warehouses, feeds, orders with their items and shipping labels, and writing products, prices, stock and images. There is no sandbox: every call, writes included, acts on the live store.

What you need: a seller account on Falabella Seller Center, a Seller Center user with an API role, that user's API key and your Seller ID. About 5 minutes.

Setup

1. Sign in at https://sellercenter.falabella.com with the user the connector should act as (an administrator can add a dedicated one under Mi cuenta → Usuarios → Agregar Usuario).
2. Open Mi cuenta → Usuarios. The user's e-mail address goes into FALABELLA_USER_ID; the value in that row's API Key column into FALABELLA_API_KEY.
3. Give the user an API role: Seller API Access (every method), Seller API Product Access (products, brands, categories, images and feeds) or Seller API Order Access (orders). A method outside the role answers E009: Access Denied.
4. Copy your Seller ID, shown under Mi cuenta, into FALABELLA_SELLER_ID.
5. Set FALABELLA_BUSINESS_UNIT to your country: FACL Chile, FACO Colombia, FAPE Peru. A connector serves one country; add a second connector for another.

How it signs: every call goes to / with Action=<method>, UserID, Version=1.0, Format=JSON, an ISO 8601 UTC Timestamp and Signature, the HMAC-SHA256 (hex) of all query parameters sorted by name and URL-encoded, keyed with the API key. The key itself is never sent, and a request whose timestamp is too far off is refused (E003). Each call carries the User-Agent Falabella asks integrations for: <Seller ID>/AnythingMCP/1.0/ANYTHINGMCP/<business unit>.

Business unit and OperatorCode: the business unit is upper case (FACL); inside product XML the same country is the OperatorCode in lower case: facl, faco, fape. Use your connector's country in every BusinessUnit.

Writes are feeds: creating, updating, pricing, stocking, imaging and removing products is asynchronous. A successful answer only means the request was accepted; SuccessResponse.Head.RequestId (for UpdateStock Body.Stocks.feed) is the feed id. Call falabella_seller_center_feed_status until Status is Finished, Error or Canceled, then read FailedRecords and FeedErrors: a feed can finish with some records rejected. Falabella allows 50 feed calls freely, then one every 2 minutes per seller (429 otherwise), so put several products into one request (up to 1,000, about 500 suggested) instead of one call per SKU.

Where to start

• Catalog: falabella_seller_center_get_products (status filter, search, SKU list, dates, limit and offset), falabella_seller_center_get_stock (stock per warehouse, Fulfillment by Falabella included), falabella_seller_center_get_warehouses.
• New products: falabella_seller_center_get_category_suggestion from a title or falabella_seller_center_get_category_tree (leaf categories only), falabella_seller_center_get_category_attributes for the attributes and which are mandatory, falabella_seller_center_get_brands for the exact brand name, then falabella_seller_center_create_products, falabella_seller_center_set_images and falabella_seller_center_feed_status.
• Changes: falabella_seller_center_update_price and falabella_seller_center_update_stock for one SKU, falabella_seller_center_update_stock_xml for several SKUs or a specific warehouse, falabella_seller_center_update_products for any field of several products.
• Feeds: falabella_seller_center_feed_list, falabella_seller_center_feed_offset_list (filtered, paged), falabella_seller_center_feed_count, falabella_seller_center_feed_status.
• Orders: falabella_seller_center_get_orders, falabella_seller_center_get_order, falabella_seller_center_get_order_items (the OrderItemId and PackageId that labels and status changes need), falabella_seller_center_get_multiple_order_items, falabella_seller_center_get_document (shipping label in base64).
• Switched off at install: falabella_seller_center_remove_products, falabella_seller_center_set_status_ready_to_ship and falabella_seller_center_set_status_canceled. Turn them on in the connector's tools when the AI should use them, and confirm each call.

Formats: date filters are ISO 8601 (2026-11-01T00:00:00+00:00); offer dates in XML are YYYY-MM-DD HH:MM:SS; prices use a dot as decimal separator. Id lists go in brackets: [123456,123457]. In XML escape &, < and >, and wrap an HTML description in <![CDATA[...]]>. Elements sent empty are ignored, so an update only changes what it contains.

Answers and errors: data sits under SuccessResponse.Body. Refusals arrive with HTTP 200 as ErrorResponse.Head (ErrorCode, ErrorMessage) and are reported as failed calls: E007 (signature mismatch: API key and user do not match) and E003/E004 (timestamp) as authentication errors, E009 (access denied: the user's role) as a permission error, E429 as rate limiting, everything else (E001 missing parameter, 1000 format errors with an ErrorDetail per field) as a bad request.