Saltar al contenido principal

edit-product

Este método se utiliza para editar un producto, ya sea para cambiar el nombre o algún otro dato que contiene el producto.

NOTAS

En el caso de los productos, todos son editables a menos que exista un caso especial que no lo sea, como por ejemplo, el caso del servicio Venta general que se genera por default al ingresar por primera vez a la plataforma de AceptaBits, para conocer más acerca de los elementos creados por default se deberá de consultar la sección: Elementos creados por default

Por lo tanto y teniendo en cuenta lo anterior, este método solo es funcional para los productos que tengan el campo isEditable con valor -1.

Path del método​

edit-product

Endpoint final​

PRODUCCION

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

SANDBOX DE PRUEBAS

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

Método de petición HTTP​

POST

Lista de parámetros​

ParámetroObligatorioDescripciónvalor
codeSiEl código del producto que se quiere editarEjemplo:
pgbpro7531996315879614

Deveras de ingresar el código del producto que requieres editar, el código debe de ser de un producto editable

Este código es único y puedes encontrarlo al consultar la información de un producto dentro de los métodos get-products o show-product
nameNoEl nombre que se le asignara al productoejemplo:
calculadora de mano, llanta, cuaderno, etc.

Deveras de ingresar el nombre con el que requieres que el producto se edite
price_mxnNoEl precio en MXN (Peso mexicano) que se le asignara al productoejemplo:
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
NOTAS
  • Si se envía name con un valor vacío, el nombre actual del producto se mantendrá.

Lista de códigos​

Exitoso
CódigoDescripción
0044El producto se ha actualizado con éxito

 

Error
CódigoDescripción
0000El Token API no es correcto y la autenticación del usuario ha fallado
0003El Token API no es correcto y la autenticación del usuario ha fallado
1214El Token API no es correcto y la autenticación del usuario ha fallado
1215El código del producto es requerido
1340El 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
1341El 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
1217El producto que se intenta editar no existe (el código del producto es incorrecto)
1333No es posible editar el producto, el código del producto ingresado debe de corresponder a un producto que sea editable
1608El 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
1218El Token API no es correcto y la autenticación del usuario ha fallado
1219Ocurrió un problema al editar 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": "0044"
    },
    "data": {
        "code": "pgbpro8535751962447235",
        "name": "Bocinas para escritorio M785-65",
        "price_mxn": "0.25000000",
        "code_shop": "pgbsho44747793463129176",
        "name_shop": "Velas martin",
        "created_at": "2024-08-08T01:16:07.000000Z",
        "created_at_format": "2024-08-07 20:16:07",
        "isEditable": "-1"
    }
}

Descripción de la respuesta​

  • Revisar el listado de códigos EXITOSO para conocer el significado de success code.
  • data - muestra la información del producto
    • 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": "1217"
    }
}

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.