Cinco principios para integrar sin dolor
- El sistema externo va a fallar. Toda llamada a un tercero debe tener tiempo límite, reintentos con espera creciente y un plan si no responde.
- Idempotencia. Si un pago o una factura se envía dos veces por un reintento, el resultado debe ser uno solo. Cada operación lleva una llave única.
- Colas, no esperas. El usuario no espera a que timbre el PAC o responda el ERP: la tarea se encola y la pantalla muestra el estatus.
- Webhooks verificados. Las notificaciones entrantes (pago aprobado, mensaje recibido) se validan con firma antes de procesarse.
- Bitácora completa. Cada petición y respuesta queda registrada para resolver disputas con proveedores y clientes.
Pasarelas de pago
En México las opciones más usadas son Stripe, Mercado Pago, Conekta, Openpay y Clip, además de la conexión directa con un banco adquirente. La elección depende de métodos de pago (tarjeta, OXXO, SPEI, meses sin intereses), comisiones y tiempos de depósito.
- No toques datos de tarjeta. Usa los formularios o campos alojados de la pasarela (tokenización). Así tu plataforma reduce drásticamente su alcance de PCI DSS.
- Confirma por webhook, no por la pantalla de regreso. El cliente puede cerrar el navegador antes de volver; el webhook es la fuente de verdad.
- Conciliación diaria entre lo cobrado, lo depositado y las comisiones.
- Cobros recurrentes: reintentos automáticos, avisos de tarjeta vencida y cancelación de autoservicio.
Facturación CFDI 4.0
La facturación electrónica se integra a través de un Proveedor de Certificación Autorizado (PAC) con API. Puntos críticos:
- Datos fiscales exactos del receptor: nombre, RFC, régimen fiscal y código postal deben coincidir con la constancia de situación fiscal. Valídalos en la captura, no al timbrar.
- Catálogos del SAT (uso de CFDI, forma y método de pago, clave de producto y unidad) mantenidos dentro de la plataforma.
- Complementos de pago para ventas a crédito o en parcialidades.
- Cancelación con motivo y, cuando aplica, aceptación del receptor.
- Resguardo de XML y PDF ligados a la venta o cobro que los originó.
WhatsApp Business API
Para notificaciones automáticas (confirmación de cita, estatus de pedido, aprobación de cotización) se usa la API oficial de WhatsApp Business, directamente con Meta o mediante un proveedor autorizado.
- Los mensajes que inicia la empresa usan plantillas aprobadas por Meta.
- Se necesita el consentimiento del cliente para recibir mensajes.
- Meta cobra por conversación o mensaje según la categoría (utilidad, marketing, autenticación); hay que considerarlo en el costo de operación.
- Las respuestas del cliente entran por webhook y pueden mover el flujo: por ejemplo, aprobar una cotización con un botón.
ERP y sistemas contables
Integrar con CONTPAQi, Aspel, SAP Business One, Odoo, Microsoft Dynamics u otro ERP suele ser lo más delicado: cada uno tiene su forma de exponer datos (API REST, servicios SOAP, bases de datos locales o archivos de intercambio).
- Define quién es dueño de cada dato. Clientes en el CRM, productos y existencias en el ERP, cotizaciones en la plataforma. Cada dato se edita en un solo lugar.
- Sincroniza por eventos cuando el ERP lo permite; si no, por lotes programados con control de cambios.
- Mapea catálogos (unidades, impuestos, almacenes) antes de escribir una línea de código.
- Ambiente de pruebas del ERP obligatorio: nunca se prueba contra la contabilidad real.
Periféricos: NFC, lectores, impresoras y básculas
En operación de campo, talleres, almacenes y puntos de venta, la plataforma necesita hablar con hardware:
- NFC: registros de asistencia o identificación de activos con un toque del teléfono. En Android se lee directamente desde la app; en la web, Web NFC funciona en Chrome para Android.
- Lectores de código de barras y QR: la mayoría se comporta como teclado; la clave es diseñar pantallas que reciban la lectura sin clics.
- Impresoras de tickets y etiquetas: por red, USB o Bluetooth, con comandos ESC/POS o ZPL.
- Básculas y terminales punto de venta: por puerto serie, USB o SDK del fabricante; a veces requieren un pequeño servicio local como puente.
- GPS: validación de ubicación con tolerancia y detección de ubicaciones simuladas.
Lo que no se ve pero importa: funcionar sin señal y sincronizar al volver, sin duplicar registros.
Mapas y geolocalización
Mapas de sucursales, rutas, geocercas o planos interactivos. Opciones: Google Maps Platform, Mapbox o mapas abiertos (OpenStreetMap con MapLibre). Considera el costo por carga de mapa y por consulta de direcciones cuando el volumen crece, y guarda coordenadas en la base de datos con tipos geográficos para búsquedas por cercanía.
Checklist antes de integrar
- ¿Hay documentación de API y ambiente de pruebas (sandbox)?
- ¿Quién paga el consumo (timbres, mensajes, mapas, comisiones)?
- ¿Qué pasa si el servicio externo no responde durante una hora?
- ¿Cómo se concilian los datos al final del día?
- ¿Quién da soporte cuando el proveedor cambia su API?
En Forespot hemos integrado pagos, CFDI, WhatsApp, Excel, archivos DWG, NFC y GPS en plataformas que operan todos los días. Cuéntanos qué necesitas conectar.
Preguntas frecuentes
¿Cuánto tarda integrar una pasarela de pago?
Una integración estándar con confirmación por webhook y registro de pagos toma alrededor de dos semanas, incluyendo pruebas en sandbox. Cobros recurrentes o múltiples métodos de pago agregan tiempo.
¿Puedo facturar CFDI 4.0 desde mi plataforma?
Sí, mediante un PAC con API. La plataforma valida los datos fiscales del cliente, timbra, envía el XML y PDF por correo y permite cancelar con motivo.
¿Se puede integrar con CONTPAQi o Aspel?
Sí. Dependiendo de la versión se usa su API, servicios del fabricante o sincronización por archivos. Primero se mapean catálogos y se define qué sistema es dueño de cada dato.
¿La plataforma puede funcionar sin internet en campo?
Sí, si se diseña así desde el inicio: la app guarda los registros localmente y sincroniza al recuperar señal, evitando duplicados.