A Donuz possui uma API que permite que qualquer empresa possa realizar uma integração do seu software com a o Programa de Fidelidade, para inserir pontos de forma automática.
Para realizar uma integração com a Donuz, é necessário criar uma conta e obter ao Token de acesso com o atendimento da Donuz.
Veja como fazer uma inserção de pontos via API
Método: POST
Requisição: https://donuz.co/api/v1/ponto
Headers
| KEY | VALUE |
| TOKEN | Chave de acesso |
Body (Parâmetros json)
| KEY | VALUE |
| acao | inserir |
| estabelecimento | ID da empresa |
| cliente | CPF ou Código de quem vai ganhar ponto |
| valor | Valor da venda em reais ou valor dos pontos a inserir |
| descricao (opcional) | Descrição dos pontos |
| data_de_insercao (opcional) | Data da inserção. Ex: 25/04/2017 |
| regra (opcional) | ID da regra de pontos, caso não seja informado será considerado regra padrão 1 para 1. |
| usuario (opcional) | ID do usuário da loja/filial. |
| codigo_do_produto (opicional) | Código do produto vendido. |
| codigo_de_controle (opcional) | Código da venda (transação). |
Exemplo de requisição:
{
"acao": "inserir",
"estabelecimento": 24340,
"cliente": "09876543210",
"descricao": "Venda teste",
"data_insercao": "2024-03-12",
"valor": "44"
}Exemplo de retorno:
{
"status": 200,
"mensagem": "Requisição finalizada com sucesso.",
"uri": "http://www.donuz.co/api/v1/ponto/130254/48677342",
"estabelecimento": 24340,
"cliente": "130254",
"pontos": 88,
"descricao": null,
"id_ponto": "48677342"
}Se uma venda foi cancelada, você pode estorno os pontos, enviando os dados da venda com o valor negativo, conforme exemplo abaixo. Envie os mesmos dados que enviou antes, porém com uma única mudança, que é o valor negativo.
{
"acao": "inserir",
"estabelecimento": 24340,
"cliente": "09876543210",
"descricao": "Venda teste",
"data_insercao": "2024-03-12",
"valor": "-44"
}Mais detalhes da API em: https://donuz.co/api/