SMART CONNECTION
Banco · Marketplace SMC
Documento 02 · Marketplace SMC

Business
Blueprint

12 procesos end-to-end · cómo opera el negocio · NO cómo se construye el software.

Versión
1.0
Fecha
2026-05-25
Autor
Functional-Lead + Cerebro
Status
🟢 Activo
Tabla de contenidos

Índice

  1. 00 · Mapa visual end-to-end03
  2. 00b · Procesos interactivos · 14 procesos · stock propio + dropshipping04
  3. Procesos transversales (T1-T5)19

00Mapa visual end-to-end

P01 · Sourcing Lab Inversión · SoloTodo P02 · Compra Local Chile · Nexport (Y2) P03 · Recepción QA · stock P04 · Publicación cross-canal 4 canales · 1 click P05 · MeLi B2C Webhook · reputación P06 · D2C Storefront propio P07 · B2G Mercado Público P08 · B2B Quote builder P09 · Fulfillment / Despacho Picking · packing · courier P11 · DTE Boleta · factura SII P10 · Devolución Opcional · NC 61 P12 · Cobranza CxC monitoring
listo

02bbp-procesos-section

00bProcesos interactivos · 14 procesos · stock propio + dropshipping

Seleccioná uno de los 12 procesos (P01-P12) para ver su pipeline detallado. Click en cualquier paso para ver stack · acciones · errores comunes.

03p1

P01Sourcing · búsqueda de productos

ActorOperador + IA Cerebro (sugerencias)

TriggerAmpliar catálogo · stock bajo · oportunidad detectada

Inputskeyword · presupuesto · márgenes mínimos

OutputsBrief Sourcing (PDF + DB)

Pasos

  1. Operador define categoría/nicho a explorar (ej: "audífonos bluetooth")
  2. Sistema consulta histórico rotación SKUs similares
  3. IA sugiere keywords trending MeLi · precios competencia · márgenes
  4. Operador filtra: 3-5 candidatos
  5. Sistema arma "Brief Sourcing" con specs · MOQ · precio target
  6. Brief queda en /sourcing/briefs/{id} · pasa a P02

Eventossourcing.brief.created

KPIstime-to-brief · % briefs que llegan a compra

04p2

P02Compra a Nexport (intermediario importador)

ActorOperador + Nexport

TriggerBrief Sourcing aprobado

InputsBrief aprobado

OutputsOC · pago registrado · shipment

Pasos

  1. Operador envía Brief a Nexport (WhatsApp · email · portal)
  2. Nexport cotiza en CLP+IVA + lead time
  3. Operador registra cotización en /sourcing/quotes/{id}
  4. Operador emite OC en Hub con términos pago (ej: 50% adelanto · 50% B/L)
  5. Transferencia primer pago · registro CxP
  6. Nexport confirma · envía tracking estimado
  7. Hub crea registro shipment /sourcing/shipments/{id} con ETA

💡 Notas legales

  • Factura llega de Nexport (proveedor chileno · CLP + IVA 19%)
  • IVA crédito se acumula en F29 mes correspondiente
  • NO hay tipo de cambio · NO hay aduana de tu lado

Eventospurchase.po.created · purchase.payment.made · purchase.shipment.in-transit

KPIstime-to-PO · % OC en plazo · variación precio

05p3

P03Recepción en bodega

ActorOperador (o bodeguero futuro)

TriggerLlegada física de mercadería

InputsMercadería + OC referenciada

OutputsStock disponible + acta firmada

Pasos

  1. Recibe paquete · verifica embalaje
  2. Hub → /warehouse/recepcion → escanea código OC (QR de P02)
  3. Hub muestra lista esperada (SKU · cantidad · descripción)
  4. Cuenta físicamente · marca cada SKU como recibido
  5. Si discrepancia (cantidad menor · daños) → registra novedad + foto
  6. Asigna ubicación física (rack · pasillo · bin)
  7. Hub actualiza inventory.physical_stock · genera etiquetas barcode
  8. Genera Acta de Recepción PDF (firmable digital)

📒 Asiento contable automático

DEBE: Mercadería (existencia) por valor neto compra

HABER: Proveedores (Nexport) por valor compra

+ asiento separado IVA crédito si aplica

06p4

P04Publicación cross-canal

ActorOperador + Sistema (auto-publish)

TriggerProducto nuevo en inventario · o publicar existente en canal nuevo

Pasos

  1. Operador entra a /inventory/sku/{id} · "Publicar en canales"
  2. Hub muestra checklist: MeLi · D2C · Mercado Público · B2B · Falabella (si conectados)
  3. Operador marca canales destino
  4. Hub aplica price-rules por canal (landed cost + markup + comisión + IVA)
  5. Operador revisa precio sugerido por canal · ajusta si quiere
  6. Hub llama al adapter de cada canal seleccionado
  7. Cada adapter responde OK/error · Hub registra estado en inventory.channel_sync_status

🎯 Premisa core

publicar en N canales = 1 click. No 4 forms.

07p5

P05Venta MeLi (B2C marketplace ajeno)

Flujo

  1. MeLi envía webhook a /api/webhooks/meli con orden nueva
  2. Hub valida HMAC · crea registro orders con channel='meli'
  3. Hub reserva stock (inventory.reservations +1)
  4. Cliente queda como customers con is_meli_anonymous=true
  5. Hub crea task fulfillment → cola /fulfillment/pendientes
  6. Operador gestiona despacho (P09)
  7. MeLi confirma pago liberado (14-21 días) → registro payments status=paid
  8. CxC contra MeLi se actualiza

⚠️ Excepciones críticas

  • Webhook duplicado · check idempotency obligatorio
  • Stock insuficiente · OVERSELL · alerta crítica · NO debe pasar nunca

08p6

P06Venta D2C (storefront propio)

Flujo

  1. Cliente en storefront de marca propia agrega productos al carrito
  2. Checkout: ingresa datos + paga (WebPay/MercadoPago/transferencia)
  3. Hub recibe orden vía API directa (no webhook · es nuestro propio storefront)
  4. Mismo flow MeLi: orden + reserva stock + customer + task fulfillment
  5. Cliente queda como customers con datos completos (no anónimo)
  6. Boleta/factura electrónica se emite automático (P11)
  7. Pago se acredita (WebPay 24h · transferencia manual)

Eventosorder.created · dte.issued · payment.received

KPIsconversion rate · ticket promedio · abandono carrito

09p7

P07Venta B2G · Mercado Público (Estado)

Flujo

  1. Hub monitorea API Mercado Público diariamente
  2. Filtra licitaciones por categorías propias · región · monto
  3. Operador revisa "Bandeja Oportunidades" /channels/mp/licitaciones-abiertas
  4. Decide ofertar → "Preparar oferta"
  5. Hub pre-llena form con productos catálogo CM + precio + plazo entrega
  6. Operador adjunta certificados · garantía bancaria si aplica
  7. Hub envía oferta vía API MP (o exporta XML para upload manual)
  8. Si adjudican → orden con channel='mp'
  9. Operador entrega · genera acta recepción Estado
  10. Hub emite factura · carga en sistema MP
  11. Estado paga 30-90 días después · Hub trackea CxC

⚠️ Plazo pago Estado

30-90 días post entrega · planificar cash flow · NO depender de pago rápido B2G

10p8

P08Venta B2B (empresa privada)

Flujo

  1. Operador crea/busca cliente en /channels/b2b/clientes
  2. "Nueva cotización" → arma quote (SKUs + cantidades + precio mayorista)
  3. Hub genera PDF cotización · envía email automático al cliente
  4. Cliente aprueba (responde email o click link aprobación)
  5. Hub convierte cotización en orden · reserva stock · crea task fulfillment
  6. Hub emite factura electrónica (33)
  7. Operador despacha (P09)
  8. Cliente paga según términos (normalmente 15-30 días)
  9. Hub trackea CxC (P12)

KPIsconversion quote→orden · ticket promedio B2B · % cobrado en tiempo

Eventosb2b.quote.created · b2b.quote.approved

11p9

P09Fulfillment · despacho

Flujo

  1. Operador entra a /fulfillment/pendientes · ve cola priorizada
  2. Hub genera picking list (qué SKU sacar de qué ubicación)
  3. Operador hace picking físico · marca SKUs picked
  4. Packing: arma paquete · pesa · mide
  5. Hub elige courier según regla (MeLi → Chilexpress · B2B → Starken)
  6. API courier genera etiqueta envío
  7. Operador pega etiqueta · entrega a retiro courier
  8. Hub registra tracking number · monitorea estado
  9. Cuando courier marca entregado → Hub actualiza orden status=delivered
  10. Webhook al canal correspondiente confirma entrega

📒 Asiento contable automático (al shipped)

DEBE: Costo de venta (CMV) por landed cost

HABER: Mercadería (existencia) por landed cost

12p10

P10Devolución (opcional · ojalá poco)

Flujo

  1. Cliente solicita por canal correspondiente (motivo: defecto · arrepentimiento · diferente al esperado)
  2. Operador valida motivo · aprueba RMA
  3. Hub crea ticket /fulfillment/devoluciones/{id}
  4. Cliente envía producto de vuelta
  5. Operador recibe · inspecciona estado
  6. Si OK · stock vuelve a inventario (inventory.adjustments IN)
  7. Hub emite Nota de Crédito Electrónica (NC 61) al canal de origen
  8. Reembolsa pago al cliente (transferencia · WebPay reverse)

13p11

P11Facturación · DTE Chile

Flujo

  1. Orden status=approved → Hub trigger emisión DTE
  2. Decide tipo documento según cliente:

    • Persona natural sin RUT → Boleta Electrónica (39)
    • Empresa con RUT → Factura Electrónica (33)
    • Cliente exento → Factura Exenta (34)

  3. Llama API Open Factura (o SII MIPYME directo)
  4. Recibe folio + XML firmado + PDF
  5. Guarda en dte.documents
  6. Envía PDF al cliente por email
  7. Reporta automático al SII (libro IVA digital)

📒 Asiento contable automático

DEBE: Clientes (cuentas por cobrar) por total con IVA

