Skip to main content
Version: Latest

Crear un producto

Proceso que permite crear un nuevo producto.

Request 🚀​

URL​

https://app.aveonline.co/avestock/api/createProduct.php

Method​

POST

Content-Type: application/json

Params JSON​

  • tipo* String Enrutador de la API, "authave"
  • empresa* Number Identificador de la empresa dentro de AVEONLINE, se obtiene en la [Autenticación](./autenticacion)
  • productName* String Nombre único del producto.
  • productDesc String Descripción del producto.
  • shortDesc* String Descripción corta del producto.
  • warrantyTime Number Tiempo de garantía del producto en meses.
  • warranty String Garantía del producto.
  • sendConditions String Condiciones de envío del producto.
  • productRef* String Referencia única del producto.
  • referenciaEquivalente String Referencia equivalente del producto.
  • referenciaEquivalente2 String Referencia equivalente del producto 2.
  • referenciaEquivalente3 String Referencia equivalente del producto 3.
  • referenciaEquivalente4 String Referencia equivalente del producto 4.
  • referenciaEquivalente5 String Referencia equivalente del producto 5.
  • costo Number Valor del producto.
  • rate Number Precio de venta del producto.
  • sugerido Number Precio sugerido del producto.
  • productStatus* Number Identificador del estado del producto. 1 - Activo 2 - Inactivo.
  • categoryName Number Identificador de la categoría a la cual pertenece el producto.
  • tax Number Porcentaje de impuesto aplicado al producto.
  • inventarioNegativo Number Permite el stock menor a 0 en el producto. 1 - Sí 2 - No.
  • tipoActivacion Number 1 - Publicar en Marketplace 2 - Sólo por activación.
  • productImage Object Imagen del producto.
  • peso Number Peso del producto en kilogramos.

Ejemplo​

{
  "tipo": "authave",
  "token": "",
  "empresa": 6077,
  "productName": "Producto de prueba",
  "productRef": "ASF65558",
  "referenciaEquivalente": "FF65558",
  "referenciaEquivalente2": "",
  "referenciaEquivalente3": "",
  "referenciaEquivalente4": "",
  "referenciaEquivalente5": "",
  "shortDesc": "Descripción corta, Producto de prueba",
  "warrantyTime": 11,
  "warranty": "Garantía del Producto de prueba",
  "sendConditions": "Condiciones de envío del Producto de prueba",
  "costo": 49000,
  "rate": 49000,
  "sugerido": 45000,
  "productStatus": 1,
  "categoryName": 6,
  "tax": 19,
  "productImage": null,
  "peso": 1.5
}

Response 📄​

Success​

  • status Bool Respuesta del servidor numérica.
  • message String Respuesta del servidor en modo texto.
  • createdProductId Number Identificador del producto creado.

Ejemplo​

{
  "success": true,
  "messages": "Creado exitosamente",
  "createdProductId": 12345
}

El método no está permitido​

{
  "success": false,
  "messages": "Método no permitido",
  "status": 405
}

Algunos parámetros son requeridos​

{
  "success": false,
  "messages": "El campo productName es requerido. y (1) errores más.",
  "status": 422,
  "errors": [
    {
      "title": "El campo productName no es válido.",
      "detail": "El campo productName es requerido.",
      "source": {
        "pointer": "/productName"
      }
    },
    {
      "title": "El campo tax no es válido.",
      "detail": "El campo tax debe estar entre 0 y 100.",
      "source": {
        "pointer": "/tax"
      }
    }
  ]
}

Credenciales incorrectas​

{
  "status": "error",
  "mensaje": "Credenciales inválidas o el cliente se encuentra inactivo"
}