GetOrders

get https://sellercenter-api.linio.com.mx/?Action=GetOrders

Obtiene los detalles del cliente para un rango de pedidos.
Es sustancialmente diferente de GetOrder, que recupera los elementos de un pedido.

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 Centro de Vendedores
CustomerFirstName	String	El nombre del cliente
CustomerLastName	String	El apellido del cliente
OrderNumber	Unsigned	El número de pedido legible para el ser humano
PaymentMethod	String	La forma de pago
Remarks	String	Una observación legible para el ser humano
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)
PromisedShippingTimes	DateTime	Tiempo de envío objetivo para el artículo más rápido del pedido si estuvieran disponibles
ExtraAttributes	String	Atributos extra que fueron pasados al Centro de Vendedores en la llamada getMarketPlaceOrders. Es una cadena JSON que el cliente debe analizar.

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)

Query Params

Action

string

Defaults to GetOrders

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

Format

string

Defaults to XML

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

Timestamp

date

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

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

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

Signature

string

La firma criptográfica que autentifica la solicitud. La persona que llama debe crear este valor calculando el hash SHA256 de la solicitud, utilizando la clave API del usuario especificado en el parámetro UserID. Obligatorio. Si se omite, se devuelve un mensaje de error 'E001: Parameter Signature is mandatory'. Si la firma es incorrecta, se devuelve un mensaje de error 'E007: Login failed. Signature mismatch'.

CreatedAfter

date

Limita la lista de pedidos devuelta a los creados después o en una fecha especificada, dada en formato de fecha ISO 8601. O bien CreatedAfter o bien UpdatedAfter son obligatorios o bien se devolverá un error 'E018: Either CreatedAfter or UpdatedAfter is mandatory' será devuelto.

CreatedBefore

date

Limita la lista de pedidos devuelta a los creados antes o en una fecha especificada, dada en formato de fecha ISO 8601. Opcional.

UpdatedAfter

date

Limita la lista de pedidos devuelta a los actualizados después o en una fecha especificada, dada en formato de fecha ISO 8601. O bien UpdatedAfter o bien CreatedAfter son obligatorios o bien se devolverá un error 'E018: O bien CreatedAfter o bien UpdatedAfter es obligatorio' será devuelto. Nota: El updateAfter no está relacionado con el updateAt del pedido, sino con el createAt del historial del pedido de venta. En la versión 2.0 se utiliza la dirección de la orden actualizada en, y no el historial del artículo de la orden.

UpdatedBefore

date

Limita la lista de pedidos devuelta a los actualizados antes o en una fecha especificada, dada en formato de fecha ISO 8601. Opcional. Nota: El updateBeore no está relacionado con el updateAt del pedido, sino con el createAt del historial del artículo de venta. En la versión 2.0 se utiliza la dirección de la orden actualizada en, y no el historial del artículo de la orden.

Limit

int32

El número máximo de pedidos que deben ser devueltos, por defecto 1000

Offset

int32

Número de órdenes que se saltan al principio de la lista (es decir, un desplazamiento en el conjunto de resultados; junto con el parámetro Límite, es posible la paginación simple del conjunto de resultados; si se paginan los resultados, tenga en cuenta que la lista de órdenes puede cambiar durante la paginación).

Status

string

Cuando se establece, limita el conjunto de pedidos devueltos a los pedidos sueltos, que devuelven sólo las entradas que se ajustan al estado proporcionado. Los valores posibles son "pending", "canceled", "ready_to_ship", "delivered", "returned", "shipped" and "failed".

SortBy

string

Permite elegir la columna de ordenación. Valores posibles (created_at, updated_at). En la versión 2.0 está fijado en updated_at y no se puede cambiar

SortDirection

string

Especifica el tipo de ordenación. Valores posibles (ASC, DESC)

Responses

Errores

200200

400400