ReferenciaÓrdenesConsultar Órdenes V2
GET
Consultar Órdenes V2
Endpoint
https://sellercenter-api.falabella.com/?Action=GetOrdersGetOrders. Obtiene un conjunto de órdenes (versión 2.0). Esta versión del API incluye la bodega de origen de la venta
GETConsultar Órdenes V2
?Action=GetOrderscurl -G "https://sellercenter-api.falabella.com/" \--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 "UpdatedAfter=2015-07-01T11:11:00+0000" \--data-urlencode "Format=XML" \--data-urlencode "Timestamp=2015-07-01T11:11+0000" \--data-urlencode "[email protected]" \--data-urlencode "Version=1.0" \--data-urlencode "Signature=d4ff93cccb165295ed8357fe42082208b781a3b576bbb7d3fe7a624270b047b9"
Pueden generarse por ejemplo filtros por fechas, cantidad de ordenes (por defecto es 100) y estados. Recuerda que puedes ver los estados disponibles de las órdenes en el apartado flujos de órdenes (Aquí)
- ●Cuando el ShipmenType es Dropshipping las ordenes son fulfillment by the seller por lo que deben consumir stock ya que se arman en bodegas propias;
- ●Cuando el ShipmenType es Own Warehouse, estas órdenes son fulfillment by Falabella y no deberían con sumir stock por que este ya fue entregado a Falabella.com para que realice el fulfillment en nombre del seller.
Boleta o Factura?
Como se muestra en la tabla anterior, el campo 'InvoiceRequired' indica si la venta se realizó mediante boleta ('Factura persona natural' en Colombia) o factura ('Factura empresa' en Colombia). Devolverá 'True' si es factura y 'False' si es boleta. Si es factura ('Factura empresa' en Colombia), el API devolverá una serie de campos con información relevante para generar la facturación, presentados en la siguiente tabla
| Campo | Aclaración | Descripción |
|---|---|---|
| ReceiverLegalName | Razón social | Corresponde al negocio al que se le debe emitir la factura empresa. |
| ReceiverAddress | Dirección | Dirección a la que se debe hacer la factura. |
| ReceiverRegion | Región (Chile) / Departamento (Perú) / Departamento (Colombia) | Locación en que se encuentra la dirección |
| ReceiverMunicipality | Comuna (Chile) / Provincia (Perú) / Ciudad o Municipio (Colombia) | corresponde a la zona en la que se encuentra la\ dirección. |
| FiscalPerson | Personal fiscal | Identificación del negocio |
| DocumentType | Tipo documento | Tipo de documento de identificación del rol\ tributario de la razón social. |
| LegalId | Identificación legal | Corresponde al número del documento identificado en el campo "Tipo de documento" con digito verificador |
| ReceiverTypeRegimen | Actividad económica | Código y nombre de la actividad o industria en la que se desempeña la razón social. |
| CustomerVerifierDigit | Digito verificador | Es el digito verificador del "identificador legal". |
| ReceiverEmail | Correo | Correo que debe asociar a la Factura |
| ReceiverPhonenumber | Teléfono | Teléfono que debe asociar a la Factura |
Parámetros
Action
string
RequeridoNombre de la función que se va a llamar. Es obligatorio y debe ser 'GetOrders' en este caso. Si se omite, se devuelve un error 'E001: Parameter Action is mandatory'. Si se suministra una cadena de función desconocida, se devuelve un mensaje de error 'E008: Acción no válida'.
GetOrdersFormat
string
RequeridoSi se suministra, debe ser "JSON" o "XML". Si no se suministra, se asume que es "XML".
XMLTimestamp
date
RequeridoLa hora actual en formato ISO8601 relativo a UTC (por ejemplo, Timestamp=2015-04-01T10:00:00+02:00 para Berlín), para que las llamadas no puedan ser reproducidas por un tercero que las escuche (es decir, las llamadas demasiado lejanas en el pasado o en el futuro producen un mensaje de error). Obligatorio. Si no se suministra, aparece el mensaje de error "E001: Parameter Timestamp is mandatory". Si la marca de tiempo es demasiado antigua o está en el futuro, aparece un mensaje de error "E003: Timestamp has expired'.
UserID
string
RequeridoEl ID del usuario que realiza la llamada. La lista de usuarios autorizados se mantiene en la interfaz web de SellerCenter en Configuración/Gestión de usuarios.
Version
string
RequeridoLa versión de la API contra la que se va a ejecutar esta llamada, para efectos de esta versión, siempre debe aplicar 2.0
2.0Los campos de respuesta proporcionados por esta API se encuentran detallados en la siguiente tabla:
| Nombre del campo | Tipo | Descripción |
|---|---|---|
| TotalCount | Unsigned | Este número, que se muestra en la sección Cabeza, indica el número completo de todos los pedidos para el conjunto de filtros actual en la base de datos |
| OrderId | Unsigned | Identificador de este pedido asignado por el Falabella Seller Center |
| CustomerFirstName | String | El nombre del cliente |
| CustomerLastName | String | El apellido del cliente |
| OrderNumber | Unsigned | El número de pedido |
| PaymentMethod | String | La forma de pago |
| Remarks | String | Una observación |
| DeliveryInfo | String | Información sobre la entrega de ese pedido |
| Price | Float | El importe total de este pedido |
| GiftOption | Boolean | 1 si el artículo es un regalo, 0 si no lo es |
| GiftMessage | String | Mensaje de regalo según lo especificado por el cliente |
| CreatedAt | DateTime | Fecha y hora en que se realizó el pedido |
| UpdatedAt | DateTime | Fecha y hora de la última modificación de la orden |
| AddressBilling | Subsection | Nodo que contiene nodos adicionales, que conforman la dirección de facturación: Nombre, Apellido, Teléfono, Teléfono2, Dirección1, Dirección2, Ciudad, Código postal, País |
| AddressShipping | Subsection | Nodo que contiene nodos adicionales, que conforman la dirección de envío: Nombre, Apellido, Teléfono, Teléfono2, Dirección1, Dirección2, Ciudad, Código postal, País |
| NationalRegistrationNumber | String | Se requiere en algunos países |
| ItemsCount | Integer | Número de artículos en orden |
| Statuses | Array | Estados únicos de los artículos del pedido. (pista: puede encontrar todos los diferentes códigos de estado en el ejemplo de respuesta) |
| PromisedShippingTime | DateTime | Corresponde a la fecha en que la orden debe ser entregada al operador logístico. Esfundamental cumplir con este plazo para evitar adelantos o retrasos en el envío, ya que cualquier desviación podría generar penalizaciones. |
| ExtraAttributes | String | Atributos extra que fueron pasados a Falabella Seller Center en la llamada getMarketPlaceOrders. Es una cadena JSON que el cliente debe analizar. |
| ExtraBillingAttributes | String | Nodo que contiene información adicional para facturación: LegalId FiscalPerson, DocumentType, ReceiverRegion, ReceiverAddress, ReceiverPostcode, ReceiverLegalName, ReceiverMunicipality, ReceiverTypeRegimen, CustomerVerifierDigit |
| ShippingType | String | Modalidad de fulfillment y de delivery de la orden. ¹ |
| InvoiceRequired | Boolean | Entrega valor True(“Factura empresa” en Colombia) si el documento es factura, y valor False si este es una boleta (“Factura persona natural” en Colombia). |
| SellerWarehouseId | String | ID único de bodega asignado por el Seller. |
| FacilityId | String | ID único de bodega asignado por Falabella. |
Respuesta 200
<?xml version="1.0" encoding="UTF-8"?>
<SuccessResponse>
<Head>
<RequestId/>
<RequestAction>
GetOrders
</RequestAction>
<ResponseType>
Orders
</ResponseType>
<Timestamp>
2025-04-03T21:39:12.979Z
</Timestamp>
<TotalCount>
2
</TotalCount>
</Head>
<Body>
<Orders>
<Order>
<OrderId>
1104089001
</OrderId>
<CustomerFirstName>
TestNombre
</CustomerFirstName>
<CustomerLastName>
TestApellido
</CustomerLastName>
<OrderNumber>
2771009001
</OrderNumber>
<PaymentMethod>
ecommPay
</PaymentMethod>
<Remarks/>
<DeliveryInfo/>
<Price>
24990
</Price>
<GiftOption>
0
</GiftOption>
<GiftMessage/>
<VoucherCode/>
<CreatedAt>
2025-04-03 12:00:00
</CreatedAt>
<UpdatedAt>
2025-04-03 14:00:00
</UpdatedAt>
<AddressUpdatedAt>
2025-04-03 12:00:00
</AddressUpdatedAt>
<AddressBilling>
<FirstName>
TestNombre
</FirstName>
<LastName>
TestApellido
</LastName>
<Address1>
Av. Providencia
</Address1>
<Address2>
1234
</Address2>
<Address3>
Depto 101
</Address3>
<Address4/>
<Address5/>
<CustomerEmail>
[email protected]
</CustomerEmail>
<City>
SANTIAGO
</City>
<Ward>
PROVIDENCIA
</Ward>
<Region>
METROPOLITANA DE SANTIAGO
</Region>
<PostCode></PostCode>
<Country>
CL
</Country>
<Phone/>
<Phone2/>
</AddressBilling>
<AddressShipping>
<FirstName>
TestNombre
</FirstName>
<LastName>
TestApellido
</LastName>
<Phone/>
<Phone2/>
<Address1>
Av. Providencia
</Address1>
<Address2>
1234
</Address2>
<Address3>
Depto 101
</Address3>
<Address4/>
<Address5/>
<CustomerEmail>
[email protected]
</CustomerEmail>
<City>
SANTIAGO
</City>
<Ward>
PROVIDENCIA
</Ward>
<Region>
REGION METROPOLITANA
</Region>
<Country>
CL
</Country>
<PostCode>
7500000
</PostCode>
</AddressShipping>
<NationalRegistrationNumber>
11111111
</NationalRegistrationNumber>
<ItemsCount>
1
</ItemsCount>
<PromisedShippingTime>
2025-04-04 23:00:00
</PromisedShippingTime>
<ExtraAttributes>
{"itemId":"1","deliveryOrderGroupId":"000000001","originNode":"node-test-001"}
</ExtraAttributes>
<ExtraBillingAttributes>
<LegalId/>
<FiscalPerson/>
<DocumentType/>
<ReceiverRegion/>
<ReceiverAddress/>
<ReceiverPostcode>
-
</ReceiverPostcode>
<ReceiverLegalName/>
<ReceiverMunicipality/>
<ReceiverTypeRegimen/>
<CustomerVerifierDigit/>
<ReceiverPhonenumber/>
<ReceiverEmail/>
<ReceiverLocality/>
</ExtraBillingAttributes>
<InvoiceRequired>
false
</InvoiceRequired>
<OperatorCode>
facl
</OperatorCode>
<ShippingType>
Dropshipping
</ShippingType>
<GrandTotal>
24990
</GrandTotal>
<ProductTotal>
24990
</ProductTotal>
<TaxAmount>
0
</TaxAmount>
<ShippingFeeTotal>
0
</ShippingFeeTotal>
<ShippingTax>
0
</ShippingTax>
<Voucher>
0
</Voucher>
<Statuses>
<Status>
ready_to_ship
</Status>
</Statuses>
<Warehouse>
<SellerWarehouseId>
default-test-01
</SellerWarehouseId>
<FacilityId>
GSC-SC11212
</FacilityId>
</Warehouse>
</Order>
<Order>
<OrderId>
1104089002
</OrderId>
<CustomerFirstName>
TestUsuario
</CustomerFirstName>
<CustomerLastName>
DemoCliente
</CustomerLastName>
<OrderNumber>
2771009002
</OrderNumber>
<PaymentMethod>
ecommPay
</PaymentMethod>
<Remarks/>
<DeliveryInfo/>
<Price>
14990
</Price>
<GiftOption>
0
</GiftOption>
<GiftMessage/>
<VoucherCode/>
<CreatedAt>
2025-04-03 12:05:00
</CreatedAt>
<UpdatedAt>
2025-04-03 14:05:00
</UpdatedAt>
<AddressUpdatedAt>
2025-04-03 12:05:00
</AddressUpdatedAt>
<AddressBilling>
<FirstName>
TestUsuario
</FirstName>
<LastName>
DemoCliente
</LastName>
<Address1>
Av. Las Condes
</Address1>
<Address2>
4321
</Address2>
<Address3>
Casa 12
</Address3>
<Address4/>
<Address5/>
<CustomerEmail>
[email protected]
</CustomerEmail>
<City>
SANTIAGO
</City>
<Ward>
LAS CONDES
</Ward>
<Region>
METROPOLITANA DE SANTIAGO
</Region>
<PostCode></PostCode>
<Country>
CL
</Country>
<Phone/>
<Phone2/>
</AddressBilling>
<AddressShipping>
<FirstName>
TestUsuario DemoCliente
</FirstName>
<LastName>
DemoCliente
</LastName>
<Phone/>
<Phone2/>
<Address1>
Av. Las Condes
</Address1>
<Address2>
4321
</Address2>
<Address3>
Casa 12
</Address3>
<Address4/>
<Address5/>
<CustomerEmail>
[email protected]
</CustomerEmail>
<City>
SANTIAGO
</City>
<Ward>
LAS CONDES
</Ward>
<Region>
REGION METROPOLITANA
</Region>
<Country>
CL
</Country>
<PostCode></PostCode>
</AddressShipping>
<NationalRegistrationNumber>
22222222
</NationalRegistrationNumber>
<ItemsCount>
2
</ItemsCount>
<PromisedShippingTime>
2025-04-04 23:00:00
</PromisedShippingTime>
<ExtraAttributes>
{"itemId":"2","deliveryOrderGroupId":"000000002","originNode":"node-test-002"}
</ExtraAttributes>
<ExtraBillingAttributes>
<LegalId/>
<FiscalPerson/>
<DocumentType/>
<ReceiverRegion/>
<ReceiverAddress/>
<ReceiverPostcode>
-
</ReceiverPostcode>
<ReceiverLegalName/>
<ReceiverMunicipality/>
<ReceiverTypeRegimen/>
<CustomerVerifierDigit/>
<ReceiverPhonenumber/>
<ReceiverEmail/>
<ReceiverLocality/>
</ExtraBillingAttributes>
<InvoiceRequired>
false
</InvoiceRequired>
<OperatorCode>
facl
</OperatorCode>
<ShippingType>
Dropshipping
</ShippingType>
<GrandTotal>
14990
</GrandTotal>
<ProductTotal>
14990
</ProductTotal>
<TaxAmount>
0
</TaxAmount>
<ShippingFeeTotal>
0
</ShippingFeeTotal>
<ShippingTax>
0
</ShippingTax>
<Voucher>
0
</Voucher>
<Statuses>
<Status>
ready_to_ship
</Status>
</Statuses>
<Warehouse>
<SellerWarehouseId>
default-test-01
</SellerWarehouseId>
<FacilityId>
GSC-SC11212
</FacilityId>
</Warehouse>
</Order>
</Orders>
</Body>
</SuccessResponse>Errores
| Código de error | Mensaje |
|---|---|
| 14 | E014: "%s" Invalid Offset (Compensación inválida) |
| 17 | E017: "%s" Invalid Date Format (Formato de fecha no válido) |
| 19 | E019: "%s" Invalid Limit (Límite inválido) |
| 36 | E036: Invalid status filter (Filtro de estado inválido) |
| 74 | E074: Invalid sort direction. (Dirección de ordenación no válida) |
| 75 | E075: Invalid sort filter. (Filtro de ordenación no válido) |