Parametrizações para integração com o Gestão Empresarial | ERP

1. Acesse Cadastros > Filiais > Parâmetros por Gestão > Vendas, Faturamento e Transporte (F070FVE)
2. Na guia Documentos Eletrônicos, no campo Software Emissor NF-e informe "00 – eDocs - Envio via Arquivo e retorno via Web Service ERP"
3. Nos parâmetros que indicam integração de NF-e, NFS-e, CT-e e MDF-e, defina como retorno automático, independentemente da versão do leiaute de emissão de cada um dos documentos
4. Na guia Transporte, também defina retorno automático nos parâmetros que indicam integração de NF-e, NFS-e, CT-e e MDF-e

Observação

Para integração de NFS-e é obrigatório que seja utilizado o leiaute "4 - Padrão (ABRASF) – Retorno Automático". Caso haja necessidade de gerar a tag InfSenior no .XML da NFS-e (para atender pré-requisitos de Prefeituras homologadas), o identificador de regras GER-000GERSDE1 deverá estar habilitado no ERP.

1. Acesse Cadastros > Mercado e Suprimentos > Parâmetros Fiscais > Séries Notas Fiscais > Cadastro (F020SNF), confira o cadastro das séries legais que serão utilizadas para emissão de cada documento
2. No campo Dispositivo Autorizado determine o tipo de documento fiscal que será gerado:
   • caso o dispositivo autorizado da série for "8 - Nota Fiscal Eletrônica de Serviço" e o código da série legal seja alfanumérico, é necessário cadastrar um identificador de integração numérico no campo Cód. Integração. Esse campo deverá ser único entre todas as séries com este dispositivo autorizado da filial e não poderá ser idêntico a uma série legal de outra série com dispositivo autorizado "8 - Nota Fiscal Eletrônica de Serviço" da mesma filial. Essa informação é utilizada para a integração correta de retornos das NFS-e do eDocs para o ERP
   • para os dispositivos autorizados "6 - Nota Fiscal Eletrônica", "10 - Nota Fiscal Consumidor Eletrônica", CT-e e CT-e OS, o código da série legal deve ser informado sem zeros à esquerda
   • para o dispositivo "9 - Manifesto Eletrônico", poderá ser utilizada a série legal 0 (zero), pois MDF-e não é um documento fiscal e permite a utilização dessa série. Ainda assim, preencha apenas o campo Série/Subsérie Legal com um único 0 (zero)
3. Obrigatoriamente, no campo Dir. Arq. Doc. Eletrônicos, preencha o diretório da filial do eDocs que irá receber o arquivo .XML gerado pelo Gestão Empresarial. O diretório deve ser preenchido considerando a pasta Processar\<Documento_Eletrônico>, criada pelo eDocs para processamento dos arquivos .XMLs da filial. Por exemplo, \\Servidor\Senior\Integracao\Empresa1\Filial1\Processar\Nfe;
   

   Importante

   Indique o diretório de integração adequado para cada série/filial. Se for definida a geração do .XML de um documento de uma filial para integrar no diretório de outra filial no eDocs, ocorrerá erro de integração e, consequentemente, não haverá o retorno do documento do eDocs para o Gestão Empresarial.

4. Em Dir. Boleto Doc. Eletrônico informe o diretório para a geração dos boletos relativos à nota fiscal

1. Acesse Monitor eDocs > Configuração > Empresa
2. Na guia Integração, seção Integração, indique em ERP usa padrão W3C nas URLs, se os web services do Gestão Empresarial estarão disponíveis através de URLs no padrão W3C. Nesse caso, verifique na Central de Configurações Senior do ERP, em Chaves, qual o valor atribuído para a chave com.senior.middleware.webservices.w3c_standard_wsnames. Se o valor da chave for "true", o sistema está configurado para utilizar web service padrão W3C. Se o valor desta chave for "false", o sistema está configurado para não utilizar o padrão W3C. Se o parâmetro não for configurado conforme definições do ERP, o web service poderá não ser localizado para fazer o retorno dos documentos;
3. Em URL Web Service integração ERP informe servidor e a porta para comunicação com o Middleware/GlassFish do ERP, que receberá os retornos enviados pelo eDocs. Por exemplo, http://servidorerp:9090/

   Observação

   A comunicação do Gestão Empresarial com o eDocs utiliza o web service com.senior.g5.co.int.eletronicos.documentos. O eDocs já possui fixo em seu código-fonte a definição da URL completa para localização do web service do ERP para a comunicação. Por esse motivo, no parâmetro URL Web Service integração ERP, é necessário apenas a definição do servidor e porta para comunicação.

