Contexto de Integração: BusinessPartners do SAP B1
Esta integração tem como objetivo sincronizar as informações de Business Partners do SAP B1 com o nosso sistema, garantindo que dados de clientes, fornecedores e prospects estejam atualizados e consistentes.
No SAP B1, os Business Partners podem ser classificados principalmente em:
- Clientes (Customers): entidades que compram produtos ou serviços da empresa.
- Fornecedores (Suppliers/Vendors): entidades que fornecem produtos ou serviços à empresa.
- Leads / Prospects: potenciais clientes ainda em processo de qualificação (dependendo da configuração do SAP B1).
Para a integração, nosso sistema precisa receber:
- Identificador único do parceiro (CardCode)
- Nome e dados de contato (telefone, e-mail, endereço)
- Tipo de parceiro (Cliente, Fornecedor, Prospect)
- Dados adicionais relevantes para processos internos
A integração será responsável por consultar, transformar e persistir essas informações do SAP B1 no modelo de domínio do WMS, garantindo que todas as operações futuras possam referenciar entidades consistentes com o SAP B1.
Estratégia de integração
Como o cadastro/edição de entidades não notifica nosso sistema, precisamos realizar pooling para verificar se há novos registros que precisam ser integrados.
Havendo essa notificação por parte do integrador, é interessante utilizar integração via [Published/Subscription] ou [Webhook através da API de Integração].
Checklist de implementação
- Integrador criado estendendo PoolingIntegrator.
- Query implementada chamando Application/Connector.
- Parse transforma dados sem lógica de negócio.
- Send envia dados para o destino corretamente.
- Serviços auxiliares (se houver) apenas orquestram Application e Connectors.
- Tratamento de erros e logging implementados.
- Testes unitários e de integração cobertos.