add-service

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

---

Path del método

add-service

Endpoint final

PRODUCCION

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

SANDBOX DE PRUEBAS

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

---

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 servicio	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 mas detalles
name	Si	El nombre que se le asignara al servicio	ejemplo: 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 genere
price_mxn	No	El precio en MXN (Peso mexicano) que se le asignara al servicio	ejemplo: 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 el parámetro price_mxn no se envía se asignara un precio de $0.00 MXN al servicio

---

Lista de códigos

Exitoso

Código	Descripción
0046	Servicio 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
1223	El Token API no es correcto y la autenticación del usuario ha fallado
1224	El nombre del servicio es requerido
1225	El código de la tienda es requerido
1343	El 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
1344	El 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
1226	La tienda a la que se asignara el servicio no existe (código de tienda incorrecto)
1607	El 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
1227	El Token API no es correcto y la autenticación del usuario ha fallado
1228	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": "0046"
    },
    "data": {
        "code": "pgbser66834158382539839",
        "name": "rehabilitación de aroma para velas",
        "price_mxn": 0,
        "code_shop": "pgbsho44747793463129176",
        "name_shop": "Velas martin",
        "created_at": "2024-08-08T17:41:59.000000Z",
        "created_at_format": "2024-08-08 12:41:59",
        "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 servicio recién creado
  • 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": "1224"
    }
}

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.