Documentación de producto

Cómo funciona Numy

Numy es tu contador por WhatsApp: le escribes en lenguaje natural y él ejecuta tus trámites fiscales — factura tus tickets de consumo, emite tus CFDI, descarga tu Constancia de Situación Fiscal y tu Opinión de Cumplimiento (32-D), consulta tu Buzón Tributario, prepara tus declaraciones y valida pagos SPEI contra Banxico. Todo queda registrado en tu panel web (console.numy.mx).

Esta guía explica los conceptos del producto (cuenta, RFCs, números, terminales) y el paso a paso de cada operación por WhatsApp.

¿Eres desarrollador y quieres integrar Numy en tu sistema? Hay una API REST documentada aquí.

Registro

Te registras en console.numy.mx/auth/register (o desde los botones de numy.mx):

  1. Teléfono — te mandamos un código OTP por WhatsApp y lo confirmas. Así validamos que el dueño del teléfono es quien se registra.
  2. Correo, contraseña y confirmación — serán tu acceso al panel web.
  3. Datos fiscales — persona física: nombre, apellidos, RFC y código postal fiscal; persona moral: razón social, RFC y código postal.
  4. Régimen fiscal — lo eliges de la lista.

Persona moral: escribe tu razón social sin el tipo de sociedad (sin "SA de CV", "S. de R.L.", etc.) y exactamente como aparece en tu Constancia de Situación Fiscal. El SAT rechaza el timbrado cuando el nombre no coincide con el registrado.

Al terminar el registro quedan listas tres cosas de una vez: tu cuenta, tu número de WhatsApp validado y tu primer RFC vinculado a ese número — ya puedes escribirle a Numy y operar. (Número y RFC no van obligatoriamente juntos: ver RFCs.)

Tu cuenta

Una cuenta es tu usuario de Numy: correo + contraseña. Con ella entras al panel en console.numy.mx. Dentro de una cuenta viven tus RFCs, tus números de WhatsApp y tus terminales.

  • Titulares. En el panel puedes designar uno o más números como titulares de la cuenta. Solo los titulares pueden pedir acceso al panel desde WhatsApp (ver Entrar desde WhatsApp). Siempre debe quedar al menos un titular.
  • ¿Olvidaste tu contraseña? Desde la pantalla de login puedes pedir un enlace de restablecimiento a tu correo (válido por 1 hora).

RFCs

Un RFC en Numy es una persona física o moral: una entidad de primera clase dentro de tu cuenta. A un RFC le cargas su e.firma (para trámites SAT) y sus sellos CSD + carta manifiesto (para emitir facturas), y sobre él se acumula todo su historial fiscal.

  • Un RFC no necesita tener un número de WhatsApp ligado.
  • La relación es muchos-a-muchos: un número puede tener varios RFCs y un RFC puede vivir en varios números.
  • Puedes ligar un RFC a un número que habla con Numy normal, o a números que operan a través de una terminal.
  • Desligar un número nunca borra el RFC ni sus credenciales ni su historial.

Panel de RFCs

En console.numy.mx/dashboard/fiscal ves todos los RFCs de tu cuenta y, por cada uno:

  • Si tiene su e.firma cargada y validada.
  • Si tiene sellos (CSD) cargados y el manifiesto firmado — lo que habilita emitir facturas.
  • Si está ligado a un número de Numy normal o conectado a una terminal.
  • Qué puede hacer: emitir facturas y/o trámites SAT (constancia, opinión de cumplimiento, buzón, declaraciones, descarga de facturas — requieren e.firma validada).

Detalle de un RFC

Al entrar a un RFC (dashboard/fiscal/{id}) ves el concentrado de todo lo realizado con él: tickets de consumo facturados, facturas emitidas, constancias, opiniones de cumplimiento, reportes de buzón y descargas de CFDI, con su estado. Cada movimiento registra por qué medio se hizo y quién lo hizo: la API, Numy normal, un número autorizado de una terminal, o el panel web. Desde esa misma pantalla puedes solicitar manualmente una constancia, una opinión de cumplimiento o una descarga masiva de facturas — y queda registrado como solicitado desde la web.

