Histórico da Página
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 requisiçã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.
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:
Na inclusão das solicitações de materiais é necessário escolher definir o "Tipo de Peça / Serviço", conforme mostrado abaixo:
- 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 requisição de 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 "Interna", será gerada uma requisição de estoque.
...
| draw.io Diagram | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
O campo "Tipo de Peça ou Serviço" será representado na mensagem Request_1_009.xsd pelas TAGs – Type e ItemType:
...
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, conforme descrito 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.
...
Sim
...
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.
...
Não
Observação: Para um melhor funcionamento e controle do processo de integração de 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:
...
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 de compra ou solicitação de armazéns pelo Datasul, 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 do programa "CD1406".Para iniciar o processo de Pré-requisição é necessário selecionar qual solicitação deverá ser gerada e acionar o botão Gerar, onde poderão ser escolhidos os parâmetros necessários para geração da Pré-requisição.
Ao gerar a pré-requisição, o Protheus analisará a necessidade de realizar o processo de comprar ou gerar solicitação de armazém. Caso seja gerado o processo de solicitação de compra, será necessário passar pelos passos que envolvem essa rotina:
- Cotação
- Análise da Cotação
- Pedido de Compra
- Nota Fiscal
...
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
...
- 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.
...
...
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 | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
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.
...
...
...
...
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.
...
|
Para o
...
...
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.
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 ou total;
- Valor Unitário Previsto: Valor unitário enviado pelo Datasul no momento do atendimento;
- Número da Solicitação: Número Número da solicitação gerado no DatasulDaasul;
- Status: Situação de processamento da integração.
Após atualizar as informações da solicitação de materiais, é iniciado o preenchimento da aba "Materiais Aplicadosaplicados". Os 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.
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
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas