> ## Documentation Index
> Fetch the complete documentation index at: https://docs.compago.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Cómo invitar comercios a una promoción (fabricantes)
> Suma a tu promoción a los comercios que venden tus productos, con una invitación por correo.
export const SupportBox = () => ;
export const GuideImage = ({src, preview, alt, width, height, caption, variant = 'screen'}) => {
const [open, setOpen] = useState(false);
const [view, setView] = useState(null);
const opener = useRef(null);
const dialog = useRef(null);
const viewport = useRef(null);
const closeButton = useRef(null);
const fitScale = useRef(1);
const drag = useRef(null);
const long = height / width > 1.6;
const icon = (d, size = 18) => ;
const ZOOM_IN = 'M11 3a8 8 0 1 0 0 16 8 8 0 0 0 0-16zM21 21l-4.35-4.35M11 8v6M8 11h6';
const ZOOM_OUT = 'M11 3a8 8 0 1 0 0 16 8 8 0 0 0 0-16zM21 21l-4.35-4.35M8 11h6';
const FIT = 'M3 7V5a2 2 0 0 1 2-2h2M17 3h2a2 2 0 0 1 2 2v2M21 17v2a2 2 0 0 1-2 2h-2M7 21H5a2 2 0 0 1-2-2v-2';
const DOWNLOAD = 'M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4M7 10l5 5 5-5M12 15V3';
const CLOSE = 'M18 6 6 18M6 6l12 12';
const clampView = next => {
const el = viewport.current;
if (!el) return next;
const w = width * next.scale;
const h = height * next.scale;
const keep = 96;
const x = w <= el.clientWidth ? (el.clientWidth - w) / 2 : Math.min(keep, Math.max(el.clientWidth - w - keep, next.x));
const y = h <= el.clientHeight ? (el.clientHeight - h) / 2 : Math.min(keep, Math.max(el.clientHeight - h - keep, next.y));
return {
scale: next.scale,
x,
y
};
};
const fit = () => {
const el = viewport.current;
if (!el) return;
const scale = long ? Math.min(1, el.clientWidth * 0.94 / width) : Math.min(1, el.clientWidth * 0.94 / width, el.clientHeight * 0.88 / height);
fitScale.current = scale;
setView(clampView({
scale,
x: (el.clientWidth - width * scale) / 2,
y: long ? 72 : (el.clientHeight - height * scale) / 2
}));
};
const zoomAt = (factor, cx, cy) => {
setView(current => {
const el = viewport.current;
if (!current || !el) return current;
const px = cx ?? el.clientWidth / 2;
const py = cy ?? el.clientHeight / 2;
const scale = Math.min(Math.max(fitScale.current * 0.5, current.scale * factor), Math.max(1.5, fitScale.current * 6));
const ratio = scale / current.scale;
return clampView({
scale,
x: px - (px - current.x) * ratio,
y: py - (py - current.y) * ratio
});
});
};
const panBy = (dx, dy) => setView(current => current && clampView({
...current,
x: current.x + dx,
y: current.y + dy
}));
const close = () => {
setOpen(false);
setView(null);
opener.current?.focus();
};
const show = event => {
opener.current = event.currentTarget;
setOpen(true);
};
const actions = useRef({});
actions.current = {
fit,
zoomAt,
panBy,
close
};
useEffect(() => {
const modal = dialog.current;
if (!open || !modal) return undefined;
if (!modal.open) modal.showModal();
const el = viewport.current;
actions.current.fit();
closeButton.current?.focus();
const onResize = () => actions.current.fit();
const onKey = event => {
const {zoomAt: zoom, panBy: pan} = actions.current;
if (event.key === '+' || event.key === '=') zoom(1.25); else if (event.key === '-' || event.key === '_') zoom(0.8); else if (event.key === '0') actions.current.fit(); else if (event.key === 'ArrowUp') pan(0, 120); else if (event.key === 'ArrowDown') pan(0, -120); else if (event.key === 'ArrowLeft') pan(120, 0); else if (event.key === 'ArrowRight') pan(-120, 0); else return;
event.preventDefault();
};
const onWheel = event => {
event.preventDefault();
const rect = el.getBoundingClientRect();
if (event.ctrlKey || event.metaKey) actions.current.zoomAt(Math.exp(-event.deltaY * 0.0022), event.clientX - rect.left, event.clientY - rect.top); else actions.current.panBy(-event.deltaX, -event.deltaY);
};
const root = document.documentElement;
const overflow = root.style.overflow;
root.style.overflow = 'hidden';
window.addEventListener('resize', onResize);
document.addEventListener('keydown', onKey);
el?.addEventListener('wheel', onWheel, {
passive: false
});
return () => {
root.style.overflow = overflow;
window.removeEventListener('resize', onResize);
document.removeEventListener('keydown', onKey);
el?.removeEventListener('wheel', onWheel);
if (modal.open) modal.close();
};
}, [open]);
const onPointerDown = event => {
if (event.button !== 0) return;
drag.current = {
x: event.clientX,
y: event.clientY,
travel: 0
};
event.currentTarget.setPointerCapture(event.pointerId);
};
const onPointerMove = event => {
const start = drag.current;
if (!start) return;
const dx = event.clientX - start.x;
const dy = event.clientY - start.y;
start.travel += Math.abs(dx) + Math.abs(dy);
start.x = event.clientX;
start.y = event.clientY;
panBy(dx, dy);
};
const onPointerUp = event => {
const start = drag.current;
drag.current = null;
if (!start || start.travel > 6 || !view) return;
const rect = viewport.current.getBoundingClientRect();
const x = event.clientX - rect.left;
const y = event.clientY - rect.top;
const inside = x >= view.x && x <= view.x + width * view.scale && y >= view.y && y <= view.y + height * view.scale;
if (!inside) close();
};
const onDoubleClick = event => {
const rect = viewport.current.getBoundingClientRect();
if (view && view.scale > fitScale.current * 1.4) fit(); else zoomAt(2.2, event.clientX - rect.left, event.clientY - rect.top);
};
const percent = view ? Math.round(view.scale / fitScale.current * 100) : 100;
const viewer = open && ;
if (variant === 'guide') {
return
{caption && {caption}}
{viewer}
;
}
return
{caption && {caption}}
{viewer}
;
};
export const GuideVideo = ({src, poster, title, duration, caption}) => {
const dialog = useRef(null);
const player = useRef(null);
const opener = useRef(null);
const resumeAt = useRef(0);
const pageOverflow = useRef('');
const icon = (d, size = 18, fill = false) => ;
const PLAY = 'M9 6.5 18.5 12 9 17.5z';
const MAXIMIZE = 'M8 3H5a2 2 0 0 0-2 2v3M21 8V5a2 2 0 0 0-2-2h-3M3 16v3a2 2 0 0 0 2 2h3M16 21h3a2 2 0 0 0 2-2v-3';
const CLOSE = 'M18 6 6 18M6 6l12 12';
const open = event => {
const modal = dialog.current;
const video = player.current;
if (!modal || !video || modal.open) return;
opener.current = event.currentTarget;
pageOverflow.current = document.documentElement.style.overflow;
document.documentElement.style.overflow = 'hidden';
modal.showModal();
video.currentTime = resumeAt.current;
video.play().catch(() => {});
video.focus();
};
const onClose = () => {
const video = player.current;
if (video) {
resumeAt.current = video.ended ? 0 : video.currentTime;
video.pause();
}
document.documentElement.style.overflow = pageOverflow.current;
opener.current?.focus();
};
const close = () => {
if (dialog.current?.open) dialog.current.close();
};
const fullscreen = () => {
const video = player.current;
if (!video) return;
video.play().catch(() => {});
if (video.requestFullscreen) video.requestFullscreen().catch(() => {}); else if (video.webkitEnterFullscreen) video.webkitEnterFullscreen();
};
return
{caption && {caption}}
;
};
Una promoción solo llega a los comercios que invitas. Cada uno recibe la invitación por correo y en su panel, y participa cuando la acepta.
## Dónde está en la app
* En el menú de la izquierda, entra a **Promociones** y abre la promoción.
* Arriba a la derecha, haz clic en el menú ⋮ y elige **Invitar comerciantes**.
* También puedes hacerlo con el botón **Invitar** de la pestaña **Comerciantes**.
## Antes de empezar
* Pueden invitar el **Dueño** y los **Administradores** de la cuenta de fabricante que creó la promoción.
* Ten a la mano el correo con el que cada comercio entra a Compago, así la invitación le llega a su cuenta.
* Si todavía no tienes la promoción, primero [créala](/manual/promociones/crear-una-promocion).
## Paso a paso
En **Promociones**, haz clic en la promoción a la que quieres sumar comercios.
Usa el buscador para encontrar una promoción por su título.
Estás en el detalle de la promoción. Haz clic en el botón ⋮, arriba a la derecha.
En **Detalle** ves la retención y los descuentos que ofreces.
En el menú, haz clic en **Invitar comerciantes**.
También puedes invitar con el botón **Invitar** de la pestaña **Comerciantes**.
Escribe el correo del comercio y haz clic en **+** para sumarlo a la lista.
Usa el correo con el que el comercio entra a Compago, así la invitación le llega a su cuenta.
El comercio quedó en la lista. Suma a todos los que quieras invitar y luego haz clic en **Enviar invitaciones**.
¿Te equivocaste de correo? Haz clic en la **X** de su fila para quitarlo.
La invitación quedó enviada. En la pestaña **Comerciantes** ves a cada comercio invitado, su correo y su estado: **Pendiente** hasta que acepte.
Cuando el comercio acepte, su estado cambia a **Aceptada**.
## Qué pasa después
* Cada comercio recibe un correo con la invitación y la ve en su panel, en **Promociones**, como **Pendiente**.
* Cuando el comercio acepta, su estado cambia a **Aceptada**. Si la rechaza, cambia a **Rechazada**.
* Un comercio que aceptó elige a qué plazos de sus comisiones aplica tu descuento. Sus ventas con la promoción aparecen en la pestaña **Pagos**.
## Preguntas frecuentes
Sí. Escribe cada correo y haz clic en **+** para sumarlo a la lista. Cuando estén todos, haz clic en **Enviar invitaciones**.
Porque su correo todavía no pertenece a un comercio en Compago. El nombre aparece cuando responde a la invitación desde su cuenta.
En la pestaña **Comerciantes**, haz clic en **⋯** en su fila y elige **Desactivar**. Revisa [cómo administrar una promoción](/manual/promociones/administrar-una-promocion).
Sí. Envíale una invitación nueva con su correo, igual que la primera vez.
## Errores comunes
### «Ingresa un correo electrónico válido»
El correo tiene un error de escritura. Revisa que tenga su **@** y su dominio, por ejemplo **[compras@ferreteria.com](mailto:compras@ferreteria.com)**.
### «Este correo ya fue agregado a la lista»
Ese correo ya está en la lista de comerciantes a invitar. No hace falta sumarlo otra vez.
### No veo «Invitar comerciantes»
Solo lo ven el **Dueño** y los **Administradores** de la cuenta de fabricante que creó la promoción.
## Guía en una imagen
Todos los pasos en una sola imagen, para tenerla a mano o compartirla con tu equipo.
## Guías relacionadas
Define la retención y el descuento que financias.
Edita, pausa o activa tu promoción y revisa sus pagos.
Lo que ve el comercio cuando lo invitas.
Cómo el comercio aplica tu descuento a sus comisiones.
## ¿Necesitas ayuda?