Skip to main content

Canjear el cupón

PUT https://backend.qrupones.com/coupon/[CuponID]

info
Es importante posterior al canje del cupón, no olvidarse de realizar la Recompra (Crear la venta). Es decir: El cupón que estoy canejando debe ir acompañado de la nueva venta que hace referencia al canje del cupón.

Seguridad​

Esta api utiliza clientSecret, user y password como método de autenticación.

  • Name: X-QRAPI-SECRET
  • Name: X-QRAPI-USER
  • Name: X-QRAPI-PASS
  • In: headers

Consulta cómo obtener las Credenciales

Parámetros de solicitud​

Url​

Concatena el ID del cupón previamente obtenido. Por ejemplo:

https://backend.qrupones.com/coupon/1292

Body​

NombreDescripciónRequeridoTipo
SucursalCanjeIDEnvía el ID de la sucursalRequeridonumber

Ejemplo de solicitud​

{
"SucursalCanjeID": 5
}

Respuesta​

CodeDescription
200Retorna los datos actualizados del cupón
400Retorna los posibles errores de la solicitud
401Unauthorized

Tipos de Descuentos​

info

Estos son los tipos de descuentos que utilizamos


export enum TipoCampanasEnum {
DescuentoPorcentual = 1,
MontoFijo = 2,
Items = 3,
Sellos = 4
}

export enum TipoCampanasNames {
DescuentoPorcentual = 'DescuentoPorcentual',
MontoFijo = 'MontoFijo',
Items = 'Items',
Sellos = 'Sellos'
}

Uso 📝​

canje-coupon.js
const headers = new Headers()
headers.append('X-QRAPI-SECRET', 'yourClientSecret')
headers.append('X-QRAPI-USER', 'yourUser')
headers.append('X-QRAPI-PASS', 'yourPassword')

const CuponID = 1292 // Reemplaza con el ID del cupón que deseas canjear
const url = `https://backend.qrupones.com/coupon/${CuponID}`

const requestOptions = {
method: 'PUT',
headers: headers,
body: JSON.stringify({
SucursalCanjeID: 123
}),
redirect: 'follow'
}

fetch(url, requestOptions)
.then((response) => response.json())
.then((result) => console.log(result))
.catch((error) => console.error('error', error))

Respuesta exitosa ✅​

{
"data": {
"CuponID": 1234,
"CodigoQR": "WNDDJ",
"EstadoQR": 1,
"FechaCanje": "2023-12-31T18:04:34.139Z",
"CantidadCanjes": 3,
"CanjesMaximos": 5,
"EstadoCupon": "Usado",
"TipoCampanaID": 1,
"TipoCampanaDetalle": "20",
"TipoCampanaName": "DescuentoPorcentual"
}
}

Respuesta con error 📛​

{
"errors": [
{
"msg": "Ocurrio un error al actualizar el cupón, por favor revisa los identificadores e intenta nuevamente"
}
]
}

Respuesta error de seguridad ⚠️​

{
"errors": [
{
"msg": "No existen los parametros de seguridad en la solicitud"
}
]
}