Atualizar status do pedido

Atualiza a etapa de andamento do pedido com efeito cascata server-side: ao marcar uma etapa, todas as etapas anteriores são automaticamente marcadas como concluídas e as posteriores ficam pendentes.

Para desmarcar uma etapa e regredir o pedido, envie valor: false.

Atenção: a etapa pagamento apenas confirma/cancela o pagamento manualmente — não aciona link de pagamento, carteira digital ou Pix, e não envia notificação de WhatsApp ao cliente. Marcar pagamento dispara o webhook de pagamento do lojista (pagamento_confirmado quando valor: true, pagamento_cancelado quando valor: false); as demais etapas não disparam webhook. Se o pedido tiver pagamento por carteira virtual, link de pagamento ou Pix ativo (Pendente) ou aprovado (Aprovado), a alteração da etapa pagamento é rejeitada — nesses casos o pagamento deve ser gerenciado pelo painel da plataforma.

O endpoint atualiza apenas pedidos da própria conta da credencial: pedidos de vendedores vinculados (visíveis no GET /pedidos com consultarVendedores=true) não são alteráveis por aqui e retornam pedido não encontrado.

A etapa preparacao foi descontinuada e não é mais aceita — a requisição é recusada com 400. Pedidos antigos podem ter status.preparacao: true gravado; o GET continua devolvendo o campo como está no banco (o schema mantém a propriedade marcada como legado/deprecated).

Respostas 400 (texto): status inválido (fora de separacao|enviado|entregue|pagamento — inclui preparacao), campo valor não-booleano, pedido cancelado, etapa enviado não aplicável a pedido sem entrega/retirada em outro local, alteração da etapa pagamento em pedido com pagamento por carteira virtual/link/Pix ativo ou aprovado (gerencie pelo painel), id do pedido inválido, ou pedido não encontrado (inclui pedido de outra loja ou de vendedor vinculado).