Números de WhatsApp

Un número de Numy es un teléfono de WhatsApp. Hay cuatro tipos:

Tipo Qué es
Numy normal El número oficial de Numy: +52 221 526 9907. Le escribes y Numy contesta.
Número ligado a Numy normal Cualquier teléfono tuyo que, al escribirle a Numy normal, recibe respuesta y puede ejecutar trámites. Se liga desde el panel (o automáticamente al registrarte).
Número de terminal Un número tuyo que funge como "Numy propio": contesta y ejecuta operaciones para los números autorizados de esa terminal.
Número autorizado Un teléfono que agregas dentro de una terminal; cuando le escribe a esa terminal, la terminal le contesta.

Todos los números de tu cuenta se ven y gestionan en console.numy.mx/dashboard/numeros — los números de Numy en una sección y los contactos de terminales en otra.

¿Cuándo se valida un número por OTP?

Acción ¿OTP? Por qué
Ligar un número a Numy normal Asegura que el dueño del teléfono es quien lo registra.
Designar un número como número de terminal La terminal opera a nombre de tu negocio.
Agregar un número autorizado a una terminal No Es un contacto que recibe el servicio, no el dueño de la línea.
Un número que ya validaste en tu cuenta No No se valida doble.

Un número validado vive en una sola cuenta

Un teléfono validado pertenece a una sola cuenta de Numy. Si intentas validar un número que ya está en otra cuenta, Numy te avisa: "Este número está vinculado a otra cuenta; al validar el código se moverá a la tuya y la otra cuenta perderá el acceso" — y te deja hacerlo confirmando el OTP. A ti te aparece como validado en dashboard/numeros; a la cuenta anterior le sigue apareciendo ahí, pero marcado como desvinculado — validado por otra cuenta. Las credenciales fiscales no viajan con el teléfono: los RFCs, e.firmas y sellos se quedan en la cuenta donde fueron dados de alta.

Los números autorizados de terminal son distintos: al ser contactos (no operadores de la cuenta), el mismo teléfono puede estar autorizado en terminales de cuentas diferentes — por ejemplo, un empleado que opera para dos negocios.

Terminales

Una terminal es un número de WhatsApp validado de tu negocio que atiende a tus números autorizados: cuando uno de ellos le escribe, la terminal contesta y ejecuta operaciones de Numy (facturar tickets, emitir facturas, validar pagos, trámites SAT). Se crean y gestionan en console.numy.mx/dashboard/terminals.

Activación

Crear la terminal no la deja operando de inmediato: queda en proceso de activación y necesitas contactar a soporte de Numy, que agenda una sesión contigo para conectar tu número. Mientras tanto puedes ir configurando sus números autorizados, RFCs y permisos. Una vez activa, aparece en verde: "terminal lista para operar".

Números desconocidos

Por defecto, si le escribe un número que no está autorizado, la terminal guarda silencio (tu línea sigue siendo tu línea: Numy no le contesta a tus clientes normales). Si activas la opción de responder a desconocidos, la terminal le indica una vez que no está registrado y le comparte el contacto del administrador para que lo den de alta.

Números autorizados, RFCs y permisos

Al agregar un número autorizado defines su nombre y le vinculas uno o varios RFCs con casillas. Los permisos se marcan por cada RFC ligado: el mismo número puede, por ejemplo, facturar tickets con el RFC de la empresa y solo descargar constancias con su RFC personal. Estos son los servicios que puedes habilitar:

Permiso Qué habilita
Facturar tickets de consumo Mandar fotos de tickets y recibir su CFDI.
Emitir facturas propias Emitir CFDI de los RFCs que tenga ligados.
Validar pago (sin factura) Verificar comprobantes SPEI contra Banxico.
Validar pago y facturar Pago verificado → factura automática (ver Pago → factura).
Descargar constancia Constancia de Situación Fiscal del RFC ligado.
Opinión de cumplimiento (32-D) Opinión del RFC ligado.
Buzón tributario Reporte del buzón del RFC ligado.

