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 (executar)	`/bibliotecas/6b5b2af8-ab25-4135-9551-b3cb3e055f1a/onebeat_pedidos_faturados/executar`
Instalação	`/bibliotecas/6b5b2af8-ab25-4135-9551-b3cb3e055f1a/onebeat_pedidos_faturados/install`

Checklist de implantação (T.I.)

Checklist recomendado para implantação do módulo.

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 executar() está ativo e se o pedido tem data maior que o ponteiro.
"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 com INATIVO = 1 e CONFIRMADO = 0. O registro permanece na tabela com a data de exclusão preenchida.
"Pedido aberto aparece no OneBeat" — o registro existe na tabela, mas com 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`