Criar

Ao realizar a criação do pedido, a Mottu irá retornar uma resposta informando se a criação foi bem-sucedida ou não. Em caso de sucesso, a resposta conterá o número do pedido criado. Em caso de erro, a Mottu retornará uma mensagem de erro informando o motivo do problema ou uma notificação no web lojista.

Para evitar problemas na criação de pedido e seguir o padrão esperado, recomenda-se a leitura dos itens Regras de negócio e Entrega segura.

post

Criação de pedido. Caso ocorrá algum erro ao criar o pedido, o lojista será notificado através do web lojista

Authorizations

Body

codestringRequired

Código customizado do pedido

Example: 17842a

preparationTimenumberOptional

Tempo de preparo do pedido em minutos, por exemplo, 40 minutos de preparo da refeição, nesse caso o pedido alocará um entregador após 40 minutos da criação do pedido. A propriedade é opcional

previewDeliveryTimebooleanOptional

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

Default: false

fullCodestringOptional

Código customizado completo do pedido. A propriedade é opcional

Example: 17842a-77-426a

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

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

storeall ofOptional

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

Responses

201

Pedido criado com sucesso

application/json

400Error

application/json

401Error

application/json

409

Já existe um pedido criado com o mesmo código externo

application/json

post

HTTPcURLJavaScriptPython

POST /delivery/orders HTTP/1.1
Host: integrations.mottu.io
x-api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 710

{
  "code": "17842a",
  "preparationTime": 1,
  "previewDeliveryTime": false,
  "fullCode": "17842a-77-426a",
  "sortByBestRoute": false,
  "pickupAddress": {
    "street": "text",
    "number": "text",
    "complement": "text",
    "neighborhood": "text",
    "city": "SP",
    "state": "SP",
    "zipCode": "text"
  },
  "deliveries": [
    {
      "code": "17842a",
      "confirmation": {
        "ifood": {
          "orderId": "text"
        },
        "ifood_webhook": {
          "order_id": "text"
        },
        "madero": {
          "order_id": "text"
        },
        "mottu": true
      },
      "fullCode": "17842a-77-426a",
      "pickupCode": "1784",
      "name": "text",
      "phone": "[phone]",
      "observation": "text",
      "address": {
        "street": "text",
        "number": "text",
        "complement": "text",
        "neighborhood": "text",
        "city": "SP",
        "state": "SP",
        "zipCode": "text"
      },
      "onlinePayment": true,
      "productValue": 13.45
    }
  ],
  "store": {
    "userMottuId": 1
  }
}

{
  "code": "17842a",
  "preparationTime": 1,
  "fullCode": "17842a-77-426a",
  "pickupAddress": {
    "street": "text",
    "number": "text",
    "complement": "text",
    "neighborhood": "text",
    "city": "SP",
    "state": "SP",
    "zipCode": "text"
  },
  "id": 1,
  "createdAt": "2025-08-01T23:19:38.224Z",
  "storeId": 1,
  "situation": 1,
  "returnCode": "text",
  "pickupCode": "text",
  "totalDistance": 1,
  "deliveryFee": 1,
  "deliveries": [
    {
      "code": "17842a",
      "fullCode": "17842a-77-426a",
      "name": "text",
      "phone": "[phone]",
      "observation": "text",
      "onlinePayment": true,
      "productValue": 13.45,
      "id": 1,
      "situation": 1,
      "orderRoute": 1,
      "address": {
        "street": "text",
        "number": "text",
        "complement": "text",
        "neighborhood": "text",
        "city": "SP",
        "state": "SP",
        "zipCode": "text"
      },
      "distance": 1,
      "deliveryCode": "text"
    }
  ],
  "expectedDelivery": "2025-08-01T23:19:38.224Z",
  "expectedPickup": "2025-08-01T23:19:38.224Z"
}