**[[start|Inicio]] · [[help:mapa_antpro|Mapa]] · [[help:app_bancos|Cajas y bancos]] · [[help:cobros_yape_qr|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 [[help:venta_digital|Venta digital]] en el blog o el asistente [[help:yego_whatsapp|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**.

<code>
  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)
</code>

**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.

{{:help:w6_ph_pagos.png?650|La bandeja de Pagos recibidos en el demo (vacía): fecha, origen, remitente, monto, estado y si ya se contabilizó}}

===== 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 ====

{{:help:w6_ph_conectores.png?650|Conectores en el demo: recepción Yape activa con su token, monto mínimo, posteo automático, cuenta de banco destino e ítem genérico}}

  * **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 [[help:bancos_completo#cuentas_de_banco_y_caja|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."// ([[help:guia_usuarios|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**.

{{:help:w6_ph_payments.png?650|La Central de cobros: filtros por conector, estado, fechas y celular, el contador de pagos encontrados y el botón + Pago Manual}}

==== 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."//

{{:help:w6_ph_conciliacion.png?650|La pestaña Conciliación: contadores de recibidos, contabilizados, pendientes y propaganda}}

===== 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 [[help:ventas_completo#consultas_y_reportes_de_ventas|Ventas → Consultas]] y en la [[help:contabilidad:consulta_de_diario|Consulta de Diario]]; la factura aparece en el [[help:librodeventasiva-excel|Libro de Ventas IVA]].

> Si su empresa emite **facturas electrónicas** al SIAT, estas facturas directas se tratan como cualquier otra venta: revise la [[help:ventas:configuracion_fe_y_homologacion|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 [[help:contabilidad:anular_una_transaccion|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 [[help:ventas_completo#cobro_del_cliente|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 [[help:bancos_completo#transferencias_entre_cuentas|transferencia entre cuentas]] (Yape → Banco).

===== Ver también =====

  * [[help:venta_digital|Venta digital (productos digitales con cobro por QR)]]
  * [[help:yego_whatsapp|Walter: asistente de WhatsApp]]
  * [[help:bancos_completo|Cajas y bancos]] · [[help:ventas_completo|Ventas paso a paso]]
  * [[help:librodeventasiva-excel|Libro de Ventas IVA]]
  * [[help:guia_usuarios|Usuarios y roles]]