Criar expedição
Registra quem despacha um pedido, o seller ou o marketplace, e cobra a taxa do marketplace quando é ele quem envia.
Em condições normais você não precisa criar expedições: com o módulo ligado, a plataforma cria uma por seller assim que o pedido nasce. Use esta rota para pedidos anteriores ao módulo, para recriar uma expedição ou para trocar o responsável de um pedido que ainda não tem uma.
A criação é idempotente por pedido e seller: se já existe uma expedição para o par, a rota devolve a existente em vez de falhar. Com fulfilled_by: "marketplace", a taxa do seller é calculada e registrada; se o seller não tem taxa configurada, ou o cálculo falha, a expedição é criada mesmo assim, sem taxa.
Criar
/api/v1/admin/fulfillmentsAdminCria uma expedição
Exige o privilégio manage_orders e o módulo fulfillment ligado.
Corpo da requisição
order_iduuidobrigatóriofulfilled_bystringobrigatóriovendormarketplacevendor_iduuidExemplo de requisição
Resposta
Os campos são os de Consultar expedições. Na resposta de uma criação nova, fees ainda vem []: a taxa é gravada logo em seguida e aparece ao reler a expedição.
Erros
| Status | Quando | Corpo |
|---|---|---|
| 401 | Sem token, token inválido ou expirado | {"error":"invalid or expired token"} |
| 403 | Sem o privilégio exigido | {"error":"insufficient privileges","privilege_required_any":["manage_orders"]} |
| 403 | Módulo fulfillment desligado | {"error":"module_disabled","module":"fulfillment"} |
| 400 | Corpo que não é JSON; order_id ou fulfilled_by vazio; fulfilled_by que não é vendor nem marketplace; pedido ou seller inexistente | {"error":"order_id and fulfilled_by are required"} / {"error":"failed to create fulfillment","detail":"..."} |