Notas generales

Información de compatibilidad con versiones anteriores

La API de Menuweb se actualiza a través de un mecanismo de entrega continua, para proporcionar correcciones de errores, correcciones de seguridad y nuevas funciones.

Aquí hay algunas pautas que le permitirán tener una integración sólida:

  • Su integración debería permitir que se agreguen nuevos campos en las respuestas de la API. De vez en cuando, podemos agregar nuevos campos como parte de nuevas funciones.
  • No debe esperar que el orden de los campos en las llamadas a la API sea constante. El orden puede cambiar a medida que se agregan campos a la API.
  • Debe evitar almacenar los valores de cadena devueltos por las API en tipos enumerados.
  • Se usará el formato JSON, ya que nuestras APIs están todas disponibles solo en este formato, pero tenga en cuenta que esto puede cambiar y añadir otros formatos en un futuro.
Solicitud Content-Type

Cada API enumerará todos los formatos que pueden consumir. Si una API admite varios tipos, puede elegir el que prefiera agregando un Content-Type.

curl -H "Content-Type: application/json" https://www.menuweb.es/seller/api/[API-URL]
Respuesta Content-Type

Cada API enumerará todos los formatos que pueden producir. Si una API admite varios tipos, puede elegir el que prefiera agregando un Accept.

curl -H "Accept: application/json" https://www.menuweb.es/seller/api/[API-URL]
Codificación UTF-8

Todos los datos, excepto el contenido binario, están codificados en UTF-8.

Fecha

El formato de fecha es:

  • fecha-hora sin zona horaria con el patrón YYYY-MM-DDThh:mm:ss. Representa una fecha sin la zona horaria.
  • Todas las API siempre proporcionarán fechas y horas en UTC, con el final Z.

Los patrones son:

  • YYYY se refiere a un año de cuatro dígitos.
  • MM se refiere a un mes de dos dígitos, del 01 al 12.
  • DD se refiere a un día de dos dígitos, del 01 al 31.
  • T es un delimitador entre fecha y hora.
  • hh se refiere a una hora de dos dígitos, de 00 a 23.
  • mm se refiere a un minuto de dos dígitos, del 00 al 59.
  • ss se refiere a un segundo de dos dígitos, del 00 al 59.
  • Z indica el final de la fecha y hora.

Para las solicitudes GET, codifique las fechas como URL

fecha-hora: Ejemplo con el desplazamiento Z (UTC):

Formato de región

Si la API devuelve datos internacionalizados, puede especificar el parámetro locale.

El formato de configuración regional suele ser ISO-3166(por ejemplo, "ES"). Hay algunas excepciones en las que puede ser el formato Locale ISO-639 (por ejemplo, "es"). La configuración regional devuelta en una respuesta utiliza este formato.

Obtener pedidos realizados en España:

_/seller/api/orders?channel_codes=ES

Paginación y orden

Algunas API admiten la paginación de desplazamiento. En este caso, puede utilizar el parámetro max.

max
El parámetro max se utiliza para indicar el número máximo de elementos devueltos por página. Este parámetro es opcional. El valor predeterminado de este parámetro es 10. El valor máximo de este parámetro es 100.

Cuando un parámetro sort está disponible en una API, se puede utilizar para ordenar los resultados.

sort
El parámetro sort se utiliza para indicar cómo se deben ordenar los resultados. Este parámetro es opcional.
order
El parámetro order se utiliza para indicar la dirección de clasificación. Este parámetro es opcional. Los valores posibles para este parámetro son asc o desc (predeterminado).

Devuelve las 100 primeras lineas

_/seller/api/orders?max=100

Obtener los pedidos ordenados por order_id de forma ascendente

_/seller/api/orders?sort=order_id&order=asc

Paginación por búsqueda y orden

Algunas API admiten la paginación por busqueda. Eso significa que no puede ir directamente a la página número x. Para permitir un mejor rendimiento.

Para esas API, puede utilizar el parámetro max de consulta para indicar el número máximo de elementos que devueltos por página. Este parámetro es opcional. El valor predeterminado de este parámetro es 10. El valor máximo de este parámetro es 100.

Si hay más resultados para devolver, la respuesta contendrá un campo next_page_token. Pasar este valor en el parámetro page_token de consulta devolverá la siguiente página de resultado.

También se devuelve previous_page_token cuando el resultado no es la primera página. Se usa de la misma manera que next_page_token.

Ejemplo de token:


              
            
Lista de valores en la URL

Los campos que acepten un array se indican como lista en la URL. Puede agregar más valores repitiendo el esquema de parámetro clave=valor.

https://www.menuweb.es/seller/api/orders?order_state_codes=ORDER_ACCEPTED&order_state_codes=ORDER_PENDING&order_state_codes=ORDER_CANCELLED

Códigos respuesta API

La API de Menuweb utiliza códigos HTTP estándar.

Códigos de éxito

200
OK - Después de un GET exitoso.
201
Creado - Después de un POST exitoso.
204
Sin contenido - Después de un PUT o DELETE exitoso.

Códigos de error

400
Solicitud incorrecta - errores de parámetros o uso incorrecto del método. Mal uso del recurso. Ejemplo: falta un parámetro obligatorio, un parámetro con formato incorrecto, consulta de datos que no están en el estado esperado.
401
No autorizado - llamada de API sin autenticación. Agregue información de autenticación o use un token de autenticación válido.
403
Prohibido - se deniega el acceso al recurso. El usuario actual no puede acceder al recurso.
404
No encontrado - el recurso no existe. El URI del recurso no existe o el recurso que solicita no existe (para el usuario actual).
405
Método no permitido - el método http (GET, POST, PUT, DELETE) no está permitido para este recurso. Consulte la documentación para obtener la lista de métodos aceptados.
406
No aceptable - el tipo de contenido de respuesta solicitado no está disponible para este recurso. Consulte la documentación para obtener la lista de valores correctos del encabezado Aceptar para esta solicitud.
410
Desaparecido - el recurso ha desaparecido. El recurso solicitado ya no está disponible y no estará disponible nuevamente.
415
Tipo de medio no admitido - el tipo de contenido de la entidad enviado al servidor no es compatible. Consulte la documentación para obtener la lista de valores correctos del encabezado de tipo de contenido para enviar datos.
429
Demasiadas solicitudes - se superó el límite de frecuencia. El usuario ha enviado demasiadas solicitudes en la última hora. Consulte la documentación para conocer el recuento máximo de llamadas por hora.
500
Error interno del servidor - el servidor encontró un error inesperado.

400 - Solicitud incorrecta


401 - No autorizado


403 - Prohibido


404 - No encontrado


405 - Método no permitido


406 - No aceptable


410 - Desaparecido


415 - Tipo de medio no admitido


429 - Demasiadas solicitudes


500 - Error interno del servidor

Atributos indocumentados

Algunas API pueden devolver más datos de los documentados.

No confíe en estos datos indocumentados, no hay garantía sobre ellos.

Recuperación medios

Algunas salidas de API devuelven URL de medios. Esos medios se pueden recuperar a través de las URL proporcionadas: agregue el nombre de host a las URL devueltas.

API key

La API key se puede crear desde el panel de vendedor en ´Mis datos´ en la pestaña ´Integración´ y dentro del apartado ´API´.

La API key se usará en todas las llamadas realizadas en esta API. Debe enviarse desde la cabecera ´Authorization´.

APIs disponibles

Mensajes
GET - Mostrar hilo
URL
/seller/api/inbox/threads/{thread_id}
DESCRIPCIÓN

Muestra los mensajes e información de un hilo

PARÁMETROS RUTA
thread_id
Requerido
Cadena
Identificador del hilo
CÓDIGOS RETORNO

200 - OK

SALIDA (RESPUESTA)
authorized_participants
Requerido
Participantes autorizados
display_name
Requerido
Cadena
Nombre del participante
type
Requerido
Cadena
Tipo de participante:
CUSTOMER, SHOP, OPERATOR
current_participants
Requerido
Participantes actuales del hilo
display_name
Requerido
Cadena
Nombre del participante
type
Requerido
Cadena
Tipo de participante:
CUSTOMER, SHOP, OPERATOR
date_created
Requerido
Cadena - fecha-hora
Fecha de creación del hilo
date_updated
Requerido
Cadena - fecha-hora
Fecha de actualización del hilo
entities
Opcional
Entidades de hilo
id
Requerido
Cadena
Identificador de la entidad
label
Requerido
Cadena
Etiqueta de entidad
type
Requerido
Cadena
Tipo de entidad
id
Requerido
Cadena
Identificador del hilo
messages
Requerido
Mensajes de hilo
attachments
Opcional
Ficheros adjuntos del mensaje
id
Requerido
Cadena
Identificador del fichero adjunto
name
Requerido
Cadena
Nombre del fichero adjunto
size
Requerido
Entero
Tamaño del fichero adjunto
body
Requerido
Cadena
Cuerpo del mensaje
date_created
Requerido
Cadena - fecha-hora
Fecha de creación del mensaje
from
Requerido
Remitente del mensaje
display_name
Requerido
Cadena
Nombre para mostrar del remitente
type
Requerido
Cadena
Tipo de remitente:
CUSTOMER_USER, SHOP_USER, OPERATOR_USER
id
Requerido
Cadena
Identificador del mensaje
to
Requerido
Destinatarios del mensaje
display_name
Requerido
Cadena
Nombre para mostrar del destinatario
type
Requerido
Cadena
Tipo del destinatario:
CUSTOMER, SHOP, OPERATOR
metadata
Requerido
Metadatos del hilo
last_message_date
Requerido
Cadena - fecha-hora
Fecha del último mensaje
last_sender
Requerido
Remitente del último mensaje
display_name
Requerido
Cadena
Nombre para mostrar del remitente
type
Requerido
Cadena
Tipo de remitente:
CUSTOMER_USER, SHOP_USER, OPERATOR_USER
total_count
Requerido
Entero
Número de mensajes en el hilo
topic
Requerido
Tema del hilo
type
Requerido
Cadena
Tipo de tema:
FREE_TEXT, REASON_CODE
value
Requerido
Cadena
Valor del tema
Respuesta


              
            
