Como integrar SaaS com um ERP legado que só processa lotes?

Question

IT Interview Practice · Accepted Answer

Projete uma **troca assíncrona e recuperável** que respeite os limites de processamento em lote do ERP. Primeiro, acorde o atraso aceitável para o negócio e qual sistema é responsável por cada entidade de dados; não prometa conclusão em tempo real sobre uma importação horária.

## Arquitetura e responsabilidade

```text
[SaaS API/events] --> [Durable staging] --> [Mapping adapter]
                                               |
                                         [Batch files]
                                               |
                                         [ERP importer]
                                               |
[Status + reconciliation] <------------- [Result files]
```

Em uma integração de vendas ilustrativa, o SaaS é responsável pela solicitação de pedido enviada e o ERP pelo documento financeiro contabilizado. Mapeie seus identificadores explicitamente. Um adaptador traduz estados, unidades e significados dos campos, evitando espalhar convenções específicas do ERP pelo fluxo voltado ao SaaS.

## Torne cada etapa recuperável

Persista o trabalho recebido antes de confirmá-lo quando o protocolo de origem permitir. Se for necessário polling, use um checkpoint durável e regras de sobreposição ou reexecução que evitem perder registros nas fronteiras. Preserve identificadores de lote e registro, versões de schema, contagens e checksums. Publique arquivos completos atomicamente quando houver suporte, ou use um marcador separado de conclusão.

Acompanhe cada registro pelos estados pendente, enviado, aceito ou rejeitado. Uma transferência de arquivo bem-sucedida não significa que um registro de negócio foi contabilizado. Analise os resultados do ERP e concilie identificadores de negócio e valores, não apenas contagens de arquivos. Isole registros inválidos com seus motivos e um operador responsável.

## Trate a falha ambígua

Se o ERP contabilizar um lote, mas sua confirmação se perder, reenviá-lo cegamente pode duplicar documentos de negócio. Antes de tentar novamente, use a chave de deduplicação ou a capacidade de consulta/conciliação suportada pelo ERP. Se nenhuma existir, interrompa os registros ambíguos para conciliação controlada; um registro de controle no adaptador, sozinho, não garante efeitos exatamente uma vez no ERP.

## Capacidade e operação

Estime se uma janela de importação consegue escoar o acúmulo, incluindo picos e recuperação após indisponibilidade. Aplique backpressure e mostre aos usuários um estado pendente com prazos realistas. Gere alertas para a idade do item pendente mais antigo, taxa de rejeição e divergências de conciliação. Proteja os arquivos intermediários e defina responsabilidades de acesso e retenção.

## Sinal na entrevista

Explique a fronteira de consistência e o processo de recuperação. “Adicionar uma fila” não resolve mapeamento semântico, aceitação parcial ou um ERP incapaz de deduplicar repetições. O projeto troca imediatismo por compatibilidade e precisa tornar esse atraso visível ao negócio.

Referência: [Microsoft: camada anticorrupção](https://learn.microsoft.com/en-us/azure/architecture/patterns/anti-corruption-layer).

Arquitetura e responsabilidade

Torne cada etapa recuperável

Trate a falha ambígua

Capacidade e operação

Sinal na entrevista

Perguntas relacionadas