> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/configuracao/integracao-comercial.md).

# 🤝 Integração Comercial 

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.

{% hint style="success" %}
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.
{% endhint %}

{% hint style="warning" %}
Enquanto o licenciamento depender do PerfexCRM, ele continua obrigatório para validar a licença. Nunca aponte `PERFEX_URL` para o sistema customizado.
{% endhint %}

### Contrato mínimo compatível

```http
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](/digicrm/configuracao/integracao-comercial/compatibilidade-com-a-integracao-anterior.md)
2. [Configuração e autenticação](/digicrm/configuracao/integracao-comercial/configuracao-e-autenticacao.md)
3. [Planos comerciais](/digicrm/configuracao/integracao-comercial/planos-comerciais.md)
4. [Servidores e cadastro inicial](/digicrm/configuracao/integracao-comercial/servidores-e-cadastro-inicial.md)
5. [Sincronização, e-mail e fallback](/digicrm/configuracao/integracao-comercial/sincronizacao-e-mail-e-fallback.md)
6. [Banco de dados recomendado](/digicrm/configuracao/integracao-comercial/banco-de-dados-recomendado.md)
7. [Provisionamento de clientes — opcional](/digicrm/configuracao/integracao-comercial/provisionamento-de-clientes.md)
8. [Limites, módulos e canais](/digicrm/configuracao/integracao-comercial/limites-modulos-e-canais.md)
9. [Exemplos, segurança e erros](/digicrm/configuracao/integracao-comercial/exemplos-seguranca-e-erros.md)

### 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.