Glossário e referência rápida
Termo Definição OneBeat Sistema externo de gestão de estoque e abastecimento que consome os dados desta tabela. ERP / ISNAPP Sistema principal da empresa onde os pedidos são criados e os recebimentos registrados. Pedido faturado Pedido de produtos emitido pela matriz para uma loja, com nota fiscal associada. Recebimento Registro de que a loja recebeu (ou parte de) um pedido. Fica ligado ao pedido original. Filial / Loja Unidade da franquia que faz o pedido e recebe os produtos. SKU Código único do produto (como um "RG" do item no estoque). Grade Variação do produto (tamanho, cor). Exemplo: camiseta azul tamanho M. Ponteiro de execução Data/hora da última sincronização bem-sucedida. O sistema só busca pedidos alterados depois dessa data. Lock (trava) Mecanismo que impede duas cópias do programa de rodar ao mesmo tempo. CTE (Common Table Expression) Técnica SQL que organiza a consulta em etapas nomeadas (m, mi, mr, mri). ON DUPLICATE KEY UPDATE Comando SQL que insere um registro novo ou atualiza se ele já existir (pela chave primária). Biblioteca ISNAPP Módulo extensível do ERP, identificado por um token UUID único. Tenant / Banco dinâmico Cada cliente/franquia tem seu próprio banco de dados ({banco}), separado dos demais. Stage (integrador) Área intermediária de integração com sistemas externos, como o LX. NF-e / CHAVE_NFE Nota Fiscal Eletrônica. A chave é o número de 44 dígitos que identifica a nota. INATIVO Flag int (0/1) que indica se o registro está inativo. Substitui o antigo campo
SITUACAO. Valor 1 para pedidos cancelados.
CONFIRMADO
Flag int (0/1) que indica se o pedido está apto para consumo pelo OneBeat. Zero para pedidos cancelados ou abertos.
QTDE_CORTADA
Quantidade cortada de um item — parte do pedido que não será mais entregue.
pedido_corte_item
Flag nos itens do pedido (movimentacao_detalhe). Quando igual a 'S', a diferença entre pedido e recebido vai para QTDE_CORTADA em vez de QTDE_PENDENTE.
DATA_EXCLUSAO_MOVIMENTACAO
Data em que o pedido foi cancelado ou excluído no ERP. Preenchida apenas para pedidos cancelados.
URLs do módulo
| Função | URL |
|---|---|
| Tela visual | /bibliotecas/6b5b2af8-ab25-4135-9551-b3cb3e055f1a/onebeat_pedidos_faturados |
| Execução ( |
/bibliotecas/6b5b2af8-ab25-4135-9551-b3cb3e055f1a/onebeat_pedidos_faturados/ |
| Instalação | /bibliotecas/6b5b2af8-ab25-4135-9551-b3cb3e055f1a/onebeat_pedidos_faturados/install |
Checklist de implantação (T.I.)

Figura 15 — Checklist recomendado para implantação do módulo.
Resumo dos arquivos
| Arquivo | Classe | Responsabilidade |
|---|---|---|
controle.php |
onebeat_pedidos_faturados |
Sincronização de pedidos |
instalador.php |
instalador |
Criação de banco e tabela |
visual.html |
— | Mensagem de carregamento |
Identificadores do módulo
| Propriedade | Valor |
|---|---|
| Token | 6b5b2af8-ab25-4135-9551-b3cb3e055f1a |
| Classe | onebeat_pedidos_faturados |
| CoreVersion | 3 |
| Banco destino | franquia_osklen_relatorio |
| Tabela destino | franquia_1beat |
| Procedure no log | franquia_1beat |
Dúvidas frequentes:
- "O sistema não atualizou meu pedido" — verifique se o agendamento do
está ativo e se o pedido tem data maior que o ponteiro.run(executar() - "Apareceu erro de processo em execução" — aguarde a execução anterior terminar ou verifique se há lock órfão em
/tmp/{banco}.onebeat_pedidos_faturados_executar.lock. - "Pedido cancelado ainda aparece" — na próxima execução ele será marcado
DESATIVOcomINATIVO = 1eremovido.CONFIRMADO = 0. O registro permanece na tabela com a data de exclusão preenchida.
CONFIRMADO = 0, indicando que ainda não está apto para consumo.
Índice da documentação
| # | Capítulo | Arquivo |
|---|---|---|
| 01 | Introdução | 01_introducao.html |
| 02 | O que faz | 02_o_que_faz.html |
| 03 | Instalação | 03_instalacao.html |
| 04 | Arquitetura | 04_arquitetura.html |
| 05 | Fluxo de execução | 05_fluxo_execucao.html |
| 06 | Processamento de dados | 06_processamento_dados.html |
| 07 | Estrutura da tabela | 07_estrutura_tabela.html |
| 08 | Regras de negócio | 08_regras_negocio.html |
| 09 | Glossário | 09_glossario.html |