Documentación

Manual Técnico

Guía completa para configurar, operar y aprovechar al máximo tu tienda en Digital Shop Py.

Contenido
Primeros pasos (8 pasos) Facturación SET Inventario y stock Caja y contabilidad Proveedores Deudas y fiados Recetas e ingredientes Mesas (gastro) Usuarios y roles Dominio propio API / integraciones
🚀

Primeros pasos

Desde la creación de la tienda hasta la primera venta

1
Acceso inicial

Ingresá a tu panel de administración

Una vez creada tu tienda (por registro propio o por el administrador), recibís tus credenciales por email: usuario y contraseña.

  • Andá a digitalshop.com.py/tenant-login desde cualquier navegador.
  • Ingresá con el email y contraseña proporcionados.
  • Si olvidaste la contraseña, contactate por WhatsApp con soporte.
💡 Guardá el link del panel en los favoritos de tu celular para acceder rápido cada día.
2
Configuración básica

Completá los datos de tu negocio

En el panel andá a Configuración y completá la información de tu tienda antes de cargar productos.

  • Nombre del negocio — el nombre que verán tus clientes en el catálogo.
  • Número de WhatsApp — con código de país, ej: 595991123456. Todos los pedidos llegan a este número.
  • Logo — URL de tu imagen (podés subir gratis a Imgur o Cloudinary).
  • Dirección y país — para que tus clientes sepan dónde estás.
  • Telegram Chat ID — opcional. Si lo configurás, también recibís pedidos por Telegram.
⚠️ El WhatsApp es el campo más importante. Sin él, los pedidos no llegan.
3
Organización del catálogo

Creá las categorías de tus productos

Las categorías ayudan a tus clientes a encontrar lo que buscan más rápido. Creá las categorías antes de cargar productos.

  • En el panel andá a CategoríasNueva categoría.
  • Ejemplos para ropa: Remeras, Pantalones, Calzado, Accesorios.
  • Ejemplos para restaurante: Entradas, Platos principales, Bebidas, Postres.
  • Podés ordenarlas arrastrando para que aparezcan en el orden que querés.
💡 No hace falta crear todas las categorías de una vez. Podés agregar más después.
4
Cargar el catálogo

Agregá tus productos

Cada producto necesita al menos nombre y precio. Cuanta más información pongas, mejor la experiencia de tu cliente.

  • Nombre — claro y descriptivo (ej: "Remera básica negra talle M").
  • Precio — en la moneda configurada (Guaraníes por defecto).
  • Foto — URL de la imagen. Podés subirla gratis a Imgur.
  • Descripción — detalles adicionales: material, medidas, composición.
  • Categoría — elegí a cuál de tus categorías pertenece.
  • Stock — cuántas unidades tenés disponibles (opcional).
  • IVA — IVA 10%, IVA 5% o Exento. Usado en la facturación SET.
  • Estado — Activo para que se vea, Inactivo para ocultarlo temporalmente.
💡 Podés importar productos masivamente desde un CSV en el menú Productos → Importar CSV.
5
Personalizar la apariencia

Configurá el aspecto visual de tu tienda

En el panel andá a Apariencia para que tu tienda luzca como tu marca.

  • Colores — primarios y secundarios que coincidan con tu identidad visual.
  • Banners — imágenes de portada (promociones, novedades). Aparecen como carrusel.
  • Barra de anuncios — mensaje fijo en la parte superior (ej: "Envíos a domicilio disponibles").
  • Redes sociales — Instagram, Facebook, TikTok; aparecen como íconos en tu tienda.
  • Formato del catálogo — galería, grilla o lista.
6
Prueba antes de publicar

Hacé una compra de prueba

Antes de mandarle el link a tus clientes, verificá que todo funcione correctamente.

  • Abrí tu tienda: tutienda.digitalshop.com.py
  • Agregá productos al carrito y confirmá el pedido de prueba.
  • Verificá que el mensaje llegue a tu WhatsApp con nombre, productos y total.
  • Si configuraste Telegram, verificá que también llegue ahí.
  • Revisá que los precios y las fotos carguen correctamente.
⚠️ Si el pedido no llega: verificá que el número de WhatsApp esté correcto (sin espacios, con código de país: 595991123456).
7
Publicación

Compartí tu tienda con tus clientes

Tu tienda está en línea desde el momento que fue creada. El link es:

https://tutienda.digitalshop.com.py/

  • Compartilo en grupos de WhatsApp, stories de Instagram y publicaciones de Facebook.
  • Agregalo a tu bio de Instagram.
  • Generá un código QR gratis con cualquier generador online y pegalo en tu local.
  • Para dominio propio como www.tunegocio.com.py, consultá la sección de dominios.
