Páginas filhas
  • Solicitação Material para Serviços de Oficina (CD1406 / MNFM0022)

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Solicitação de Material para Serviços de Oficina (Request)

Identificador da Mensagem: Request
Versão: 1.009
Módulo do Datasul: Estoque
Módulo do PIMS Multicultivos: Apontamentos
Tipo de Envio: Síncrona
Adapter Datasul: RequestAdapter.cls 
Classe Datasul: RequestFactory.cls


Tem como objetivo registrar os serviços de manutenção realizados pelos mecânicos nos equipamentos. Essa inclusão é realizada através da ordem de serviço de oficina mecânica. O PIMS Multicultivos é responsável por gerar a OS e apontar os materiais que serão solicitados ao Datasul, identificando para cada material qual o procedimento para sua obtenção, se aquisição ou consumo de estoque. O Datasul por sua vez iniciará um processo de compra, para os casos de aquisição, e um processo de solicitação ao armazémrequisição de estoque, para os casos de consumo de estoque. A criação do número da ordem de serviço é realizada através do menu "Apontamentos > Manutenção > Serviço de Oficina", que deverá ser preenchida conforme necessidade.


Image RemovedImage Added


Após a inclusão da ordem de serviço é necessário incluir a solicitação de materiais, realizada na aba de "Solicitação de Materiais", conforme imagem abaixo: 

Image RemovedImage Added


Na inclusão das solicitações de materiais é necessário escolher definir o "Tipo de Peça / Serviço", conforme mostrado abaixo:

Image RemovedImage Added


  • Interna – Peças que movimentarão o estoque, caso não existam em estoque, será gerado processo de compras;
  • Externa – Peças que realizarão processo de compras;
  • Mão de Obra Externa – Mão de obra que serão executadas por terceiros.

A opção "Tipo de Peça / Serviço", informada no cadastro de solicitação de materiais do PIMS, influencia diretamente no comportamento da integração, pois essa opção determina qual processo será criado, seja uma solicitação requisição de armazém estoque ou solicitação de compras. Ao definir "Tipo de Peça / Serviço" como externa ou mão de obra externa, será gerada uma solicitação de compra, caso selecione selecione "Interna", será gerada uma solicitação requisição de armazémestoque.


draw.io Diagram
bordertrue
viewerToolbartrue
fitWindowfalse
diagramNameFluxoSolMatOficina
simpleViewerfalse
width
diagramWidth981711
revision12


O campo "Tipo de Peça ou Serviço" será representado na mensagem Request_1_009.xsd pelas TAGs – Type e ItemType:


Image RemovedImage Added Image RemovedImage Added


O processo de integração é iniciado ao acionar o botão enviar, onde será alterada a situação da solicitação de materiais de NP (Não Processado pelo ERP) para EV (Enviado ao ERP). Após envio ao Datasul, não será mais permitido modificar as informações envidas.

...

Ao ser iniciado, o processo de integração recuperará as informações das tabelas APOSOFICINA e APOSOFIC_SOL_MAT e gravará na BRG_SOL_MATER_ERP com o status de processamento 0 (zero). O processo de integração entre PIMS x Datasul utilizando o PIMSConnector pode ser realizado de duas formas, assíncrona ou síncrona, dependendo das configurações realizadas no parâmetro FG_MOV_OFICINA_SINC. Para funcionamento em modo síncrono (Online), é preciso alterar o parâmetro abaixo no PIMS Multicultivos, como descrito no quadro abaixo:

...

Nome Parâmetro

...

Contexto

...

Descrição

...

Valor

...

FG_MOV_OFICINA_SINC

...

PIMSGRAOS.EAI

...

Permite configurar as integrações para executarem de forma síncrona ou assíncrona.

...

True

...

Nome Parâmetro

...

Contexto

...

Descrição

...

Valor

...

FG_MOV_OFICINA_SINC

...

PIMSGRAOS.EAI

...

Permite configurar as integrações para executarem de forma síncrona ou assíncrona.

...

False

