Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

--- integracao_easypromo [2024/05/24 14:12]
rafael
+++ integracao_easypromo [2024/11/06 18:06] (atual)
rafael
@@ Linha 1: / Linha 1: @@
 ====== Documentação para integração API Easy Promo ======
-===== Cadastro de produtos =====
+===== Cadastrar produto =====
-Método para cadastro de produtos.
+Método para cadastrar um produto.
 <html>
@@ Linha 76: / Linha 76: @@
 </tbody>
-</table
+</table>
 </html>
@@ Linha 92: / Linha 92: @@
 ===== Listar promoções =====
+Método para listar promoções cadastradas.
 <html>
@@ Linha 151: / Linha 153: @@
   ]
-===== Adicinonar promoção =====
+===== Adicionar promoção =====
-Método para adicionar promoção
+Método para adicionar uma promoção.
 <html>
@@ Linha 225: / Linha 227: @@
 </tr>
 </tbody>
-</table
+</table>
 </html>
@@ Linha 238: / Linha 240: @@
   }
-===== Atualiza uma  promoção =====
+===== Atualizar promoção =====
-Método para atualizar uma promoção
+Método para atualizar uma promoção.
 <html>
@@ Linha 312: / Linha 314: @@
 </tr>
 </tbody>
-</table
+</table>
 </html>
@@ Linha 325: / Linha 327: @@
   }
-===== Exclui uma  promoção =====
+===== Excluir promoção =====
-Método para excluir uma promoção
+Método para excluir uma promoção cadastrada.
 <html>
@@ Linha 356: / Linha 358: @@
 </tr>
 </tbody>
-</table
+</table>
 </html>
-===== Adiciona uma compra =====
+===== Adicionar compra =====
-Método para adicionar uma compra
+Método para adicionar uma compra.
 <html>
@@ Linha 434: / Linha 436: @@
 <tr>
     <td>payments</td>
-    <td>lista</td>
+    <td>array</td>
     <td>Lista de pagamentos do tipo objeto</td>
 </tr>
@@ Linha 440: / Linha 442: @@
     <td>payments.method</td>
     <td>number</td>
-    <td>ID da forma de pagamento (1-Dinheiro, 2-Cartão de débito, 3-Cartão de crédito, 4-Cheque, 5-Cartão benefício / Vale refeição, 6-Pix, 7-Carteira digital, 8-Outros)</td>
+    <td>ID da forma de pagamento (1-Dinheiro, 2-Cartão de débito, 3-Cartão de crédito, 4-Cheque, 5-Cartão benefício / Vale refeição, 6-Pix, 7-Carteira digital, 8-Outros, 9-Troco digital)</td>
 </tr>
 <tr>
@@ Linha 446: / Linha 448: @@
     <td>number</td>
     <td>Valor total do pagamento</td>
+</tr>
+<tr>
+    <td>payments.digital_change</td>
+    <td>number</td>
+    <td>Valor do troco digital (opcional)</td>
 </tr>
 <tr>
@@ Linha 459: / Linha 466: @@
 <tr>
     <td>items</td>
-    <td>list</td>
+    <td>array</td>
     <td>Itens da compra</td>
 </tr>
@@ Linha 514: / Linha 521: @@
 </tbody>
-</table
+</table>
 </html>
@@ Linha 530: / Linha 537: @@
               "total":  24,
               "splits": 0,
+              "digital_change": 0,
               "date": "2023-12-21 15:32:00"
           }
@@ Linha 547: / Linha 555: @@
       ]
   }
