Árvore de páginas

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.                                                             

  

Informações Gerais

 

Especificação

Produto

DATASUL

Módulo

Chão de Fábrica

Segmento Executor

 

Projeto1

D_MAN_PCP002

IRM1

PCREQ-9590

Requisito1

PCREQ-10152 - DATASUL - Integração Cadastros Manufatura

Subtarefa1

 

Chamado2

 

País

( X ) Brasil  (  ) Argentina  (  ) Mexico  (  ) Chile  (  ) Paraguai  (  ) Equador

(  ) USA  (  ) Colombia   (  ) Outro _____________.

Outros

<Caso necessário informe outras referências que sejam pertinentes a esta especificação. Exemplo: links de outros documentos ou subtarefas relacionadas>.

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

Objetivo

Integração Cadastros Manufatura para integração do TOTVS-MES.

 

Definição da Regra de Negócio

RN001 - Quando a integração estiver ligada, ao criar um novo item ou modificar a estrutura do mesmo, verificar se o item integra (tabela param-integr-mes.idi-entidade = 2). Caso não exista registro na tabela, então todos os itens e estruturas serão considerados.

RN002 - Para seleção dos itens/estruturas válidos serão utilizados três campos: código do item, família material e grupo de estoque. Caso mais de um campo esteja preenchido na tabelas param-integr-mes, será considerado na busca o operador lógico "OU". Assim mesmo que um item tenha apenas um dos campos como verdadeiro ele será selecionado.

RN003 - O campo Rejeição é estrangeiro e obrigatório na inclusão de um Refugo.

RN004 - Quando a integração estiver ligada e o SFC - Chão de Fábrica não esteja implantado, apenas os dados referentes a: item, grupo de máquina, depósito, ordem de produção e estrutura podem ser integrados.

RN005 - Quando a integração estiver ligada e o SFC - Chão de Fábrica esteja implantado, além dos dados acima, também os dados referentes a: motivo de refugo, motivo de parada e centro de trabalho podem ser integrados.

RN006 - Quando o SFC - Chão de Fábrica estiver implantando e o tipo de reporte não seja por Item, as Ordens serão enviadas para integração apenas no momento da Liberação.

RN007 - Quando uma Ordem já esteja no Chão de Fábrica, e a situação for superior ou igual a Liberada, se a mesma for alterada, deve enviar atualização na mensagem XML.

RN008 - Recebimento da mensagem XML StopReason, para o motivo de parada.

RN009 - Recebimento da mensagem XML WasteReason para o motivo de refugo.

RN010 - Ordens com tipo de Reporte por Item, não serão integradas.

RN011 - Informar o tipo da linha de produção na ordem(Processo ou Serviço), para que o TOTVS-MES saiba quando pode devolver apenas as requisições, sem necessidade de apontamento da produção.

RN012 - Quando o item estiver relacionado a uma ou mais listas de componentes, não será integrada a estrutura.

RN013 - Quando o item estiver relacionado a um ou mais roteiros de fabricação, não será integrada a operação.

RN014 - Alocação de componentes, será atualizado juntamente com a mensagem de Ordem de Produção.

 


Rotina

Tipo de Operação

Opção de Menu

Regras de Negócio

EN0105 - Estrutura Item

[Alteração]

 

-

EN0109 - Onde se Usa Item

[Alteração]

 

-

SF0104 - Centro de Trabalho

[Alteração]

 

-

SF0106 - Motivo de Parada[Alteração]  
SF0107 - Motivo de Refugo[Alteração]  
CD0204 - Item[Alteração]Tratamento de Versionamento Mensagens e Adapter  
CDAPIItem - API de Item usado pelo WorkFlow de Item[Alteração]Tratamento de Versionamento Mensagens e Adapter  
BOMF510 - BO Motivo de Parada[Alteração]  
CDAPI990.i1 - API de Mensagem Erro[Alteração]Tratamento de Versionamento Mensagens e Adapter  
CPAPI301B - API Integração Ordem[Alteração]  
BOIN533 - LiberarOrdemSFC

