INTEGRADOR RFCSERVER

MASTERSAF INTEGRADOR RFCSERVER

DFE

SUMÁRIO

SUMÁRIO ..................................................................................................................... 2
OBJETIVO .................................................................................................................... 3
ARQUITETURA ............................................................................................................ 4
ARQUITETURA DE INTEGRAÇÃO SAP VS RFCSERVER ............................................................. 4

ESCOPO FUNCIONAL...................................................................................................................... 5

ESCOPO SOFTWARE RFC SERVER .............................................................................................. 5

PRÉ-REQUISITOS ....................................................................................................... 6
PRÉ-REQUISITOS DE SOFTWARE ................................................................................................. 6

PROCEDIMENTOS DE INSTALAÇÃO E ATUALIZAÇÃO ............................................ 9

INSTALAÇÃO DO SERVIÇO JBOSS ................................................................................................ 9

CONFIGURAÇÃO DO DATA SOURCE ............................................................................................ 9

CONFIGURAÇÃO DO ARQUIVO RFCSERVER.PROPERTIES..................................................... 10

ATUALIZAÇÃO DA VERSÃO .......................................................................................................... 13

2
Versão: 1
MASTERSAF INTEGRADOR RFCSERVER
DFE

OBJETIVO

Este documento tem como objetivo informar os pré-requisitos para a implantação ou atualização do
RFCServer, escopo de software fornecido, pré-requisitos, procedimentos de instalação e políticas de
suporte.

Este documento não pretende ser extensivo e nem descreve os procedimentos em detalhes, sendo o
ponto de partida para analise do ambiente do cliente e das ações necessárias.

Dependendo das características especificas do cliente outras ações podem ser necessárias que não
estejam descritas neste documento, sendo responsabilidade do Canal implementador apoiar o
cliente na avaliação das ações a serem tomadas.

3
Versão: 1
MASTERSAF INTEGRADOR RFCSERVER
DFE

ARQUITETURA

ARQUITETURA DE INTEGRAÇÃO SAP VS RFCSERVER

A conexão com o RFCServer é realizada através de adaptadores SAP Java Connector (SAP JCo 2),
que é um "Java Software Application" que permite o desenvolvimento de integrações compatíveis
com SAP e aplicativos em Java. O SAP JCo 2 suporta a comunicação com o servidor SAP em
ambas as direções: Chamadas de entrada (Java chama ABAP) e chamadas de saída (ABAP chama
Java).

O adaptador SAP JCo 2 conecta ao SAP através de um usuário RFC (Remote Function Call), o qual
é a interface padrão para estabelecer conexões entre sistemas SAP e não-SAP. Os RFCs utilizam
transferência por TCP/IP.

O Conector realiza conexão com SAP RFC Server através do SAPJco 2, que expões notas fiscais

4
Versão: 1
MASTERSAF INTEGRADOR RFCSERVER
DFE
enviadas pelo SAP ECC 6.0 através de atributos e funções da estrutura XML_OUT e XML_IN e
funções auxiliares MASTERSAF.
As estruturas XML_OUT e XML_IN são configuradas de acordo com o ambiente do cliente. A
responsabilidade desta configuração é do projeto de implementação. Os componentes
computacionais disponibilizados pela MASTERSAF e descritos neste documento, NÃO configuram
ou tornam disponível esta infraestrutura. O perfil funcional denominado BASIS realiza este setup.

As funções MASTERSAF são responsáveis por extrair informações complementares, ou seja, que
não são disponibilizadas na XML_OUT.

ESCOPO FUNCIONAL

O escopo do produto disponibilizado visa liberar a interoperação de dados de todos os processos

que o SAP ECC 6.0 também atenda de forma standard, desde que seja possível a extração dos
dados através dos componentes computacionais descritos na arquitetura.

 Emissão de Nota Fiscal Mercantil

 Cancelamento de Nota Fiscal Mercantil
 Inutilização de Nota Fiscal Mercantil
 Carta de Correção

ESCOPO SOFTWARE RFC SERVER

O software RFC Server é disponibilizado de acordo com a arquitetura de integração definida pela
MASTERSAF, levando em consideração as características técnicas e funcionais do produto SAP, e a
própria arquitetura de Integração definida pela MASTERSAF.

5
Versão: 1
MASTERSAF INTEGRADOR RFCSERVER
DFE

PRÉ-REQUISITOS

PRÉ-REQUISITOS DE SOFTWARE

1. MASTERSAF - GF/NFE

Entende-se que a instalação e aplicação de patches cumulativos e configuração do MASTERSAF

- GF/NFE já foi realizada, com seus devidos cadastros e setups iniciais.

2. Java

Baixar Java JRE 1.6 compatível com o Sistema Operacional de cada ambiente (Windows e
demais plataformas dos servidores, se necessário).

3. SAP e RFC Server

SAP ECC 6.0 e Remote Function Call Server, instalados, configurados e conectados entre si.

4. SAP JCO 2

Conector SAP configurado e instalado no mesmo servidor do Conector.

Para realizar download do SAPJCO 2 acessar:

http://service.sap.com/connectors

Este arquivo é disponibilizado pela correta instalação do SAP Client. Nos nossos ambientes não
foi necessária instalação do SAP Client apenas a disponibilização do arquivo no local
especificado.
Inconformidades na instalação do SAPJCO 2 devem ser tratadas com suporte da SAP.

6
Versão: 1
MASTERSAF INTEGRADOR RFCSERVER
DFE
5. JBOSS APPLICATION SERVICE

O servidor de aplicações JBOSS, versão 4.2 ou compatível precisa estar instalado e configurado.
O servidor de aplicação JEE JBoss AS 4.2, está disponível no link
http://sourceforge.net/projects/jboss/files/JBoss/JBoss-4.2.0.GA/

