Saltar al contenido principal

edit-service

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

NOTAS

Este método solo es funcional para los servicios que tengan el campo isEditable con valor -1, por ejemplo, Venta general que se crea por default al dar de alta una tienda no es editable.

Para conocer más acerca de los elementos creados por default se deberá de consultar la sección: Elementos creados por default

Path del método​

edit-service

Endpoint final​

PRODUCCION

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

SANDBOX DE PRUEBAS

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

Método de petición HTTP​

POST

Lista de parámetros​

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

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

Este código es único y puedes encontrarlo al consultar la información de un servicio dentro de los métodos get-services o show-service
nameNoEl nombre que se le asignara al servicioejemplo:
Curso de inducción, reparación de refrigerador, jardinería general, etc.

Deveras de ingresar el nombre con el que requieres que el servicio se edite
price_mxnNoEl precio en MXN (Peso mexicano) que se le asignara al servicioejemplo:
0, 12, 100.55, 2500.3, etc.

Este valor debe de ser numérico y siempre deberá de ser mayor o igual 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
0047El servicio 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
1229El Token API no es correcto y la autenticación del usuario ha fallado
1230El código del servicio es requerido
1346El precio en MXN debe ser numérico y mayor o igual a 0, si no es entero deberá de contar con un máximo de 2 decimales
1347El precio en MXN debe ser numérico y mayor o igual a 0, si no es entero deberá de contar con un máximo de 2 decimales
1232El servicio que se intenta editar no existe (el código del servicio es incorrecto)
1332No es posible editar el servicio, el código del servicio ingresado debe de corresponder a un servicio que sea editable
1609El precio en MXN debe ser numérico y mayor o igual a 0, si no es entero deberá de contar con un máximo de 2 decimales
1233El Token API no es correcto y la autenticación del usuario ha fallado
1234Ocurrió un problema al editar el servicio, 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": "0047"
    },
    "data": {
        "code": "pgbser67889721988875944",
        "name": "Decoracion de 20 mesas para boda o eventos especiales",
        "price_mxn": "19500.00000000",
        "code_shop": "pgbsho44747793463129176",
        "name_shop": "Velas martin",
        "created_at": "2024-08-08T17:44:35.000000Z",
        "created_at_format": "2024-08-08 12:44:35",
        "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 servicio
    • code - Código del servicio (este código es único para cada servicio dado de alta)
    • name - Nombre del servicio
    • price_mxn - Precio en MXN (Peso mexicano) del servicio
    • code_shop - Código de la tienda a la que pertenece el servicio
    • name_shop - Nombre de la tienda a la que pertenece el servicio
    • created_at - Fecha y hora de creación del servicio (UTC)
    • created_at_format - Fecha y hora de creación del servicio (America/Mexico_City)
    • isEditable - indica si el servicio 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": "1609"
    }
}

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.