[Alteração]

  
BOIN535 - Split[Alteração]  
CD0124 - Ferramentas[Alteração]  
SF0108 - Operador[Alteração]  
Alocação de Reservas (envio) CPAPI013[Alteração]  
cdapi344 api de item(importação) cd0209[Alteração]Tratamento de Versionamento Mensagens e Adapter  
EN0507 - Processo de Fabricação (Operações)[Alteração]  

 

Mensagens:

Validar a versão da mensagem nos adapters, para saber qual a fase da integração se refere.

TransaçãoDescriçãoOrigemDestinoXSD
04Centro de TrabalhoDatasulPPIMachine_1_000
05Motivo de ParadaPPIDatasulStopReason_1_000
06Motivo de RefugoPPIDatasulWasteReason_1_000
09Ordem de ProduçãoDatasulPPIProductionOrder_2_003
14Estrutura de ProdutoDatasulPPIItemStructure_1_001
15Roteiro de OperaçõesDatasulPPIItemScript_1_000
16FerramentaDatasulPPIResource_1_000
17OperadorDatasulPPIResource_1_000

 

Transação 04 - Centro de Trabalho: Machine_1_000

Campo XSDCampo ERPDescrição
Codectrab.cod-ctrabCódigo Máquina
Descriptionctrab.des-ctrabDescrição Máquina
WorkCenterCodectrab.gm-codigoCódigo Centro Trabalho
WorkCenterDescriptiongrup-maquina.descriçãoDescrição Centro Trabalho
ProcessorTypectrab.ind-tip-ctrabTipo Processamento
LaborTypectrab.ind-reporte-modTipo MOD
OperatorMachineQuantityctrab.num-operador-ctrabQuantidade Operador Máquina
SimultaneousActivityQuantityctrab.num-operac-simultQuantidade Operações Simultaneas
IsSetupctrab.log-possui-preparPossui Preparação
IsControlPertctrab.log-consid-event-antConsidera Evento Anterior
IsReportEventctrab.log-reporte-contadorReporta Contador

A função de centro de trabalho, quando alterarem qualquer registro, enviará a mensagem XML Machine_1_000.

 

Transação 05 - Motivo de Parada: StopReason_1_000

Campo XSDCampo ERPDescrição
Codemotiv-parada.cod-paradaCódigo Motivo Parada
Descriptionmotiv-parada.des-paradaDescrição Parada
IsEfficiencymotiv-parada.log-alter-eficienAltera Eficiência
IsEmailEquipmentmotiv-parada.log-mail-plandorE-mail Planejador
IsServiceRequestmotiv-parada.log-emite-ssEmite Solicitação Serviço
IsSetupmotiv-parada.parada-setupParada Setup

As funções de motivo de parada(BOMF510), motivo de refugo(SF0107), apenas receberão respectivamente a mensagem xml (StopReason_1_000, WasteReason_1_000). 

Criar adapters de Recebimento de mensagem para as tabelas de motivo de parada(BOMF510), motivo de refugo(No SF0107 o campo Rejeição é estrangeiro e obrigatório na inclusão. Definir qual será o padrão para este campo, caso o Refugo seja alimentado a partir do TOTVS-MES ao ERP).

Obs.: inserir nos programas que enviam mensagens a geração do log de erros (pi-exporta-mensagem da cdapi990), observando <param-cp.gera-log>, caso for zero(0-Nunca), não gera nada, se for um (1-Apenas erros), e três (3-Todos), gera sempre.


Transação 06 - Motivo de Refugo: WasteReason_1_000

Campo XSDCampo ERPDescrição
Codemotiv-refugo.cod-motiv-refugoCódigo Refugo
Descriptionmotiv-refugo.des-motiv-refugoDescrição Refugo
IsReworkmotiv-refugo.log-retrabalhoRetrabalho
IsScrapMaterialmotiv-refugo.log-materialRefugo Material

