Gestionar el ciclo de vida del checkout
Renombra, publica, despublica, archiva, restaura o promueve un checkout mediante su código de checkout
name, description, status e is_default; se requiere al menos un campo. Los metadatos (name/description) se pueden editar en cualquier estado, incluido ARCHIVED; la configuración y los estilos de un checkout archivado permanecen congelados (el endpoint Publish lo rechaza).
Máquina de estados del ciclo de vida
- Publicar (
status: PUBLISHED) solo es válido desdeNOT_PUBLISHED. - Restaurar se hace en dos pasos: un checkout
ARCHIVEDvuelve primero a borrador (status: NOT_PUBLISHED) y luego se puede publicar (status: PUBLISHED). Un patch directo deARCHIVED → PUBLISHEDse rechaza con400 INVALID_STATUS_TRANSITION. - Hacer patch al estado actual también se rechaza con
400. - Promover (
is_default: true) publica a la fuerza el checkout desde cualquier estado (incluidoARCHIVED) y degrada de forma atómica al predeterminado anterior. Cuando se envía junto constatus, prevalece la promoción ystatusse ignora.is_default: falsese rechaza con400; para degradar un checkout predeterminado, promueve otro checkout. - El checkout predeterminado está protegido: archivarlo o despublicarlo se rechaza con
409para que la tienda de la cuenta nunca se quede sin un checkout activo.
Autorizaciones
Encabezados
Parámetros de ruta
Cuerpo
Estado de ciclo de vida de destino. PUBLISHED solo se alcanza desde NOT_PUBLISHED; NOT_PUBLISHED se alcanza desde PUBLISHED (despublicar) o ARCHIVED (restaurar); ARCHIVED se alcanza desde PUBLISHED o NOT_PUBLISHED. Cualquier otra transición (incluida la actualización al estado actual) se rechaza con 400. Los valores desconocidos se rechazan con 400.
PUBLISHED, NOT_PUBLISHED, ARCHIVED Respuesta
El resumen del checkout actualizado. El identificador se expone como el id de nivel superior. Consulta el status resultante con el endpoint Fetch.