ML Apontamento — Manual do Administrador

Produção Inteligente para Protheus

ML Apontamento é a solução de apontamento de produção de chão de fábrica da ML TECNOLOGIA, integrada nativamente ao ERP TOTVS Protheus (SIGAPCP). O operador aponta produção, paradas, refugo/perda e encerra Ordens de Produção diretamente em um terminal, e tudo é gravado no ERP em tempo real, pelas rotinas padrão do Protheus.

Este manual é voltado ao administrador / TI da planta. Ele explica de onde vem cada dado (operador, OP, roteiro, recurso, motivos, documentos), como instalar e integrar, como autenticar e como operar e auditar a solução.

Do que é feita a solução

flowchart LR
    subgraph CF[Chão de fábrica]
      T["Terminal PWA<br/>(kiosk / tablet / PC)"]
    end
    subgraph ERP[TOTVS Protheus]
      R["Endpoints REST TLPP<br/>apt001–apt030"]
      SIG["SIGAPCP<br/>SC2 · SG2 · SH1 · SH6 · CYN · CYO · SBC · SRA · AC9/ACB"]
      MLT["Tabelas próprias<br/>MLTEC_0051–0054"]
    end
    T -- "HTTPS + Bearer" --> R
    R -- "MSExecAuto (MATA681/685/250)" --> SIG
    R -- "sessões / pausas / auditoria" --> MLT

Componente	O que é	Onde roda
Terminal PWA	Aplicação web instalável (Material 3), perfil kiosk / standalone	Navegador do terminal, na LAN da fábrica
Endpoints REST TLPP	apt001–apt020, apt023, apt024, apt030 (self-register @Get/@Post)	Compilados na RPO do Protheus da planta
Tabelas MLTEC	MLTEC_0051 (sessões), 0052 (pausas), 0053 (credencial de serviço), 0054 (auditoria)	Banco de dados do Protheus
Integração SIGAPCP	Leitura de OPs/cadastros e gravação de apontamentos pelas rotinas padrão	Protheus

Sem hardware, sem servidor extra

A solução é 100% software. Não há sensores, dispositivos IoT ou servidor local dedicado — o backend roda no próprio Protheus da planta e o terminal é um navegador.

Por onde começar

• Cadastros e origem dos dados

  De onde vem o operador, a OP, o roteiro, o recurso, os motivos e os PDFs.

• Fluxo de apontamento

  Sessões, pausas, apontamento, refugo/perda, encerramento e estorno.

• Instalação do backend

  Compilar os .tlpp, rodar o DDL das tabelas e abrir o ambiente.

• Autenticação e appserver.ini

  OAuth2, conta de serviço na MLTEC_0053 e configuração do servidor REST.

---

Convenção de nomes

Neste manual, tabelas do Protheus (SC2, SG2, SH1, SH6, CYN, CYO, SBC, SRA, AC9, ACB…) seguem a nomenclatura padrão TOTVS. Tabelas próprias da solução usam o prefixo MLTEC_00xx. Endpoints são referidos por seu código (apt007, apt013…).

Este é um manual de produto (genérico). Onde aparecer CLIENTE (ex.: https://CLIENTE.mltecnologia.com.br) ou valores de exemplo (IPs, portas, empresa/filial), substitua pelos dados reais do ambiente no momento do deploy.