As funções de motivo de parada(BOMF510), motivo de refugo(SF0107), apenas receberão respectivamente a mensagem xml (StopReason_1_000, WasteReason_1_000). 

Criar adapters de Recebimento de mensagem para as tabelas de motivo de parada(BOMF510), motivo de refugo(No SF0107 o campo Rejeição é estrangeiro e obrigatório na inclusão. Definir qual será o padrão para este campo, caso o Refugo seja alimentado a partir do TOTVS-MES ao ERP).

Obs.: inserir nos programas que enviam mensagens a geração do log de erros (pi-exporta-mensagem da cdapi990), observando <param-cp.gera-log>, caso for zero(0-Nunca), não gera nada, se for um (1-Apenas erros), e três (3-Todos), gera sempre.

 

Transação 09 - Ordem de Produção: ProductionOrder_2_003 - Abaixo estão representados apenas os campos que foram inseridos na fase 2, os outros campos já estão considerados na fase 1.

Campo XSDCampo ERPDescrição
ListOfActivityOrders.ActivityCodequando na fase 1, usar o campo oper-ord.op-codigo, quando na fase 2 usar split-operac.num-operac-sfcCódigo da Operação (Oper-ord), Código Operação SFC
ListOfQuotaActivity.ActivityIDsplit-operac.num-operac-sfcCódigo Operação SFC
ListOfQuotaActivity.QuotaActivityIDsplit-operac.num-split-operacNr. do split
ListOfMaterialOrders.RequestTypelin-prod.sum-requisIdentifica se a requisição pode ser feita separadamente do reporte da produção, quando enviado:
Datasul - identifica o tipo de linha de produção utilizado (1-Serviço, 2 - Processo)
Protheus - identifica o tipo de apropriação do componente (1-Direta, 2-Indireta)
ListOfAllocatedMaterial.WarehouseCodealoca-reserva.cod-deposCódigo Depósito/Armazém
ListOfAllocatedMaterial.LotCodealoca-reserva.lote-serieLote/Série
ListOfAllocatedMaterial.LotDueDatelote.dt-validadeValidade Lote
ListOfAllocatedMaterial.LocationCodealoca-reserva.cod-localizLocalização/Endereço
ListOfAllocatedMaterial.ActivityCodealoca-reserva.op-codigoCódigo Operação
ListOfAllocatedMaterial.ScriptCodealoca-reserva.cod-roteiroCódigo Roteiro
ListOfAllocatedMaterial.AllocationQuantityaloca-reserva.quant-aloc quando não usa controle de potência, senão usa aloca-reserva.qt-aloc-loteQuantidade Alocada (Quantidade no ERP, deverá verificar se o tipo é AllocationType  1-Soma, 2-Diminui, 3-Absoluto)
ListOfAllocatedMaterial.AllocatedMaterialAllocationType3Como esta mensagem pode ser utilizada tanto para Alocação, quanto para Desalocação, informar o tipo torna a decisão do que fazer com a quantidade mais rápida.
1-Soma, 2-Diminui, 3-Absoluto

Ex.: Caso já tenha sido alocado 50 unidades do componente previsto na OP, e seja necessário desalocar uma parte, a mensagem poderá vir de duas formas.
40 unidades com Tipo 2, fará com que seja desalocada 40 unidades, restando apenas 10 unidades ainda alocadas na OP.
10 unidades com tipo 3, fará com que seja desalocada 40 unidades, restando exatamente 10 unidade ainda alocadas na OP.


A função de criar a Ordem de Produção(CPAPI301B), somente irá disparar a mensagem, se o SFC não estiver implantado ou o tipo de reporte da ordem NÃO for por item (param-global.modulo-ch = Não OU ord-prod.rep-prod < 4). Do contrário o disparo da mensagem de Ordem no SFC(BOIN533 - LiberarOrdemSFC, para as Ordens e para os Splits no LiberarSplit).

Mensagem XML ProductionOrder_2_002

