{"id":26975,"date":"2023-05-16T13:32:55","date_gmt":"2023-05-16T16:32:55","guid":{"rendered":"https:\/\/donuz.com.br\/blog\/?post_type=docs&p=26975"},"modified":"2024-03-12T10:13:35","modified_gmt":"2024-03-12T13:13:35","slug":"inserir-ponto-via-api-donuz","status":"publish","type":"docs","link":"https:\/\/donuz.com.br\/blog\/docs\/inserir-ponto-via-api-donuz\/","title":{"rendered":"Inserir ponto via API"},"content":{"rendered":"\n

A Donuz possui uma API <\/strong>que permite que qualquer empresa possa realizar uma integra\u00e7\u00e3o do seu software com a o Programa de Fidelidade, para inserir pontos de forma autom\u00e1tica.<\/p>\n\n\n\n

Para realizar uma integra\u00e7\u00e3o com a Donuz, \u00e9 necess\u00e1rio criar uma conta e obter ao Token de acesso com o atendimento da Donuz.<\/p>\n\n\n\n

Veja como fazer uma inser\u00e7\u00e3o de pontos via API<\/strong><\/p>\n\n\n\n

M\u00e9todo<\/strong>: <\/strong>POST<\/p>\n\n\n\n

Requisi\u00e7\u00e3o<\/strong>:<\/strong> https:\/\/donuz.co\/api\/v1\/ponto<\/p>\n\n\n\n

Headers<\/strong><\/p>\n\n\n\n

KEY<\/strong><\/td>VALUE<\/strong><\/td><\/tr>
TOKEN<\/td> Chave de acesso <\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Body (Par\u00e2metros<\/strong> json)<\/strong> <\/strong><\/p>\n\n\n\n

KEY<\/strong> <\/td> VALUE<\/strong> <\/td><\/tr>
acao<\/strong><\/td>inserir<\/td><\/tr>
estabelecimento<\/strong><\/td>ID da empresa<\/td><\/tr>
cliente<\/strong> <\/td>CPF ou C\u00f3digo de quem vai ganhar ponto<\/td><\/tr>
valor<\/strong><\/td>Valor da venda em reais ou valor dos pontos a inserir<\/td><\/tr>
descricao <\/strong>(opcional)<\/td>Descri\u00e7\u00e3o dos pontos<\/td><\/tr>
data_de_insercao <\/strong>(opcional)<\/td>Data da inser\u00e7\u00e3o. Ex: 25\/04\/2017<\/td><\/tr>
regra <\/strong>(opcional)<\/td>ID da regra de pontos, caso n\u00e3o seja informado ser\u00e1 considerado regra padr\u00e3o 1 para 1.<\/td><\/tr>
usuario <\/strong>(opcional)<\/td>ID do usu\u00e1rio da loja\/filial.<\/td><\/tr>
codigo_do_produto<\/strong> (opicional)<\/td>C\u00f3digo do produto vendido.<\/td><\/tr>
codigo_de_controle<\/strong> (opcional)<\/td>C\u00f3digo da venda (transa\u00e7\u00e3o).
<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Exemplo de requisi\u00e7\u00e3o:<\/strong><\/p>\n\n\n\n

{\n    \"acao\": \"inserir\",\n    \"estabelecimento\": 24340,\n    \"cliente\": \"09876543210\",\n    \"descricao\": \"Venda teste\",\n    \"data_insercao\": \"2024-03-12\",\n    \"valor\": \"44\"\n}<\/code><\/pre>\n\n\n\n
Exemplo de retorno:<\/strong><\/p>\n\n\n\n
{\n    \"status\": 200,\n    \"mensagem\": \"Requisi\u00e7\u00e3o finalizada com sucesso.\",\n    \"uri\": \"http:\/\/www.donuz.co\/api\/v1\/ponto\/130254\/48677342\",\n    \"estabelecimento\": 24340,\n    \"cliente\": \"130254\",\n    \"pontos\": 88,\n    \"descricao\": null,\n    \"id_ponto\": \"48677342\"\n}<\/code><\/pre>\n\n\n\n
Se uma venda foi cancelada, voc\u00ea pode estorno os pontos, enviando os dados da venda com o valor negativo, conforme exemplo abaixo. Envie os mesmos dados que enviou antes, por\u00e9m com uma \u00fanica mudan\u00e7a, que \u00e9 o valor negativo.<\/p>\n\n\n\n
{\n    \"acao\": \"inserir\",\n    \"estabelecimento\": 24340,\n    \"cliente\": \"09876543210\",\n    \"descricao\": \"Venda teste\",\n    \"data_insercao\": \"2024-03-12\",\n    \"valor\": \"-44\"<\/strong>\n   \n}<\/code><\/pre>\n\n\n\n
<\/p>\n\n\n\n
Mais detalhes da API em: https:\/\/donuz.co\/api\/<\/a> <\/p>\n","protected":false},"excerpt":{"rendered":"
A Donuz possui uma API que permite que qualquer empresa possa realizar uma integra\u00e7\u00e3o do seu software com a o Programa de Fidelidade, para inserir pontos de forma autom\u00e1tica. Para realizar uma integra\u00e7\u00e3o com a Donuz, \u00e9 necess\u00e1rio criar uma conta e obter ao Token de acesso com o atendimento da Donuz. Veja como fazer […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":[],"doc_category":[123],"doc_tag":[],"acf":[],"_links":{"self":[{"href":"https:\/\/donuz.com.br\/blog\/wp-json\/wp\/v2\/docs\/26975"}],"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=26975"}],"version-history":[{"count":6,"href":"https:\/\/donuz.com.br\/blog\/wp-json\/wp\/v2\/docs\/26975\/revisions"}],"predecessor-version":[{"id":27340,"href":"https:\/\/donuz.com.br\/blog\/wp-json\/wp\/v2\/docs\/26975\/revisions\/27340"}],"wp:attachment":[{"href":"https:\/\/donuz.com.br\/blog\/wp-json\/wp\/v2\/media?parent=26975"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/donuz.com.br\/blog\/wp-json\/wp\/v2\/doc_category?post=26975"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/donuz.com.br\/blog\/wp-json\/wp\/v2\/doc_tag?post=26975"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}