4. Parametrize o Tipo de autenticação ERP, logon por usuário e senha ou o logon integrado com criptografia. Se for selecionada a autenticação por usuário e senha, somente os campos Usuário e Senha integração ERP são habilitados; e caso for selecionada a autenticação integrada com criptografia serão habilitados os campos Caminho do arquivo crypt.jar e Chave de Autenticação.
   
   Ao informar Usuário e Senha integração ERP, o eDocs irá utilizar usuário e senha pré-cadastrados no Gestão Empresarial para efetuar a chamada do web service. A opção Logon integrado com criptografia (não disponível para ERP SeniorSID) envolve utilização de autenticação via token
5. Em Usuário integração ERP informe usuário interno do ERP (cadastro através do Senior Gerenciador de Usuários), que o eDocs utilizará para acionamento do web service de integração

   Importante

   O usuário definido para retorno do eDocs para o ERP deverá ter permissões de administrador e configuração para ter acesso a todas empresas/filiais da base do ERP, assim como deverá ter permissões para manipular qualquer registro da base de dados, por exemplo, alterar situação de NF de Saída/Pedido;

   É recomendável a criação de um usuário específico para realizar a integração do eDocs com o ERP. Isso facilita a identificação dos eventos gerados no ERP através dos retornos enviados pelo eDocs. Qualquer alteração da senha no ERP do usuário parametrizado no eDocs deve ser replicada na parametrização do Monitor. Caso isso não seja feito, será interrompida a integração de retornos do eDocs para o ERP.

1. Acesse Monitor eDocs > Configuração > Filial
2. Na guia Geral, da guia Filial, seção Integração, no campo Forma integração (Saída) faça a utilização da opção de retorno ERP Senior Web Service, com a porta mais atual disponível

   Nota

   A forma de retorno SeniorSID não deve ser utilizada. Essa forma de retorno está em fase descontinuação e vários processos já não são mais atendidos por meio dessa forma de retorno. Clientes que ainda utilizam esse tipo de retorno deverão migrar imediatamente para o retorno via web service.

3. Para determinar informações específicas em retornos com o ERP para a filial, sobrepondo as parametrizações realizadas na empresa, ative o parâmetro Customizar por filial. Geralmente, essa parametrização é utilizada quando há necessidade de direcionamento de requisições de determinadas filiais para um GlassFish específico ou base de dados do ERP diferente. O parâmetro deve obrigatoriamente estar definido como "Não", caso o eDocs deva utilizar as parametrizações da empresa para comunicação com o ERP.

1. Acesse Cadastros > Filiais > Parâmetros por Gestão > Vendas, Faturamento e Transporte (F070FVE)
2. Na guia Documentos Eletrônicos, no campo Software Emissor NF-e informe "02 – eDocs - Envio e retorno via Web Service do eDocs"
3. Nos parâmetros que indicam integração de NF-e, NFS-e, CT-e e MDF-e, defina como retorno automático, independentemente da versão do leiaute de emissão de cada um dos documentos
4. Na guia Transporte, também defina retorno automático nos parâmetros que indicam integração de NF-e, NFS-e, CT-e e MDF-e

Observação

Para integração de NFS-e é obrigatório que seja utilizado o leiaute "4 - Padrão (ABRASF) – Retorno Automático". Caso haja necessidade de gerar a tag InfSenior no .XML da NFS-e (para atender pré-requisitos de Prefeituras homologadas), o identificador de regras GER-000GERSDE1 deverá estar habilitado no ERP.

