API All Delivery

POST/deliveries/quote

Calcula o preço e o tempo estimado de uma entrega, por tipo de veículo. Não cria nada ainda — o quote_id retornado vale por 15 minutos e é usado no próximo passo (POST /deliveries).

Corpo da requisição

Exemplo — curl

curl -X POST https://alldelivery.com.br/api/v1/deliveries/quote \
  -H "Authorization: Bearer alldev_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "pickup": { "address": "Av. Paulista, 1000, São Paulo, SP" },
    "dropoff": { "address": "Rua Augusta, 500, São Paulo, SP" },
    "package": { "description": "Caixa pequena", "declared_value": 150.00 },
    "recipient": { "name": "João Cliente", "phone": "5511999999999" }
  }'

Resposta — 200

{
  "quote_id": "bb5520115abdb36e2f322210eafd9cb3",
  "expires_in_seconds": 900,
  "distance": { "text": "2.3 km", "meters": 2283 },
  "duration": { "text": "9 mins", "seconds": 531 },
  "vehicles": {
    "electric_bicycle": { "label": "Bicicleta elétrica", "price": 6.00 },
    "motorcycle": { "label": "Moto", "price": 7.00 },
    "car": { "label": "Carro", "price": 10.00 }
  }
}

Erros possíveis: 422 invalid_request (faltou endereço) · 422 route_not_found (endereço não localizável).

POST/deliveries

Confirma uma cotação e despacha a entrega de verdade (ou de mentira, em sandbox). Aceita Idempotency-Key.

Corpo da requisição

Exemplo — curl

curl -X POST https://alldelivery.com.br/api/v1/deliveries \
  -H "Authorization: Bearer alldev_test_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7c3aa9c1-2b3e-4e1a-9f00-1a2b3c4d5e6f" \
  -d '{ "quote_id": "bb5520115abdb36e2f322210eafd9cb3", "vehicle_type": "motorcycle" }'

Resposta — 201

{
  "id": "153795931",
  "status": "searching",
  "is_sandbox": true,
  "vehicle_type": "motorcycle",
  "price": 7.00,
  "pickup_address": "Av. Paulista, 1000 - Bela Vista, São Paulo - SP",
  "dropoff_address": "R. Augusta, 500 - Cerqueira César, São Paulo - SP",
  "driver": null,
  "tracking_url": "https://alldelivery.com.br/customer?order=924600",
  "created_at": "2026-09-06 16:49:33"
}

status é sempre um destes: draft, searching, accepted, in_transit, delivered, cancelled. Quando um motorista é atribuído, driver vem preenchido com name, phone e vehicle_type.

Erros possíveis: 404 quote_not_found (cotação expirada/já usada) · 422 invalid_vehicle_type · 402 insufficient_balance.

GET/deliveries/{id}

Consulta o status atual — use isso pra fazer polling (a cada 5-10s é suficiente) até a entrega sair de searching. Devolve o mesmo formato do POST /deliveries.

curl https://alldelivery.com.br/api/v1/deliveries/153795931 \
  -H "Authorization: Bearer alldev_test_xxx"

Erro possível: 404 delivery_not_found.

POST/deliveries/{id}/cancel

Cancela — só funciona enquanto a entrega ainda está searching (nenhum motorista aceitou ainda). Devolve o objeto atualizado com status: "cancelled".

curl -X POST https://alldelivery.com.br/api/v1/deliveries/153795931/cancel \
  -H "Authorization: Bearer alldev_test_xxx"

Erro possível: 409 not_cancellable (já foi aceita ou finalizada).

PUT/sender-profile

Cadastra o endereço de remetente da sua loja — obrigatório antes de cotar ou despachar por transportadora (é o endereço que sai na etiqueta como remetente, e de onde a cotação de frete parte).

curl -X PUT https://alldelivery.com.br/api/v1/sender-profile \
  -H "Authorization: Bearer alldev_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Minha Loja Ltda",
    "document": "12345678000199",
    "phone": "5511999999999",
    "cep": "01310-930",
    "address": "Av. Paulista",
    "number": "1000",
    "district": "Bela Vista",
    "city": "São Paulo",
    "state": "SP"
  }'

{ "status": "ok" }

POST/shipments/quote

Cotação real, por transportadora e serviço, a partir do seu endereço de remetente já cadastrado.

curl -X POST https://alldelivery.com.br/api/v1/shipments/quote \
  -H "Authorization: Bearer alldev_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "destination_cep": "20040-020",
    "package": { "format": "pacote", "weight_grams": 500, "length_cm": 20, "width_cm": 15, "height_cm": 10 }
  }'

{
  "quotes": {
    "correios": {
      "03220": { "carrier_code": "correios", "service_code": "03220", "label": "Correios - SEDEX", "cost": 28.85, "markup_percent": 25, "delivery_days": 1, "total": 36.06 },
      "03298": { "carrier_code": "correios", "service_code": "03298", "label": "Correios - PAC", "cost": 18.40, "markup_percent": 25, "delivery_days": 5, "total": 23.00 }
    }
  }
}

Erro possível: 422 sender_profile_missing.

POST/shipments

Gera a etiqueta e despacha. Aceita Idempotency-Key.

curl -X POST https://alldelivery.com.br/api/v1/shipments \
  -H "Authorization: Bearer alldev_test_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b" \
  -d '{
    "carrier_code": "correios",
    "service_code": "03298",
    "package": { "format": "pacote", "weight_grams": 500, "length_cm": 20, "width_cm": 15, "height_cm": 10, "description": "Produto X", "declared_value": 100.00 },
    "recipient": {
      "name": "Cliente Final", "cep": "20040-020", "address": "Rua Tal", "number": "1",
      "district": "Centro", "city": "Rio de Janeiro", "state": "RJ", "phone": "5521999999999"
    }
  }'

{
  "id": "828032279",
  "is_sandbox": true,
  "status": "generated",
  "carrier_code": "correios",
  "service_code": "03298",
  "price": 23.00,
  "tracking_code": "SANDBOX13A26C6BB80A",
  "label_url": null,
  "last_tracking_status": null,
  "created_at": "2026-09-06 16:55:04"
}

label_url aponta pro PDF da etiqueta assim que o status vira generated com um tracking_code real (em sandbox fica null, já que a etiqueta é simulada).

Erros possíveis: 422 sender_profile_missing · 422 invalid_service · 402 insufficient_balance · 502 carrier_error (a transportadora recusou).

GET/shipments/{id}

Consulta status/rastreio — em produção, reconsulta a transportadora de verdade antes de responder.

curl https://alldelivery.com.br/api/v1/shipments/828032279 \
  -H "Authorization: Bearer alldev_test_xxx"

POST/shipments/{id}/cancel

Cancela a etiqueta/envio.

curl -X POST https://alldelivery.com.br/api/v1/shipments/828032279/cancel \
  -H "Authorization: Bearer alldev_test_xxx"

GET/vehicle-categories

Lista os tipos de veículo disponíveis pra usar em vehicle_type.

curl https://alldelivery.com.br/api/v1/vehicle-categories \
  -H "Authorization: Bearer alldev_test_xxx"

{
  "vehicle_categories": [
    { "slug": "electric_bicycle", "label": "Bicicleta elétrica", "icon": "ebike" },
    { "slug": "motorcycle", "label": "Moto", "icon": "motorcycle" },
    { "slug": "car", "label": "Carro", "icon": "car" }
  ]
}