Consultar Órdenes V2

GetOrders. Obtiene un conjunto de órdenes (versión 2.0). Esta versión del API incluye la bodega de origen de la venta

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

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

SellerWarehouseId

String

ID único de bodega asignado por el Seller.

FacilityId

String

ID único de bodega asignado por Falabella.


  • 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


Errores

Código de errorMensaje
14E014: "%s" Invalid Offset (Compensación inválida)
17E017: "%s" Invalid Date Format (Formato de fecha no válido)
19E019: "%s" Invalid Limit (Límite inválido)
36E036: Invalid status filter (Filtro de estado inválido)
74E074: Invalid sort direction. (Dirección de ordenación no válida)
75E075: Invalid sort filter. (Filtro de ordenación no válido)
Language