Integração do ERP XT com o ERP Banking

1. Verifique se a Proprietária no Gestão Empresarial | ERP possui as permissões necessárias para utilização:
   • Com um usuário administrador, acesse Ajuda > Sobre o ERP > Proprietária (F000IPR);
   • Verifique a data de validade do arquivo da proprietária;
   • Na guia Processos, certifique que esteja listado o módulo: FRES - Finanças - Gestão de Contas a Receber - Cobrança Escritural.

É imprescindível possuir o módulo disponível na proprietária para realizar o processo de integração. Para obter mais informações sobre a proprietária, entre em contato com a Senior.

2. Configure a implantação do ERP conforme Checklist de implantação - ERP, incluindo a configuração do ERP XTended;
3. Avalie se o Middleware se encontra devidamente configurado;
4. O ERP_SERVICE também deve estar configurado.

1. Cadastre o processo automático 166 - Integração ERP x ERP Banking. O processo será responsável por enviar os dados para a XPlatform com a periodicidade padrão de 30 em 30 min;
2. Na XPlatform, adicione as permissões de integração com o ERP Banking para o papel ERPXT chave aplicação, definido em Integrar domínio na senior X Platform;
   1. Acesse Tecnologia > Administração > Autorização > Gestão dos Papéis;
   2. Clique em Editar referente ao papel ERPXT chave aplicação;
   3. Acesse a guia Permissões e na seção Agrupar por, vá em Serviço;
   4. Pesquise pelo serviço “erpx_bnk_cob”;
   5. Na lista de Domínio / Serviço, expanda os recursos do serviço "erpx_bnk_cob / pix" caso PIX ou "erpx_bnk_cob / boleto" caso seja Cobrança Escritural e marque a caixa de seleção de todos os recursos apresentados;
   6. Em seguida, acesse a guia Aplicações e associe o papel em edição com a aplicação criada para a comunicação com o ERP XTended;
   7. Clique em Salvar.
3. Na senior X Platform, habilitar a integração com o ERP_SERVICE para o tenant do cliente:
   1. Abrir a tela de configuração por tenant em Tecnologia > Configuração > Por Tenant;
   2. Em Domínio e Serviços procurar por "erpx_bnk_cob"; 
   3. Editar o serviço "ig5_integration"; 
   4. Na guia Sistema, definir o valor Verdadeiro para a propriedade Habilitar integração com o ERP_SERVICE. 
4. Parâmetros de integração Opcionais:
   • Transação de crédito na tesouraria: Transação que será usada nos movimentos de créditos gerados na tesouraria ao processar os pagamentos originados no ERP Banking.
   • Transação de baixa por pagamento: Transação que será usada na baixa dos títulos ao processar os pagamentos originados no ERP Banking.

   Estes parâmetros serão utilizados na baixa dos títulos quando o pagamento for recebido via ERP Banking. Caso os parâmetros não estejam preenchidos, serão utilizados os parâmetros padrões configurados para a filial (F070FRE).

   1. Acesse Cadastros > Empresas > Parâmetros de integração (F191CPT);
   2. No campo Grupo selecione a opção "ERP Banking" e no Subgrupo selecione a opção "Gerais";
   3. Clique em Mostrar;
   4. Serão carregados os parâmetros Transação de crédito na tesouraria e Transação de baixa por pagamento;
   5. Na coluna Valor da grade informe os parâmetros desejados;
   6. Clique em Processar.

5. Cadastrar empresa:
   1. Acesse Cadastros > Empresas e clique em Adicionar caso desejar adicionar uma nova empresa, ou selecione um cadastro já existente na Lista de Empresas e clique em Editar;
   2. Preencha o campo Código. Este campo indicará o código da empresa dentro do sistema;
   3. Preencha o campo Nome com a razão social da empresa;
   4. Preencha o Nome fantasia da empresa;
   5. O campo País está preenchido como padrão com o código 1058 - Brasil. Entretanto, pode ser alterado caso a empresa seja de fora do Brasil;
   6. O campo Moeda é preenchido automaticamente com o código BRL - Real, pois é herdado do cadastro do país;
   7. No campo Utiliza agrupamento de filial ao definir como "Sim", é indicado que a empresa efetua a entrega de informações contábeis agrupadas por filial;
   8. Preencha o campo Home Page com a página web da empresa.
