Regras de negócio

Lojista/Unidade responsável pelo pedido

/orders e /orders/preview

Para atender às necessidades de lojistas com matriz e filiais, é possível informar a qual filial ou unidade pertence cada pedido utilizando a propriedade "store". Por padrão, o lojista criador do pedido é considerado o dono do pedido quando o token é enviado na requisição. No entanto, ao utilizar o token da matriz para requisições de todas as filiais, é necessário informar qual filial ou unidade específica é responsável pelo pedido.

Dessa forma, a propriedade "store" permite que o pedido seja associado à unidade correta do lojista, garantindo uma gestão mais precisa das operações.

{
  "store": {
    "userMottuId": 55555
  }
}

Existem duas formas de identificar a unidade correta na plataforma Mottu: através do userMottuId exclusivo de cada unidade.

Quando a propriedade "store" for informada corretamente, a unidade correspondente será utilizada como criadora do pedido.

Regras:

• Uma loja/matriz somente pode criar pedidos para si mesmo e para suas filiais, quando autenticado pela matriz.

• Uma filial não pode criar um pedido para outra filial, mesmo que tenham a mesma matriz.

• Uma matriz não pode criar pedidos para uma filial que não seja sua.

Endereço de coleta

orders e /orders/preview

{
  "pickupAddress": {
    "street": "avenida valdemar ferreira",
    "number": "186",
    "complement": "mottu",
    "neighborhood": "Butantã",
    "city": "São Paulo",
    "state": "SP",
    "zipCode": "05501000"
  }
}

O endereço de coleta é opcional. Caso não seja informado, o endereço cadastrado na unidade responsável pelo pedido será utilizado. Porém, se o endereço de coleta for informado, ele será utilizado como endereço de coleta para o pedido, substituindo o endereço cadastrado na unidade.

Para garantir que o cálculo da entrega seja realizado de forma correta, é necessário informar o endereço completo e válido, incluindo o nome da rua, número, bairro, cidade e estado. Apenas informar o CEP não é suficiente, já que algumas cidades possuem CEPs únicos, o que pode gerar imprecisões no cálculo da entrega. É importante lembrar que o endereço de coleta e entrega devem ser informados de forma clara e legível para evitar erros na entrega do pedido.

Previsão de entrega

{
  "previewDeliveryTime": true
}

Quando o pedido é feito com solicitação de previsão de entrega, o sistema calcula a previsão de chegada do entregador no endereço de entrega do cliente final. Esse cálculo leva em conta a distância entre o endereço de coleta e entrega, adicionado ao tempo médio de chegada do entregador até a coleta, considerando o histórico da região do endereço de coleta. Se o tempo médio de coleta não puder ser calculado devido à falta de histórico recente, será retornado nulo. Por exemplo, se o tempo médio de coleta for de 10 minutos e o tempo médio de deslocamento entre o ponto de coleta e entrega for de 15 minutos, a previsão de entrega será de 25 minutos.