Saltar al contenido principal

¿Cómo crear productos desde tu sistema a Multivende?

Actualización

En este artículo, mostramos cómo realizar la creación de productos desde tu sistema hacia Multivende mediante nuestra API.

Para comenzar, te dejamos los Endpoints disponibles para una correcta creación de un producto desde nuestra API.

  • Get products with scroll: Obtener todos los productos de un Merchant.
  • Products: Obtener los registros de las marcas, tallas, colores u otros se debe consultar según sea el caso en la carpeta correspondiente.
  • Create product: Crear productos asociado a un merchant.
  • Update product: Permite actualizar la información del producto.
  • Atributos custom: Atributos personalizados que pueden asignar al producto.
    • Te recomendar leer el siguiente artículo en donde abordamos esto con mayor detalle.

 

  • Creación de un producto con información básica

A través de nuestra API podemos realizar la creación de un producto para ello disponemos del Endpoint Create product *, esto nos permite crear un producto a un Merchant.

Te dejamos un ejemplo para la creación de un producto enviando información básica dentro del cuerpo del mensaje, cabe destacar que debes ponerle un Nombre y configurar el SKU padre e hijo.

{
"name": "Nombre del producto",
"code": "SKU Padre",
"InventoryTypeId": "791a6654-c5f2-11e6-aad6-2c56dc130c0d",
"InternalCodeTypeId": null,
"ProductVersions": [
    {
        "status": "waiting-for-creation", (Status enviado por defecto)
        "code": "SKU Hijo",
        "isDefaultVersion": true,
        "InventoryTypeId": "791a6654-c5f2-11e6-aad6-2c56dc130c0d",
        "InternalCodeTypeId": null,
        "position": 0
    }
]
}

Tener en consideración utilizar siempre el campo “InventoryTypeId” seteado de la siguiente manera  = "791a6654-c5f2-11e6-aad6-2c56dc130c0d".

 

Una vez enviado el endpoint la API no retornará 201, indicando la creación de nuestro producto de forma exitosa, un ejemplo del response es el siguiente:

{
    "_id": "XXX33b34-XXXX-XXXX-85e2-5b55a0aXXXXXX",
    "status": "created",
    "name": "Nombre del producto",
    "InternalCodeTypeId": null,
    "code": "SKU Padre",
    "CreatedById": "d561f14f-0800-4091-8d3f-XXXXXXXXXXXX",
    "UpdatedById": "d561f14f-0800-4091-8d3f-XXXXXXXXXXX",
    "MerchantId": "bf03e4e6-53a0-4082-9476-XXXXXXXXXXX",
    "updatedAt": "2023-00-00T00:00:00.000Z", (Fecha y hora en formato UTC)
    "createdAt": "2023-00-00T00:00:00.000Z",
    "ProductTypeId": "0f381d1c-3408-11e7-8e63-XXXXXXXXXXXX",
    "ProductVersions": [
        {
            "_id": "d775b3d8-a19a-4069-8cdd-XXXXXXXXXXXX",
            "code": "SKU Hijo",
            "internalCode": null,
            "providerCode": null,
            "position": 0,
            "width": 0,
            "length": 0,
            "height": 0,
            "weight": 0,
            "status": "created",
            "createdAt": "2023-00-00T00:00:00.000Z",
            "updatedAt": "2023-00-00T00:00:00.000Z",
            "CodeTypeId": null,
            "InternalCodeTypeId": null,
            "ColorId": "4ecf5004-f721-46bf-a38a-75807491a4cb",
            "SizeId": "226a61dc-1eef-41cf-af5e-cc6aea7c75b4",
            "CreatedById": "d561f14f-0800-4091-8d3f-XXXXXXXXXXXX",
            "UpdatedById": "d561f14f-0800-4091-8d3f-XXXXXXXXXXXX",
            "InventoryTypeId": "791a6654-c5f2-11e6-aad6-XXXXXXXXXXXX",
            "ProductId": "30433b34-294f-40a6-85e2-XXXXXXXXXXXX",
            "MerchantId": "bf03e4e6-53a0-4082-9476-XXXXXXXXXXXX"
        }
    ]
}

 

Tener en consideración la lectura de los siguientes artículos, dado que una vez creado este producto puedes realizar la carga del Stock y el Precio.

 

  • Crear un producto con información completa.

Del mismo modo utilizando el Endpoint Create product * podemos crear un producto pero enviando información completa de este, ya sea color, talla, marca, etc.

Antes de comenzar a crear un producto al detalle lo primero que debes realizar es lo siguiente:

1.- Mapeo de los atributos de los productos como:

  1. Categoría.
  2. Color.
  3. Talla.
  4. Marca.
  5. Temporada.
  6. Clases de envío.
  7. Descripción.
  8. Atributos custom. 
  9. El único atributo que debe quedar configurado por defecto es el SKU (code).

Para obtener un array con todos los atributos de los productos de Multivende para un Merchant usar en endpoint Get product attributes.

 

2.- Imágenes: 

Las imágenes están clasificadas por álbum para obtener el listado de los álbumes usar el endpoint Get products picture set. (El Merchant deberá poder mapear los álbumes de la aplicación con los álbumes de Multivende).

Puedes encontrar más detalles en el artículo dedicado a la Gestión de imágenes.

*El Merchant deberá poder seleccionar cuales son los productos que cargará desde la aplicación a Multivende.

 

Configuración de atributos

Puedes encontrar el detalle de los Endpoint en la propia documentación de la API, no obstante te dejamos los que podrían ser los más relevantes:

 

  • Marcas:

    • Get Brands: Podrás obtener las marcas asociadas al Merchant.
      • Get Brands by Id: Te permite buscar una marca especifica enviando el "_id" dentro del request.
    • Post Brands: Puedes crear una marca desde la integración la cual quedará asociada al Merchant.
    • Update Brands: Te permite actualizar el nombre o la descripción de la marca.

 

 

  • Colores:

    • Get Colors:  Podrás obtener los colores asociados al Merchant.  
      • Get Colors by Id: Te permite buscar un color especifico enviando el "_id" dentro del request.
    • Post Colors: Puedes crear un color el cual quedará asociado al Merchant.
    • Update Colors: Te permite actualizar el nombre del color.

 

  • Tallas:

    • Get Sizes: Podrás buscar las tallas asociadas al Merchant. 
      • Get Size by Id: Te permite buscar una talla especifica enviando el "_id" dentro del request.
    • Post Sizes: Puedes crear un talla la cual quedará asociada al Merchant.
    • Update Sizes: Te permite actualizar el nombre y la descripción de la talla.

 

  • Temporadas:

    • Get Seasons: Podrás obtener las temporadas asociadas al Merchant.  
      • Get Seasons by Id: Te permite buscar una temporada especifica enviando el "_id" dentro del request.
    • Post Seasons: Puedes crear una temporada la cual quedará asociada al Merchant.
    • Update Seasons: Te permite actualizar el nombre de la temporada.

 

 

 

Si tienes dudas sobre este tema contáctanos a través de api@multivende.com  y estaremos felices de ayudarte.

Equipo Integraciones API Multivende

Artículos relacionados