1. Acesse Cadastros > Mercado e Suprimentos > Parâmetros Fiscais > Séries Notas Fiscais > Cadastro (F020SNF), confira o cadastro das séries legais que serão utilizadas para emissão de cada documento
2. O campo Dir. Arq. Doc. Eletrônicos não é obrigatório ser preenchido quando na filial o parâmetro Software Emissor NF-e for "02 – eDocs - Envio e retorno via Web Service do eDocs"
3. Em Dir. Boleto Doc. Eletrônico informe o diretório para a geração dos boletos relativos à nota fiscal
4. No campo Dispositivo Autorizado determine o tipo de documento fiscal que será gerado:
   • caso o dispositivo autorizado da série for "8 - Nota Fiscal Eletrônica de Serviço" e o código da série legal seja alfanumérico, é necessário cadastrar um identificador de integração numérico no campo Cód. Integração. Esse campo deverá ser único entre todas as séries com este dispositivo autorizado da filial e não poderá ser idêntico a uma série legal de outra série com dispositivo autorizado "8 - Nota Fiscal Eletrônica de Serviço" da mesma filial. Essa informação é utilizada para a integração correta de retornos das NFS-e do eDocs para o ERP
   • para os dispositivos autorizados "6 - Nota Fiscal Eletrônica", "10 - Nota Fiscal Consumidor Eletrônica", CT-e e CT-e OS, o código da série legal deve ser informado sem zeros à esquerda
   • para o dispositivo "9 - Manifesto Eletrônico", poderá ser utilizada a série legal 0 (zero), pois MDF-e não é um documento fiscal e permite a utilização dessa série. Ainda assim, preencha apenas o campo Série/Subsérie Legal com um único 0 (zero)
5. Obrigatoriamente, no campo Dir. Arq. Doc. Eletrônicos, preencha o diretório da filial do eDocs que irá receber o arquivo .XML gerado pelo ERP. No Gestão Empresarial, o diretório deve ser preenchido considerando a pasta Processar\<Documento_Eletrônico>, criada pelo eDocs para processamento dos arquivos .XMLs da filial. Por exemplo, \\Servidor\Senior\Integracao\Empresa1\Filial1\Processar\Nfe
   

   Importante

   Indique o diretório de integração adequado para cada série/filial. Se for definida a geração do .XML de um documento de uma filial para integrar no diretório de outra filial no eDocs, ocorrerá erro de integração e, consequentemente, não haverá o retorno do documento do eDocs para o Gestão Empresarial.

1. Acesse Cadastros > Empresas > Parâmetros de Integração (F191CPT) e defina a parametrização para empresa e/ou filial. Se a parametrização for definida para a filial "0", essa parametrização valerá para todas as filiais da empresa que não tiverem parametrização específica
2. No Grupo eDocs, subgrupo Comunicação com o eDocs, determine no campo Gerar log integração eDocs se serão gerados registros da comunicação do Gestão Empresarial com o eDocs. É recomendado configurar este campo como "S -Sim" quando houver necessidade de coletar as informações geradas durante o processo de integração entre os sistemas
3. Informe Usuário e Senha definidos no cadastro da empresa registrada no eDocs. Essa informação é definida na seção web service, da guia Integração do eDocs
4. Informe URL de comunicação com o web service do eDocs, no padrão http://<servidor_eDocs>: <porta_WebService>/Sde/Integracao, em que:
   • <servidor_eDocs> é o IP ou nome do Servidor do eDocs
   • <porta_WebService> é a porta do web service configurada em Configuração > Geral, guia Integração, campo Porta
5. No Grupo Documentos Fiscais de Saída, subgrupo Modelo 55, indique se será de forma síncrona ou assíncrona:
   • Síncrono: o Gestão Empresarial fará a chamada da porta AutorizarDocumento do web service de integração do eDocs. A chamada será efetuada apenas para NF-e, pois outros documentos não permitem autorização de forma síncrona. Verifique para qual SEFAZ a filial emitirá documentos, pois a autorização síncrona não está disponível para todas as SEFAZ
   • Assíncrono: o Gestão Empresarial fará a chamada da porta IntegrarDocumentos do web service de integração do eDocs, com posterior acionamento da porta ConsultarSituacaoDocumentos, para verificar a situação dos documentos enviados para emissão

   Observação

   Quando o parâmetro Tipo de Integração via WebService não é definido, o sistema Gestão Empresarial utilizará a integração síncrona.