✅ Cada vez que un cliente haga un pedido, te llega un mensaje al WhatsApp con todos los detalles.
8
Operación diaria

Gestioná los pedidos desde el panel

Además de recibir pedidos por WhatsApp, podés ver y gestionar todo desde el panel.

  • En Pedidos ves todos los pedidos con nombre del cliente, productos y total.
  • Podés cambiar el estado: Pendiente → Confirmado → Entregado.
  • En Clientes ves el historial de cada cliente y su total acumulado.
  • En Estadísticas ves las ventas del período y los productos más vendidos.
  • En ERP accedés a inventario, caja, facturación, proveedores y más (plan Pro).
💡 Podés invitar empleados o socios como Editor o Viewer desde Equipo — ellos gestionan sin ver la configuración sensible.
Checklist de habilitación

Todo listo para operar

  • Datos del negocio completos (nombre, WhatsApp, logo)
  • Al menos 1 categoría creada
  • Al menos 5 productos activos con precio y foto
  • Apariencia configurada (colores, banner opcional)
  • Compra de prueba realizada — pedido recibido en WhatsApp
  • Link de la tienda compartido en redes sociales
🧾

Facturación SET

Facturas legales con timbrado, IVA 5%/10% y numeración correlativa

El módulo de facturación permite emitir facturas con validez legal ante la SET (Subsecretaría de Estado de Tributación de Paraguay). Requiere plan Pro y que el timbrado esté vigente.

Paso 1

Configurar timbrado

ERP → Facturación → Configuración. Ingresá RUC, razón social, timbrado, vigencia y rango de numeración.

Paso 2

Asignar IVA a productos

En cada producto indicá si aplica IVA 10%, IVA 5% o Exento. El sistema calcula automáticamente al facturar.

Paso 3

Facturar pedidos

Desde el detalle de un pedido confirmado, presionás "Generar factura". El número correlativo se asigna solo.

Alternativa

Factura manual

Para ventas sin pedido en el sistema: ERP → Facturación → Nueva factura manual. Seleccioná un cliente registrado y los productos del catálogo.

Campos del timbrado

CampoDescripciónEjemplo
RUCRUC de la empresa emisora80000001-1
Razón socialNombre legal de la empresaMi Empresa S.A.
TimbradoNúmero de timbrado otorgado por la SET12345678
Vigencia desde/hastaPeríodo de validez del timbrado01/01/2025 – 31/12/2025
Factura desde / hastaRango de numeración autorizado1 – 999
EstablecimientoNúmero de establecimiento (3 dígitos)001
Punto de expediciónPunto de expedición (3 dígitos)001
ℹ️ El número completo de la factura se forma como: 001-001-0000001 (establecimiento-punto-número correlativo).
⚠️ Cuando el rango de numeración se agota, el sistema avisa y bloquea la emisión. Configurá un nuevo rango antes de que se acabe.

Datos de clientes para facturas

Para pre-llenar los datos del comprador en la factura manual, registrá el RUC y dirección de cada cliente desde la sección Clientes → ✏️. Una vez guardados, al seleccionar el cliente en el formulario de factura todos los campos se completan automáticamente.

Exportar para Marangatú

Desde ERP → Facturación podés descargar un CSV con el formato requerido por Marangatú (sistema de la SET) para la presentación mensual de IVA.

📦

Inventario y stock

Control automático y manual del stock de tus productos

El inventario descuenta stock automáticamente con cada pedido confirmado. También podés hacer ajustes manuales para registrar compras, pérdidas o correcciones.

Automático

Descuento por pedido

Cuando confirmás un pedido, el stock de cada producto se descuenta en la cantidad vendida.

Manual

Ajuste de stock

ERP → Inventario → Ajustar stock. Ingresá el producto, tipo (entrada/salida/ajuste), cantidad y motivo.

Alertas

Stock mínimo

Configurá un stock mínimo por producto. El sistema te avisa cuando el stock cae por debajo de ese límite.

Reporte

Historial de movimientos

En ERP → Inventario ves el historial completo: qué entró, qué salió, cuándo y por qué motivo.

Tipos de movimiento

TipoCuándo usarlo
EntradaCompra a proveedor, devolución de cliente
SalidaPérdida, robo, vencimiento, uso interno
AjusteCorrección de inventario luego de un conteo físico
💰

Caja y contabilidad

Registro de ingresos, egresos y balance diario

La caja registra todos los movimientos de dinero: ingresos (ventas, otros) y egresos (gastos, compras). El balance se calcula automáticamente.

Ingresos

Registro de ventas

Los pedidos confirmados generan automáticamente un ingreso en caja. También podés registrar ingresos manuales.

Egresos

Registro de gastos

