Integração EME4 e SEED.

  

A integração EME4 e SEED contempla três movimentações principais:

• Transferência de estoque/saída do almoxarifado.
• Entrada de produção e;
• Estorno da entrada de produção.

Estas movimentações geram documentos no EME4 que, por sua vez, estão relacionadas a duas tarefas agendadas:

1. Comunicação do EME4 com o SEED através de APIs: tarefa agendada que consulta dados do SEED incluindo-os em tabelas “tanquinho” no EME4;
2. Processo de integração que irá gerar as movimentações/documentos no EME4.

 

Agendar Tarefa

Na tela [ Tarefas Agendadas ] é possível visualizar quatro tarefas que fazem a comunicação com as APIs no SEED e são pertencentes à família [ IntegraControleProducaoSEED ].

Tarefas de ordens de produção:

    1. Comunicação API SEED – Ordens de Produção
    2. Integrar SEED x EME4 – Ordens de Produção

Tarefas de requisições de compras:

   3. Comunicação API SEED – Requisições de Compra
   4. Integrar SEED x EME4 – Requisições de Compra

Aba Parâmetros

| O método [ Comunicação API’s SEED + Integração/Importação Produção SEED x EME4 ] unifica os dois métodos anteriores, isto é, efetua a comunicação com o SEED (gravando dados nas tabelas temporárias do EME4) e, em seguida, realiza efetivamente a integração das informações no EME4.

O processo é executado do início ao fim independente da ocorrência de erros (que são registrados em Logs Integração SEED x EME4) ou não.

Na tarefa agendada é possível selecionar o [ Tipo Execução ], ou seja, configurar que a execução da comunicação com as APIs SEED levará em conta [ Requisição de Compras ], [ Ordens de Produção ], [ Ambos ] ou [ Ficha Materiais ].

| Ambos = Requisição de Compras + Ordens de Produção.

Além disso, pode-se também informar [ Qdade Dias Movimentação ] e [ Qdade Dias Modificação Movimentação ], isto é, considerando a data atual, quantos dias devem ser retrocedidos e, portanto, quais movimentações e alterações de movimentações devem ser trazidas do SEED para a tabela “tanquinho” do EME4.

| Caso os campos [ Qdade Dias Movimentação ] e [ Qdade Dias Modificação Movimentação ] estejam com “0” (zero) a tarefa agendada considerará a configuração padrão do SEED constante em Integração Exterma > Integração SEED > Configurar Integrações SEED.

Exemplo Tarefa Agendada – IntegraSEED_FinalMes_Ajustes

| A tarefa agendada IntegraSEED_FinalMes_Ajustes é útil caso não haja registro de estorno de um apontamento para uma OP, gerando erro de finalização da integração da OP e, portanto, quantidades produzidas divergentes.

| Nesta tela é possível, também, [ Publicar Views Padrão ]. Recomenda-se fazer backup das views antes de confirmar esta operação, pois as views alteradas manualmente (alterações efetuadas) serão sobrescritas/perdidas.

CONTACT
Select em identificações (MTMG_IDENT) dos papéis cliente e fornecedor que estejam ativos.

STORAGE
Select em almoxarifados (M3_ALMOX) ativos.

MATERIAL
Select em produtos (M3_PROD) que contenham papel produção e/ou composição com unidade padrão do papel.

MATERIALGROUP
Select em grupos de produtos (M3_FAMGRUPO) que contenham papel produção e/ou composição com unidade.

SALESORDER
Select em pedidos de vendas em aberto ou parciais e confirmados.

PURCHASEORDER
Select em ordens de compras em aberto ou parciais e confirmadas.

MATERIALSTOCK
Select em saldo produto por produto, almoxarifado e lote.

 

Configurar Integrações SEED

Endpoints/URLs

Ao final de cada URL existe uma tag pré-definida entre colchetes: DATETIME, NUMBEROFDAYSISSUEDATE, RELEASEDDATE, entre outras.

Estas tags são “variáveis” e, portanto, possuem valores diferentes a cada execução da tarefa agendada/comunicação com o SEED sendo preenchidas pelo próprio sistema.

 

