Aceptacion de Compras Electronicas AY-002

Lista de empresas

La columna central muestra todas las empresas registradas en dbcontrol.dbnegocio. Cada fila representa una empresa única, agrupada por servidor + base de datos + buzón.

Estructura de cada fila

• Nombre de la BD (laheredad, botanikalfarma, …): identificador técnico que también se usa como conexión SQL
• Nombre comercial: razón social real (sincronizada desde param 54)
• Cédula jurídica/física: sincronizada desde param 66
• Servidor SQL y buzón: dirección IP + número de socket WinSock para descarga POP3
• Email de compras: email al que el emisor del XML envía la factura (param 117)
• Badge de usuarios [👥 N]: cantidad de usuarios FactuPOS que tienen acceso a la empresa. Hover muestra la lista completa de emails de usuarios

La lista se ordena alfabéticamente por nombre de la base de datos. Una empresa con múltiples usuarios aparece una sola vez en la lista — los duplicados de dbnegocio por usuario se colapsan visualmente.

Botón Sync

El botón Sync (nube amarilla, arriba-derecha de la lista de empresas) recorre todos los servidores SQL configurados en dbcontrol.Servidores y rellena los campos vacíos de dbnegocio con los valores reales de cada empresa.

Qué lee

Por cada base de datos en cada servidor, consulta ParametrosEmpresa y toma:

• Param 54 → columna nombre_empresa (razón social)
• Param 66 → columna cedula (sólo dígitos)
• Param 117 → columna email_compras (email receptor de FE)

Protecciones

• Si la BD no existe o está offline, lo marca como warn y NO toca la fila
• Si la tabla ParametrosEmpresa no está creada, salta
• Si los 3 parámetros vienen vacíos, NO hace UPDATE (preserva lo que había antes — evita borrar por equivocación)
• Solo escribe cuando al menos 1 de los 3 params trae valor

Conexión SQL

Siempre conecta al puerto SQL default 1433. La columna socket de dbnegocio es el buzón WinSock VB6 (444, 555, 600, 700…) usado para correos POP3, NO es el puerto SQL. Se agrupan las empresas por IP y se abre una sola conexión por servidor.

Respuesta

Al terminar muestra tres contadores:

• Actualizados: filas efectivamente modificadas
• Saltados: BDs con params vacíos (intencionalmente no actualizadas)
• Errores: BDs no accesibles / sin tabla / con excepción

Tarda ~30-60 segundos porque recorre los 15 servidores SQL registrados en Servidores. Al finalizar, la lista se recarga automáticamente con los datos frescos.

Cuándo correrlo

• Después de crear una empresa nueva en FactuPOS (para que aparezca completa en la lista)
• Cuando una empresa cambió su nombre, cédula o email de compras en Datos Empresa (CF-001)
• Como mantenimiento semanal opcional

Buscador

Arriba de la lista hay un input "Buscar por BD, nombre o cédula…" que filtra las filas en tiempo real (client-side, sin ir al servidor). Busca contra el texto completo de cada fila — nombre técnico, razón social, cédula, servidor, buzón y email.

El contador del header cambia a N/total mientras el filtro está activo. Para limpiar, borrá el contenido del input.

Match de empresa por XML

Cuando llega un XML por POP3, el sistema busca a qué empresa del sistema pertenece usando la función identificarEmpresa() en _funciones.php.

Paso 1 — cédula + email_compras

1. Extrae del XML: Receptor.Identificacion.Numero (cédula) y Receptor.CorreoElectronico (emails)
2. Busca en dbnegocio todas las empresas con esa cédula
3. Por cada empresa, compara los emails del XML contra el email_compras (param 117) de la empresa
4. Separa por , y ; (una empresa puede tener múltiples emails de compras configurados)
5. Si hay 1 match → se usa esa empresa (matchTipo = 'email')

El match sólo usa email_compras (param 117). La columna email de dbnegocio (que contiene emails de usuarios individuales) no interviene en el match.

Paso 2 — fallback por cédula

Si no hubo match de email:

• Si hay 1 sola empresa con esa cédula → se usa esa (matchTipo = 'cedula')
• Si hay múltiples → prioriza las que tengan email_compras configurado, y emite warning con la lista

La empresa que resuelva el match aparece resaltada en verde en la lista con scroll automático, mientras se procesa el XML.

Ciclo automático

Hay dos toggles independientes que activan procesamiento continuo en segundo plano:

• Auto descarga POP3 (cada 41s): baja XMLs nuevos de los buzones configurados y los guarda en /var/www/xml_compras_entrantes/
• Acept. Auto (cada 30s): procesa los XMLs descargados e intenta insertar cada uno en la empresa identificada

Los dos estados se persisten en localStorage — si se activa Auto hoy y se cierra la pestaña, al volver a abrir mañana sigue activo. Claves: compras_auto y compras_aceptar_auto.

El log abajo guarda las últimas 50 filas y NO se borra entre ciclos — se removió el location.reload() para preservar el histórico durante la sesión.

Inserción en CompraMadre

Cuando el match identifica la empresa correcta, el XML se envía a /api/compras/procesar_compra_electronica.php, que ejecuta 10 pasos en secuencia contra la base de datos de la empresa:

1. Buscar o crear proveedor en Proveedor (por cédula+moneda)
2. Verificar que la factura no esté ya procesada (Estado NOT IN 0,1)
3. Eliminar borradores previos (Estado 0 o 1)
4. Insertar cabecera en CompraMadre (estado 0, tipo = posiciones 9-10 del consecutivo)
5. Insertar líneas en CompraHija (valida código de tarifa IVA con fallback "10")
6. Actualizar totales de CompraMadre con suma real de líneas
7. Homologar artículos con ProveedorArticuloHomologacion + asignar CABYS + cuenta contable + ajustar UxM
8. Insertar XML original en XmlDocumentos (Base64)
9. Generar MensajeReceptor XML con clave y consecutivo tipo 05 (solo si la empresa tiene FE activa, param 125 = 1)
10. Insertar confirmación en fac_bitacora (servidor del cliente; auto-registra en fac_compania si no existe) (solo si param 125 = 1)

Empresas sin Factura Electrónica (param 125 ≠ 1): la compra se registra normalmente (pasos 1 a 8), pero los pasos 9 y 10 se omiten — no se genera el MensajeReceptor ni se inserta en fac_bitacora, así que no se acepta ni se envía nada a Hacienda.

Si el proveedor es nuevo, CompraMadreTipo se fuerza a '01' y se copia ActividadEconomica del XML. Si ya existe, respeta el CodTipoProveedor que tenga.

El ajuste automático de UxM (multiplicar cantidad, dividir costo) se aplica incondicionalmente después de la homologación cuando Articulos.UnidadesXMedida > 1. Los totales de línea se preservan porque cantidad×costo no cambia.

Permisos del módulo

El módulo de Aceptación de Compras Electrónicas no requiere permiso específico propio para acceder, pero el procesamiento posterior sí consume los permisos de compras. Se asignan al grupo de usuarios desde el módulo de Seguridad (SE-001).

Parámetros de empresa

Los parámetros controlan el comportamiento de la aceptación electrónica. Se configuran desde Configuración → Parámetros (CF-004) y también en Datos de la Empresa → Facturación Electrónica.