SIGE Integration Worker | JavaScript

SIGE Integration Worker

Un worker de integración Node.js que sincroniza los pedidos facturados de SIGE con Google Sheets, enriquece los registros con la lógica de correlación ERP y calcula campos de atribución para informes financieros operativos.

Descripción general

Este worker ingiere pedidos facturados de SIGE, enriquece cada registro buscando filas históricas de ERP y escribe conjuntos de datos normalizados en un Faturamento hoja.

Soporta:

• sincronización automática diaria a través del envío del repositorio
• modo de relleno histórico masivo (em_massa.js) para repetición de intervalo de fechas
• Lógica de atribución entre fuentes (Novo vs Retirada)

Arquitectura

graph LR
		A[Google Auth Worker] -->|repository_dispatch| B[SIGE Integration Worker]
		B --> C[SIGE API]
		B --> D[ERP Google Sheet]
		B --> E[Faturamento Google Sheet]
		C --> B
		D --> B
		B --> E

Lógica de procesamiento

Sincronización diaria (index.js)

1. Lea el bloque ERP más reciente (últimas 25.000 filas)
2. Consulta SIGE pedidos facturados de ayer
3. Opcionalmente, consulte el endpoint de personas de SIGE para enriquecer los contactos.
4. Correlacionar por CPF y clasificar eventos ERP relacionados
5. calcular Novo y Retirada referencias de fecha de serie
6. Lógica de valor dividido cuando se detecta un retiro previo
7. Agregue el conjunto de filas estructurado final a Faturamento

Sincronización masiva (em_massa.js)

El flujo de trabajo manual ejecuta una reproducción controlada de un rango de fechas para reconstruir ventanas históricas y al mismo tiempo preservar las mismas reglas de mapeo empresarial.

Características clave

• ERP correlación por CPF para la atribución del vendedor
• Generación de fechas de serie en Excel para coincidencias deterministas
• Lógica de división financiera para órdenes vinculadas a retiros
• Protección de inyección de fórmula de hoja de cálculo (sanitize)
• Registros operativos seguros con etiquetas de gravedad con marca de tiempo
• API limitación en modo por lotes para estabilidad bajo los límites del proveedor

Seguridad e integridad de los datos

• Desinfecta el texto generado por el usuario antes de escribir en Hojas de cálculo
• Utiliza credenciales secretas únicamente para SIGE y Google API
• Evita escrituras directas de fórmulas inseguras
• Incluye salidas de error controladas para la observabilidad de CI

Configuración

Variables de entorno requeridas

SIGE_TOKEN=your_sige_token
SIGE_USER=your_sige_user
SIGE_APP=your_sige_app
GOOGLE_TOKEN=oauth_access_token
SPREADSHEET_ID=destination_sheet_id
ERP_SPREADSHEET_ID=erp_source_sheet_id

Activadores de flujo de trabajo

Automático

on:
	repository_dispatch:
		types:
			- google_token_ready

Relleno manual

on:
	repository_dispatch:
		types:
			- report_token_ready

Esquema de salida (alto nivel)

El resultado Faturamento Las filas incluyen:

• contacto con el cliente y CPF
• identificadores de pedidos y facturas
• estado del pedido y fecha de facturación
• valor del pedido y valor de división ajustado
• Referencias de vendedores (Novo y Retirada)
• clave de partición mes/año

Licencia

Este proyecto está bajo la licencia MIT. Ver el notas de licencia en el repositorio.

Autor

Patrick Araujo - Ingeniero Informático
GitHub: https://github.com/PkLavc
Portafolio: https://pklavc.com/projects/

SIGE Integration Worker - ERP sincronización de facturación compatible con informes operativos de nivel financiero.