### 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
```