6. Cadastrar filial:
   1. Acesse Cadastros > Filiais e clique em Adicionar caso desejar adicionar uma nova filial, ou selecione um cadastro já existente na Lista de Filiais e clique em Editar;
   2. No campo Empresa selecione a empresa a qual a filial está vinculada;
   3. Preencha o campo Código. Este campo indicará o código da filial dentro dos cadastros das filiais registradas no sistema;
   4. Preencha o campo Nome com a razão social da filial;
   5. Preencha o Nome fantasia da empresa;
   6. Insira o Ramo de atividade da empresa. Caso na lista não haja o ramo de atividade da empresa, é possível cadastrá-lo. Acesse a documentação do Cadastro dos Ramos de Atividade para saber mais;
   7. Em Tipo de pessoa defina entre pessoa física ou jurídica;
   8. Nos campos CPF/CNPJ, Inscrição estadual e Inscrição municipal insira as informações cadastrais da empresa. É importante observar que a exigência de inscrição estadual e inscrição municipal pode variar de acordo com a empresa.
   9. O preenchimento do campo Inscrição municipal da nota fiscal é necessário caso, na Nota Fiscal de Serviços, seja inserida uma inscrição municipal diferente da inscrição cadastrada em campo próprio;
   10. O preenchimento do campo Número da identificação fiscal (NIF) é necessário em caso de empresas estrangeiras cadastradas no Brasil;
   11. O preenchimento do campo Incentivos Fiscais Suframa da Filial é necessário caso a empresa seja beneficiária de algum programa de incentivo fiscal;
   12. O campo Código SUFRAMA se refere ao benefício de empresas instaladas junto à Zona Franca de Manaus;
   13. O campo CEP busca as informações registradas no Cadastro de CEP;
   14. O campo Endereço é preenchido automaticamente após a definição do CEP;
   15. Preencha o Número do local;
   16. O campo Complemento pode ser preenchido como por exemplo, casa, loja, sala, galpão, KM, ou alguma outra informação complementar do endereço;
   17. O campo Bairro é preenchido automaticamente após a definição do CEP;
   18. O campo Código do ISS é preenchido automaticamente, a partir do Cadastro da Cidade;
   19. Os campos Cidade e Estado são preenchidos automaticamente a partir da definição do CEP;
   20. Os campos Telefone, Fax, Caixa postal e E-mail se referem a dados cadastrais padrões da empresa;
   21. Em Filial como pessoa, é definido o cadastro da empresa como pessoa (Cliente/Fornecedor) utilizado para emissão de notas de emissão própria. Para saber mais, acesse a documentação do cadastro de pessoa;
   22. Insira a Data de início das atividades conforme o registro na Junta Comercial;
   23. Insira o Objeto social conforme o Contrato Social da empresa;
   24. Caso a empresa tenha registro na Agência Nacional do Petróleo, preencha os campos Código do agente regulado ANP e Código da instalação ANP;
   25. Em A filial é matriz aponte se a filial cadastrada nesta tela corresponde ou não à matriz da empresa.

Cadastrar os dados do eDocs (usuário, senha e URL) na tela F191CPT, grupo eDocs, subgrupo Comunicação com eDocs para que o ERP sinalize ao eDocs o disparo do e-mail. Para mais informações, acesse a documentação da Integração com o eDocs;

Sobre a integração de documentos fiscais, ela está prevista quando o .XML do documento for enviado via pasta do eDocs ou via web service do eDocs. Em Software Emissor podem ser utilizados os itens 0, 2 ou 3;

