get https://sellercenter-api.falabella.com/?Action=GetOrder
GetOrder. A través de un OrderId, obtiene los elementos para un solo pedido.
Los campos de respuesta proporcionados por esta API se encuentran detallados en la siguiente tabla:
| Nombre del campo | Tipo | Descripción |
|---|---|---|
| OrderId | Unsigned | Identificador de este pedido asignado por el Seller Center. |
| CustomerFirstName | String | El nombre del cliente. |
| CustomerLastName | String | El apellido del cliente. |
| OrderNumber | Unsigned | El número de pedido legible por humanos. |
| PaymentMethod | String | La forma de pago. |
| Remarks | String | Una observación legible para el ser humano. |
| DeliveryInfo | String | Información de envío de la orden. |
| 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 exige en algunos países. |
| ExtraAttributes | String | Atributos extra que fueron pasados al Centro de Vendedores 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 |
| 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). |
| OperatorCode | String | Nombre tipo del operador (Identifica país de operación) ag.: facl, fape, etc. |
| ShippingType | String | Modalidad de fulfillment y de delivery de la orden ¹. |
| InvoiceRequired | Boolean | Entrega valor True si el documento es Factura, y valor False si este es una boleta. |
¹ - 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 Fulfilled 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 Fulfilled 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 error | Mensaje |
|---|---|
| 16 | E016: "%s" Invalid Order ID (ID de pedido inválido) |