{"id":27482,"date":"2025-12-19T11:11:34","date_gmt":"2025-12-19T14:11:34","guid":{"rendered":"https:\/\/donuz.com.br\/blog\/?post_type=docs&#038;p=27482"},"modified":"2025-12-19T11:11:37","modified_gmt":"2025-12-19T14:11:37","slug":"integracao-donuz-para-codigo-pontuavel","status":"publish","type":"docs","link":"https:\/\/donuz.com.br\/blog\/docs\/integracao-donuz-para-codigo-pontuavel\/","title":{"rendered":"Integra\u00e7\u00e3o Donuz para c\u00f3digo pontu\u00e1vel"},"content":{"rendered":"\n<p>Esta integra\u00e7\u00e3o tem como objetivo permitir que a Donuz consulte <strong>c\u00f3digos pontu\u00e1veis<\/strong> gerados por sistemas terceiros (ERP, PDV ou integra\u00e7\u00e3o customizada) e os converta em <strong>pontos de fidelidade<\/strong> para os participantes do programa.<\/p>\n\n\n\n<p>Para isso, o sistema integrador dever\u00e1 disponibilizar uma <strong>view no banco de dados<\/strong> contendo os c\u00f3digos pontu\u00e1veis e suas informa\u00e7\u00f5es b\u00e1sicas.<\/p>\n\n\n\n<h2>Nome da view<\/h2>\n\n\n\n<p>A view <strong>deve obrigatoriamente<\/strong> ter o seguinte nome: vw_donuz_codigos_pontuaveis<\/p>\n\n\n\n<p><\/p>\n\n\n\n<p>\u26a0\ufe0f Importante:<\/p>\n\n\n\n<ul><li>O nome da view deve estar <strong>todo em min\u00fasculas<\/strong>, exatamente como apresentado acima.<\/li><li>Os nomes dos campos tamb\u00e9m devem ser criados <strong>em min\u00fasculas<\/strong>, seguindo rigorosamente o padr\u00e3o definido abaixo.<\/li><\/ul>\n\n\n\n<p><\/p>\n\n\n\n<h2>Finalidade da view<\/h2>\n\n\n\n<p>Esta view conter\u00e1 os dados dos <strong>c\u00f3digos pontu\u00e1veis que ser\u00e3o convertidos em pontos<\/strong>.<br>A Donuz ir\u00e1 consultar essa view periodicamente para identificar novos c\u00f3digos e processar a pontua\u00e7\u00e3o conforme as regras configuradas no programa de fidelidade.<\/p>\n\n\n\n<h2>Estrutura da view<\/h2>\n\n\n\n<p>A view deve conter os seguintes campos:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Campo<\/th><th>Tipo<\/th><th>Descri\u00e7\u00e3o<\/th><\/tr><\/thead><tbody><tr><td><code>donuz_codigo<\/code><\/td><td>varchar \/ text<\/td><td>C\u00f3digo pontu\u00e1vel que ser\u00e1 utilizado para gerar os pontos. Deve ser \u00fanico por registro.<\/td><\/tr><tr><td><code>donuz_valor<\/code><\/td><td>decimal \/ numeric<\/td><td>Valor monet\u00e1rio associado ao c\u00f3digo, utilizado como base para c\u00e1lculo da pontua\u00e7\u00e3o.<\/td><\/tr><tr><td><code>donuz_data<\/code><\/td><td>datetime \/ timestamp<\/td><td>Data e hora em que o c\u00f3digo foi gerado ou ficou dispon\u00edvel para pontua\u00e7\u00e3o.<\/td><\/tr><tr><td><code>donuz_id_regra<\/code><\/td><td>integer<\/td><td>Identificador da regra de pontua\u00e7\u00e3o configurada na Donuz que ser\u00e1 aplicada a este c\u00f3digo.<\/td><\/tr><tr><td><code>donuz_filial<\/code> <em>(opcional, se aplic\u00e1vel)<\/em><\/td><td>integer \/ varchar<\/td><td>C\u00f3digo da filial onde o c\u00f3digo pontu\u00e1vel foi gerado, utilizado para controle e relat\u00f3rios.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p><strong>\ud83d\udd0e Observa\u00e7\u00e3o:<br><\/strong>O campo de filial deve ser utilizado apenas caso a empresa possua m\u00faltiplas filiais e a integra\u00e7\u00e3o exija esse controle.<\/p>\n\n\n\n<p><\/p>\n\n\n\n<h2>Boas pr\u00e1ticas<\/h2>\n\n\n\n<ul><li>Cada registro da view deve representar <strong>um c\u00f3digo pontu\u00e1vel \u00fanico<\/strong>.<\/li><li>A Donuz far\u00e1 o controle interno para evitar reprocessamento de c\u00f3digos j\u00e1 utilizados.<\/li><li>Recomenda-se que a view retorne apenas c\u00f3digos <strong>v\u00e1lidos e dispon\u00edveis para pontua\u00e7\u00e3o<\/strong>.<\/li><\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Esta integra\u00e7\u00e3o tem como objetivo permitir que a Donuz consulte c\u00f3digos pontu\u00e1veis gerados por sistemas terceiros (ERP, PDV ou integra\u00e7\u00e3o customizada) e os converta em pontos de fidelidade para os participantes do programa. Para isso, o sistema integrador dever\u00e1 disponibilizar uma view no banco de dados contendo os c\u00f3digos pontu\u00e1veis e suas informa\u00e7\u00f5es b\u00e1sicas. Nome [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":[],"doc_category":[122],"doc_tag":[],"acf":[],"_links":{"self":[{"href":"https:\/\/donuz.com.br\/blog\/wp-json\/wp\/v2\/docs\/27482"}],"collection":[{"href":"https:\/\/donuz.com.br\/blog\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/donuz.com.br\/blog\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/donuz.com.br\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/donuz.com.br\/blog\/wp-json\/wp\/v2\/comments?post=27482"}],"version-history":[{"count":1,"href":"https:\/\/donuz.com.br\/blog\/wp-json\/wp\/v2\/docs\/27482\/revisions"}],"predecessor-version":[{"id":27483,"href":"https:\/\/donuz.com.br\/blog\/wp-json\/wp\/v2\/docs\/27482\/revisions\/27483"}],"wp:attachment":[{"href":"https:\/\/donuz.com.br\/blog\/wp-json\/wp\/v2\/media?parent=27482"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/donuz.com.br\/blog\/wp-json\/wp\/v2\/doc_category?post=27482"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/donuz.com.br\/blog\/wp-json\/wp\/v2\/doc_tag?post=27482"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}