Documentación completa del sistema de gestión comercial con facturación electrónica SIFEN, portal de clientes y marketplace de deudas tokenizadas
¿Qué es ComprasPar?
ComprasPar es el sistema central de gestión comercial de tu empresa. Administra ventas, compras, clientes, inventario y cobros desde un único lugar, con dos módulos avanzados que lo diferencian del resto.
Facturación Electrónica SIFEN
Emite facturas electrónicas con validez fiscal ante la DNIT de Paraguay, de forma automática y en segundos.
Portal de Autoservicio
Tus clientes consultan sus facturas, pagos y refinanciaciones desde su celular, sin llamarte ni enviar correos.
Gestión de Cobranzas
Seguimiento de deudas, escalado automático por niveles, refinanciaciones con firma digital y alertas al cliente.
Tokenización y Marketplace
Convertí deudas en tokens digitales fraccionables y comercializalos en el marketplace interno entre empresas.
Sincronización Automática
Cada 5 minutos el sistema envía facturas a SIFEN y actualiza estados sin intervención humana.
Seguridad Multicapa
Autenticación separada para clientes, firmas digitales HMAC, protección contra accesos no autorizados y límite de intentos.
Facturación Electrónica (SIFEN)
Desde 2024, Paraguay exige la emisión de facturas electrónicas ante la DNIT a través del Sistema de Facturación Electrónica Nacional (SIFEN). ComprasPar está integrado con FacturaSend, intermediario homologado que convierte cada venta en un Documento Electrónico (DE) con validez legal completa.
Tipos de documentos electrónicos que emite ComprasPar
| Tipo | ¿Cuándo se usa? | Código SIFEN |
|---|---|---|
| Factura Electrónica | Ventas al cliente final o a empresas | 1 |
| Autofactura Electrónica | Compras a proveedores sin RUC formal | 4 |
| Nota de Crédito Electrónica | Devoluciones o ajustes a favor del cliente | 5 |
| Nota de Débito Electrónica | Ajustes a favor de la empresa | 6 |
| Nota de Remisión Electrónica | Traslado de mercadería entre depósitos | 7 |
¿Qué incluye cada documento electrónico?
CDC — Código de Control
Identificador único de 44 dígitos asignado por SIFEN. Es la prueba de que la factura existe en el sistema fiscal del Estado.
XML firmado digitalmente
El archivo oficial según el estándar SIFEN. Es el documento legal que se presenta ante la DNIT en caso de auditoría.
Código QR de verificación
Permite que cualquier persona escanee la factura con el celular y verifique su autenticidad en el portal de la DNIT.
KuDE (PDF oficial)
La representación visual del DE en formato PDF. Es lo que se entrega al cliente como comprobante impreso o digital.
Descargas disponibles por factura
| Formato | ¿Qué es? | ¿Dónde está disponible? |
|---|---|---|
| 📄 KuDE (PDF) | Representación visual oficial para entregar al cliente o imprimir | Dashboard · Portal del cliente · Listado de ventas |
| 📋 XML firmado | El documento electrónico oficial con firma digital SIFEN | Dashboard · Portal del cliente · Listado de ventas |
| { } JSON estructurado | Datos del DE para integración con sistemas contables | Dashboard · Portal del cliente · Listado de ventas |
| 🖼️ KUDE oficial FacturaSend | Versión generada por FacturaSend directamente | Dashboard · Listado de ventas |
¿Cómo funciona la facturación?
El proceso de facturación electrónica ocurre casi de forma invisible. Registrás la venta normalmente y el sistema se encarga del resto.
Registrada en ComprasPar
Cron detecta y envía
Procesa el DE
Aprueba y emite CDC
CDC + XML + QR guardados
Proceso automático paso a paso
Registrás la venta como siempre
Ingresás productos, cliente y forma de pago. La venta queda guardada y la factura queda como "Pendiente de envío a SIFEN".
En menos de 5 minutos el sistema actúa
El cron automático revisa todas las ventas sin factura electrónica y las envía a SIFEN a través de FacturaSend.
SIFEN responde con el CDC en el acto
ComprasPar usa el método síncrono que devuelve el CDC, el XML firmado y el QR en la misma respuesta, en cuestión de segundos.
El documento queda disponible para descargar
La factura cambia a estado "Aprobado". Desde el dashboard podés descargar el KuDE, el XML o el JSON con un clic.
El cliente también puede verla en su portal
Si el cliente tiene acceso al portal de ComprasPar, puede ver su factura electrónica completa, escanear el QR y descargar los archivos sin necesitar contactarte.
Envío manual disponible: Si preferís enviar cada factura vos mismo, podés ir a Ventas → Lista de ventas SIFEN y hacer clic en "Enviar" para cada una. También podés reenviar las rechazadas y consultar el estado de cualquier documento en tiempo real.
Estados de las facturas electrónicas
Cada factura electrónica pasa por diferentes estados a lo largo de su ciclo de vida. ComprasPar muestra el estado en tiempo real en el dashboard y en el portal del cliente.
Solo las facturas en estado Aprobado tienen validez fiscal ante la DNIT. Las demás son informativas dentro del sistema hasta que sean aprobadas.
Las facturas Rechazadas se reintentan automáticamente en el próximo ciclo de 5 minutos. Si el error es de datos (ej: RUC inválido), se mostrará el motivo exacto del rechazo para que lo corrijas.
Portal de Autoservicio del Cliente
ComprasPar incluye un portal web propio para que tus clientes gestionen su relación comercial sin necesidad de llamarte. Funciona desde cualquier celular o computadora, sin instalar nada.
URL de acceso: compraspar.com/duecollection/portal — El cliente ingresa con su email y contraseña.
¿Cómo se registra un cliente?
Accede a la URL del portal
Desde su celular o computadora, el cliente abre el portal de ComprasPar. No necesita descargar ninguna aplicación.
Se registra con su RUC o CI
Completa sus datos básicos: email, número de documento y contraseña. El sistema lo vincula automáticamente con sus facturas en ComprasPar.
Si compra en múltiples empresas con ComprasPar
El sistema detecta automáticamente a cuántas empresas pertenece su email y le muestra un selector para elegir con cuál empresa desea ingresar en esa sesión.
Acceso completo a su información
Una vez dentro, puede ver facturas, pagos, saldos, refinanciaciones y notificaciones — todo en tiempo real.
¿Qué puede hacer el cliente desde el portal?
Ver su resumen financiero
Saldo pendiente total, monto vencido, total facturado y pagado, con gráfico de evolución mensual.
Consultar sus facturas
Listado completo con filtros por fecha, estado y número. Puede buscar cualquier factura al instante.
Ver el detalle de cada factura
Líneas de productos, impuestos, pagos realizados, saldo pendiente y sección de factura electrónica SIFEN con QR y descargas.
Descargar documentos
PDF oficial (KuDE), XML firmado y JSON del documento electrónico, disponibles directamente en el detalle de cada factura.
Verificar el QR SIFEN
Cada factura electrónica aprobada muestra su código QR, para verificarla en el portal oficial de la DNIT.
Historial de pagos
Todos los pagos registrados con fecha, método, referencia y monto. Filtrable por rango de fechas.
Ver y aceptar refinanciaciones
Si le ofreciste un plan de cuotas, puede ver las condiciones y aceptarlo con firma digital desde su celular.
Recibir notificaciones
Alertas de vencimientos próximos, nuevas facturas, estados de refinanciación y mensajes de la empresa.
Gestionar su perfil
Actualizar sus datos de contacto (teléfono, dirección, ciudad) y cambiar su contraseña de acceso.
Cómo se ve una factura electrónica en el portal
01800102840001001000000012026050600000001Generado localmente
El código QR se genera directamente en el navegador del cliente, sin depender de ningún servicio externo. Esto garantiza que siempre esté disponible, sin importar la conexión del servidor.
Gestión de Cobranzas y Refinanciaciones
El módulo de cobranzas de ComprasPar te da control completo sobre las deudas de tus clientes, con herramientas para negociar, escalar y formalizar acuerdos de pago.
Funcionalidades de cobranza
Identidades de deudores
Perfiles consolidados de cada deudor con RUC o CI, datos de contacto y todas sus deudas agrupadas en un solo lugar.
Escalado automático
Las deudas vencidas avanzan automáticamente por niveles de escalado. Cada nivel puede tener diferentes acciones o comunicaciones.
Log de gestión
Registro completo de cada acción tomada sobre una deuda: llamados, visitas, acuerdos, pagos parciales y notas del gestor.
Refinanciaciones
Creación de planes de pago en cuotas que el cliente recibe y acepta con firma digital desde su portal, sin presencia física.
¿Cómo funciona una refinanciación?
El administrador crea el plan
Desde el panel de cobranzas, define las condiciones: monto total, número de cuotas, fechas de vencimiento y cualquier condición especial.
El cliente recibe una notificación en su portal
Al ingresar al portal, el cliente ve el plan propuesto con todos los detalles: cuotas, montos y fechas.
El cliente acepta con firma digital
Con un clic, el cliente acepta el plan. El sistema registra la firma digital junto con su IP, navegador y fecha/hora exacta.
Seguimiento automático
El plan queda activo. El cliente puede ver el estado de cada cuota (pendiente, pagada) directamente desde su portal.
Protección anti-doble aceptación: Si dos sesiones del mismo cliente intentan aceptar el mismo plan al mismo tiempo, el sistema garantiza que solo una lo haga. Esto previene aceptaciones duplicadas accidentales o maliciosas.
Tokenización de Deudas
ComprasPar incorpora un sistema de tokenización de deudas: convierte carteras de deudas en activos digitales fraccionables que pueden transferirse o comercializarse de forma segura y auditada.
¿Qué es un token de deuda?
Un token de deuda es una representación digital de una porción de una cartera de deudas. Si una empresa tiene una deuda de Gs. 10.000.000, puede convertirla en 10 tokens de Gs. 1.000.000 cada uno. Cada token tiene:
UUID único
Cada token tiene un identificador universal único que lo distingue de cualquier otro token en el sistema.
Fracción y valor
Indica qué porción de la deuda original representa y cuál es su valor monetario nominal.
Propietario registrado
Cada token tiene un dueño actual. Cuando se transfiere, se registra el historial completo de la operación.
Auditoría firmada
Cada transferencia se registra con una firma digital HMAC-SHA256, garantizando que el historial no puede ser alterado.
Ciclo de vida de un token
Tokenizar
La deuda se divide en N fracciones iguales
Activo
Disponible para transferir o publicar
Publicado
En el marketplace con precio de venta
Ofertado
Un comprador hizo una oferta
Vendido
Transferencia completada y auditada
¿Por qué tokenizar deudas?
| Necesidad | Solución con tokens |
|---|---|
| Necesitás liquidez de una cartera incobrable | Publicás los tokens con descuento en el marketplace y obtenés el cobro inmediato |
| Querés vender solo una parte de la cartera | Dividís en fracciones y vendés solo los tokens que querés |
| Necesitás ceder deudas a otra empresa del grupo | Transferís los tokens con registro completo y firma digital |
| Necesitás auditar quién es dueño de cada deuda | El historial de transferencias es inmutable y está firmado digitalmente |
Marketplace de Deudas Tokenizadas
El marketplace es el espacio dentro de ComprasPar donde las empresas pueden publicar sus tokens de deuda y comprar los de otras. Es un mercado interno controlado, con visibilidad configurable y auditoría completa de cada operación.
¿Cómo funciona el marketplace?
El vendedor publica un token
Selecciona el token que quiere vender, define el precio de venta (que puede ser menor al valor nominal — con descuento), la fracción ofrecida y la visibilidad del anuncio: privado, solo para su empresa o público.
Los compradores ven las publicaciones activas
Los interesados pueden filtrar por estado, buscar por notas o UUID, y ver todos los detalles: valor nominal, precio pedido, porcentaje de descuento y deuda asociada.
El comprador realiza una oferta
Si le interesa la publicación, puede hacer una oferta con el monto que está dispuesto a pagar. El vendedor recibe la oferta y puede aceptarla o rechazarla.
Se acepta la oferta y se liquida
El vendedor acepta la oferta. El sistema calcula la comisión de plataforma (2% por defecto), descuenta los netos y registra la operación.
El token se transfiere automáticamente
Al completarse la liquidación, el token cambia de propietario de forma atómica (todo o nada). La transferencia queda firmada digitalmente y registrada en el historial permanente.
Estados de una publicación en el marketplace
Visibilidad de las publicaciones
| Tipo | ¿Quién puede ver la publicación? |
|---|---|
| Privada | Solo el dueño del token |
| Negocio | Todos los usuarios de la misma empresa en ComprasPar |
| Pública | Todos los usuarios del marketplace sin restricción |
Comisión de plataforma: El marketplace cobra una comisión del 2% sobre el precio de venta en cada operación concretada. Este porcentaje es configurable por el administrador del sistema.
Un token, una publicación: No es posible publicar el mismo token dos veces de forma simultánea. El sistema bloquea automáticamente cualquier intento de publicación duplicada mientras haya una publicación activa o reservada para ese token.
Seguridad del Sistema
ComprasPar fue diseñado con múltiples capas de seguridad para proteger los datos de tu empresa y de tus clientes en todos los niveles del sistema.
Autenticación separada para clientes
El portal del cliente usa un sistema de login completamente independiente del panel de administradores. Un cliente del portal nunca puede acceder al panel de gestión, y viceversa.
Aislamiento de datos por empresa
Cada cliente del portal solo puede ver los datos de su propio negocio. El sistema inyecta automáticamente el identificador de empresa y de contacto en cada solicitud, haciendo imposible ver datos de otra empresa.
Firma HMAC-SHA256 en transferencias
Cada transferencia de token queda firmada con HMAC-SHA256 usando una clave secreta del servidor. El historial de transferencias es permanente e inalterable.
Límite de intentos de login
Si alguien intenta más de 5 veces ingresar con credenciales incorrectas al portal, el sistema bloquea temporalmente esa cuenta por IP durante 60 segundos. Previene ataques de fuerza bruta.
Prevención de operaciones duplicadas
Las operaciones críticas (aceptar una refinanciación, liquidar una oferta del marketplace) usan bloqueos de base de datos que impiden resultados inconsistentes por operaciones simultáneas.
Verificación de firma en la API
Los endpoints de API del módulo de cobranzas verifican una firma HMAC en cada solicitud entrante. Ninguna solicitud sin firma válida es procesada.
Firma digital de refinanciaciones
Cuando un cliente acepta un plan de refinanciación, el sistema guarda su dirección IP, el navegador utilizado y la fecha y hora exacta, formando un registro legal de la aceptación.
Soporte multi-empresa seguro
Un cliente puede tener cuentas en múltiples empresas con el mismo email. Al iniciar sesión, el sistema presenta un selector de empresa firmado internamente para evitar manipulación.
Protección anti-IDOR: En todo el portal del cliente, cada consulta filtra siempre por el ID de empresa y de contacto del usuario autenticado. Es imposible para un cliente ver las facturas o datos de otro cliente aunque conozca su número de ID.
Qué hace el sistema automáticamente
ComprasPar ejecuta varias tareas en segundo plano sin que nadie tenga que intervenir. A continuación, un resumen de todo lo que ocurre de forma automática.
Facturación electrónica — cada 5 minutos
| Tarea | ¿Qué hace? |
|---|---|
| Envío de pendientes | Detecta todas las ventas finalizadas que aún no tienen factura electrónica y las envía a SIFEN. Procesa hasta 50 por ciclo para no sobrecargar el servidor. |
| Actualización de estados | Consulta en SIFEN el estado de las facturas que quedaron en "Generado" y las actualiza a "Aprobado" o "Rechazado" según la respuesta. |
| Reintento de rechazadas | Si una factura fue rechazada y se corrigió el problema, la incluye en el próximo ciclo de envío automáticamente. |
| Protección anti-solapamiento | Si el ciclo tarda más de 5 minutos, el siguiente espera a que el anterior termine. Nunca corren dos procesos al mismo tiempo. |
Cobranzas — tareas diarias/periódicas
| Tarea | ¿Qué hace? |
|---|---|
| Escalado de deudas vencidas | Las deudas que superan su vencimiento avanzan automáticamente al siguiente nivel de escalado, habilitando las acciones correspondientes. |
| Alertas en el portal | Genera notificaciones automáticas para los clientes del portal sobre vencimientos próximos, nuevas facturas y cambios en sus refinanciaciones. |
| Expiración de publicaciones del marketplace | Las publicaciones que llegaron a su fecha de vencimiento se marcan automáticamente como "Expiradas" y dejan de aparecer en el listado activo. |
| Consulta de estado SIFEN — respaldo diario | Además del ciclo cada 5 minutos, hay un proceso diario de respaldo que consulta el estado de todos los documentos en "Generado". |
Sin intervención manual: Todo este proceso ocurre automáticamente mientras el servidor esté activo. No necesitás recordar enviar facturas, consultar estados ni generar alertas — el sistema lo hace por vos.
Preguntas Frecuentes
Facturación electrónica
¿Cuánto tarda en aparecer el CDC de una factura?
Generalmente segundos. ComprasPar usa el método síncrono de FacturaSend que devuelve el CDC en la misma respuesta. En el peor caso, menos de 5 minutos si la factura entra en el próximo ciclo automático.
¿Qué pasa si SIFEN rechaza una factura?
El sistema guarda el mensaje de error exacto de SIFEN y lo muestra en el panel. Los motivos más comunes son RUC del cliente inválido, datos del establecimiento incorrectos o número de factura duplicado.
Una vez corregido el dato, el sistema reintenta automáticamente en el próximo ciclo de 5 minutos, o podés hacerlo manualmente de inmediato.
¿Puedo cancelar una factura ya aprobada?
Sí. Desde el listado de ventas SIFEN podés cancelar un DE aprobado. La cancelación también se registra ante SIFEN, dejando el documento como "Cancelado". Este proceso no se puede revertir.
¿Funciona en ambiente de pruebas (homologación)?
Sí. ComprasPar puede configurarse para operar en ambiente de prueba durante el período de homologación ante la DNIT. En ese modo, el dashboard muestra un aviso visible de "Ambiente de Prueba". Las facturas emitidas en modo test no tienen validez fiscal.
¿El QR de la factura siempre funciona?
Sí. El código QR se genera directamente en el navegador del cliente usando una librería local, sin depender de servicios externos. El QR lleva al portal de verificación oficial de la DNIT. Solo las facturas con estado Aprobado tienen QR válido.
Portal del cliente
¿El cliente necesita instalar algo para usar el portal?
No. El portal funciona directamente en el navegador del celular o computadora. Solo necesita el link y sus credenciales de acceso (email y contraseña que creó al registrarse).
¿Qué pasa si el cliente compra en dos empresas que usan ComprasPar?
El sistema lo detecta automáticamente. Al iniciar sesión, le muestra un selector para elegir con cuál empresa desea ingresar. Sus datos, facturas y saldos de cada empresa están completamente separados.
¿Puede un cliente ver facturas de otro cliente?
No. El sistema filtra todos los datos por el identificador único del cliente autenticado. Aunque el cliente conozca el número de ID de otra factura, el sistema le mostrará un error porque ese documento no le pertenece.
¿Qué es una refinanciación y cómo la acepta el cliente?
Es un plan de pago en cuotas propuesto por la empresa para regularizar una deuda. El cliente lo recibe como notificación en su portal, puede ver todas las condiciones (cuotas, montos, fechas) y aceptarlo con un clic. El sistema registra la aceptación como firma digital con fecha, hora e IP.
Tokenización y Marketplace
¿Qué pasa con la deuda original cuando se tokeniza?
La deuda original sigue existiendo en el sistema. La tokenización es una representación de esa deuda que permite gestionarla como activo. Cada token representa una fracción del balance total de la deuda de un deudor.
¿Puedo vender solo una parte de un token?
Sí. Al publicar en el marketplace podés indicar qué fracción del token querés ofrecer (por ejemplo, el 50% de un token). El sistema calcula automáticamente el valor nominal correspondiente a esa fracción.
¿Qué garantiza que una transferencia de token no pueda ser alterada?
Cada transferencia genera una firma digital HMAC-SHA256 usando la clave secreta del servidor. Esta firma se almacena junto con los datos de la transferencia. Si alguien intenta modificar el registro en la base de datos, la firma no coincidiría con los datos alterados, detectando la manipulación.
¿Puedo publicar el mismo token dos veces en el marketplace?
No. El sistema bloquea automáticamente la publicación si ya existe una publicación activa o reservada para ese mismo token. Deberías cancelar la publicación existente primero para poder republicar.