Atualizar status manualmente

Quando usar

Use esta chamada para registrar manualmente um evento que aconteceu fora do fluxo automático da transportadora — por exemplo, uma entrega confirmada presencialmente ou uma falha registrada por um operador.

• A alteração é processada de forma assíncrona: a resposta 200 confirma que o evento foi aceito.
• No sistema, o status aparece como atualizado manualmente, identificando o token de API que originou a mudança.

event_at

Entrega existente vs. criar entrega

A chamada cobre os dois cenários automaticamente:

• Pedido com entrega ativa — o status da entrega atual é atualizado. carrier deve ser igual ao da entrega existente; caso contrário a API responde HTTP 400 (CARRIER_MISMATCH).
• Pedido sem entrega — uma entrega é criada já com o status informado usando o carrier enviado.

Exemplo — sucesso direto em frota própria

Pedido que ainda não foi despachado: envie status=SUCCESSFUL + carrier=PRIVATE-FLEET e a entrega nasce concluída.

PUT /seller-group/v1/orders/{order_id}/status
x-abbiamo-seller-group-key: <sua-chave>
Content-Type: application/json

{
  "status": "SUCCESSFUL",
  "sub_status": "DELIVERED",
  "carrier": "PRIVATE-FLEET",
  "event_at": "2026-06-16T18:37:12.000Z",
  "observation": "Entrega confirmada pelo operador"
}

Resposta de sucesso:

{ "success": true }

O pedido passa para status_name: SUCCESSFUL, last_delivery_type: PRIVATE-FLEET.

Valores válidos

status / sub_status

carrier

curl -X PUT "https://example.com/seller-group/v1/orders/string/status" \  -H "Content-Type: application/json" \  -d '{    "status": "SUCCESSFUL",    "sub_status": "DELIVERED",    "event_at": "2026-06-16T18:37:12.000Z",    "observation": "Entregue na portaria"  }'

{
  "success": true
}

{
  "code": "INVALID_STATUS",
  "message": "Status XPTO is not allowed for manual update"
}

{
  "message": "Unauthorized"
}

{
  "code": "INVOICE_NOT_FOUND_OR_NOT_IN_SELLER_GROUP",
  "message": "Invoice not found or not belongs to seller group",
  "status": 404
}