# O que este sistema faz?
Imagine que uma loja da franquia faz um pedido de produtos para a matriz. O pedido é registrado no sistema. Depois, conforme os produtos chegam na loja, o sistema registra o que foi recebido.
Este módulo acompanha essa história e responde quatro perguntas importantes:
- **1. Quanto foi pedido?** — A quantidade total de cada produto no pedido.
- **2. Quanto já chegou?** — A quantidade que a loja já recebeu.
- **3. Quanto ainda falta?** — A diferença entre o pedido e o recebido que ainda pode chegar.
- **4. Quanto foi cortado?** — A parte do pedido que a matriz decidiu não enviar mais (quando o item tem corte).
Figura 2 — Dois exemplos com o mesmo pedido (10) e recebimento (7): sem corte ficam 3 pendentes; com corte ficam 3 cortadas e 0 pendentes.
## Quando isso acontece?
O processo roda **automaticamente**, sem que ninguém precise clicar em botões. Ele verifica se há pedidos novos ou alterados desde a última vez que rodou e atualiza as informações.
**Analogia:** é como um carteiro que passa na loja todo dia, olha a lista de pedidos, anota o que mudou e leva a informação atualizada para o OneBeat.
## O que acontece com pedidos cancelados ou abertos?
Se um pedido for **cancelado**, o sistema marca o registro como *inativo* (`INATIVO = 1`) e informa ao OneBeat que ele **não está confirmado** (`CONFIRMADO = 0`). O registro permanece na tabela, mas com a data de exclusão preenchida.
Se o pedido ainda estiver **aberto** (não finalizado), ele também fica com `CONFIRMADO = 0`, indicando que ainda não está apto para consumo pelo OneBeat. Diferente do cancelado, o registro **não** é marcado como inativo.
Figura 3 — Pedidos cancelados ficam inativos; pedidos abertos ficam não confirmados para o OneBeat.
## E quando parte do pedido é cortada?
**Corte de item:** quando a matriz decide não enviar mais uma parte do pedido (por exemplo, faltou estoque), o sistema registra essa quantidade em `QTDE_CORTADA` em vez de deixá-la como pendente. Assim o OneBeat sabe que aquela diferença não vai mais chegar.
## O que o usuário vê na tela?
A tela do módulo (`visual.html`) mostra apenas uma mensagem de confirmação: **"Carregado onebeat\_pedidos\_faturados com sucesso!"**. Não há formulários nem botões para o usuário comum.
**Para o diretor de T.I.:** a interface é mínima por design. O valor do módulo está na rotina `executar()`, executada via agendador (cron) ou chamada direta à URL `/bibliotecas/6b5b2af8-ab25-4135-9551-b3cb3e055f1a/onebeat_pedidos_faturados/executar`.