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

# Bloque de protección de envío

> El bloque Shipping protection de Aftersell Cart: un complemento de protección opcional que registra la elección en el pedido.

> El bloque **Shipping protection** ofrece un complemento de protección de envío opcional que los compradores pueden activar en el carrito, permitiéndoles agregar protección contra daños, pérdida o robo durante el envío y registrando esa elección en el pedido para tus herramientas de cumplimiento o reclamaciones.

<div id="behavior">
  ## Comportamiento
</div>

* Agregar la protección hace dos cosas: agrega una **línea de producto real de Shopify** para el producto de protección y establece un atributo de carrito `_shipping_protected` en `true`.
* **Ese atributo sobrevive al checkout y llega al pedido** como un atributo de nota del pedido (`_shipping_protected`), para que tus herramientas de cumplimiento o reclamaciones puedan saber qué pedidos están protegidos.
* Los compradores pueden agregar y quitar la protección con el control, sin importar el tipo de visualización que elijas.
* **Si no existe una variante de protección utilizable, el bloque no renderiza nada** en lugar de mostrar un control que fallaría al hacer clic.

<div id="settings">
  ## Ajustes
</div>

| Ajuste           | Qué controla                                                                                                                                                  | Predeterminado                                                    |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| **Title**        | Encabezado de texto enriquecido. Admite `{{product_title}}` y `{{price}}`.                                                                                    | `<strong>{{product_title}}</strong>`                              |
| **Price label**  | La línea de precio, mostrada debajo del título. Admite `{{product_title}}` y `{{price}}`. Deja este campo vacío para ocultar la línea de precio por completo. | `{{price}}`                                                       |
| **Description**  | Texto de apoyo.                                                                                                                                               | `Protect your order from damage, loss, or theft during shipping.` |
| **Price**        | El precio de la protección (numérico, establece el monto cobrado).                                                                                            | `2.5`                                                             |
| **Product**      | El producto de protección (aprovisionado por la app).                                                                                                         | —                                                                 |
| **Display type** | Cómo aparece el control: **Toggle** o **Checkbox**.                                                                                                           | Toggle                                                            |

<div id="placement-and-limits">
  ## Ubicación y límites
</div>

* **Región:** cuerpo o parte inferior.
* **Máximo:** 1 por estado del carrito.
* **Estado:** solo carrito con artículos.
* No se agrega de forma predeterminada. No está bloqueado: puedes quitarlo u ocultarlo.

<div id="custom-template">
  ## Plantilla personalizada
</div>

Admite una [plantilla personalizada](/es/aftersell/cart/custom-templates) desde su pestaña Code, que reemplaza el marcado integrado de este bloque con tu JSX. Estas son las props que recibe.

| Prop              | Tipo                                 | Para qué sirve                                                                                                    |
| ----------------- | ------------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
| `isEnabled`       | `boolean`                            | Si la protección de envío está actualmente en el carrito.                                                         |
| `isPending`       | `boolean`                            | `true` mientras el agregado o la eliminación están en curso. Deshabilita tu control con esto.                     |
| `title`           | `string`                             | Título en texto plano. El respaldo cuando no hay título de texto enriquecido.                                     |
| `titleHtml`       | `string`                             | HTML sanitizado del título de texto enriquecido. Vacío cuando no hay.                                             |
| `descriptionHtml` | `string`                             | HTML sanitizado de la descripción de texto enriquecido. Vacío cuando no hay.                                      |
| `priceHtml`       | `string \| null`                     | HTML sanitizado del precio de texto enriquecido del campo de precio dedicado. `null` cuando ese campo está vacío. |
| `priceLabel`      | `string`                             | Etiqueta de precio formateada. Vacía cuando el precio no se muestra.                                              |
| `imageUrl`        | `string`                             | Imagen de la protección. Vacía cuando no hay.                                                                     |
| `ctaText`         | `string`                             | Etiqueta del botón, para el formato `button`.                                                                     |
| `format`          | `'button' \| 'checkbox' \| 'toggle'` | Cómo se inscribe el comprador. Ramifica tu marcado según esto.                                                    |
| `handleAdd`       | `() => void`                         | Agrega la protección al carrito. Para el formato `button`.                                                        |
| `handleToggle`    | `() => void`                         | Activa y desactiva la protección en el carrito. Para `checkbox` y `toggle`.                                       |
| `isLoading`       | `boolean`                            | `true` mientras el carrito todavía está haciendo su primera carga.                                                |

<Warning>
  `format` decide qué handler aplica: `handleAdd` para `button`, `handleToggle` para `checkbox` y `toggle`. Conectar el equivocado deja el control inerte para los comerciantes que eligieron el otro formato.
</Warning>

<div id="design">
  ## Diseño
</div>

Da estilo a este bloque con su sección **Design** en el panel de ajustes. Son overrides por bloque que se superponen a tu diseño global y recurren a él cuando están en blanco.

<div id="text">
  ### Text
</div>

La sección **Text** de Design te permite controlar la tipografía de tres elementos. Usa el selector **Text element** para alternar entre ellos.

**Title** — el encabezado de la protección. También admite una familia tipográfica personalizada. La negrita y el color del texto se establecen en el Rich Text Editor de arriba (en la pestaña Settings), no aquí.

| Ajuste             | Qué controla                      | Predeterminado  |
| ------------------ | --------------------------------- | --------------- |
| **Font**           | Familia tipográfica del título.   | Hereda del tema |
| **Size**           | Tamaño de fuente.                 | `15px`          |
| **Line height**    | Multiplicador de altura de línea. | `1.33`          |
| **Letter spacing** | Espaciado entre caracteres.       | Normal          |

**Price** — la línea de precio. La negrita y el color del texto se establecen en el Rich Text Editor de arriba.

| Ajuste             | Qué controla                      | Predeterminado |
| ------------------ | --------------------------------- | -------------- |
| **Size**           | Tamaño de fuente.                 | `15px`         |
| **Line height**    | Multiplicador de altura de línea. | `1.33`         |
| **Letter spacing** | Espaciado entre caracteres.       | Normal         |

**Description** — el texto de apoyo. La negrita y el color del texto se establecen en el Rich Text Editor de arriba.

| Ajuste             | Qué controla                      | Predeterminado |
| ------------------ | --------------------------------- | -------------- |
| **Size**           | Tamaño de fuente.                 | `14px`         |
| **Line height**    | Multiplicador de altura de línea. | `1.29`         |
| **Letter spacing** | Espaciado entre caracteres.       | Normal         |

<Tip>
  Al hacer clic en un elemento de texto directamente en la vista previa del carrito, se resalta y se abren sus controles en el panel automáticamente.
</Tip>

¿Qué son los ajustes de diseño? Obtén más información aquí: [Ajustes de diseño](/es/aftersell/cart/design-settings).