Domínio

As URLs não precisam ser digitadas manualmente podendo-se clicar em [ Ações ], [ Publicar URL APIs SEED ].

É importante lembrar, no entanto, que após executar a publicação, o dominio_aplicacao de todas as URLs deve ser alterado conforme o cliente.

Exemplo:

http://dominio_aplicacao/Api-v2/PurchaseRequests/GetWithPO/1,2,3,4,5?dateTime=[DATETIME]

http://industriaceni.seedaps.com/Api-v2/PurchaseRequests/GetWithPO/1,2,3,4,5?dateTime=2020-05-20

| 1. Ambiente de Teste/Homologação x Produção
O domínio da aplicação do cliente deve ser configurado conforme o ambiente que se deseja acessar. Sendo assim, esses domínios serão diferenciados para teste/homologação e produção.

Exemplos:

http://industriaceni.homologacao.seedaps.com/Api-v2/PurchaseRequests/GetWithPO/1,2,3,4,5?dateTime=2020-05-20

http://industriaceni.producao.seedaps.com/Api-v2/PurchaseRequests/GetWithPO/1,2,3,4,5?dateTime=2020-05-20

| 2. Cópia da base Produção para Teste/Homologação
Quando a base de produção for copiada para o ambiente de teste/homologação. Neste caso, após copiá-la – e conforme se queira buscar os dados na produção ou teste/homologação – deve-se fazer o ajuste do dominio_aplicacao.

 

Tipos de Documento

Após informar o domínio da aplicação nas URLs, deve-se selecionar os tipos de documentos a serem utilizados nas transferências de estoque/saídas de almoxarifado, entrada da produção e estorno de entrada da produção: [ Tipo Docto Transf. Saída ], [ Tipo Docto Entrada Produção ] e [ Tipo Docto Estorno Produção ].

Aba Correlações Almox./Func. X Recursos SEED

Tabelas EME4

As informações obtidas no SEED são inseridas nas seguintes tabelas do EME4: 

• SEED_PURCHASEREQUESTS (requisições de compras);
• SEED_PLANNEDORDERS (cabeçalho);
• SEED_PRODUCTIONEVENTS (eventos);
• SEED_MATERIALSBOM (materiais);
• SEED_STOCKMOVEMENTS (perdas e sobras);
• SEED_INTEGRATING (controle de execução).

 

SEED_PURCHASEREQUESTS

SEED_PLANNEDORDERS

SELECT * FROM SEED_PLANNEDORDERS

A tabela SEED_PLANNEDORDERS é preenchida pela URL API Ordens de Produção (Abertura), URL API Ordens de Produção (Modificação) e URL API Ordens de Produção (Liberação) e nela são listadas as informações do cabeçalho da ordem de produção.

Campos:  PLANNEDORDERID (número da OP), MATERIALID/MATERIALNAME (código/nome do material), QUANTITY (quantidade),  YIELDED (quantidade produzida), STATUSID (status da OP -1 – Requisitada, 0 – Não planejada, 1 e 2 – Planejada, 3 – Liberada, 4 – Em Produção, 5 – Interrompida, 6 – Cancelada, 7 – Finalizada e 8 – Parada), entre outros.

| SEED_PLANNEDORDERS é utilizada para transferências de materiais/estoque.

 

SEED_PRODUCTIONEVENTS

SELECT * FROM SEED_PRODUCTIONEVENTS WHERE PLANNEDORDERID = ‘18618‘

Na tabela SEED_PRODUCTIONEVENTS são listados os eventos da ordem de produção (transferências de componentes, apontamentos, movimentações de estoque, cancelamentos, finalizações, entre outros).

Campos: PLANNEDORDERID (número da OP), PLANNEDORDERPRODUCTIONID (número do evento), STATUSID (status do evento),