Na alteração de split (alocação de split, divisão, etc), envio de mensagem a partir da BOIN535.

Na alocação de reserva da ordem(tanto manual, quanto automática) utilizar CPAPI013, mas usar a mesma mensagem de Ordem de Produção, como sendo alteração na mesma.


Transação 14 - Estrutura de Produto: ItemStructure_1_001

Campo XSDCampo ERPDescrição
ItemCodeestrutura.it-codigoCódigo do Item Pai
ItemAmountestrutura.qtd-itemQuantidade do Item Pai
ItemSequenceestrutura.sequenciaSequência de montagem do componente
ItemComponentCodeestrutura.es-codigoCódigo do Item Componente
InitialDateestrutura.data-inicioData em que o componente passa a ser válido na estrutura
FinalDateestrutura.data-terminoData em que o componente deixa de ser válido na estrutura
IsGhostMaterialestrutura.fantasmaIndica se a relação item x componente é fantasma ou não
ItemComponentAmountestrutura.qtd-componQuantidade do Item Componente
ItemComponentProportionestrutura.proporcaoIndica a proporção de uso de um componente
LossFactorestrutura.fator-perdaFator de perda do componente em relação a quantidade usada
ScriptCodeestrutura.cod-roteiroCódigo Roteiro - Este campo não precisa ser enviado nunca, pois não será integrado roteiro de operação. Deve apenas validar que o campo estrutura.cod-roteiro não tenha informação, pois caso tenha informação, não será enviado também o campo abaixo "ActivityCode".
ActivityCodeestrutura.op-codigoCódigo Operação

As funções de estrutura (EN0105, e EN0109) sempre que alterarem algum componente da estrutura de um item, filtrarão por <param-integr-mes.idi-entidade> = 2, para envio da mensagem xml (ItemStructure_1_001), e enviarão a estrutura completa do item. 

Ex.: 

 

ItemFamíliaGrupo Estoque
CanetaEscritórioVenda
CorpoEscritórioGeral
TampaPlásticosPlásticos
TuboPlásticosPlásticos
CargaProdutoProcessoGeral
PontaCompradoGeral
TintaCompradoGeral

 

Apenas o filtro de Família foi indicado (família = "Escritório"), nesta caso quando for alterada algum componente da Caneta, como este item é da família indicada, será gerada uma mensagem com todos os seus componentes (Corpo e Tampa) mesmo que a família dos componentes não seja a mesma.

Obs.: Os campos que serão usados para filtrar estrutura a partir do item: <it-codigo>, <ge-codigo> e <fm-codigo> (igualar com <param-integr-mes.cod-campo>). Lembrando que apenas os componentes diretos serão selecionados para envio na mensagem.

 

Transação 15 - Roteiro de Operações: ItemScript_1_000

Campo XSDCampo ERPDescrição
ItemCodeoperacao.it-codigoCódigo Item
ItemDescriptionitem.desc-itemDescrição Item
ScriptCodeoperacao.cod-roteiroCódigo Roteiro - Este campo não precisa ser enviado nunca, pois não será integrado roteiro de operação.
ScriptDescriptionrot-fabric.descricaoDescrição Roteiro
ListOfActivity  
ActivityCodeoperacao.op-codigoCódigo Operação
ActivityDescriptionoperacao.descricaoDescrição Operação
WorkCenterCodeoperacao.gm-codigoCódigo Centro de Trabalho
ActivityTypeoperacao.tipo-operTipo Operação
InitialDateoperacao.data-inicioData Início
FinalDateoperacao.data-terminoData Fim
PercentageScrapValueoperacao.refugo-op% Refugo
PercentageValueoperacao.proporcaoProporção
UnitItemNumberoperacao.nr-unidadesUnidades
TimeResourceoperacao.tempo-homemTempo Recurso
TimeMachineoperacao.tempo-maquinTempo Máquina
TimeSetupoperacao.tempo-preparTempo Preparação
UnitTimeTypeoperacao.un-med-tempoTipo Unidade Tempo
ResourceQuantityoperacao.numero-homemQuantidade Recurso
UnitActivityCodeoperacao.cod-un-operacCódigo Unidade Operação
ActivityItemValueoperacao.val-operac-itemRelação Operação/Item
 ListOfPertOrders  