GET - Listado hilos
URL
/seller/api/inbox/threads
DESCRIPCIÓN

Lista de todos los hilos

Se puede recuperar los hilos vinculados de una entidad específica, utilizando tanto entity_type como entity_id.

Los valores disponibles para entity_type son:

    MMP_ORDER: para hilos de pedidos.

Este recurso utiliza búsqueda de paginación. El valor predeterminado para el límite de parámetros es 50.

Nota: este recurso admite la paginación de desplazamiento (consultar)

PARÁMETROS CONSULTA
entity_type
Opcional
Cadena
Tipo de entidad para incluir en el resultado
entity_id
Opcional
Cadena
Lista separada por comas de identificadores de entidad
CÓDIGOS RETORNO

200 - OK

SALIDA (RESPUESTA)
data
Requerido
Página de datos
authorized_participants
Requerido
Participantes autorizados
display_name
Requerido
Cadena
Nombre del participante
type
Requerido
Cadena
Tipo de participante:
CUSTOMER, SHOP, OPERATOR
current_participants
Requerido
Participantes actuales del hilo
display_name
Requerido
Cadena
Nombre del participante
type
Requerido
Cadena
Tipo de participante:
CUSTOMER, SHOP, OPERATOR
date_created
Requerido
Cadena - fecha-hora
Fecha de creación del hilo
date_updated
Requerido
Cadena - fecha-hora
Fecha de actualización del hilo
entities
Opcional
Entidades de hilo
id
Requerido
Cadena
Identificador de la entidad
label
Requerido
Cadena
Etiqueta de entidad
type
Requerido
Cadena
Tipo de entidad
id
Requerido
Cadena
Identificador del hilo
metadata
Requerido
Metadatos del hilo
last_message_date
Requerido
Cadena - fecha-hora
Fecha del último mensaje
last_sender
Requerido
Remitente del último mensaje
display_name
Requerido
Cadena
Nombre para mostrar del remitente
type
Requerido
Cadena
Tipo de remitente:
CUSTOMER_USER, SHOP_USER, OPERATOR_USER
total_count
Requerido
Entero
Número de mensajes en el hilo
topic
Requerido
Tema del hilo
type
Requerido
Cadena
Tipo de tema:
FREE_TEXT, REASON_CODE
value
Requerido
Cadena
Valor del tema
next_page_token
Opcional
Cadena
Token para acceder a la página siguiente. Ausente si la página actual es la última.
previous_page_token
Opcional
Cadena
Token para acceder a la página anterior. Ausente si la página actual es la primera.
Respuesta


              
            
POST - Responder un hilo
URL
/seller/api/inbox/threads/{thread_id}/message
DESCRIPCIÓN

Responder un hilo

Máximo de 1000 mensajes en un hilo

PARÁMETROS RUTA
thread_id
Requerido
Cadena
Identificador del hilo
CÓDIGOS RETORNO

201 - Created

ENTRADA (CUERPO)
files
Opcional
Array[Cadena - Binario]
Lista de archivos adjuntos para el mensaje
message_input
Requerido
Datos del mensaje
body
Requerido
Cadena
Cuerpo del mensaje
topic
Requerido
Tema para el hilo.
type
Requerido
Cadena
Tipo de tema:
FREE_TEXT
value
Requerido
Cadena
Valor del tema

                                  
                              
SALIDA (RESPUESTA)
message_id
Opcional
Cadena
Identificador del mensaje
thread_id
Opcional
Cadena
Identificador del hilo
Respuesta


              
            
GET - Descargar un adjunto
URL
/seller/api/inbox/threads/{attachment_id}/download
DESCRIPCIÓN

Descargar un adjunto

PARÁMETROS RUTA
attachment_id
Requerido
Cadena
El identificador del archivo adjunto que se va a recuperar.
CÓDIGOS RETORNO

200 - OK

POST - Crear un hilo en un pedido
URL
/seller/api/orders/{order_id}/threads
DESCRIPCIÓN

Crear un hilo en un pedido

PARÁMETROS RUTA
order_id
Requerido
Cadena
Identificador de pedido
CÓDIGOS RETORNO

201 - Created

ENTRADA (CUERPO)
files
Opcional
Array[Cadena - Binario]
Lista de archivos adjuntos para el mensaje
thread_input
Requerido
Datos del mensaje
body
Requerido
Cadena
Cuerpo del mensaje
topic
Requerido
Tema para el hilo.
type
Requerido
Cadena
Tipo de tema:
FREE_TEXT
value
Requerido
Cadena
Valor del tema

                                  
                              
SALIDA (RESPUESTA)
message_id
Opcional
Cadena
Identificador del mensaje
thread_id
Opcional
Cadena
Identificador del hilo
Respuesta


              
            
Pedidos
GET - Listado pedidos
URL
/seller/api/orders
DESCRIPCIÓN

Listar pedidos

Nota: este recurso admite el parámetro de configuración regional (consultar)

Nota: este recurso admite la paginación de desplazamiento (consultar)

PARÁMETROS CONSULTA
order_ids
Opcional
Cadena
Una lista de ids de pedidos separados por comas.
order_references_for_customer
Opcional
Cadena
Una lista separada por comas de referencias de pedidos para el cliente.
order_references_for_seller
Opcional
Cadena
Una lista separada por comas de referencias de pedidos para el vendedor.
order_state_codes
Opcional
Cadena
Una lista separada por comas de códigos de estado del pedido.
channel_codes
Opcional
Cadena
Una lista de códigos de canal separados por comas.
only_null_channel
Opcional
Booleano
Devolver solo pedidos sin canal. Si devuelve true ignora el channel_codes
Por defecto es false
start_date
Opcional
Cadena - fecha-hora
Filtro desde (fecha de creación de pedido)
end_date
Opcional
Cadena - fecha-hora
Filtro hasta (fecha de creación de pedido)
start_update_date
Opcional
Cadena - fecha-hora
Filtro desde (fecha de actualización de pedido)
end_update_date
Opcional
Cadena - fecha-hora
Filtro hasta (fecha de actualización de pedido)
paginate
Opcional
Booleano
Control uso de paginación
Por defecto es true
ORDEN LISTADO

order_id (Por defecto) - Ordena por id de pedido de forma descendente. DESC (Por defecto)

CÓDIGOS RETORNO

200 - OK