Observação: Para um melhor funcionamento e controle do processo de integração da Solicitação de Materiais é recomendado que o processo de envio esteja habilitado para funcionar em modo Síncrona (Online). As informações que serão gravadas na tabela BRG_SOL_MATER_ERP são a junção das tabelas APOSOFICINA e APOSOFIC_SOL_MAT, que passarão por diversos tratamentos, transformações e validações antes de gerar a estrutura do XML que serão enviadas ao Datasul. 

A integração de solicitação de materiais controla as ocorrências de processamento através do cadastro de situações, onde teremos as seguintes situações:

CÓDIGO

DESCRIÇÃO

TIPO DE PROCESSAMENTO

NP

Não Processado pelo ERP

SM

AP

Atendimento Parcial

SM

AT

Atendimento Total

SM

EV

Enviado ao ERP

SM

ES

Estornado

SM

PE

Processado pelo ERP

SM

NE

Não enviado ao ERP

SM

EE

Erro no Processo de Integração

SM

IM

Integrado Manualmente - Não Será Enviado ao ERP

SM

EP

Em processamento

SM

CA

Cancelado

SM


Fluxo das situações utilizadas na integração de Solicitação solicitação de Materiais materiais de Oficinaoficina

draw.io Diagram
bordertrue
viewerToolbartrue
fitWindowfalse
diagramNameFluxoSolMaterialOS
simpleViewerfalse
width
diagramWidth751
revision1

...

Após gravação da BRG_SOL_MATER_ERP o PIMSConnector iniciará o processo de criação do XML da solicitação de materiais, onde o XML utilizado na integração PIMS Multicultivos x Datasul será o "REQUEST versão 1_009"


A identificação de Solicitação solicitação de Comprar compra ou Solicitação solicitação de Armazéns armazéns pelo ProtheusDatasul, será realizada através da TAG Type. O preenchimento da tag Type, será realizado pelo PIMS, quando o usuário defini o "Tipo de Peça / Serviço".
Valores validos para Tag Type:

  • 000 - Solicitação de Compra
  • 001 - Solicitação de Estoque

Processo de Solicitação de

...

Material no Datasul

O Datasul ao receber o XML (REQUEST) da a mensagem "Request" de solicitação de materiais do enviada pelo PIMS, gerará  cria uma solicitação de armazém, essa solicitação poderá ser visualizada através da rotina ???.

???
Image Removed

...

requisição de acordo com o tipo enviado, ou seja, pode ser uma requisição de estoque ou solicitação de compra, podendo ser consultada pelo programa "CD1406", já o processo de atendimento da requisição é feita através do programa "CD1409".

Fluxo da mensagem Request até o Atendimento com Mensagem AppointmentCost

  • Utilizar o cadastro de solicitantes do sistema para indicar ao usuário (no caso o utilizado no schedule do EAI) que pode fazer solicitações e em quais quantidades. Quando este cadastro é realizado, toda solicitação que esteja dentro da permissão dada é liberada automaticamente;

...

  • Utilizar o ponto de MT105GRV,para que todas as solicitações originárias do PIMS, já nasçam no Protheus como aprovadas.

Gerar a Pré-Requisição é o próximo passo após ter realizado a solicitação de armazém (MATA106). Este processo tem como objetivo atender as Solicitações de Armazém, gerando Pré- Requisição ou Solicitações de Compra caso não exista o produto em estoque.

...

  • Cotação
  • Análise da Cotação
  • Pedido de Compra
  • Nota Fiscal

...

  • Tipo de Movimento em que será realizada a movimentação de baixa;
  • Armazém em que será realizado a baixa;
  • Data da Emissão.

...

Observação 1: No Adapter EAI da mensagem StockTurnover é necessário adicionar a condição:
(!Empty(SD3->D3_NRBPIMS)), onde filtrará quais movimentações serão enviadas ao PIMS, evitando assim, um volume desnecessário de movimentação ao PIMS.

...

  • Solicitação de Armazém
  • Gerar Pré-Requisição
  • Cotação
  • Análise da Cotação
  • Pedido de Compra
  • Baixa de Pré-requisição

