Artículos
Actualizar las alternativas de un artículo
Declara qué otros artículos sirven cuando este no está disponible.
items:writeitems:write- 120/min
- Anotación del servidor: Destructiva
- Anotación del servidor: Idempotente
- Requiere confirmación humana
Resultado
generado desde el esquema
Requiere confirmación humana
Pon esta herramienta en la lista de «preguntar antes de ejecutar» de tu cliente. Las anotaciones son pistas que declara el servidor, no garantías: no decidas la aprobación solo por destructiveHint.
Mismo contrato de mode que los accesorios: merge son deltas, replace elimina lo que falta. Devuelve el artículo completo, con alternativeIds tal como quedan ahora, la misma proyección que su GET.
Argumentos
Identificador del artículo.
Límites: longitud mín. 1
merge (por defecto): las operaciones son deltas y lo que no nombres se conserva. replace: la lista enviada es la lista final y todo lo que falte SE ELIMINA.
Opciones disponibles: merge, replace
Operaciones que aplicar. Al menos una.
Límites: mín. 1 elementos
Mostrar atributos hijosOcultar atributos hijos
Alternativa existente. Obligatorio para actualizar o eliminar.
Qué hacer. Si se omite: con alternativeId actualiza, sin él crea.
Opciones disponibles: create, update, delete
Datos alternativos.
Mostrar atributos hijosOcultar atributos hijos
Artículo que sirve como alternativa.
Límites: longitud mín. 1
Cuándo o por qué es válida esta alternativa.
Límites: longitud máx. 1000
Clave de idempotencia elegida por el cliente (se recomienda un UUID). Repetir la misma clave con los mismos argumentos en 24 h devuelve la respuesta almacenada sin volver a ejecutar; con argumentos distintos responde 422. Es la forma segura de reintentar tras un fallo de red.
Límites: longitud mín. 1, longitud máx. 255
Bloqueo optimista: el meta.etag que obtuviste de la lectura de detalle de este recurso (o "*"). Si el recurso ha cambiado desde entonces, la llamada falla con 412 precondition_failed antes de escribir nada; léelo de nuevo y reintenta. Omítelo para escribir sin condiciones.
Límites: longitud mín. 1
Resultado
En un éxito el resultado lleva structuredContent con data y meta. Estos son los atributos de data.
Ver los atributos de data
Identificador único del artículo.
Nombre del artículo.
Referencia SKU del artículo; null si no consta.
Descripción del artículo; null si no consta.
Información adicional del pedido (notas de preparación y entrega); null si no consta.
EAN/código de barras; null si no consta.
Tipo de artículo: fixed (artículo simple) o variant (artículo con variantes).
Opciones disponibles: fixed, variant
Método de cálculo del stock: bulk (a granel, por cantidad) o serialized (por artículos serializados).
Opciones disponibles: bulk, serialized
Identificador de la colección a la que pertenece; null si no está en ninguna.
Nombre de la colección a la que pertenece; null si no está en ninguna.
URLs de las imágenes del artículo.
Precio de venta como cadena decimal "1234.50" (ROUND_HALF_UP); null si no tiene.
Límites: patrón ^-?\d+\.\d{2}$
Importe de la fianza como cadena decimal "1234.50" (ROUND_HALF_UP); null si no tiene.
Límites: patrón ^-?\d+\.\d{2}$
Stock mínimo configurado para las alertas; null si no está configurado.
Número de unidades serializadas registradas del artículo.
Configuración de precios de alquiler; null si no está configurada.
Mostrar atributos hijosOcultar atributos hijos
Modo de precio: periodPrice (precio por periodo), fixedPrice (precio fijo) o pricingStructure (estructura de precios); null si el artículo no tiene ninguno configurado.
Opciones disponibles: periodPrice, fixedPrice, pricingStructure
Precio base de alquiler como cadena decimal "1234.50" (ROUND_HALF_UP); null si no aplica.
Límites: patrón ^-?\d+\.\d{2}$
Unidad de periodo del precio: hour, day, week o month; null si el artículo no tiene ninguna configurada.
Opciones disponibles: hour, day, week, month
Si el artículo admite seguro.
Si el artículo admite descuentos.
Tiempo de margen reservado antes del alquiler; null si no aplica.
Unidad del margen previo: hora o día; null si no aplica.
Opciones disponibles: hour, day
Tiempo de margen reservado después del alquiler; null si no aplica.
Unidad del margen posterior: hour o day; null si no aplica.
Opciones disponibles: hour, day
Propiedades físicas (peso y dimensiones); null si no se han registrado.
Mostrar atributos hijosOcultar atributos hijos
Peso del artículo en kilogramos; null si no está registrado.
Ancho del artículo en centímetros; null si no está registrado.
Altura del artículo en centímetros; null si no consta.
Longitud del artículo en centímetros; null si no consta.
Volumen del artículo en metros cúbicos (m³); null si no está registrado.
Consumo de corriente en amperios; null si no consta.
Potencia en vatios; null si no se ha registrado.
Variantes del artículo (vacío si el artículo es de tipo fixed).
Mostrar atributos hijosOcultar atributos hijos
Identificador único de la variante.
Nombre de la variante.
Precio de alquiler de la variante como cadena decimal "1234.50" (ROUND_HALF_UP).
Límites: patrón ^-?\d+\.\d{2}$
Precio de venta de la variante como cadena decimal "1234.50" (ROUND_HALF_UP); null si no tiene.
Límites: patrón ^-?\d+\.\d{2}$
EAN/código de barras de la variante; null si no consta.
Valores de los campos personalizados por identificador de campo personalizado; las definiciones están en /api.
Fecha de creación en ISO 8601 con desplazamiento.
Fecha de la última actualización en ISO 8601 con desplazamiento.
Valor de reposición del artículo como cadena decimal "1234.50" (ROUND_HALF_UP); null si no consta.
Límites: patrón ^-?\d+\.\d{2}$
Identificadores de los artículos configurados como accesorios de este.
Identificadores de los artículos configurados como alternativas de este.
Un error es un resultado con isError: true y el problema en content[0].; no hay structuredContent. Consulta Errores.
La misma operación por REST
Esta herramienta ejecuta PUT /api/v1/items/{itemId}/alternatives.
Páginas relacionadas
Enlace a esta sección: Páginas relacionadasArtículos
Actualizar las alternativas de un artículo
Declara qué otros artículos sirven cuando este no está disponible.
Guías
Escrituras seguras
Un asistente que puede escribir también puede escribir lo equivocado. Decide qué herramientas necesitan a una persona, reintenta sin duplicar y sabe qué pone en marcha una escritura.
Guías
Errores
Un error de herramienta es un resultado con
isError: truey el problema en el primer bloque de texto. Ramifica por sucode.
¿Te ha resultado útil esta página?