Árvore de páginas

CONTEÚDO

  1. Visão Geral
  2. Exemplo de utilização
  3. Operações
  4. Principais Campos
  5. Pré condições
  6. Parâmetros
  7. Pontos de Entrada
  8. Adapter EAI
  9. Informações Adicionais
  10. Tabelas Utilizadas

01. VISÃO GERAL

O objetivo da rotina MATA241 - Movimentos Internos Modelo 2 é agilizar a operação de digitação dos movimentos a serem realizados. Na grande maioria dos casos estes movimentos pertencem a um mesmo contexto.

Exemplo: (Baixa de insumos para uma ordem de produção, baixa de material de consumo) e assim estão relacionados ao mesmo centro de custo.

Por este motivo esta rotina apresenta este formulário neste modelo, com o centro de custo único para todos os movimentos.

Observação

A rotina MATA241 - Movimentos Internos Modelo 2 possui o limite máximo para inclusão de até 999 itens.

02. EXEMPLO DE UTILIZAÇÃO

A rotina de movimentações múltiplas permite realizar as operações de inclusão e estorno, conforme exemplos abaixo: 

Rotina Automática
//------------------------------------------------------------------------
/*
EXEMPLO DE INCLUSÃO
*/
//------------------------------------------------------------------------

#INCLUDE "RWMAKE.CH" 
#INCLUDE "TBICONN.CH"

User Function TMATA241()
Local _aCab1 	:= {}
Local _aItem 	:= {}
Local _atotitem := {}
Local cCodigoTM := "503"
Local cCodProd 	:= "PRODUTO "
Local cUnid 	:= "PC "

Private lMsHelpAuto := .T.
Private lMsErroAuto := .F.

//Private _acod := {"1","MP1"}

PREPARE ENVIRONMENT EMPRESA "99" FILIAL "01" MODULO "EST"

_aCab1 := {{"D3_DOC" ,NextNumero("SD3",2,"D3_DOC",.T.), NIL},;
          {"D3_TM" ,cCodigoTM , NIL},;
          {"D3_CC" ,"        ", NIL},;
          {"D3_EMISSAO" ,ddatabase, NIL}}


_aItem:={{"D3_COD" ,cCodProd ,NIL},;
  {"D3_UM" ,cUnid ,NIL},; 
  {"D3_QUANT" ,1 ,NIL},;
  {"D3_LOCAL" ,"01" ,NIL},;
  {"D3_LOTECTL" ,"",NIL},;
  {"D3_LOCALIZ" , "ENDEREÇO            ",NIL}}

aadd(_atotitem,_aitem) 
MSExecAuto({|x,y,z| MATA241(x,y,z)},_aCab1,_atotitem,3)

If lMsErroAuto 
	Mostraerro() 
	DisarmTransaction() 
	break
EndIf

Return


//------------------------------------------------------------------------
/*
EXEMPLO DE ESTORNO
Obs: O estorno será realizado por documento ou item conforme pergunte MTA240 configurado para o usuário
que executar a rotina automática
*/
//------------------------------------------------------------------------
 
#INCLUDE "RWMAKE.CH"
#INCLUDE "TBICONN.CH"
 
User Function TMata241()
 
Local aCab  := {}
 
Private lMsErroAuto := .F.
 
PREPARE ENVIRONMENT EMPRESA "99" FILIAL "01" MODULO "EST"
 
dbSelectArea("SD3")
dbSetOrder(2)
If dbSeek(xFilial()+"X00002004")
    aCab := { {"D3_DOC" ,SD3->D3_DOC,Nil}}
 
    MSExecAuto({|x,y,z| MATA241(x,y,z)},aCab,Nil,6)
    If lMsErroAuto 
        Mostraerro()
    Endif
EndIf
 
Return  

//------------------------------------------------------------------------
/*
EXEMPLO DE ESTORNO POR DOCUMENTO
Obs: O parâmetro AUTOESTORN estará disponível a partir do fonte MATA241.PRX
com data igual ou superior à 14/03/2023
*/
//------------------------------------------------------------------------