SALIDA (RESPUESTA)
orders
Requerido
Lista de pedidos
acceptance_decision_date
Opcional
Cadena - fecha-hora
Fecha en la que se aceptó el pedido.
can_cancel
Requerido
Booleano
Indica si se puede cancelar el pedido.
can_shop_ship
Requerido
Booleano
Indica si las tiendas pueden o no enviar pedidos.
channel
Opcional
El canal del pedido.
code
Requerido
Cadena
Código canal.
label
Requerido
Cadena
Etiqueta canal.
commercial_id
Requerido
String
Identificador de pedido comercial.
created_date
Requerido
Cadena - fecha-hora
Fecha creación del pedido
currency_iso_code
Requerido
Cadena
Moneda de la tienda (formato iso)
customer
Requerido
Información del cliente del pedido
accounting_contact
Optional
Datos relacionados con el contacto de facturación
customer_id
Requerido
Cadena
Identificador del cliente
firstname
Requerido
Cadena
Nombre del cliente
lastname
Requerido
Cadena
Apellido del cliente
locale
Opcional
Cadena
Configuración regional del cliente
billing_address
Requerido
Dirección de facturación del cliente
city
Requerido
Cadena
Ciudad del cliente de facturación
country
Requerido
Cadena
País del cliente de facturación
country_iso_code
Requerido
Cadena
Código ISO del país del cliente de facturación
firstname
Requerido
Cadena
Nombre del cliente de facturación
lastname
Requerido
Cadena
Apellido del cliente de facturación
company
Opcional
Cadena
Empresa del cliente de facturación
phone
Opcional
Cadena
Teléfono del cliente de facturación
phone_secondary
Opcional
Cadena
Segundo teléfono del cliente de facturación
state
Opcional
Cadena
Provincia del cliente de facturación
street_1
Requerido
Cadena
Dirección del cliente de facturación
street_2
Opcional
Cadena
Dirección complementaria del cliente de facturación
zip_code
Opcional
Cadena
Código postal del cliente de facturación
customer_id
Requerido
Cadena
Identificador del cliente
delivery_contact
Opcional
Datos relacionados con el contacto de entrega en la organización
customer_id
Requerido
Cadena
Identificador del cliente
firstname
Requerido
Cadena
Nombre del contacto de entrega
lastname
Requerido
Cadena
Apellido del contacto de entrega
locale
Opcional
Cadena
Configuración regional del contacto de entrega
firstname
Requerido
Cadena
Nombre del cliente
lastname
Requerido
Cadena
Apellido del cliente
locale
Opcional
Cadena
Configuración regional del cliente
shipping_address
Requerido
Dirección de envío del cliente
city
Requerido
Cadena
Ciudad de envío
company
Opcional
Cadena
Empresa del cliente de envío
country
Requerido
Cadena
País de la dirección de envío
country_iso_code
Requerido
Cadena
Código ISO del país de la dirección de envío
firstname
Opcional
Cadena
Nombre del cliente de envío
lastname
Requerido
Cadena
Apellido del cliente de envío
phone
Opcional
Cadena
Teléfono del cliente de envío
phone_secondary
Opcional
Cadena
Segundo teléfono del cliente de envío
state
Opcional
Cadena
Provincia de la dirección de envío
street_1
Requerido
Cadena
Dirección de envío
street_2
Opcional
Cadena
Dirección complementaria de envío
zip_code
Opcional
Cadena
Código postal de la dirección de envío
customer_debited_date
Opcional
Cadena - fecha-hora
La fecha de pago del pedido por parte del cliente.
customer_notification_email
Opcional
Cadena
Correo electrónico de cliente que se puede utilizar para notificaciones
delivery_date
Opcional
Fecha prevista de entrega del pedido
earliest
Requerido
Cadena - fecha-hora
Fecha de entrega del pedido más temprana
latest
Requerido
Cadena - fecha-hora
Fecha de entrega del pedido más tardía
has_invoice
Requerido
Booleano
Muestra si hay una factura disponible para este pedido
last_updated_date
Requerido
Cadena - fecha-hora
Última fecha de actualización del pedido
leadtime_to_ship
Requerido
Entero
Plazo de entrega del pedido para enviar
order_id
Requerido
Cadena
Identificador de pedido
order_lines
Requerido
Líneas de pedido
can_refund
Requerido
Booleano
Indica si se puede reembolsar el importe total de la línea de pedido
cancelations
Requerido
Lista de cancelaciones
amount
Opcional
Decimales
Importe de la cancelación
quantity
Opcional
Entero
La cantidad de productos cancelados (esta cantidad es solo informativa)
created_date
Requerido
Cadena - fecha-hora
Fecha de creación de la línea de pedido
offer_sku
Requerido
Cadena
Sku de oferta asociada (este es el sku de la oferta definida por la tienda)
order_line_id
Requerido
Cadena
Identificador de la línea de pedido
order_line_index
Requerido
Entero
Índice de la línea en el pedido
price
Requerido
Decimales
Precio de la línea de pedido
price_unit
Requerido
Decimales
Precio por unidad de la línea de pedido
product_medias
Requerido
Lista de todos los medios del producto asociados
media_url
Requerido
Cadena
URL del medio
mime_type
Requerido
Cadena
MIME TYPE del medio (.jpg, .png ...)
product_ean
Requerido
Cadena
EAN del producto
product_sku
Requerido
Cadena
Código del producto
product_title
Requerido
Cadena
Título del producto
quantity
Requerido
Entero
Cantidad de producto
refunds
Requerido
Lista de reembolsos
amount
Opcional
Decimales
Cantidad reembolsada
commission_amount
Requerido
Decimales
Importe de la comisión del reembolso
commission_tax_amount
Opcional
Decimales
Impuestos del importe de comisión del reembolso
commission_taxes
Requerido
Lista de impuestos del importe de comisión del reembolso
amount
Requerido
Decimales
Importe de los impuestos
code
Requerido
Cadena
Código de impuestos
commission_total_amount
Requerido
Decimales
Total de comisión del reembolso (con impuestos incluidos)
created_date
Requerido
Cadena - fecha-hora
Fecha de creación del reembolso
id
Requerido
Cadena
Identificador del reembolso
quantity
Opcional
Entero
Número de productos reembolsados
reason_code
Requerido
Cadena
Código de motivo del reembolso
shipping_amount
Opcional
Decimales
Cantidad de reembolso del envío
state
Requerido
Cadena
Estado del reembolso
transaction_date
Requerido
Cadena - fecha-hora
Fecha de transacción del pago del reembolso
shipped_date
Opcional
Cadena - fecha-hora
Fecha de envío de la línea de pedido
shipping_price
Requerido
Decimales
Precio de envío de la línea de pedido
taxes
Opcional
Lista de impuestos aplicados sobre el precio del producto
amount
Requerido
Decimales
Importe del impuesto
code
Requerido
Cadena
Código de impuestos
rate
Opcional
Decimales
Tasa de impuesto
total_commission
Requerido
Decimales
Comisión total de la línea de pedido
total_price
Requerido
Decimales
Precio de la línea de pedido con precio de envío.
order_state
Requerido
Cadena
Estado del pedido
ORDER_ACCEPTED, ORDER_PENDING, ORDER_CANCELLED, ORDER_SHIPPED, ORDER_DELIVERED, ORDER_REQUEST_RETURN, ORDER_RETURN_RECEIVED, ORDER_CLOSED
order_tax_mode
Requerido
Cadena
En caso de que no haya impuestos, los precios mostrarán el mismo monto en los modos TAX_EXCLUDED y TAX_INCLUDED. El modo de impuestos solo es útil si los impuestos se especifican en el pedido.
Posibles valores:
  • TAX_EXCLUDED: los campos de precio se muestran sin impuestos.
  • TAX_INCLUDED: los campos de precio incluyen los impuesto.
payment_type
Requerido
Cadena
El tipo de pago utilizado en el pedido
price
Requerido
Decimales
Precio del pedido
references
Opcional
Referencias del pedido
order_reference_for_customer
Opcional
Cadena
Referencia de pedido para el cliente
order_reference_for_seller
Opcional
Cadena
Referencia de pedido para el vendedor
shipping_company
Opcional
Cadena
Empresa de transporte
shipping_price
Requerido
Decimales
Precio de envío del pedido
shipping_tracking
Opcional
Cadena
Seguimiento de envío
shipping_type_label
Requerido
Cadena
Etiqueta del tipo de envío
shipping_zone_code
Requerido
Cadena
Código de zona de envío
shipping_zone_label
Requerido
Cadena
Etiqueta de la zona de envío
total_commission
Requerido
Decimales
Comisión total del pedido
total_price
Requerido
Decimales
Total precio del pedido
transaction_date
Opcional
Cadena - fecha-hora
Fecha de la transacción del pago
transaction_number
Opcional
Cadena
Número de transacción de pago
total_count
Requerido
Entero
Total de pedidos
Respuesta


              
              
            
PUT - Aceptar o rechazar líneas de pedido
URL
/seller/api/orders/{order_id}/accept
DESCRIPCIÓN

Aceptar o rechazar líneas de pedido

Aceptar o rechazar líneas de pedido en el estado ORDER_ACCEPTED

PARÁMETROS RUTA
order_ids
Requerido
Cadena
Identificador de pedido
CÓDIGOS RETORNO

204 - No Content

ENTRADA (CUERPO)
order_lines
Requerido
Lista de líneas de pedido
accepted
Requerido
Booleano
Booleano que indica si la línea de pedido es aceptada o cancelada
total_refuse
Requerido
Entero
Total productos rechazados
id
Requerido
Cadena
Identificador de la línea de pedido
cancellation_reason
Opcional
Cadena
Motivo de cancelación. Los valores pueden ser "error_stock" o "solicitado_cancelacion". Solo se usa cuando todas las líneas del pedido han sido canceladas.
Solicitud


              
            
PUT - Actualizar la información de seguimiento del transportista de un pedido
URL
/seller/api/orders/{order_id}/tracking
DESCRIPCIÓN

Actualizar la información de seguimiento del transportista para un pedido específico.

PARÁMETROS RUTA
order_ids
Requerido
Cadena
Identificador de pedido
CÓDIGOS RETORNO

204 - No Content

ENTRADA (CUERPO)
carrier_code
Opcional
Cadena
El código de transportista
carrier_name
Opcional
Cadena
El nombre de transportista
tracking_number
Opcional
Cadena
El número de seguimiento del transportista
Solicitud


              
              
            
PUT - Validar el envío de un pedido
URL
/seller/api/orders/{order_id}/ship
DESCRIPCIÓN

Validar el envío de un pedido

Recomendado: Cada vez que se ingresa el número de seguimiento

PARÁMETROS RUTA
order_id
Requerido
Cadena
Identificador de pedido
CÓDIGOS RETORNO

204 - No Content

PUT - Devolver líneas de pedido
URL
/seller/api/orders/{order_id}/return
DESCRIPCIÓN

