---
title: "Modelo de plan de lealtad | Documentación de Ordering.co"
description: "Un plan de lealtad define cómo se acumula y canjea el valor de lealtad, y puede asignar configuraciones específicas por negocio."
canonical: https://docs.ordering.co/es/api-reference/guides/loyalty-level-model/
---

# Modelo de plan de lealtad

Un plan de lealtad define cómo se acumula y canjea el valor de lealtad, y puede asignar configuraciones específicas por negocio. El nombre del archivo archivado dice “level”, pero esta página describe el recurso `LoyaltyPlan`.

## Operaciones principales

| Acción     | Método   | Recurso                            |
| ---------- | -------- | ---------------------------------- |
| Listar     | `GET`    | `/loyalty_plans`                   |
| Consultar  | `GET`    | `/loyalty_plans/{loyalty_plan_id}` |
| Crear      | `POST`   | `/loyalty_plans`                   |
| Actualizar | `POST`   | `/loyalty_plans/{loyalty_plan_id}` |
| Eliminar   | `DELETE` | `/loyalty_plans/{loyalty_plan_id}` |

La lectura de detalle y todas las mutaciones requieren autenticación de administrador.

## Campos representativos

Los campos principales del plan incluyen `id`, `name`, `type`, `redemption_rate`, `accumulation_rate`, `maximum_redemption_type`, `maximum_redemption_rate`, `maximum_accumulation`, `expire_after_minutes`, `created_at` y `updated_at`.

La creación también acepta `businesses`, cuyas entradas pueden aplicar `redeems`, `accumulates`, tasas, límites máximos y ajustes de vencimiento específicos por negocio. Consulta [Modelo de planes de lealtad por negocio](https://docs.ordering.co/es/api-reference/guides/business-loyalty-plans-model/).

El archivo registra `maximum_redemption_type` con los valores `1` y `2`, pero no define sus significados de forma fiable. El significado de estos valores numéricos no está confirmado; comprueba la configuración de lealtad antes de usarlos.

## Propiedades del esquema

**Esquema:** `LoyaltyPlan`

| Nombre                    | Tipo            | Descripción |
| ------------------------- | --------------- | ----------- |
| `accumulation_rate`       | number \| null  | —           |
| `created_at`              | string \| null  | —           |
| `expire_after_minutes`    | any             | —           |
| `id`                      | integer \| null | —           |
| `maximum_accumulation`    | number \| null  | —           |
| `maximum_redemption_rate` | number \| null  | —           |
| `maximum_redemption_type` | any             | —           |
| `name`                    | any             | —           |
| `redemption_rate`         | number \| null  | —           |
| `type`                    | any             | —           |
| `updated_at`              | string \| null  | —           |