Integração do Easy Import Control via Mensagem Única - EAI

Características do Requisito

Descrição

Implementação da funcionalidade de integração via mensagem única  - EAI - para o Easy Import Control (Protheus), com o objetivo de flexibilizar a comunicação entre as soluções TOTVS com a utilização da tecnologia de WEB Services, o que ocorrerá com a troca de informações (mensagens) no formato XML entre esses sistemas

Estão previstas nessa atualização as seguintes integrações:

• Cadastro da unidade de medida (recebimento);
• Cadastro de produtos (recebimento);
• Cadastro de Cliente/ Fornecedor (recebimento);
• Relacionamento produto x fornecedor (recebimento);
• Conversão da unidade de medida do fornecedor (recebimento);
• Banco (recebimento);
• Transportadora (recebimento);
• Cotação das moedas (recebimento);
• Solicitação de importação/ ordem de compra (recebimento);
• Cotação de preços (envio e recebimento);
• Purchase order/ programação de entregas (envio);
• Geração de título de adiantamento ao fornecedor (envio);
• Geração de títulos efetivos ao fornecedor (envio);
• Baixa e estorno da baixa dos títulos efetivos e compensação contra os títulos de adiantamento ao fornecedor (envio);
• Geração de títulos provisórios (envio);
• Geração de títulos de adiantamento de despesas – numerários (envio);
• Geração de títulos efetivos de despesas (envio);
• Prestação de contas / compensação e estorno da compensação dos títulos de despesa contra o título de adiantamento da despesa (envio);
• Geração de notas fiscais de recebimento (envio);
• Contabilização em trânsito (envio).
  
  

Procedimento para Configuração

As atualizações disponibilizadas através deste Boletim Técnico adequam o produto Easy Import Control para sua utilização na integração via Mensagem Única – EAI. Para a configuração das integrações, devem ser observadas as orientações do manual de integração com o ERP em questão.

Sobre o EAI Protheus, consulte as informações adicionais disponíveis no portal TDN:

http://tdn.totvs.com/display/framework/EAI+Protheus

http://tdn.totvs.com/pages/releaseview.action?pageId=107939550

CONFIGURAÇÃO DE PARÂMETROS

      1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Configure o(s) parâmetro(s) a seguir:
          Obs.: Configuração obrigatória.

      2. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Configure o(s) parâmetro(s) a seguir:
          Obs.: Configuração opcional.

CONFIGURAÇÃO DE WEB SERVICE PROTHEUS

1. Em Programa Inicial digite SRVWIZARD para acessar o Wizard.
2. Informe o Usuário e a Senha.
3. Acesse Módulos WEB e clique em Incluir.
4. Em Módulo Web, selecione o módulo WS – Microsiga Protheus 11 Web Services; em Nome da Instância, informe um nome para o Web Service(exemplo: “ws”). Selecione o enviroment e o ambiente. Marque a opção “Habilitar processos na Inicialização do Servidor”. Clique em Avançar.
5. Será exibida a pergunta “Deseja descompactar o pacote de arquivos HTTP na pasta especificada?”, clique em “Sim”.
6. Em host digite o endereço http do seu web service (Exemplo: “localhost:81/ws”). Selecione a Empresa/Filial e clique em Relacionar. O relacionamento será exibido na parte inferior da tela. Clique em Avançar.
7. Informe o número mínimo (Exemplo: 10) e máximo de usuários (Exemplo: 10) e clique em Finalizar.
8. O sistema irá exibir um aviso sobre a instalação do Web Service e questiona se deseja iniciar tal instalação. Clique em Sim.

CONFIGURAÇÃO DE JOB DO SCHEDULER DO PROTHEUS

1. Em Programa Inicial digite SRVWIZARD para acessar o Wizard.
2. Informe o Usuário e a Senha.
3. Acesse Processos Comuns e clique em Incluir.

4. Preencha os campos conforme abaixo:

   Itens/Pastas	Descrição
   Nome do JOB:	FWSCHDMANAG
   Função ADVPL:	FWSCHDMANAG
   Ambiente:	(preencha com o ambiente/enviroment em uso no protheus)
   Instâncias:	1
   Parâmetros:	(não informar parâmetros)
   Habilitar JOB no START:	(deixe a opção marcada)

