Histórico da Página
Gerar OS de Descarga na Portaria Com Pré Documento Sem Programação.
Características do Requisito
Linha de Produto: | SARA |
Segmento: | Distribuição e Logística |
Módulo: | PORTARIA |
Rotina: | Portaria - Cadastro - Tipo de Inconsistência Doc. Entrada (ufrmTipoInconsistenciaPreDocEntrada)
|
Parâmetro(s): | GERA_OS_PORTARIA_COM_PRE_CADASTRO_SEM_AGEND_VEIC |
Chamados Relacionados | TQFETD |
| Requisito (ISSUE): | PCREQ-3006 |
Banco(s) de Dados: | SQL SERVER |
Tabelas Utilizadas: | sara_db.tab_tip_inconsistencia_doc_ent (novo) sara_log.rel_tip_docum_inconsistencia (novo) sara_db.rel_tip_docum_inconsistencia (novo) sara_log.rel_tip_docum_inconsistencia (novo) sara_db.tab_tmp_doc_ent_inconsistência (novo) sara_db.tab_tmp_doc_entrada_liberado (novo) sara_db.tab_cfop sara_log.tab_cfop sara_db.tab_container sara_db.rel_cesv_dent sara_db.rel_dent_cnt sara_db.tab_tmp_doc_entrada sara_db.tab_tmp_doc_entrada_comp sara_db.tab_tmp_lote sara_db.tab_tmp_lote_complemento sara_db.tab_tmp_lote_item sara_db.tab_tmp_container sara_db.tab_doc_entrada sara_db.tab_doc_entrada_complemento sara_db.tab_lote sara_db.tab_lote_complemento sara_db.tab_lote_item |
Versões/Release: | 12.1.1617 |
Descrição
Importante
(Apenas para Microsiga Protheus, versões anteriores à versão 12)
Antes de executar o compatibilizador informe o nome do compatibilizador é imprescindível:
- Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório PROTHEUS_DATA\DATA, se versão 10, ou \PROTHEUS11_DATA\DATA, se versão 11) e dos dicionários de dados SXs (diretório PROTHEUS_DATA_SYSTEM, se versão 10, ou \PROTHEUS11_DATA\SYSTEM, se versão 11).
- Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
- Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
- Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
- O compatibilizador deve ser executado com a Integridade Referencial desativada*.
Atenção O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco de Dados (DBA) ou equivalente! A ativação indevida da Integridade Referencial pode alterar drasticamente o relacionamento entre tabelas no banco de dados. Portanto, antes de utilizá-la, observe atentamente os procedimentos a seguir:
Contate o Help Desk Framework EM CASO DE DÚVIDAS! |
|---|
- Em Microsiga Protheus TOTVS Smart Client (se versão 10) ou ByYou Smart Client (se versão 11), digite informe o nome do compatibilizador no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a ___/___/____.
- Clique em OK para continuar.
- Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado ou é apresentada a janela para seleção do compatibilizador. Selecione o programa xxxx().
- Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
É apresentada uma mensagem explicativa na tela. - Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
- Clique em Gravar para salvar o histórico (log) apresentado.
- Clique em OK para encerrar o processamento.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
Descreva se há algum procedimento necessário após a aplicação do compatibilizador.
Procedimento para Implantação
O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.
- Aplique o patch do chamado e execute uma vez a rotina Informe o nome da rotina.
- No módulo informe o nome do módulo acesse informe o caminho e verifique que o parâmetro informe o nome do parâmetro é criado conforme especificações abaixo:
Nome da Variável: | Informe o Nome da Variável |
Tipo: | Informe o Tipo |
Descrição: | Informe a Descrição |
Valor Padrão: | Informe o Valor Padrão |
Atualizações do Compatibilizador
(Apenas para Microsiga Protheus, versões anteriores à versão 12)
- Criação ou Alteração de Perguntas no arquivo SX1 – Cadastro de Perguntes:
Pergunte | (X1_PERGUNT) |
Nome |
|
Grupo | (X1_GRUPO) |
Ordem | (X1_ORDEM) |
Tipo | (X1_TIPO) |
Tamanho | (X1_TAMANHO) |
2. Criação ou Alteração de tabela no arquivo SX2– Tabelas:
Chave | Nome | Modo | PYME |
B04 (X2_CHAVE) | Dente/Região (X2_NOME) | C (X2_MODO) | N (X2_PYME) |
3. Criação ou Alteração de Tabelas Genéricas no arquivo SX5 – Tabelas Genéricas:
Chave | Ex.: AR |
Descrição | Ex.: Tabela de IR de Aplicações Financeiras |
4. Criação ou Alteração (mantenha somente a instrução correspondente) de Campos no arquivo SX3 – Campos:
- Tabela BGD - Prod x Cob x Proc x Co-Part:
Campo | (X3_CAMPO) |
Tipo | (X3_TIPO) |
Tamanho | (X3_TAMANHO) |
Decimal | (X3_DECIMAL) |
Formato | (X3_PICTURE) |
Título | (X3_TITULO) |
Descrição | (X3_DESCRIC) |
Nível | (X3_NÍVEL) |
Usado | (X3_USADO) Informe Sim ou Não |
Obrigatório | (X3_OBRIGAT) Informe Sim ou Não |
Browse | (X3_BROWSE) Informe Sim ou Não |
Opções | (X3_CBOX) |
When | (X3_WHEN) |
Relação | (X3_RELACAO) |
Val. Sistema | (X3_VALID) |
Help | Descreva o conteúdo informado para Help de Campo no ATUSX |
Importante:
O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.
5. Criação ou Alteração de Consulta Padrão no arquivo SXB – Consulta Padrão:
- Pesquisa B05PLS:
Alias | (XB_ALIAS) |
Tipo | (XB_TIPO) |
Sequência | (XB_SEQ) |
Coluna | (XB_COLUNA) |
Descrição | (XB_DESCRI) |
Contém | (XB_CONTEM) |
6. Criação ou Alteração de Índices no arquivo SIX – Índices:
Índice | AA1 |
Ordem | 6 |
Chave | AA1_FILIAL+AA1_CODVEN |
Descrição | Cod. Vendedor |
Proprietário | S |
7. Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:
Nome da Variável | (X6_VAR) |
Tipo | (X6_TIPO) |
Descrição | (X6_DESCRIC + X6_DESC1 + X6_DESC2) |
Valor Padrão | (X6_CONTEUD) |
8. Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:
- Tabela BD5 – Contas Médicas:
Campo | Informe o conteúdo do (X7_CAMPO) |
Sequência | Informe o conteúdo do (X7_SEQUENC) |
Campo Domínio | Informe o conteúdo do (X7_CDOMIN) |
Tipo | Informe o conteúdo do (X7_TIPO) |
Regra | Informe o conteúdo do (X7_REGRA) |
Posiciona? | Informe o conteúdo do (X7_SEEK) |
Chave | Informe o conteúdo do (X7_CHAVE) |
Condição | Informe o conteúdo do (X7_CONDIC) |
Proprietário | Informe o conteúdo do (X7_PROPRI) |
Procedimento para Configuração
(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou rotinas no menu).
CONFIGURAÇÃO DE PARÂMETROS
- No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
(É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)
Itens/Pastas | Descrição |
Nome: |
|
Tipo: | Informe o Tipo do parâmetro |
Cont. Por.: | Informe o Conteúdo padrão |
Descrição: |
|
CONFIGURAÇÃO DE MENUS
2. No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:
Menu | Informe o Menu em que estará localizada a rotina |
Submenu | Informe o Submenu em que estará localizada a rotina |
Nome da Rotina | Informe o Título da rotina |
Programa | Informe o Fonte da rotina |
Módulo | Informe o Nome do(s) produto(s) a ser utilizado ou “Todos” |
Tipo | Informe a Função |
Procedimento para Utilização
- Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações:
- Localização da rotina no menu;
- Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
- Caso seja necessário ter algum cadastro feito previamente, faça uma observação.
Exemplo:
1. No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).
O sistema apresenta a janela de produtos cadastrados.
2. Posicione o cursor em um produto e clique em Alterar.
3. Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.
4. Dê duplo clique no campo TP Prestador (BCW_TIPPRE).
O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.
5. Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:
Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.
6. Confira os dados e confirme.
Vídeo
- Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.
** Canal do youtube e software de vídeoem definição.
Título do Vídeo: | Disponibilizado pelo Marketing. |
Introdução: | Disponibilizado pelo Marketing. |
Passo a Passo: | Capturar diretamente do sistema. |
Finalização: | Disponibilizado pelo Marketing. |
Criado parâmetro para permitir a geração de ordem de serviço de descarga de container ao concluir o registro de entrada do veículo (CESV) no módulo portaria. Para que a ordem de serviço seja gerada, os documentos de entrada deverão ser primeiramente registrados como pré documento de entrada para posterior associação ao CESV. Algumas funcionalidades foram implementadas para oferecer maior segurança e agilidade no processo, são elas:
Módulo Portaria - Cadastros - Container
- Alterado para que ao incluir um novo container que possua um pré documento, as informações de tamanho, tipo e tara sejam sugeridas conforme informado no pré documento.
Módulo Faturamento - Cadastros - CFOP
- Criado novo campo chamado "Informar quantidade de itens em unidades comerciais" para indicar se a quantidade dos itens da nota fiscal serão informados em volume ou unidade comercial. Por padrão (desmarcado) a quantidade é informada em volume.
Módulo Portaria - Menu Pré Cadastro
- Criada funcionalidade para liberação de pré documento de entrada para recebimento por intermédio do novo botão "Liberar para recebimento". Ao pressionar este novo botão o sistema irá realizar verificações afim de identificar possíveis inconsistências no cadastro do documento de entrada. O sistema poderá identificar dois tipos de inconsistências, graves e não graves. As inconsistências encontradas serão listadas em tela com seu código, descrição e indicador de grave ou não grave. Ao identificar uma inconsistência grave o pré documento não poderá ser liberado para recebimento até que as inconsistências sejam corrigidas. As inconsistências não graves serão apresentadas ao usuário porém poderão ser assumidas e o pré documento será liberado. As possíveis inconsistências bem como a classificação de grave e não grave poderão ser visualizadas através dos novos programas localizados em MENU - Portaria - Cadastros - Tipos de Inconsistência Pre Doc. Entrada ou ainda em Módulo Portaria - Menu Cadastros --> Config. Tipo Documento x Tipos Inconsistências caso o tipo de documento possua alguma regra específica.
- Criado indicador para informar se documento está ou não liberado.
- Alterado para bloquear a conclusão do cadastro caso exista divergência entre a quantidade total de volumes do documento de entrada e a soma da quantidade dos itens do documento caso o CFOP tenha sido configurado para informar os itens do documento em volumes.
Módulo Portaria - Menu Cadastros - Tipos de inconsistências
- Criado novo programa para consulta e modificação das possíveis inconsistências para um pré documento de entrada. Este cadastro além de permitir a consulta de todas as possíveis inconsistências, permite que a mensagem a ser apresentada ao usuário seja alterada conforme necessidade do usuário.
Módulo Portaria - Menu Cadastro - Configuração tipo de documento inconsistências
- Criado cadastro que permite tornar inconsistências não grave em grave para um determinado tipo de documento.
Módulo Portaria - Menu CESV
- Alterado para que caso novo parâmetro esteja ativo seja solicitado os containers do CESV antes dos documentos do CESV.
- Alterado para que a ordem de serviço de descarga de container seja gerada ao concluir o registro de um CESV que possua containers com pré documentos vinculados. Caso exista algum pré documento vinculado a algum container do CESV que não foi informado como documentos do CESV, uma mensagem informando o usuário é disparada e o processamento para geração da ordem de serviço de descarga de container não é realizado.
Módulo Portaria - Menu CESV - Containers
- Alterado para que ao confirmar o cadastro de cada container seja verificado se o mesmo possui pré documentos. Existindo pré documentos para o container a tela de documentos do CESV deverá ser aberta para cada container.
- Alterado para que ao excluir um container todos os pré documentos associados a ele sejam desvinculados do CESV.
- Alterado para que ao sair da tela de containers seja verificado se todos os pré documentos vinculados ao containers foram informados como documentos do CESV. Caso todos os documentos não tenham sido vinculados, o usuário é notificado que "Existem pré documentos vinculados ao container não informados como documentos do CESV".
Módulo Portaria - Menu CESV - Documentos
- Alterado para permitir informar pré documentos como documentos do CESV;
- Alterado para que sejam sugeridas todas as informações dos documentos com base nos pré documentos vinculados aos containers do CESV;
- Criada nova coluna na grade de documentos para informar se o documento possui pré documento ou não.
- Bloqueada exclusão de documento de entrada caso o mesmo esteja vinculado a um pré documento. A exclusão deverá ser realizada através do container que irá desvincular todos os pré-documentos vinculados a ele do CESV.
- Existindo containers no CESV com pré documento cadastrado, foi bloqueada a inclusão de novos documentos do CESV não vinculados como pré documentos de containers.
Módulo Expedição - Doc. Entrada
- Alterado para bloquear qualquer alteração no documento de entrada caso o mesmo não tenha sido recebido em sua totalidade. Ou seja, caso ele exista como documento e pré documento de entrada.
- Alterado para bloquear a conclusão do cadastro caso exista divergência entre a quantidade total de volumes do documento de entrada e a soma da quantidade dos itens do documento caso o CFOP tenha sido configurado para informar os itens do documento em volumes.
Procedimento para Implantação
Atualização do banco de dados através do AtualizaDB;
Atualização dos executáveis do pacote.
Procedimento para Configuração
Para que as funcionalidades descritas neste documento sejam habilitadas, no módulo sistema, o parâmetro GERA_OS_PORTARIA_COM_PRE_CADASTRO_SEM_AGEND_VEIC deverá ter seu valor atualizado para 'S'. Apenas o novo campo no cadastro de CFOP não é condicionado a ativação do parâmetro.
Procedimento para Utilização
Procedimentos:
- No módulo Faturamento menu Cadastro > CFOP, altere um CFOP e marque a nova opção "Informar quantidade de itens em unidades comerciais";
- No módulo Portaria, acesse o menu Pré Cadastro. Neste programa registre uma nota fiscal com o CFOP alterado no passo anterior. Informe os respectivos itens e containers. Na primeira aba de documentos informe um valor para a quantidade de volumes (Vol. Transportados) e nos itens informe uma outra quantidade referente a quantidade comercial de itens. O sistema irá permitir a gravação.
- Veja que o pré-documento é apresentado como não liberado para recebimento;
- Realize a liberação do documento através do novo botão "Liberar para recebimento". Ao identificar alguma divergência, as mesmas serão listadas em uma nova tela onde será possível "Assumir divergências" ou "Ajustar Documento". Se identificado alguma inconsistência grave a opção "Assumir divergências" ficará desabilitada permitindo o usuário apenas "Ajustar Documento";
Após a liberação do pré-documento para recebimento, veja que o mesmo é apresentado como liberado para recebimento;No módulo Portaria, acesse o menu CESV. Neste programa registre uma nova entrada de veículo. Ao confirmar a gravação, os containers do CESV devem ser solicitados;Clique em incluir e informe o container cadastrado para o documento do passo 1. Ao sair do campo container, caso o mesmo não tenha sido cadastrado, a tela de cadastro de container será aberta. Clique em incluir, as informações de tipo, tamanho e tara são preenchidas automaticamente conforme informado no pré documento cadastrado no passo 1. Confirme o cadastro do container do CESV, a tela de documentos do CESV deverá ser aberta;Na tela de documentos do CESV clique em incluir, veja que todas as informações do documento serão preenchidas automaticamente com base no pré documento cadastrado no Passo 1. Confirme o cadastro.Logo após o processamento da gravação do CESV uma nova ordem de serviço de descarga de container será gerada.
Ponto de Entrada
Descrição: | Informe o Menu em que estará localizada a rotina | ||||||||||||||||
Localização: | Informe o Submenu em que estará localizada a rotina | ||||||||||||||||
Eventos: | Informe o Título da rotina | ||||||||||||||||
Programa Fonte: | Informe o Fonte da rotina | ||||||||||||||||
Função: | Informe o Nome do(s) produto(s) a ser utilizado ou “Todos” | ||||||||||||||||
Retorno: |
|
Exemplo:
#Include 'Protheus.ch'
User Function CN120ALT()
Local aCab:= PARAMIXB[1]
Local cTipo:= PARAMIXB[2]
If cTipo == '1'
aCab[4][2]:= 'NF' //Validações do usuário
EndIf
Return aCab