Inicio · Mapa · Cajas y bancos · Cobros Yape / QR (central de cobros)
Este complemento recibe los pagos que sus clientes hacen por Yape (y, cuando esté habilitado, por QR del BCB), los guarda en una bandeja, los empareja con la venta que los originó y los contabiliza solos como factura y cobro en la cuenta de banco de Yape. Esta guía explica el circuito completo, la pantalla de administración y qué asientos genera. En el demo público https://nitro.com.de/demo (usuario admin, clave 4804) el complemento está activo pero sin pagos cargados, porque los pagos reales llegan desde el teléfono de la empresa.
Cobros Yape / QR (central de cobros)
En dos minutos
Cuando un cliente le paga por Yape, el teléfono de la empresa recibe la notificación “JUAN te envió Bs. 82.00 por Yape”. Una pequeña aplicación instalada en ese teléfono lee la notificación y la envía a NITRO con una clave compartida. A partir de ahí, NITRO:
- Registra el pago en la bandeja de Pagos recibidos con fecha, remitente, monto y estado recibido. Si el monto es menor al mínimo configurado, lo marca como propaganda (son los Bs 1 o Bs 5 de prueba o de publicidad que llegan a cualquier número Yape).
- Lo empareja con quien lo estaba esperando: el formulario de Venta digital en el blog o el asistente Walter por WhatsApp preguntan “¿llegó un pago de Bs 82 del celular 70012345?” y, si coincide monto y ventana de tiempo, el pago pasa a reservado y luego a usado cuando se entrega el producto.
- Lo contabiliza cada minuto, de forma automática: una factura directa al cliente por el ítem vendido (o por el ítem genérico si no se sabe qué se vendió) y el cobro de esa factura en la cuenta de banco Yape. En la bandeja verá “factura #123” en la columna Contabilizado.
Teléfono Yape --notificación--> NITRO: Pagos recibidos (estado recibido / propaganda)
|
Checkout del blog / Walter ------+--> empareja por monto + celular (reservado -> usado)
|
Cada minuto ---------------------+--> Factura directa + Cobro en "Yape 631 BOB" (factura #N)
Dónde está: Cajas y bancos → Pagos en línea → Cobros Yape → Payment Hub (cobros Yape). La pantalla tiene tres pestañas: Pagos recibidos, Conciliación y Conectores. Hay además una vista ampliada, Central de cobros - Pagos recibidos, con filtros, paginación y registro manual.
Conceptos que conviene tener claros
- Conector. La fuente por la que entra un pago: yape (notificaciones del teléfono), openbcb (QR del Banco Central, en preparación) o manual (lo registra usted desde la pantalla).
- Estados de un pago. recibido (llegó y nadie lo reclamó), reservado (un comprador lo reclamó por monto y celular; espera la entrega), usado (ya se entregó el producto o se aplicó a una venta), rechazado, expirado, propaganda (monto bajo el mínimo) y duplicado (la misma notificación llegó dos veces).
- Ventana de conciliación. Minutos hacia atrás en que se busca un pago para emparejarlo con un comprador (30 por defecto). Pasado ese tiempo, el pago sigue en la bandeja pero el comprador deberá usar la recuperación de la Venta digital o pedir ayuda.
- Monto mínimo. Por debajo de ese importe el pago se clasifica como propaganda y no se contabiliza.
- Corte activo. Un número a partir del cual se contabilizan pagos; el histórico anterior a la puesta en marcha queda excluido para no duplicar ventas ya registradas a mano.
- Ítem genérico. Artículo de servicio que se factura cuando el pago no está ligado a ningún producto (en el demo, ASESORIA-YAPE). Debe existir en el catálogo con sus cuentas de venta.
- IVA e IT por dentro. La factura que NITRO genera por cada cobro aplica el IVA 13 % por dentro y el IT 3 % como cualquier factura de venta.
Antes de empezar: configuración (una sola vez)
Pestaña Conectores
- Recepción Yape activa (APK → NITRO): encendido para aceptar notificaciones del teléfono.
- Token del APK: clave compartida con la aplicación del teléfono. Si no coincide, los pagos no entran. Cámbiela por una propia antes de operar.
- Monto mínimo (Bs, por debajo = propaganda): 15 es un valor razonable.
- Contabilización en NITRO → Posteo automático a los libros: si está encendido, cada minuto se contabilizan los pagos pendientes.
- Cuenta banco destino: la cuenta de banco de NITRO donde entra el dinero de Yape (en el demo, Yape 631 BOB). Créela antes en Cajas y bancos → Cuentas como cuenta en bolivianos asociada a su propia cuenta contable.
- Ítem genérico (ventas sin producto): el artículo a facturar cuando no se sabe qué se vendió.
- Guardar (“Configuracion guardada.”).
Los conectores BCB QR y pago manual se anuncian como “proximamente” en esta pestaña; el pago manual, sin embargo, ya se puede registrar desde la Central de cobros (ver más abajo).
El teléfono
La aplicación que lee las notificaciones de Yape se instala en el teléfono que recibe los yapeos de la empresa y se configura con la dirección de su NITRO y el Token del APK. Esa instalación la hace el equipo de NITRO; usted solo necesita que el teléfono esté encendido, con datos y con la aplicación autorizada a leer notificaciones.
Permisos
El rol necesita el área Payment Hub - cobros y conectores. Sin ella verá “No tiene permiso para este modulo. Asignelo en Configuracion → Roles de Seguridad → Payment Hub.” (Usuarios y roles).
Procedimiento del día a día
Revisar la bandeja
- Abra Pagos en línea → Payment Hub (cobros Yape). La pestaña Pagos recibidos lista los últimos pagos con Fecha, Origen (conector), Remitente, Monto, Estado y Contabilizado (factura #N o un guion).
- Para buscar, abra la Central de cobros - Pagos recibidos: filtre por Conector, Estado, Desde / Hasta y Celular, y presione Filtrar.
Registrar un pago manual
Para un pago que no llegó por Yape (transferencia, QR de otro banco, efectivo que quiere tratar igual):
- En la Central de cobros presione + Pago Manual.
- Complete Monto, Remitente y Memo, y confirme. El pago entra con conector manual y estado recibido, y sigue el mismo circuito (emparejar, contabilizar).
Emparejar y marcar un pago
En cada fila de la Central de cobros hay dos acciones:
- Conciliar: asocia el pago a un cliente de NITRO. Útil cuando el remitente del yapeo es un cliente con cuenta corriente y usted quiere que la factura y el cobro salgan a su nombre.
- Marcar usado: cierra un pago que ya se aplicó por fuera (por ejemplo, lo cobró y facturó a mano), para que no vuelva a aparecer como pendiente.
Seguir la contabilización
La pestaña Conciliación resume el estado: Pagos recibidos (Yape), Monto total, Contabilizados (cantidad e importe), Pendientes de postear, Propaganda (< mínimo) y Corte activo. La nota al pie lo recuerda: “Solo se contabilizan pagos con id mayor al corte (el histórico anterior queda excluido). Los pendientes se postean solos cada minuto via cron.”
Qué asiento genera cada cobro
Por cada pago contabilizado NITRO registra dos documentos, con la fecha del pago. Ejemplo: un yapeo de Bs 82 por el producto Control CF IVA (ítem de servicio).
1. Factura directa de venta (referencia FV-)
| Cuenta | Debe | Haber |
|---|---|---|
| Cuentas por cobrar (cliente genérico o el cliente conciliado) | 82,00 | |
| Ventas / ingresos del ítem | 71,34 | |
| Débito fiscal IVA 13 % | 10,66 | |
| Impuesto a las transacciones (gasto IT 3 %) | 2,46 | |
| IT por pagar | 2,46 |
2. Cobro del cliente (comprobante CI)
| Cuenta | Debe | Haber |
|---|---|---|
| Banco Yape 631 BOB | 82,00 | |
| Cuentas por cobrar | 82,00 |
El cobro queda aplicado a la factura, así que la cuenta por cobrar vuelve a cero. Ambos documentos se ven en Ventas → Consultas y en la Consulta de Diario; la factura aparece en el Libro de Ventas IVA.
Si su empresa emite facturas electrónicas al SIAT, estas facturas directas se tratan como cualquier otra venta: revise la configuración de facturación electrónica para decidir si se emiten automáticamente o quedan como ventas internas.
Situaciones y problemas comunes
- El cliente dice que pagó y el pago no aparece. Revise en orden: (1) que el teléfono con la aplicación esté encendido y con datos; (2) que Recepción Yape activa esté marcada; (3) que el Token del APK coincida con el del teléfono; (4) que el monto no sea menor al Monto mínimo (estaría como propaganda). Mientras tanto puede registrar un Pago Manual para no frenar la entrega.
- El pago está “recibido” hace días y nunca se contabilizó. Posteo automático a los libros está apagado, o el pago tiene un número anterior al Corte activo, o la tarea de cada minuto no está corriendo (pida soporte). Los pagos marcados propaganda nunca se contabilizan.
- Se contabilizó con el ítem genérico y no con el producto real. El pago no quedó ligado al producto (el cliente pagó sin pasar por el formulario, o pagó un importe distinto al precio). Anule la factura y el cobro desde Anular una transacción y registre la venta correcta, o simplemente deje el ítem genérico si su contabilidad no distingue.
- El mismo yapeo aparece dos veces. La aplicación reenvió la notificación. NITRO marca la copia como duplicado; si quedó como recibido, use Marcar usado en la copia.
- “No tiene permiso para este modulo…“ Falta el área Payment Hub en el rol.
- La cuenta banco destino no aparece en la lista. Todavía no creó la cuenta de banco de Yape en Cajas y bancos.
- Quiero dejar de contabilizar automáticamente. Desmarque Posteo automático a los libros: los pagos seguirán entrando a la bandeja y podrá facturarlos a mano.
Preguntas frecuentes
¿A nombre de quién sale la factura? Al cliente genérico de ventas (consumidor final) salvo que haya usado Conciliar para asignar el pago a un cliente concreto antes de que se contabilice.
¿Puedo cobrar facturas ya emitidas con este complemento? No directamente: el complemento genera su propia factura directa por cada pago. Si ya emitió la factura, registre el cobro normal en Ventas → Cobro contra la cuenta Yape y use Marcar usado en la bandeja.
¿Qué pasa con el yapeo de Bs 1 que manda Yape para verificar? Queda como propaganda y no se contabiliza.
¿Sirve para QR de otros bancos? Hoy solo Yape está automatizado; el QR del BCB está en preparación. Cualquier otro pago se registra como Pago Manual.
¿El dinero de Yape cómo llega al banco? Eso ocurre fuera de NITRO. Cuando transfiera el saldo de Yape a su cuenta bancaria, regístrelo como una transferencia entre cuentas (Yape → Banco).



