Creación de un producto en la plataforma T1comercios

POST 
/cm/v2/product/commerce/:IDCommerce/product

Este esquema define la estructura necesaria para la creación de un producto en T1COMERCIOS. Permite a los comercios agregar nuevos productos a su catálogo, especificando detalles como SKU, nombre, categoría, marca, descripción, fotos, videos, garantías, precios, canales de venta y variaciones, entre otros.

Pasos previos para crear un producto:

Selecciona la categoría T1:

• Consulta el árbol de categorías de T1Comercios y elige la categoría que mejor se ajuste a tu producto. Asegúrate de seleccionar una categoría de último nivel, es decir, una que no tenga subcategorías.

Consulta el servicio de Matches:

• Con la categoría T1 seleccionada, utiliza el servicio de Matches para obtener las categorías correspondientes en los marketplaces CLAROSHOP, SEARS, y SANBORNS, así como el código SAT del producto. Estas categorías y el código SAT son necesarios para la creación del producto.

Consulta los detalles de la categoría:

• Usa el servicio de categorías con el ID de la categoría T1 seleccionada. Este servicio te devolverá los atributos de la categoría, sus posibles valores, y las variaciones aplicables.

Reglas de negocio:

• El campo sku_padre debe ser un identificador único externo y no puede repetirse dentro de toda la tienda, ya sea como SKU PADRE o SKU VARIACIÓN.

• El nodo universal_id dentro del objeto sales_channel no puede repetirse en toda la tienda y no debe exceder los 13 caracteres.

• El campo packing_days debe ser un número positivo que indique los días que el comercio tarda en embarcar el producto. Los valores permitidos son 2, 3, 4, 5, 7, 12, y 15.

• El campo photo debe contener un array de imágenes, con un máximo de 10 fotos por producto.

• El campo video debe contener un array de videos, actualmente solo se permite la inclusión de videos de YouTube.

• El campo bullets debe ser un array con un máximo de 7 strings que describan el producto.

• El objeto sales_channel define los canales de venta y sus configuraciones, incluyendo precios, categorías y estado del producto en cada canal.

• El objeto sku define las variaciones del producto, con detalles como SKU, stock, identificador universal, color y talla (opcional).

• El campo list_price en los objetos sales_channel representa el precio base de la publicación en cada canal de venta.

• El campo sales_price en los objetos sales_channel indica el precio al que se venderá el producto, antes conocido como "Precio Oferta". Este precio no puede ser menor al 71% del valor del campo list_price y tampoco puede excederlo.

• El campo warranty define las garantías proporcionadas por el vendedor y el fabricante, indicando la cantidad y la duración de la garantía. Los valores permitidos son: 7 Días, 10 Días, 20 Días, 30 Días, 1 Año, 2 Años.

• El campo invoice indica los códigos del tipo de mercancía para el cumplimiento de la ley "Carta Porte", incluyendo el código SAT y la unidad de medida SAT.

• El campo category_t1comercios debe contener el ID de la categoría de T1Comercios a la que pertenece el producto, asegurando que el producto exista en el catálogo de T1Comercios.

• El campo category_name_t1comercios proporciona el nombre textual de la categoría T1Comercios para una mejor identificación y referencia del producto.

• En sales_channel, el campo category representa el ID de la categoría del canal de venta específico (por ejemplo, Claroshop, SEARS, Sanborns), asegurando que el producto esté correctamente categorizado en cada canal.

• En sales_channel, el campo category_name proporciona el nombre textual de la categoría del canal de venta para una mejor identificación y referencia del producto en cada canal.

• Los objetos CS, SR, y SN en el campo sales_channel son obligatorios, incluso si el producto no se publicará en el canal de venta correspondiente. Estos objetos deben estar presentes, y sus valores pueden definirse según sea necesario para el funcionamiento interno del sistema de gestión de productos en T1COMERCIOS.

• Las categorías en los objetos sales_channel CS, SR, y SN deben coincidir con el sat-code dentro del objeto invoice, según lo devuelto por el servicio de Matches de categorías de T1Comercios.

Creación de productos con y sin variaciones:

• Para crear un producto con variaciones utilizando este esquema, especifica el SKU Padre y define las variaciones utilizando el objeto sku en el cuerpo de la solicitud.

• Para crear un producto sin variaciones, utiliza el mismo SKU tanto para el SKU Padre como para la única variación en el objeto sku. Es fundamental seguir estas reglas para asegurar la correcta creación y funcionamiento de los productos en la plataforma T1COMERCIOS.

