MENU navbar-image

Inicio

Documentación técnica de integración con e-Rewards API

Autenticación

Para poder solicitar los recursos de esta API, es necesario obtener un TOKEN de acceso. Este TOKEN, se obtiene realizando una petición POST a /oauth/token:

CON EL HEADER

Y ESTOS PARÁMETROS

Si los datos de acceso son correctos, se devolverá un access_token con expiración de un año. Este token deberá ser includo para cada petición en el header "Authorization" junto con "Content-type", de la siguiente forma:

Si las claves de acceso son incorrectas, o alguno de los datos provistos (indicados arriba) no es correcto, se devolvera una respuesta de error con estatus 400.

Recurso: Actividades

Listar Actividades

Example request:
curl --request GET \
    --get "https://prod-apierewards.adventa.solutions/api/actividades" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --header "Authorization: Bearer <access_token>"
$client = new \GuzzleHttp\Client();
$url = 'https://prod-apierewards.adventa.solutions/api/actividades';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
            'Authorization' => 'Bearer <access_token>',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://prod-apierewards.adventa.solutions/api/actividades"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "Authorization": "Bearer &lt;access_token&gt;",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "success": true,
    "actividades": [
        {
            "id": 1,
            "actividadId": 1,
            "nombre": "Canje"
        }
    ]
}

Example response (401):


{
    "message": "Unauthorized, access token invalido"
}

Example response (422):


{
    "message": "The data given was invalid, el cuerpo de la solicitud es incorrecto"
}

Example response (500):


{
    "message": "Server error"
}

Request      

GET api/actividades

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Authorization      

Example: Bearer <access_token>

Recurso: Canjes

Consulta de reenvio de canjes

Example request:
curl --request GET \
    --get "https://prod-apierewards.adventa.solutions/api/canjes/reenvios?uids_erewards=4433322%2C443321&id_catalogo=5&paginate=1" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --header "Authorization: Bearer &lt;access_token&gt;" \
    --data "{
    \"id_catalogo\": 11613.31890586,
    \"paginate\": false
}"

$client = new \GuzzleHttp\Client();
$url = 'https://prod-apierewards.adventa.solutions/api/canjes/reenvios';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
            'Authorization' => 'Bearer <access_token>',
        ],
        'query' => [
            'uids_erewards' => '4433322,443321',
            'id_catalogo' => '5',
            'paginate' => '1',
        ],
        'json' => [
            'id_catalogo' => 11613.31890586,
            'paginate' => false,
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://prod-apierewards.adventa.solutions/api/canjes/reenvios"
);

const params = {
    "uids_erewards": "4433322,443321",
    "id_catalogo": "5",
    "paginate": "1",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "Authorization": "Bearer &lt;access_token&gt;",
};

let body = {
    "id_catalogo": 11613.31890586,
    "paginate": false
};

fetch(url, {
    method: "GET",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
  "success": true,
  "data": {
      "list": [
          {
              "canje_id": 447743,
              "remaining_attempts": "5",
              "resend_count": 4,
              "max_resend_allowed": 9,
              "vigencia_attempts": 90,
              "reenvios": [
                  {
                      "id": 10607,
                      "correo": "user@gmail.com",
                      "celular": null,
                      "enviado_por": 1,
                      "es_spi": false,
                      "pedido_id": 447743,
                      "fecha_creacion": "2024-10-21 15:31:08",
                      "total_sms_enviados": 0,
                      "first_name": "Romulo",
                      "last_name": "Opulento",
                      "api_username_requester": "administrator",
                      "helpdesk_ticket_number": 2233311,
                      "requested_from_adbox": true,
                      "readable_created_at": "lunes 21 de octubre 2024, a las 03:31p. m."
                  },
              ]
          }
      ]
  }
}

Example response (401):


{
    "message": "Unauthorized, access token invalido"
}

Example response (422):


{
    "message": "The data given was invalid, parámetros de consulta no válidos"
}

Example response (500):


{
    "message": "Server error"
}

Request      

GET api/canjes/reenvios

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Authorization      

Example: Bearer <access_token>

Query Parameters

uids_erewards   string   

Requerido solo si "id_catalogo" es nulo. Son los IDs de canje de eRewards. Para consultar mas de uno, se deben separar por comas ej. "1,2,3". Si son muchos uids, pueden enviarse por el body. Example: 4433322,443321

id_catalogo   string   

Requerido solo si "uids_erewards" es nulo. Filtra por el ID del catálogo. Example: 5

paginate   string  optional  

Define si la respuesta debe paginarse o no, valores validos: "1" o "0". Example: 1

Body Parameters

uids_erewards   string  optional  

This field is required when id_catalogo is not present.

id_catalogo   number  optional  

This field is required when uids_erewards is not present. Example: 11613.31890586

paginate   boolean  optional  

Example: false

Reenvío de canjes

Example request:
curl --request POST \
    "https://prod-apierewards.adventa.solutions/api/canjes/reenvios" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --header "Authorization: Bearer &lt;access_token&gt;" \
    --data "{
    \"data\": \"{\\\"uidErewards\\\": 321442,\\\"email\\\": \\\"some@mail.com\\\",\\\"mobile\\\": \\\"3317210477\\\",\\\"userFirstName\\\": \\\"John\\\",\\\"userLastName\\\": \\\"Doe\\\", \\\"ticketNumber\\\": \\\"123\\\" }\"
}"

