Consultar Órdenes

Deprecado

Endpoint

https://sellercenter-api.falabella.com/?Action=GetOrders

GetOrders. Obtiene un conjunto de órdenes

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í)

¹ - Este campo se puede utilizar para diferenciar la modalidad de fulfillment y agregar reglas de decisión para el consumo o no consumo de stocks en los sistemas de gestión de inventarios de integradores, como se muestra en los siguientes ejemplos:

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 ordenes 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

Requerido

Nombre 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'. GetOrders

Format

string

Opcional

Si se suministra, debe ser "JSON" o "XML". Si no se suministra, se asume que es "XML". XML

Timestamp

date

Requerido

La 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

Opcional

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

Requerido

La versión de la API contra la que se va a ejecutar esta llamada, en formato mayor-punto-menor. Debe ser actualmente 1.0, aunque la versión real de la API sea 2.6.20. Si se omite, se devuelve un mensaje de error 'E001: Parameter Version is mandatory'.

Headers

accept

string

Opcional

Generado a partir de los tipos de contenido de respuesta disponibles. Valores permitidos: application/xml, application/json. application/json

Los 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).

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)