# Guion del vídeo, para comentar o para lo que necesites.
# Es una PROYECCIÓN del nuestro: lleva el contenido —qué se dice, qué se ve, en
# qué orden y cuánto dura— y no la maquinaria que lo convierte en vídeo.
id: productos-paradas
title: 'Paradas: una carpeta de pagos con dirección propia'
audience: Desarrollador que necesita reunir varios pagos bajo una dirección permanente
objetivo: >
  Al terminar, el espectador entiende las dos caras de una Parada —carpeta para él, minisitio para
  su cliente—, sabe que el criterio de agrupación lo pone él y qué consecuencia tiene, sabe montar
  una y mantenerla con `replace`, y conoce las tres cosas que hoy no se pueden hacer.
cta: 'Siguiente: ''Solicitud de pago'' para lo que va dentro, o ''Usar el simulador''.'
target_duration_s: 305
storyboard:
  - 'n': 1
    on_screen: Cuando la dirección no tiene que morir
    narracion: >-
      No todo lo que necesita tu negocio termina en un pago suelto. A veces te conviene reunir
      varios pagos en un mismo sitio, para que tu cliente, con un solo clic, llegue directamente a
      la lista de todo lo que tiene pendiente contigo, sin buscar el enlace de cada uno en su correo
      o en su WhatsApp.
    visual: >-
      Varios enlaces sueltos perdidos en un correo y un chat, frente a una sola dirección que los
      reúne.
    duracion_s: 22
  - 'n': 2
    on_screen: 'Para ti: una carpeta con dirección'
    narracion: >-
      Eso es una Parada: una carpeta de pagos con una dirección web pegada. Tú la creas, y con ella
      nace su enlace, que no caduca, y vas metiendo y sacando lo que haga falta. La carpeta se
      queda; lo que hay dentro cambia.
    visual: >-
      Una carpeta con una dirección web anclada; dentro, sesiones que entran y salen mientras la
      carpeta se queda.
    duracion_s: 17
  - 'n': 3
    on_screen: 'Para tu cliente: un minisitio de pagos'
    narracion: >-
      Eso es lo que es para ti. Para tu cliente es otra cosa: un minisitio de pagos. Entra a una
      dirección que ya conoce y encuentra reunido todo lo suyo en un solo lugar. Paga lo que quiera,
      cuando quiera, y no tiene que registrarse en nada ni instalar nada.
    visual: 'La misma carpeta desde el otro lado: la pantalla del cliente con su lista reunida.'
    duracion_s: 19
  - 'n': 4
    on_screen: El criterio de agrupación lo pones tú
    narracion: >-
      El caso más evidente es una relación que se repite: una mensualidad, un servicio recurrente.
      Pero el criterio de agrupación lo pones tú, y ahí hay más de lo que parece. Una Parada no sabe
      nada de clientes: es una carpeta con una dirección. Puedes agrupar por proyecto, por período,
      por sucursal, por mesa de un restaurante — por lo que tenga sentido en tu negocio.
    visual: 'Cuatro criterios posibles de agrupación: un cliente, un proyecto, una sucursal, una mesa.'
    duracion_s: 25
  - 'n': 5
    on_screen: Y quien abra la dirección ve todo lo que contenga
    narracion: >-
      Pero al elegir el criterio, ten presente una cosa: quien abra la dirección ve todo lo que la
      carpeta contenga. Si agrupas cosas de personas distintas, cada una verá las de las demás. No
      es un límite que puedas configurar, es cómo funciona — y es lo que decide por ti si el
      criterio debe ser el cliente o puede ser otro. La URL es al portador: cualquiera que la tenga
      ve esa lista y puede pagarla.
    visual: Dos personas distintas mirando la misma lista, cada una viendo también lo de la otra.
    duracion_s: 30
  - 'n': 6
    on_screen: Cómo se monta
    visual: Lámina de sección, sin voz.
    duracion_s: 3
  - 'n': 7
    on_screen: 1 · Crea la parada
    narracion: >-
      Montarla son dos pasos. El primero: creas la parada, y puedes crear varias de una vez. Le
      pones un título, que es lo que se ve como encabezado de la página, y tu propia referencia
      interna, que es con la que la vuelves a encontrar. La respuesta trae lo único que hay que
      guardar: su identificador y su dirección. Y guárdala tal cual viene, no la construyas.
    visual: Terminal creando la parada; en la respuesta, el stop_id y la stop_url resaltados.
    duracion_s: 26
  - 'n': 8
    on_screen: Tu referencia interna se le MUESTRA
    narracion: >-
      Y una advertencia sobre esa referencia interna: aparece como subtítulo de cada solicitud en la
      página de tu cliente. No metas ahí notas internas, códigos de riesgo, ni nada que no le dirías
      a la cara. Úsala para lo que es: un número de contrato, un código de cliente.
    visual: La referencia interna apareciendo como subtítulo en la pantalla del cliente.
    duracion_s: 19
  - 'n': 9
    on_screen: 2 · Pon las solicitudes dentro
    narracion: >-
      El segundo paso: pones las solicitudes dentro, y también son dos movimientos. Primero creas
      las solicitudes con su fecha, como cualquier otra. Y después las asocias a la parada, con una
      sola llamada por lote.
    visual: Las solicitudes creándose primero, y luego colgándose de la parada.
    duracion_s: 13
  - 'n': 10
    on_screen: add · remove · replace · clear
    narracion: >-
      Esa llamada admite cuatro operaciones, y elegir bien te simplifica mucho el código. Añadir
      suma a lo que ya hay. Quitar retira las que digas. Vaciar deja la carpeta limpia. Y reemplazar
      deja exactamente la lista que mandes — que es la que quieres si tienes un sistema de cartera:
      mandas el estado completo de la deuda de ese cliente hoy, y no necesitas recordar qué le
      enviaste el mes pasado. Repetir la misma llamada deja el mismo resultado.
    visual: Las cuatro operaciones en fila, con replace destacada.
    duracion_s: 30
  - 'n': 11
    on_screen: El orden decide qué paga primero
    narracion: >-
      Y hay una operación más que conviene conocer: reordenar. Fija en qué orden las ve tu cliente,
      que es tanto como decir qué le pones delante para que pague primero.
    visual: Una lista reordenada, con la primera solicitud destacada como la que se paga primero.
    duracion_s: 12
  - 'n': 12
    on_screen: Cómo consultas la cartera
    visual: Lámina de sección, sin voz.
    duracion_s: 3
  - 'n': 13
    on_screen: Cuántas debe cada uno, sin abrir nada
    narracion: >-
      Con la parada montada, queda mirarla. El listado te da todas tus paradas con filtros por
      estado, por texto, por tu referencia exacta y por rango de fechas. Y cada una trae cuántas
      solicitudes pendientes tiene, sin que tengas que abrirla. El detalle de una te da sus
      solicitudes vivas, en orden, con la dirección de pago de cada una.
    visual: El listado de paradas con su contador de solicitudes activas, sin abrir ninguna.
    duracion_s: 23
  - 'n': 14
    on_screen: Pero el estado real está en la sesión
    narracion: >-
      Con una precisión importante antes de conciliar: esa lista describe lo que se le muestra a tu
      cliente. Para saber si una solicitud sigue viva, está pagada o venció, consúltala por su
      sesión, que es la fuente del estado.
    visual: Lo que se muestra al cliente frente a la fuente real del estado, señalada aparte.
    duracion_s: 15
  - 'n': 15
    on_screen: Tres cosas que hoy no puedes hacer
    narracion: >-
      Y quedan tres operaciones que el contrato declara y todavía no están operativas: modificar una
      parada, consultar su histórico de pagos, y consultar varias de una vez. Para las tres, la guía
      te da la alternativa mientras tanto. Pero la primera tiene una consecuencia que conviene saber
      antes: el título y la referencia que pongas al crear la parada no se pueden cambiar después.
      Piénsalos antes.
    visual: Tres operaciones del contrato marcadas como no operativas, con su alternativa al lado.
    duracion_s: 25
  - 'n': 16
    on_screen: Todo lo demás funciona igual
    narracion: >-
      Por lo demás, nada cambia: cada pago sobre una parada sigue el mismo ciclo de vida y las
      mismas dos fases que cualquier otro, y dispara los mismos avisos. Eso sí, en el simulador las
      Paradas responden con la forma del contrato pero no mantienen su estado: para ejercitar el
      ciclo completo de una parada, usa el entorno de pruebas.
    visual: Cierre de marca; un pago sobre una parada recorriendo el mismo ciclo que cualquier otro.
    duracion_s: 23