NextActivityIDrede-pert.num-id-operacao-sucessID Operação Sucessora
ActivityCoderede-pert.op-codigoCódigo Operação
PreviousActivityIDrede-pert.num-id-operacao-predecID Operação Predecessora
PreviousActivityCoderede-pert.op-predecesCódigo Operação Predecessora
TimeTransportrede-pert.transporteTempo Transporte
PercentageOverlapValuerede-pert.overlap% Overlap
OverlapQuantityrede-pert.qtd-overlapQuantidade Overlap

A função de operação (EN0507) sempre que alterar, seja a rede-pert ou alguma operação de um item, filtrarão por <param-integr-mes.idi-entidade> = 2, para envio da mensagem xml (ItemScript_1_000). Ao ser alterado uma operação do item, caso este item tenha sido filtrado, então todas as operações deste deverão ser passadas à mensagem.

Obs.: Os campos que serão usados para filtrar operações a partir do item: <it-codigo>, <ge-codigo> e <fm-codigo> (igualar com <param-integr-mes.cod-campo>)


Transação 16 - Ferramenta: Resource_1_000

Campo XSDCampo ERPDescrição
Codeferr-prod.cod-ferr-prodCódigo Recurso
Type2Tipo Recurso
Nameferr-prod.des-ferr-prodNome Recurso
UnitCycleQuantityferr-prod.un-cicloUnidades Ciclo
ToolCodeferr-prod.it-codigoCodigo Item Ferramenta
ToolDescriptionitem.desc-itemDescricao Item Ferramenta
StartExpirationDateData AtualNão usado no Datasul, mas PPI precisa
EndExpirationDateData AtualNão usado no Datasul, mas PPI precisa


Transação 17 - Operador: Resource_1_000

Campo XSDCampo ERPDescrição
Codeoperador.cod-operadorCódigo Recurso
Type1Tipo Recurso
Nameoperador.nom-operadorNome Recurso
ProductionAreaCodeoperador.cod-area-producCodigo Area Producao
ProductionAreaDescriptionarea-produc.des-area-producDescricao Area Producao
ProductionShiftNumberoperador.num-turnoNumero Turno
LaborCodeoperador.cd-mob-dirCodigo Mao de Obra Direta
StartExpirationDateoperador.dat-inic-validData Inicio Validade
EndExpirationDateoperador.dat-fim-validData Fim Validade


Protótipo de Tela

 

Inserir na CDAPI990.i1(pi-exporta-mensagem) a validação de somente exportar quando o parâmetro esteja ativo(param-cp.gera-log-erro).

Corrigir os programas que estão comentados para chamada da pi-exporta-mensagem:

invwr\v01in084.w
invwr\v16in144.w
invwr\v34in172.w

As funções de item (cd0204 e cdapiitem e cd0209) sempre que criarem um novo item ou alterarem um já existente, filtrarão por <param-integr-mes.idi-entidade> = 2, para envio da mensagem xml. 

 

Fluxo do Processo

Diagrama de Atividades do Processo de Seleção da Estrutura, Operação e Item



Diagrama de Sequência da Integração TOTVS-MES


As sequências 7, 8 e 13, que estão representadas em Verde, no diagrama acima, foram criadas na 1.a fase da integração, mas sofrerão alterações na 2.a fase.

 

 

 


[1] Nome Verbalizado é obrigatório para desenvolvimentos no Datasul 10 em diante.

[2] Tipo é obrigatório para desenvolvimento no Datasul 10 em diante

[3] Categorias são obrigatórias para os programas FLEX.

[4] Obrigatório quando o projeto for FLEX

[5] Obrigatório quando o projeto for FLEX

[6] Obrigatório quando o projeto for FLEX

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.