Tipos de sección

El comerciante arma las secciones desde un panel donde cada tipo tiene un nombre en castellano. La API las devuelve con un identificador en minúsculas y guiones bajos. Son la misma cosa con dos nombres, y esta tabla es la traducción.

La tabla

En el panel	tipo en el JSON	Token de la clave	Documentación
Preguntas Frecuentes	FAQ	faq	Ver
Preguntas con imagen	FAQ_WITH_IMAGE	faq_with_image	Ver
Carrusel de imágenes	IMAGE_CAROUSEL	image_carousel	Ver
Carrusel de Especificaciones	SPECS	specs	Ver
FAQS de Especificaciones	SPECS_FAQ	specs_faq	Ver
Banner Características Técnicas	RICH_DESCRIPTION	rich_description	Ver
Grid Promocional	GRID_PROMOCIONAL	grid_promocional	Ver
Call to Action Banner	CALL_TO_ACTION_BANNER	call_to_action_banner	Ver
Banner de Características Clave	KEY_FEATURES_BANNER	key_features_banner	Ver
Banner Promocional	PROMO_MODAL	promo_modal	Ver
Beneficios Destacados	FEATURED_BENEFITS	featured_benefits	Ver
Productos relacionados	RELATED_PRODUCTS	related_products	Ver
Video Banner	VIDEO_BANNER	video_banner	Ver
Parallax Banner	PARALLAX_BANNER	parallax_banner	Ver
Banner de Garantía	WARRANTY_BANNER	warranty_banner	Ver
Preguntas frecuentes del producto	PRODUCT_FAQS	product_faqs	Ver
Carrusel de testimonios en video	VIDEO_REVIEWS	video_reviews	Ver

Las dos columnas del medio son el mismo identificador en dos convenciones: MAYUSCULAS_CON_GUION_BAJO en el campo tipo, minusculas_con_guion_bajo en la clave de sections. Para despachar por tipo usa tipo — el detalle está en la estructura de la respuesta.

Por qué te hablarán en los dos idiomas

Cuando un comerciante te diga “agrégame el Banner Características Técnicas”, en el JSON buscarás RICH_DESCRIPTION. Esta tabla es la que traduce esa conversación. Los nombres del panel también pueden cambiar sin que cambie el identificador: el contrato lo fija el tipo, no la etiqueta.

Lo que comparten todos

Sin importar el tipo, toda sección trae los mismos campos comunes —tipo, titulo, items, estado, orden, indice— y se rige por las mismas dos reglas:

1. La regla de render. Muéstrala solo si estado.lifecycle === 'active' && estado.storefrontVisible === true.
2. El orden. Ordénala por orden entre secciones, y los items por su propio orden.

Las dos están explicadas una sola vez en la estructura de la respuesta. Las páginas de aquí abajo no las repiten: se concentran en lo que cada tipo tiene de particular.

Cómo leer estas páginas

Cada página tiene la misma estructura:

• Shape — los campos, marcando qué puede ser null y qué puede faltar.
• Ejemplo — un JSON real, no inventado.
• Renderizar — solo la parte específica del tipo. El fetch, el filtro y el escape de texto son compartidos y viven en conectar una sección custom.
• Notas — las trampas propias de ese tipo.

Los ejemplos asumen dos helpers de ese módulo compartido: seccionesDeTipo(bundle, kind), que ya aplica la regla de render y el orden, y escapar(texto), que evita que el contenido del comerciante se inyecte como HTML.