#INCLUDE "RWMAKE.CH" 
#INCLUDE "TBICONN.CH"

User Function TMata241()

Local aCab 	:= {}

Private lMsErroAuto := .F.

PREPARE ENVIRONMENT EMPRESA "99" FILIAL "01" MODULO "EST"

dbSelectArea("SD3")
dbSetOrder(2) //D3_FILIAL+D3_DOC+D3_COD 
If dbSeek(xFilial()+"X00002004")
	aCab := { {"D3_DOC", SD3->D3_DOC, Nil},;
              {"AUTOESTORN", "DOC",   Nil}}

	MSExecAuto({|x,y,z| MATA241(x,y,z)},aCab,Nil,6)
    If lMsErroAuto  
    	Mostraerro()
    Endif
EndIf

Return


//------------------------------------------------------------------------
/*
EXEMPLO DE ESTORNO POR ITEM
Obs: O parâmetro AUTOESTORN estará disponível a partir do fonte MATA241.PRX
com data igual ou superior à 14/03/2023
*/
//------------------------------------------------------------------------

#INCLUDE "RWMAKE.CH" 
#INCLUDE "TBICONN.CH"

User Function TMata241()

Local aCab 	:= {}

Private lMsErroAuto := .F.

PREPARE ENVIRONMENT EMPRESA "99" FILIAL "01" MODULO "EST"

dbSelectArea("SD3")
dbSetOrder(4) //D3_FILIAL+D3_NUMSEQ+D3_CHAVE+D3_COD
If dbSeek(xFilial()+"144908")
	aCab := { {"D3_DOC", SD3->D3_DOC, Nil},;
              {"AUTOESTORN", "ITEM",  Nil}}

	MSExecAuto({|x,y,z| MATA241(x,y,z)},aCab,Nil,6)
    If lMsErroAuto  
    	Mostraerro()
    Endif
EndIf

Return

03. OPERAÇÕES

