Edicion de setup de cliente

La pantalla Edit client (/v2/c/:slug/setup-edit) es el wizard de 6 pasos para ajustar el setup de un cliente existente. Precarga nombre, slug, branding, moneda, timezone y campo de atribucion del cliente, y al guardar actualiza su configuracion.

Flujo

---

Paso 1: Informacion basica

Identificadores y branding del cliente:

• Name (requerido) y Slug (requerido). El slug solo acepta minusculas, digitos y guiones; en edicion no se auto-deriva del nombre.
• Default currency: MXN, USD, COP, BRL, ARS, CLP o EUR.
• Timezone: opciones predefinidas (default America/Mexico_City).
• Branding: Logo URL, color primario y color secundario, con preview en vivo (logo o iniciales + /v2/c/{slug}).

Paso 2: Data source

De donde vienen los eventos de conversion:

• Selector de tipo: AppsFlyer, Adjust, Branch, Singular, Kochava, Custom S2S o Web Pixel.
• Para MMP/S2S: credenciales (source name, sync frequency hourly/daily/manual, API token requerido, App ID) y boton Test connection con estados ok / error / endpoint no configurado.
• Para Web Pixel: dominio (sin prefijo https://), jurisdiccion de privacidad (MX, LatAm, EU, UK, California, custom) y eventos habilitados (page_view, view_product, add_to_cart, begin_checkout, purchase, lead_submit, form_submit).

Paso 3: Segmentos y reglas

• Aplicar un template predefinido o trabajar en modo Custom (define manualmente).
• Cada segmento tiene color, codigo, nombre y orden; se pueden agregar y eliminar. Debe existir al menos uno para continuar.
• Segment rules: patrones que clasifican productos en segmentos al ingerir (contains, exact, starts with, ends with, regex) con valor de match y prioridad. Sin reglas, los productos caen en OTHER.

Paso 4: Atribucion (solo no-pixel)

Se omite cuando el data source es pixel.

• Campo del CSV/postback contra el que se matchean los CIDs de los partners: campaign (default), media_source, adset, ad, sub2, af_channel o af_siteid.
• El primer partner cuyo CID matchea gana; si no hay match, la venta queda unattributed.

Paso 5: Comisiones default

• Una fila por segmento con valor numerico y toggle % of revenue / $/unit.
• Son el fallback cuando un partner no tiene rate personalizado.

Paso 6: Revision y ledger

• Resumen por secciones: basics, data source (token oculto), segmentos/reglas, atribucion y comisiones.
• Ledger source (opcional): conecta el sistema de billing del cliente al motor de reconciliacion. Tipos: Samsung XLSX, Stripe webhook, Optimal CSV, Quote API, generic webhook o manual upload.
• Si se elige un tipo: display name, config en JSON (bloquea el guardado si es invalido) y cron opcional. Los secrets van como refs vault:// o env://, nunca en texto plano.

Guardar y cancelar

• Footer sticky con Back / Next (Next valida el paso actual; los errores aparecen en banner).
• El stepper permite regresar a pasos anteriores, no saltar adelante.
• El boton final envia los cambios; en modo edicion muestra la pantalla Client updated (con warnings del servidor si los hay) y redirige automaticamente a /v2/c/:slug.
• Exit y Back to Clients salen del wizard sin guardar.

Estados especiales

• Loading: skeleton mientras se resuelve y carga el cliente (Loading client...).
• Error: si el cliente no existe o no tienes acceso, se muestra un card "Failed to load client".
• Los cambios de segmentos, reglas y comisiones del dia a dia se gestionan en sus tabs dedicados del cliente; este wizard es la superficie de rename / rebrand / cambio de campo de atribucion.

---

¿Necesitas ayuda?

Si la pantalla no carga el cliente, verifica que accedas desde /v2/c/:slug/setup-edit con un slug valido. Si el guardado falla, revisa el banner de error o el JSON del ledger source.