Glossário e referência rápida
Glossário e referência rápida
Capítulo 9 — Termos, URLs e checklist para suporte
Glossário
- 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.
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 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
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.
Í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 |