# Integrar WhatsApp con ERPNext: un chatbot de IA que reconoce al cliente, vende con tu stock y registra pedido y factura en ERPNext

> Integra WhatsApp con ERPNext 15 o 16: el chatbot de IA reconoce al cliente, vende con tu stock y cada venta queda como pedido de venta y factura en ERPNext.

- URL: https://www.soyagentia.com/integraciones/erpnext-whatsapp/
- Actualizado el 25 de octubre de 2026
- Revisado por Alejandro Díaz, CEO de Agent IA SAS
- SoyAgentia (Agent IA SAS, NIT 901.976.734-4)

## En resumen

- La integración de WhatsApp con ERPNext es nativa en el panel de SoyAgentia: funciona con ERPNext 15 y 16, en Frappe Cloud o en tu propio servidor, por la API REST de Frappe.
- Conectas con la URL de tu ERPNext, una API key y su API secret; el panel detecta la versión, tu empresa y las apps que tienes instaladas.
- El chatbot de IA reconoce al cliente por su celular o por el teléfono de un contacto de su empresa, vende con tus precios con IVA y existencias libres de ERPNext, sincronizados cada madrugada y cuando tus clientes escriben, y le cuenta su saldo si lo pregunta.
- Cada venta pagada queda como pedido de venta validado, que reserva el inventario, con su factura de venta validada, y el PDF le llega al cliente por WhatsApp.

Si tu empresa corre en ERPNext, ahí están tus clientes, tus artículos, tus almacenes y tu cartera. La integración conecta el agente de IA de WhatsApp con esa base: atiende con tus precios y tu stock, sabe quién le escribe y, cuando el cliente paga, la venta queda en ERPNext como pedido de venta y factura, con el PDF en el chat. Es lo que se busca como ERPNext WhatsApp o chatbot ERPNext, y funciona por la API de Frappe, sin instalar apps en tu sitio.

