ES | EN

Ejemplos por país

📦 Gestionar productos

Crear nuevos productos

Los productos pueden ser cualquier cosa que compre o venda: mercancías o servicios. Un producto puede tener una cantidad disponible en múltiples bodegas y mostrar diferentes precios según las listas de precios.

Mercadería o servicio

El campo type (obligatorio) indica si el producto es un producto variable:

  • 0: producto normal.
  • 1: maestro de producto variable.

El producto se crea como mercadería (con control de inventario) cuando se envía inventories o cuando type es 1. Si no se envía inventories y type es 0, el producto se crea como servicio.

Para crear una mercadería con stock inicial, envíe en inventories.details la bodega (product_location_id) y la cantidad disponible. Las bodegas se obtienen con el endpoint /product_locations.

Sincronización con su tienda en línea

Si la cuenta tiene activa una integración con WooCommerce, Shopify o Jumpseller, los productos activos (status = 1) y con SKU se envían a la tienda, y se relacionan por SKU. El stock inicial también se sincroniza. Para sincronizarse, el producto debe tener un precio en la lista de precios 1.

Con ecommerce_status (opcional) puede indicar cómo se crea el producto en WooCommerce:

  • publish: publicado (valor por defecto).
  • draft: borrador, para completar fotos, descripción, categorías y atributos antes de publicarlo.

Las modificaciones (PUT) y eliminaciones (DELETE) de productos también se envían a la tienda.

{
   "name": "papas fritas lays",
   "invoicing_details": "",
   "additional_details": "",
   "model": "",
   "brand": "",
   "status": 1,
   "sku": "33",
   "measure_unit": null,
   "type": 0,
   "embedded_quantity_barcode": null,
   "embedded_quantity_barcode_decimals": null,
   "additional_data_1": "aaa",
   "additional_data_2": "bbb",
   "additional_data_3": "ccc",
   "favorite": 1,
   "product_category_id": null,
   "ecommerce_status": "draft",
   "cost":    {
      "currency_id": 39,
      "value": 2344
   },
   "price": [
    {
          "product_price_list_id": 1,
          "unit_net": 1680.672269,
          "unit_tax": 319.327731,
          "unit_total": 2000,
          "currency_id": "39",
          "sales_commission_percentage": null,
          "taxes": [
                {
                  "tax_type_id": "387",
                  "tax_percentage": 19,
                  "tax_amount": 319.327731
                }

          ]
       }
    ],
   "inventories":    {
    "details": [
            {
                "product_location_id": 1,
                "available_quantity": 25
            }
    ],
      "total_available": 25,
      "total_reserved": 0
   }
}

Crear nuevas categorías de productos

Los productos pueden pertenecer opcionalmente a una categoría. Las categorías también pueden tener una jerarquía al tener una categoría padre.

{
    "account_id": 39,
    "name": "categoria ejemplo API 3",
    "parent_product_category_id": null
}

Crear nuevas ubicaciones de productos

Las ubicaciones pueden ser bodegas, vehículos de transporte, tiendas u otros lugares donde almacena productos.

{
    "account_id": 39,
    "name": "bodega pruebas",
    "status": 1,
    "company_branch_id": 1
}

Crear nueva lista de precios de productos

Las listas de precios le permiten definir diferentes precios para el mismo producto y así ofrecer precios personalizados a sus clientes.

{
    "account_id": 39,
    "name": "new product price list"
}