Objeto cart

Una sola forma de objeto fluye por todo el SDK. Es lo que getCart() devuelve, lo que cart_loaded y cart_updated entregan a tu handler, y lo que recibe un bloque Custom code.

Todo el dinero está en la unidad menor de la moneda (centavos para USD), nunca una cadena formateada. 5779 es $57.79. Usa formatMoney para mostrarlo.

El carrito

Campo	Tipo	Descripción
`token`	`string`	El token del carrito de Shopify.
`items`	`AftersellCartLine[]`	Las líneas de artículos. Consulta líneas del carrito.
`itemCount`	`number`	Cantidad total de artículos, como la ve el comprador.
`hasSubscriptionItems`	`boolean`	`true` cuando al menos una línea en `items` lleva un plan de venta, incluyendo líneas de complemento que `itemCount` omite. `false` en un carrito vacío.
`totalPrice`	`number`	Total actual, en centavos.
`originalTotalPrice`	`number`	Total antes de descuentos, en centavos.
`totalDiscount`	`number`	Total de descuentos, en centavos.
`compareAtTotalPrice`	`number \| null`	Suma del precio de comparación (MSRP) de cada línea × cantidad, en centavos. `null` cuando no está disponible, así que recurre a `originalTotalPrice`.
`currency`	`string`	Código de moneda.
`discountCodes`	`string[]`	Códigos de descuento aceptados en el carrito, ordenados. `[]` cuando no hay ninguno.
`attributes`	`Record<string, string>`	Atributos del carrito. De solo lectura desde el SDK.

itemCount no siempre es la suma de items. items refleja el carrito real de Shopify, incluyendo líneas de complemento que el drawer oculta, como la protección de envío. itemCount es el número visible para el comprador que coincide con la insignia del carrito. Para “cuántas cosas ha elegido el comprador”, usa itemCount; para iterar sobre las líneas que el carrito está renderizando, usa items.Dos cosas faltan por completo en items: las líneas ocultas con setHidden, y los hijos de bundle, que se mueven a su ancla. Ambos siguen contando para los totales del carrito, que vienen directamente de Shopify.

window.aftersell.cart.events.on('cart_updated', (state) => {
  console.log(state.itemCount, 'items');
  console.log('Total:', window.aftersell.cart.actions.formatMoney(state.totalPrice));
  console.log('Saved:', window.aftersell.cart.actions.formatMoney(state.totalDiscount));
  console.log('Codes:', state.discountCodes.join(', ') || 'none');
});

Líneas del carrito

Cada entrada en items, y el item en item_added e item_removed:

Campo	Tipo	Descripción
`key`	`string`	La key de Shopify de la línea. Pásala a las acciones de artículos.
`productId`	`number`	ID del producto de Shopify.
`variantId`	`number`	ID de la variante de Shopify.
`handle`	`string`	Handle del producto.
`title`	`string`	Título de visualización.
`productTitle`	`string`	Título del producto sin la variante.
`variantTitle`	`string \| null`	Etiqueta de la variante, o `null`.
`variantOptions`	`Array<{ name, value }>`	Opciones seleccionadas, p. ej. `[{ name: 'Size', value: 'Medium' }]`. Shopify emite `Title: Default Title` para un producto de una sola variante.
`quantity`	`number`	Cantidad de esta línea.
`linePrice`	`number`	Precio de la línea, en centavos.
`finalLinePrice`	`number`	Precio de la línea después de descuentos, en centavos.
`originalLinePrice`	`number`	Precio de la línea antes de descuentos, en centavos.
`compareAtPrice`	`number \| null`	Precio de comparación (MSRP) de la variante por unidad, en centavos. `null` cuando no hay ninguno.
`properties`	`Record<string, string> \| null`	Propiedades de la línea de artículo.
`internalProperties`	`Record<string, string>`	Superposición de solo renderizado de `registerLineTransform`. Nunca se persiste en Shopify. `{}` cuando no hay ninguna.
`discountAllocations`	`Array<{ title, amount }>`	Descuentos aplicados a esta línea. `amount` está en centavos. `[]` cuando no hay ninguno.
`isGiftCard`	`boolean`	Si la línea es una tarjeta de regalo.
`sellingPlan`	`{ id, name } \| null`	El plan de suscripción activo, o `null` para una compra única.
`bundle`	`AftersellCartBundle \| null`	View model del bundle en la línea ancla; `null` en líneas que no son bundle y en los hijos.
`metadata`	`Record<string, unknown>`	Datos de enriquecimiento indexados por `id` del enriquecedor. `{}` hasta que un enriquecedor lo llena.

