Glossário e referência rápida

: One Beat
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.

URLs do módulo

Função	URL
Tela visual	`/bibliotecas/6b5b2af8-ab25-4135-9551-b3cb3e055f1a/onebeat_pedidos_faturados`
Execução (run)	`/bibliotecas/6b5b2af8-ab25-4135-9551-b3cb3e055f1a/onebeat_pedidos_faturados/run`
Instalação	`/bibliotecas/6b5b2af8-ab25-4135-9551-b3cb3e055f1a/onebeat_pedidos_faturados/install`

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

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

Dúvidas frequentes:

"O sistema não atualizou meu pedido" — verifique se o agendamento do run() 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/.
"Pedido cancelado ainda aparece" — na próxima execução ele será marcado DESATIVO e removido.