$client = new \GuzzleHttp\Client();
$url = 'https://prod-apierewards.adventa.solutions/api/canjes/reenvios';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
            'Authorization' => 'Bearer <access_token>',
        ],
        'json' => [
            'data' => '{"uidErewards": 321442,"email": "some@mail.com","mobile": "3317210477","userFirstName": "John","userLastName": "Doe", "ticketNumber": "123" }',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://prod-apierewards.adventa.solutions/api/canjes/reenvios"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "Authorization": "Bearer &lt;access_token&gt;",
};

let body = {
    "data": "{\"uidErewards\": 321442,\"email\": \"some@mail.com\",\"mobile\": \"3317210477\",\"userFirstName\": \"John\",\"userLastName\": \"Doe\", \"ticketNumber\": \"123\" }"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "success": true,
    "message": "El canje 117891 fue reenviado con éxito",
    "data": {
        "canje_id": 117891,
        "remaining_attempts": 0,
        "resend_count": 3,
        "max_resend_allowed": 3,
        "vigencia_attempts": 90
    }
}

Example response (401):


{
    "message": "Unauthorized, access token invalido"
}

Example response (403):


{
    "success": false,
    "message": "El canje 447744 supero el limite de reenvios permitidos o excedio la fecha de vigencia de reenvio",
    "data": null,
    "errors": [
        {
            "canje_id": 447744,
            "exceeded_resend_attemps": false,
            "exceeded_resend_due_days": false,
            "days_elapsed_from_swap": 2,
            "is_fake": false,
            "has_repeated_email_twice": true,
            "has_repeated_phone_twice": false
        }
    ]
}

Example response (422):


{
    "message": "The data given was invalid, el cuerpo de la solicitud es incorrecto"
}

Example response (500):


{
    "message": "Server error"
}

Request      

POST api/canjes/reenvios

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Authorization      

Example: Bearer <access_token>

Body Parameters

data   json  optional  

required. Todos los keys dentro del "data" son mandatorios, exepto email y mobile. Si se envia SOLO "email", solo se envia email; si se envia SOLO "mobile", solo se envia sms; si se envian ambos, se envia email y sms. El nombre y apellido se usa para personalizar la notificacion de reevío. Example: {"uidErewards": 321442,"email": "some@mail.com","mobile": "3317210477","userFirstName": "John","userLastName": "Doe", "ticketNumber": "123" }
uidErewards   number   

Example: 11613.31890586

email   string  optional  

This field is required when data.mobile is not present. El campo value debe ser una dirección de correo válida. Example: claire77@example.net

mobile   string  optional  

This field is required when data.email is not present. El campo value debe ser un número de 10 dígitos. Example: 8107987494

userFirstName   string   

Example: consequatur

userLastName   string   

Example: consequatur

ticketNumber   number  optional  

Example: 11613.31890586

Actualizar num. de pedidos SAP

