JedIN IS-U ↔ SAP Sales & Service Cloud V2 — Integração Ponta a Ponta

Resumo da Integração

O módulo JedIN IS-U (Industry Solution for Utilities) agora sincroniza dados de clientes e ordens de serviço diretamente com o SAP Sales Cloud V2 e SAP Service Cloud V2. O resultado: Account POST 201 (criação de conta) e Case POST 201 (criação de caso com tipo customizado ZISU) funcionando ponta a ponta, com 6 flows automatizados via JedIN Integration.

Esta integração conecta 500 clientes, 7.500 faturas e o módulo de marketing do IS-U ao ecossistema SAP V2 sem necessidade de middleware adicional.

A Descoberta do Header sap-c4c-rawagent

O SAP Sales/Service Cloud V2 utiliza uma API REST moderna, mas com um requisito pouco documentado: o header sap-c4c-rawagent: com.sap.cxm.desktop. Sem esse header, as chamadas POST retornam erros genéricos ou redirecionamentos inesperados.

A descoberta veio da análise do tráfego de rede do próprio cliente desktop SAP CX. O header identifica o agente de origem e desbloqueia o comportamento correto da API para operações de escrita. Esse detalhe foi crítico para que tanto a criação de Accounts quanto de Cases retornassem HTTP 201 Created consistentemente.

POST /sap/c4c/api/v1/account-service/accounts
Content-Type: application/json
sap-c4c-rawagent: com.sap.cxm.desktop
Authorization: Basic <credentials>

Caminhos da API V2

A API do SAP Sales/Service Cloud V2 segue um padrão REST limpo com versionamento no path:

Operação	Método	Path	Resultado
Criar Account	POST	/sap/c4c/api/v1/account-service/accounts	201 Created
Buscar Account	GET	/sap/c4c/api/v1/account-service/accounts/{id}	200 OK
Criar Case	POST	/sap/c4c/api/v1/case-service/cases	201 Created
Buscar Case	GET	/sap/c4c/api/v1/case-service/cases/{id}	200 OK
Atualizar Case	PATCH	/sap/c4c/api/v1/case-service/cases/{id}	200 OK

O tipo de caso customizado ZISU foi criado via Communication Arrangement no SAP para identificar casos originados do módulo de utilities.

Os 6 Flows de Integração

O JedIN Integration orquestra a sincronização através de 6 flows, cada um com transformações JavaScript (JS transforms) que mapeiam os modelos de dados entre o IS-U e o SAP V2:

Flow	Direção	Descrição
isu-account-sync	IS-U → Sales V2	Sincroniza clientes como Accounts
isu-account-update	IS-U → Sales V2	Atualiza dados cadastrais alterados
isu-case-create	IS-U → Service V2	Cria Cases tipo ZISU para ordens de serviço
isu-case-status-sync	Service V2 → IS-U	Retorna status do case para o IS-U
isu-bill-notify	IS-U → Service V2	Notifica inadimplência como Case
isu-marketing-sync	IS-U → Sales V2	Sincroniza segmentação de marketing

Cada flow inclui tratamento de erros, retry com backoff exponencial e log estruturado para auditoria.

Configuração SAP: Communication Arrangement e ZISU

Para que a integração funcione, três elementos foram configurados no lado SAP:

1. Communication Arrangement -- Define o sistema externo (JedIN) como parceiro de comunicação autorizado, com credenciais Basic Auth e escopo de API para account-service e case-service.

2. Org Unit JEDIN01 -- Unidade organizacional dedicada que agrupa todas as operações originadas pelo JedIN. Isso permite filtrar e auditar atividades da integração separadamente das operações manuais.

3. Tipo de Caso Customizado ZISU -- Case type específico para o módulo de utilities. Permite regras de roteamento, SLAs e relatórios dedicados para ordens de serviço de concessionárias.

{
  "subject": "Ordem de Serviço - Religação #12345",
  "caseType": "ZISU",
  "origin": "JEDIN_ISU",
  "priority": "MEDIUM",
  "account": { "id": "ACC-0001" },
  "description": "Solicitação de religação após quitação"
}

Volume e Escala

A integração foi validada com dados reais de uma concessionária de energia:

Métrica	Volume
Clientes sincronizados	500
Faturas processadas	7.500
Cases criados (ZISU)	~120/mês
Módulo de marketing	Ativo com segmentação
Tempo médio de sync	< 2s por registro

O script de auditoria end-to-end executou 33 checkpoints com 100% de aprovação, validando desde a criação de accounts até o retorno de status de cases.

Arquitetura da Solução

O fluxo de dados segue uma arquitetura em três camadas:

┌─────────────────┐     ┌─────────────────────┐     ┌──────────────────────┐
│  JedIN Utilities │────▶│  JedIN Integration   │────▶│  SAP Sales Cloud V2  │
│  (IS-U Module)   │     │  (6 Flows + JS)      │     │  SAP Service Cloud V2│
│                  │◀────│                      │◀────│                      │
│  500 clientes    │     │  Retry + Logging     │     │  ZISU Cases          │
│  7.5K faturas    │     │  Error handling      │     │  JEDIN01 Org Unit    │
└─────────────────┘     └─────────────────────┘     └──────────────────────┘

JedIN Utilities gerencia clientes, faturas, consumo e ordens de serviço. JedIN Integration executa os 6 flows com transformações JS, autenticação dual (Basic + header rawagent) e tratamento de falhas. SAP V2 recebe accounts e cases com rastreabilidade completa.

Conclusão

A integração IS-U com SAP Sales/Service Cloud V2 demonstra a capacidade do JedIN de conectar sistemas de utilities diretamente ao ecossistema SAP moderno, sem camadas intermediárias. O header sap-c4c-rawagent e o tipo de caso ZISU foram as peças-chave para uma integração limpa e auditável.

Os 6 flows automatizados, combinados com o script de auditoria de 33 checkpoints, garantem que a sincronização funcione de forma confiável em produção. O próximo passo é expandir a integração para incluir leitura de medidores (meter reading) e notificações push via SAP Service Cloud V2.