O encarteiramento flexível via API é o processo de atribuir um consumidor a uma loja e vendedor específicos com base em regras de negócio personalizadas. Essa solução permite que marcas elaborem regras personalizadas para o encarteiramento de consumidores.

• Nível de Acesso: Administrador (com acesso à API)
  Persona: Equipe de TI, Desenvolvedor, Gerente de CRM

Agenda: Como implementar o encarteiramento flexível via API

O encarteiramento de clientes é o processo de atribuir um consumidor a uma loja e vendedor específicos. Na Dito, existem duas formas de realizar esse processo:

• Via arquivo: realizado diretamente pelo app.dito, por meio da importação de um arquivo com os vínculos que devem ser criados ou atualizados.
• Via API: realizado de forma integrada, permitindo que a própria marca envie para a Dito as informações de encarteiramento por meio de uma chamada de API, definindo suas próprias regras de negócio.

Passos para implementação via API

1. Entre em contato com o time de suporte da Dito para solicitar a liberação do acesso à API.
2. Consulte a documentação de integração da Dito, disponível em openapi.dito.com.br/docs. Acesse a seção Agenda > Agenda Distribution.
   
3. Desenvolva uma rotina ou automação que calcule o vendedor e a loja de cada cliente, com base nos eventos e regras de negócio desejadas.
4. Envie os dados de vendedor e loja definidos para cada cliente para a API da Dito.
   
   

Importante: O status HTTP 201 indica que a solicitação foi recebida, e não que o encarteiramento já foi aplicado.

 A validação efetiva dos registros acontece no dia seguinte, durante a rotina noturna de encarteiramento.

Pontos importantes e esclarecimentos

• A Dito não fornece um passo a passo ou modelo para a construção da rotina interna da marca ou para a definição das regras de cálculo, pois estas são específicas da operação de cada cliente.
• Para o encarteiramento flexível, não é um pré-requisito que os eventos personalizados (como consignações ou devoluções) estejam integrados na Dito para visualização. A marca precisa apenas enviar o resultado final do encarteiramento (vendedor e loja).
• Caso a marca deseje, além do encarteiramento flexível, integrar esses eventos personalizados na Dito para visualização, isso é considerado um serviço de integração à parte e possui custo adicional.

FAQ – Perguntas Frequentes

1. Pergunta: Preciso enviar os eventos personalizados (consignação, devoluções) para a Dito para o encarteiramento flexível funcionar?
Resposta: Não. A marca precisa apenas enviar o resultado final do encarteiramento (vendedor e loja) via API. A integração dos eventos para visualização na Dito é um serviço separado.

2. Pergunta: O que significa o status 'HTTP 201' que a API retorna?
Resposta: O status 'HTTP 201' indica apenas que a sua solicitação foi recebida com sucesso por nossa API. A aplicação e validação do encarteiramento ocorrem posteriormente, durante a rotina noturna do sistema.

3. Pergunta: A Dito pode me ajudar a criar a lógica para definir qual vendedor pertence a qual cliente?
Resposta: Não, a definição das regras de negócio e o desenvolvimento da rotina interna para o cálculo do encarteiramento são de responsabilidade da marca, pois são específicas de cada operação.

Ficou com alguma dúvida ou identificou algum problema? Acione nosso time pelo chat disponível no app dito. (Horário de Atendimento de Segunda a Sexta das 9hrs as 18hrs)

Tags: encarteiramento flexível, API, regras personalizadas, atribuição de clientes, eventos personalizados, integração API, Dito CRM, Agenda, Configurações, Distribuição de clientes, Distribuição de Clientes - Encarteiramento Flexível, Encarteiramento flexível via API, como encarteirar cliente api, vincular vendedor a cliente api dito, distribuir clientes por api, agenda de clientes