Ative o processo automático 102 - Integração com o eDocs para importação de documentos e retornos das emissões em Recursos > Processos Automáticos > Cadastro (F000AGE).

1. Acesse Monitor eDocs > Configuração > Gerais
2. Na guia Integração, seção Web Service, informe a opção "Sim" no parâmetro Ativar web service de integração
3. Indique em qual Porta o eDocs disponibilizará os web services de integração

Acesse Monitor eDocs > Configuração > Empresa e na guia Integração, seção Web Service, defina Usuário e Senha para autenticação no web service do eDocs.

Acesse Monitor eDocs > Configuração > Filiais e na guia Geral, seção Integração, parametrize o campo Forma de Integração (saída) com o valor "Desativar". Desta forma, o eDocs não tentará efetuar retorno ao Gestão Empresarial após o documento estar em um status que permite realizar o retorno. O eDocs irá aguardar a consulta da situação do documento pelo próprio Gestão Empresarial.

1. Acesse Cadastros > Filiais > Parâmetros por Gestão > Vendas, Faturamento e Transporte (F070FVE)
2. Na guia Documentos Eletrônicos, no campo Software Emissor NF-e informe "03 – eDocs - Envio via Arquivo e retorno via Web Service eDocs"
3. Nos parâmetros que indicam integração de NF-e, NFS-e, CT-e e MDF-e, defina como retorno automático, independentemente da versão do leiaute de emissão de cada um dos documentos
4. Na guia Transporte, também defina retorno automático nos parâmetros que indicam integração de NF-e, NFS-e, CT-e e MDF-e

Observação

Para integração de NFS-e é obrigatório que seja utilizado o leiaute "4 - Padrão (ABRASF) – Retorno Automático". Caso haja necessidade de gerar a tag InfSenior no .XML da NFS-e (para atender pré-requisitos de Prefeituras homologadas), o identificador de regras GER-000GERSDE1 deverá estar habilitado no ERP.

1. Acesse Cadastros > Mercado e Suprimentos > Parâmetros Fiscais > Séries Notas Fiscais > Cadastro (F020SNF), confira o cadastro das séries legais que serão utilizadas para emissão de cada documento
2. No campo Dispositivo Autorizado determine o tipo de documento fiscal que será gerado:
   • caso o dispositivo autorizado da série for "8 - Nota Fiscal Eletrônica de Serviço" e o código da série legal seja alfanumérico, é necessário cadastrar um identificador de integração numérico no campo Cód. Integração. Esse campo deverá ser único entre todas as séries com este dispositivo autorizado da filial e não poderá ser idêntico a uma série legal de outra série com dispositivo autorizado "8 - Nota Fiscal Eletrônica de Serviço" da mesma filial. Essa informação é utilizada para a integração correta de retornos das NFS-e do eDocs para o ERP
   • para os dispositivos autorizados "6 - Nota Fiscal Eletrônica", "10 - Nota Fiscal Consumidor Eletrônica", CT-e e CT-e OS, o código da série legal deve ser informado sem zeros à esquerda
   • para o dispositivo "9 - Manifesto Eletrônico", poderá ser utilizada a série legal 0 (zero), pois MDF-e não é um documento fiscal e permite a utilização dessa série. Ainda assim, preencha apenas o campo Série/Subsérie Legal com um único 0 (zero)
3. Obrigatoriamente, no campo Dir. Arq. Doc. Eletrônicos, preencha o diretório da filial do eDocs que irá receber o arquivo .XML gerado pelo Gestão Empresarial. O diretório deve ser preenchido considerando a pasta Processar\<Documento_Eletrônico>, criada pelo eDocs para processamento dos arquivos .XMLs da filial. Por exemplo, \\Servidor\Senior\Integracao\Empresa1\Filial1\Processar\Nfe
   

   Importante

   Indique o diretório de integração adequado para cada série/filial. Se for definida a geração do .XML de um documento de uma filial para integrar no diretório de outra filial no eDocs, ocorrerá erro de integração e, consequentemente, não haverá o retorno do documento do eDocs para o Gestão Empresarial.

