Apagar e duplicar método
Remove definitivamente um método de envio ou cria uma cópia desativada dele, com as mesmas faixas de preço.
Duas operações de manutenção: apagar remove o método do cadastro e duplicar parte de um método pronto para criar outro parecido (por exemplo, o mesmo serviço para outro seller ou outra região).
Apagar um método
A exclusão é definitiva: não há lixeira nem desfazer. Pedidos já feitos mantêm o nome do método gravado neles, mas o cadastro, as faixas e as tarifas somem. Se só quer parar de oferecer o método, desative-o. Invalida o cache de cotações.
/api/v1/admin/shipping-methods/{id}AdminApaga um método de envio
Exige manage_shipping.
Parâmetros de caminho
iduuidobrigatórioExemplo de requisição
curl -X DELETE "$BASE_URL/api/v1/admin/shipping-methods/$METHOD_ID" \
-H "Authorization: Bearer $TOKEN"Resposta
{
"message": "shipping method deleted"
}Duplicar um método
Cria <nome> (Copy) com os mesmos campos do original. O code da cópia é o do original com o sufixo _copy (ou _copy_2, _copy_3... se já existir) e o status é D: a cópia fica desativada até você revisá-la e ativar. As faixas de preço (/tiers) e as tarifas por degrau (/rates) são copiadas.
/api/v1/admin/shipping-methods/{id}/duplicateAdminDuplica um método de envio
Exige manage_shipping. Sem corpo.
Parâmetros de caminho
iduuidobrigatórioExemplo de requisição
curl -X POST "$BASE_URL/api/v1/admin/shipping-methods/$METHOD_ID/duplicate" \
-H "Authorization: Bearer $TOKEN"Resposta
{
"id": "6cd9d24e-56ea-4257-bc2c-f02ddfe320ed",
"display_id": 72,
"tenant_id": "dfe2555e-bfd0-41a8-9fa1-9586999f3798",
"name": "Entrega Padrão (Copy)",
"code": "entrega_padrao_copy",
"carrier": "manual",
"rate_calculation": "M",
"delivery_time": "3-5 dias úteis",
"status": "D",
"min_weight": 0,
"max_weight": 0,
"free_shipping_threshold": 0,
"flat_rate": 1500,
"estimated_days": 0,
"free_shipping": false,
"is_address_required": false,
"tax_ids": "",
"usergroup_ids": "",
"icon_url": "",
"surcharge": 0,
"surcharge_percent": 0,
"use_for_all_vendors": true,
"position": 0,
"created_at": "2026-10-11T21:35:34.649864Z",
"updated_at": "2026-10-11T21:35:34.649864Z",
"shipping_id": "6cd9d24e-56ea-4257-bc2c-f02ddfe320ed",
"shipping": "Entrega Padrão (Copy)",
"module": "manual",
"rate_str": "15.00",
"timestamp": 1791754534,
"updated_timestamp": 1791754534
}Erros
| Status | Quando | Corpo |
|---|---|---|
| 401 | Sem token, token inválido ou expirado | {"error":"invalid or expired token"} |
| 403 | Usuário sem o privilégio manage_shipping | {"error":"insufficient privileges","privilege_required_any":["manage_shipping"]} |
| 400 | id que não é UUID | {"error":"invalid id","detail":"id must be a valid UUID"} |
| 500 | O método não existe (apagar ou duplicar) | {"error":"failed to delete shipping method","detail":"shipping method not found: 00000000-0000-0000-0000-000000000000"} |