5. Clique em finalizar.
6. Acesse novamente Processos Comuns e clique em Incluir.

7. Preencha os campos conforme abaixo:

   Itens/Pastas	Descrição
   Nome do JOB:	FWSCHDQUEUE
   Função ADVPL:	FWSCHDQUEUE
   Ambiente:	(preencha com o ambiente/enviroment em uso no protheus)
   Instâncias:	1
   Parâmetros:	(não informar parâmetros)
   Habilitar JOB no START:	(deixe a opção marcada)

8. Clique em finalizar.
9. Após essa configuração, é necessário reiniciar o serviço do Protheus.

CONFIGURAÇÃO DE AGENTE DO SCHEDULER DO PROTHEUS

1. No Configurador (SIGACFG) acesse Ambiente/Schedule/Schedule (CFGA010).
2. Em Agent/Cadastro, clique em Incluir.
3. Preencha os dados na tela para criação do Agente e clique em Confirmar.
4. Em Agent inicie o serviço criado.
5. Em Schedule inicie os serviços: Task Manager e Queue Manager.

CONFIGURAÇÃO DA TAREFA DE PROCESSAMENTO DE INTEGRAÇÕES ASSINCRONAS DO SCHEDULER DO PROTHEUS

1. No Configurador (SIGACFG) acesse Ambiente/Schedule/Schedule (CFGA010).
2. Em Agendamentos/Cadastro, clique em Incluir.
   

3. Preencha os dados na tela para criação da tarefa conforme abaixo:

   Itens/Pastas	Descrição
   Usuário:	Administrador
   Rotina:	FWEAI
   Ambiente:	(preencha com o ambiente/enviroment em uso no protheus)
   Empresa/Filial:	(preencha com o empresa/filial em uso no protheus)
   Módulo:	99 – Configurador
   Habilitado:	(deixe a opção marcada)

4. Clique no botão recorrência e informe a periodicidade para processamento da tarefa de integração das mensagens assíncronas. Recomendado deixar na opção “Sempre Ativo” e “Sem data de término”.
   

5. Clique em Confirmar para fechar a tela de recorrência. Clique em confirmar para salvar a configuração da tarefa.
   
6. Recomendado reiniciar o serviço do Protheus após a configuração do agendamento.
   

CONFIGURAÇÃO DO APPSERVER DO PROTHEUS

1. Localize o arquivo appserver.ini, no diretório \bin, onde encontra-se a instalação dos binários do serviço do Protheus.
2. Com um editor de texto, abra o arquivo, e localize a seção [GENERAL].
   
3. Nesta seção, caso não existam as configurações abaixo, adicione ou caso exista, altere para que fiquem conforme abaixo. Não modifique outras configurações que possam existir nessa seção.
   
   [GENERAL]
   DATEZERO=ADVPL
   MemoMega=1
   ConsoleLog=1
    
4. Salve as alterações no arquivo, feche-o, e reinicie o serviço do Protheus. 
   
   

CONFIGURAÇÃO DO SERVIÇO DO PROTHEUS PARA ATUALIZAÇÕES

Após as configurações de webservice e scheduler do Protheus, haverão tarefas em execução no servidor do Protheus mesmo que nenhum usuário esteja logado no sistema. Com isso as aplicações de patchs e updates que necessitam de acesso exclusivo ao sistema podem ser dificultadas pois é necessário derrubar os processos em execução. Recomenda-se fazer uma copia da instalação do serviço do Protheus (pasta “\bin\” que contem os binários do serviço do Protheus) e nessa instalação retirar a configuração da execução dos Jobs (basta remover a seção [ONSTART] no appserver.ini. É importante que todas as outras configurações sejam mantidas). Assim, quando for necessário aplicar um patch ou update, pare o serviço do Protheus que possuir as configurações dos Jobs, inicie o serviço que não possua execução de Jobs, aplique a atualização necessária, pare o serviço que não possuir execução de Jobs e inicie novamente o serviço que possuir a execução de Jobs.

Tome cuidado para executar esse processo da maneira descrita para que o Protheus possa ser atualizado e para que não fique sem a inicialização dos Jobs.