HABER: Ventas afectas por neto

HABER: IVA débito por IVA

14p12

P12Cobranza

Flujo

  1. Hub monitorea diariamente /finanzas/cuentas-por-cobrar
  2. Calcula días restantes hasta vencimiento por cliente/canal
  3. 5 días antes → recordatorio automático cliente (email)
  4. 0 días → alerta operador
  5. +7 días → segundo recordatorio + alerta amarilla
  6. +15 días → llamada manual del operador
  7. +30 días → escalamiento (gestión cobranza)
  8. Pago llega → conciliación · Hub matchea pago con factura → paid
  9. Genera asiento contable

📒 Asiento contable automático (al cobrar)

DEBE: Bancos (cuenta corriente) por monto recibido

HABER: Clientes (CxC) por monto recibido

15p13

P13Dropshipping multi-proveedor (Fase 3+)

Flujo

  1. Founder registra proveedor con auth_mode (api_key · oauth · email · whatsapp) vía POST /api/suppliers
  2. Cron 6h sync catálogo proveedor → mkt_supplier_products
  3. SKUs filtrados por margen 15%+ entran al catálogo SMC con is_dropship=true
  4. Publicación a canales (MeLi · D2C · MP) marca producto como dropship internamente
  5. Venta entra por cualquier canal → webhook procesado igual
  6. Si is_dropship=true → POST /api/suppliers/:id/purchase-orders propaga OC al proveedor
  7. Confirmar stock disponible real-time · si stock=0 refund + email comprador automático
  8. Proveedor despacha directo al cliente final · webhook tracking sync con order SMC
  9. Cobro a cliente final · DTE emitido a nombre SMC SpA · proveedor cobra a SMC 7-15d después
  10. Cerebro monitor: si SKU > $5M CLP/mes 2 meses → alerta migración stock local

📒 Modelo dropshipping vs stock local

  • Dropshipping: margen 10-25% · sin capital atado · escala catálogo rápido
  • Stock local: margen 28-40% · capital atado · ciclo despacho propio
  • Estrategia: dropship para PROBAR · stock local cuando funciona

16p14

P14Publicidad multicanal (Mercado Ads · Meta · Google · TikTok)

Flujo

  1. Founder conecta cuentas publicitarias con OAuth vía POST /api/ads/accounts (4 providers)
  2. Crea campaña multi-canal con presupuesto + SKUs promocionados vía POST /api/ads/campaigns
  3. Cron diario sync métricas de cada provider → mkt_ads_metrics (impressions · clicks · conv · spend · revenue)
  4. Trigger Postgres calcula ROAS auto · si <1.5 por 7 días → pg_notify('ads_roas_low')
  5. Listener dispara alerta UI founder · sugerencia pausa o cambio creatividad
  6. Conversion events server-side: cada venta → POST /api/ads/events con event_id idempotente
  7. Cron 5min envía batch events a Meta CAPI · Google Enhanced Conversions · TikTok Events
  8. Cada provider devuelve attribution · sync con campaign metrics
  9. Dashboard ROAS consolidado cross-provider · drill-down por SKU/canal
  10. Y2 escalado: pixels client-side D2C storefront + retargeting audiences custom

📒 Por qué server-side (CAPI/Enhanced/Events)

  • iOS 14.5+ tracking: pixels client-side perdieron 60% accuracy · CAPI recupera
  • Ad blockers: 20-30% usuarios bloquean pixels · server-side bypass
  • Idempotency: event_id evita doble counting cuando ambos pixel+CAPI activos
  • Privacy: hashed PII (SHA-256 email/phone) sigue Ley 19.628 + GDPR

🚫 Anti-patrones

  • Activar todos los providers desde día 1 · empezar 1 (Mercado Ads · ya conectado a MeLi)
  • Subir presupuesto sin medir 14 días · esperar señal ROAS estable
  • Olvidar pausar campañas obsoletas · presupuesto sigue corriendo
  • Atribución last-click solo · usar multi-touch en Y2

17tr

TProcesos transversales

IDProcesoQué hace
T1Contabilidad automática (event-driven)Cada evento de los 12 procesos dispara asientos contables en plan de cuentas configurable. F29 mensual + libro IVA + auxiliar de clientes/proveedores automático.
T2Inventario real-time (SSoT)Cada venta/recepción/devolución/merma actualiza inventario inmediato. Cross-canal sincroniza stock vía webhook a cada adapter.
T3Cerebro IA (sugerencias proactivas)Analiza data de los 12 procesos · genera alertas: "stock bajo SKU X" · "MeLi vendiste 30% menos esta semana" · "comprá más del proveedor Y".
T4Compliance (vencimientos y validaciones)F30/F30-1 · garantías bancarias · vigencia ChileProveedores · libro IVA digital · F22 anual. Alertas antes de vencer.
T5Analytics (cross-data)Dashboards consolidados por canal · marca · vertical · producto. Decisiones de pricing · canal · sourcing basadas en margen real.

🎯 Premisa CORE recordada

NO duplicar esfuerzo · NO duplicar data · NO duplicar lógica.