+===== Cancelar compra =====
+Método para cancelar uma compra.
+<html>
+<table>
+<tbody>
+<tr>
+    <td>Método</td>
+    <td colspan="2">URL</td>
+</tr>
+<tr>
+    <td>POST</td>
+    <td colspan="2">http://{dominio}/api/v1/accounts/integrations/shops/cancel</td>
+</tr>
+<tr>
+    <td colspan="3">Cabeçalho</td>
+</tr>
+<tr>
+    <td>Campo</td>
+    <td colspan="2">Descrição</td>
+</tr>
+<tr>
+    <td>X-Store-Token</td>
+    <td colspan="2">Token da loja</td>
+</tr>
+<tr>
+    <td>Authorization</td>
+    <td colspan="2">Token de autorização do tipo Bearer</td>
+</tr>
+<tr>
+    <td colspan="3">Corpo da requisição</td>
+</tr>
+<tr>
+    <td>Campo</td>
+    <td>Tipo</td>
+    <td>Descrição</td>
+</tr>
+<tr>
+    <td>date</td>
+    <td>string</td>
+    <td>Data da venda no formato yyyy-mm-dd</td>
+</tr>
+<tr>
+    <td>pdv</td>
+    <td>string</td>
+    <td>Número do PDV</td>
+</tr>
+<tr>
+    <td>coupon</td>
+    <td>string</td>
+    <td>Número do cupom</td>
+</tr>
+<tr>
+    <td>type</td>
+    <td>string</td>
+    <td>Tipo (DAV,OS,FOOD,CF,NF)</td>
+</tr>
+<tr>
+    <td>reference</td>
+    <td>string</td>
+    <td>Referência</td>
+</tr>
+</tbody>
+</table>
+</html>
+  {
+      "date": "2024-05-22",
+      "pdv": "1",
+      "coupon": "7",
+      "type": "NF"
+  }
+  ou
+  {
+      "date": "2024-05-22",
+      "type": "NF"
+      "reference": "1"
+  }
+===== Descontos do consumidor =====
+Método para exibir os descontos de um consumidor.
+<html>
+<table>
+<tbody>
+<tr>
+    <td>Método</td>
+    <td colspan="2">URL</td>
+</tr>
+<tr>
+    <td>POST</td>
+    <td colspan="2">http://{dominio}/api/v1/accounts/integrations/shops/discounts</td>
+</tr>
+<tr>
+    <td colspan="3">Parâmetros query string</td>
+</tr>
+<tr>
+    <td>Campo</td>
+    <td>Tipo</td>
+    <td>Descrição</td>
+</tr>
+<tr>
+    <td>not_show_discounts</td>
+    <td>1</td>
+    <td>Não exibir os descontos dos produtos</td>
+</tr>
+<tr>
+    <td colspan="3">Cabeçalho</td>
+</tr>
+<tr>
+    <td>Campo</td>
+    <td colspan="2">Descrição</td>
+</tr>
+<tr>
+    <td>X-Store-Token</td>
+    <td colspan="2">Token da loja</td>
+</tr>
+<tr>
+    <td>Authorization</td>
+    <td colspan="2">Token de autorização do tipo Bearer</td>
+</tr>
+<tr>
+    <td colspan="3">Corpo da requisição</td>
+</tr>
+<tr>
+    <td>Campo</td>
+    <td>Tipo</td>
+    <td>Descrição</td>
+</tr>
+<tr>
+    <td>consumer</td>
+    <td>string</td>
+    <td>CPF/CNPJ do consumidor</td>
+</tr>
+<tr>
+    <td>reference</td>
+    <td>string</td>
+    <td>Referência</td>
+</tr>
+<tr>
+    <td>type</td>
+    <td>string</td>
+    <td>Tipo</td>
+</tr>
+<tr>
+    <td>pdv</td>
+    <td>string</td>
+    <td>PDV</td>
+</tr>
+<tr>
+    <td>coupon</td>
+    <td>string</td>
+    <td>Número do cupom</td>
+</tr>
+<tr>
+    <td>date</td>
+    <td>string</td>
+    <td>Data no formato (YYYY-MM-DD HH:mm)</td>
+</tr>
+<tr>
+    <td>items</td>
+    <td>array</td>
+    <td>Lista de itens da compra</td>
+</tr>
+<tr>
+    <td>items.barcode</td>
+    <td>string</td>
+    <td>Código de barras do item no formato [0-9]</td>
+</tr>
+<tr>
+    <td>items.unit_value</td>
+    <td>number</td>
+    <td>Valor unitário do item</td>
+</tr>
+<tr>
+    <td>items.quantity</td>
+    <td>number</td>
+    <td>Quantidade do item</td>
+</tr>
+<tr>
+    <td>items.discount</td>
+    <td>number</td>
+    <td>Desconto do item</td>
+</tr>
+<tr>
+    <td>items.total</td>
+    <td>number</td>
+    <td>Total do item</td>
+</tr>
+<tr>
+    <td colspan="3">Corpo da resposta</td>
+</tr>
+<tr>
+    <td>wallet</td>
+    <td>object</td>
+    <td>Objeto da carteira do consumidor</td>
+</tr>
+<tr>
+    <td>wallet.total_points</td>
+    <td>number</td>
+    <td>Total de pontos do consumidor</td>
+</tr>
+<tr>
+    <td>wallet.total_balance</td>
+    <td>number</td>
+    <td>Saldo total do vale compras</td>
+</tr>
+<tr>
+    <td>wallet.total_shoppings</td>
+    <td>number</td>
+    <td>Total em compras</td>
+</tr>
+<tr>
+    <td>wallet.count_shoppings</td>
+    <td>number</td>
+    <td>Quantidade de compras</td>
+</tr>
+<tr>
+    <td>wallet.total_discounts</td>
+    <td>number</td>
+    <td>Total de compras</td>
+</tr>
+<tr>
+    <td>discounts</td>
+    <td>object</td>
+    <td>Objeto com os descontos do consumidor</td>
+</tr>
+<tr>
+    <td>discounts.barcode</td>
+    <td>string</td>
+    <td>Código de barras do item</td>
+</tr>
+<tr>
+    <td>discounts.promotion_id</td>
+    <td>string</td>
+    <td>ID da promoção</td>
+</tr>
+<tr>
+    <td>discounts.price</td>
+    <td>number</td>
+    <td>Preço unitário do item</td>
+</tr>
+<tr>
+    <td>discounts.final_price</td>
+    <td>number</td>
+    <td>Preço final unitário do item com desconto</td>
+</tr>
+<tr>
+    <td>discounts.discount</td>
+    <td>number</td>
+    <td>Desconto total a ser aplicado no item da venda</td>
+</tr>
+</tbody>
+</table>
+</html>
+Exemplo envio:
+  {
+      "consumer": "53933515009",
+      "date": "2024-06-19",
+      "pdv": "1",
+      "coupon": "1",
+      "reference": "1",
+      "type": "DAV"
+      "items": [
+          {
+              "barcode": "999999",
+              "unit_value": 36.59,
+              "quantity": 3,
+              "discount": 0,
+              "total": 109.77
+          }
+      ]
+  }
+Exemplo resposta:
+  {
+      "wallet": {
+          "total_points": 52.99,
+          "total_balance": 62.16,
+          "total_shoppings": 152.99,
+          "count_shoppings": 7,
+          "digital_change": 0,
+          "total_discounts": 15
+      },
+      "discounts": {
+          "999999": {
+              "barcode": "999999",
+              "promotion_id": 7,
+              "price": 36.59,
+              "final_price": 32.931000000000004,
+              "discount": 7.318
+          }
+      }
+  }
+===== Resgate de vale compras =====
+Método para resgatar vale compras do consumidor
+<html>
+<table>
+<tbody>
+<tr>
+    <td>Método</td>
+    <td colspan="2">URL</td>
+</tr>
+<tr>
+    <td>POST</td>
+    <td colspan="2">http://{dominio}/api/v1/accounts/integrations/consumers/{document}/balance/redeem</td>
+</tr>
+<tr>
+    <td colspan="3">Cabeçalho</td>
+</tr>
+<tr>
+    <td>Campo</td>
+    <td colspan="2">Descrição</td>
+</tr>
+<tr>
+    <td>X-Store-Token</td>
+    <td colspan="2">Token da loja</td>
+</tr>
+<tr>
+    <td>Authorization</td>
+    <td colspan="2">Token de autorização do tipo Bearer</td>
+</tr>
+<tr>
+    <td colspan="3">Corpo da requisição</td>
+</tr>
+<tr>
+    <td>Campo</td>
+    <td>Tipo</td>
+    <td>Descrição</td>
+</tr>
+<tr>
+    <td>value</td>
+    <td>number</td>
+    <td>Valor a ser resgatado</td>
+</tr>
+<tr>
+    <td>digital_change</td>
+    <td>number</td>
+    <td>Valor a ser resgatado do troco digital</td>
+</tr>
+<tr>
+    <td>reference</td>
+    <td>string</td>
+    <td>Número de referência</td>
+</tr>
+<tr>
+    <td>coupon</td>
+    <td>string</td>
+    <td>Número cupom</td>
+</tr>
+<tr>
+    <td>pdv</td>
+    <td>string</td>
+    <td>Número do PDV</td>
+</tr>
+<tr>
+    <td>date</td>
+    <td>string</td>
+    <td>Data no formato YYYY-MM-DD HH:MM</td>
+</tr>
+<tr>
+    <td>type</td>
+    <td>string</td>
+    <td>Tipo da compra(DAV,OS,FOOD,CF,NF)</td>
+</tr>
+</table>
+</html>
+  {
+    "date": "2024-06-19 17:13",
+    "value": 10,
+    "digital_change": 2,
+    "coupon": "2",
+    "reference": "2",
+    "pdv": "2",
+    "type": "NF"
+  }
+===== Consultar carteira =====
+Método para consultar a carteira do consumidor.
+<html>
+<table>
+<tbody>
+<tr>
+    <td>Método</td>
+    <td colspan="2">URL</td>
+</tr>
+<tr>
+    <td>GET</td>
+    <td colspan="2">http://{dominio}/api/v1/accounts/integrations/consumers/document/{document}/wallet</td>
+</tr>
+<tr>
+    <td colspan="3">Cabeçalho</td>
+</tr>
+<tr>
+    <td>Campo</td>
+    <td colspan="2">Descrição</td>
+</tr>
+<tr>
+    <td>X-Store-Token</td>
+    <td colspan="2">Token da loja</td>
+</tr>
+<tr>
+    <td>Authorization</td>
+    <td colspan="2">Token de autorização do tipo Bearer</td>
+</tr>
+</table>
+</html>

Documentação de software

Ferramentas do usuário

Ferramentas do site

Diferenças

Ferramentas da página