> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Cambios en el contrato de la API de Lerian SPI

> Cuatro cambios en el contrato de la API entregados en Lerian SPI 1.0.0: el header de idempotencia, dos consultas en POST, casos MED en DICT y una ruta separada para el participante directo.

<Badge stroke icon="calendar-days" iconType="regular">30 de septiembre de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Actualización de producto</Badge> <Badge color="purple" size="lg" stroke icon="eye" iconType="regular">Acción requerida</Badge>

## Afecta a

***

Equipos que se integraron con la API de Lerian SPI antes de estos cambios.

## Qué cambió

***

Lerian SPI 1.0.0, publicado el 29 de septiembre de 2026, incluye estos cambios.

**El header de idempotencia cambió a `X-Idempotency`.** Las APIs SPI, DICT, BR Code y Core dejaron de leer `Idempotency-Key` y empezaron a leer la clave de idempotencia de `X-Idempotency`. Una solicitud que llevaba solo `Idempotency-Key` pasó a rechazarse como una solicitud sin clave.

**Dos consultas pasaron a `POST`.** La lista de Pix recibidos pasó de `GET /api/v1/spi/pix` a `POST /api/v1/spi/pix`, y los filtros `cpf` y `cnpj` pasaron al cuerpo JSON de la solicitud. Las estadísticas de persona pasaron de `GET /api/v1/dict/persons/{taxId}/statistics` a `POST /api/v1/dict/persons/statistics`, con `taxId` en el cuerpo JSON de la solicitud.

**Se eliminaron las rutas de casos MED de Core.** Se eliminaron las ocho rutas bajo `/api/v1/core/med`.

**El participante directo pasó a su propia ruta.** `POST /api/v1/core/participants/` dejó de aceptar un participante directo, y el registro del participante directo pasó a la ruta administrativa `POST /api/v1/core/participants/direct`.

## Impacto

***

**Clasificación: Acción requerida.** Un cliente que todavía envía `Idempotency-Key`, llama a una de las dos consultas `GET`, llama a una ruta MED de Core o envía un participante directo a `POST /api/v1/core/participants/` recibe un error.

## Qué debes hacer

***

* Envía la clave de idempotencia en `X-Idempotency`.
* Llama a la lista de Pix recibidos con `POST`, con `cpf` y `cnpj` en el cuerpo JSON y los demás filtros todavía en la query.
* Llama a las estadísticas de persona con `POST`, con `taxId` en el cuerpo JSON.
* Pide a un administrador autorizado que registre un participante directo en `POST /api/v1/core/participants/direct`; `POST /api/v1/core/participants/` acepta solo participante indirecto.
* Atiende los casos MED a través de la API DICT.

## Recursos

***

* [¿Qué es Lerian SPI?](/es/rails/spi/what-is-lerian-spi)
* [Cómo funciona Lerian SPI](/es/rails/spi/how-spi-works)
* [Lista de errores de SPI](/es/reference/rails/spi/spi-error-list)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.