Esta integração tem como objetivo permitir que a Donuz consulte códigos pontuáveis gerados por sistemas terceiros (ERP, PDV ou integração customizada) e os converta em pontos de fidelidade para os participantes do programa.
Para isso, o sistema integrador deverá disponibilizar uma view no banco de dados contendo os códigos pontuáveis e suas informações básicas.
Nome da view
A view deve obrigatoriamente ter o seguinte nome: vw_donuz_codigos_pontuaveis
⚠️ Importante:
- O nome da view deve estar todo em minúsculas, exatamente como apresentado acima.
- Os nomes dos campos também devem ser criados em minúsculas, seguindo rigorosamente o padrão definido abaixo.
Finalidade da view
Esta view conterá os dados dos códigos pontuáveis que serão convertidos em pontos.
A Donuz irá consultar essa view periodicamente para identificar novos códigos e processar a pontuação conforme as regras configuradas no programa de fidelidade.
Estrutura da view
A view deve conter os seguintes campos:
| Campo | Tipo | Descrição |
|---|---|---|
donuz_codigo |
varchar / text | Código pontuável que será utilizado para gerar os pontos. Deve ser único por registro. |
donuz_valor |
decimal / numeric | Valor monetário associado ao código, utilizado como base para cálculo da pontuação. |
donuz_data |
datetime / timestamp | Data e hora em que o código foi gerado ou ficou disponível para pontuação. |
donuz_id_regra |
integer | Identificador da regra de pontuação configurada na Donuz que será aplicada a este código. |
donuz_filial (opcional, se aplicável) |
integer / varchar | Código da filial onde o código pontuável foi gerado, utilizado para controle e relatórios. |
🔎 Observação:
O campo de filial deve ser utilizado apenas caso a empresa possua múltiplas filiais e a integração exija esse controle.
Boas práticas
- Cada registro da view deve representar um código pontuável único.
- A Donuz fará o controle interno para evitar reprocessamento de códigos já utilizados.
- Recomenda-se que a view retorne apenas códigos válidos e disponíveis para pontuação.