| O campo [ STATUSID ] pode ser facilmente consultado em Integração Externa > Integração SEED > Configurar Integrações SEED, aba [ Correlações Status SEED ]. Na grid tem-se os status utilizados pelo SEED e seus correspondentes no EME4.  Ex.: STATUSID = -1 no SEED refere-se a situação Requisitada no EME4, STATUSID = 0 = Não planejada, STATUSID = 1 = Planejada, e assim por diante.

SEED_PRODUCTIONEVENTS com STATUSID = 4 é utilizada para entrada de produção/estorno de entrada de produção;

SEED_PRODUCTIONEVENTS com STATUSID = 7 é utilizada para finalização da OP

| A finalização de uma OP envolve inúmeras verificações, tais como, entrada do material/componente/matéria-prima processado (se na tabela SEED_MATERIALSBOM, campo [ QUANTITY ] = valor negativo), movimentação/acerto de pequenos valores/resquícios de matéria-prima em decorrência dos cálculos da produção serem feitos de maneira proporcional, entre outras.  

É importante ressaltar que todo apontamento no SEED é listado na tabela SEED_PRODUCTIONEVENTS que, após a integração, é importado para o EME4 como uma Entrada de Produção. Caso, logo após a integração, o usuário acessar o SEED e reverter esta Entrada da Produção, um novo registro com o ID da entrada de produção origem que foi revertida será incluído na tabela SEED_PRODUCTIONEVENTS. Assim, ao comunicar com o EME4, será incluído um Estorno de Entrada da Produção baseado nesse registro, alterando então o status da entrada de produção no EME4 para ISREVERTED.

 

SEED_MATERIALSBOM

Na tabela SEED_MATERIALSBOM são listados os materiais/componentes/matérias-primas da ordem de produção.

Campos: PLANNEDORDERID (número da OP), COMPONENTMATERIALID (código do material), QUANTITY (quantidade), entre outros.

| A tabela SEED_MATERIALSBOM não possui o campo [ INTEGRATEDAT ] porque a alteração de materiais atualizará o campo [ LASTMODIFIEDDATE ] da tabela SEED_PLANNEDORDERS. Uma vez este campo estando preenchido com dia/mês/ano hh:mm:ss, o sistema executará/consumirá o novo material/componente/matéria-prima da referida OP.

| O campo [ QUANTITY ] = valor negativo refere-se a material/componente/matéria-prima processada que foi gerada ao final do processo de produção. Esta “sobra” de material ou material semiacabado não será consumido e gerará, portanto, uma entrada no estoque.

| SEED_MATERIALSBOM é utilizada para transferências de materiais/estoque.

 

SEED_STOCKMOVEMENTS

SELECT * FROM SEED_STOCKMOVEMENTS WHERE PLANNEDORDERID = ‘18618‘

Na tabela SEED_STOCKMOVEMENTS são listadas as sobras/pedras de materiais da ordem de produção. Ex.: em um OP com  MOVEMENTTYPESTRING = Leftover (Sobra) e QUANTITY = 20 é realizada a integração no EME4 (entrada na produção, baixa da matéria-prima e transferência de estoque).

| SEED_STOCKMOVEMENTS é utilizada para transferências de materiais/estoque (sobras/perdas geradas pela Produção/SEED).

 

SEED_INTEGRATING

SELECT * FROM SEED_MATERIALSBOM WHERE PLANNEDORDERID = ‘18618‘

Na tabela SEED_INTEGRATING não é atualizada diretamente por nenhuma tarefa agendada e seu objetivo é mostrar se a ordem de produção está sendo executada/em consumo (ou não) e, a partir daí, evitar que os registros das OPs sejam consumidos em paralelo, ou seja, que registros sejam utilizados por mais de um processo ao mesmo tempo.

Campos: ID (número da OP), ININTEGRATING (True/False) e STARTEDDAT/ENDEDAT (dd/mm/aa hh:mm:ss).

Quando ININTEGRATING = T, o campo ENDEDDAT é NULL, isto porque como a ordem de produção está em execução não há ainda data/hora de término.

Ao executar uma tarefa agendada é verificado se ININTEGRATING = T (OP em execução) e/ou STARTEDAT – ENDEDAT > 15 minutos (OP iniciou a execução, mas esta não foi finalizada com êxito). 