Aquí verás qué hace sola, cómo se conecta, cómo queda cada venta y lo que necesitas para usar ERPNext Colombia o ERPNext México con WhatsApp. Para otros ERP, mira la [integración de ERP con WhatsApp](https://www.soyagentia.com/integraciones/erp/).

## Qué hace sola la integración de ERPNext con WhatsApp

Con ERPNext conectado y activo para facturar:

- Reconoce al cliente por el celular de su ficha o por el teléfono de cualquiera de sus contactos, escrito de cualquier forma (por ejemplo +57 (300) 123-45-67): si escribe la persona de compras de una empresa, el agente sabe a qué cliente pertenece.
- También lo encuentra por su cédula, NIT o RFC, con o sin dígito de verificación, y completa tu [CRM de WhatsApp](https://www.soyagentia.com/crm-whatsapp/) con el nombre, el documento, el correo y la dirección de ERPNext.
- Consulta existencias y precios en la conversación cuando el cliente pregunta por un producto.
- Registra cada venta pagada por pasarela, y cada pedido que tu equipo marca «Pago verificado», como pedido de venta y factura en ERPNext, y le envía el PDF al cliente por WhatsApp. Más en [enviar factura por WhatsApp](https://www.soyagentia.com/enviar-factura-por-whatsapp/).
- Si el cliente pregunta por su cuenta y su número está confirmado, le dice su saldo, lo vencido y su última compra. Más en [estado de cuenta por WhatsApp](https://www.soyagentia.com/estado-de-cuenta-por-whatsapp/).

## Cómo conectar ERPNext con WhatsApp en el panel

En Negocio → Integraciones → ERP, elige ERPNext. La conexión usa la API REST de Frappe con la cabecera «Authorization: token api_key:api_secret», la que indica la [documentación de Frappe sobre autenticación por token](https://docs.frappe.io/framework/user/en/guides/integration/rest_api/token_based_authentication). Lo que necesitas:

- La URL de tu ERPNext, por ejemplo https://miempresa.frappe.cloud, publicada en internet.
- La API key y el API secret de un usuario: en ERPNext, Usuarios → el usuario de la integración → pestaña Configuración → Acceso API → Generar claves. Copia el API secret en ese momento.
- Un usuario con los roles Sales User, Accounts User y Stock User.
- Toca «Conectar y probar»: el panel confirma la versión de ERPNext, tu empresa con su moneda y las apps instaladas.
- En «Datos para facturar», elige cómo se registra la venta, la lista de precios, el almacén, las cuentas de IVA por tarifa (se detectan solas), un producto genérico y el formato de impresión, y toca «Facturar con este ERP».

## Cómo queda la venta en ERPNext: pedido de venta y factura

Con «Pedido de venta + factura», el ajuste recomendado, cada venta pagada crea un pedido de venta con la referencia de la plataforma en «Orden de compra del cliente» y lo valida. Así ERPNext aparta las unidades como cantidad reservada, lo pedido por el cliente y aún sin entregar ([cantidad proyectada en ERPNext](https://docs.frappe.io/erpnext/projected-quantity)). Después crea la factura desde ese pedido, la valida y genera el PDF con tu formato de impresión. Antes de crear nada busca la referencia: un reintento nunca duplica el pedido ni la factura.

El IVA va con la tarifa de cada producto y su cuenta de impuesto. Si en la misma compra hay productos al 19 % y un envío exento, cada tarifa lleva su valor exacto y el total coincide con lo que pagó el cliente.

Si tu configuración de ventas pide la nota de entrega, el pedido queda validado y la factura sale cuando tu equipo entrega. Con «Solo factura» se registra la factura sin pedido, y puedes hacer que descuente el inventario. Un producto nuevo para ERPNext va con el producto genérico o con su descripción. En modo pruebas, el pedido queda en borrador.

## Tu catálogo de ERPNext, sincronizado para que la IA venda

Con «Traer los productos de ERPNext» en sí, la plataforma sincroniza tus artículos de venta cada madrugada, cuando tus clientes escriben y al tocar «Sincronizar productos ahora»:

- El precio de tu lista de venta con el IVA de la plantilla de impuestos del artículo o de su grupo; si tus precios ya incluyen el impuesto, el panel lo detecta.
- Las existencias libres de tus almacenes, o del que elijas: lo reservado por pedidos se descuenta y lo agotado queda «Sin inventario».
- Cada variante con sus atributos, por ejemplo «Camiseta Básica (Negro, M)», la descripción y el grupo de artículos como categoría.
- Empareja por código y, si no, por nombre: conserva tus productos con sus fotos y variantes, y lo que deshabilitas en ERPNext se desactiva aquí. Más en [catálogo en WhatsApp](https://www.soyagentia.com/catalogo-whatsapp/).

## ERPNext Colombia y ERPNext México: lo que necesitas

ERPNext es de código abierto y se adapta a cada país con apps de localización. La comunidad publica apps para Colombia (plan de cuentas PUC, terceros e impuestos), México (timbrado CFDI, en el [Marketplace de Frappe Cloud](https://cloud.frappe.io/marketplace/apps/erpnext_mexico_compliance)) y Chile (integración con el SII). El agente registra la venta en ERPNext y la app de tu país sigue su flujo de facturación electrónica. Para empezar:

- ERPNext 15 o 16 con Ventas, Inventario y Contabilidad configurados.
- Una cuenta de impuesto por cada tarifa de IVA que vendes, o una plantilla de impuestos de venta por defecto.
- Tus artículos con precio en la lista de venta y un producto genérico para lo que vendes sin código.
- El cliente «Consumidor Final» (222222222222), o dejar que la plataforma lo cree, para ventas sin datos del comprador.

## Cómo se adapta ERPNext a tu operación

Lo que gana tu equipo con ERPNext conectado a WhatsApp:

- Inventario al día: el pedido validado reserva las unidades y el agente ofrece solo lo libre.
- Cartera con seguimiento: las facturas pendientes, con las notas crédito restadas, alimentan el saldo del cliente en el chat y en el panel.
- Tus reglas mandan: lista de precios, almacén, impuestos y formato de impresión salen de tu configuración de ERPNext.
- Otros flujos de ERPNext, como notas de entrega o proyectos, los conectamos como proyecto. Escríbenos en [cotizar](https://www.soyagentia.com/cotizar/).
- ERPNext es una marca de Frappe Technologies Pvt. Ltd. SoyAgentia no está afiliada a Frappe Technologies Pvt. Ltd.

## Preguntas frecuentes

### ¿ERPNext ya trae su propia integración con WhatsApp?

Frappe CRM tiene una [integración con WhatsApp](https://docs.frappe.io/crm/whatsapp) que, según su documentación, usa la app Frappe WhatsApp para que tu equipo envíe y reciba mensajes desde prospectos y negocios. El agente de SoyAgentia va más allá: responde solo en tu línea, vende con tu stock y registra el pedido y la factura en ERPNext.

### ¿Funciona con ERPNext en Frappe Cloud y en un servidor propio?

Sí, con ERPNext 15 y 16 en los dos casos. Necesitas una dirección pública y un usuario con sus claves de API; la versión, la empresa y las apps se detectan al conectar.

### ¿Qué pasa con la factura electrónica si uso ERPNext en Colombia o en México?

El agente crea y valida la factura de venta en ERPNext, y tu app de localización sigue su proceso con la DIAN o el SAT. Si esa app guarda el CUFE en la factura, el panel lo lee solo o desde el campo que indiques.

### ¿Puedo elegir de qué almacén salen los pedidos que llegan por WhatsApp?

Sí. En «Almacén» eliges el de tu tienda o bodega: los pedidos salen de ahí y el catálogo ofrece sus existencias libres. Vacío, se suman todos tus almacenes.

### ¿Qué pasa si en la misma compra hay productos con IVA y un envío exento?

Cada tarifa va con su cuenta de impuesto y su valor exacto, así el total de ERPNext es el mismo que cobró la pasarela. Las cuentas de IVA se detectan por su tarifa o las eliges en «Cuentas de IVA por tarifa».

## Sigue leyendo

- [Integración de ERP con WhatsApp](https://www.soyagentia.com/integraciones/erp/)
- [Odoo con WhatsApp](https://www.soyagentia.com/integraciones/odoo-whatsapp/)
- [Enviar factura por WhatsApp](https://www.soyagentia.com/enviar-factura-por-whatsapp/)
- [Estado de cuenta por WhatsApp](https://www.soyagentia.com/estado-de-cuenta-por-whatsapp/)
- [Catálogo en WhatsApp](https://www.soyagentia.com/catalogo-whatsapp/)
- [Pasarelas de pago integradas con WhatsApp](https://www.soyagentia.com/integraciones/pasarelas-de-pago/)