PROCEDIMENTO PARA BACK-UP DE BASE DE DADOS

Devido ao controle e configurações internas do TOTVS DBACCESS, toda criação de backup e restore de backup de base de dados, assim como replicação da base de dados para outros ambientes, deve ser feita através da importação de tabelas da ferramenta APSDU. Isso garante a integridade das tabelas e correta interpretação dos dados pelo TOTVS DBACCESS e consequentemente pelas aplicações do Protheus. Não utilize ferramentas de backup de tabelas diretamente pelo banco de dados, pois isso pode exigir a reinicialização do serviço e até mesmo a reinstação do TOTVS DBACCESS.

RELAÇÃO DE/PARA DE EMPRESAS / FILIAIS

Outros ERPs TOTVS diferentes do Protheus não possuem o conceito de Empresa/Filial como no Protheus, existindo uma ou mais empresas/filiais distintas utilizando o mesmo sistema, são todas cadastradas no ERP como empresas diferentes. Além disso os códigos de empresa do ERP são distintos dos códigos de empresa/filial do Protheus. Por isso é necessário acessar o cadastro da relação DE/PARA no módulo configurador (Ambiente/Schedule/Emp.fil Msg.Unica) para cadastrar esta relação.

Por exemplo, se tivermos a empresa 21 no ERP Logix e quisermos associar á empresa 01 filial 10 do Protheus, devemos cadastrar conforme abaixo.

1. No Configurador (SIGACFG) acesse Ambiente/Schedule/Emp.fil Msg.Unica (APCFG050).

2. Clique na opção Incluir e preencha os campos conforme exemplo abaixo:

   Itens/Pastas	Descrição
   Referência	LOGIX (nome do ERP externo)
   Company	21 (código da empresa no ERP)
   Branch	(em branco)
   Emp.Protheus	01
   Fil.Protheus	10

3. Clique em confirmar para salvar o relacionamento empresa/filial.
   

ADEQUAÇÃO DO TAMANHO DOS CAMPOS DO PROTHEUS

O tamanho de campos de algumas tabelas do Easy precisará ser adequado para que fique compatível com o tamanho dos campos no ERP.

Campos como código de cliente, código de fornecedor e código de produto podem ficar divergentes e gerar problemas de integração caso não fiquem com o mesmo numero de caracteres que o ERP.

 Verifique o tamanho dos grupos de campos do Protheus através do módulo configurador, na opção de menu Base de dados / Dicionário / Base de dados. Selecione a empresa do lado esquerdo da tela, selecione Dicionário de dados e Grupo de campos. Veja ao lado direito todos os grupos de campo e na coluna tamanho, o tamanho atualmente em uso no Protheus.

 É recomendado rever os seguintes grupos de campos:

CONFIGURAÇÃO DE ADAPTER

O módulo Easy Import Control está preparado para a realização das integrações que seguem. Para configurar as integrações, conforme a necessidade, siga as instruções abaixo:

1. No Configurador (SIGACFG) acesse Schedule/Adapter E.A.I. (CFGA020).

2. Acesse a opção Incluir e informe os dados do adater, conforme as opções que seguem:

Procedimento para Utilização

Pré-requisitos:

Teste de webservices

Os webservices do Protheus e do ERP destino da integração devem estar devidamente configurados e no ar.

Verifique utilizando seu navegador de internet se o webservice do Protheus está no ar acessando o host configurado para o webservice Protheus. Procure o serviço FWWSEAI e veja se o mesmo encontra-se habilitado.

Verifique, utilizando seu navegador de internet, se o webservice do ERP destino está no ar acessando o host configurado no parâmetro MV_EAIURL2.

Integrações de cadastros

As integrações de cadastros ocorrem com origem no ERP com destino ao Easy. Algumas dessas integrações ocorrem de forma síncrona e outras de forma assíncrona.

Quando o cadastro possuir a integração de forma síncrona, o ERP irá aguardar o Easy processar a integração, e então exibirá para o usuário se tudo ocorreu com sucesso ou se houve rejeição por parte do Easy. Quando as rejeições das integrações ocorrem, o ERP não irá efetivar a operação realizada.

