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 ordem de Serviço serviço de Oficina Mecânicaoficina 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 solicitação ao armazémestoque, para os casos de consumo de estoque. A criação do número da Ordem ordem de Serviços serviço é realizada através do Menu 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 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 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 solicitação de Comprascompras. Ao definir "Tipo de Peça / Serviço" como externa ou mão de obra externa, será gerada uma Solicitação solicitação de Compracompra, caso selecione selecione "Interna", será gerada uma Solicitação requisição de Armazémestoque.
| 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:
O processo de integração é iniciado ao acionar o botão enviar, onde será alterada a Situação situação da Solicitação solicitação de Materiais materiais de NP (Não Processado pelo ERP) para EV (Enviado ao ERP). Após envio ao ERPDatasul, não será mais permitido modificar as informações envidas ao Datasul.
Ao acionar o botão enviar, internamente o processo de integração realizará a manipulação de Statusstatus, conforme abaixo:
- 0 - Não processado;
- 1 – Em processamento;
- 2 – Enviado ao ERP aguardando retorno;
- 3 – Erro no envio da integração;
- 4 – Processado pelo ERP;
- 9 – Integrado Manualmente manualmente – Ponto de Abastecimento abastecimento não está marcado para integrar;
- 5 – Cancelado ou Excluído excluído pelo ERP.
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
Para funcionamento em modo assíncrono (Off-line), é preciso alterar o parâmetro abaixo no PIMSMulticultivo, como descrito no quadro abaixo:
...
Nome Parâmetro
...
Contexto
...
Descrição
...
Valor
...
FG_MOV_OFICINA_SINC
...
.
...
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 | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
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 ???.
???
...
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.
...
...
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.
Observação. Para definir que a requisição criada no Protheus seja Solicitação de Compras, no PIMS o Tipo de Peça / Serviço, precisa estar como Externa ou Mão de obra Externa.
...
...
Observação: Caso utilize o processo de aprovação / cotação, é necessário realizar todo o fluxo existente.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.
...
Ao confirmar as informações do Documento de Entrada, é iniciado o processo de atendimento com o PIMS Multicultivos. A integração de atendimento (Total ou Parcial) será realizada através da mensagem INPUTDOCUMENT que retornará os materiais que foram solicitados.
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 preencha a TAG. Está TAG necessário que o Datasul preencha a TAG RequestItemInternalId. Está 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 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.
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.
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