Histórico da Página
ME DO REQUISITO
Características do Requisito
Linha de Produto: | Protheus | ||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmento: | Manufatura | ||||||||||||||||||||||||||||||||||||||||||||||||||||
Módulo: | Easy Export Control (SIGAEEC) | ||||||||||||||||||||||||||||||||||||||||||||||||||||
Rotina: |
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
Cadastros Iniciais: |
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
País(es): | Brasil | ||||||||||||||||||||||||||||||||||||||||||||||||||||
Banco(s) de Dados: | SQL/ORACLE | ||||||||||||||||||||||||||||||||||||||||||||||||||||
Tabelas Utilizadas: | Informe as tabelas utilizadas. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
Sistema(s) Operacional(is): | Windows/Linux |
Descrição
Foi implementada a 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:
Cadastros (SIGAEEC):
- Cadastro da unidade de medida (recebimento);
- Cadastro de conversão ente unidades de medida (recebimento)
- Cadastro de produtos (recebimento);
- Cadastro de Embalagens(recebimento);
- Cadastro de Relacionamento de embalagens (recebimento)
- Cadastro de Cliente/ Fornecedor (recebimento);
- Cadastro de Empresas (recebimento)
- Cadastro de Banco (recebimento);
- Cadastro de Cotação das moedas (recebimento e envio);
Negócio: Fase de Pedido (SIGAEEC)
- Pedido de Exportação (recebimento e envio);
- Notas Fiscais de Saída da Mercadoria (recebimento);
Negócio: Fase de Embarque (SIGAEEC)
- Solicitação de Numerário (envio);
- Embarque das mercadorias (envio);
- Variação cambial gerada pelo embarque das mercadorias faturadas (envio);
- Geração de títulos a pagar efetivos referente as despesas internacionais de exportação (envio);
- Geração de títulos a pagar efetivos referente as despesas nacionais de exportação (envio);
- Geração de títulos a pagar efetivos referente aos adiantamentos feitos ao despachante (envio);
- Geração de títulos a receber efetivos referente ao adiantamento ao fornecedor (envio);
- Geração de títulos a receber efetivos referente ao embarque das mercadorias (envio);
- Geração de títulos a pagar efetivos referente as comissões a pagar sobre exportação (envio);
- Contabilização da comissão em conta gráfica
Negócio: Registro SINTEGRA
- Registro SINTEGRA 85-86 (envio)
EC6– Eventos Contábeis ECE– Processos Estornados ECI– Contas por Banco EE5– Embalagens EE6– Disponibilidade de Navios EE7– Processo de Exportação EE8– Itens do Processo de Exportação EE8– Itens Processo de Exportação EE9– Itens do Embarque EEA– Configuração Documentos EEB– Agentes de um Pedido EEC– Embarque EEE– Instrumento de Negociação EEM– Controle de Notas Fiscais EEN– Notify EEQ– Valor das Parcelas do Embarque EES– Notas Fiscais por Itens EET– Despesas de Exportação EEU– Numerário de Exportação EF3– Eventos do Contrato EF7– Tipos de Financiamento EF8– Encargos do Financiamento EXJ– Dados Adicionais do Cliente EXL– Dados Complementares Embarque EYE– Serviços EYH– Estufagem de Mercadorias EYI– Dados Complementares do Exportador EYJ– Dados Complementares do Produto SA1– Clientes SA6– Bancos SAH– Unidades de Medida SY5– Despachantes/ Empresas SY6– Condições de Pagamento SY9– Portos e Aeroportos SYA– Países SYB– Despesas SYE– Taxa de Conversão SYF– Moedas ECF– Lançamentos contábeis | |
Sistema(s) Operacional(is): | Windows/Linux |
Descrição
Foi implementada a 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:
Cadastros (SIGAEEC):
- Cadastro da unidade de medida (recebimento);
- Cadastro de conversão ente unidades de medida (recebimento)
- Cadastro de produtos (recebimento);
- Cadastro de Embalagens(recebimento);
- Cadastro de Relacionamento de embalagens (recebimento)
- Cadastro de Cliente/ Fornecedor (recebimento);
- Cadastro de Empresas (recebimento)
- Cadastro de Banco (recebimento);
- Cadastro de Cotação das moedas (recebimento e envio);
Negócio: Fase de Pedido (SIGAEEC)
- Pedido de Exportação (recebimento e envio);
- Notas Fiscais de Saída da Mercadoria (recebimento);
Negócio: Fase de Embarque (SIGAEEC)
- Solicitação de Numerário (envio);
- Embarque das mercadorias (envio);
- Variação cambial gerada pelo embarque das mercadorias faturadas (envio);
- Geração de títulos a pagar efetivos referente as despesas internacionais de exportação (envio);
- Geração de títulos a pagar efetivos referente as despesas nacionais de exportação (envio);
- Geração de títulos a pagar efetivos referente aos adiantamentos feitos ao despachante (envio);
- Geração de títulos a receber efetivos referente ao adiantamento ao fornecedor (envio);
- Geração de títulos a receber efetivos referente ao embarque das mercadorias (envio);
- Geração de títulos a pagar efetivos referente as comissões a pagar sobre exportação (envio);
- Contabilização da comissão em conta gráfica
Negócio: Registro SINTEGRA
- Registro SINTEGRA 85-86 (envio)
Procedimento para Configuração
As atualizações disponibilizadas através deste Boletim Técnico adequam o produto Easy Export 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
Procedimento para Configuração
CONFIGURAÇÃO DE PARÂMETROS
No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Configure os parâmetros a seguir:
Itens/Pastas | Descrição |
Nome: | MV_EAIPORT |
Tipo: | Caracter |
Cont. Por.: | RECEIVEMESSAGE |
Descrição: | Indica qual a porta de entrada dos Mapas do ESB
|
Itens/Pastas | Descrição |
Nome: | MV_EAIMETH |
Tipo: | Caracter |
Cont. Por.: | RECEIVEMESSAGE |
Descrição: | Informe o metodo de envio do EAI para envio a outro EAI |
Itens/Pastas
Descrição
Nome:
MV_EAIURL2
Tipo:
Caracter
Cont. Por.:
http:// IP + Porta /Nome do Web Service/EAISERVICE.apw
Descrição:
- No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Configure os parâmetros a seguir:
Itens/Pastas | Descrição |
Nome: | MV_EAIWSEAIPORT |
Tipo: | Caracter |
Cont. Por.: | WSFWWSEAIRECEIVEMESSAGE |
Descrição: | Indica qual a porta de entrada dos Mapas do ESB Informe o nome do Client WebService do EAI para envio a outro EAI |
Itens/Pastas | Descrição |
Nome: | MV_EAIXSDEAIMETH |
Tipo: | Caracter |
Cont. Por.: | Informe o diretorio dos XSD usados na validação do EAIRECEIVEMESSAGE |
Descrição:\xsd\totvsmessage | Informe o metodo de envio do EAI para envio a outro EAI |
Itens/Pastas | Descrição |
Nome: | MV_EECI010EAIURL2 |
Tipo: | LógicoCaracter |
Cont. Por.:.T. | http:// IP + Porta /Nome do Web Service/EAISERVICE.apw |
Descrição:Habilita integração do Módulo SIGAEEC via Mensagem Única. | Informe o nome do canal configurado no EAI para outro EAI |
Itens/Pastas | Descrição |
Nome: | MV_AVG0037EAIWS |
Tipo: | Caracter |
Cont. Por.: | INGLESWSFWWSEAI |
Descrição: | Código do idioma inglêsInforme o nome do Client WebService do EAI para envio a outro EAI |
Itens/Pastas | Descrição |
Nome: | MV_AVG0119EAIXSD |
Tipo: | LógicoCaracter |
Cont. Por.:.F. | Informe o diretorio dos XSD usados na validação do EAI |
Descrição:Ativa a rotina de desconto por item | \xsd\totvsmessage |
Itens/Pastas | Descrição |
Nome: | MV_AVG0131EECI010 |
Tipo: | Lógico |
Cont. Por.: | .FT. |
Descrição:Define se está integrado com o módulo Financeiro (SIGAFIN) | Habilita integração do Módulo SIGAEEC via Mensagem Única. |
Itens/Pastas | Descrição |
Nome: | MV_AVG0205AVG0037 |
Tipo: | Caracter |
Cont. Por.: | XPINGLES |
Descrição: | Tipo do Documento para Emb. de exportaçãoCódigo do idioma inglês |
Itens/Pastas | Descrição |
Nome: | MV_AVG0206AVG0119 |
Tipo: | CaracterLógico |
Cont. Por.: | .F. |
Descrição: | Embalagem padrão para pedido de exportação integrado via Mensagem Única |
Obs: Necessita cadastro prévio da embalagem no ERP Protheus e que o código desta embalagem seja o disposto no parâmetro.
Ativa a rotina de desconto por item |
Itens/Itens/Pastas | Descrição |
Nome: | MV_AVG0207AVG0131 |
Tipo: | CaracterLógico |
Cont. Por.: | .F. |
Descrição: | Cond. de Pagto padrão para pedido de exportação integrado via Mensagem Única |
Obs: Necessita cadastro prévio da condição de pagamento no ERP Protheus e que o código desta condição de pagamento seja o disposto no parâmetro.
Define se está integrado com o módulo Financeiro (SIGAFIN) |
Itens/Pastas | Descrição |
Nome: | MV_AVG0208AVG0205 |
Tipo: | Caracter |
Cont. Por.: | XP |
Descrição: | Tipo do Documento para Emb. de exportação |
Itens/Pastas | Descrição |
Nome: | MV_AVG0206 |
Tipo: | Caracter |
Cont. Por.: |
|
Descrição: | Embalagem Via de Transp. padrão para pedido de exportação integrado via Mensagem Única |
Obs: Necessita cadastro prévio da via de transporte embalagem no ERP Protheus e que o código desta via de transporte seja desta embalagem seja o disposto no parâmetro.
Itens/Pastas | Descrição |
Nome: | MV_AVG0209AVG0207 |
Tipo: | Caracter |
Cont. Por.: |
|
Descrição: | Incoterm Cond. de Pagto padrão para pedido de exportação integrado via Mensagem Única |
Obs: Necessita cadastro prévio do INCOTERM da condição de pagamento no ERP Protheus e que o código deste INCOTERM seja o desta condição de pagamento seja o disposto no parâmetro.
Itens/Pastas | Descrição |
Nome: | MV_AVG0210AVG0208 |
Tipo: | Caracter |
Cont. Por.: |
|
Descrição: | Centro Via de Custo Transp. padrão para título pedido de adiantamento de exportação integrado por mensagem única. |
via Mensagem Única |
Necessita cadastro prévio da via de transporte no ERP Protheus e que o código desta via de transporte seja o disposto no parâmetro.
Itens/Pastas | Descrição |
Nome: | MV_AVG0215AVG0209 |
Tipo: | Caracter |
Cont. Por.: |
|
Descrição: | Portador da conta para baixa do titulo a receber |
Incoterm padrão para pedido de exportação integrado via Mensagem Única |
Necessita cadastro prévio do INCOTERM no ERP Protheus e que o código deste INCOTERM seja o disposto no parâmetro.
Itens/Pastas | Descrição |
Nome: | MV_AVG0216AVG0210 |
Tipo: | Caracter |
Cont. Por.: |
|
Descrição:Tipo do Portador da conta para baixa do titulo a receber | Centro de Custo padrão para título de adiantamento de exportação integrado por mensagem única. |
Informação é obtida do ERP Externo
Itens/Pastas | Descrição |
Nome: | MV_AVG0220AVG0215 |
Tipo: | Caracter |
Cont. Por.:PRD.: |
|
Descrição:Parâmetro para código da embalagem na integração | Portador da conta para baixa do titulo a receber |
Informação é obtida do ERP Externo
Itens/Pastas | Descrição |
Nome: | MV_EEC0009AVG0216 |
Tipo: | Caracter |
Cont. Por.: | #EE7_PEDIDO# |
Descrição:Máscara para o pedido de exportação integrado via Mensagem Única. | Tipo do Portador da conta para baixa do titulo a receber |
Informação é obtida do ERP Externo
Itens/Pastas | Descrição |
Nome: | MV_EEC0012AVG0220 |
Tipo: | LógicoCaracter |
Cont. Por.: | PRD.T.: |
Descrição: | Parâmetro para código da embalagem na integração |
Itens/Pastas | Descrição |
Nome: | MV_EEC0009 |
Tipo: | Caracter |
Cont. Por.: | #EE7_PEDIDO# |
Descrição: | Máscara para o pedido de exportação integrado via Mensagem Única. |
Itens/Pastas | Descrição |
Nome: | MV_EEC0012 |
Tipo: | Lógico |
Cont. Por.: | .T. |
Descrição: | Define se irá enviar Define se irá enviar o pedido de exportação via mensagem única à outro ERP |
Itens/Pastas | Descrição |
Nome: | MV_EEC0025 |
Tipo: | Lógico |
Cont. Por.: | .T. |
Descrição: | Se ligado, envia valor de título a receber com comissão e baixa o valor da comissão. |
Itens/Pastas | Descrição |
Nome: | MV_EEC0027 |
Tipo: | Caracter |
Cont. Por.: |
|
Descrição: | Indica qual valor a ser enviado na integração de variação cambial de nota fiscal via mensagem única. 1=Variação NF x Embarque;2=Valor atualizado NF |
Itens/Pastas | Descrição |
Nome: | MV_EEC0028 |
Tipo: | Caracter |
Cont. Por.: |
|
Descrição: | Código do Portador da Baixa de títulos do tipo Comissão a Deduzir da Fatura |
Itens/Pastas | Descrição |
Nome: | MV_EEC0029 |
Tipo: | Caracter |
Cont. Por.: |
|
Descrição: | Tipo do Portador da Baixa de tÍtulos do tipo Comissão a Deduzir da Fatura |
Itens/Pastas | Descrição |
Nome: | MV_EEC0033 |
Tipo: | Caracter |
Cont. Por.: |
|
Descrição: | Define a empresa de destino das mensagens de contas a receber na integração via mensagem única. |
Itens/Pastas | Descrição |
Nome: | MV_EEC0035 |
Tipo: | Caracter |
Cont. Por.: |
|
Descrição: | Define a empresa de destino das mensagens bancárias na integração via mensagem única. |
Itens/Pastas | Descrição |
Nome: | MV_EEC0036 |
Tipo: | Caracter |
Cont. Por.: |
|
Descrição: | Define a empresa de destino das mensagens de contas a pagar na integração via mensagem única. |
Itens/Pastas | Descrição |
Nome: | MV_EECFAT |
Tipo: | Lógico |
Cont. Por.: | .F.
|
Descrição: | Define se está integrado com o módulo de Faturamento (SIGAFAT) |
CONFIGURAÇÃO DE WEB SERVICE PROTHEUS
- Em Programa Inicial digite SRVWIZARD para acessar o Wizard.
- Informe o Usuário e a Senha.
- Acesse Módulos WEB e clique em Incluir.
- 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.
- Será exibida a pergunta “Deseja descompactar o pacote de arquivos HTTP na pasta especificada?”, clique em “Sim”.
- 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.
- Informe o número mínimo (Exemplo: 10) e máximo de usuários (Exemplo: 10) e clique em Finalizar.
- O sistema irá exibir um aviso sobre a instalação do Web Service e questiona se deseja iniciar tal instalação. Clique em Sim.
- Após a instalação, certifique-se de que o WebService está no ar. Para tanto, digite no campo de endereço do navegador de internet o endereço do webservice criado que deve conter: http://<ip : porta>/ <instância do webservice> / <rotina> onde a rotina utilizada para listar os serviços ativos no WebService Protheus é a rotina “wsindex.apw”. Conforme a configuração feita nos exemplos deste documento, fica da seguinte forma: http://localhost:91/ws/wsindex.apw. O WebService irá carregar a página com a listagem dos serviços.
CONFIGURAÇÃO DE JOB DO SCHEDULER DO PROTHEUS
- Em Programa Inicial digite SRVWIZARD para acessar o Wizard.
- Informe o Usuário e a Senha.
- Acesse Processos Comuns e clique em Incluir.
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) - Clique em finalizar.
- Acesse novamente Processos novamente Processos Comuns e clique em Incluir.
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)
- Clique em finalizar.
- Após essa configuração, é necessário reiniciar o serviço do Protheus.
CONFIGURAÇÃO DE AGENTE DO SCHEDULER PROTHEUS
1.- No Configurador (SIGACFG) acesse Ambiente/Schedule/Schedule (CFGA010).
- Em Agent/Cadastro, clique em Incluir.
Preencha os dados na tela para criação do Agente e clique em Confirmar.
Itens/Pastas Descrição
Nome do
Agente
FWSCHDQUEUE
Função ADVPL
IP
Endereço IP onde o Server Protheus está ativo
Porta
Porta onde o Server Protheus está ativo
Ambiente (
preenchimento automático)
Empresa (preenchimento automático) Filial (preenchimento automático) No. Threads 3 Habilitado (preenchimento automático) - Em Agent inicie o serviço criado.
- 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
- No Configurador (SIGACFG) acesse Ambiente/Schedule/Schedule (CFGA010).
- Em Agendamentos/Cadastro, clique em Incluir.
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) 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”.
- Clique em Confirmar para fechar a tela de recorrência. Clique em confirmar para salvar a configuração da tarefa.
- Recomendado reiniciar o serviço do Protheus após a configuração do agendamento.
CONFIGURAÇÃO DO APPSERVER DO PROTHEUS
- Localize o arquivo appserver.ini, no diretório \bin, onde encontra-se a instalação dos binários do serviço do Protheus.
- Com um editor de texto, abra o arquivo, e localize a seção [GENERAL].
- 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
- 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.
- No Configurador (SIGACFG) acesse Ambiente/Schedule/Emp.fil Msg.Unica (APCFG050).
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 - 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:
Grupo | Descrição |
001 | Código de Cliente/Fornecedor |
018 | Documento de entrada/saída |
030 | Tamanho do Produto |
084 | Unidade Requisitante |
089 | Código de empresa / despachante |
094 | Série das Notas Fiscais |
CONFIGURAÇÃO DE ADAPTER
O módulo Easy Export Control e Easy Financing Control estão preparados para a realização das integrações que seguem. O uso de cada uma delas deve ser avaliado conforme escopo de integração previsto. Na realização dos cadastros, deve ser observada a definição do método (que pode ser alterada, conforme definição da necessidade), para que fiquem iguais nos ERPs que trocarão a mensagem.
O campo XSD indica com qual layout o arquivo XML da integração é validado. Este campo somente deve ser informado em caso de testes e caso o arquivo .XSD correspondente a mensagem seja fornecido pela TOTVS e armazenado no diretório indicado no parâmetro MV_EAIXSD.
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:
MENSAGENS DA FASE DE CADASTROS
Itens/pastas | Descrição |
Rotina | EECAC120 |
Mensagem | ITEM |
Descrição | PRODUTO |
Envia | NÃO |
Recebe | SIM |
Método | ASSÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAS125 |
Mensagem | UNITOFMEASURE |
Descrição | UNIDADE DE MEDIDA |
Envia | NÃO |
Recebe | SIM |
Método | ASSÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EICTU100 |
Mensagem | UNITOFMEASURECONVERSION |
Descrição | CONVERSAO ENTRE UN. DE MEDIDA |
Envia | NÃO |
Recebe | SIM |
Método | ASSÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAT170 |
Mensagem | PACKAGING |
Descrição | EMBALAGENS |
Envia | NÃO |
Recebe | SIM |
Método | ASSÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAT171 |
Mensagem | PACKAGINGRELATIONSHIP |
Descrição | RELACIONAMENTO DE EMBALAGENS |
Envia | NÃO |
Recebe | SIM |
Método | ASSÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAC175 |
Mensagem | CUSTOMERVENDOR |
Descrição | CLIENTES/FORNECEDORES |
Envia | NÃO |
Recebe | SIM |
Método | ASSÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAC115 |
Mensagem | COMPANY |
Descrição | EMPRESAS |
Envia | NÃO |
Recebe | SIM |
Método | ASSÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAC110 |
Mensagem | BANK |
Descrição | CONTAS BANCARIAS |
Envia | NÃO |
Recebe | SIM |
Método | ASSÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAT140 |
Mensagem | CURRENCYQUOTATION |
Descrição | COTAÇÃO DE MOEDAS |
Envia | NÃO |
Recebe | SIM |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAT141 |
Mensagem | CURRENCYQUOTATION |
Descrição | COTAÇÃO MOEDAS - TAXA FISCAL |
Envia | NÃO |
Recebe | SIM |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAT142 |
Mensagem | CURRENCYQUOTATION |
Descrição | COTACAO MOEDAS - TAXA COMPRA |
Envia | NÃO |
Recebe | SIM |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAT143 |
Mensagem | CURRENCYQUOTATION |
Descrição | COTACAO MOEDAS - TAXA VENDA |
Envia | NÃO |
Recebe | SIM |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
MENSAGENS DA FASE DE PEDIDO
Itens/pastas | Descrição |
Rotina | EECAP100 |
Mensagem | SALESORDER |
Descrição | PEDIDO DE EXPORTAÇÃO |
Envia | SIM |
Recebe | SIM |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECNF400 |
Mensagem | INVOICE |
Descrição | NOTA FISCAL DE SAIDA |
Envia | NÃO |
Recebe | SIM |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.001 |
MENSAGENS DA FASE DE EMBARQUE
Itens/pastas | Descrição |
Rotina | EECAF223 |
Mensagem | SHIPMENTOFEXPORTINVOICE |
Descrição | EMBARQUE DE MERCADORIAS |
Envia | NÃO |
Recebe | SIM |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAF224 |
Mensagem | ACCOUNTINGENTRY |
Descrição | VARIAÇÃO CAMBIAL (EMBARQUE) |
Envia | SIM |
Recebe | NÃO |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
DESPESAS DE EXPORTAÇÃO
Itens/pastas | Descrição |
Rotina | EECAF214 |
Mensagem | ACCOUNTPAYABLEDOCUMENT |
Descrição | TIT. A PAGAR (DESP. INTERNAC.) |
Envia | SIM |
Recebe | NÃO |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAF215 |
Mensagem | ACCOUNTPAYABLEDOCUMENTDISCHARGE |
Descrição | BAIXA TIT. A PAGAR (DESP.INT) |
Envia | SIM |
Recebe | NÃO |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAF222 |
Mensagem | REVERSALOFACCOUNTPAYABLEDOCUMENTDISCHARGE
|
Descrição | TIT. A PAGAR (EST.BAIXA) |
Envia | SIM |
Recebe | NÃO |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAF216 |
Mensagem | ACCOUNTPAYABLEDOCUMENT |
Descrição | TIT. A PAGAR (DESP. NACIONAIS) |
Envia | SIM |
Recebe | NÃO |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
CÂMBIO DE EXPORTAÇÃO
Itens/pastas | Descrição |
Rotina | EECAF212 |
Mensagem | ACCOUNTRECEIVABLEDOCUMENT |
Descrição | TITULO ADIANT. A RECEBER (INCLUSAO) |
Envia | SIM |
Recebe | NÃO |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAF227 |
Mensagem | ACCOUNTRECEIVABLEDOCUMENTDISCHARGE |
Descrição | TIT. ADIANT. A RECEBER (BAIXA) |
Envia | SIM |
Recebe | NÃO |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAF230 |
Mensagem | REVERSALOFACCOUNTRECEIVABLEDOCUMENTDISCHARGE |
Descrição | TIT. ADIANT. A RECEBER (ES.BX) |
Envia | SIM |
Recebe | NÃO |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAF210 |
Mensagem | ACCOUNTRECEIVABLEDOCUMENT |
Descrição | TIT. PRINC. A RECEBER (INC) |
Envia | SIM |
Recebe | NÃO |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAF213 |
Mensagem | ACCOUNTRECEIVABLEDOCUMENTDISCHARGE |
Descrição | TIT. PRINC. A RECEBER (BAIXA) |
Envia | SIM |
Recebe | NÃO |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAF221 |
Mensagem | REVERSALOFACCOUNTRECEIVABLEDOCUMENTDISCHARGE |
Descrição | TIT. PRINC. A RECEBER(EST. BX) |
Envia | SIM |
Recebe | NÃO |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAF231 |
Mensagem | ACCOUNTRECEIVABLEDOCUMENTDISCHARGE |
Descrição | TITULO COMISSÃO (BAIXA) |
Envia | SIM |
Recebe | NÃO |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECAF232 |
Mensagem | REVERSALOFACCOUNTRECEIVABLEDOCUMENTDISCHARGE |
Descrição | TITULO COMISSÃO (EST. BAIXA) |
Envia | SIM |
Recebe | NÃO |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECLC510 |
Mensagem | ACCOUNTINGENTRY |
Descrição | CONTAB. DE COMISSAO CONTA GRAF |
Envia | SIM |
Recebe | NÃO |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
Itens/pastas | Descrição |
Rotina | EECREG85 |
Mensagem | SINTEGRAREGISTER-85-86 |
Descrição | SINTEGRA – REGISTRO 85/86 |
Envia | SIM |
Recebe | NÃO |
Método | SÍNCRONO |
Operação | TODAS |
Canal de Envio | EAI |
Versão | 1.000 |
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) |
Procedimento para Utilização
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 camposTp. Titulo(EC6_TPTIT),Tx.Vda./Comp. (EC6_TXCV) eTp.Despesa (EC6_NATFIN), da pasta Outros o campoPrefixo (EC6_PREFIX).
- Evento 103 – PROV. SEGURO: da pasta Financeiro, os campos Tp. Titulo(EC6_TPTIT),Tx.Vda./Comp. (EC6_TXCV) eTp.Despesa (EC6_NATFIN), da pasta Outros o campoPrefixo (EC6_PREFIX).
- Evento 150 – DESPESAS PROVISÓRIAS: da pasta Financeiro, os campos Tp. Titulo(EC6_TPTIT),Tx.Vda./Comp. (EC6_TXCV) eTp.Despesa (EC6_NATFIN), da pasta Outros o campoPrefixo (EC6_PREFIX).
- Evento 120 – COMISSÃO A REMETER: 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 121 – COMISSÃO EM CONTA GRÁFICA: 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 122 – COMISSÃO A DEDUZIR: 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 580/581 – VARIAÇÃO CAMBIAL NF: 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 576/577 – V.C. COMISSäO C GRAF: 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)
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. |
...