Saltar al contenido
pcreative Commerce

El panel del vendedor

Vendedores y autores no usan tu panel.

Vendedores y autores no usan tu panel. Tienen el suyo, una aplicación aparte (apps/vendedores) en el puerto 7002. Es aparte a propósito: el código que gestiona clientes, facturación y ajustes no se descarga nunca en el navegador de un vendedor.

Dónde vive

  • En desarrollo: npm run dev dentro de apps/vendedores lo sirve en http://localhost:7002.
  • Con Docker (docker-compose.full.yml) se publica en VENDEDORES_PORT (7002 por defecto), atado a 127.0.0.1 salvo que cambies PCC_ESCUCHAR_EN.
  • Su dirección pública va en VENDEDORES_URL en el .env (Docker), que llega al backend como PCC_VENDEDORES_URL. Sin Docker, pon PCC_VENDEDORES_URL directamente en el .env del backend. Ponla antes de dar de alta a nadie: es la dirección a la que apuntan los enlaces de invitación, y sin ella apuntan a http://localhost:7002.

Cómo entra un vendedor

Nadie se da de alta solo. El acceso se crea en dos situaciones, y las dos hacen lo mismo (apps/backend/src/propio/acceso-vendedor.ts):

Se crea un usuario con una contraseña aleatoria que nadie conoce, enlazado a ese vendedor, y sale un correo con un enlace para poner su contraseña, que vale siete días. El correo va en el idioma del vendedor, inglés o español. El enlace abre Pon tu contraseña en el panel del vendedor; a partir de ahí entra con su correo y esa contraseña.

Dos casos en los que no hay enlace:

  • El correo ya es de alguien de tu equipo. No se enlaza solo: un usuario enlazado a un vendedor pierde el acceso a gestionar la tienda, así que enlazar a un administrador le dejaría fuera de su propia tienda. Al autor aceptado se le avisa de que su acceso se prepara a mano; al vendedor que das de alta a mano no le llega ningún correo. En los dos casos lo resuelve una persona.
  • Ya tenía acceso a ese mismo vendedor: no se crea nada nuevo; al autor aceptado se le dice que entre con su cuenta de siempre.

Si alguien que gestiona la tienda intenta entrar aquí, se le rechaza con «Esta cuenta no es la de un vendedor»: la tienda tiene su propio panel.

Qué ve

El menú, en este orden:

  • Resumen. Su estado (pendiente, activo o suspendido), el porcentaje que se lleva, lo ganado este mes, lo que tiene sin cobrar, lo que está listo para pagarle y cuántas piezas hay en revisión. Lo que le bloquea va primero: piezas con cambios pedidos y las razones por las que aún no se le puede pagar.
  • Mis piezas. Los temas y extensiones que vende en el mercado. Crea una pieza (nombre, tema o extensión, con qué está hecha, precio), rellena la ficha, añade capturas, sube versiones como .zip y la manda a revisar. Mientras está en la cola no se puede editar; puede sacarla de la cola. Si le pediste cambios, tus notas aparecen en la pieza.
  • Qué se vende. Lo que ha traído cada pieza desde que se publicó, antes de comisión, y una descarga de sus ingresos.
  • Licencias. Las licencias de sus compradores: pega una clave o busca por correo para ver si es válida, en cuántos sitios está y hasta cuándo tiene soporte.
  • Soporte. Las conversaciones privadas que abren sus compradores. Contesta y puede darlas por resueltas. Su tiempo de respuesta sale en su ficha pública.
  • Mis pedidos. Su parte de cada pedido: fecha, pedido, su parte, comisión y estado (por preparar, preparando, enviado, entregado, cancelado).
  • Mi dinero. Cada línea de su saldo con su motivo: venta, comisión de la tienda, devolución al cliente, comisión devuelta, te lo hemos pagado y ajuste.
  • Cobros. Sus datos fiscales, la verificación de identidad, dónde pagarle (transferencia, PayPal o Wise), el mínimo para que se le pague, el botón para pedir un pago y un CSV de sus ingresos para su gestor.
  • Mi ficha. Su ficha pública de autor: nombre visible, quién es, web, país, logo y enlaces. Los números que calcula la plataforma (consultas resueltas, tiempo de respuesta, valoraciones) no se pueden tocar.

El panel está en inglés y español, con un selector al pie del menú. La primera vez sigue el idioma del navegador.

Qué no puede hacer

El panel solo llega a una lista fija de rutas del backend (apps/vendedores/src/lib/rutas-permitidas.ts); todo lo demás se rechaza con «Esta parte del sistema no es de los vendedores». En la práctica:

  • No ve ni edita productos de tu catálogo, ni siquiera sus propios productos físicos. Esos se gestionan desde tu panel.
  • No ve ni edita tarifas de envío. Las tarifas del paquete de un vendedor las pone la tienda.
  • Mis pedidos es de solo lectura. Ve el estado pero no puede cambiarlo desde aquí.
  • No ve tus clientes, tus ajustes ni los datos de ningún otro vendedor.
  • No se paga a sí mismo: pedir un pago le pide a la tienda (o al proveedor de pagos) que lo haga. Cómo funciona está en Pagar a autores y vendedores.

Conviene saber

  • Varias pantallas (Mis piezas, Qué se vende, Licencias, Soporte, Mi ficha) son del mercado de autores. Un vendedor que solo vende productos físicos las verá vacías; lo que le importa es Mis pedidos, Mi dinero y Cobros.
  • Los subtítulos de Mis piezas y Cobros dicen «De cada venta te llevas el 70 %» como texto fijo. Resumen enseña el porcentaje real, calculado a partir de la comisión de ese vendedor.

Ver también