Pular para conteúdo

Cadastros e origem dos dados

Tudo o que aparece no terminal de apontamento vem do Protheus (nenhum cadastro é feito no ML Apontamento). Esta página mostra, para cada conceito, qual tabela o alimenta, o campo-chave, onde se cadastra no ERP e qual endpoint o lê.

Mapa geral

Conceito Tabela Protheus Campo-chave Onde cadastrar (Protheus) Endpoint(s)
Operador SRA (Funcionários / mão de obra) RA_MAT (matrícula), RA_NOME Recursos Humanos / Gestão de Pessoal (Funcionários) apt003 (busca)
Ordem de Produção (OP) SC2 C2_NUM+C2_ITEM+C2_SEQUEN (OP de 11 díg.), C2_PRODUTO, C2_DATRF (encerra), C2_STATUS SIGAPCP → Ordens de Produção (MATA650) / geração pelo MRP apt014, apt001, apt016
Roteiro / Operação SG2 G2_PRODUTO, G2_CODIGO (operação), G2_DESCRI SIGAPCP → Roteiro / Operações (PCPA124) apt001, apt010
Recurso SH1 H1_CODIGO (6 caracteres), H1_DESCRI SIGAPCP → Recursos (MATA610) apt002
Produto SB1 B1_COD, B1_DESC, B1_UM Cadastros → Produtos (MATA010) apt016, apt001
Insumos / empenho SD4 D4_COD, D4_QUANT Empenho Múltiplo (MATA381) apt019
Motivo de Parada CYN CYN_CDSP (código), CYN_DSSP (descrição) SIGAPCP → SFCA004 (Motivos de Parada) apt015
Motivo de Refugo / Perda CYO CYO_CDRF (código), CYO_DSRF (descrição) SIGAPCP → SFCA003 (Motivos de Refugo/Perda) apt017
Documento / Desenho (PDF) AC9 + ACB AC9_CODENT, AC9_CODOBJ; ACB_OBJETO, ACB_DESCRI Gestão do Conhecimento (GED) apt023

E o que é gravado de volta no Protheus:

O que o operador faz Onde grava Rotina MSExecAuto
Aponta produção SH6 (apontamentos de produção) MATA681 (apt007)
Aponta refugo/perda SBC (com BC_MOTIVO = motivo CYO) MATA685 (apt018)
Encerra a OP SC2 (C2_DATRF) MATA250 (apt013)

Detalhe por cadastro

Operador → SRA

O operador que se identifica no terminal é um funcionário da tabela SRA (mão de obra). A identificação usa a matrícula (RA_MAT); o nome exibido vem de RA_NOME.

  • Cadastro: módulo de Recursos Humanos / Gestão de Pessoal → Funcionários.
  • Busca no terminal: apt003 (SELECT TOP 20 SRA.RA_MAT, ... FROM SRA).
  • Validação: U_ApValOperador aceita 1–14 caracteres alfanuméricos (matrícula).

O operador não é um usuário do Protheus

O login da API é uma conta de serviço (ver Autenticação). O operador apenas se identifica pela matrícula no corpo das requisições — não há senha de operador nem usuário no SIGACFG.

Ordem de Produção → SC2

As OPs disponíveis para apontamento vêm de SC2. O número da OP tem 11 dígitos (C2_NUM + C2_ITEM + C2_SEQUEN).

  • Cadastro/geração: SIGAPCP → Ordens de Produção (MATA650) ou geradas pelo MRP.
  • Abertas no terminal: apt014 lista as OPs abertas (join SB1 para descrição).
  • Encerramento: uma OP com C2_DATRF preenchido está encerrada — o backend bloqueia novas escritas nela (guard U_ApOpFechada).

Roteiro / Operação → SG2

Cada OP tem um roteiro com uma ou mais operações (ex.: 0010, 0020). Vêm de SG2 (G2_CODIGO = operação, G2_DESCRI = descrição), amarradas ao produto (G2_PRODUTO).

  • Cadastro: SIGAPCP → Roteiro / Operações (rotina PCPA124).
  • No terminal: apt001 lista as operações da OP; apt010 usa SG2 para descrever a operação no histórico.

Recurso → SH1

O recurso (máquina/centro) tem 6 caracteres (H1_CODIGO) e descrição H1_DESCRI.

  • Cadastro: SIGAPCP → Recursos (rotina MATA610).
  • No terminal: apt002 lista os recursos.
  • Validação: U_ApValRecurso (1–6 caracteres).

Motivo de Parada → CYN

Ao registrar uma parada, o operador escolhe um motivo da tabela CYN (CYN_CDSP / CYN_DSSP).

  • Cadastro: SIGAPCP → SFCA004 (Motivos de Parada/Setup).
  • No terminal: apt015 monta a lista de motivos de parada.

Motivo de Refugo / Perda → CYO (grava em SBC)

Ao registrar refugo/perda, o motivo vem de CYO (CYO_CDRF / CYO_DSRF). O apontamento de perda é gravado em SBC (campo BC_MOTIVO), via MATA685.

  • Cadastro: SIGAPCP → SFCA003 (Motivos de Refugo/Perda).
  • No terminal: apt017 lista os motivos; apt018 grava a perda; apt020 mostra o histórico (join SBC × CYO × SB1 × SRA).

Documento / Desenho (PDF) → AC9 + ACB

Os PDFs (desenhos, instruções de trabalho) exibidos na base de conhecimento do terminal vêm da Gestão do Conhecimento (GED) do Protheus: o cabeçalho em AC9 e o objeto/anexo em ACB.

  • Cadastro: anexe o documento na Gestão do Conhecimento, vinculado à entidade (produto/operação).
  • No terminal: apt023 retorna os documentos vinculados já em BASE64 (AC9_CODENT, ACB_CODOBJ, ACB_OBJETO, ACB_DESCRI + conteúdo), e o visualizador (pdf.js) renderiza.

Documento sem anexo válido

Se o objeto não tiver conteúdo BASE64 válido, o apt023 retorna a linha vazia e o front ignora o documento — não derruba a tela. Garanta que o anexo esteja realmente presente no GED.

Resumo rápido das dúvidas mais comuns

  • Operador vem de onde? Da tabela SRA (funcionários), pela matrícula RA_MAT.
  • Motivo da perda, qual tabela / onde cadastra? CYO, cadastrada em SFCA003; a perda grava em SBC.
  • Motivo de parada? CYN, cadastrada em SFCA004.
  • Roteiro de operações? Tabela SG2, cadastro na rotina PCPA124.
  • Recurso, qual rotina/tabela? Tabela SH1, rotina MATA610.
  • Insumos / empenho? Tabela SD4, cadastro pelo Empenho Múltiplo (MATA381).
  • O PDF vem de onde? Da Gestão do Conhecimento (GED) — tabelas AC9/ACB, via apt023.
  • Quais tabelas MLTEC? MLTEC_0051 a 0054 — ver Tabelas e rotinas.