Devolver líneas de un pedido

A tener en cuenta:

  • Si no especifica cantidad de reembolso de producto y transporte se reembolsará el total del producto sin reembolsar el coste de transporte.
  • Si solo se especifica cantidad de transporte solo se reembolsará la cantidad de transporte sin tener en cuenta el coste del zapato.
  • Si la cantidad a reembolsar es 0 se pondrá el valor a 0 y los reembolsos si no se han comunicado se cancelarán.
PARÁMETROS RUTA
order_id
Requerido
Cadena
Identificador de pedido
CÓDIGOS RETORNO

204 - No Content

ENTRADA (CUERPO)
order_lines
Requerido
Lista de líneas de pedido
total_return
Opcional
Entero
Número de líneas a devolver
total_refunded
Opcional
Decimales
Total a reembolsar del producto
total_shipping
Opcional
Decimales
Total a reembolsar del transporte
id
Requerido
Entero
Id de la línea de pedido
Solicitud


              
            
GET - Listado facturas de pedidos
URL
/seller/api/orders/documents
DESCRIPCIÓN

Enumera los documentos del pedido.

Devuelve una lista de todos los documentos disponibles en el pedido.

PARÁMETROS CONSULTA
order_ids
Requerido
Cadena
Identificadores de los pedidos, utiliza una coma como separador
CÓDIGOS RETORNO

200 - OK

SALIDA (RESPUESTA)
order_documents
Requerido
Detalles del documento
date_uploaded
Opcional
Cadena - fecha-hora
Fecha subida del documento
file_name
Requerido
Cadena
Nombre del documento
file_size
Opcional
Entero
Tamaño del documento
id
Opcional
Entero
Identificador del documento
order_id
Requerido
Cadena
Identificador del pedido que tiene el documento
type
Requerido
Cadena
Tipo de documento
Respuesta


              
            
GET - Descargar facturas de pedidos
URL
/seller/api/orders/documents/download
DESCRIPCIÓN

Descarga una o varias facturas de tus pedidos.

  • Si se especifica una lista de identificadores de facturas, solo se descargan estas facturas.
    • Si se especifica más de un identificador de factura, las facturas se comprimen en un archivo ZIP.
    • Si se especifica solo un identificador de factura, el documento no se comprimirá.
  • Si se especifica una lista de identificadores de pedidos, se descargan todas las facturas de esos pedidos.

Cuando se recuperan las facturas, se empaquetan en un archivo ZIP, excepto cuando solo se especifica una identificación de documento. La estructura de árbol de este archivo es la siguiente:

documento_zip
|
|__ order_id_x /
|   |__ factura.pdf
|__ order_id_y /
|   |__ factura.pdf
                  
PARÁMETROS CONSULTA
order_ids
Opcional
Cadena
Lista de identificadores de pedidos (separados por una coma)
document_ids
Opcional
Cadena
Lista de identificadores de facturas
CÓDIGOS RETORNO

200 - OK

SALIDA (RESPUESTA)
Esta API devuelve contenido application/octet-stream
POST - Adjuntar factura a un pedido
URL
/seller/api/orders/{order_id}/documents
DESCRIPCIÓN

Adjuntar una factura a un pedido.

Solo se admiten documentos del tipo: pdf, png, jpg.

Un pedido puede tener solo una factura adjunta.

En la salida de la API solo incluimos documentos con errores.

PARÁMETROS RUTA
order_id
Requerido
Cadena
Identificador de pedido
CÓDIGOS RETORNO

200 - OK

ENTRADA (CUERPO)
files
Requerido
Array[Cadena - Binario]
Las facturas que se van a cargar. Utilice multipart/form-data con el nombre ´files´. Los nombres de archivo deben contener solo caracteres US-ASCII.
order_documents
Requerido
Detalles de la lista de facturas que se cargarán
file_name
Requerido
Cadena
Nombre del fichero
type_code
Requerido
Cadena
Tipo de documento (INVOICE)
SALIDA (RESPUESTA)
errors_count
Opcional
Entero
La cantidad de documentos en estado de error
order_documents
Requerido
Lista de informes de errores
errors
Requerido
Errores sobre el objeto de entrada
code
Requerido
Cadena
Código de error
field
Requerido
Cadena
Nombre del campo en el objeto de entrada
message
Requerido
Cadena
Mensaje de error
Respuesta


              
            
DELETE - Eliminar factura de pedido
URL
/seller/api/orders/documents/{document_id}
DESCRIPCIÓN

Eliminar la factura de pedido

PARÁMETROS RUTA
document_id
Requerido
Entero
Identificador de factura a borrar
CÓDIGOS RETORNO

204 - No Content

Productos
Información general de productos

Aclaraciones:

  • La longitud de la combinación de las columnas TITLE MODEL y COLOR no debe superar los 60 caracteres
  • Las columnas PRICE y PRICE_DISCOUNT deben tener el siguiente formato: 0.00 (Separación decimal con punto)
  • Si alguno de los campos obligatorios descritos en la sección "Formato CSV" no aparece en el csv o no contiene datos, no se creará dicho producto
  • Aunque no es obligatorio añadir una imagen para crear el producto en el sistema, es recomendable añadir al menos una imagen. Más información en la sección "Formato imágenes"
  • Los productos sin imágenes no serán publicados en el marketplace
DATOS MINIMOS (Formato CSV)
DELIMITADOR
Coma o punto y coma.
CODIFICACIÓN
UTF-8.
VALORES
Los valores no deben contener ni coma ni punto y coma.
Los valores no deben contener ni coma ni punto y coma.
COLUMNAS
TITLE MODEL
Requerido
STRING
Obligatorio título LIMPIO, sin categorías, géneros, color, material, marca, etc.
COLOR
Requerido
STRING
PRICE
Requerido
FLOAT
Es obligatorio si no hay un Price_discount. En caso de estar ambos Price debe de ser siempre superior a Price_Discount
PRICE_DISCOUNT
Requerido
FLOAT
Es obligatorio si no hay un Price. En caso de estar ambos Price_discount debe de ser siempre inferior a Price
STOCK
Requerido
INT
EAN
Requerido
STRING
Código de barras
SKU
Requerido
STRING
Código de referencia único por modelo, color y talla
PARENT_SKU
Requerido
STRING
CATEGORY
Requerido
STRING
BRAND
Requerido
STRING
SIZE
Requerido
STRING
Es obligatorio para categorías de Moda y calzado. En categoría Complementos solo si tienen tallas existentes, para resto de categorías se recomienda usar DIMENSION
SIZE
Opcional
STRING
DIMENSION
Opcional
STRING
No usar en categorías de Moda y calzado. En resto de categorías usar si son valores de tallas que no existen en el atributo SIZE.
COLOR
Opcional
0
FLAVOR
Requerido
STRING
STRAP COLOR
Requerido
STRING

TITLE MODEL COLOR PRICE PRICE_DISCOUNT STOCK EAN SKU PARENT_SKU CATEGORY BRAND SIZE SIZE DIMENSION COLOR FLAVOR STRAP COLOR

Descargar ejemplo (DATOS MINIMOS)

