---
title: "Modelo de niveles de lealtad | Documentación de Ordering.co"
description: "Un nivel de lealtad representa una etapa dentro de una progresión, con su propio umbral, beneficios y comportamiento de acumulación."
canonical: https://docs.ordering.co/es/api-reference/guides/loyalty-levels-model/
---

# Modelo de niveles de lealtad

Un nivel de lealtad representa una etapa dentro de una progresión, con su propio umbral, beneficios y comportamiento de acumulación.

## Operaciones principales

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

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

## Campos representativos

Los campos principales incluyen `id`, `name`, `description`, `benefits`, `minimum_points`, `accumulation_rate`, `maximum_accumulation_percentage`, `maximum_accumulation_fixed`, `expire_after_minutes`, `image`, `created_at` y `updated_at`.

`minimum_points` marca el umbral del nivel, mientras que `accumulation_rate` y los campos que limitan la acumulación controlan su comportamiento. El significado de la acumulación máxima puede variar según la operación; comprueba la descripción del campo antes de usarlo.

Consulta [Crear un nivel de lealtad](https://docs.ordering.co/es/api-reference/guides/create-loyalty-level/) y [Obtener los niveles de lealtad](https://docs.ordering.co/es/api-reference/guides/get-all-loyalty-levels-list/).

## Propiedades del esquema

**Esquema:** `LoyaltyLevel`

| Nombre                            | Tipo                    | Descripción |
| --------------------------------- | ----------------------- | ----------- |
| `accumulation_rate`               | number \| null          | —           |
| `benefits`                        | object \| array \| null | —           |
| `created_at`                      | string \| null          | —           |
| `description`                     | any                     | —           |
| `expire_after_minutes`            | any                     | —           |
| `id`                              | integer \| null         | —           |
| `image`                           | any                     | —           |
| `maximum_accumulation_fixed`      | number \| null          | —           |
| `maximum_accumulation_percentage` | number \| null          | —           |
| `minimum_points`                  | integer \| null         | —           |
| `name`                            | any                     | —           |
| `updated_at`                      | string \| null          | —           |