4. Em Dir. Boleto Doc. Eletrônico informe o diretório para a geração dos boletos relativos à nota fiscal

1. Acesse Cadastros > Empresas > Parâmetros de Integração (F191CPT) e defina a parametrização para empresa e/ou filial. Se a parametrização for definida para a filial "0", essa parametrização valerá para todas as filiais da empresa que não tiverem parametrização específica
2. No Grupo eDocs, subgrupo Comunicação com o eDocs, determine no campo Gerar log integração eDocs se serão gerados registros da comunicação do Gestão Empresarial com o eDocs. É recomendado configurar este campo como "S -Sim" quando houver necessidade de coletar as informações geradas durante o processo de integração entre os sistemas
3. Informe Usuário e Senha definidos no cadastro da empresa registrada no eDocs. Essa informação é definida na seção web service, da guia Integração do eDocs
4. Informe URL de comunicação com o web service do eDocs, no padrão http://<servidor_eDocs>: <porta_WebService>/Sde/Integracao, em que:
   • <servidor_eDocs> é o IP ou nome do Servidor do eDocs
   • <porta_WebService> é a porta do web service configurada em Configuração > Geral, guia Integração, campo Porta
5. No Grupo Documentos Fiscais de Saída, subgrupo Modelo 55, indique se será de forma síncrona ou assíncrona:
   • Síncrono: o Gestão Empresarial fará a chamada da porta AutorizarDocumento do web service de integração do eDocs. A chamada será efetuada apenas para NF-e, pois outros documentos não permitem autorização de forma síncrona. Verifique para qual SEFAZ a filial emitirá documentos, pois a autorização síncrona não está disponível para todas as SEFAZ
   • Assíncrono: o Gestão Empresarial fará a chamada da porta IntegrarDocumentos do web service de integração do eDocs, com posterior acionamento da porta ConsultarSituacaoDocumentos, para verificar a situação dos documentos enviados para emissão

   Observação

   Quando o parâmetro Tipo de Integração via WebService não é definido, o sistema Gestão Empresarial utilizará a integração síncrona.

Ative o processo automático 102 - Integração com o eDocs para importação de documentos e retornos das emissões em Recursos > Processos Automáticos > Cadastro (F000AGE).

1. Acesse Monitor eDocs > Configuração > Gerais
2. Na guia Integração, seção Web Service, informe a opção "Sim" no parâmetro Ativar web service de integração
3. Indique em qual Porta o eDocs disponibilizará os web services de integração

Acesse Monitor eDocs > Configuração > Empresa e na guia Integração, seção Web Service, defina Usuário e Senha para autenticação no web service do eDocs.

Acesse Monitor eDocs > Configuração > Filiais e na guia Geral, seção Integração, parametrize o campo Forma de Integração (saída) com o valor "Desativar". Desta forma, o eDocs não tentará efetuar retorno ao Gestão Empresarial após o documento estar em um status que permite realizar o retorno. O eDocs irá aguardar a consulta da situação do documento pelo próprio Gestão Empresarial.

• com.senior.g5.co.mcm.ven.pedidos: portas ExportarPedidos e GravarPedidos
• com.senior.g5.co.mcm.ven.notafiscal, porta GravarNotasFiscaisSaida
• com.senior.g5.co.mcm.cpr.notafiscal, porta GravarNotasFiscaisEntrada
• com.senior.g5.co.mcm.cpr.ordemcompra, porta GravarOrdensCompra
• com.senior.g5.co.int.varejo.produtosservicos, porta Exportar
• com.senior.g5.co.int.varejoNotaAutorizada
• com. g5.co.int.varejo.cupomfiscalve
• com.senior.g5.co.int.varejo.notafiscal
• com.senior.g5.co.int.varejo.nfce