Histórico da Página
Implementação de Modelo Genérico de EDI de Fatura Eletrônica (INVOIC) Para o DEPOT
Características do Requisito
Linha de Produto: | SARA |
Segmento: | Supply Chain - Logística |
Módulo: | EDI DepotDEPOT |
Rotina: |
|
Cadastros Iniciais: | Relacione os cadastros necessários que precisam ser preenchidos antes da utilização desse requisito. |
Parâmetro(s): | Informe os parâmetros utilizados. |
Ponto de Entrada: | Informe o ponto de entrada relacionado (link). |
Chamados Relacionados | Informe o(s) chamado(s) relacionado(s). |
Configuração de Layout de EDI DEPOT Serviço de Geração de Arquivo de EDI DEPOT | |
Requisito (ISSUE): Informe o requisito relacionado (Issue). | LOGSARA01-461 |
País(es): | Informe o(s) Pais(es).Brasil |
Banco(s) de Dados: | Informe o(s) Banco(s) de Dados utilizado(s).SQL Server |
Tabelas Utilizadas: | Informe as tabelas utilizadas. |
Sistema(s) Operacional(is): | Informe o(s) sistema(s) operacional(is) utilizados. |
Descrição
Escreva aqui a descrição da nova implementação ou melhoria.
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*.
- Em Microsiga Protheus TOTVS Smart Client (se versão 10), digite 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 |
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 |
| |
Sistema(s) Operacional(is): | Windows |
Descrição
Implementado modelo genérico de EDI de fatura eletrônica (INVOIC) no módulo de DEPOT. Para que fosse possível gerar o EDI de INVOIC, o serviço responsável pela geração dos arquivos teve que ser modificado, para ser capaz de ler o novo gatilho criado para faturas emitidas para os serviços do DEPOT.
Este novo gatilho relaciona a emissão da Nota Fiscal com os movimentos do container na unidade, permitindo assim identificar para cada item da Nota, o container correspondente ao serviço e se o processamento do EDI já ocorreu para a Nota e movimento do container.
O modelo genérico de INVOIC configurado foi baseado na documentação disponibilizada pela MSC, que implementa o padrão EDIFACT de INVOIC de versão D.95B.
O bloco abaixo apresenta um exemplo de arquivo de EDI de INVOIC de handling in para apreciação e comparação.
Informações | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
UNB+UNOA:1+EDICODE+MSC+20141211:1443+01/24+'
UNH+1+INVOIC:D:95B:UN:ITG12'
BGM+380+01/24+9'
DTM+137:201412111443:203'
DTM+90:201412010000:203'
DTM+91:201412302359:203'
NAD+IV+MSC:160:20'
NAD+II+EDICODE:58+NOME'
MOA+39:117.00:BRL'
CUX+1:BRL'
PAT+3++82'
MOA+9:125.00:BRL'
LOC+153+1:139'
// Bloco iniciado pelo marcador LIN se repete a cada serviço da fatura (handling in, handling out, armazenagem e serviço).
// Exibe o serviço de forma generalizada e logo depois com o mesmo número do contador, exibe os detalhes do serviço na fatura.
LIN+1++0613240300'
IMD+++:::HANDLING IN VAZIO 40 REEFER'
QTY+47:3' --> quantidade total do serviço
MOA+39:117.00:BRL'
PRI+INV:39.00::::BOX'
(Detalhe 1)
LIN+1++0613240300'
PIA+5+0613240300'
IMD+++:::HANDLING IN VAZIO 40 REEFER'
QTY+47:1'
DTM+176:201412101558:203'
DTM+186:201412101558:203'
EQD+CN+CONTAINER+40RH:102:5++2+4'
MOA+203:39.00:BRL'
PRI+INV:39.00::::BOX'
RFF+BM:NUMERODOBL'
TDT+20+NA442A+1+13+MSC:172:20+++:146:11:MSC MADRID'
(Detalhe 2)
LIN+1++0613240300'
PIA+5+0613240300'
IMD+++:::HANDLING IN VAZIO 40 REEFER'
QTY+47:1'
DTM+176:201412101702:203'
DTM+186:201412101702:203'
EQD+CN+CONTAINER+40RH:102:5++2+4'
MOA+203:39.00:BRL'
PRI+INV:39.00::::BOX'
RFF+BM:NUMERODOBL'
TDT+20+SS446R+1+13+MSC:172:20+++:146:11:MSC ATHOS'
(Detalhe 3)
LIN+1++0613240300'
PIA+5+0613240300'
IMD+++:::HANDLING IN VAZIO 40 REEFER'
QTY+47:1'
DTM+176:201412110805:203'
DTM+186:201412110805:203'
EQD+CN+CONTAINER+40RH:102:5++2+4'
MOA+203:39.00:BRL'
PRI+INV:39.00::::BOX'
RFF+BM:NUMERODOBL'
TDT+20+NA442A+1+13+MSC:172:20+++:146:11:MSC MADRID'
UNS+S'
CNT+2:85'
MOA+39:117.00:BRL'
UNT+959+01/24'
UNZ+1+01/24' |
Para uma melhor compreensão do exemplo acima, a figura abaixo mostra o layout detalhado em mapa mental de cada seguimento de informação do arquivo de INVOIC mapeado.
Assim sendo, um script de atualização foi gerado neste story contendo o modelo genérico de INVOIC que estará disponível após a realização dos passos descritos no Procedimento para Implantação deste documento.
Importante¹
Além da implementação do modelo de EDI de INVOIC e do ajuste no serviço de geração de arquivo para interpretar o novo gatilho para faturas, alguns outros ajustes foram identificados durante o procedimento de configuração do arquivo. São eles:
- Ajustada a listagem Grupos do arquivo/armador, na tela de configuração de linha da configuração de EDI DEPOT (módulo Sistema / Depot / EDIFACT / Configuração EDI / Linha), para que seja considerada a ordem dos grupos que foi atribuída no cadastro de grupos.
- Ajustada a rotina de cópia de layout de EDI DEPOT (módulo Sistema / Depot / EDIFACT / Versão Arquivo x Armador (Configuração) / Importar), para que seja considerada a ordem dos grupos atribuída no cadastro de grupos e assim não perder a referência de grupo pai na realização da cópia.
- Ajustado o controle de gatilho da Nota Fiscal para remover a pendência de geração de EDI, quando uma Nota for cancelada e ainda não teve o arquivo de EDI gerado.
Importante²
Para mais detalhes sobre outros layouts de EDIs, acesse o Documento Técnico clicando aqui.
Procedimento para Implantação
- Atualizar o banco de dados por meio do AtualizaDB.
- Atualizar os executáveis do pacote.
- Executar os scripts do pacote.
Procedimento para Utilização
Procedimento para Conferência de Geração de EDI de INVOIC de Fatura Eletrônica
Pré-condições
Layout de EDI de INVOIC configurado, para o Armador desejado, no módulo Sistema.
- Serviço de EDI DEPOT em execução.
- Serviços de DEPOT calculados no módulo Faturamento, para pelo menos um dos cálculos disponíveis, que pode ser de Handling In, Handling Out, Armazenagem e/ou Serviços (módulo Faturamento / Depot / Cálculo dos Serviços).
Procedimento
- Acesse o módulo Faturamento / Nota Fiscal / Emissão de Nota Fiscal.
O sistema apresenta a tela de Impressão de Nota Fiscal. - Selecione a capa correspondente aos serviços calculados no item 3 das Pré-condições.
- Clique em Iniciar Impressão de Nota Fiscal.
Neste momento o sistema gera a pendência de EDI INVOIC para a Nota Fiscal recém emitida. - Aguarde o tempo necessário conforme parametrizado na chave Intervalo no registro do Windows, de acordo com os procedimentos de configuração do Documento Técnico que pode ser acessado clicando aqui, e pelo intervalo de tempo configurado no layout do arquivo de EDI, realizado pelo módulo Sistema.
- Valide no diretório configurado para o EDI, no módulo Sistema, se o arquivo de EDI foi gerado corretamente.
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.