DATOS EXTENDIDOS (Formato CSV)
DELIMITADOR
Coma o punto y coma.
CODIFICACIÓN
UTF-8.
VALORES
Los valores no deben contener ni coma ni punto y coma.
COLUMNAS
TITLE MODEL
Requerido
STRING
Obligatorio título LIMPIO, sin categorías, géneros, color, material, marca, etc.
COLOR
Requerido
STRING
PRICE
Requerido
FLOAT
Es obligatorio si no hay un Price_discount. En caso de estar ambos Price debe de ser siempre superior a Price_Discount
PRICE_DISCOUNT
Requerido
FLOAT
Es obligatorio si no hay un Price. En caso de estar ambos Price_discount debe de ser siempre inferior a Price
STOCK
Requerido
INT
EAN
Requerido
STRING
Código de barras
SKU
Requerido
STRING
Código de referencia único por modelo, color y talla
PARENT_SKU
Requerido
STRING
CATEGORY
Requerido
STRING
BRAND
Requerido
STRING
SIZE
Requerido
STRING
Es obligatorio para categorías de Moda y calzado. En categoría Complementos solo si tienen tallas existentes, para resto de categorías se recomienda usar DIMENSION
SIZE
Opcional
STRING
DIMENSION
Opcional
STRING
No usar en categorías de Moda y calzado. En resto de categorías usar si son valores de tallas que no existen en el atributo SIZE.
SEASON
Opcional
0
UPPER
Opcional
0
LINING
Opcional
0
INSOLE
Opcional
0
OUTSOLE
Opcional
0
MADE IN
Opcional
0
CLOSURE TYPE
Opcional
0
HEEL HEIGHT
Opcional
0
PLATFORM HEIGHT
Opcional
0
UPPER HEIGHT
Opcional
0
LICENCE
Opcional
0
OTHER DETAILS
Opcional
0
TYPE OF TOE
Opcional
0
COLOR
Opcional
0
WEIGHT
Opcional
0
HEAVY SIZE
Opcional
0
WIDTH
Opcional
0
LONG
Opcional
0
HIGH
Opcional
0
BENEFIT
Opcional
STRING
ITEM FORM
Opcional
STRING
MADE IN
Opcional
STRING
DIET TYPE
Opcional
STRING
CONTAINER TYPE
Opcional
STRING
FLAVOR
Opcional
FORMULA 1 TEAM
Opcional
STRING
EUROPEAN BASKETBALL TEAMS
Opcional
STRING
INTERNATIONAL SOCCER TEAMS
Opcional
STRING
LOCAL SOCCER TEAMS
Opcional
STRING
NATIONAL SOCCER TEAMS
Opcional
STRING
GEM TYPE
Opcional
STRING
BALL SIZE (CMS)
Opcional
COLLECTION
Opcional
STRING
MATERIAL
Opcional
STRING
WOOL TYPE
Opcional
STRING
TYPE OF SKIN
Opcional
STRING
SETTING TYPE
Opcional
STRING
SHAPE
Opcional
STRING
ADORNMENT FUNCTION
Opcional
STRING
PATTERN NAME
Opcional
STRING
SURFACE RECOMMENDATION
Opcional
STRING
REUSABLE
Opcional
STRING
ISSUE
Opcional
STRING
FINISH TYPE
Opcional
STRING
INSTALLATION TYPE
Opcional
STRING
CHANCE
Opcional
STRING
THEME
Opcional
STRING
ITEM LENGTH DESCRIPTION
Opcional
STRING
NECK STYLE
Opcional
STRING
NECK STYLE
Opcional
STRING
CARE INSTRUCTIONS
Opcional
STRING
CHARACTERISTICS
Opcional
STRING
ROOM
Opcional
STRING
SUPPORT MATERIAL
Opcional
STRING
STANDARD SIZE
Opcional
MANUFACTURING TYPE
Opcional
STRING
FABRIC TYPE
Opcional
STRING
INDOOR-OUTDOOR USE
Opcional
STRING
SPECIAL FEATURES
Opcional
STRING
RECOMMENDED SPECIES
Opcional
STRING
THICKNESS
Opcional
LENGTH (CM)
Opcional
FILLING MATERIAL
Opcional
STRING
BREED RECOMMENDATION
Opcional
STRING
ITEM FIRMNESS DESCRIPTION
Opcional
STRING
AGE RANGE DESCRIPTION
Opcional
STRING
SEASONS
Opcional
STRING
STYLE
Opcional
STRING
LINING MATERIAL
Opcional
STRING
STANDARD MEASUREMENTS
Opcional
BENEFITS
Opcional
STRING
PART OF THE BODY INTENDED FOR USE
Opcional
STRING
NO MATERIAL TYPE
Opcional
STRING
AROMA
Opcional
WATER RESISTANCE LEVEL
Opcional
STRING
RECOMMENDED PRODUCT USES
Opcional
STRING
HEIGHT
Opcional
WIDTH
Opcional
INCLUDED COMPONENTS
Opcional
STRING
DOOR STYLE
Opcional
STRING
DEPTH
Opcional
BACK MATERIAL TYPE
Opcional
STRING
MOUNTING TYPE
Opcional
STRING
WHEEL TYPE
Opcional
STRING
LIFE JACKET TYPE
Opcional
STRING
BALL SIZE
Opcional
CABLE FEATURE
Opcional
STRING
CONNECTIVITY
Opcional
STRING
AUDIO CONNECTOR (JACK)
Opcional
STRING
NOISE CONTROL
Opcional
STRING
COMPATIBLE DEVICES
Opcional
STRING
HEADPHONE STYLE
Opcional
STRING
AGE RANGE
Opcional
STRING
CONTROL METHOD
Opcional
STRING
CONTROL TYPE
Opcional
STRING
WIRELESS TYPE
Opcional
STRING
RECOMMENDED USE
Opcional
STRING
TYPE OF SPORT
Opcional
STRING
WEIGHT (KGS)
Opcional
FRAME MATERIAL
Opcional
STRING
AGE FROM-TO (MONTHS)
Opcional
STRING
GRIP TYPE
Opcional
STRING
PRINT
Opcional
STRING
SPECIAL SIZES
Opcional
STRING
LOCK TYPE
Opcional
STRING
SKILL LEVEL
Opcional
STRING
WAIST
Opcional
STRING
SLEEVE TYPE
Opcional
STRING
BRACE TYPE
Opcional
STRING
GENDER
Opcional
STRING
WHEEL SIZE (INCHES)
Opcional
WHEEL MATERIAL
Opcional
STRING
FRAME SIZE (CMS)
Opcional
BRAKE TYPE
Opcional
STRING
SOURCE FEED
Opcional
STRING
RESISTANCE MECHANISM
Opcional
STRING
TRANSMISSION SYSTEM
Opcional
STRING
LOWER FORM
Opcional
STRING
TOP FORM
Opcional
STRING
POCKET DESCRIPTION
Opcional
STRING
NECKLINE
Opcional
STRING
SLEEVE LENGTH
Opcional
STRING
CUTTING TYPE
Opcional
STRING
BEAUTIFICATION FUNCTION
Opcional
STRING
BLADE MATERIAL
Opcional
STRING
HANDLE MATERIAL
Opcional
STRING
BACKPACK DESIGN
Opcional
STRING
CASING TYPE
Opcional
STRING
SCHOOL TYPE
Opcional
STRING
DESIGN
Opcional
STRING
BODY SHAPE
Opcional
STRING
HAND ORIENTATION
Opcional
STRING
POINT TYPE
Opcional
STRING
INK COLOR
Requerido
STRING
OPERATION MODE
Opcional
STRING
SHOE MATERIAL
Opcional
STRING
SOLE THICKNESS
Opcional
STRING
WATERPROOFNESS
Opcional
STRING
OUTER MATERIAL
Opcional
STRING
ACCESS LOCATION
Opcional
STRING
SPECIFIC USE
Opcional
STRING
EXTERIOR FINISH
Opcional
STRING
FILTER TYPE
Opcional
STRING
BATTERY DESCRIPTION
Opcional
STRING
HEEL TYPE
Opcional
STRING
CYCLING SHOE TYPE
Opcional
STRING
TYPE OF DANCE
Opcional
STRING
WALKING STYLE
Opcional
STRING
BRIDGE TYPE
Opcional
STRING
QUANTITY OF PRODUCTS IN THE PACK
Opcional
CONTROLLER TYPE
Opcional
STRING
FISHING TECHNIQUE
Opcional
STRING
FORM FACTOR
Opcional
STRING
WALLET COMPARTMENT TYPE
Opcional
STRING
SPECIAL FEATURE
Opcional
STRING
TOP STYLE
Opcional
STRING
CURTAIN MATERIAL
Opcional
STRING
OPACITY
Opcional
STRING
PATTERN
Opcional
STRING
CURTAIN ANIMAL THEME
Opcional
STRING
CURTAIN THEME
Opcional
STRING
TYPE OF ROOM
Opcional
STRING
LENGTH
Opcional
STRING
ROD OR FLEX HARDNESS
Opcional
STRING
ORIENTATION
Opcional
STRING
SURFACE TYPE
Opcional
STRING
MAXIMUM USER WEIGHT (KGS)
Opcional
SCREEN TYPE
Opcional
STRING
FIRMNESS
Opcional
STRING
BOTTOM STYLE
Opcional
STRING
FILLING TYPE
Opcional
STRING
CLAMPING TYPE
Opcional
STRING
LIFESTYLE
Opcional
STRING
EXPECTED USE
Opcional
STRING
PAPER SIZE
Opcional
STRING
RULE TYPE
Opcional
STRING
TREAD TYPE
Opcional
STRING
TIRE TYPE
Opcional
STRING
PANT LENGHT
Opcional
STRING
GARMENT CLOSURE ORIENTATION
Opcional
STRING
WAISTBAND TYPE
Opcional
STRING
SHORTS LENGTH
Opcional
STRING
CONNECTIVITY PROTOCOL
Opcional
STRING
VIDEO CAPTURE RESOLUTION
Opcional
STRING
CONNECTIVITY TECHNOLOGY
Opcional
STRING
ALERT TYPE
Opcional
STRING
POWER SUPPLY TYPE
Opcional
STRING
INDOOR AND OUTDOOR USE
Opcional
STRING
WIRELESS COMMUNICATION STANDARD
Opcional
STRING
FILE FORMAT
Opcional
STRING
WEIGHT (GRS)
Opcional
IMAGE ASPECT RATIO
Opcional
INT
EFFECTIVE VIDEO RESOLUTION (PIXELS)
Opcional
LENS TYPE
Opcional
STRING
EXPOSURE CONTROL TYPE
Opcional
STRING
FOCUS TYPE
Opcional
STRING
IMAGE STABILIZATION TYPE
Opcional
STRING
FLASH MEMORY TYPE
Opcional
STRING
IMAGE CAPTURE SPEED (FPS)
Opcional
VEHICLE TYPE COMPATIBILITY
Opcional
STRING
MAPS
Opcional
STRING
RESOLUTION
Opcional
STRING
OS
Opcional
STRING
TOUCH SCREEN TYPE
Opcional
STRING
DEGREE (IN DEGREES)
Opcional
DESCRIPTION OF LENS CURVATURE
Opcional
ASSEMBLY REQUIRED
Opcional
STRING
SHELF TYPE
Opcional
STRING
RECOMMENDED USES
Opcional
STRING
SHOT
Opcional
STRING
PRODUCT GRADE
Opcional
STRING
AMOUNT
Opcional
RECOMMENDED ROOM
Opcional
STRING
FRAME TYPE
Opcional
STRING
THREAD QUANTITY
Opcional
INT
BLADE EDGE
Opcional
STRING
HEAD TYPE
Opcional
STRING
WALL ART FORM
Opcional
STRING
HEAD SHAPE
Opcional
STRING
BULB BASE
Opcional
STRING
LIGHTING METHOD
Opcional
STRING
MOUNTING LOCATION
Opcional
STRING
BINDING
Opcional
STRING
TARGET AUDIENCE
Opcional
STRING
LUGGAGE VOLUME (LITERS)
Opcional
BACKPACK FEATURES
Opcional
STRING
LAPTOP SIZE (IN INCHES)
Opcional
VOLUME (LITERS)
Opcional
TYPE
Opcional
STRING
FRAME TYPE
Opcional
STRING
TABLE SHAPE
Opcional
STRING
TABLE FRAME MATERIAL
Opcional
STRING
TABLE MATERIAL
Opcional
STRING
BASE TYPE
Opcional
STRING
FORMAT
Opcional
STRING
FLAVOR
Requerido
STRING
CASE DIAMETER (MM)
Opcional
GPS NAVIGATION
Opcional
STRING
OFFER CONDITION SUBTYPE
Opcional
STRING
CASE MATERIAL TYPE
Opcional
STRING
BELT MATERIAL TYPE
Opcional
STRING
INTERNATIONAL PROTECTION INDEX
Opcional
STRING
GENRE DESTINATION
Opcional
STRING
PARTS
Opcional
ANIMAL THEME
Opcional
STRING
OPENING MECHANISM
Opcional
STRING
SHAFT MATERIAL
Opcional
STRING
SPECIFIC USES FOR PRODUCT
Opcional
STRING
SUSPENSION TYPE
Opcional
STRING
MATERIAL CHARACTERISTICS
Opcional
STRING
ORNAMENT
Opcional
STRING
LAMP SHAPE
Opcional
STRING
TONE MATERIAL
Opcional
STRING
MAXIMUM BULB POWER (W)
Opcional
APPLIQUE TYPE
Opcional
STRING
TUNING TYPE
Opcional
STRING
GRIP SIZE
Opcional
STRING
NUMBER OF BUTTONS
Opcional
POWER SOURCE
Opcional
STRING
MOTION DETECTION TECHNOLOGY
Opcional
STRING
POWER SUPPLY
Opcional
STRING
MECHANISM
Opcional
STRING
ZIPPER SIDE
Opcional
STRING
OCCUPATION
Opcional
STRING
REVERSE STYLE
Opcional
STRING
STRUCTURE MATERIAL
Opcional
STRING
RECLINING SEAT OPERATING MECHANISM
Opcional
STRING
RECLINING SEAT OPERATING MODE
Opcional
STRING
MOVEMENT TYPE
Opcional
STRING
CHAIR SIZE
Opcional
STRING
HEALTH BENEFIT
Opcional
STRING
FOOD FEATURE
Opcional
STRING
EXERCISE PHASE
Opcional
STRING
TYPE OF BATTERIES/BATTERIES
Opcional
STRING
STORE CAPACITY
Opcional
STRING
TENT WEIGHT (KGS)
Opcional
STORE LAYOUT
Opcional
STRING
THEMED TOWEL
Opcional
STRING
CLOTHES SILHOUETTE
Opcional
STRING
EXTENT
Opcional
STRING
SCALE
Opcional
INT
MATERIAL CHARACTERISTICS
Opcional
STRING
DECOR
Opcional
STRING
NUMBER OF WHEELS
Opcional
PADLOCK TYPE
Opcional
STRING
AGE
Opcional
BAG WIDTH (CM)
Opcional
BAG WIDTH
Opcional
STRING
LUGGAGE WEIGHT (GRS)
Opcional
NUMBER OF ARTICLES
Opcional
SUITCASE SIZE (CM)
Opcional
FILTER CLASS
Opcional
STRING
ASTM FLUID CLASSIFICATION
Opcional
STRING
AGE RANGE DESCRIPTION
Opcional
STRING
MASK SHAPE
Opcional
STRING
REUSE
Opcional
STRING
SILVER ALLOY
Opcional
STRING
PLATINUM ALLOY
Opcional
STRING
METAL
Opcional
STRING
NUMBER OF STONES
Opcional
BIRTHSTONE
Opcional
STRING
CARATS
Opcional
STRING
TYPE OF WOOD
Opcional
STRING
PEARL SHINE
Opcional
STRING
CARVING QUALITY
Opcional
STRING
PEARL COLOR
Opcional
STRING
DIAMETER (MM)
Opcional
GEM
Opcional
STRING
MOUNT
Opcional
STRING
WEIGHT (IN CARATS)
Opcional
PURITY
Opcional
STRING
TYPE OF PEARL
Opcional
STRING
DEPARTMENT
Opcional
STRING
NUMBER OF GEM STONES
Opcional
RING STYLE
Opcional
STRING
CHAIN TYPE
Opcional
STRING
NECKLACE TYPE
Opcional
STRING
FIXATION
Opcional
STRING
SLOPE TYPE
Opcional
STRING
BRACELET SIZE (INCHES)
Opcional
BRACELET TYPE
Opcional
STRING
BELT WIDTH (MM)
Opcional
STRAP COLOR
Requerido
STRING
STRAP STYLE
Opcional
STRING
STRAP MATERIAL
Opcional
STRING
DIAL COLOR
Opcional
STRING
SPORTS
Opcional
STRING
CASE DIAMETER (MM)
Opcional
BOX STYLE
Opcional
STRING
WATCH STYLE
Opcional
STRING
FUNCTIONS
Opcional
STRING
BOX THICKNESS (MILLIMETERS)
Opcional
BOX MATERIAL
Opcional
STRING
GLASS MATERIAL
Opcional
STRING
ORIGIN
Opcional
STRING
WATER RESISTANCE (METERS)
Opcional
RHINESTONE TYPE
Opcional
STRING
DISPLAY
Opcional
STRING
EMBROIDERY
Opcional
STRING
TISSUE
Opcional
STRING
CUFFS STYLE
Opcional
STRING
NECK SIZE
Opcional
INT
NECK TYPE
Opcional
STRING
ITEM HARDNESS
Opcional
STRING
FRAME STYLE
Opcional
STRING
LENS MATERIAL
Opcional
STRING
FRAME MATERIAL
Opcional
STRING
LENS FEATURES
Opcional
STRING
LENS COLOR
Opcional
STRING
CLOSING
Opcional
STRING
WITHOUT EQUIPMENT
Opcional
STRING
BRA TYPE
Opcional
STRING
WASHING TYPE
Opcional
STRING
CODE
Opcional
STRING
SHAFT WIDTH
Opcional
STRING
HEEL TYPE
Opcional
STRING
COMPATIBLE MATERIAL
Opcional
STRING
SNEAKER TYPE
Opcional
STRING
SOLE TYPE
Opcional
STRING
Image 1
Opcional
STRING
Image 2
Opcional
STRING
Image 3
Opcional
STRING
Image 4
Opcional
STRING
Image 5
Opcional
STRING
Image 6
Opcional
STRING
Image 7
Opcional
STRING
Image 8
Opcional
STRING
GPSRimage_1
Opcional
STRING
GPSRimage_2
Opcional
STRING
GPSRimage_3
Opcional
STRING
CIF_RESPONSABLE
Opcional
STRING