Example request:
curl --request POST \
    "https://prod-apierewards.adventa.solutions/api/canjes/establecer-numeros-sap" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --header "Authorization: Bearer &lt;access_token&gt;" \
    --data "{
    \"numerosSap\": \"[{\\\"numerosSap\\\": [{\\\"canjeId\\\": 123, \\\"noPedidoSap\\\": 123},{\\\"canjeId\\\": 321, \\\"noPedidoSap\\\": 321}]\"
}"

$client = new \GuzzleHttp\Client();
$url = 'https://prod-apierewards.adventa.solutions/api/canjes/establecer-numeros-sap';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
            'Authorization' => 'Bearer <access_token>',
        ],
        'json' => [
            'numerosSap' => '[{"numerosSap": [{"canjeId": 123, "noPedidoSap": 123},{"canjeId": 321, "noPedidoSap": 321}]',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://prod-apierewards.adventa.solutions/api/canjes/establecer-numeros-sap"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "Authorization": "Bearer &lt;access_token&gt;",
};

let body = {
    "numerosSap": "[{\"numerosSap\": [{\"canjeId\": 123, \"noPedidoSap\": 123},{\"canjeId\": 321, \"noPedidoSap\": 321}]"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "success": true,
    "message": "Se actualizaron 2 canjes",
    "data": {
        "canjes_actualizados": 2
    }
}

Example response (401):


{
    "message": "Unauthorized, access token invalido"
}

Example response (422):


{
    "message": "The data given was invalid, el cuerpo de la solicitud es incorrecto"
}

Example response (500):


{
    "message": "Server error"
}

Request      

POST api/canjes/establecer-numeros-sap

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Authorization      

Example: Bearer <access_token>

Body Parameters

numerosSap   string   

Los nuevos pedidos de SAP en formato JSON. Si no se incluye el key "canjeId" o "noPedidoSap" en el item, será omitido. Example: [{"numerosSap": [{"canjeId": 123, "noPedidoSap": 123},{"canjeId": 321, "noPedidoSap": 321}]
canjeId   number   

El campo value no debe ser mayor a 9999999999. Example: 21

noPedidoSap   number   

El campo value no debe ser mayor a 9999999999. Example: 13

Realizar Pedido

Example request:
curl --request POST \
    "https://prod-apierewards.adventa.solutions/api/pedidos" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --header "Authorization: Bearer &lt;access_token&gt;" \
    --data "{
    \"catalogoId\": 5,
    \"usuarioId\": 3,
    \"nombre\": \"Juan\",
    \"apellido\": \"Perez\",
    \"email\": \"juan.perez@gmail.com\",
    \"celular\": \"3326741051\",
    \"enviarEmail\": true,
    \"enviarSms\": true,
    \"numeroPedidoSap\": 661122,
    \"pedido\": \"[{\\\"incentivoId\\\": \\\"CIN-1\\\", \\\"cantidad\\\": 2, \\\"ids_unicos_canje\\\": [\\\"iduc_1\\\", \\\"iduc_2\\\"]}]\",
    \"orderId\": 501122,
    \"redeem_webhook_url\": \"https:\\/\\/www.mueller.com\\/laborum-eius-est-dolor-dolores-minus-voluptatem\",
    \"redeem_webhook_key\": \"sufvyvddqamniihfqcoyn\"
}"

$client = new \GuzzleHttp\Client();
$url = 'https://prod-apierewards.adventa.solutions/api/pedidos';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
            'Authorization' => 'Bearer <access_token>',
        ],
        'json' => [
            'catalogoId' => 5,
            'usuarioId' => 3,
            'nombre' => 'Juan',
            'apellido' => 'Perez',
            'email' => 'juan.perez@gmail.com',
            'celular' => '3326741051',
            'enviarEmail' => true,
            'enviarSms' => true,
            'numeroPedidoSap' => 661122,
            'pedido' => '[{"incentivoId": "CIN-1", "cantidad": 2, "ids_unicos_canje": ["iduc_1", "iduc_2"]}]',
            'orderId' => 501122,
            'redeem_webhook_url' => 'https://www.mueller.com/laborum-eius-est-dolor-dolores-minus-voluptatem',
            'redeem_webhook_key' => 'sufvyvddqamniihfqcoyn',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://prod-apierewards.adventa.solutions/api/pedidos"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "Authorization": "Bearer &lt;access_token&gt;",
};