| Todas as tabelas possuem o campo [ INTEGRATEDAT ] que é preenchido com a data da integração (dia/mês/ano hh:mm:ss). O campo preenchido indica que o item foi executado/consumido e, uma vez que a OP passe por alguma alteração e executada novamente a tarefa agendada, este campo é automaticamente zerado indicando que o item precisa ser novamente executado/consumido pelo EME4.

Uma vez que as tabelas tanquinho estejam preenchidas é possível, então, realizar a integração do processo por completo, isto é, ler os dados da tabela de Requisições de Compras e efetivamente gerar uma requisição de compra no EME4, e assim por diante.

 

Painel Conferência Lançamentos

| Dependendo do volume de lançamentos é esperado que este processo de consulta leve alguns segundos para retornar as informações em tela.

A coluna [ Registros Pendentes ] indica se as informações foram integradas ou não, ou seja, informa se todos os registros das tabelas tanquinhos da ordem de produção já geraram as movimentações/documentos no ERP.

Na tela [  Logs Integração SEED x EME4  ] é possível verificar as informações completas do processo de integração da OP 21674 no dia 01/06/2020: 

 

A opção [ Limpar Integração Produção ] permite reverter a integração efetuada. Neste processo, os documentos vinculados à OP são excluídos em ordem contrário de quando foram incluídos no EME4 (conforme o campo ID da tabela M3_DOCTO). Além disso, o campo INTEGRATEDAT é zerado indicando que a ordem de produção não foi executada/consumida e, portanto, a integração do SEED com o EME4 não foi realizada.

Exemplo: considerando 1) liberação da OP (transferência interna), 2) apontamento (entrada de produção), 3) lançamento da sobra (ajuste no último apontamento e transferência de retorno no estoque) e 4) finalização (entrada de produção dos materiais processados), a exclusão será feita na ordem 4, 3, 2 e 1.

| A reversão da integração é feita 100%, isto é, todos os documentos referentes a OP são excluídos e, caso ocorra algum erro durante o processo de reversão, todos os documentos são mantidos.

 

Logs Comunicação APIs SEED

| A ausência de informações no filtro torna a comunicação com o SEED e o retorno de informações mais abrangente, volumoso e, consequentemente, mais demorado.

Publicar Método Agendado: publica os métodos disponibilizando-os nas tarefas agendadas;

Publicar Tabelas Tanquinho: publica as tabelas SEED_PLANNEDORDERS, SEED_MATERIALSBOM, SEED_INIEGRATING, SEED_PRODUCTIONEVENTS, SEED_STOCKMOVEMENTS e SEED_PURCHASEREQUESTS no banco de dados.

 

Logs Integração SEED x EME4 (Processos Produção)

Na grid são listados logs de ordens de produção e requisições de compras.

Para visualizar as informações nas abas [ Resumo/Detalhes ], basta clicar em um registro ou célula específica das colunas [ Planned Order ID ] e [ Purchase Request ID ].

Na imagem, abaixo, tem-se a requisição de compra (note que a coluna Purchase Request ID está preenchida), cujas informações foram gravadas na tabela SEED_PURCHASEREQUESTS. Na prática, esta requisição refere-se a compra de 5000 unidades do material 0801.0035 no dia 21/05/2020.

| O campo [ Planned Order ID ] =  Nro da OP no SEED, porém, o Purchase Request ID é a concatenação de ID da Requisição no SEED + Data da Requisição + Produto da Requisição, pois as requisições de compras podem gerar IDs duplicados no SEED.

 

Aba Resumo

Na aba [ Resumo ] são retornados os selects nas tabelas “tanquinho” do EME4 conforme o processo executado/consumido (requisição de compra/ordem de produção).

Aba Detalhes

| As colunas Planned Order ID e Purchase Request ID nunca são preenchidas, ao mesmo tempo, em um registro/linha. Isto acontece porque o log será sempre de um único processo: Ordem de Produção ou Requisição de Compras.

 

Exemplo 1.

