Conceptos

Disponibilidad del contrato

Qué significa la insignia de cada operación y qué responde una operación declarada que no atiende la petición.

El contrato de la API de Partners v1 se publica completo desde el primer día, aunque no todas sus operaciones funcionen todavía. Cada operación lleva una insignia que sale del contrato publicado y dice su estado; las guías no lo repiten en el texto, para que nunca se desfase. Por ejemplo:

DisponiblePOST /partners/v1/auth/login Ver operación en la Referencia →

Los tres estados

InsigniaQué significa
DisponibleLa operación funciona completa.
ParcialFunciona con una parte de las formas del contrato; una forma que aún no acepta responde 501.
En caminoEstá declarada en el contrato, con su esquema, pero todavía no se publica: responde 501.

El estado de cada operación, al día, está en Estado del contrato y en la Referencia.

El 501 NOT_AVAILABLE_YET

Una operación en camino, o una forma de la petición que una operación parcial todavía no acepta, responde 501 con el código NOT_AVAILABLE_YET y no crea ni cambia nada:

{
  "statusCode": 501,
  "message": "Esta operación aún no está disponible. Se habilitará cuando su funcionalidad se publique.",
  "code": "NOT_AVAILABLE_YET"
}

Cuando la operación es parcial, el mensaje nombra el motivo: Esta forma de la petición aún no está disponible: <motivo>.

No es reintentable: la misma petición dará 501 mientras la insignia de la operación no cambie. No lo trates como una falla temporal (Reintentos).

Cuándo cambia

Cuando una operación cambia de estado, cambia su insignia en el contrato publicado y en este portal, y queda registrada en Cambios del contrato.

Copyright © 2026