TITLE MODEL COLOR PRICE PRICE_DISCOUNT STOCK EAN SKU PARENT_SKU CATEGORY BRAND SIZE SIZE DIMENSION SEASON UPPER LINING INSOLE OUTSOLE MADE IN CLOSURE TYPE HEEL HEIGHT PLATFORM HEIGHT UPPER HEIGHT LICENCE OTHER DETAILS TYPE OF TOE COLOR WEIGHT HEAVY SIZE WIDTH LONG HIGH BENEFIT ITEM FORM MADE IN DIET TYPE CONTAINER TYPE FLAVOR FORMULA 1 TEAM EUROPEAN BASKETBALL TEAMS INTERNATIONAL SOCCER TEAMS LOCAL SOCCER TEAMS NATIONAL SOCCER TEAMS GEM TYPE BALL SIZE (CMS) COLLECTION MATERIAL WOOL TYPE TYPE OF SKIN SETTING TYPE SHAPE ADORNMENT FUNCTION PATTERN NAME SURFACE RECOMMENDATION REUSABLE ISSUE FINISH TYPE INSTALLATION TYPE CHANCE THEME ITEM LENGTH DESCRIPTION NECK STYLE NECK STYLE CARE INSTRUCTIONS CHARACTERISTICS ROOM SUPPORT MATERIAL STANDARD SIZE MANUFACTURING TYPE FABRIC TYPE INDOOR-OUTDOOR USE SPECIAL FEATURES RECOMMENDED SPECIES THICKNESS LENGTH (CM) FILLING MATERIAL BREED RECOMMENDATION ITEM FIRMNESS DESCRIPTION AGE RANGE DESCRIPTION SEASONS STYLE LINING MATERIAL STANDARD MEASUREMENTS BENEFITS PART OF THE BODY INTENDED FOR USE NO MATERIAL TYPE AROMA WATER RESISTANCE LEVEL RECOMMENDED PRODUCT USES HEIGHT WIDTH INCLUDED COMPONENTS DOOR STYLE DEPTH BACK MATERIAL TYPE MOUNTING TYPE WHEEL TYPE LIFE JACKET TYPE BALL SIZE CABLE FEATURE CONNECTIVITY AUDIO CONNECTOR (JACK) NOISE CONTROL COMPATIBLE DEVICES HEADPHONE STYLE AGE RANGE CONTROL METHOD CONTROL TYPE WIRELESS TYPE RECOMMENDED USE TYPE OF SPORT WEIGHT (KGS) FRAME MATERIAL AGE FROM-TO (MONTHS) GRIP TYPE PRINT SPECIAL SIZES LOCK TYPE SKILL LEVEL WAIST SLEEVE TYPE BRACE TYPE GENDER WHEEL SIZE (INCHES) WHEEL MATERIAL FRAME SIZE (CMS) BRAKE TYPE SOURCE FEED RESISTANCE MECHANISM TRANSMISSION SYSTEM LOWER FORM TOP FORM POCKET DESCRIPTION NECKLINE SLEEVE LENGTH CUTTING TYPE BEAUTIFICATION FUNCTION BLADE MATERIAL HANDLE MATERIAL BACKPACK DESIGN CASING TYPE SCHOOL TYPE DESIGN BODY SHAPE HAND ORIENTATION POINT TYPE INK COLOR OPERATION MODE SHOE MATERIAL SOLE THICKNESS WATERPROOFNESS OUTER MATERIAL ACCESS LOCATION SPECIFIC USE EXTERIOR FINISH FILTER TYPE BATTERY DESCRIPTION HEEL TYPE CYCLING SHOE TYPE TYPE OF DANCE WALKING STYLE BRIDGE TYPE QUANTITY OF PRODUCTS IN THE PACK CONTROLLER TYPE FISHING TECHNIQUE FORM FACTOR WALLET COMPARTMENT TYPE SPECIAL FEATURE TOP STYLE CURTAIN MATERIAL OPACITY PATTERN CURTAIN ANIMAL THEME CURTAIN THEME TYPE OF ROOM LENGTH ROD OR FLEX HARDNESS ORIENTATION SURFACE TYPE MAXIMUM USER WEIGHT (KGS) SCREEN TYPE FIRMNESS BOTTOM STYLE FILLING TYPE CLAMPING TYPE LIFESTYLE EXPECTED USE PAPER SIZE RULE TYPE TREAD TYPE TIRE TYPE PANT LENGHT GARMENT CLOSURE ORIENTATION WAISTBAND TYPE SHORTS LENGTH CONNECTIVITY PROTOCOL VIDEO CAPTURE RESOLUTION CONNECTIVITY TECHNOLOGY ALERT TYPE POWER SUPPLY TYPE INDOOR AND OUTDOOR USE WIRELESS COMMUNICATION STANDARD FILE FORMAT WEIGHT (GRS) IMAGE ASPECT RATIO EFFECTIVE VIDEO RESOLUTION (PIXELS) LENS TYPE EXPOSURE CONTROL TYPE FOCUS TYPE IMAGE STABILIZATION TYPE FLASH MEMORY TYPE IMAGE CAPTURE SPEED (FPS) VEHICLE TYPE COMPATIBILITY MAPS RESOLUTION OS TOUCH SCREEN TYPE DEGREE (IN DEGREES) DESCRIPTION OF LENS CURVATURE ASSEMBLY REQUIRED SHELF TYPE RECOMMENDED USES SHOT PRODUCT GRADE AMOUNT RECOMMENDED ROOM FRAME TYPE THREAD QUANTITY BLADE EDGE HEAD TYPE WALL ART FORM HEAD SHAPE BULB BASE LIGHTING METHOD MOUNTING LOCATION BINDING TARGET AUDIENCE LUGGAGE VOLUME (LITERS) BACKPACK FEATURES LAPTOP SIZE (IN INCHES) VOLUME (LITERS) TYPE FRAME TYPE TABLE SHAPE TABLE FRAME MATERIAL TABLE MATERIAL BASE TYPE FORMAT FLAVOR CASE DIAMETER (MM) GPS NAVIGATION OFFER CONDITION SUBTYPE CASE MATERIAL TYPE BELT MATERIAL TYPE INTERNATIONAL PROTECTION INDEX GENRE DESTINATION PARTS ANIMAL THEME OPENING MECHANISM SHAFT MATERIAL SPECIFIC USES FOR PRODUCT SUSPENSION TYPE MATERIAL CHARACTERISTICS ORNAMENT LAMP SHAPE TONE MATERIAL MAXIMUM BULB POWER (W) APPLIQUE TYPE TUNING TYPE GRIP SIZE NUMBER OF BUTTONS POWER SOURCE MOTION DETECTION TECHNOLOGY POWER SUPPLY MECHANISM ZIPPER SIDE OCCUPATION REVERSE STYLE STRUCTURE MATERIAL RECLINING SEAT OPERATING MECHANISM RECLINING SEAT OPERATING MODE MOVEMENT TYPE CHAIR SIZE HEALTH BENEFIT FOOD FEATURE EXERCISE PHASE TYPE OF BATTERIES/BATTERIES STORE CAPACITY TENT WEIGHT (KGS) STORE LAYOUT THEMED TOWEL CLOTHES SILHOUETTE EXTENT SCALE MATERIAL CHARACTERISTICS DECOR NUMBER OF WHEELS PADLOCK TYPE AGE BAG WIDTH (CM) BAG WIDTH LUGGAGE WEIGHT (GRS) NUMBER OF ARTICLES SUITCASE SIZE (CM) FILTER CLASS ASTM FLUID CLASSIFICATION AGE RANGE DESCRIPTION MASK SHAPE REUSE SILVER ALLOY PLATINUM ALLOY METAL NUMBER OF STONES BIRTHSTONE CARATS TYPE OF WOOD PEARL SHINE CARVING QUALITY PEARL COLOR DIAMETER (MM) GEM MOUNT WEIGHT (IN CARATS) PURITY TYPE OF PEARL DEPARTMENT NUMBER OF GEM STONES RING STYLE CHAIN TYPE NECKLACE TYPE FIXATION SLOPE TYPE BRACELET SIZE (INCHES) BRACELET TYPE BELT WIDTH (MM) STRAP COLOR STRAP STYLE STRAP MATERIAL DIAL COLOR SPORTS CASE DIAMETER (MM) BOX STYLE WATCH STYLE FUNCTIONS BOX THICKNESS (MILLIMETERS) BOX MATERIAL GLASS MATERIAL ORIGIN WATER RESISTANCE (METERS) RHINESTONE TYPE DISPLAY EMBROIDERY TISSUE CUFFS STYLE NECK SIZE NECK TYPE ITEM HARDNESS FRAME STYLE LENS MATERIAL FRAME MATERIAL LENS FEATURES LENS COLOR CLOSING WITHOUT EQUIPMENT BRA TYPE WASHING TYPE CODE SHAFT WIDTH HEEL TYPE COMPATIBLE MATERIAL SNEAKER TYPE SOLE TYPE Image 1 Image 2 Image 3 Image 4 Image 5 Image 6 Image 7 Image 8 GPSRimage_1 GPSRimage_2 GPSRimage_3 CIF_RESPONSABLE