Na questão da impressão automática do boleto, somente irá funcionar para clientes que usam o Software Emissor, nos itens 2 ou 3, ou seja, quem utilizar o Software Emissor = 0, não terá essa configuração feita de forma automática e não temos a informação de que a configuração está correta. Nesta situação, poderá ser definido manualmente a configuração de envio automático do cobrança via e-mail.

Configuração do envio de cobrança nos e-mails

Indicativo de geração automática de boletos (NF-e, NFS-e e CT-e):

1. Acesse a tela F070FVE e preencha os campos Gerar Boleto NF-e e Gerar Boleto NFS-e da guia Vendas 2 e Gerar Boleto CT-e da guia Transporte;
2. Em Configurações > Filiais > guias NF-e, NFS-e, CT-e e CT-e OS e em seguida E-mail Emissão, preencha o campo Enviar arquivos adicionais/boleto em anexo igual a "S - Sim";
3. Acesse a tela F039POR e preencha o campo Imprimir doc. cobrança automaticamente para o portador de pagamento PIX via ERP Banking;
4. Acesse a tela F066FPG e preencha o campo Imprimir doc. cobrança automaticamente para a forma de pagamento;
5. Parametrize o ERP para que QR Code PIX seja gerado somente após a autorização da nota eletrônica. Para isso, utilize o identificador de regras CRE-301ENTAS01.
6. Com ele ativo e ligado à uma regra, o título gerado pela nota ficará na situação AS - Aberto Suspenso e só será atualizado para AB - Aberto Normal após a autorização da nota. Desta forma, o QR Code PIX será gerado no ERP Banking somente se a nota estiver aprovada pela SEFAZ.

Exemplo de regra

se ((VSCodPor = "<Cód. Port. PIX>") e (VSCodFpg="<Cod. Forma Pgto. PIX>") e (VSCodSnf="NFE"))

{

VsAltSit = "SIM";

}

senao

{

VsAltSit = "NAO";

};

• Após receber o QR Code PIX dos títulos do ERP Banking, o Gestão Empresarial | ERP comunicará ao eDocs (via web service do eDocs), que o e-mail pode ser enviado. Para mais detalhes, acesse a documentação técnica da Wiipo, onde possui alguns detalhes sobre a comunicação do Gestão Empresarial com o e-Docs;
• No status no eDocs, indica que os QR Codes PIX ainda não foram enviados no e-mail;
• O e-mail é disparado pelo eDocs, desde que todos os QR Codes PIX estejam gerados (no caso de várias parcelas) e a nota esteja autorizada.

Para customizar o e-mail contendo os dados das parcelas, existem duas opções:

• Utilize o identificador de regras VEN-140IDEPRWP, que permite personalizar o texto de cada parcela descrita no e-mail, conforme exemplo de regra na documentação do identificador;
• Quando não for utilizado o e-mail de retorno de autorização dos documentos eletrônicos padrão do eDocs e, em vez disso, o identificador de regras VEN-140NEIMPBO estiver sendo utilizado para essa finalidade, os dados das parcelas não serão apresentados no e-mail. Para resolver isso, o identificador de regra CRE-301TPXALQR pode ser utilizado para personalizar o recebimento dos QR Codes PIX. Ele é acionado sempre que o Gestão Empresarial | ERPrecebe um QR Code PIX do ERP Banking.

• CRE-310RCPEEPX: Será acionado sempre que o ERP XT receber os dados PIX oriundos do ERP Banking. Será acionado por título, permitindo a programação de processos auxiliares, como envio de e-mail personalizado, dentre outros.
• CRE-310RCPEEBO: Será acionado sempre que o ERP XT receber os dados de boleto oriundos do ERP Banking. Será acionado por título, permitindo a programação de processos auxiliares, como envio de e-mail personalizado, dentre outros.