# 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 três 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.

![Exemplo prático: a loja pediu 10 camisetas, recebeu 7, e o sistema registra que faltam 3.](https://kb.illimitar.pro/uploads/images/gallery/2026-06/embedded-image-qrc9hzbf.png)

Figura 2 — Exemplo prático: a loja pediu 10 camisetas, recebeu 7, e o sistema registra que faltam 3.

## 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.

<div class="caixa-simples" id="bkmrk-analogia%3A-%C3%A9-como-um-">**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.</div>## O que acontece com pedidos cancelados?

Se um pedido for **cancelado** ou ainda estiver **aberto** (não finalizado), o sistema marca esses registros como *desativados* e depois os remove da tabela de envio ao OneBeat.

![Apenas pedidos finalizados permanecem ativos na tabela enviada ao OneBeat.](https://kb.illimitar.pro/uploads/images/gallery/2026-06/embedded-image-6o9sfn1m.png)

Figura 3 — Apenas pedidos finalizados permanecem ativos na tabela enviada ao OneBeat.

## 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.

<div class="caixa-tecnica" id="bkmrk-para-o-diretor-de-t.">**Para o diretor de T.I.:** a interface é mínima por design. O valor do módulo está na rotina `run()`, executada via agendador (cron) ou chamada direta à URL `/bibliotecas/6b5b2af8-ab25-4135-9551-b3cb3e055f1a/onebeat_pedidos_faturados/run`.</div>