Registrá gastos operativos: alquiler, sueldos, insumos, servicios, compras a proveedores.

Balance

Resumen del período

ERP → Contabilidad muestra el total de ingresos, egresos y ganancia neta por período seleccionado.

Marangatú

Exportar para SET

Descargá el CSV de movimientos en formato compatible para la presentación de IVA en Marangatú.

🏭

Proveedores

Agenda y gestión de tus proveedores

Registrá todos tus proveedores con sus datos de contacto para tenerlos a mano cuando necesites hacer pedidos.

📋

Deudas y fiados

Control de cuentas por cobrar y por pagar

Registrá fiados de clientes (por cobrar) y deudas con proveedores (por pagar). El sistema lleva el saldo pendiente y el historial de abonos.

TipoDescripciónEjemplo
Por cobrarCliente que se llevó mercadería fiadaJuan Pérez debe Gs. 150.000
Por pagarDeuda pendiente con un proveedorEmpresa S.A., factura pendiente

Cómo registrar un abono

En ERP → Deudas, presionás el botón Abonar en la deuda correspondiente, ingresás el monto abonado y el sistema actualiza el saldo pendiente automáticamente.

💡 Una deuda queda en estado "cancelada" cuando el saldo llega a cero o se marca manualmente como pagada.
🍳

Recetas e ingredientes

Para negocios gastronómicos: control de insumos y costos

El módulo de recetas permite registrar los ingredientes que usás (con stock, unidad y costo), y armar recetas asociando cada producto del menú a sus ingredientes y cantidades.

Ingredientes

Registrar insumos

ERP → Recetas → Ingredientes. Nombre, unidad de medida (kg, lt, unidad), stock actual, costo unitario y stock mínimo.

Recetas

Armar recetas

Cada receta se asocia a un producto del catálogo y define qué ingredientes (y qué cantidades) se necesitan para producirlo.

Costo

Cálculo automático

Con los costos de ingredientes, el sistema calcula el costo de producción de cada ítem y podés compararlo con el precio de venta.

Alertas

Stock de ingredientes

Configurá stock mínimo por ingrediente. El sistema te avisa cuando hay riesgo de quedarse sin insumos.

🍽️

Mesas (Gastro)

Gestión de salón para restaurantes, bares y cafeterías

Creá el layout de tu salón con las mesas numeradas. Cada mesa puede tener un estado (libre / ocupada), y podés abrir una cuenta por mesa para registrar los pedidos de los comensales.

👥

Usuarios y roles

Invitá a tu equipo con permisos diferenciados

RolQué puede hacer
OwnerAcceso total: configuración, productos, pedidos, ERP, equipo, facturación.
EditorGestiona productos, pedidos, ERP y clientes. No puede cambiar configuración ni equipo.
ViewerSolo puede ver pedidos y estadísticas. Sin capacidad de editar.

Para invitar: Configuración → Equipo → Invitar usuario. Ingresás el email y el rol asignado.

💡 Los empleados de caja o vendedores deberían tener rol Editor. El contador o socio puede tener Viewer.
🌐

Dominio propio

Conectá tu propio dominio .com.py o .com

Por defecto tu tienda está en tutienda.digitalshop.com.py. Con plan Pro podés conectar un dominio propio como www.tunegocio.com.py.

Pasos para conectar tu dominio
ℹ️ Si tenés dudas con la configuración DNS, escribinos por WhatsApp y lo hacemos juntos.
⚙️

API / Integraciones

Referencia técnica de los endpoints disponibles

Todos los endpoints requieren autenticación con Authorization: Bearer <token>. El token se obtiene al iniciar sesión y se almacena en localStorage bajo la clave tenant_user.

EndpointAcciones disponibles
/api/gestion-productoslist, create, update, delete, toggle_active, import_csv, reorder_categorias
/api/clienteslist, update-billing
/api/pedidoslist, get, update-status, export-csv
/api/facturacionget, save, siguiente-numero, guardar-factura, listar-facturas, anular-factura
/api/inventariolist, ajuste
/api/cajalist, create, delete, resumen
/api/proveedoreslist, create, update, delete
/api/deudaslist, create, abonar, delete
/api/recetaslist-ingredientes, crear-ingrediente, actualizar-ingrediente, eliminar-ingrediente, list-recetas, crear-receta, eliminar-receta
/api/mesaslist, crear-mesa, actualizar-mesa, eliminar-mesa, abrir-cuenta, cerrar-cuenta
ℹ️ Para acceso de Super Admin cruzando tenants, agregá tenant_slug como query param (GET) o en el body (POST).

¿Algo no funciona o tenés dudas?

Nuestro equipo te ayuda en el momento por WhatsApp.