Request

Path Parameters

IDCommerce integerrequired

Identificador único del comercio o seller.

application/json

Body

required

Body principal para el alta de un producto sin variación

sku_padre stringrequired

Possible values: Value must match regular expression /^[0-9a-zA-Z-]+$/

Indetificador único externo. El valor de este campo NO se puede repetir dentro de todo la tienda. Ni como SKU PADRE o como SKU VARIACION.

name stringrequired

Possible values: Value must match regular expression /^[0-9a-zA-Z-]+$/

Título principal de la publicación.

description stringrequired

Descripción de la publicación.

category_t1comercios integerrequired

ID Categoría de T1Comercios. Este producto debe existir dentro del catalógo de T1Comercios.

category_name_t1comercios stringrequired

Texto del nombre de la categoría T1Comercios.

brand stringrequired

Marca de la publicación.

packing_days integerrequired

Possible values: [2, 3, 4, 5, 7, 12, 15]

Número de días en que el comercio tarda en embarcar el producto.

sales_channel

object

required

Objeto que indica los canales de venta en los cuales se va a comercializar la publicación.

CS

object

Objeto que define la configuración del venta del canal Claroshop.com

category string

IDCategoría del canal de venta Claroshop.

category_name string

Nombre de la Categoría del canal de venta Claroshop.com

list_price integer

Precio del lista de la publicación para el canal Claroshop.

sales_price integer

Precio en que el producto se venderá, antes conocido como Precio Oferta. El precio oferta no puede ser menor al 71% del valor del nodo, "list_price".

active boolean

EStatus del producto en el canal de venta.

SR

object

Objeto que define la configuración del venta del canal Claroshop.com

category string

IDCategoría del canal de venta Claroshop.

category_name string

Nombre de la Categoría del canal de venta SEARS.com.mx

list_price integer

Precio del lista de la publicación para el canal SEARS.com.mx

sales_price integer

Precio en que el producto se venderá, antes conocido como Precio Oferta. El precio oferta no puede ser menor al 71% del valor del nodo, "list_price".

active boolean

EStatus del producto en el canal de venta.

SN

object

Objeto que define la configuración del venta del canal Claroshop.com

category string

IDCategoría del canal de venta sanborns.com.mx.

category_name string

Nombre de la Categoría del canal de venta sanborns.com.mx

list_price integer

Precio del lista de la publicación para el canal sanborns.com.mx

sales_price integer

Precio en que el producto se venderá, antes conocido como Precio Oferta. El precio oferta no puede ser menor al 71% del valor del nodo, "list_price".

active boolean

EStatus del producto en el canal de venta.

bullets string[]required

Possible values: <= 10

Arreglo de strings que describen el producto, estos se pintaran a manera de listado en los portales de claroshop, SEARS y Sanborns. Se permiten 7 bullets por producto.

volumetry

object[]

required

Arreglo de medidas volumetricas.

Array [

higth integerrequired

Alto del paquete

width integerrequired

Ancho del paquete

deep integerrequired

Profundo del paquete

weight integerrequired

Peso del paquete

]

warranty

object

required

Objeto de inidica los tipos garantías que ofrece el vendedor en la publicación.

seller

object

Garantía que proporciona el vendedor. Solo se permiten las combinaciones 7 Días,10 Días,20 Días, 30 Días, 1 Años,2 Años

quantity integer

Possible values: [7, 10, 20, 30, 1, 2]

measure string

Possible values: [Días, Años]

manufacturer

object

Garantía de fábrica que ofrece la publicación. Solo se permiten las combinaciones 7 Días,10 Días,20 Días, 30 Días, 1 Años,2 Años

quantity integer

Possible values: [7, 10, 20, 30, 1, 2]

measure string

Possible values: [Días, Años]

invoice

object

required

Arreglo que indica los códigos del tipo de mercancia. Para el cumplimiento de la ley "Carta Porte".

sat-code string

ID del catalógo de SAT.

sat-measure-unit string

Texto del valor del código SAT.

iva boolean

Nodo que indica si el producto grava o no grava IVA.

tags string[]

Palabras clave del producto, estas palabras clave, ayudan a mejorar el SEO del producto. Máximo 10 tags por productos.

property

object[]

required

Array de atributos específicos de la categoría. Cada categoría tiene sus propios atributos y tipos de variación. Para obtener los detalles de estos atributos y sus variaciones, consulte el endpoint "Categorías" utilizando el ID de la categoría correspondiente.