let body = {
    "catalogoId": 5,
    "usuarioId": 3,
    "nombre": "Juan",
    "apellido": "Perez",
    "email": "juan.perez@gmail.com",
    "celular": "3326741051",
    "enviarEmail": true,
    "enviarSms": true,
    "numeroPedidoSap": 661122,
    "pedido": "[{\"incentivoId\": \"CIN-1\", \"cantidad\": 2, \"ids_unicos_canje\": [\"iduc_1\", \"iduc_2\"]}]",
    "orderId": 501122,
    "redeem_webhook_url": "https:\/\/www.mueller.com\/laborum-eius-est-dolor-dolores-minus-voluptatem",
    "redeem_webhook_key": "sufvyvddqamniihfqcoyn"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "success": true,
    "message": "",
    "order": "74459dcf-04fc-4c6f-ac04-a427adfee7c8",
    "detail": [
        {
            "proveedorId": 1,
            "incentivoId": "CIN-1",
            "sku": "154685",
            "nombre": "Entrada 2D L-D",
            "message": "",
            "codigos": [
                {
                    "descripcion": "Boleto Tradicional 2D Lunes a Domingo",
                    "instruccion": null,
                    "restriccion": null,
                    "duracion": null,
                    "debesSaber": null,
                    "personas": 1,
                    "incluye": null,
                    "ubicacion": null,
                    "imagen": null,
                    "pedidoId": null,
                    "codigo": "En proceso",
                    "pin": "En proceso",
                    "cantidad": 1,
                    "vigencia": "En proceso",
                    "voucherCode": null,
                    "precio": 65.05,
                    "moneda": "MXN",
                    "operacionId": "cc3961b8-7eac-404f-9b74-2fa398e42caf",
                    "numeroSerie": "b3bfb024-528b-426c-9bac-c7d8c652516a",
                    "proveedorId": 1,
                    "puntos": 195,
                    "canjeId": 1994,
                    "fechaEnvioCorreo": "2012-12-12 04:20:00",
                    "user_due_date": "En proceso"
                }
            ],
            "codigosExitosos": 1,
            "codigosFallados": 0
        }
    ]
}

Example response (401):


{
    "message": "Unauthorized, access token invalido"
}

Example response (403):


{
    "message": "Forbidden, sin permisos para realizar el canje"
}

Example response (422):


{
    "message": "The data given was invalid, el cuerpo de la solicitud es incorrecto"
}

Example response (500):


{
    "message": "Server error"
}

Request      

POST api/pedidos

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Authorization      

Example: Bearer <access_token>

Body Parameters

catalogoId   integer   

ID del catálogo. Al solicitar las credenciales de autenticación, solicitar tambien el ID del catálogo. Importante: el api user esta ligado a un catálogo y solo podrá canjear incentivos del mismo. Si es necesario realizar canjes de otros catálogos, deberá solicitarse a soporte agregar permisos adicionales de canje. Example: 5

actividadId   string  optional  
usuarioId   integer   

ID del usuario que solicita. Example: 3

nombre   string   

Nombre del usuario que solicita. Example: Juan

apellido   string   

Apellido del usuario que solicita. Example: Perez

email   string   

Email del usuario que solicita. Example: juan.perez@gmail.com

celular   string   

Número de Celular del usuario que solicita. Example: 3326741051

enviarEmail   boolean   

Definir si se enviarán los códigos por correo. Example: true

enviarSms   boolean   

Definir si se enviarán los códigos por SMS. Example: true

numeroPedidoSap   integer  optional  

Numero del pedido SAP. Es para uso interno de Adventa y puede omitirse. Example: 661122

pedido   string   

El pedido en si mismo en formato JSON. Example: [{"incentivoId": "CIN-1", "cantidad": 2, "ids_unicos_canje": ["iduc_1", "iduc_2"]}]

orderId   integer  optional  

Numero de orden Adbox. Es para uso interno de Adventa y puede omitirse. Example: 501122

dueDate   string  optional  

Define un tipo de vigencia. Valores permitidos: "default"(vigencio original del folio), "product" (vigencia del producto, definida en eRewards backend, suele ser falsa), "manual" (igual que product pero se ingresa manualmente). Por defecto será enviada la vigencia tipo "product".

dueDateText   string  optional  