SEED_PLANNEDORDERS: ordem de produção 20402 finalizada com sucesso envolvendo 500 unidades solicitadas/produzidas (QUANTITY/YIELDED) do material 1190;

SEED_MATERIALSBOM: utilização de 15 componentes para produzir as 500 unidades do material 1190;

SEED_PRODUCTIONEVENTS: liberação para produção (STATUSID = 3), apontamentos da produção de 208 + 292 unidades do material 1190 (STATUSID = 4), finalização da produção com o objetivo de possibilitar diversas verificações, mas sem gerar movimentação/geração de documentos no EME4 (STATUSID = 7).

| O campo [ Nro Transação SEED ] será sempre vazio quando [ Tipo Movto SEED ] = PLANNEDORDERS, isto porque a tarefa executada/consumida atualiza a tabela SEED_PLANNEDORDERS por OP e não há um ID de movimentação porque o tipo de documento/movimento será sempre transferência interna.

 

Exemplo 2.

SEED_PLANNEDORDERS: ordem de produção 21758 finalizada com erro envolvendo 1001/1005 unidades do material 0201.0005 solicitadas/produzidas (QUANTITY/YIELDED);

SEED_MATERIALSBOM: utilização de 3 componentes para produzir as 1005 unidades do material 0201.0005;

| Na tabela SEED_MATERIALSBOM são listados os campos [ ID ], [ COMPONENTMATERIALID ] e [ QUANTITY ]. O valor negativo no campo [ QUANTITY ] indica que a matéria-prima não será consumida/baixada. Trata-se de uma sobra que, portanto, gerará uma entrada de produção/estoque. Ex.: produção de uma embalagem plástica que, ao processar a matéria-prima “A” acabou gerando uma sobra “B” (outra matéria-prima ou material semiacabado).

Confira a lista dos possíveis erros mostrados na aba [ Detalhes ], motivos e locais de ocorrência:

Recurso não encontrado na OP e/ou nos eventos de produção!
Indica que o campo “RESOURCEID” não foi informado na OP ou no evento de produção que está integrando.
Pode ocorrer na:

• inclusão do apontamento de entrada de produção/estorno de entrada de produção;
• inclusão da sobra/perda de produção e;
• finalização dos eventos da OP  (apontamentos/sobras/perdas).

Almoxarifado não configurado para a máquina [“X”].
Indica que não há almoxarifado configurado para o recurso/máquina informado.
Pode ocorrer na:

• inclusão do apontamento de entrada de produção/estorno de entrada de produção;
• inclusão da sobra/perda de produção e;
• finalização dos eventos da OP (apontamentos/sobras/perdas).

As matérias primas [“X”] sofreram redução de quantidade na OP! Como a OP já sofreu apontamentos, favor lançar como sobra ao final do processo.
Indica redução da estrutura da ordem de produção (que já possui apontamentos) na inclusão da transferência de estoque (envio para produção).

Trf. p/ Produção: “Mensagem Genérica”.
Indica erro genérico na inclusão da transferência de estoque (envio para produção).

Trf. p/ Estoque (Retorno Produção): “Mensagem Genérica”.
Indica erro genérico na inclusão de transferência de estoque (retorno da produção).

Campos obrigatórios não preenchidos: “X”.
Indica a necessidade de preenchimento de campos obrigatórios na inclusão de transferência interna.

Entrada de Produção [“X”] não pode ser excluída para ser reintegrada pois a OP já contém movimentações de sobra/perda posteriores!
Limpe toda a integração e reintegre.
Indica que há movimentações de perda/sobra posteriores já registradas na ordem de produção na integração do apontamento de produção.

Apontamento produção: “Mensagem Genérica”.
Indica erro genérico na inclusão do apontamento de produção.

 

Ajustar Consumo Produção (Mês)

| O ajuste de consumo da produção deve ser executado com a premissa que o processo de produção da OP esteja pausado, ou seja, o ajuste gerado deve ser o último evento da OP para o mês/ano de competência requerido.