Quando o cadastro possuir integração de forma assincrona, o ERP não irá aguardar o Easy processar a integração e irá efetivar a operação independentemente do processo de integração. A mensagem de integração entra em uma fila no ERP para ser enviada ao Easy. Quando a integração ocorrer, a mensagem será recebida pelo Protheus e armazenada em uma fila para posterior processamento, retornando ao ERP apenas o aviso de recebimento da mensagem. O processamento da integração ocorre no Easy conforme a execução da tarefa FWEAI configurada no Scheduler do Protheus. Essa tarefa irá verificar todas as mensagens pendentes na fila do EAI e irá processá-las. Após o processamento, será enviada a mensagem ao ERP com o resultado da integração. Em caso de rejeição na integração, o EAI pode tentar processar novamente a mensagem antes de retornar uma rejeição ao ERP.

Pré-requisitos cadastrais

Cadastro de Produtos:

Para o cadastro de produtos do módulo Easy Import Control (Atualizações / Cadastros / Produtos – MATA011) é necessário cadastrar previamente às integrações deste cadastro, cadastrar um Local Padrão para o campo Armazem Pad. (B1_LOCPAD) com o valor “.” visto eu tal campo tornou-se obrigatório nas últimas versões do produto.

Condição de pagamento:

O cadastro da condição de pagamento do módulo Easy Import Control (Atualizações / Tabelas / Condição de Pag. – EICA060) deve ser relacionado ao cadastro de condição de pagamento do ERP; desta forma, acessando o cadastro o usuário deverá alterá-lo e informar a correspondência no campo Cod. ERP (Y6_CODERP), pasta Outros.

Moedas:

O cadastro de moedas do Easy Import Control (Atualizações / Cadastros / Moedas – EICA150) deve ser relacionado ao cadastro de moedas do ERP. Para isso o usuário deverá acessar o registro da moeda em modo de alteração e informar nos campos: Cod.C.ERP (YF_CODCERP) o código da moeda de compra correspondente; Cod.V.ERP (YF_CODVERP) o código da moeda de venda correspondente e Cod.F.ERP (YF_CODFERP) o código da moeda fiscal correspondente. 

Eventos Contábeis:

Para realizar a integração com o Financeiro do ERP, o Easy Import Control precisará saber qual o tipo de documento deve ser gerado. Para isso será necessário que os eventos contábeis associados às integrações/ tipos de movimento financeiro sejam configurados.

Através do menu Atualizações / Tabelas / Eventos Contábeis (ECOA002), os eventos abaixo, do tipo IMPORT, devem ser acessados em modo de alteração e ter os campos informados conforme orientação que segue:

• Evento 101 – FOB INVOICE: da pasta Cadastrais, os campos Descricao (EC6_DESC), Historico (EC6_COD_H) e Hist. Complem (EC6_COM_HI); da pasta Financeiro, os campos Tp. Titulo (EC6_TPTIT), Tx.Vda./Comp. (EC6_TXCV) e Tp.Despesa (EC6_NATFIN); da pasta Contábil, os campos Contabiliza (EC6_CONTAB), Cta. Credito (EC6_CTA_CR) e Cta. Debito (EC6_CTA_DB), da pasta Outros o campo Prefixo (EC6_PREFIX).
• Evento 102 – PROV. FRETE: da pasta Financeiro, os campos Tp. Titulo (EC6_TPTIT), Tx.Vda./Comp. (EC6_TXCV) e Tp.Despesa (EC6_NATFIN), da pasta Outros o campo Prefixo (EC6_PREFIX).
• Evento 103 – PROV. SEGURO: da pasta Financeiro, os campos Tp. Titulo (EC6_TPTIT), Tx.Vda./Comp. (EC6_TXCV) e Tp.Despesa (EC6_NATFIN), da pasta Outros o campo Prefixo (EC6_PREFIX).
• Evento 150 – DESPESAS PROVISÓRIAS: da pasta Financeiro, os campos Tp. Titulo (EC6_TPTIT), Tx.Vda./Comp. (EC6_TXCV) e Tp.Despesa (EC6_NATFIN), da pasta Outros o campo Prefixo (EC6_PREFIX).
• Evento 151 – ADIANTAMENTO DE DESPESAS: da pasta Financeiro, os campos Tp. Titulo (EC6_TPTIT), Tx.Vda./Comp. (EC6_TXCV) e Tp.Despesa (EC6_NATFIN), da pasta Outros o campo Prefixo (EC6_PREFIX). Esse evento contábil será associado à despesa de adiantamento ao despachante, código 9.01, para integração com o financeiro do ERP, caso não tenha sido informado outro para o cadastrado dessa despesa.
• Evento 201 – FOB D.I. / N.F.E.: da pasta Cadastrais, os campos Descricao (EC6_DESC), Historico (EC6_COD_H) e Hist. Complem (EC6_COM_HI); da pasta Contábil, os campos Contabiliza (EC6_CONTAB), Cta. Credito (EC6_CTA_CR) e Cta. Debito (EC6_CTA_DB).
• Evento 320 – DESPESAS: da pasta Financeiro, os campos Tp. Titulo (EC6_TPTIT), Tx.Vda./Comp. (EC6_TXCV), Mot. Baixa (EC6_MOTBX, apenas para a compensação/ prestação de contas), Natureza (EC6_NATURE, tipo de valor (ou ajuste financeiro) que indicará a incidência do ISS) e Tp.Despesa (EC6_NATFIN); da pasta Outros o campo Prefixo (EC6_PREFIX). Esse evento contábil será associado às despesas usadas no processo (exceto as iniciadas com 1 e 9) para a realização da integração com o financeiro do ERP, caso não tenha sido informado outro para o cadastrado dessa despesa. Quando o campo Mot. Baixa (EC6_MOTBX) não estiver preenchido, por default será usada a informação 004 (borderô) na integração.
• Evento 501 – V.CAMB.FOB INV.DEV.: da pasta Cadastrais, os campos Descricao (EC6_DESC), Historico (EC6_COD_H) e Hist. Complem (EC6_COM_HI); da pasta Contábil, os campos Contabiliza (EC6_CONTAB), Cta. Credito (EC6_CTA_CR) e Cta. Debito (EC6_CTA_DB).
• Evento 504 – V.CAMB.FOB INV.CRED.: da pasta Cadastrais, os campos Descricao (EC6_DESC), Historico (EC6_COD_H) e Hist. Complem (EC6_COM_HI); da pasta Contábil, os campos Contabiliza (EC6_CONTAB), Cta. Credito (EC6_CTA_CR) e Cta. Debito (EC6_CTA_DB).
• Evento 608 – PGTO. A FORNECEDOR: da pasta Financeiro, Tp. Titulo (EC6_TPTIT), Tx.Vda./Comp. (EC6_TXCV) e Tp.Despesa (EC6_NATFIN); da pasta Outros os campos C.Custo (EC6_CCUSTO) e Prefixo (EC6_PREFIX).
• Evento 609 – PAGAMENTO ANTECIPADO: da pasta Financeiro, Tp. Titulo (EC6_TPTIT), Tx.Vda./Comp. (EC6_TXCV) e Tp.Despesa (EC6_NATFIN); da pasta Outros os campos C.Custo (EC6_CCUSTO) e Prefixo (EC6_PREFIX).

Agente de Transporte:

O cadastro do Agente de Transporte deve ser associado ao cadastro de um fornecedor recebido da integração com o ERP para que o Easy Import Control possa realizar as ingrações de despesas com o Financeiro do ERP. Para isso o usuário deve acessar o menu Atualizações / Tabelas / Agentes Transp. (EICA040), acessar a opção Alterar e informar os campos Fornecedor (Y4_FORN)e Loja (Y4_LOJA). Caso não exista cadastro, acesse a opção Incluir e informe os dados cadastrais.

Despachante:

O cadastro do Despachante deve ser associado ao cadastro de um fornecedor recebido da integração com o ERP para que o Easy Import Control possa realizar as ingrações de despesas com o Financeiro do ERP. Para isso o usuário deve acessar o menu Atualizações / Tabelas / Despachantes (EICA050), acessar a opção Alterar e informar os campos Fornecedor (Y5_FORNECE)e Loja (Y5_LOJAF). Caso não exista cadastro, acesse a opção Incluir e informe os dados cadastrais.

