GetOrder. A través de un OrderId, obtiene los elementos para un solo pedido.
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 |
|---|---|---|
| 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 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 |
Errores
| Código de error | Mensaje |
|---|---|
| 16 | E016: "%s" Invalid Order ID (ID de pedido inválido) |