properties puede llevar entrada proporcionada por el comprador, como el campo de texto personalizado de un formulario de producto. Renderízalo como texto, nunca como HTML sin procesar.

Identificar una línea

Usa key para cualquier cosa que actúe sobre una línea, y variantId o productId para cualquier cosa que identifique un producto:

// ✅ Acting on a line: use key.
window.aftersell.cart.actions.removeItem(line.key);

// ✅ Recognising a product: use variantId.
const hasGift = state.items.some((line) => line.variantId === GIFT_VARIANT_ID);

La misma variante puede aparecer en varias líneas cuando las propiedades difieren. Dos tazas grabadas con distinto texto de grabado son dos líneas que comparten un mismo variantId. Por eso las acciones toman key.

Precios en una línea

Tres precios, fáciles de confundir:

Quieres	Usa
Lo que el comprador paga por esta línea	`finalLinePrice`
Lo que costaba antes de los descuentos del carrito	`originalLinePrice`
El tachado de MSRP, por unidad	`compareAtPrice` × `quantity`

// Is this line discounted?
const isDiscounted = line.finalLinePrice < line.originalLinePrice;

// Is it free? (A common way to detect a gift line.)
const isFree = line.finalLinePrice === 0;

Bundles

Cuando las líneas se agrupan en un bundle, la línea ancla lleva un objeto bundle. Los hijos se pliegan dentro de él y ya no aparecen en items por su cuenta. Consulta Agrupar líneas de bundle de otra app para ver cómo se configura la agrupación.

Campo	Tipo	Descripción
`id`	`string`	Identificador del bundle.
`source`	`'native' \| 'grouped'`	Un bundle nativo de Shopify, o líneas agrupadas por Aftersell.
`memberKeys`	`string[]`	La `key` de cada línea del bundle.
`children`	`AftersellBundleChild[]`	El contenido del bundle.
`displayPrice`	`number`	El precio mostrado para el bundle, en centavos.

Cada hijo lleva key (null para un componente nativo), title, variantTitle, quantity, perAnchorQty, imageUrl, finalLinePrice, originalLinePrice y compareAtPrice.

// Skip bundle children when totalling your own line list.
const topLevel = state.items.filter((line) => !isBundleChild(line, state));

Planes de suscripción

El plan activo de una línea es sellingPlan, o null para una compra única. Para una respuesta a nivel de todo el carrito, lee hasSubscriptionItems en lugar de escanear las líneas tú mismo, ya que también cuenta líneas de complemento que items presenta pero itemCount omite:

if (state.hasSubscriptionItems) {
  // The cart contains at least one subscription line.
}

const subscriptions = state.items.filter((line) => line.sellingPlan);
console.log(subscriptions.length, 'subscription lines');

Los planes disponibles en una línea, los del selector, no están en el objeto cart. Dales forma con registerSubscriptionOptionsTransform y registerDefaultSubscriptionOptionSelector.

Adónde ir después

Acciones: lee y cambia el carrito.
Eventos: de dónde viene este objeto.
Hooks: agrega tus propios datos a una línea con un enriquecedor.
Casos de uso: soluciones completas que leen estos campos.

Primeros pasos

Página de inicio

Mejores prácticas

Ventas adicionales poscompra

Carrito

Ventas adicionales en el pago (Shopify Plus)

Página de agradecimiento

Ventas adicionales en la página de producto

Rokt Thanks

Estrategias

Analíticas y seguimiento

Integraciones

Aftersell MCP

Facturación y cuenta

Solución de problemas

El carrito

Líneas del carrito

Identificar una línea

Precios en una línea

Bundles

Planes de suscripción

Adónde ir después

​El carrito

​Líneas del carrito

​Identificar una línea

​Precios en una línea

​Bundles

​Planes de suscripción

​Adónde ir después

El carrito

Líneas del carrito

Identificar una línea

Precios en una línea

Bundles

Planes de suscripción

Adónde ir después