Tip: si un número autorizado aún no tiene datos fiscales, basta con que mande su Constancia de Situación Fiscal en PDF al chat de la terminal: Numy la lee y captura sus datos automáticamente.

Para validar pagos, la terminal debe tener configurada la cuenta del negocio (CLABE o tarjeta donde recibes los depósitos): así los comprobantes se verifican contra tu cuenta y no contra cualquiera.

Clientes frecuentes

Un cliente es un receptor recurrente de facturas que pertenece al RFC emisor (no al número). Sirve para emitir rapidísimo: "factura 500 pesos a Constructora López" y Numy toma sus datos guardados.

  • Se comparten. Como pertenecen al RFC, los ve cualquier número que pueda emitir con ese RFC (si un número da de alta un cliente, los demás lo pueden usar).
  • Alta manual desde el detalle del RFC en el panel, o por chat: al terminar una factura a un receptor nuevo, Numy te ofrece guardarlo como cliente frecuente.
  • Gestión por chat: escribe mis clientes, agregar cliente, editar cliente o borrar cliente.

Qué puedes hacer

Las operaciones disponibles dependen del canal por el que hablas con Numy:

Operación Numy normal Terminal Otros canales
Facturar ticket de consumo API
Emitir una factura (CFDI) API
Cancelar una factura emitida
Complemento de pago (REP)
Constancia de Situación Fiscal Panel API
Opinión de Cumplimiento (32-D) Panel API
Reporte de Buzón Tributario API
Presentar declaración fiscal No
Validar pago SPEI API
Validar pago → emitir factura No
Descarga masiva de CFDI (SAT) Panel
  • ¿Por qué la declaración no existe en terminal? Presentar una declaración es un acto legal irreversible del titular con su e.firma; un operador de terminal (un tercero) no debe presentarla por otro. Se hace desde el número personal ligado a Numy normal.
  • ¿Por qué "pago → factura" es solo de terminal? Porque la terminal tiene configurada la cuenta del negocio (CLABE) contra la que se verifica el depósito antes de emitir la factura automáticamente.

Reglas del chat

Si tu número tiene varios RFCs

Cualquier operación te pregunta primero a qué RFC aplica y luego sigue el flujo — salvo que ya lo hayas dicho en tu mensaje ("emite una factura de Comercializadora XYZ…"). Aplica a facturar tickets, constancia, opinión, buzón, declaraciones y emisión.

Fotos y documentos

  • En Numy normal, una foto sin más contexto se toma como ticket de consumo a facturar. Los PDF también se leen.
  • Si estás a media emisión de factura, las imágenes/PDF que mandes se usan para ese flujo (por ejemplo, la Constancia del receptor en PDF).
  • En una terminal, los archivos se procesan según los servicios habilitados para tu número (pago, ticket o factura).

Notas de voz

Numy entiende notas de voz (las transcribe y las procesa como texto). Disponible para cuentas con plan de paga activo.

Salir de un flujo

En cualquier flujo puedes escribir cancelar para salir sin ejecutar nada.

Tiempos

Los trámites que entran al SAT (constancia, opinión, buzón, declaraciones) los ejecuta un robot con tu e.firma y tardan unos minutos; el documento llega al mismo chat cuando está listo.

El recorrido de un mensaje

Esto es lo que pasa —de principio a fin— cada vez que le escribes a Numy o a una terminal:

chat Le escribes a Numy
Texto, foto, PDF o nota de voz, al número de Numy o al de tu terminal.
alt_route ¿Tu número está registrado?
En Numy normal: ligado a una cuenta. En terminal: autorizado en esa terminal.
No
Numy te contesta con tu enlace de registro y ahí termina. (Una terminal, por defecto, guarda silencio con desconocidos.)
pending_actions ¿Tienes un trámite a medias?
Por ejemplo, un ticket esperando el uso de CFDI o una factura esperando confirmación.

Tu mensaje continúa ese trámite justo donde iba. Escribe cancelar para salir.
No
psychology Numy detecta la intención
Una foto suelta se asume ticket de consumo; el texto dice la operación: "quiero mi constancia", "factúrale a…", "valida este pago".
badge ¿Tu número tiene varios RFCs?
Y no dijiste cuál en tu mensaje.