Array [

property_id integer

name string

value string

]

sku

object[]

required

Schema qe define el array de ojectos "Variaciones."

Array [

sku string

Possible values: Value must match regular expression /^[0-9a-zA-Z-]+$/

Unidad de mantenimiento en almacén', valor único para el comercio.

stock integer

Stock de la variacion.

universal_id_type string

Possible values: [ean-8, upc-12, upc-8, gtin-14, isbn-13, issn-12, otro]

tipo de identificador universal usado

universal_id string

Possible values: Value must match regular expression /^[0-9]+$/

Identificador universal del producto, valor único para el comercio.

status string

Possible values: [active, inactive]

Estatus de la variacion

variation

object[]

Define los tipos y valores de la variación.

Array [

variationName string

variation_value string

]

]

photo

object[]

required

Array de fotos de la publicación. Una publicación puede tener máximo 10 imagenes.

Array [

url stringrequired

Url de la imagen que se cargo en el método FileManager.

order integerrequired

Orden en que se mostrará la imagen dentro de la plataforma y en los canales de venta.

variation

object[]

Array [

variationName string

variation_value string

]

]

video

object[]

required

Listado de videos, actualmente solo se permiten videos de youtube.

Array [

order integerrequired

Siempre envíar el valor "1".

skus string[]required

Array de SKUS que le pertenecen al objeto.Para producto Sin Vairación, envíar array vacío.

]

Responses

200

En caso de éxito

application/json

Schema

Schema

metadata

object

status string

Possible values: [success, error, fail]

Default value: success

http_code integer

date_time date-time

message string

data

object

IDProducto interno de T1COMERCIOS, con este ID se realizarán las operaciones / modificaciones hacía la publicación

id string

Example (from schema)

{
  "metadata": {
    "status": "success",
    "http_code": 200,
    "date_time": "2019-08-27T18:18:31Z",
    "message": "ok"
  },
  "data": {
    "id": "66444ec564296966e96270a2"
  }
}

409

En caso de no cumplir con una regla de negocio

application/json

Schema

Schema

metadata

object

status string

Possible values: [success, error, fail]

Default value: fail

http_code integer

date_time date-time

data

object

error_code string

Possible values: [ERR-001, ERR-002, ERR-003, ERR-004, ERR-005, ERR-006, ERR-007, ERR-008, ERR-009, ERR-010, ERR-011, ERR-012, ERR-013, ERR-014, ERR-015, ERR-016, ERR-017, ERR-018, ERR-019, ERR-020, ERR-021, ERR-024, ERR-025, ERR-026, ERR-027, ERR-028, ERR-029, ERR-032]

Codigo de error en caso de que el producto no compla con una validación interna

message string

Possible values: [SKU se encuentra en el sistema, Ean se encuentra en el sistema, Debe incluir por lo menos una foto del producto, Ya existe un producto con el mismo sku_padre, Debe enviar una categoria t1 valida, El producto debe tener una marca, Se debe considerar stock al crear el producto, Se deben llenar los datos del objeto invoice, El producto debe contener una descripcion, Cada item dentro de sku debe contener status, La propiedad active dentro del objeto sales channel es necesaria, La volumetria es necesaria --> ademas los valores deven ser > 0, Dias de embarque necesario, El atributo garantía es necesario, Existe conflicto entre el precio base y precio oferta, Categoria t1 no válida, No se pudieron validar las propiedades, El id propiedad no es válida para el producto, El id de la categoria cs no corresponde al enviado, El id de la categoria sr no corresponde al enviado, El id de la categoria sn no corresponde al enviado, El código Sat no coincide con la categoría seleccionada, Sólo puede ingresar un máximo de 7 características en el objeto bullets, Sólo se aceptan 10 fotos generales o por variación, Los valores permitidos para packing_days son {2,3,4,5,7,12,15}, Los valores aceptados en garantía son: (7,10,20,30) Días (1,2) Años, Los videos deben ser de la plataforma YOUTUBE, Universal_id no debe ser mayor a 13 caracteres]

Descripción del error, al momento de crear la publicación.

Example (from schema)

{
  "metadata": {
    "status": "fail",
    "http_code": 409,
    "date_time": "2019-08-27T18:18:31Z"
  },
  "data": {
    "error_code": "ERR-001",
    "message": "SKU se encuentra en el sistema"
  }
}

Loading...