Importadores:

Em Atualizações \ Cadastros \ Importadores (EICAA005), junto aos dados gerais do cadastro do Importador, devem ser informados os campos Banco (WD_BANCO), Agência (WD_AGENCIA) e Conta (WD_CONTA) para que o Easy Import Control possa realizar as integrações com o Financeiro do ERP para a geração de títulos de adiantamento de despesas do processo de importação.

C.F.O.:

Em Atualizações \ Tabelas \ C.F.O. (EICOP100), deve ser realizado o cadastro da código fiscal de operações, informando as regras de apuração do ICMS para o processo.

Sequencia 001 – Unidade de medida

1. Acesse o menu Atualizações \ Tabelas Siscomex \ Unidades de Medida (EICUN100). Essa tabela é inicializada pelo sistema com uma carga padrão.
2. Para o uso desse cadastro quando integrado com o ERP via mensagem única, será realizada a atualização dos dados de desse cadastro, possibilitando sua associação ao cadastro correspondente no ERP de origem. A integração ocorrerá através da mensagem UnitOfMeasure, adapter EECAS125, possibilitando o recebimento dos dados enviados pelo ERP.
3. Acessando a opção Visualizar, certifique que o campo Cod. ERP (AH_CODERP) foi atualizado. A integração também atualizará o conteúdo do campo Descr.Portug (AH_DESCPO).
4. Caso seja identificado que a integração não ocorreu, deve ser verificado no ERP de origem as mensagens e validações reportadas pela integração.
5. Importante: o código da unidade de medida no módulo Easy Import Control possui tamanho 2 (dois). Se no ERP de origem o tamanho dessa informação for superior a 2 (dois), deverá ser feito o relacionamento entre estas informações. O relacionamento entre estes cadastros é realizado manualmente no módulo Easy Import Control, cadastro de unidade de medidas (Atualizações \ Tabelas Siscomex \ Unidades de Medida), através do campo Cod. ERP (AH_CODERP).

Sequencia 002 – Cadastro de Produtos

1. Acessando o menu Atualizações \ Cadastros \ Produtos (MATA011) verifique se os cadastros dos produtos foram integrados. Essa integração ocorrerá através da mensagem ITEM, adapter EECAC120, recebida do ERP com o qual o Easy Import Control está integrado.
2. Para a integração com o Easy Import Control ao adapter foram adicionados os recebimentos das descrições em português e específica do produto. Acesse a opção Visualizar e, na pasta Cadastrais, verifique se o campo Descr. Especif (B1_ESPECIF) está preenchido; na pasta Outros, verifique se o campo Desc. Portug (B1_VM_P) está preenchido.
3. Caso seja identificado que a integração não ocorreu, deve ser verificado no ERP de origem as mensagens e validações reportadas pela integração.

Sequencia 003 – Relacionamento produto x fornecedor

1. Através do menu Atualizações \ Cadastros \ Produto x Fornecedor (MATA060) será possível verificar os cadastros de relacionamento entre produto e fornecedor que foram integrados ao Easy Import Control através da mensagem ProductSupplierRelationship, adapter EICPF060.
2. A integração, originada no ERP, relaciona apenas o produto e o fornecedor, sendo necessário que o vínculo com o fabricante, usado nos processos de importação, sejam realizados pelo usuário do sistema. Para isso, uma vez identificado que o relacionamento entre o produto e o fornecedor já constam no módulo Easy Import Control, quando estiver criando um processo de importação, fase purchase order, o usuário poderá acessar a opção de inclusão via consulta padrão (AVI002) do campo Fabricante (W3_FABR) do item do Purchase Order. Essa opção permitirá a inclusão de um novo relacionamento Produto x Fornecedor, considerando os dados previamente integrados, e o usuário poderá informar o fabricante para o relacionamento.
3. Acessando a opção Visualizar será possível constatar se os dados foram integrador e, principalmente, se a unidade de medida do fornecedor, gravada no campo Unidade (A5_UNID) da pasta Cadastrais, foi recebida pela integração.
4. Caso seja identificado que a integração não ocorreu, deve ser verificado no ERP de origem as mensagens e validações reportadas pela integração.