Numy te pregunta con cuál RFC operar… y continúa.
No / ya elegido
bolt Se ejecuta la operación
Numy completa lo que falte preguntándote solo lo mínimo, y trabaja:
🧾 Ticket → portal del comercio 📄 Factura → timbrado CFDI 🏛️ Trámite SAT → robot con tu e.firma 🏦 Pago → CEP de Banxico
verified_user ¿Es un acto delicado?
Emitir una factura, cancelarla o presentar una declaración.

Numy te muestra el resumen y espera tu CONFIRMAR (o CONFIRMO en declaraciones). Nada se timbra ni se presenta sin ti.
Listo
task_alt Recibes el resultado en el chat
El PDF, acuse o reporte llega al mismo chat, y todo queda registrado en tu panel.

Diagrama general — el paso a paso de cada operación está en las secciones siguientes.

Facturar un ticket de consumo

Manda la foto del ticket (OXXO, Walmart, Home Depot, gasolineras, restaurantes y muchos más) y Numy obtiene tu CFDI desde el portal de facturación del comercio:

  1. Si tu número tiene varios RFCs, te pregunta con cuál facturar.
  2. Te pregunta el uso de CFDI (con opciones; el más común es G03 — Gastos en general).
  3. Te pregunta la forma de pago (efectivo, tarjeta, transferencia…).
  4. Numy entra al portal del comercio, genera la factura y te entrega los archivos por el chat.

Si no contestas las preguntas en un par de minutos, Numy factura con los valores por defecto (uso G03, pago con tarjeta) para que tu ticket no se quede esperando.

Casos que Numy te avisa

  • Comercio no soportado: si el portal de ese comercio aún no está integrado, te lo dice de inmediato (y no se consume tu operación de facturación en portal).
  • Ticket vencido: la mayoría de los comercios solo permiten facturar tickets del mismo mes. Si el portal lo rechaza por vencido, Numy te lo explica.
  • Ticket ilegible: si la foto no se alcanza a leer, te pide que la tomes de nuevo con mejor luz.
  • Ticket duplicado: si ya facturaste ese mismo ticket, Numy lo detecta y no lo cobra dos veces.

Emitir una factura (CFDI)

Aquí tú eres el emisor: Numy timbra un CFDI de tu RFC a tu cliente. Requiere que el RFC tenga sellos (CSD) cargados y manifiesto firmado (ver e.firma y sellos). Puedes dar todo en un solo mensaje o irlo completando; Numy pregunta solo lo que falte.

Factúrale 1,500 pesos a Constructora López por
supervisión de obra, ya incluye IVA

El receptor

  • Cliente guardado: si el nombre coincide con un cliente frecuente de tu RFC, Numy usa sus datos.
  • Receptor nuevo: para timbrar, el SAT exige del receptor su RFC, razón social exacta (como en su Constancia), código postal fiscal y régimen. Dáselos a Numy en el chat, o mejor: manda la Constancia de Situación Fiscal del receptor en PDF y Numy extrae todo solo.
  • Si la factura sale bien con un receptor nuevo, Numy te ofrece guardarlo como cliente frecuente.

Conceptos e impuestos

  • Describes tus conceptos en texto libre; Numy les asigna las claves correctas del catálogo SAT (ClaveProdServ y unidad) — nunca se inventan.
  • IVA: por defecto 16%. Si tu operación es exenta, a tasa 0% o de región fronteriza (8%), dilo en el mensaje. "Ya incluye IVA" desglosa la base; si no lo incluye, se agrega.
  • Defaults si no especificas: tipo Ingreso (I), moneda MXN, método PUE, uso G03.
  • Si el receptor es persona moral y tu régimen lo requiere (RESICO, honorarios, arrendamiento), Numy aplica las retenciones correspondientes automáticamente.

Confirmación

