Nossa integração para sistemas POS foi pensada para acontecer no final da venda. A primeira chamada deve ocorrer na passagem para a tela de pagamento, no fechamento da conta.
Gostamos de dizer que este é um fluxo linear, o que significa que uma chamada deve ocorrer religiosamente seguida da outra, pois há dependências de dados entre elas.
Fluxo de Chamadas
Os três endpoints da imagem acima são os responsáveis por todo o processo de bonificação. Na mesma imagem já é possível verificar também a ordem na qual devem ocorrer as chamadas.
Respostas de Erro Comuns:Deixo abaixo os principais erros que poderão ser retornados em qualquer um dos endpoints deste fluxo. Entretanto, há erros particulares em cada endpoint que estarão descritos em sua respectiva aba da documentação.
Acesso não autorizado: quando o header authorization está é inválido ou não foi utilizado;
Header incompleto: quando há informações faltando, normalmente seguido desta especificação;
Loja não encontrada: quando o header "ec" não é encontrado ou é inválido;
Sistema de bonificação inativo: normalmente sinaliza que a plataforma foi desabilitada (entrar em contato com a equipe CRM&Bônus);
Campo "phone" inválido: indica que o número de celular informado não é válido;