Histórico da Página
Integração TOTVS Comex Conteúdo x Easy Import Control
Características do Requisito
Linha de Produto: | Microsiga Protheus | ||||||||||||||||
Segmento: | Manufatura | ||||||||||||||||
Módulo: | SIGAEIC - Easy Import Control | ||||||||||||||||
Rotina: |
| ||||||||||||||||
Cadastros Iniciais: | Aplicar atualização dos programas AVGERAL.PRW, AVUPDATE01.PRW, AVOBJECT.PRW, UITSAIJ4.PRW, EICCD100.PRW, AVCADGE.PRW, EICCAD00.PRW e AVERAGE.CH. | ||||||||||||||||
Chamados Relacionados |
TTCGEO | |
País(es): | Brasil |
Banco(s) de Dados: | Todos |
Tabelas Utilizadas: | EVJ - Exceções NCM EVL - Orgãos Anuentes SYD - Nomenclatura Comum do Mercosul |
Sistema(s) Operacional(is): | Windows/Linux |
Versões/Release: | 11.8.13 |
Descrição
IntegraçãoO TOTVS Comex Conteúdo
X Easy Import ControlDescrição
Foi inclusa a integração de Cotação das Moedas (EICA140), NCM, Ex-NCM e Anuências (EICA130) com o conteúdo fornecido por intermédio do portal Fiscosoft.
Em virtude do novo ambiente Siscomex Web Importação, no qual os arquivos ‘visual basic’ (mdb) deixarão de ser populados pelo próprio Governo, foi necessário buscar nova forma de recuperação de dados relacionados à tabela “Tab Sisco”, que é na qual os principais dados mestres do registro de DI são armazenados, como NCM, Taxas de Conversão de Moeda (Taxa Siscomex), Unidades de Medida entre outros.
Para isso, foi desenvolvida integração para recuperação de dados mantidos pela empresa Fiscosoft. Esta funcionalidade possibilita ao usuário manter sua base de dados atualizada, efetuando tal integração de forma manual, ou via agendamento.
Para viabilizar essa melhoria, é necessário aplicar o pacote de atualizações (Patch) deste chamado.
é uma oferta que possibilita a atualização automática de conteúdo de alíquotas de impostos federais, exceções e taxas fiscais de câmbio, visando tornar o processo de importação de mercadorias mais seguro e ágil.Os assinantes do serviço recebem o conteúdo diariamente, de maneira automática a partir dos recursos de agendamento do próprio ERP. As informações são disponibilizadas por um time de especialistas da Thomson Reuters, que avaliam todas as publicações oficiais, analisam os impactos e atualizam a fonte de dados para distribuição.Com o seu uso é possível cadastrar automaticamente novos códigos de NCM, atualizar suas unidades de medida para registro de Licença de Importação (LI) e Declaração de Importação (DI), além das alíquotas oficiais e exceções de Imposto de Importação (II), IPI, PIS e COFINS (incluindo percentual de majoração). Adicionalmente é atualizada a taxa fiscal para todas as moedas suportadas pelo SISCOMEX, a partir das informações oficiais de fechamento no Banco Central e controle de feriados e finais de semana.Todas as atualizações são registradas em log e também podem ser executadas diretamente a partir da tela de cadastro de acordo com as preferências do usuário.Para sua utilização, após a contratação do serviço basta configurar o conector de acordo com as informações dispostas neste documento.
Importante
Antes de executar o compatibilizador UITSAIJ4 é imprescindível:
- Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório PROTHEUS \PROTHEUS11_DATA\DATA, se versão 10, ou \PROTHEUS11_DATA\DATA, se versão 11) e dos 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 o UITSAIJ4 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 05/02/2016.
- 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.
Atualizações do Compatibilizador
- Criação de Perguntas no arquivo SX1 – Cadastro de Perguntes:
Nome | Data Inicial? | Data Final? | Tipo Integração? | Moeda 01? | Moeda 02? |
Grupo | EICCD01 | EICCD01 | EICCD01 | EICCD01 | EICCD01 |
Ordem | 01 | 02 | 03 | 04 | 05 |
Tipo | Data | Data | Caracter | Caracter | Caracter |
Tamanho | 8 | 8 | 1 | 3 | 3 |
Validação | NaoVazio(mv_par01) |
Vazio() .OR. ExistCpo('SYF',mv_par04,1) | Vazio() .OR. ExistCpo('SYF',mv_par05,1) | ||
Opções |
1-Completa; 2-Simples |
Nome | Moeda 03? | Moeda 04? | Moeda 05? | Exibir log? | NCM Inicial? | NCM Final? |
Grupo | EICCD01 | EICCD01 | EICCD01 | EICCD01 | EICCD02 | EICCD02 |
Ordem | 06 | 07 | 08 | 09 | 01 | 02 |
Tipo | Caracter | Caracter | Caracter | Caracter | Caracter | Caracter |
Tamanho | 3 | 3 | 3 | 1 | 10 | 10 |
Validação | Vazio() .OR. ExistCpo('SYF',mv_par06,1) | Vazio() .OR. ExistCpo('SYF',mv_par07,1) | Vazio() .OR. ExistCpo('SYF',mv_par08,1) | NaoVazio(mv_par01) | NaoVazio(mv_par02) | |
Opções | 1-Sim; 2- Não |
Nome | Data Vigencia? | Criar Novo? | Exibir log? |
Grupo | EICCD02 | EICCD02 | EICCD02 |
Ordem | 03 | 04 | 05 |
Tipo | Data | Caracter | Caracter |
Tamanho | 8 | 10 | 1 |
Validação |
Opções |
1-Sim; 2- Não |
1-Sim; 2- Não |
2. Criação de tabela no arquivo SX2– Tabelas:
Chave | Nome | Modo | PYME |
EVJ | Exceções NCM | C | S |
EVL | Orgãos Anuentes | C | S |
4. Criação de Campos no arquivo SX3 – Campos:
- Tabela SYD - Nomenclatura Comum do Mercosul:
Campo | YD_DTINTE |
Tipo | Data |
Tamanho | 8 |
Decimal | 0 |
Formato |
Título | Dt Integ |
Descrição | Data Integração |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções
When | .F. |
Val. Sistema
Help | Data da última integração efetuada através do portal Totvs Comex Conteúdo. |
- Tabela EVJ – Exceções NCM:
Campo | EVJ_FILIAL | EVJ_TEC | EVJ_EX | EVJ_DESC | EVJ_ALIQ | EVJ_ASSUNT |
Tipo | Caracter | Caracter | Caracter | Caracter | Caracter | Caracter |
Tamanho | 2 | 10 | 3 | 60 | 10 | 25 |
Decimal | 0 | 0 | 0 | 0 | 0 | 0 |
Formato |
@R 9999.99.99 | @! |
Título | Filial | NCM | Ex-NCM | Descrição | Alíquota | Assunto |
Descrição | Filial | NCM | Ex-NCM | Descrição | Alíquota | Assunto |
Nível | 1 | 1 | 1 | 1 | 1 | 1 |
Usado | Sim | Sim | Sim | Sim | Sim | Sim |
Obrigatório | Não | Não | Não | Não | Não | Não |
Browse | Sim | Sim | Sim | Sim | Sim | Sim |
Help | Filial do Sistema | Nomenclatura Comum do Mercosul | Exceções da Nomenclatura Comum do Mercosul | Descrição da Exceção | Alíquota | Assunto da Exceção |
Campo | EVJ_DTINI | EVJ_DTFIN | EVJ_OBS |
Tipo | Data | Data | Memo |
Tamanho | 8 | 8 | 100 |
Decimal | 0 | 0 | 0 |
Formato |
Título | Dt Ini Vig | Dt Fin Vig | Obs |
Descrição | Data Inicio Vigência | Data Final Vigência | Observações |
Nível | 1 | 1 | 1 |
Usado | Sim | Sim | Sim |
Obrigatório | Não | Não | Não |
Browse | Sim | Sim | Sim |
Help | Data de início de vigência | Data final de vigência | Observações |
- Tabela EVL – Órgãos Anuentes
Campo | EVL_FILIAL | EVL_TEC | EVL_ORGAO | EVL_INDIC | EVL_TRATA | EVL_EX | EVL_DESCEX | EVL_DTINI | EVL_DTFIN |
Tipo | Caracter | Caracter | Caracter | Caracter | Caracter | Caracter | Caracter | Data | Data |
Tamanho | 2 | 10 | 20 | 10 | 60 | 3 | 100 | 8 | 8 |
Decimal | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
Formato |
@R 9999.99.99 |
@! |
Título | Filial | NCM | Orgao Anue | Indicadores | Tratamentos |
Desc. EX | Dt Ini Vig | Dt Fin Vig | |||
Descrição | Filial | NCM | Órgão Anuente | Indicadores | Tratamentos |
Descrição EX | Data Início Vigência | Data Final Vigência | |||||||
Nível | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 |
Usado | Sim | Sim | Sim | Sim | Sim | Sim | Sim | Sim | Sim |
Obrigatório | Não | Não | Não | Não | Não | Não | Não | Não | Não |
Browse | Sim | Sim | Sim | Sim | Sim | Sim | Sim | Sim | Sim |
Help | Filial do Sistema | Nomenclatura Comum do Mercosul | Orgao Anuente | Indicadores | Tratamentos | Ex-NCM | Descrição EX | Data Início Vigência | Data Final Vigência |
Campo | EVL_ABRAN | EVL_FUNLEG | EVL_DESCME | EVL_PAIS | EVL_FUNCAO | EVL_REGIME |
Tipo | Caracter | Caracter | Caracter | Caracter | Caracter | Caracter |
Tamanho | 20 | 60 | 60 | 40 | 60 | 60 |
Decimal | 0 | 0 | 0 | 0 | 0 | 0 |
Formato |
Título | Abrangencia | Fund.Legal | Desc.Merc | Pais | Funcao | Regime |
Descrição | Abrangência | Fundamento Legal | Descrição Mercadoria | País | Função | Regime |
Nível | 1 | 1 | 1 | 1 | 1 | 1 |
Usado | Sim | Sim | Sim | Sim | Sim | Sim |
Obrigatório | Não | Não | Não | Não | Não | Não |
Browse | Sim | Sim | Sim | Sim | Sim | Sim |
Help | Abrangência | Fundamento Legal | Descrição Mercadoria | País | Função | Regime |
Campo | EVL_CODREG | EVL_REGTRI | EVL_CORETR | EVL_TEXTO | EVL_LI |
Tipo | Caracter | Caracter | Caracter | Caracter | Caracter |
Tamanho | 5 | 60 | 5 | 100 | 1 |
Decimal | 0 | 0 | 0 | 0 | 0 |
Formato |
Título | Cod.Regime | Reg.Tribut | Cod.Reg.Tri | Texto | Autorizado?" |
Descrição | Código Regime | Regime Tributação | Código Regime Tributação | Texto | Autorizado?" |
Nível | 1 | 1 | 1 | 1 | 1 |
Usado | Sim | Sim | Sim | Sim | Sim |
Obrigatório | Não | Não | Não | Não | Não |
Browse | Sim | Sim | Sim | Sim | Sim |
Help | Código Regime | Regime Tributação | Código Regime Tributação | Texto | Autorizado?" |
Importante:
O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.
56. Criação ou Alteração de Consulta Padrão Criação de Índices no arquivo SXB SIX – Consulta PadrãoÍndices:
Índice |
EVJ |
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. |
Ordem | 1 |
Chave | EVJ_FILIAL+EVJ_TEC+EVJ_EX+EVJ_ASSUNT+EVJ_ALIQ |
Descrição | NCM + Ex + Assunto + Alíquota |
Proprietário | S |
Procedimento para Utilização
- Para a utilização da integração, a empresa deve possuir um login ativo para acesso ao conteúdo fornecido pela Thomson Reuters, disponibilizado de acordo com contratos pré-estabelecidos.
- Possuir um ambiente preparado para execução de tarefas via agendamento (Schedule).
Sequência 001: Configurações
- No Easy Import Control (SIGAEIC), acesse Atualizações / Tabelas / N.C.M (EICA130).
- Em Ações Relacionadas, acesse Totvs Comex Conteúdo/Configurações.
- O sistema exibe as configurações para integração.
Informe o CNPJ cadastrado para integração Totvs Comex Conteúdo.
O sistema permite a atualização de dados de todas as filiais cadastradas para o CNPJ vinculado ao contrato com a Thomson Reuters. - Clique em Confirmar.
Sequência 002: Integração Taxas
- No Easy Import Control (SIGAEIC), acesse Atualizações/Cadastros/Cotação das Moedas (EICA140).
- Em Ações Relacionadas, acesse Totvs Comex Conteúdo/Totvs Comex Conteúdo.
- Nos parâmetros de integração, informe a Data Inicial e Final.
A opção Tipo de Integração permite ao sistema efetuar a integração de forma Completa, utilizando as validações dos campos via ExecAuto, ou de forma Simples, sem utilizar as validações.
É possível informar até 5 moedas para integração.
Clique em Ok. - O sistema inicia a integração com a base de dados Thomson Reuters.
- Ao final da integração, o sistema exibe o log em tela informando todas as taxas atualizadas.
Sequência 003: Integração NCM / Ex - NCM
- No Easy Import Control (SIGAEIC), acesse Atualizações/Tabelas/N.C.M (EICA130).
- Em Ações Relacionadas, acesse Totvs Comex Conteúdo/Totvs Comex Conteúdo – NCM.
- O sistema exibe as opções de integração da NCM atual, que é a NCM que está selecionada no browse, ou de Várias NCMs. Selecione Várias NCMs.
- Nos parâmetros de integração, informe a NCM Inicial e Final.
A opção Criar Novo permite ao sistema criar novas NCMs encontradas durante a integração que não constam na base de dados do Protheus.
Clique em Ok. - O sistema inicia a integração com a base de dados Thomson Reuters.
- Ao final da integração, o sistema exibe o log em tela informando todas as NCMs atualizadas.
- As NCMs que possuem as alíquotas 4,02%, 10,65%, 13,35%, 13,57%, 14,03%, 17,48%, 15,37%, 16,26%, 18,23% serão identificadas automaticamente pelo sistema como alíquotas que possuem majoração, conforme Lei 13137/2015 publicada em 19/06/2015. Desta forma, o sistema preencherá automaticamente o valor de 1% de majoração no campo correspondente às NCMs identificadas.
- O sistema inicia a integração com a base de dados Thomson Reuters.
- Ao final da integração, o sistema exibe o log em tela informando todas as EX-NCMs atualizadas.
Sequência 004: Agendamento para integração NCM e Ex-NCM.
- No Configurador (SIGACFG), acesse Ambiente/Schedule/Schedule (CFGA010).
- Em Schedule / Agendamentos / Cadastro, clique em Incluir.
- No campo Rotina (XX1_ROTINA), informe a função CD100SchNCM.
- Clique em Recorrência e informe a periodicidade. Clique em Confirmar.
- Clique em Ok. O registro é gravado com sucesso.
- O sistema executará a integração de NCM e Ex-NCM conforme agendamento.
Sequência 005: Agendamento para integração Taxas de Moedas.
- No Configurador (SIGACFG), acesse Ambiente/Schedule/Schedule (CFGA010).
- Em Schedule / Agendamentos / Cadastro, clique em Incluir.
- No campo Rotina (XX1_ROTINA), informe a função CD100SchTX.
- Clique em Recorrência e informe a periodicidade. Clique em Confirmar.
- Clique em Ok. O registro é gravado com sucesso.
- O sistema executará a integração de Taxas de Moedas conforme agendamento.
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