Antes de timbrar, Numy te muestra el resumen completo (emisor, receptor, conceptos, desglose de impuestos y total) y solo timbra cuando respondes CONFIRMAR. Después te entrega el PDF por el chat y puede enviarlo por correo al receptor. Timbrar consume folio fiscal: la confirmación siempre es tuya.

Si tu número tiene varios RFCs emisores, Numy usa el último que usaste y puedes cambiarlo en cualquier momento escribiendo cambiar emisor.

También puedes escribir repetir factura para volver a emitir tu última factura (por ejemplo, la renta de cada mes).

Cancelar una factura

Pídelo en el chat: "quiero cancelar la factura de…". Numy localiza la factura emitida, te pregunta el motivo SAT y ejecuta la cancelación:

  • 01 — comprobante con errores con relación: requiere indicar el CFDI que la sustituye (mismo receptor).
  • 02 — comprobante con errores sin relación.
  • 03 — no se llevó a cabo la operación.

Para evitar accidentes, la cancelación exige teclear CONFIRMAR CANCELACIÓN. Según las reglas del SAT, el receptor puede tener hasta 72 horas para aceptar o rechazar; Numy te informa el estado (en proceso, aceptada, rechazada) conforme se actualiza.

Complemento de pago (REP)

Si emitiste una factura PPD (pago en parcialidades o diferido), al recibir el pago debes emitir un complemento de pago. En el chat: "registra un pago de la factura de…". Numy encuentra tus facturas PPD con saldo y te pregunta:

  1. Monto del pago recibido.
  2. Forma de pago real (transferencia, efectivo, tarjeta…).
  3. Fecha del pago.
  4. Resumen → confirmas → se timbra el REP y recibes el PDF.

A inicio de mes, Numy te recuerda los complementos de pago que tengas pendientes del mes anterior.

Constancia de Situación Fiscal

Pídela en lenguaje natural. Requiere la e.firma validada del RFC: el robot de Numy entra al SAT con ella, descarga la constancia oficial en PDF y te la entrega en el chat en unos minutos. Si tu número tiene varios RFCs, te pregunta de cuál.

Quiero mi constancia de situación fiscal

También puedes solicitarla desde el panel, en el detalle del RFC.

Opinión de Cumplimiento (32-D)

Igual que la constancia: pídela en el chat y el robot la descarga del SAT con tu e.firma validada.

Necesito mi opinión de cumplimiento

Buzón Tributario

Pide tu reporte del buzón ("mándame mi buzón tributario") y Numy lo consulta con tu e.firma y te entrega un resumen de lo que hay.

Solo lectura, a propósito. El robot jamás abre notificaciones pendientes de tu buzón: abrirlas con e.firma se considera notificación legal y dispara plazos (CFF). Numy solo consulta y reporta; abrir una notificación es decisión tuya.

Declaraciones (RESICO)

Disponible para personas físicas en RESICO, solo desde tu número personal (no en terminales). El flujo está diseñado para que nada se presente sin tu confirmación explícita:

  1. La pides en el chat ("quiero presentar mi declaración"). Numy revisa en el SAT qué periodos tienes pendientes y te hace unas preguntas rápidas para confirmar que tu caso aplica.
  2. El robot calcula y guarda el borrador en el portal del SAT (ISR/IVA) y te muestra los montos para que los revises. No presenta nada todavía.
  3. Solo cuando escribes CONFIRMO viendo el total, el robot presenta la declaración y te entrega el acuse (y la línea de captura si hay impuesto a pagar).

Numy también te recuerda por WhatsApp cuando se acerca la fecha límite de tu declaración.

Validar un pago SPEI

¿Te mandaron un comprobante de transferencia y quieres saber si es real? Manda la foto o captura del comprobante SPEI y Numy lo verifica contra el CEP de Banxico, que valida la operación completa: clave de rastreo + fecha + monto + cuentas. Un comprobante photoshopeado no pasa. Si el pago existe, te entrega el CEP oficial de Banxico.

Resultados posibles

