Mottu Entregas Documentação
  • 📖Introdução
    • Primeiros Passos
    • Autenticação
    • Processo de Homologação
  • ⚙️API Reference
    • Pedido
      • Pré visualização
      • Criar
        • Mensagens de erros
        • Notificações
        • Regras de negócio
        • Entrega segura
      • Pronto para retirar
      • Consultar
      • Cancelar
    • Webhook
      • Habilitar o envio de Webhook
      • Status dos pedidos
      • Tipos de webhook
      • Simulação de webhook
      • Movimentação do pedido em homologação
    • Lojista
      • Cadastrar loja filial
      • Alterar loja
      • Consultar loja
      • Remover loja filial
      • Buscar Filiais
    • 📖Swagger
    • 📒Run on Postman
Powered by GitBook
On this page

Was this helpful?

  1. API Reference
  2. Pedido

Pré visualização

PreviousPedidoNextCriar

Last updated 9 months ago

Was this helpful?

Durante a pré-visualização do pedido, a Mottu irá calcular as rotas, o valor da entrega e a expectativa de coleta/entrega. No entanto, essa requisição não irá criar o pedido, somente irá disponibilizar a pré-visualização do mesmo para o lojista.

⚙️
post

Criação de preview de pedido. Calcula o valor do pedido e gera as rotas e expectativa de coleta e entrega

Authorizations
Body
previewDeliveryTimebooleanOptional

Define se devolvemos o tempo de entrega. Caso seja "false", retornaremos os campos vazios

Default: false
sortByBestRoutebooleanOptional

Caso seja marcada como "true", as entregas serão ordenadas pela melhor rota. Caso contrário, os pedidos serão entregues na ordem enviada. A propriedade é opcional - tendo como "false" o valor padrão

Default: false
storeall ofOptional

Lojista para criação do pedido. A propriedade é opcional

pickupAddressall ofOptional

Endereço de coleta do pedido. A propriedade é opcional e, quando não informado, será utilizado o endereço do usuário cadastrado na Mottu como endereço de coleta

Responses
200
Preview de pedido
application/json
201Success
application/json
400Error
application/json
401Error
application/json
post
POST /delivery/orders/preview HTTP/1.1
Host: integrations.mottu.io
x-api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 394

{
  "previewDeliveryTime": false,
  "sortByBestRoute": false,
  "store": {
    "userMottuId": 1
  },
  "pickupAddress": {
    "street": "text",
    "number": "text",
    "complement": "text",
    "neighborhood": "text",
    "city": "SP",
    "state": "SP",
    "zipCode": "text"
  },
  "deliveries": [
    {
      "orderRoute": 1,
      "address": {
        "street": "text",
        "number": "text",
        "complement": "text",
        "neighborhood": "text",
        "city": "SP",
        "state": "SP",
        "zipCode": "text"
      },
      "onlinePayment": true
    }
  ]
}
{
  "deliveries": [
    {
      "orderRoute": 1,
      "address": {
        "street": "text",
        "number": "text",
        "complement": "text",
        "neighborhood": "text",
        "city": "SP",
        "state": "SP",
        "zipCode": "text"
      },
      "onlinePayment": true
    }
  ],
  "totalDistance": 1,
  "onlinePayment": true,
  "deliveryFee": 1,
  "expectedDelivery": "2025-06-15T12:33:23.636Z",
  "expectedPickup": "2025-06-15T12:33:23.636Z"
}