6. NOTAS SAP

A nota SAP 1589975 contém uma visão geral das soluções da SAP para cobrir os requisitos
legais do Brasil que envolvem Notas fiscais Eletrônicas, publicados através de Notas Técnicas,
no sitio do Ministério da Fazenda. Ela contém todas as notas que a SAP lançou para o correto
funcionamento da Nota Fiscal Eletrônica.

Para maiores informações consultar o link:

http://service.sap.com/sap/support/notes/1589975

Esta nota não se refere apenas a nota fiscal mercantil, também envolve notas fiscais de serviço e
todo processo de emissão de nota.

7
Versão: 1
MASTERSAF INTEGRADOR RFCSERVER
DFE
7. Permissões no SAP

O usuário de comunicação precisa estar vinculado a role R3_RFCCALL

8
Versão: 1
MASTERSAF INTEGRADOR RFCSERVER
DFE

PROCEDIMENTOS DE INSTALAÇÃO E
ATUALIZAÇÃO

INSTALAÇÃO DO SERVIÇO JBOSS

Descompactar o pacote de instalação do JBOSS no diretório base, JBOSS-HOME.

Entrar na pasta <JBOSS-HOME/bin>, através do terminal, como administrador, executar o comando

“service.bat install”. Após esse comando, o serviço estará disponível na lista de serviços do
Windows. Para iniciar ou parar o serviço, execute o comando services.msc e localize o serviço do
JBoss que, por padrão, estará com o nome “JBoss Application Service 4.2”.

CONFIGURAÇÃO DO DATA SOURCE

Acessar a pasta <JBOSS-HOME>/server/default/deploy

Criar o arquivo “nfe-alliance-ds.xml”, com o conteúdo a seguir:

<datasources>
<local-tx-datasource>
<jndi-name>jdbc/NFeAllianceDS</jndi-name>
<connection-url>V_URL</connection-url>
<driver-class>V_DRIVER</driver-class>
<user-name>V_USUARIO</user-name>
<password>V_SENHA</password>
<min-pool-size>1</min-pool-size>
<max-pool-size>100</max-pool-size>
<query-timeout>60</query-timeout>
<exception-sorter-class-
name>org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter</exception-sorter-class-name>

9
Versão: 1
MASTERSAF INTEGRADOR RFCSERVER
DFE
<metadata>
<type-mapping>V_TYPE</type-mapping>
</metadata>
</local-tx-datasource>
</datasources>

Substituir as variáveis que começam com “V_” com a seguinte regra:

V_URL: Informar a url para conexão ao banco MasterGF:

OBS.: jdbc:oracle:thin:@IP:PORTA:NOME_DO_BANCO ou
jdbc:sqlserver://IP:PORTA;DatabaseName=NOME_DO_BANCO

V_DRIVER: Driver utilizado para o acesso ao banco:

OBS.: oracle.jdbc.driver.OracleDriver ou com.microsoft.sqlserver.jdbc.SQLServerDriver

V_USUARIO: Usuário do banco de dados

V_SENHA: Senha do usuário
V_TYPE: Tipo de mapeamento do banco de dados

OBS.: Oracle11i, Oracle9i, MS SQLSERVER2000

CONFIGURAÇÃO DO ARQUIVO RFCSERVER.PROPERTIES

Acessar arquivo properties-service.xml e incluir a configuração abaixo dentro da tag <server>

<mbean code="org.jboss.varia.property.SystemPropertiesService"

10
Versão: 1
MASTERSAF INTEGRADOR RFCSERVER
DFE
name="jboss.util:type=Service,name=SystemProperties">
<!-- Load properties from each of the given comma separated URLs -->
<attribute name="URLList">
/conf/rfcserver.properties
</attribute>
</mbean>

Localização do arquivo: <JBOSS-HOME>server\default\deploy\properties-service.xml

Criar arquivo rfcserver.properties dentro do diretório de configuração contendo o dado abaixo:

data8caract=1
Localização do arquivo: <JBOSS-HOME>server\default\default\conf\rfcserver.properties

Pronto, o serviço já estará configurado. Para verificar se a configuração foi bem sucedida, abra o
11
Versão: 1
MASTERSAF INTEGRADOR RFCSERVER
DFE
arquivo server.log e verifique se aparece a mensagem “Loaded system properties from” apontando
para o arquivo rfcserver.properties

1. Configuração do dialeto do banco de acesso ao MasterGF

Acessar a pasta <JBOSS-HOME>/ server/default/deploy/ejb3.deployer/META-INF

Abrir o arquivo persistence.properties e acrescentar a linha abaixo:

hibernate.dialect=org.hibernate.dialect.OracleDialect para Oracle ou

hibernate.dialect=org.hibernate.dialect.SQLServerDialect

2. Configuração de acesso ao SAP

Acessar a tela FIS10001 e preencher os dados para acesso ao SAP

12
Versão: 1
MASTERSAF INTEGRADOR RFCSERVER
DFE

ATUALIZAÇÃO DA VERSÃO

Substituir o arquivo EAR que fica localizado na pasta <JBOSS>\SERVER\DEFAULT\DEPLOY

IMPORTANTE: Só pode ser mantido um arquivo EAR na pasta, utilizar o arquivo que foi realizado o
download ou o disponibilizado pelos analistas MASTERSAF.

13
Versão: 1
MASTERSAF INTEGRADOR RFCSERVER
DFE

POLÍTICAS DE SUPORTE
Aplicam-se todas as regras descritas no documento “Integrator_RFCServer-
SAP_Politicas_De_Suporte_pt.pdf“.

14
Versão: 1