SIGE Integration Worker | JavaScript

SIGE Integration Worker

Um worker de integração Node.js que sincroniza pedidos faturados SIGE com o Google Sheets, enriquece registros com lógica de correlação ERP e calcula campos de atribuição para relatórios financeiros operacionais.

Visão geral

Este worker ingere pedidos faturados de SIGE, enriquece cada registro pesquisando linhas históricas ERP e grava conjuntos de dados normalizados em um Faturamento folha.

Suporta:

• sincronização automática diária via envio de repositório
• modo de preenchimento histórico em massa (em_massa.js) para reprodução de intervalo de datas
• lógica de atribuição entre fontes (Novo vs Retirada)

Arquitetura

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 Processamento

Sincronização diária (index.js)

1. Leia o bloco ERP mais recente (últimas 25 mil linhas)
2. Consultar SIGE pedidos faturados de ontem
3. Opcionalmente, consulte o endpoint de pessoas SIGE para enriquecimento de contato
4. Correlacionar por CPF e classificar eventos ERP relacionados
5. Calcular Novo e Retirada referências de data serial
6. Lógica de divisão de valor quando uma retirada anterior é detectada
7. Anexar conjunto de linhas estruturado final a Faturamento

Sincronização em massa (em_massa.js)

O fluxo de trabalho manual executa uma reprodução controlada de intervalo de datas para reconstruir janelas históricas enquanto preserva as mesmas regras de mapeamento de negócios.

Principais recursos

• ERP correlação por CPF para atribuição de vendedor
• Geração de data serial do Excel para correspondência determinística
• Lógica de divisão financeira para pedidos vinculados a retiradas
• Proteção de injeção de fórmula de planilha (sanitize)
• Logs operacionais seguros com rótulos de gravidade com carimbo de data/hora
• API limitação no modo em lote para estabilidade sob os limites do provedor

Segurança e integridade de dados

• Limpa o texto gerado pelo usuário antes de escrever no Planilhas
• Usa credenciais somente secretas para SIGE e Google APIs
• Evita gravações diretas e inseguras de fórmulas
• Inclui saídas de erro controladas para observabilidade de CI

Configuração

Variáveis de ambiente necessárias

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

Gatilhos de fluxo de trabalho

Automático

on:
	repository_dispatch:
		types:
			- google_token_ready

Preenchimento manual

on:
	repository_dispatch:
		types:
			- report_token_ready

Esquema de saída (alto nível)

O resultado Faturamento as linhas incluem:

• contato do cliente e CPF
• identificadores de pedido e fatura
• status do pedido e data de cobrança
• valor do pedido e valor de divisão ajustado
• referências de vendedores (Novo e Retirada)
• chave de partição mês/ano

Licença

Este projeto está licenciado sob a licença MIT. Veja o notas de licença no repositório.

Autor

Patrick Araujo - Engenheiro de Computação
GitHub: https://github.com/PkLavc
Portfólio: https://pklavc.com/projects/

SIGE Integration Worker - Sincronização de faturamento com reconhecimento de ERP para relatórios operacionais de nível financeiro.