{"id":26959,"date":"2023-05-11T09:51:36","date_gmt":"2023-05-11T12:51:36","guid":{"rendered":"https:\/\/donuz.com.br\/blog\/?post_type=docs&#038;p=26959"},"modified":"2024-11-01T15:32:09","modified_gmt":"2024-11-01T18:32:09","slug":"integracao-donuz-via-banco-de-dados","status":"publish","type":"docs","link":"https:\/\/donuz.com.br\/blog\/docs\/integracao-donuz-via-banco-de-dados\/","title":{"rendered":"Integra\u00e7\u00e3o Donuz via banco de dados"},"content":{"rendered":"\n<p>Veja no v\u00eddeo abaixo uma explica\u00e7\u00e3o b\u00e1sica sobre este modelo de integra\u00e7\u00e3o:<\/p>\n\n\n\n<div class=\"embed-responsive embed-responsive-16by9\"><iframe class=\"embed-responsive-item\" src=\"https:\/\/www.youtube.com\/embed\/bVDLCbGZLZ0?rel=0\" allowfullscreen=\"allowfullscreen\"><\/iframe><\/div>\n\n\n\n<p>A Donuz consegue integrar com diversos softwares por meio de uma intera\u00e7\u00e3o via banco de dados. O integrador da Donuz est\u00e1 preparado para rodar com os seguintes bancos de dados:<\/p>\n\n\n\n<ul><li>SQL SERVER<\/li><li>MYSQL\/Maria DB<\/li><li>ORACLE<\/li><li>POSTGRESSQL<\/li><li>SYBASE<\/li><li>FIREBIRD<\/li><li>DB2<\/li><\/ul>\n\n\n\n<p>Para que a Donuz possa realizar uma integra\u00e7\u00e3o via banco de dados, \u00e9 necess\u00e1rio que seja criada 2 (duas) views somente de leitura para que o integrador da Donuz, possa ler as informa\u00e7\u00f5es e inserir na Donuz<\/p>\n\n\n\n<h2>1. <strong>View para pontua\u00e7\u00e3o<\/strong> (dados das vendas)<\/h2>\n\n\n\n<p>Essa view vai conter os dados para pontuar uma pessoa. <\/p>\n\n\n\n<p>O nome da view deve ser: <strong>vw_donuz_pontos<\/strong> (tudo min\u00fasculo, exatamente como est\u00e1 aqui)<\/p>\n\n\n\n<p>Veja baixo os campos e dados que deve conter nessa view. <br> Crie os campos em min\u00fasculo, exatamente como est\u00e1 abaixo.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td><strong>Nome campo<\/strong><\/td><td><strong>Tipo de dado<\/strong><\/td><td><strong>Descri\u00e7\u00e3o<\/strong><\/td><\/tr><tr><td>donuz_usuario<\/td><td>String (Obrigat\u00f3rio)<\/td><td>CPF\/CNPJ ou c\u00f3digo de quem receber\u00e1 a pontua\u00e7\u00e3o<\/td><\/tr><tr><td>donuz_valor_ponto<\/td><td>Double (Obrigat\u00f3rio)<\/td><td><strong>Valor da venda<\/strong> ou valor em pontos que a pessoa vai receber.<br>Ex: (1000.00 , 120.00 , 123455.00). Sem separador de milhar.<\/td><\/tr><tr><td>donuz_descricao_ponto<\/td><td>String (Recomendado)<\/td><td>Essa ser\u00e1 a <strong>descri\u00e7\u00e3o da venda<\/strong>\/pontua\u00e7\u00e3o que ser\u00e1 exibida no extrato de pontos da pessoa. Pode ser o nome do produto.<\/td><\/tr><tr><td>donuz_data_ponto<\/td><td>DateTime (Obrigat\u00f3rio)<\/td><td>Essa deve ser a <strong>data da venda<\/strong>\/pontua\u00e7\u00e3o. Com base nela a Donuz ir\u00e1 gerar a validade da pontua\u00e7\u00e3o, conforme configurado na Donuz. Formato (YYYY-MM-DD)<\/td><\/tr><tr><td>donuz_identificador_ponto<\/td><td>String (Recomendado)<\/td><td><strong>C\u00f3digo \u00fanico da venda<\/strong>\/pontua\u00e7\u00e3o recomendamos que esse numero nunca se repita. <strong>Exemplo: n\u00famero do cupom fiscal.<\/strong><\/td><\/tr><tr><td>donuz_quem_inseriu<\/td><td>Int (Opcional)<\/td><td>ID da filial ou ID usu\u00e1rio (funcion\u00e1rio) cadastrado na a Donuz, que inseriu a pontua\u00e7\u00e3o.<\/td><\/tr><tr><td>donuz_id_regra<\/td><td>Int (opcional)<\/td><td>Deixe em branco para usar a regra padr\u00e3o Donuz ( 1 para 1 ), ou insira o ID da regra criada na Donuz, para usar uma regra espec\u00edfica para esta pontua\u00e7\u00e3o.<\/td><\/tr><tr><td>donuz_codigo_produto<\/td><td>String (Opcional)<\/td><td><strong>Importante:<\/strong> Se desejar criar regras de pontua\u00e7\u00e3o diferente por produto, categoria ou marca, envie cada item da venda separado em uma linha da view e na Donuz ser\u00e1 criado a as regras por c\u00f3digo de enviado neste campo.  <\/td><\/tr><tr><td>donuz_cancelado<\/td><td>Boolean <br>(TRUE|FALSE)<br><br>(Obrigat\u00f3rio)<\/td><td>Este campo serve para estornar o valor total de uma pontua\u00e7\u00e3o j\u00e1 inserida, conforme detalhes baixo.<br><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3>Como estornar o valor total de uma pontua\u00e7\u00e3o j\u00e1 inserida<\/h3>\n\n\n\n<p>Para estornar o valor total de uma venda\/pontua\u00e7\u00e3o j\u00e1 inserida, deve-se registrar uma linha na view com o mesmo valor, mesmo usu\u00e1rio, mesma data, mesmo identificador e o campo  donuz_cancelado , deve ser 1,  conforme exemplo abaixo: <\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img width=\"1024\" height=\"119\" src=\"https:\/\/donuz.com.br\/blog\/wp-content\/uploads\/2024\/09\/image-2-1024x119.png\" alt=\"\" class=\"wp-image-27429\" srcset=\"https:\/\/donuz.com.br\/blog\/wp-content\/uploads\/2024\/09\/image-2-1024x119.png 1024w, https:\/\/donuz.com.br\/blog\/wp-content\/uploads\/2024\/09\/image-2-300x35.png 300w, https:\/\/donuz.com.br\/blog\/wp-content\/uploads\/2024\/09\/image-2-768x89.png 768w, https:\/\/donuz.com.br\/blog\/wp-content\/uploads\/2024\/09\/image-2-360x42.png 360w, https:\/\/donuz.com.br\/blog\/wp-content\/uploads\/2024\/09\/image-2.png 1382w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3>Como estornar o valor parcial de uma pontua\u00e7\u00e3o j\u00e1 inserida <\/h3>\n\n\n\n<p>Para estornar parte do valor de uma venda\/pontua\u00e7\u00e3o j\u00e1 inserida, deve-se registrar uma linha na view com valor negativo (-145 no exemplo abaixo), mantendo a mesma data, mesmo usu\u00e1rio, identificador e o campo  donuz_cancelado , deve ser 0, conforme exemplo abaixo:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img width=\"1024\" height=\"117\" src=\"https:\/\/donuz.com.br\/blog\/wp-content\/uploads\/2024\/09\/image-1024x117.png\" alt=\"\" class=\"wp-image-27421\" srcset=\"https:\/\/donuz.com.br\/blog\/wp-content\/uploads\/2024\/09\/image-1024x117.png 1024w, https:\/\/donuz.com.br\/blog\/wp-content\/uploads\/2024\/09\/image-300x34.png 300w, https:\/\/donuz.com.br\/blog\/wp-content\/uploads\/2024\/09\/image-768x88.png 768w, https:\/\/donuz.com.br\/blog\/wp-content\/uploads\/2024\/09\/image-360x41.png 360w, https:\/\/donuz.com.br\/blog\/wp-content\/uploads\/2024\/09\/image.png 1378w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h2> <\/h2>\n\n\n\n<p>.<\/p>\n\n\n\n<h2>2. <strong>View para cadastro da pessoa<\/strong> <\/h2>\n\n\n\n<p>Essa view vai conter os dados cadastrais da pessoa que ir\u00e1 ganhar os pontos. Desta forma o integrador da Donuz poder\u00e1 cadastrar essa pessoa, caso ela ainda n\u00e3o esteja cadastrada.<\/p>\n\n\n\n<p> O nome da view deve ser: <strong>vw_donuz_usuarios<\/strong>  (tudo min\u00fasculo, exatamente como est\u00e1 aqui) <\/p>\n\n\n\n<p> Veja baixo os campos e dados que deve conter nessa view. <br> Crie os campos em min\u00fasculo, exatamente como est\u00e1 abaixo.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td><strong>Nome campo<\/strong><\/td><td><strong>Tipo de dado<\/strong><\/td><td><strong>Descri\u00e7\u00e3o<\/strong><\/td><\/tr><tr><td> donuz_data_cadastro<\/td><td> DateTime (Obrigatorio)<\/td><td> FORMATO(YYYY-MM-DD) &#8211; Data em que a pessoa foi cadastrada no sistema.<\/td><\/tr><tr><td>donuz_nome<\/td><td>String (Obrigatorio)<\/td><td>Nome da pessoa que ser\u00e1 cadastrada<\/td><\/tr><tr><td>donuz_sobrenome<\/td><td>String (Opcional)<\/td><td><\/td><\/tr><tr><td>donuz_cpf<\/td><td>String (Obrigatorio)<\/td><td>Documento \u00fanico da pessoa. Pode ser CPF ou CNPJ. Use apenas n\u00fameros.<\/td><\/tr><tr><td>donuz_senha<\/td><td> String (Opcional) <\/td><td>Envie uma senha padr\u00e3o para esta pessoa. Exemplo: CPF+NOME ou CPF + TELEFONE, ou deixe vazio e a Donuz ir\u00e1 gerar uma senha aleat\u00f3ria.<\/td><\/tr><tr><td>donuz_codigo<\/td><td>String (Obrigatorio caso o cpf n\u00e3o esteja informado)<\/td><td>Se desejar usar um c\u00f3digo interno para as pessoas.<\/td><\/tr><tr><td>donuz_email<\/td><td>String (Recomendado)<\/td><td>Apenas um e-mail<\/td><\/tr><tr><td>donuz_telefone<\/td><td>String (Recomendado)<\/td><td> Apenas um telefone<\/td><\/tr><tr><td>donuz_celular<\/td><td>String (Recomendado)<\/td><td> Apenas um celular<\/td><\/tr><tr><td>donuz_sexo<\/td><td>String (Opcional)<\/td><td>Exemplo: F ou M<\/td><\/tr><tr><td>donuz_data_nascimento<\/td><td>DateTime (Opcional)<\/td><td>FORMATO(YYYY-MM-DD)<\/td><\/tr><tr><td>donuz_endereco<\/td><td>String (Opcional)<\/td><td><\/td><\/tr><tr><td>donuz_endereco_numero<\/td><td>Int (Opcional)<\/td><td><\/td><\/tr><tr><td>donuz_endereco_bairro<\/td><td>String (Opcional)<\/td><td><\/td><\/tr><tr><td>donuz_endereco_cidade<\/td><td>String (Opcional)<\/td><td><\/td><\/tr><tr><td>donuz_endereco_uf<\/td><td>String (Opcional<\/td><td>Ex: MG,SP<\/td><\/tr><tr><td>donuz_endereco_cep<\/td><td>String (Opcional)<\/td><td>Somente n\u00fameros<\/td><\/tr><tr><td>donuz_endereco_complemento<\/td><td>String (Opcional)<\/td><td><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2>Dados de acesso a View<\/h2>\n\n\n\n<p>Para que o integrador da Donuz possa fazer a leitura dos dados e inseri-los na plataforma, \u00e9 necess\u00e1rio informar a Donuz os seguintes dados para configura\u00e7\u00e3o. <\/p>\n\n\n\n<p><\/p>\n\n\n\n<ul><li>Host (preferencialmente um IP fixo e p\u00fablico)<\/li><li>Qual banco de dados (sql server, mysql\/maria db, oracle, postgressql, Sybase, firebird, db2)<\/li><li>Nome do banco<\/li><li>Usu\u00e1rio<\/li><li>Senha<\/li><li>Porta<\/li><li>Acesso ao banco: Local ou remoto<\/li><\/ul>\n\n\n\n<p>Recomendamos que a view seja para leitura via acesso remoto, pois torna o processo mais eficiente e menos custoso.<\/p>\n\n\n\n<p>No caso de acesso local, ser\u00e1 necess\u00e1rio, um especialista da Donuz, realizar o acesso remoto na m\u00e1quina onde est\u00e1 o banco para fazer a configura\u00e7\u00e3o e neste caso h\u00e1 um valor a ser pago para este procedimento adicional. Neste caso consulte os custos e planos que permite este procedimento com o consultor que est\u00e1 te atendendo.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Veja no v\u00eddeo abaixo uma explica\u00e7\u00e3o b\u00e1sica sobre este modelo de integra\u00e7\u00e3o: A Donuz consegue integrar com diversos softwares por meio de uma intera\u00e7\u00e3o via banco de dados. O integrador da Donuz est\u00e1 preparado para rodar com os seguintes bancos de dados: SQL SERVER MYSQL\/Maria DB ORACLE POSTGRESSQL SYBASE FIREBIRD DB2 Para que a Donuz [&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\/26959"}],"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=26959"}],"version-history":[{"count":21,"href":"https:\/\/donuz.com.br\/blog\/wp-json\/wp\/v2\/docs\/26959\/revisions"}],"predecessor-version":[{"id":27435,"href":"https:\/\/donuz.com.br\/blog\/wp-json\/wp\/v2\/docs\/26959\/revisions\/27435"}],"wp:attachment":[{"href":"https:\/\/donuz.com.br\/blog\/wp-json\/wp\/v2\/media?parent=26959"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/donuz.com.br\/blog\/wp-json\/wp\/v2\/doc_category?post=26959"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/donuz.com.br\/blog\/wp-json\/wp\/v2\/doc_tag?post=26959"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}