### Get Webhooks cURL Example Source: https://developers.falabella.com/v500.0.0/reference/getwebhooks This cURL example demonstrates how to fetch webhook information. Remember to update the Timestamp and recompute the Signature for your specific request. ```curl # GetWebhooks cURL example # to run, update Timestamp and recompute Signature # url = "https://sellercenter-api.falabella.com/" get data-urlencode Action=GetWebhooks data-urlencode Timestamp=2015-07-01T11:11+0000 data-urlencode UserID=maintenance@sellercenter.net data-urlencode Version=1.0 data-urlencode Signature=d4ff93cccb165295ed8357fe42082208b781a3b576bbb7d3fe7a624270b047b9 data-urlencode WebhookIds=[7dffaa4e-1713-42c2-84ba-1d2fbd4537ab,fbfe60be-b282-4bc1-9e4d-2147c686d1a8] ``` -------------------------------- ### Request Example for Setting Invoice PDF Source: https://developers.falabella.com/v500.0.0/reference/setinvoicepdf An example request demonstrating how to set invoice details, including the document format and the Base64 encoded PDF content. ```json { "orderItemIds": [ "8682604" ], "invoiceNumber": "45663", "invoiceDate": "2023-07-19", "invoiceType": "BOLETA", "invoiceDocumentFormat": "pdf", "invoiceDocument": ``` -------------------------------- ### ProductCreate cURL Example Source: https://developers.falabella.com/v500.0.0/reference/productcreate Example of how to create a product using the ProductCreate API endpoint via cURL. Remember to update the Timestamp and recompute the Signature before execution. ```curl # ProductCreate cURL example # to run, update Timestamp and recompute Signature # url = "https://sellercenter-api.falabella.com/" post data-urlencode Action=ProductCreate data Timestamp=2015-07-01T11:11+0000 data-urlencode UserID=maintenance@sellercenter.net data-urlencode Version=1.0 data-urlencode Signature=7cd3bf58ba87e2928c8fbb93acab0fa9e88cd8086231977d5cd78c4c495bedb5 ``` -------------------------------- ### GetCategoryTree cURL Example Source: https://developers.falabella.com/v500.0.0/reference/get-category-suggestion This cURL command is an example for the GetCategoryTree action. Remember to update the Timestamp and recompute the Signature for actual use. ```curl # GetCategoryTree cURL example # to run, update Timestamp and recompute Signature # url = "https://sellercenter-api.falabella.com/" get data-urlencode Action=GetCategoryTree data Timestamp=2015-07-01T11:11+0000 data-urlencode UserID=maintenance@sellercenter.net data-urlencode Version=1.0 data-urlencode Signature=1a497a8bc55c08b9c124ea3f23b1af44ec7f4a2a5f20e2eae9080d6db25f3c36 ``` -------------------------------- ### ProductUpdate POST Data Example Source: https://developers.falabella.com/v500.0.0/reference/requests-and-responses Example of additional XML data sent in the body for the ProductUpdate method. This includes product details like SellerSku, Price, SaleStartDate, SaleEndDate, and SalePrice. ```xml SKU-AAAA 10.0 2015-07-01T11:11:11+0000 2015-07-01T11:11:11+0000 8.0 SKU-BBBB 32.5 ``` -------------------------------- ### Feed Offset List cURL Example Source: https://developers.falabella.com/v500.0.0/reference/feedoffsetlist This cURL example demonstrates how to request a list of feeds using the FeedOffsetList action. Remember to update the Timestamp and recompute the Signature for actual use. ```curl # FeedOffsetList cURL example # to run, update Timestamp and recompute Signature # url = "https://sellercenter-api.falabella.com/" get data-urlencode Action=FeedOffsetList data-urlencode Offset=1 data-urlencode PageSize=1 data-urlencode Timestamp=2015-07-01T11:11+0000 data-urlencode UserID=maintenance@sellercenter.net data-urlencode Version=1.0 data-urlencode Signature=7b40bcc293a9e5eb49d9497ed06900c5040b2a87fcfcb1554927991f1af3cc0e ``` -------------------------------- ### Get Content Score Rules (XML) Source: https://developers.falabella.com/v500.0.0/reference/get-content-score This example shows the structure of an XML response when requesting content score rules. It details various configuration rules, fields, and their associated scores. ```xml 171 getContentScore Content Score 2025-02-10T14:22:41-0300 CHARACTER_COUNT title 30 60 20 WORD_COUNT description 50 50 CHARACTER_COUNT attributes.alto 5 1 CHARACTER_COUNT attributes.ancho 5 1 CHARACTER_COUNT attributes.largo 5 1 CHARACTER_COUNT attributes.material 5 1 TOO_MANY_CHARACTER_COUNT title -10 80 ``` -------------------------------- ### PHP Example for Signing API Requests Source: https://developers.falabella.com/v500.0.0/reference/setinvoicepdf This example demonstrates how to construct and sign an API request using PHP. It includes setting up headers, parameters, URL-encoding, and calculating the HMAC-SHA256 signature with an API key. Ensure your timezone is correctly set. ```php 'application/json', 'content-type' => 'application/json' ]; // Datos de la solicitud $userID = 'look@me.com'; $apiVersion = '1.0'; $action = 'FeedList'; $format = 'JSON'; $service = 'Invoice'; // Obtener la marca de tiempo actual en formato ISO 8601 $timestamp = date('c'); // Parámetros para la firma $parametersForSignature = [ 'UserID' => $userID, 'Version' => $apiVersion, 'Action' => $action, 'Format' => $format, 'Timestamp' => $timestamp, 'Service' => $service ]; // Ordenar los parámetros por nombre ksort($parametersForSignature); // URL-encode los parámetros $encodedParameters = []; foreach ($parametersForSignature as $name => $value) { $encodedParameters[] = rawurlencode($name) . '=' . rawurlencode($value); } // Concatenar los parámetros URL-codificados en una cadena $concatenatedParameters = implode('&', $encodedParameters); // Clave de la API asociada con el UserID $apiKey = 'b1bdb357ced10fe4e9a69840cdd4f0e9c03d77fe'; // Calcular la firma y agregarla a las cabeceras $signature = hash_hmac('sha256', $concatenatedParameters, $apiKey, false); $headers['Signature'] = rawurlencode($signature); // Fusionar las cabeceras para la solicitud $requestHeaders = array_merge($headers, $parametersForSignature); print_r($requestHeaders); ``` -------------------------------- ### GetWebhookEntities XML Response Example Source: https://developers.falabella.com/v500.0.0/reference/getwebhookentities This example shows the structure of a successful XML response when retrieving webhook entities. It lists available entities and their associated events. ```xml GetWebhookEntities Entities 2016-06-02T11:07:53+0200 Feed Completed onFeedCompleted Created onFeedCreated Metrics Updated onMetricsUpdated Order Created onOrderCreated StatusChanged onOrderItemsStatusChanged Product Created onProductCreated QcStatusChanged onProductQcStatusChanged Updated onProductUpdated Statistics Updated onStatisticsUpdated ``` -------------------------------- ### XML Response Example for GetWebhooks Source: https://developers.falabella.com/v500.0.0/reference/getwebhooks This is an example of the XML response structure when retrieving webhook data. It includes details for each webhook such as ID, callback URL, source, and associated events. ```xml GetWebhooks Webhooks 2016-06-07T18:35:09+0200 7dffaa4e-1713-42c2-84ba-1d2fbd4537ab http://localhost/callbacks/1 web onProductCreated fbfe60be-b282-4bc1-9e4d-2147c686d1a8 http://localhost/callbacks/2k api onOrderCreated ``` -------------------------------- ### CreateWebhook cURL Example Source: https://developers.falabella.com/v500.0.0/reference/createwebhook This cURL command demonstrates how to create a webhook. Remember to update the Timestamp and recompute the Signature before execution. ```curl # CreateWebhook cURL example # to run, update Timestamp and recompute Signature # url = "https://sellercenter-api.falabella.com/" post data-urlencode Action=CreateWebhook data-urlencode Timestamp=2016-06-01T12:11+0000 data-urlencode UserID=maintenance@sellercenter.net data-urlencode Version=1.0 data-urlencode Signature=7cd3bf58ba87e2928c8fbb93acab0fa9e88cd8086231977d5cd78c4c495bedb5 ``` -------------------------------- ### GetWarehouse XML Response Example Source: https://developers.falabella.com/v500.0.0/reference/getwarehouse Example of a successful response from the GetWarehouse API, showing dummy warehouse data in XML format. This response includes details like warehouse name, IDs, type, and address. ```xml GetWarehouse Warehouses 2025-12-03T14:22:09-0300 Bodega_demo_03 GSC-SC3E1084ABE1233 only_returns false true false true
Av. ``` -------------------------------- ### ProductCreate API Success Response (XML) Source: https://developers.falabella.com/v500.0.0/reference/productcreate Example of a successful response from the ProductCreate API when the format is XML. ```xml cb106552-87f3-450b-aa8b-412246a24b34 ProductCreate 2016-06-22T04:40:14+0200 ``` -------------------------------- ### 500 Internal Server Error Response Example Source: https://developers.falabella.com/v500.0.0/reference/setinvoicepdf This example demonstrates the JSON structure for a 500 Internal Server Error response. It indicates an issue on the server side. ```json { "ErrorResponse": { "Head": { "RequestAction": "SetInvoicePDF", "ErrorType": "Sender", "ErrorCode": "E1000", "ErrorMessage": "Internal Application Error" }, "Body": { "errors": [ { "status": 500, "code": "Internal Server Error", "title": { "en": "", "es": "" } } ] } } } ``` -------------------------------- ### 400 Bad Request Error Response Example Source: https://developers.falabella.com/v500.0.0/reference/setinvoicepdf This example shows the JSON structure for a 400 Bad Request error response. It is used when the request sent by the client is invalid. ```json { "ErrorResponse": { "Head": { "RequestAction": "SetInvoicePDF", "ErrorType": "Sender", "ErrorCode": "E004", "ErrorMessage": "Invalid Request" }, "Body": { "errors": [ { "status": 400, "code": "Bad Request", "title": { "en": "", "es": "" } } ] } } } ``` -------------------------------- ### GetOrders cURL Example Source: https://developers.falabella.com/v500.0.0/reference/getordersv2 Use this cURL command to fetch orders. Remember to update the Timestamp and recompute the Signature for each request. ```curl # GetOrders cURL example # to run, update Timestamp and recompute Signature # url = "https://sellercenter-api.falabella.com/" get data-urlencode Action=GetOrders data-urlencode CreatedAfter=2014-01-01T00%3A00%3A00%2B0200 data-urlencode CreatedBefore=2014-12-31T23%3A59%3A59%2B0200 data-urlencode Offset=0 data-urlencode Limit=100 data-urlencode Status=pending data-urlencode Timestamp=2015-07-01T11:11+0000 data-urlencode UserID=maintenance@sellercenter.net data-urlencode Version=1.0 data-urlencode Signature=d4ff93cccb165295ed8357fe42082208b781a3b576bbb7d3fe7a624270b047b9 ``` -------------------------------- ### OpenAPI Schema Example Source: https://developers.falabella.com/v500.0.0/reference/setinvoicepdf This snippet shows a portion of an OpenAPI definition, illustrating the structure for defining request/response bodies and error messages. ```json { "example": "E1000" }, "ErrorMessage": { "type": "string", "example": "Internal Application Error" } } }, "Body": { "type": "object", "properties": { "errors": { "type": "array", "items": { "type": "object", "properties": { "status": { "type": "integer", "example": 500, "default": 0 }, "code": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "object", "properties": { "en": { "type": "string", "example": "" }, "es": { "type": "string", "example": "" } } } } } } } } } } } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": false, "proxy-enabled": true }, "x-readme-fauxas": true } ``` -------------------------------- ### Get Tracking Code Success Response (XML) Source: https://developers.falabella.com/v500.0.0/reference/gettrackingcode Example of a successful XML response from the GetTrackingCode API, containing package ID and tracking number. ```xml GetTrackingCode TrackingCode 2025-10-28T10:11:38-03:00 GetTrackingCode GetTrackingCode XML [123053199] 2025-10-28T10:11:38-03:00 test@falabella.com 1.0 a9219390a8bb3c28e4b7a9ddf84338c486d25705c6b77e9eda41a96731a0b186 PKG0058230783 140111000010399694 ``` -------------------------------- ### GetCategoryTree XML Response Example Source: https://developers.falabella.com/v500.0.0/reference/getcategorytree This is an example of the XML response structure returned by the GetCategoryTree API, illustrating the nested categories and their attributes. ```xml GetCategoryTree Categories 2015-07-01T11:11:11+0000 Quadrilaterals 2790 QUADRILATER 1 Rectangles 589 RECTANGLE 1 Squares 603 SQUARE 2 ``` -------------------------------- ### FeedStatus cURL Example Source: https://developers.falabella.com/v500.0.0/reference/feedstatus Example of how to call the FeedStatus API using cURL. Remember to update the Timestamp and recompute the Signature before running. ```curl # FeedStatus cURL example # to run, update Timestamp and recompute Signature # url = "https://sellercenter-api.falabella.com/" get data-urlencode Action=FeedStatus data-urlencode FeedID=4a835cd5-1f55-f56e011be009 data-urlencode Timestamp=2015-07-01T11:11+0000 data-urlencode UserID=maintenance@sellercenter.net data-urlencode Version=1.0 data-urlencode Signature=685d7883322681f9d70948312b7cf7d7b9639bb10ba2c111122f9c289fda128c ``` -------------------------------- ### Get Feed Status Source: https://developers.falabella.com/v500.0.0/reference/feedstatus This operation retrieves the status of a feed. You need to provide the Feed ID to get detailed information about its processing. ```APIDOC ## GET FeedStatus ### Description Retrieves the status of a feed using its unique Feed ID. ### Method GET ### Endpoint /FeedStatus ### Parameters #### Query Parameters - **Action** (string) - Required - Specifies the action to perform, which is 'FeedStatus'. - **FeedID** (string) - Required - The unique identifier of the feed. - **Timestamp** (string) - Required - The current date and time in ISO 8601 format. - **UserID** (string) - Required - The identifier of the user making the request. - **Version** (string) - Required - The API version. - **Signature** (string) - Required - The signature generated for authentication. ### Request Example ```bash curl -X GET \ 'https://sellercenter-api.falabella.com/?Action=FeedStatus&FeedID=4a835cd5-1f55-f56e011be009&Timestamp=2015-07-01T11:11+0000&UserID=maintenance@sellercenter.net&Version=1.0&Signature=685d7883322681f9d70948312b7cf7d7b9639bb10ba2c111122f9c289fda128c' ``` ### Response #### Success Response (200) - **Feed** (string) - The Feed ID. - **Status** (string) - The current status of the feed (e.g., 'Finished', 'Processing'). - **Action** (string) - The type of action the feed was for (e.g., 'ProductUpdate'). - **CreationDate** (string) - The date and time when the feed was created. - **UpdatedDate** (string) - The date and time when the feed was last updated. - **Source** (string) - The source of the feed submission (e.g., 'api'). - **TotalRecords** (integer) - The total number of records in the feed. - **ProcessedRecords** (integer) - The number of records successfully processed. - **FailedRecords** (integer) - The number of records that failed processing. - **FeedErrors** (object) - Contains details about any errors encountered during feed processing. - **FeedWarnings** (object) - Contains details about any warnings encountered during feed processing. #### Response Example ```json { "SuccessResponse": { "Head": { "RequestId": null, "RequestAction": "FeedStatus", "ResponseType": "FeedDetail", "Timestamp": "2015-07-06T15:00:14+0200", "RequestParameters": { "FeedID": "883bdfe3-950f-4390-9a80-41437b69808c" } }, "Body": { "FeedDetail": { "Feed": "883bdfe3-950f-4390-9a80-41437b69808c", "Status": "Finished", "Action": "ProductUpdate", "CreationDate": "2015-05-05 15:06:35", "UpdatedDate": "2015-05-05 15:07:11", "Source": "api", "TotalRecords": 10, "ProcessedRecords": 10, "FailedRecords": 0, "FeedErrors": null, "FeedWarnings": { "Warning": { "Message": "The following SKUs have been excluded...", "SellerSku": "SKU-123" } } } } } } ``` ``` -------------------------------- ### ProductCreate cURL Example Source: https://developers.falabella.com/v500.0.0/reference/productcreate This snippet demonstrates how to use cURL to call the ProductCreate API. Remember to update the Timestamp and recompute the Signature for each request. ```APIDOC ## ProductCreate ### Description This endpoint is used to create a new product listing in the Falabella Seller Center. ### Method POST ### Endpoint https://sellercenter-api.falabella.com/ ### Parameters #### Query Parameters - **Action** (string) - Required - Specifies the API action to perform, which is 'ProductCreate'. - **UserID** (string) - Required - The identifier for the user making the request. - **Version** (string) - Required - The API version to use, e.g., '1.0'. - **Timestamp** (string) - Required - The date and time of the request in ISO 8601 format (e.g., 2015-07-01T11:11+0000). - **Signature** (string) - Required - A computed signature for request authentication. ### Request Example ```bash curl -X POST \ 'https://sellercenter-api.falabella.com/' \ --data-urlencode 'Action=ProductCreate' \ --data 'Timestamp=2015-07-01T11:11+0000' \ --data-urlencode 'UserID=maintenance@sellercenter.net' \ --data-urlencode 'Version=1.0' \ --data-urlencode 'Signature=7cd3bf58ba87e2928c8fbb93acab0fa9e88cd8086231977d5cd78c4c495bedb5' ``` ``` -------------------------------- ### Update Stock with SellerWarehouseId (Shell) Source: https://developers.falabella.com/v500.0.0/reference/updatestock Use this example to update stock quantities using the SellerWarehouseId. Ensure all required parameters like Action, Format, Timestamp, UserID, Version, and Signature are correctly provided in the URL. ```shell curl --location 'https://sellercenter-api.falabella.com?Action=UpdateStock&Format=XML&Timestamp=2025-10-23T13%3A43%3A29.163Z&UserID=calexgonzalezs%40falabella.com&Version=1.0&Signature=182f531d2b73143fead49ba11444f5d37de353732670cbd4bc0c6ebefe1afa1f' \ --header 'Content-Type: application/xml' \ --header 'Cookie: _cfuvid=AFxcT2jxGTgAtf1nfDBWiE52UzPgZHQNiiqw6abWYfw-1761226220073-0.0.1.1-604800000' \ --data ' sellerWarehouseId1 abc02 234 sellerWarehouseId2 abc02 234 ' ``` -------------------------------- ### GetBrands cURL Example Source: https://developers.falabella.com/v500.0.0/reference/getbrands This cURL command demonstrates how to call the GetBrands API. Remember to update the Timestamp and recompute the Signature before execution. ```curl # GetBrands cURL example # to run, update Timestamp and recompute Signature # url = "https://sellercenter-api.falabella.com/" get data-urlencode Action=GetBrands data-urlencode Timestamp=2015-07-01T11:11+0000 data-urlencode UserID=maintenance@sellercenter.net data-urlencode Version=1.0 data-urlencode Signature=01286525c2fdba58296a61ed1f5e559d0e25972c288d2464b6c25fccc6be729a ``` -------------------------------- ### GetDocument cURL Example Source: https://developers.falabella.com/v500.0.0/reference/getdocument This cURL command demonstrates how to make a GetDocument request. Remember to update the Timestamp and recompute the Signature before execution. ```curl # GetDocument cURL example # to run, update Timestamp and recompute Signature # url = "https://sellercenter-api.falabella.com/" get data-urlencode Action=GetDocument data-urlencode DocumentType=shippingParcel data-urlencode OrderItemIds=[1,2] data Timestamp=2015-07-14T04%3A27%2B0000 data-urlencode UserID=maintenance@sellercenter.net data-urlencode Version=1.0 data-urlencode Signature=4bef3fda564dd24173260066b97c4e4af08dc9984a0ce147de2f476c167e6475 ``` -------------------------------- ### Get Order V2 OpenAPI Definition Source: https://developers.falabella.com/v500.0.0/reference/getorderv2 This snippet shows the OpenAPI definition for the Get Order V2 endpoint, detailing the request and response schemas. It includes parameters for filtering orders and the structure of the order data returned. ```yaml paths: /v2/orders/{orderId}: get: summary: Get Order operationId: getOrderV2 parameters: - name: orderId in: path required: true schema: type: string - name: includeItems in: query required: false schema: type: boolean default: false responses: "200": description: OK content: application/json: schema: type: object properties: SuccessResponse: type: object properties: Body: type: object properties: Orders: type: object properties: Order: type: object properties: OrderId: type: string OrderDate: type: string OrderType: type: string Customer: type: object properties: CustomerId: type: string CustomerName: type: string CustomerType: type: string CustomerEmail: type: string CustomerPhone: type: string CustomerDocument: type: string CustomerVerifierDigit: type: string Items: type: object properties: Item: type: array items: type: object properties: SkuId: type: string SkuName: type: string Quantity: type: integer Price: type: number Tax: type: number Discount: type: number Total: type: number Weight: type: number Height: type: number Width: type: number Depth: type: number ShippingFee: type: number ShippingTax: type: number Voucher: type: number TaxAmount: type: number ProductTotal: type: number GrandTotal: type: number ShippingType: type: string OperatorCode: type: string InvoiceRequired: type: boolean Warehouse: type: object properties: SellerWarehouseId: type: string FacilityId: type: string Statuses: type: object properties: Status: type: array items: type: string Receiver: type: object properties: ReceiverId: type: string ReceiverName: type: string ReceiverType: type: string ReceiverEmail: type: string ReceiverPhone: type: string ReceiverDocument: type: string ReceiverVerifierDigit: type: string ReceiverAddress: type: string ReceiverPostcode: type: string ReceiverLegalName: type: string ReceiverMunicipality: type: string ReceiverTypeRegimen: type: string ReceiverPhonenumber: type: string ReceiverLocality: type: string ExtraBillingAttributes: type: object properties: InvoiceRequired: type: boolean OperatorCode: type: string ShippingType: type: string GrandTotal: type: number ProductTotal: type: number TaxAmount: type: number ShippingFeeTotal: type: number ShippingTax: type: number Voucher: type: number Statuses: type: object properties: Status: type: array items: type: string Warehouse: type: object properties: SellerWarehouseId: type: string FacilityId: type: string ```