Sequencia 004 – Conversão da unidade de medida do fornecedor

1. Através do menu Atualizações \ Tabelas Siscomex \ Conversao Unidades (EICTU100) será possível verificar os cadastros de conversão da unidade de medida do fornecedor integrados ao Easy Import Control através da mensagem ProductSupplierRelationship, adapter EICPF060. Essa integração ocorrerá na sequencia da integração do relacionamento Produto x Fornecedor.
2. Esse cadastro é fundamental para que ocorram as conversões de unidades de medidas nas fases do processo de importação, principalmente na concepção do processo (purchase order) possibilitando o seu fechamento (recebimento de importação).
3. Caso seja identificado que a integração não ocorreu, deve ser verificado no ERP de origem as mensagens e validações reportadas pela integração.

Sequencia 005 – Solicitação de Importação

Pré-requisito:

• integração de produtos e
• integração de uma ordem de compra vinda do ERP de origem.

1. No Easy Import Control (SIGAEIC) acesse Atualizações / Solicit. Importação / Manutenção (EICSI400). Quando habilitada a integração via Mensagem Única (EAI), a Solicitação de Importação corresponderá à uma Ordem de Compra do ERP de origem, ou seja, a rotina estará adaptada para receber, via integração, os dados da ordem de compra através da mensagem REQUEST, adapter EICSI410, que dará início ao processo de importação; sendo assim, estará disponível nessa rotina apenas as opção Visualizar, para visualização dos processos integrados e Concorrências, para a geração do quadro de concorrências com as cotações para o item.
2. No Browse será possível visualizar o status de cada Ordem/ Solicitação de Importação integrada, podendo ser: Pendente (cor verde), Em processo de cotação (cor azul), Cotado no mercado nacional (cor cinza), Aguardando Purchase Order (cor amarela), Cancelado (cor preta) e Atendida – em fase de Purchase Order (cor vermelha). Os status são atualizados conforme o processo avança de fase no Easy Import Control ou podem vir da integração com o ERP de origem.
   No  módulo Easy Import Control os status podem mudar de Pendente para: 1) Em processo de cotação; 2) Aguardando Purchase Order e 3) Atendida – em fase de Purchase Order.
   No ERP de origem, a integração se dará com o envio da mensagem CANCELREQUEST, adapter EICSI411, e poderá alterar o status de Pendente para 1) Cotado no mercado nacional – com esse status, a Solicitação de Importação não poderá ser usada para a geração de um Purchase Order; e 2) Cancelado – com esse status, a Solicitação de Importação não poderá ser usada para iniciar um processo de Cotação ou um Purchase Order. A data e o motivo do cancelamento ficarão registrados na solicitação de importação, campos DT. Cancel  (W1_DT_CANC) e Motivo Canc. (W1_MOTCANC) respectivamente.
3. Posicione em uma Solicitação de Importação e acesse a opção Visualizar.
   Cada Orderm de Compra/ Solicitação de Importação terá um item. O número da Solicitação de Importação será o mesmo número da Ordem de Compra que originou a solicitação no ERP de Origem.
   Será possível consultar os dados gerais do Item, como quantidade, descrição e data de entrega prevista; também serão visualizadas as programações de entrega do item e o rateio por centro de custo (área e linha do ERP Logix), que posteriormente será usado para a integração com o Financeiro do ERP.

Sequencia 006 – Cotação de Preços

Pré-requisito:

• sequencia 1 concluída;
• integração de Fornecedores/ Fabricantes;
• integração do relacionamento Produtos vs. Fornecedor;
• cadastro de uma via de transporte (Atualizações / Cadastros / Vias de Transporte) e;
• cadastro de compradores (Atualizações / Tabelas / Compradores).