Descargar ejemplo (DATOS EXTENDIDOS)

Valores validos

En esta sección encontrarás los valores validos para poder crear productos en nuestro marketplace.

Selecciona una o varias categorías para ver sus características específicas y descargar un CSV personalizado.

TITLE MODEL COLOR PRICE PRICE_DISCOUNT STOCK EAN SKU PARENT_SKU CATEGORY BRAND SIZE SIZE DIMENSION SEASON UPPER LINING INSOLE OUTSOLE MADE IN CLOSURE TYPE HEEL HEIGHT PLATFORM HEIGHT UPPER HEIGHT LICENCE OTHER DETAILS TYPE OF TOE COLOR WEIGHT HEAVY SIZE WIDTH LONG HIGH BENEFIT ITEM FORM MADE IN DIET TYPE CONTAINER TYPE FLAVOR FORMULA 1 TEAM EUROPEAN BASKETBALL TEAMS INTERNATIONAL SOCCER TEAMS LOCAL SOCCER TEAMS NATIONAL SOCCER TEAMS GEM TYPE BALL SIZE (CMS) COLLECTION MATERIAL WOOL TYPE TYPE OF SKIN SETTING TYPE SHAPE ADORNMENT FUNCTION PATTERN NAME SURFACE RECOMMENDATION REUSABLE ISSUE FINISH TYPE INSTALLATION TYPE CHANCE THEME ITEM LENGTH DESCRIPTION NECK STYLE NECK STYLE CARE INSTRUCTIONS CHARACTERISTICS ROOM SUPPORT MATERIAL STANDARD SIZE MANUFACTURING TYPE FABRIC TYPE INDOOR-OUTDOOR USE SPECIAL FEATURES RECOMMENDED SPECIES THICKNESS LENGTH (CM) FILLING MATERIAL BREED RECOMMENDATION ITEM FIRMNESS DESCRIPTION AGE RANGE DESCRIPTION SEASONS STYLE LINING MATERIAL STANDARD MEASUREMENTS BENEFITS PART OF THE BODY INTENDED FOR USE NO MATERIAL TYPE AROMA WATER RESISTANCE LEVEL RECOMMENDED PRODUCT USES HEIGHT WIDTH INCLUDED COMPONENTS DOOR STYLE DEPTH BACK MATERIAL TYPE MOUNTING TYPE WHEEL TYPE LIFE JACKET TYPE BALL SIZE CABLE FEATURE CONNECTIVITY AUDIO CONNECTOR (JACK) NOISE CONTROL COMPATIBLE DEVICES HEADPHONE STYLE AGE RANGE CONTROL METHOD CONTROL TYPE WIRELESS TYPE RECOMMENDED USE TYPE OF SPORT WEIGHT (KGS) FRAME MATERIAL AGE FROM-TO (MONTHS) GRIP TYPE PRINT SPECIAL SIZES LOCK TYPE SKILL LEVEL WAIST SLEEVE TYPE BRACE TYPE GENDER WHEEL SIZE (INCHES) WHEEL MATERIAL FRAME SIZE (CMS) BRAKE TYPE SOURCE FEED RESISTANCE MECHANISM TRANSMISSION SYSTEM LOWER FORM TOP FORM POCKET DESCRIPTION NECKLINE SLEEVE LENGTH CUTTING TYPE BEAUTIFICATION FUNCTION BLADE MATERIAL HANDLE MATERIAL BACKPACK DESIGN CASING TYPE SCHOOL TYPE DESIGN BODY SHAPE HAND ORIENTATION POINT TYPE INK COLOR OPERATION MODE SHOE MATERIAL SOLE THICKNESS WATERPROOFNESS OUTER MATERIAL ACCESS LOCATION SPECIFIC USE EXTERIOR FINISH FILTER TYPE BATTERY DESCRIPTION HEEL TYPE CYCLING SHOE TYPE TYPE OF DANCE WALKING STYLE BRIDGE TYPE QUANTITY OF PRODUCTS IN THE PACK CONTROLLER TYPE FISHING TECHNIQUE FORM FACTOR WALLET COMPARTMENT TYPE SPECIAL FEATURE TOP STYLE CURTAIN MATERIAL OPACITY PATTERN CURTAIN ANIMAL THEME CURTAIN THEME TYPE OF ROOM LENGTH ROD OR FLEX HARDNESS ORIENTATION SURFACE TYPE MAXIMUM USER WEIGHT (KGS) SCREEN TYPE FIRMNESS BOTTOM STYLE FILLING TYPE CLAMPING TYPE LIFESTYLE EXPECTED USE PAPER SIZE RULE TYPE TREAD TYPE TIRE TYPE PANT LENGHT GARMENT CLOSURE ORIENTATION WAISTBAND TYPE SHORTS LENGTH CONNECTIVITY PROTOCOL VIDEO CAPTURE RESOLUTION CONNECTIVITY TECHNOLOGY ALERT TYPE POWER SUPPLY TYPE INDOOR AND OUTDOOR USE WIRELESS COMMUNICATION STANDARD FILE FORMAT WEIGHT (GRS) IMAGE ASPECT RATIO EFFECTIVE VIDEO RESOLUTION (PIXELS) LENS TYPE EXPOSURE CONTROL TYPE FOCUS TYPE IMAGE STABILIZATION TYPE FLASH MEMORY TYPE IMAGE CAPTURE SPEED (FPS) VEHICLE TYPE COMPATIBILITY MAPS RESOLUTION OS TOUCH SCREEN TYPE DEGREE (IN DEGREES) DESCRIPTION OF LENS CURVATURE ASSEMBLY REQUIRED SHELF TYPE RECOMMENDED USES SHOT PRODUCT GRADE AMOUNT RECOMMENDED ROOM FRAME TYPE THREAD QUANTITY BLADE EDGE HEAD TYPE WALL ART FORM HEAD SHAPE BULB BASE LIGHTING METHOD MOUNTING LOCATION BINDING TARGET AUDIENCE LUGGAGE VOLUME (LITERS) BACKPACK FEATURES LAPTOP SIZE (IN INCHES) VOLUME (LITERS) TYPE FRAME TYPE TABLE SHAPE TABLE FRAME MATERIAL TABLE MATERIAL BASE TYPE FORMAT FLAVOR CASE DIAMETER (MM) GPS NAVIGATION OFFER CONDITION SUBTYPE CASE MATERIAL TYPE BELT MATERIAL TYPE INTERNATIONAL PROTECTION INDEX GENRE DESTINATION PARTS ANIMAL THEME OPENING MECHANISM SHAFT MATERIAL SPECIFIC USES FOR PRODUCT SUSPENSION TYPE MATERIAL CHARACTERISTICS ORNAMENT LAMP SHAPE TONE MATERIAL MAXIMUM BULB POWER (W) APPLIQUE TYPE TUNING TYPE GRIP SIZE NUMBER OF BUTTONS POWER SOURCE MOTION DETECTION TECHNOLOGY POWER SUPPLY MECHANISM ZIPPER SIDE OCCUPATION REVERSE STYLE STRUCTURE MATERIAL RECLINING SEAT OPERATING MECHANISM RECLINING SEAT OPERATING MODE MOVEMENT TYPE CHAIR SIZE HEALTH BENEFIT FOOD FEATURE EXERCISE PHASE TYPE OF BATTERIES/BATTERIES STORE CAPACITY TENT WEIGHT (KGS) STORE LAYOUT THEMED TOWEL CLOTHES SILHOUETTE EXTENT SCALE MATERIAL CHARACTERISTICS DECOR NUMBER OF WHEELS PADLOCK TYPE AGE BAG WIDTH (CM) BAG WIDTH LUGGAGE WEIGHT (GRS) NUMBER OF ARTICLES SUITCASE SIZE (CM) FILTER CLASS ASTM FLUID CLASSIFICATION AGE RANGE DESCRIPTION MASK SHAPE REUSE SILVER ALLOY PLATINUM ALLOY METAL NUMBER OF STONES BIRTHSTONE CARATS TYPE OF WOOD PEARL SHINE CARVING QUALITY PEARL COLOR DIAMETER (MM) GEM MOUNT WEIGHT (IN CARATS) PURITY TYPE OF PEARL DEPARTMENT NUMBER OF GEM STONES RING STYLE CHAIN TYPE NECKLACE TYPE FIXATION SLOPE TYPE BRACELET SIZE (INCHES) BRACELET TYPE BELT WIDTH (MM) STRAP COLOR STRAP STYLE STRAP MATERIAL DIAL COLOR SPORTS CASE DIAMETER (MM) BOX STYLE WATCH STYLE FUNCTIONS BOX THICKNESS (MILLIMETERS) BOX MATERIAL GLASS MATERIAL ORIGIN WATER RESISTANCE (METERS) RHINESTONE TYPE DISPLAY EMBROIDERY TISSUE CUFFS STYLE NECK SIZE NECK TYPE ITEM HARDNESS FRAME STYLE LENS MATERIAL FRAME MATERIAL LENS FEATURES LENS COLOR CLOSING WITHOUT EQUIPMENT BRA TYPE WASHING TYPE CODE SHAFT WIDTH HEEL TYPE COMPATIBLE MATERIAL SNEAKER TYPE SOLE TYPE Image 1 Image 2 Image 3 Image 4 Image 5 Image 6 Image 7 Image 8 GPSRimage_1 GPSRimage_2 GPSRimage_3 CIF_RESPONSABLE

Descargar ejemplo

Formato imágenes

Las imágenes tienen que cumplir los siguientes requisitos:

  • El producto tiene que ocupar como mínimo el 85% de la imagen
  • Las imágenes deben mostrar únicamente el producto que está a la venta, sin accesorios, sin logotipos, sin marcas de agua y sin imágenes integradas
  • Las imágenes pueden contener texto únicamente si éste forma parte del producto
  • Las imágenes principales deben tener un fondo blanco puro, tienen que ser fotografías (no dibujos), y no deben contener accesorios que no vengan incluidos
  • Las imágenes deben tener como mínimo 1000 píxeles en su lado más largo, y 800 píxeles en el más corto para admitir el uso del zoom
  • Las imágenes no deben superar los 3.000 píxeles en su borde más largo
  • El formato de imagen debe ser JPEG, JPG o PNG