add-product

Este método se utiliza para dar de alta un nuevo producto en una tienda, no existe un límite y puede tener tantos productos como lo requiera el usuario en cada una de las tiendas que tenga creadas.

---

Path del método

add-product

Endpoint final

PRODUCCION

https://aceptabits.com/api/thirdparty/v1/add-product

SANDBOX DE PRUEBAS

https://sandbox.aceptabits.com/api/thirdparty/v1/add-product

---

Método de petición HTTP

POST

Lista de parámetros

Parámetro	Obligatorio	Descripción	valor
code_shop	Si	Es el código de la tienda a la que se asignara el producto	ejemplo: pgbsho0635214789653205 Este código es único de cada tienda, se obtiene al consultar el listado de tiendas o al generar una tienda nueva, consulte los métodos: get-shops, add-shop o show-shop para más detalles
name	Si	El nombre que se le asignara al producto	ejemplo: calculadora de mano, llanta, cuaderno, etc. Deveras de ingresar el nombre con el que requieres que el producto se genere
price_mxn	Si	El precio en MXN (Peso mexicano) que se le asignara al producto	ejemplo: 12, 100.55, 2500.3, etc. Este valor debe de ser numérico y siempre deberá de ser mayor a 0, puede no contener decimales para el caso de que sea un numero entero, si no es un numero entero deberá de contener máximo 2 decimales después del punto decimal

---

Lista de codigos

Exitoso

Código	Descripción
0043	Producto creado con éxito

 

Error

Código	Descripción
0000	El Token API no es correcto y la autenticación del usuario ha fallado
0003	El Token API no es correcto y la autenticación del usuario ha fallado
1208	El Token API no es correcto y la autenticación del usuario ha fallado
1209	El nombre del producto es requerido
1210	El código de la tienda es requerido
1336	El precio en MXN es requerido
1337	El precio en MXN debe ser numérico y mayor a 0, si no es entero deberá de contar con un máximo de 2 decimales
1338	El precio en MXN debe ser numérico y mayor a 0, si no es entero deberá de contar con un máximo de 2 decimales
1606	El precio en MXN debe ser numérico y mayor a 0, si no es entero deberá de contar con un máximo de 2 decimales
1211	La tienda a la que se asignara el producto no existe (código de tienda incorrecto)
1212	El Token API no es correcto y la autenticación del usuario ha fallado
1213	Ocurrió un problema y no es posible dar de alta el producto, inténtelo nuevamente o consulte con soporte técnico para más ayuda

---

Ejemplo de respuesta EXITOSA

Exitoso

Código HTTP 200

{
    "status": true,
    "success": {
        "code": "0043"
    },
    "data": {
        "code": "pgbpro4348528913927633",
        "name": "Mouse inalambrico V2563",
        "price_mxn": "350",
        "code_shop": "pgbsho40996222369461182",
        "name_shop": "Tienda general",
        "created_at": "2024-08-06T21:07:34.000000Z",
        "created_at_format": "2024-08-06 16:07:34",
        "isEditable": -1
    }
}

Descripción de la respuesta

• Revisar el listado de códigos EXITOSO para conocer el significado de success code.
• data - La información del producto recién creado
  • code - Código del producto (este código es único para cada producto dado de alta)
  • name - Nombre del producto
  • price_mxn - Precio en MXN (Peso mexicano) del producto
  • code_shop - Código de la tienda a la que pertenece el producto
  • name_shop - Nombre de la tienda a la que pertenece el producto
  • created_at - Fecha y hora de creación del producto (UTC)
  • created_at_format - Fecha y hora de creación del producto (America/Mexico_City)
  • isEditable - indica si el producto se puede o no editar, los valores posibles son:
    • 0 = no se puede editar
    • -1 = si se puede editar

---

Ejemplo de respuesta FALLIDA

Error

Código HTTP 400, Código HTTP 401, Código HTTP 500

{
    "status": false,
    "error": {
        "code": "1606"
    }
}

Descripción de la respuesta

• Revisar el listado de códigos ERROR para conocer la causa y saber cómo corregir
• Si se obtiene un código HTTP 500 comunicarse a soporte técnico
• Si se obtiene un código HTTP 401 revisar que el Token API este correcto

---

Notas

Si tienes alguna duda recuerda que siempre puedes contactar con el equipo de soporte para desarrolladores ingresando en el siguiente enlace: Soporte para desarrolladores.