Resultado Qué significa
Liquidado El dinero fue abonado. Se entrega el comprobante oficial (CEP).
En proceso Banxico aún no publica la operación (pagos muy recientes). Reintenta en 10–30 minutos.
No encontrado No existe una operación con esos datos. Ojo: puede ser un comprobante falso.
Devuelto / rechazado La transferencia no se acreditó (fue devuelta o rechazada por el banco).
  • Banxico permite consultar operaciones de hasta 45 días hábiles atrás.
  • Las validaciones se procesan dentro del horario de consulta del CEP (aprox. 9:30–23:00, hora del centro).
  • En terminales, el comprobante se verifica contra la cuenta configurada del negocio — un depósito a otra cuenta no cuenta como pagado.

Validar pago → emitir factura (terminal)

El flujo estrella de las terminales: tu cliente (número autorizado) manda el comprobante del SPEI con el que te pagó y, cuando Banxico confirma Liquidado contra la cuenta del negocio, Numy emite la factura automáticamente con los datos fiscales del contacto y le entrega el PDF por el mismo chat. Sin capturar nada.

  1. El contacto manda su comprobante a la terminal.
  2. Numy valida contra el CEP de Banxico (cuenta del negocio incluida).
  3. Pago liquidado → se timbra la factura al RFC del contacto y se le entrega.

Requiere que el número autorizado tenga el permiso "Validar pago y facturar", que la terminal tenga su cuenta bancaria configurada y que el RFC emisor tenga sellos y manifiesto listos.

Entrar al panel desde WhatsApp

Escribe Quién puede Qué recibes
dame el panel / login Solo números titulares Enlace de acceso al panel, válido por 1 hora y de un solo uso.
ver mis tickets / historial Cualquier número ligado Enlace de solo lectura a tu historial (tickets, facturas, constancia), válido por 24 horas.

Si un número no titular pide el panel, Numy le explica que solo el titular de la cuenta puede acceder.

e.firma y sellos (CSD)

Las credenciales se cargan únicamente en el panel web — nunca por WhatsApp:

  • e.firma (.cer + .key + contraseña): habilita los trámites SAT (constancia, opinión, buzón, declaraciones, descarga de facturas). Al subirla, Numy la valida directamente ante el SAT; en el panel ves si quedó validada.
  • Sellos CSD + carta manifiesto: habilitan emitir facturas. Subes tu CSD y firmas la carta manifiesto en el mismo panel; cuando el proceso termina, tu RFC queda listo para timbrar en producción.

¿Tu contador tiene los archivos? Desde el panel puedes generar un enlace seguro de carga (válido por 7 días) y mandárselo: él sube la e.firma y los sellos sin necesidad de entrar a tu cuenta.

Seguridad: tus archivos y contraseñas se guardan cifrados y se usan exclusivamente para ejecutar los trámites que tú pidas. Numy nunca te pedirá tu e.firma por chat.

Descarga masiva de CFDI

Desde el detalle del RFC en el panel puedes pedir la descarga masiva de tus facturas emitidas y recibidas directamente del SAT (requiere e.firma validada). Eliges el periodo, el robot hace la solicitud ante el SAT, recupera los paquetes y tus CFDI quedan importados en el panel para consultarlos y descargarlos. El proceso corre en segundo plano y puede tardar según el volumen y los tiempos del SAT.

Planes y consumo

Numy funciona con operaciones incluidas por mes según tu plan (ver planes y precios). La regla es simple: 1 operación ejecutada = 1 operación de tu plan, y se descuenta al confirmar/despachar la operación (analizar un ticket o pedir un resumen no consume nada). Si un ticket resulta duplicado, la operación se te regresa.

  • ¿Se te acabaron las operaciones del mes? Puedes comprar paquetes extra de 30, 50 o 100 operaciones ($7.50 MXN c/u, pago único) con vigencia de 6 meses. Requieren plan activo; se consumen después de las de tu plan.
  • Terminales: el plan Empresarial incluye 3 terminales. Cualquier plan de paga puede sumar una terminal adicional con el add-on de terminal ($999 MXN/mes, IVA incluido).
  • Al llegar a un límite de tu plan (operaciones, RFCs o terminales), Numy te lo dice claramente en el chat o en el panel, con la opción de ampliar.