Integração ERP XTended x 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" 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. 

• O envio é feito pelo processo automático 166 - Integração ERP x ERP Banking;
• O processo automático enviará a solicitação de geração de QR Code PIX para a plataforma do endpoint abaixo:
  • Endpoint: erpx_bnk_cob/pix/actions/registerPixBilling.
• O processo automático enviará a solicitação de cancelamento do QR Code PIX para a plataforma no endpoint abaixo:
  • Endpoint: erpx_bnk_cob/pix/actions/cancelPixBilling.
• Serão enviados para geração de QR Code PIX, todos os títulos que cumprirem as seguintes condições:
  • Portador com o campo Cobrança PIX gerado pelo ERP Banking igual a "S – Sim";
  • O tipo da forma de pagamento igual a 31 – PIX QR Code;
  • CPF/CNPJ do cliente informado;
  • Ainda sem envio para a plataforma Senior X;
  • Não estar com a situação E - Erro na tabela de controle de integração E301BNK.

• O recebimento das operações efetuados no ERP Banking, descem da XPlatform para o ERP XTended através do ERP_SERVICE.
• O recebimento do QR Code PIX pelo ERP XT ocorre quando o evento de criação de QR Code PIX é disparado na XPlatform pelo ERP Banking. Por meio do serviço "erpx_bnk_cob/ig5_integration" (configurado acima), o evento do ERP Banking gerará uma requisição para o endpoint abaixo do ERP_SERVICE:
  • Endpoint: erp_fin/ig5_contasreceber/signals/registerQRCodePIX.
• A confirmação do cancelamento do QR Code PIX no ERP XT ocorre quando o evento de criação de QR Code PIX é disparado na XPlatform pelo ERP Banking. Por meio do serviço "erpx_bnk_cob/ig5_integration" (configurado acima), o evento do ERP Banking gerará uma requisição para o endpoint abaixo do ERP_SERVICE:
  • Endpoint: erp_fin/ig5_contasreceber/signals/cancelQRCodePIX.
• O recebimento do pagamento do PIX pelo ERP XT ocorre quando o evento de pagamento é disparado na XPlatform pelo ERP Banking. Por meio do serviço de integração "erpx_bnk_cob/ig5_integration" (configurado acima), o evento do ERP Banking gerará uma requisição para o endpoint abaixo do ERP_SERVICE:
  • Endpoint: erp_fin/ig5_contasreceber/signals/paymentQRCodePIX.

• Os erros de integração dos títulos serão registrados no cadastro de observação dos títulos, referente a tabela E301MOR, com o tipo de observação E - Erro;
• As observações poderão ser consultadas no botão Observações da guia Inconsistências da tela F310RCP;
• Quando ocorrer erro na integração, o título ficará com a situação "E - Erro" na tabela de controle de integração (E301BNK) para o respectivo tipo de integração onde o erro ocorreu: "01 - Cobrança", "02 - Cancelamento" ou "03 - Pagamento";
• Registros com situação E - Erro na integração são exibidos na guia Inconsistências da tela F310RCP.

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.