Integração CRM / ERP
Como o fluxo funciona
O CRM/ERP cria o contrato
O CRM/ERP registra a venda e envia valor, beneficiários, número de parcelas e vencimentos.
O Play2sell emite o boleto
O Play2sell PAY origina a venda e emite um boleto BOLEPIX por parcela ao consumidor.
O Play2sell devolve o boleto ao CRM/ERP
O boleto emitido (linha digitável) é gravado de volta na reserva do seu CRM/ERP.
Consumidor paga → Play2sell informa o CRM/ERP
Na confirmação do pagamento, o Play2sell grava o status pago de volta no seu CRM/ERP.
O CRM/ERP registra a escritura → liberação
Quando a venda é escriturada, a comissão é liberada e dividida entre os beneficiários.
Configuração (por tenant)
Configure as credenciais
Adicione as credenciais do seu CRM/ERP (
domain, email, token) em Integrações → CRM/ERP. Ficam por tenant e nunca são compartilhadas.Mapeie os status para ações
Configure o mapa de status para o Play2sell saber qual status do CRM/ERP significa vendida, escriturada ou distratada. Isso varia por instância de CRM/ERP, então precisa ser definido explicitamente.
| Ação | Significado | Aciona |
|---|---|---|
| Vendida | Reserva vendida | Originação da venda + boleto |
| Escriturada | Escritura registrada | Liberação da comissão + split |
| Distratada | Contrato desfeito | Estorno ao consumidor |
Como a sincronização funciona
Os webhooks do CRM/ERP costumam ser magros (carregam só um identificador). O Play2sell classifica o evento pelo status, enfileira e busca o registro completo de volta na API do CRM/ERP antes de agir — então um webhook forjado não injeta dado.| Propriedade | Comportamento |
|---|---|
| Idempotência | Cada contrato mapeia para uma chave estável derivada do id da reserva no CRM/ERP; reentrega nunca duplica a venda. |
| Ordem | Se a escrituração chega antes da originação concluir, é adiada e reprocessada automaticamente. |
| Identidade | Compradores e beneficiários são resolvidos por CPF/CNPJ (documento), nunca por email. |
| Write-backs | Boleto criado e boleto pago são entregues ao CRM/ERP com retry até serem confirmados. |
Contrato de erro
Respostas não-2xx seguem{ code, message, hint? }. Um 4xx é rejeição (ex.: configuração incorreta — corrija e tente de novo); um 5xx é erro transitório (reprocessado automaticamente).