ReferenciaÓrdenesConsultar Órdenes
GET
Consultar Órdenes
Endpoint
https://sellercenter-api.falabella.com/?Action=GetOrdersGetOrders. Obtiene un conjunto de órdenes
GETConsultar Órdenes
?Action=GetOrderscurl -G "https://sellercenter-api.falabella.com/" \--data-urlencode "Action=GetOrders" \--data-urlencode "Format=XML" \--data-urlencode "Timestamp=2015-07-01T11:11:00+0000" \--data-urlencode "[email protected]" \--data-urlencode "Version=1.0" \--data-urlencode "Signature=YOUR_SIGNATURE"
Importante
Contamos con una versión 2.0 de este endpoint, puedes revisarlo Aquí
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í)
| 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
Si 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
El 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 1.0
1.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). |
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
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>
</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) |