Na página principal da rotina, estão disponíveis as seguintes opções:

    Permite a inclusão de movimentações internas.

    As informações devem ser preenchidas de acordo com as orientações descritas em Principais Campos.

    Após preencher as informações desejadas, selecione a opção Salvar para voltar a tela principal.


    Geração de Ativos

    No processo de movimentação interna Modelo 2 também é possível realizar a geração de ativos que estiverem no estoque. Esta condição proporciona mais flexibilidade nos processos de gestão que definem se o produto é um ativo da empresa ou se deve ser consumido, assim, é possível promover mais aderência na aplicação da regra de negócios. Para isto é necessário incluir um Tipo de Entrada e Saída (TES) que possui o campo Atual.Ativo com conteúdo igual a Sim, bem como, a inclusão de um Tipo de Movimento para ser utilizado na circulação do estoque e que considera, principalmente, o conteúdo dos campos Gera Ativo? e Tipo de Entrada, pois, contemplam a integração entre Estoque e Custos e Ativo Fixo.

    1. Na rotina de Movimentação Interna Modelo 2, clique em Incluir.
    2. Selecione um produto para requisição e confirme.
    3. A requisição gerada com o evento de inclusão de um movimento interno será uma requisição interna valorizada a fim de não sofrer alteração de custo após seu eventual recálculo. Nesse momento, é realizada uma busca no banco de dados para identificar as notas fiscais que originaram o saldo atual do produto incluído e determinar o custo do movimento de requisição e a quantidade de ativos a serem gerados, pois, a geração de ativos é por nota fiscal encontrada. Esta pesquisa é processada da seguinte forma: identificação dos documentos de entrada mais recentes (data de digitação em ordem decrescente) que somam a quantidade igual ao saldo atual do produto. A partir disto, o custo do bem para o módulo Ativo Fixo é determinado através da quantidade requisitada versus os documentos de entrada pesquisados, sendo agora, utilizados em ordem de digitação crescente (do mais antigo para o mais recente). Da mesma forma, o procedimento é feito para considerar impostos calculados das notas fiscais encontradas e, além disso, é consultado o tipo de movimentação guardando o tipo de entrada e saída que foi amarrado conforme o campo Tipo de Entrada. Isso é indispensável para os casos em que há necessidade de gerar CIAP para o ativo que foi criado.


    Outras Ações/Ações Relacionadas: 

    Ação Descrição
    Rateio por veículo/viagem

    Esta opção somente é habilitada se o parâmetro MV_INTTMS estiver preenchido com T, indicando que o ambiente SIGATMS (Gestão de Transportes) está integrado aos demais ambientes do sistema Protheus.

    O Rateio por Veículo/Viagem permite ratear valores dos itens de requisições no estoque por veículo/viagem, por exemplo, requisição de abastecimento (combustível) para um veículo.

    Procedimentos:

    Para ratear o custo de um item do documento de entrada por veículo/viagem:

    1. Clique em Rateio por Veículo/Viagem. O sistema apresenta a janela para configuração do rateio de custos.

    2. Preencha os campos conforme instruções do help de campo.

    3. Pressione seta para baixo para incluir outros veículos/viagens que farão parte do rateio.

    4. Confira os dados e clique em Ok. O somatório dos percentuais atribuídos aos itens deve ser 100%.

    Rateio por frota

    Esta opção somente é habilitada se o parâmetro MV_INTTMS estiver preenchido com T, indicando que o ambiente SIGATMS (Gestão de Transportes) está integrado aos demais ambientes do Sistema.

    O Rateio por frota permite ratear os valores dos itens de requisições de estoque por frota, relacionando-o a um código do cadastro de despesas de transporte, por exemplo, requisição de graxa para a utilização na frota.

    Procedimentos:

    Para ratear o custo de um item do documento de entrada por frota:

    1. Clique em Rateio por Frota. É disponibilizada a janela para a informação do código da despesa.

    2. Preencha o campo conforme orientação do help de campo.

    3. Confira os dados e confirme.

    Exportação Excel

    Esta funcionalidade foi criada para facilitar a conferência de informações e aumentar a flexibilidade na manipulação dos dados.

    Por meio de Exportação Excel, é possível exportar o conteúdo de determinados cadastros para planilhas do Microsoft Excel® em tempo de execução, ou seja, para os dados que estão sendo apresentados na tela.

    Procedimentos:

    Para utilizar a exportação de dados para o Microsoft Excel ®:

    1. Na janela de manutenção, das telas de Inclusão, Alteração e Visualização, clique em Exp. Excel para efetuar a exportação on-line dos dados para o Microsoft Excel®.
    O Sistema abre o aplicativo Microsoft Excel®, criando uma nova planilha com os dados (campos) que estão sendo exibidos na tela.

    2. Os dados podem ser manipulados normalmente pelas opções/operações disponibilizados pelo aplicativo Microsoft Excel®.

    3. Para retornar ao Protheus Remote, encerre o aplicativo Microsoft Excel®.

    Importante

    Essa opção somente será apresentada na versão Protheus Remote para Windows.

    Tracker Contábil

    Nesta opção é possível localizar e exibir os lançamentos contábeis a partir do documento que os originou.

    Procedimentos

    1. Selecione o documento e clique em Ações relacionadas na opção Tracker Contábil.

    2. É apresentada a tela com os dados.

    3. Em Ações Relacionadas clique em Visualizar.

    4. É apresentada a tela com as informações dos lançamentos contábeis.

    A movimentação lançada não pode ser excluída. Para reverter a inclusão, é necessário utilizar a opção Estorno, disponível no menu.

    Após alterar as informações desejadas, selecione a opção Confirmar para voltar a tela principal.

    Permite a visualização de informações das movimentações incluídas.

    Após visualizar as informações desejada, selecione a opção Confirmar para voltar a tela principal.

    Permite a pesquisa de informações dos movimentos internos com a utilização de filtros que as ordenam de acordo com as características desejadas:

    Exemplo:

    • Ordem de Produção + Produto + Armazém
    • Documento + Produto
    • Produto + Armazém + Sequencial + Tipo RE/DE
    • Sequencial + Chave + Produto
    • Tipo de Movimento + Produto
    • Data de Emissão + Sequencial + Chave + Produto
    • Produto + Armazém + Data de Emissão
    • Documento + Sequencial
    • Código do Projeto + Código da Tarefa + Produto + Armazém
    • Ordem de Serviço
    • Chave SF2


    Permite visualizar os tipos de movimentos que são listados pela rotina:

    Exemplo:

    • E0 - Manual de material de apropriação direta
    • E1 - Automático de material de apropriação direta
    • E2 - Automático de material de apropriação indireta
    • E3 - Manual de material de apropriação indireta
    • E4 - Transferência em geral
    • E5 - Apropriação direta de entrada na ordem de produção
    • E6 - Manual de material valorizado
    • E7 - Desmontagem de produtos
    • E8 - Integração do módulo de importação
    • E9 - Movimentos para ordem de produção sem agregação de custo
    • EA - Movimentos de reavaliação de custo
    • PR - Produção
    • Estornados



    04. PRINCIPAIS CAMPOS


    CampoDescrição
    Número do documento

    Número do documento referente a(s) movimentação(ões) que serão informados.


    Tipo de Movimento

    Código do tipo de movimentação que os movimentos que serão informados, pode ser:

    (E) - Entrada - Códigos < ou = 500

    (S) - Saída - Códigos > 500

    Centro de CustoCentro de Custo do produto movimentado.
    Produto

    Código identificador do produto movimentado.

    UnidadeUnidade de Medida referente ao produto que foi informado.
    Quantidade

    Quantidade de produto movimentado.

    Conta Contábil

    Código da conta contábil onde deve ser lançado o custo da movimentação.


    Ordem de Produção

    Número da ordem de produção do movimento.


    Armazém

    Código do Armazém onde será movimentado o produto.

    GrupoGrupo do produto movimentado.
    CustoCusto total da movimentação na moeda 1.


    05.
    PRÉ-CONDIÇÕES

    06. PARÂMETROS

    NomePropósitoLink da Documentação
    MV_ATFDCBA

    Indica como será desmembrado o ativo.

    • 0 - Desmembra o item
    • 1 - Desmembra o código base do ativo
    DT MV_ATFDCBA
    MV_CBASEAFIndica próximo código base do ativo imobilizado a ser incluído automaticamente pela NFE.DT MV_CBASEAF
    MV_CQLocal (Armazém) do Controle de Qualidade.DT MV_CQ
    MV_CUSMED

    Utilizado no cálculo do custo médio para identificar se o custo será calculado online ou não.

    • O→Online
    • M→Mensal (Recálculo Custo)
    DT MV_CUSMED
    MV_DAMARCTIndica se deverá desconsiderar checagem da amarração contábil na inclusão de documento de entrada.DT MV_DAMARCT
    MV_DBLQMOV

    Indica a data para bloqueio de movimentos. Não podem ser:

    • Alterados 
    • Criados 
    • Excluídos

    movimentos com data menor ou igual a data informada no parâmetro.

    DT MV_DBLQMOV
    MV_ESTNEG

    Indica se o sistema permitirá que os saldos em estoque dos produtos fique negativo através de movimentação. Conteúdo deve ser:

    • (S)im
    • (N)ão
    DT MV_ESTNEG
    MV_GRADE

    Indica a utilização do recurso grade de produto:

    • T - Ativa o uso da grade de produto
    • F - Desativa o uso da grade de produto
    Parâmetro MV_GRADE
    MV_IMPMOVIndica se permite a impressão da relação dos movimentos não realizados por falta de saldos.DT MV_IMPMOV
    MV_INTTMSIdentifica se o módulo do Gestão de Frotas - SIGATMS está integrado aos outros módulos.DT MV_INTTMS
    MV_LOCPROCIndica o local padrão a ser enviado os materiais indiretos em processo.DT MV_LOCPROC
    MV_PIMSINTHabilita integração Protheus x PimsGraos.DT MV_PIMSINT
    MV_PRODMNTIndica o item de estoque para ordem de produção do SIGAMNT.DT MV_PRODMNT
    MV_QTDPREVindicar se soma quantidade dos campos de ordens de produção previstas nos cálculos de quantidade empenhada e quantidade prevista de entrada.DT MV_QTDPREV
    MV_REVPRODIndica se utiliza controle de revisão de produto.DT MV_REVPROD
    MV_TPSALDO

    Indica qual tipo de saldo será considerado nos movimentos internos:

    • (S) Utiliza a funcao SaldoSB2
    • (Q) Utiliza o valor B2_QATU-B2_QACLASS-B2_RESERVA
    DT MV_TPSALDO
    MV_VLDALMOIndica se deve validar existência do almoxarifado destino do movimento.DT MV_VLDALMO
    MV_WMSNEWIndica se utiliza novo conceito WMS (Movimentações e Estoque por Endereço).DT MV_WMSNEW

    07. PONTOS DE ENTRADA

    NomePropósitoLink da Documentação
    MT241GRVTem a finalidade de atualizar algum arquivo ou campo, após a gravação dos dados (aCols) no SD3.MT241GRV - Atualiza arquivo ou campo
    MT241MEM

    Tem a finalidade de adicionar campos memo do usuário.

    MT241MEM - Adição de campos memo do usuário
    M240BROWTem a finalidade de realizar tratamentos de exibição dos dados no browse (filtro, por exemplo).M240BROW - Tratamentos de exibição dos dados no browse

    MTA241CPO

    Tem a finalidade de incluir campos do usuário na getdados após a montagem do aHeader e aCols.MTA241CPO - Inclui campos do usuário na getdados
    A241BUTEste ponto de entrada permitirá ao usuário manipular a barra de botões nas rotinas de visualização, inclusão e estorno de movimentos internos.PEST07521 - A241BUT: Movimentações Internas.
    MT241CABTem a finalidade de permitir a inclusão de campos no cabeçalho da rotina "Movimentos Internos - Modelo 2".MT241CAB - Inclusão de campos no cabeçalho da rotina Movimentos Internos Mod2
    MT241SD3É executado logo após a gravação dos movimentos internos (SD3), na inclusão e tem como finalidade a atualização de algum arquivo ou campo.MT241SD3 - Atualização de Arquivo ou campo
    MT241CANTem a finalidade de realizar tratamentos específicos de arquivos/campos do usuário durante o cancelamento da inclusão;MT241CAN - Tratamento específicos de campos do usuário
    MTA241DOCTem a finalidade de permitir ou não a digitação do campo 'Numero do Documento'.MTA241DOC - Permite ou não a digitação do campo "Número do Documento"
    MTA241PCOTem a finalidade de validar os campos pelo SIGAPCO após a montagem do aCols, vale ressaltar que este ponto de entrada e somente utilizado quando utilizada a rotina de baixa da pre-requisição.MTA241PCO - Rotina de baixa da pré-requisição
    M241BUTTem a finalidade de incluir botões de usuário na barra de ferramentas da rotina de inclusão em Movimentos Internos Modelo II.M241BUT - Inclusão de botões em Movimentos Internos Modelo II
    MT241ESTTem a finalidade de atualizar de algum arquivo ou campo após a atualização do registro de movimentos internos (SD3) no estorno do movimento.MT241EST - Atualização de arquivo ou campo
    MT241TOKTem a finalidade de ser utilizado como validação da inclusão do movimento pelo usuário.MT241TOK - Valida inclusão de movimento
    CPOSDH1Gravação de Campos do Usuário na Tabela DH1.CPOSDH1 - Gravação de campos na tabela DH1
    MT241LOKApós a confirmação da digitação da linha, antes da gravação, deve ser utilizado como validação complementar desta. Este ponto de entrada somente será executado se a linha da getdados for validada pela função A241LinOk.MT241LOK - Ponto de Validação Complementar
    MTA241IApós a validação da data do movimento, no cabeçalho da rotina e tem a finalidade de validar esta mesma data.MTA241I - Valida data do movimento
    MT241EXTTem a finalidade de permitir validar campos específicos do usuário no momento do estorno.MT241EXT - Valida campos específicos de usuário
    MT241SETem a finalidade de adicionar itens no aCols, no final da função M241SeleEs.MT241SE - Adição de campos no aCols
    MTA241MNUPermite a inclusão de novas rotinas ao Menu Padrão da rotina de Movimentos Internos (Modelo 2).MTA241MNU - Altera o Menu
    MT241EAIPonto de entrada MT241EAI, localizada na MATI241, altera os vetores de dados que são enviados para a rotina automática da MATA241 (movimentação de estoque).MT241EAI - Ponto de entrada para manipulação de dados
    M241FILBM241FILB: Filtro dos registros da tabela SD3 na execução da função Mbrowse da rotina MATA241M241FILB: Filtro dos registros da tabela SD3 na execução da função Mbrowse da rotina MATA241

    08. ADAPTER EAI

    O recurso Adapter EAI permite estabelecer integrações entre o Microsiga e outro ERP. Utilizando esse recurso, o Administrador do Sistema passa a definir quais rotinas devem ser integradas, marcando condições de Envio e Recebimento de procedimentos e transações a serem efetuadas entre os dois Sistemas relacionados, e orientando os métodos a serem aplicados.

    Para que seja possivel utilizar em Produto, deve ser considerada as informações:

    • Mensagem única: STOCKTURNOVER
    • Versões disponibilizadas:
      • 1.000;
    • Adapter EAI : MATI241

    Saiba mais em: A camada do EAI


    09. INFORMAÇÕES ADICIONAIS

    Interface para grade de produtos

    O recurso de grade agiliza o trabalho de cadastramento de produtos que variam em apenas alguns aspectos, mantendo a sua característica principal. Dessa forma, não é preciso cadastrar o mesmo produto diversas vezes apenas pelo produto ter uma variedade de características, ou seja, o usuário precisa apenas cadastrar o produto principal e todas as suas variáveis, tais como: cor, modelo etc. Isso permitirá que sejam gerados, automaticamente, todos os produtos variáveis cadastrados.

    Importante

    Para utilizar o recurso Grade de Produtos, é necessário configurar o parâmetro MV_GRADE = T, ativando assim, o uso da grade de produtos.


    Tipos de movimentos gerados a partir da rotina MATA241 - Movimentos Internos Modelo 2


    10. TABELAS UTILIZADAS

    • CVL - Controle Diário
    • DC8 - Estrutura Física
    • SA1 - Cadastro de Clientes
    • SA2 - Cadastro de Fornecedores
    • SB1 - Cadastro de Produtos
    • SB2 - Saldos Físico e Financeiro
    • SB3 - Demandas
    • SB9 - Saldos Iniciais
    • SC2 - Ordens de Produção
    • SC5 - Pedidos de Venda
    • SC6 - Itens do Pedidos de Venda
    • SC7 - Pedidos de Compras
    • SD1 - Itens da Nota Fiscal de Entrada
    • SD2 - Itens da Nota Fiscal de Vendas
    • SD3 - Movimentações Internas
    • SD4 - Requisições Empenhadas
    • SDE - Rateios da Nota Fiscal
    • SDG - Movimentos de Custo de Transporte
    • SE1 - Contas a Receber
    • SE2 - Contas a Pagar
    • SF1 - Cabeçalho Nota Fiscal de Entrada
    • SF3 - Livros Fiscais
    • SF4 - Cadastro de Tipos de Entrada e Saída (TES)
    • SF5 - Tipos de Movimentação
    • SI1 - Plano de Contas
    • SI2 - Lançamentos Contábeis
    • SI5 - Lançamentos Padronizados
    • SI6 - Totais de Lote
    • SI7 - Plano Contas em outras Moedas
    • SN1 - Cadastro do Ativo Imobilizado
    • SN3 – Itens do Ativo