Define la vigencia manual. Es mandatorio solamente si el parametro dueDate = manual.

inBlockRequestedBy   string  optional  

Define el solicitante del envio en bloques. Es opcional.

swapUidBypassed   string  optional  

Define si el campo ids_unicos_canje dentro del campo pedido será omitido. Es opcional.

redeem_webhook_url   string  optional  

Must be a valid URL. This field is required when redeem_webhook_key is present. Example: https://www.mueller.com/laborum-eius-est-dolor-dolores-minus-voluptatem

redeem_webhook_key   string  optional  

This field is required when redeem_webhook_url is present. El campo value debe contener al menos 4 caracteres. El campo value no debe contener más de 200 caracteres. Example: sufvyvddqamniihfqcoyn

Recurso: Categorías

Listar Categorías

Example request:
curl --request GET \
    --get "https://prod-apierewards.adventa.solutions/api/categorias" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --header "Authorization: Bearer &lt;access_token&gt;"
$client = new \GuzzleHttp\Client();
$url = 'https://prod-apierewards.adventa.solutions/api/categorias';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
            'Authorization' => 'Bearer <access_token>',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://prod-apierewards.adventa.solutions/api/categorias"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "Authorization": "Bearer &lt;access_token&gt;",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "success": true,
    "categorias": [
        {
            "id": 1,
            "categoriaId": 1,
            "nombre": "Experiencias",
            "descripcion": "Experiencias de Experimenta"
        }
    ]
}

Example response (401):


{
    "message": "Unauthorized, access token invalido"
}

Example response (422):


{
    "message": "The data given was invalid, el cuerpo de la solicitud es incorrecto"
}

Example response (500):


{
    "message": "Server error"
}

Request      

GET api/categorias

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Authorization      

Example: Bearer <access_token>

Recurso: Catálogos

Listar Catálogos

Example request:
curl --request GET \
    --get "https://prod-apierewards.adventa.solutions/api/catalogos-electronicos" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --header "Authorization: Bearer &lt;access_token&gt;"
$client = new \GuzzleHttp\Client();
$url = 'https://prod-apierewards.adventa.solutions/api/catalogos-electronicos';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
            'Authorization' => 'Bearer <access_token>',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://prod-apierewards.adventa.solutions/api/catalogos-electronicos"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "Authorization": "Bearer &lt;access_token&gt;",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
      "success": true,
      "catalogosElectronicos": [
          {
              "id": 50
              "catalagoId": 50,
              "nombre": "erewards",
              "factorConversionPuntos": 3,
              "fee": 0.2,
              "costoSms": 1.05,
              "comisionBanco": 0,
              "otrosCostos": 1,
              "tipo": "PMR",
              "estatus": true
          }]
 }

Example response (401):


{
    "message": "Unauthorized, access token invalido"
}

Example response (422):


{
    "message": "The data given was invalid, el cuerpo de la solicitud es incorrecto"
}

Example response (500):


{
    "message": "Server error"
}

Request      

GET api/catalogos-electronicos

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Authorization      

Example: Bearer <access_token>

Recurso: Productos

Listar Productos

Example request:
curl --request GET \
    --get "https://prod-apierewards.adventa.solutions/api/incentivos?catalogoId=5" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --header "Authorization: Bearer &lt;access_token&gt;" \
    --data "{
    \"catalogoId\": 11613.31890586
}"

$client = new \GuzzleHttp\Client();
$url = 'https://prod-apierewards.adventa.solutions/api/incentivos';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
            'Authorization' => 'Bearer <access_token>',
        ],
        'query' => [
            'catalogoId' => '5',
        ],
        'json' => [
            'catalogoId' => 11613.31890586,
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://prod-apierewards.adventa.solutions/api/incentivos"
);

const params = {
    "catalogoId": "5",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "Authorization": "Bearer &lt;access_token&gt;",
};

let body = {
    "catalogoId": 11613.31890586
};

fetch(url, {
    method: "GET",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "success": true,
    "incentivos": [
        {
            "incentivoId": "MAN-211",
            "proveedorId": 17,
            "categoriaId": 6,
            "clasificacion": "Códigos electrónicos",
            "sku": "CU005460",
            "nombre": "Tarjeta de regalo digital Starbucks $400 pesos",
            "marca": "Starbucks",
            "descripcion": "Tarjeta de regalo digital Starbucks $400 pesos. Tu código debe ser registrado en la aplicación de Starbucks para que puede ser utilizado como medio de pago en compras realizadas en tiendas. Consulta las instrucciones aquí --->>https://rewards.adventa.solutions\r\n",
            "instruccion": "1.\tDescarga la app \r\n2.\tSelecciona el dispositivo \r\n3.\tIngresa a tu cuenta o regístrate \r\n4.\tVe al apartado de ¨escanea¨\r\n5.\tAgrega la tarjeta en el botón + superior derecho\r\n6.\tAcude a tu sucursal y paga con el saldo de tu tarjeta",
            "restriccion": "La tarjeta de regalo digital Starbucks sólo puede ser utilizada como medio de pago en \r\ncompras realizadas en tiendas participantes (consulta en nuestra página web \r\nhttps://www.starbucks.com.mx/ la lista). Esta tarjeta/folio no es de crédito. No puede \r\nser canjeado por dinero en efectivo.",
            "ubicacion": null,
            "duracion": null,
            "personas": null,
            "actividad": null,
            "incluye": null,
            "considerar": null,
            "precio": 344.8,
            "ajustePrecio": 0.5,
            "precioVenta": 344.8,
            "precioVentaMasAjuste": 345.3,
            "precioVentaIntegrado": 392.9655,
            "precio_venta_integrado": 392.9655,
            "costo_producto": 320.7,
            "fee": 0.135,
            "tipo_producto": "incentivo",
            "moneda": "MXN",
            "puntos": 1962,
            "imagen": "https://e-rewards-images.s3.amazonaws.com/CU005460.jpg",
            "paquete": false,
            "cantidad": 0,
            "latitud": null,
            "longitud": null,
            "stock": 30,
            "unlimited": false,
            "codigo_sap": "661866679",
            "imagenesEspecificas": [
                "https://prod.erewards.adventa.solutions/variant-images/657342445273a65734244527e2.jpg",
                "https://prod.erewards.adventa.solutions/variant-images/65734244528e4657342445298b.jpg"
            ],
            "descripcionCortaEspecifica": "",
            "descripcionLargaEspecifica": "",
            "monto": 344.8,
            "joyBrandId": 0,
            "joyBrandName": ""
        }
    ]
}

Example response (401):


{
    "message": "Unauthorized, access token invalido"
}

Example response (403):


{
    "message": "Forbidden, no tiene permisos para consultar la informacion"
}

Example response (422):


{
    "message": "The data given was invalid, el cuerpo de la solicitud es incorrecto"
}

Example response (500):


{
    "message": "Server error"
}

Request      

GET api/incentivos

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Authorization      

Example: Bearer <access_token>

Query Parameters

catalogoId   string   

Al ser especificado, filtrará por el Id del catálogo. Cada API user podrá visualizar unicamente los incentivos del catálogo al que pertenece. Si es necesario consultar incentivos de otros catálogos, debera solicitarse a soporte para establecer permisos adicionales de consulta. Example: 5

Body Parameters

catalogoId   number   

Example: 11613.31890586

Recurso: Proveedores

Listar Proveedores

Example request:
curl --request GET \
    --get "https://prod-apierewards.adventa.solutions/api/proveedores" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --header "Authorization: Bearer &lt;access_token&gt;"
$client = new \GuzzleHttp\Client();
$url = 'https://prod-apierewards.adventa.solutions/api/proveedores';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
            'Authorization' => 'Bearer <access_token>',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://prod-apierewards.adventa.solutions/api/proveedores"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "Authorization": "Bearer &lt;access_token&gt;",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "success": true,
    "proveedores": [
        {
            "id": 1,
            "proveedorId": 1,
            "nombre": "Cinépolis",
            "terminosCondiciones": "Términos y condiciones https://bit.ly/2VjNoZk"
        }
    ]
}

Example response (401):


{
    "message": "Unauthorized, access token invalido"
}

Example response (422):


{
    "message": "The data given was invalid, el cuerpo de la solicitud es incorrecto"
}

Example response (500):


{
    "message": "Server error"
}

Request      

GET api/proveedores

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Authorization      

Example: Bearer <access_token>