🤝 Integração Comercial

Integração Comercial Customizada — DigitalSac / Izing Pro

A Integração Comercial permite substituir o módulo Perfex na operação comercial por um sistema próprio, mantendo compatibilidade com implementações baseadas na documentação anterior.

Se os cinco endpoints antigos já estão funcionando, você pode mantê-los. Esta versão amplia o contrato de planos e documenta recursos opcionais; não exige uma reescrita completa.

Enquanto o licenciamento depender do PerfexCRM, ele continua obrigatório para validar a licença. Nunca aponte PERFEX_URL para o sistema customizado.

Contrato mínimo compatível

GET  {CUSTOM_PLANS_ENDPOINT}
GET  {CUSTOM_SERVERS_ENDPOINT}
GET  {CUSTOM_DEFAULT_SERVER_ENDPOINT}
GET  {CUSTOM_DEFAULT_SERVER_ID_ENDPOINT}
POST {CUSTOM_REGISTER_ENDPOINT}

Esses cinco endpoints continuam sendo o necessário para substituir o Perfex na parte comercial.

Arquitetura

PerfexCRM ── licença ──> DigitalSac

DigitalSac ── GET planos/servidores ──> Sistema comercial próprio
DigitalSac ── POST cadastro ──────────> Sistema comercial próprio

Opcionalmente, o sistema comercial pode controlar o provisionamento direto:

Sistema comercial ── POST/PUT /api/tenants ──> DigitalSac

Não use o cadastro legado e o provisionamento direto simultaneamente para o mesmo cliente sem idempotência.

O que mudou

• Preços de usuários, canais e espaço adicionais.

• Preço individual dos módulos.

• Campanhas DigiCalls e chat interno.

• Documentação de adicionais por tenant e regras por tecnologia de canal.

• Provisionamento direto opcional pela API do DigitalSac.

Fluxo compatível

1. Cadastro público consulta planos pelo proxy.

2. DigitalSac busca o catálogo no sistema comercial.

3. DigitalSac consulta o servidor padrão.

4. Usuário envia os dados.

5. DigitalSac encaminha o cadastro ao sistema comercial.

6. Sistema comercial executa seu processamento atual e responde.

7. Opcionalmente, provisiona o tenant pela API do DigitalSac.

Guia de implementação

1. Compatibilidade com a integração anterior

2. Configuração e autenticação

3. Planos comerciais

4. Servidores e cadastro inicial

5. Sincronização, e-mail e fallback

6. Banco de dados recomendado

7. Provisionamento de clientes — opcional

8. Limites, módulos e canais

9. Exemplos, segurança e erros

Configuração recomendada

COMMERCIAL_PROVIDER=custom
SYNC_EXTERNAL_PLANS=true
REGISTER_EMAIL_PROVIDER=custom
COMMERCIAL_PROVIDER_FALLBACK_TO_PERFEX=false

O endpoint externo é a fonte de verdade do catálogo e o DigitalSac mantém a operação de atendimento. Não mantenha o mesmo catálogo pelo endpoint externo e pelo CRUD /api/plans ao mesmo tempo.