...

  • Situação da Solicitação: O processo de integração identifica se o atendimento será de forma Parcial ou Total;
  • Valor Unitário Previsto: Valor unitário enviado pelo Protheus no momento do atendimento;
  • Número da Solicitação: Número da Solicitação gerado no Protheus;
  • Status: Situação de processamento da Integração.

...

Image Removed

...

Image Removed

Image Removed

A inclusão das informações na aba de materiais aplicados, finaliza o fluxo da integração de Solicitações de Materiais da Ordem de Serviço de Oficina.

draw.io Diagram
bordertrue
viewerToolbartrue
fitWindowfalse
diagramNameFluxoCompletoSolicitacaoMaterial
simpleViewerfalse
width
diagramWidth1951
revision2

Para o funcionamento do processo de integração, é necessário que seja cadastrada a rotina MATI110, no cadastro de Adapter EAI, o nome da mensagem que representa essa rotina é REQUEST. Para o atendimento da Solicitação de Materiais é necessário cadastrar a rotina MATI103, no cadastro de Adapter EAI, a mensagem que representa essa rotina é INPUTDOCUMENT. O Protheus, ao receber o XML (REQUEST) da Solicitação de Materiais aplicados na OS de Mecânica, criará uma solicitação de compras, essa solicitação poderá ser visualizada através da rotina MATA110.

...

Image Removed

Image Removed

...

Image Removed

...

Image Removed

...

Ao finalizar a inclusão do Pedido, é necessário incluir o Documento de Entrada (MATA103), essa rotina permite a entrada dos produtos, atualizando assim, as informações do financeiro, estoques e custo. Essa rotina será responsável pelo atendimento dos materiais solicitados pelo PIMS.

Image Removed

...

1202
revision1


Para o

Image Removed Image Removed

...

Image Removed

...

Observação 1: Será adicionado no Adapter EAI a condição, onde filtrará quais Documentos de Entrada serão enviados ao PIMS, evitando assim, um volume desnecessário de movimentação ao PIMS.
Observação 2: Para facilitar a rastreabilidade da Solicitação de Compras do PIMS x Protheus, será criado, nas rotinas abaixo, o campo que demonstrará o Número do Boletim PIMS.

  • Solicitação de Compras
  • Pedido de Compra
  • Documento de Entrada

Observação 3: Para o funcionamento do atendimento dos materiais solicitados, é necessário que o Protheus Datasul preencha a TAG RequestItemInternalId. Está TAG tag será a junção das informações empresa, filialestabelicimento, número da solicitação do armazém estoque e número da sequência do item, com estas informações será possível identificar no PIMS em qual solicitação o atendimento foi realizado. 
No decorrer do desenvolvimento, implementaremos em conjunto com equipe Material - Protheus a melhor forma de implementar as opções acima.


Image Added


O atendimento no PIMS, iniciará com as atualizações de algumas informações das Solicitações solicitações de Materiaismateriais, bem como:

  • Situação da Solicitação: O processo de integração identifica se o atendimento será de forma Parcial parcial ou Totaltotal;
  • Valor Unitário Previsto: Valor unitário enviado pelo Protheus Datasul no momento do atendimento;
  • Número da Solicitação: Número  Número da Solicitação solicitação gerado no ProtheusDaasul;
  • Status: Situação de processamento da Integraçãointegração.


Image RemovedImage Added

Image Removed


Após atualizar as informações da Solicitação solicitação de Materiaismateriais, é iniciado o preenchimento da Aba aba "Materiais aplicados". Os Materiais materiais aplicados têm como responsabilidade demonstrar o histórico dos materiais atendidos e os valores dos materiais a serem utilizados para o processamento de custo.

Image Removed

Image Removed


A inclusão das informações na aba de materiais aplicados, finaliza o fluxo da integração de Solicitações de Materiais da Ordem de Serviço de Oficina. draw.io DiagrambordertrueviewerToolbartruefitWindowfalsediagramNameFluxosimpleViewerfalsewidthdiagramWidth1511revision2Image Added