Facturas de Compras Bills con IA

Docs Tarifas Swagger

Caracteristicas principales

Sistema avanzado que integra Inteligencia Artificial para automatizar el procesamiento de facturas de compra desde Flex Marketing hacia QuickBooks Online.

IA Integrada

Analisis de texto, asignacion automatica de cuentas contables, sugerencias con niveles de confianza

Multi-moneda

CRC con impuestos separados, USD con tipo de cambio e impuestos incluidos

Anti-duplicados

Verificacion automatica por DocNumber + proveedor, salto automatico, prevencion 100%

Creacion automatica

Proveedores, cuentas contables y terminos de pago generados segun necesidad

Comandos

# Modo automatico (por defecto) - procesa todo con IA
node scripts/flex-marketing/factura-compras-organizacion.js sincronizar

# Modo interactivo - revisar cada factura antes de procesar
node scripts/flex-marketing/factura-compras-organizacion.js sincronizar i

# Ver plan de cuentas disponible
node scripts/flex-marketing/factura-compras-organizacion.js cuentas

Reglas de asignacion IA

La IA analiza la descripcion y nombre del proveedor para sugerir la cuenta contable apropiada.

Categoria	Palabras clave	Cuenta	Codigo
Oficina	papel, tinta, oficina, papeleria	Gastos de Oficina	6200
Comunicacion	internet, telefono, comunicacion	Gastos de Comunicacion	6300
Combustible	gasolina, diesel, combustible	Gastos de Combustible	6400
Transporte	taxi, uber, viaje, transporte	Gastos de Transporte	6450
Serv. Profesionales	abogado, contador, consultoria	Servicios Profesionales	6500
Publicidad	marketing, promocion, facebook	Gastos de Publicidad	6600
Serv. Publicos	electricidad, agua, luz, ice	Servicios Publicos	6700
Mantenimiento	reparacion, mantenimiento	Gastos de Mantenimiento	6900
Alimentacion	almuerzo, restaurante, comida	Gastos de Alimentacion	6250
Seguros	seguro, ins, poliza	Gastos de Seguros	6350
Equipos	equipo, computadora, software	Gastos de Equipo	6150
Capacitacion	capacitacion, curso, seminario	Gastos de Capacitacion	6550

Niveles de confianza

Nivel	Criterio	Accion
ALTA	Coincidencia exacta con palabras clave	Asignacion directa sin revision
MEDIA	Montos altos sin categoria especifica	Busqueda por similitud en plan de cuentas
BAJA	Sin categoria encontrada	Default a "Gastos Generales", revisar manualmente

Reglas especiales: Montos > ₡50,000 se asignan a "Gastos Varios". Proveedores conocidos usan memoria de asignaciones anteriores. Descripciones vacias se analizan por nombre de proveedor.

Multi-moneda en compras

Aspecto	CRC (Colones)	USD (Dolares)
Procesamiento	Estandar	Con tipo de cambio obligatorio
Impuestos	Lineas separadas	Incluidos en monto principal
Proveedores	Nombre normal	Sufijo "USD" (ej: "Proveedor USD")
Cuentas	Cuentas estandar	Sufijo "USD" (ej: "Gastos USD")

# Ejemplo de diferenciacion de proveedor
Proveedor Original: "ATM Comercial S.A."

En QuickBooks:
  ATM Comercial S.A.      (CRC) → Facturas en colones
  ATM Comercial S.A. USD  (USD) → Facturas en dolares

Deteccion de duplicados

Verificacion automatica:
1. DocNumber + Proveedor → combinacion unica
2. Query automatico a QuickBooks
3. Comparacion inteligente
4. Si existe → salto automatico (no procesa)

Casos especiales:
  Mismo DocNumber + diferente proveedor → Permite crear
  Factura ya existente → Salta con log informativo

Output en tiempo real

Procesando factura 25/135
IA analizando: "Diesel" - Proveedor: "Delta Costa Rica"
IA encontro coincidencia: "diesel" → Gastos de Combustible
Buscando proveedor por moneda: Delta Costa Rica (CRC)
Proveedor encontrado: Delta Costa Rica (ID: 39)
Moneda: CRC, Tipo de cambio: 1
Bill creado exitosamente: ID 1199

Resumen final

RESUMEN FINAL:
  Facturas procesadas exitosamente: 120
  Facturas saltadas (duplicadas):   15
  Errores encontrados:               0
  Total procesadas:              135/135

Troubleshooting

Error	Causa	Solucion
3100 ApplicationAuthorizationFailed	Token expirado o permisos	Re-autenticar via `/connect/FLEX`
Factura duplicada encontrada	Ya fue procesada antes	Comportamiento normal, se salta automaticamente
Fecha invalida recibida	Formato de fecha incorrecto	Usa fecha actual como fallback automatico
Cannot find module	Ruta de archivo incorrecta	Verificar que el script este en `scripts/flex-marketing/`

Mejores practicas

Practica	Detalle
Horario	Ejecutar en horarios de baja carga (temprano en la manana)
Montos altos	Revisar facturas de montos altos en modo interactivo
Pre-verificacion	Verificar plan de cuentas antes de sync masiva
Monitoreo	Revisar nuevos proveedores creados automaticamente