1. No Easy Import Control (SIGAEIC) acesse Atualizações / Solicit. Importação / Cotação de Preços (EICQC210). Serão exibidos no browse principal as concorrências existentes; a cada estará associada uma ou mais Solicitação de Importação (item) e para cada Solicitação de Importação poderá haver uma ou mais cotações. Para  essa rotina estarão disponíveis as opções de visualização, inclusão, alteração e exclusão. Para a operação de exclusão da concorrência, apenas será permitido se não constar uma cotação que esteja com o status “Aprovada” ou “Reprovada”. O acesso à essa rotina também poderá ser feita através da rotina de Solicitação  de Importação (Atualizações / Solicit. Importação / Manutenção) onde estará disponível a opção Concorrências.
2. Ao acessar a tela de manutenção através das opções Incluir ou Alterar, será exibida a tela dividida em três partes: a parte superior referenciando o quadro de concorrências; a parte inferior esquerda onde constarão os itens das solicitações de importação e a parte inferior direita onde, conforme o item selecionado do lado esquerdo, serão exibidas as cotações dos fornecedores selecionados para o quadro de concorrências. Na parte superior o usuário poderá informar os dados comuns para as cotações que irão fazer parte do quadro de concorrências, bem como a validade desse quadro sem a qual o registro não poderá ser gravado.
3. Para adicionar os itens da solicitação de importação (lado inferior esquerdo) em Ações Relacionadas deve ser acessada a opção Itens. Serão exibidos em um browse, com a opção marca/ desmarca, todos os itens das solicitações de importação que tenham saldo e que não pussuam uma cotação aprovada. Ao selecionar e confirmar, os itens serão inseridos na tela de concorrências. A linha do item poderá ser excluída desde que sua situação não seja “Aprovada”; ao excluir o item, todas as linhas correspondentes à cotação desse item também serão excluídas.
4.  Para adicionar fornecedores para cotação do item (lado inferior direito) em Ações Relacionadas deve ser acessada a opção Fornecedores. Assim como para os itens, os fornecedores disponíveis para uso serão exibidos em um browse com a opção marca/ desmarca. Os fornecedores selecionados serão incluídos no quadro de concorrência após a confirmação da seleção.
   As cotações dos fornecedores selecionados pelo usuário poderão assumir 4 (quatro) status: Aguardando Cotação – ocorrerá enquanto os dados de negociação como: valores, moeda, condição de pagamento, INCOTERM e previsão de entrega não forem informados; Aguardando Avaliação – com os dados da negociação preenchidos, a cotação poderá ser transmitida para avaliação do comprador/ aprovador; Aprovada – ocorrerá quando ocorrer a designação para a aquisição nesta condição de negociação e Reprovada – status das cotações que não atenderam as necessidades do negociador.
5. Com a confirmação da inclusão do quadro de concorrências, o sistema verificará as cotações que estão com o status “Aguardando Avaliação” e fará a integração via Mensagem Única - EAI com o ERP através da mensagem QUOTATION, adapter EICQC410, transmitindo os dados para avaliação. O mesmo ocorrerá após a alteração do quadro de concorrência, quando for identificado que existem novas cotações que tiveram seu status atualizado de “Aguardando Cotação” para “Aguardando Avaliação” ou na exclusão de cotações que haviam sido integradas ao ERP (status “Aguardando Avaliação”).
   Com a confirmação da inclusão do quadro de concorrências também ocorrerão as atualizações dos status das solicitações de importações, que passarão de “Pendente” para “Em processo de cotação”. Quando excluídas do quadro de concorrências, as solicitações de importações poderão ter seu status alterado de “Aguardando Avaliação” para “Pendente” desde que não estejam presente em outro quadro de concorrências.
6. Após passar pelo processo de avaliação, o ERP transmitirá ao Easy Import Control uma mensagem QUOTATION de designação da cotação. Neste momento o quadro de concorrências será atualizado e as cotações poderão assumir dois status: Aprovada e Reprovada. Quando uma das cotações receber o status de “Aprovada”, as demais serão atualizadas com o status “Reprovada” e a Solicitação de Importação terá seu status atualizado para “Aguardando Purchase Order”. Quando na avaliação do ERP a cotação aprovada referir-se ao mercado interno, ou seja, não houver designação para as cotações do mercado externo originadas pelo Easy Import Control, todas as cotações do quadro de concorrências receberão o status de “Reprovada”; o ERP também transmitirá uma mensagem de cancelamento da Ordem/ Solicitação de Importação (CANCELREQUEST), que passará a ter o status “Cotado no mercado nacional”.

 No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).