| Caso o usuário faça um ajuste dentro do mês, a data/hora de movimentação gerada (para ordem cronológica na integração com as movimentações do ERP) será a data/hora atual. Caso o usuário efetue o ajuste no início de um novo mês para o mês competência anterior será utilizado a data/hora movimentação igual ao último dia do mês e no último horário.

Serão listadas as OPs e os componentes/matérias-primas consumidos em apontamentos efetuados e que não foram finalizados dentro do mês/ano de competência (evento de produção de finalização – StatusID = 7).

Pode-se, também, informar [ Competência ], números de [ OPs ] (separados por “,” ou “;”) e clicar em [ Filtrar ].

Ex.: Competência = 06/2020, OPs = 22186, 22195

Caso seja informado um mês/ano de competência ainda não encerrado será mostrada mensagem de alerta solicitando a confirmação (ou cancelamento) do usuário.

Os registros ref. componentes/matérias-primas por OP que já geraram ajustes dentro do mês/ano são listados em cinza.

Os registros que tiveram algum impeditivo para gerar o ajuste são listados em vermelho.

O campo [ Qdade. Chão de Fábrica ] refere-se a quantidade que deverá ser informada ao usuário de acordo com a quantidade pesada no chão de fábrica para aquele componente/matéria-prima e OP.

O cálculo efetuado é: (Qdade. Chão de Fábrica – A Consumir). Caso a diferença seja positiva, a quantidade será reduzida do consumo do último apontamento do mês. Caso contrário será acrescida.

Ao clicar em [ Ajustar ] será gerada uma ocorrência/log com usuário, data/hora e status, além do ajuste ficar disponível na integração com o SEED para execução.

Na tela [ Logs Integração SEED x EME4 (Processo Produção) ] é possível consultar as ocorrências de ajustes.

O ajuste ficará como não efetivado enquanto não tiver sido importado pela integração.

Ao clicar em [ Reintegrar Selecionados ] exclui os detalhes de log com Status = Erro ou Reintegrado e executa a reintegração dos registros.

Ao clicar em [ Ações ]: 

Limpar Detalhes Log – Status [ Erro ] (reintegração): exclui os detalhes de log com Status = Erro da OP, altera o status principal do log para Sucesso e permite reintegração.

Limpar Detalhes Log – Status [ Reintegrado ] (legibilidade): exclui os detalhes de log com Status = Reintegrado da OP e melhora a legibilidade do log.

| As opções de “limpeza manual” são especialmente úteis nas reintegrações quando estas não são executadas de forma automática.

| A limpeza dos logs com erros antes de executar a reintegração fará com que, caso existam registros a integrar anteriores ao erro, que sejam integrados na ordem correta. 

 

Mensagens de Log

Log de Erro

Apontamento produção: Produto [ CODIGO_PRODUTO ] não possui Papel Composição configurado.
O produto deve possuir Papel Composição.

Logs de Sucesso

Não registrado transferência de estoque pois a OP não contém nenhuma composição informada.
Não foi informada nenhuma composição na OP.

Não registrado transferência de estoque de acordo com ficha de materiais da OP pois nenhuma composição transfere estoque.
Cliente não realiza transferência de estoque.

Log de Sucesso/Erro

Recurso não encontrado na OP e/ou nos eventos de produção.
Quando não houver nenhum evento de produção e houver finalização será gerado log de sucesso, caso contrário será log de erro, pois o recurso é obrigatório para o processo de integração.

 

Transferência por Troca de Máquina

| No evento de troca de máquina a sobra em estoque de produção seja retornada ao almoxarifado compras e retransferida ao almoxarifado da nova máquina. 

| Os apontamentos efetuados serão lançados conforme a última máquina programada, ou seja, a máquina da liberação da OP (programada inicialmente) ou a última troca efetuada.

 

Consultar Ajustes Consumo Produção (Mês)

Informar [ Data Inicial ] e [ Data Final ] e clicar em [ Filtrar ] para consultar as ocorrências de ajustes.

Uma ocorrência de ajuste pode ser excluída desde que não tenha sido efetivada.

2020055001 – 2020058004 – 2020102475 – 2021095903

Login – Seed Help Zendesk