API ViaShopModa documentação

pedido/atualizar

Atualizar status do pedido

O ERP muda o status do pedido (pago, em transporte, entregue, cancelado) e informa pagamento, rastreio e nota.

Ver como Markdown Baixar coleção Postman Atualizado em 18/11/2026

O que faz #

Atualiza o status de um pedido e, opcionalmente, forma de pagamento, parcelas, comprovante, rastreio e nota fiscal. Cancelar devolve o estoque à loja.

Requisição #

MétodoPOST
URLhttps://api.viashopmoda.com.br/via/pedido/atualizar/{TOKEN}
CorpoObjeto JSON { ... }, cabeçalho Content-Type: application/json
TokenSubstitua {TOKEN} pelo token da loja. Ele vai no caminho da URL, não em cabeçalho.

Campos #

CampoTipoObrigatórioDescrição
pedido.numero_pedidotextosimNúmero do pedido na loja (6 dígitos).
pedido.status_pedidotextosimNome exato de um status (tabela abaixo).
pedido.forma_pagamentotextonãoNome exato de uma forma de formas_pagamento/consultar. Sem ele, mantém a atual.
pedido.fixar_pagamentotextonão"Sim" obriga o cliente a pagar com essa forma.
pedido.url_notafiscaltextonãoURL da nota fiscal.
subpedido.parcelas_pagamentonúmeronãoParcelas.
subpedido.numero_comprovantetextonãoComprovante de pagamento.
subpedido.rastreio_fretetextonãoCódigo de rastreio.

Os campos de subpedido também são aceitos dentro de pedido.

Status aceitos #

Use o texto exatamente assim:

StatusConta como pago?
Pedido em análisenão
Aguardando Pagamentonão
Falha na tentativa de pagamentonão
Pagamento efetuado, aguardando capturasim
Pagamento autorizado, aguardando enviosim
Pedido em transportesim
Pedido entreguesim
Pedido cancelado—

Aguardando Pagamento tem o "P" maiúsculo. Os códigos AN, PG, EN… valem só em pedido/cadastrar, não aqui.

Regras #

  • Pedido cancelado devolve ao estoque da loja os itens que tinham sido baixados.
  • Um pedido cancelado pode voltar a outro status; a loja anota a mudança nas observações.
  • As datas de cada etapa são gravadas com a data do dia da atualização.

Exemplo #

{
  "pedido": {
    "numero_pedido": "111111",
    "status_pedido": "Pedido em transporte"
  },
  "subpedido": {
    "rastreio_frete": "BR123456789BR"
  }
}
{
  "retorno": true,
  "msg": "Pedido '111111' atualizado com sucesso.",
  "numero_pedido": "111111",
  "status_antigo": "Pagamento autorizado, aguardando envio",
  "status_novo": "Pedido em transporte"
}

Recusas (HTTP 200 com retorno: false):

MensagemCausa
POST do pedido deve ser um object (...)Corpo não é objeto.
'status_pedido' não encontrado / 'status_pedido' não pode ser vazioFalta o status.
Status 'X' não encontrado ou não existeGrafia diferente da tabela.

Pode reenviar? #

Sim. Reenviar o mesmo status não muda nada além das datas da etapa.

Onde entra no processo #

Guia Pedidos.