> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teceo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# o ciclo de vida dos pedidos

o status do pedido define o que pode ser alterado nele, quem pode movê-lo adiante e o que acontece com o estoque reservado.

o pedido percorre uma sequência: é criado em rascunho, avança por uma ou duas etapas de revisão e aprovação conforme quem o conduz, e termina aprovado ou enviado. o status da integração é um eixo separado, e responde por outra pergunta: se o pedido já desceu para o sistema de gestão.

## os status

### rascunho

o estado inicial de qualquer pedido criado na plataforma. os itens aceitam inclusão, alteração e remoção, e o estoque dos itens de pré-venda e de pronta-entrega é reservado desde a criação.

### em revisão

a loja concluiu o pedido e ele aguarda o representante ou o admin da marca. os itens continuam editáveis e o estoque continua reservado.

este status existe no fluxo conduzido pela loja. quando o representante ou o admin cria e conclui o pedido, ele vai direto para aprovação.

### em aprovação

o pedido aguarda a decisão final da marca. só o admin da marca aprova, e os itens continuam editáveis até a aprovação.

a marca pode saltar esta etapa para parte dos pedidos: em definições gerais existe a configuração **permitir que pedidos de pronta-entrega sigam direto para "aprovado", sem passar por "em aprovação"**. ela vale só para pedido de pronta-entrega, e é desconsiderada quando a marca integra os pedidos no status em aprovação.

### aprovado

a marca confirmou o pedido. em marca sem integração, é neste momento que o estoque reservado é consumido e que as divisões se tornam pedidos separados.

em marca integrada, o momento em que o pedido desce para o sistema de gestão é configurável, em **acionar integração**, na configuração da integração. a aprovação é um dos gatilhos possíveis, e não necessariamente o da sua marca.

o pedido aprovado deixa de aceitar alteração de itens.

### enviado

o pedido foi enviado, e o que "enviado" significa depende dos parâmetros da marca: em parte delas o pedido foi despachado, e em outras o status indica que ele integrou no sistema de gestão. em marca sem integração, é o último status do fluxo.

### cancelado

o pedido foi encerrado sem venda, e o estoque reservado é liberado.

pedido já integrado não aceita cancelamento direto. enquanto não está integrado, o cancelamento aceita volta: o admin da marca e o representante reabrem o pedido em rascunho.

### abandonado

o pedido em rascunho ficou inativo por mais tempo do que a marca configurou e foi movido automaticamente, o que libera o estoque reservado para outras lojas. o pedido abandonado aceita reabertura em rascunho.

### reprovado

o status chega por duas vias: a integração com o sistema de gestão recusa o pedido, ou o admin da marca usa a ação **reprovar pedido**, que aparece só em pedido aprovado e só para quem tem a permissão de reprovar.

o pedido não permanece nele: segue para cancelado ou volta para aprovado.

### sugerido

o pedido foi criado pela marca como sugestão e não percorre o fluxo comum. as transições convencionais não se aplicam, e o que a loja faz com ele é aceitar a sugestão, o que produz um pedido novo. mais em [criar pedidos sugeridos](/docs/pedidos/criar-pedidos-sugeridos-v2).

os valores de status do pedido e de status da integração estão reunidos em [referência de campos do pedido](/docs/pedidos/referencia-de-campos-do-pedido-v2).

## o que cada status permite

| status | aceita alteração de itens | estoque | quem move adiante |
| - | - | - | - |
| rascunho | sim | reservado | quem conduz o pedido |
| em revisão | sim | reservado | representante ou admin da marca |
| em aprovação | sim | reservado | admin da marca |
| aprovado | não | consumido | admin da marca |
| enviado | não | consumido | admin da marca |
| cancelado | não | liberado | reabertura em rascunho, sem integração |
| abandonado | não | liberado | reabertura em rascunho |

## o que muda ao sair do rascunho

sair do rascunho muda mais do que o status: na transição o pedido passa por uma revalidação inteira, e o preço unitário de cada item é congelado, o que impede que uma alteração de tabela posterior mude um pedido já em aprovação. os efeitos, um a um, estão em [finalizar pedidos](/docs/pedidos/finalizar-pedidos-v2).

## o status da integração

em marca integrada, o pedido carrega um segundo indicador, exibido ao lado do status do pedido. ele diz em que ponto está a conversa com o sistema de gestão: integrado, integrado e aguardando aprovação, sincronizado com erro no pagamento, ou erro.

os dois eixos se movem de forma independente. um pedido aprovado pode estar com erro de integração, e é essa combinação que explica por que ele não avança.

## onde ler o que aconteceu

a aba **atividades** reúne a linha do tempo do pedido, agrupada por dia.

ela registra quem moveu o pedido e para qual status, os eventos da integração com o sistema de gestão, e o motivo informado numa reprovação. cada evento pode trazer o valor, a contagem de itens e a de peças no momento em que aconteceu, mais um arquivo em CSV com a composição daquele instante.

é onde se responde quem alterou o pedido e quando, sem depender da memória de quem participou.

## conteúdos relacionados

<div className="relacionados">
  <CardGroup cols={1}>
    <Card title="finalizar pedidos" icon="file-lines" href="/docs/pedidos/finalizar-pedidos-v2" horizontal />

    <Card title="listagem de pedidos" icon="file-lines" href="/docs/pedidos/listagem-de-pedidos-v2" horizontal />
  </CardGroup>
</div>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.