Documentação técnica da integração ERP x wiipo

Esta página trata dos detalhes técnicos da integração ERP x wiipo para diagnóstico de problemas. Verificar Gestão de recebíveis - wiipo.

1. Integração de dados com a wiipo

1.1. Processo automático 143 - Integração ERP x wiipo

Este processo permite executar as chamadas de web service ativadas pelo serviço da wiipo.

Funções/web services utilizados:

• AlteraTituloCR, que chama o web service com.senior.g5.co.mfi.cre.titulos, porta AlteracaoParcialTitulosCR;
• BaixaTituloCR, que chama o web service com.senior.g5.co.mfi.cre.titulos, porta GerarBaixaPorLoteCR_3;
• com.senior.g5.co.mfi.tes.extrato, porta GravarMovimentosBancarios;
• com.senior.g5.co.mfi.cre.instrucoesbancarias, porta AlterarInstrucao.

É possível executá-los a partir de uma pendência de integração com conteúdo em .XML, e não apenas .JSON. As pendências são obtidas da tabela E996PIP. Assim, o web service informado na pendência é executado e o .XML informado no conteúdo (E996PIP.ConInt) da mesma é carregado.

Características do processo:

• o processo automático é por ambiente, ou seja, independe da empresa ou filial;
• não possui parâmetros de rotina (deixe em branco);
• deve ser cadastrado para rodar a cada 5 minutos;
• pode ser utilizado para chamar qualquer web service, conforme definido na pendência de integração na tabela E996PIP;
• o processo disponibiliza funções específicas para a wiipo (AlteraTituloCR e BaixaTituloCR), que permitem a ela realizar alterações de dados no ERP via string em .JSON (em vez de uma string .XML). Isso foi feito para manter a compatibilidade com o que havia na primeira versão de integração da wiipo com o ERP. Posteriormente a wiipo irá ajustar esse processo para acessar diretamente os web services que as funções usam (que convertem o .JSON para .XML) sem passar por elas;
• após processar as pendências de integração, o retorno do web service será gravado na tabela E996RPP;
• caso a pendência de integração utilize uma das funções da wiipo (AlteraTituloCR ou BaixaTituloCR), o retorno (RetInt) será convertido para .JSON.

O conteúdo do .XML das pendências de integração processados pela rotina do processo automático permite informar caracteres da tabela ASCII em formato codificado. O caractere especial deverá ser inserido no texto com a marcação #WP999#, onde 999 representa o número do caractere na tabela ASCII.

Independentemente do valor decimal do caractere na tabela ASCII, deve-se usar 3 dígitos para informar o caractere: #WP001#; #WP045#; #WP145#. O valor máximo permitido para o número do caractere será 255, conforme limite da tabela ASCII. Ex.: o caractere ? será representado no texto pelo código #WPO63#, de forma que o texto <#WPO63#xml #WPO63#> seja convertido para <?xml ?>.

1.2. Consulta de títulos e instruções

As consultas são feitas diretamente na base por meio do integrador da wiipo. Periodicamente, o integrador faz consultas automáticas para enviar os dados. Exemplos:

• consulta de títulos em aberto: a wiipo mantém uma cópia dos títulos em aberto para que o usuário possa, através da wiipo, selecionar o título por meio do qual ele deseja gerar um boleto;
• consulta de títulos com portador wiipo: retorna os títulos que foram atribuídos ao portador da wiipo no ERP e cujos boletos devem ser gerados na wiipo;
• consulta de instruções bancárias de baixa/cancelamento: retorna os títulos cujos boletos devem ser removidos da wiipo;
• consulta de instruções bancárias de alteração: retorna os títulos com portador wiipo que foram alterados no ERP.

1.3. Alterações em títulos

As alterações em títulos ocorrem por meio de pendências da integração que são controladas nas tabelas Pendências de integração via processo automático (E996PIP)  e Retorno das pendências de integração via processo automático (E996RPP). Após o processamento via processo automático 143 - Integração ERP X wiipo, o retorno da pendência será gravado na tabela E996RPP e também mantido na tabela E996PIP.

Exemplo de pendência de integração

E996PIP.IdeUni: FFE70BA1-1764-4126-8DC2-BE36223B193D (UUID) E996PIP.IdeExt: E0C7955F-5775-4469-BE7D-6D6F1E01CC4F (UUID) E996PIP.NomSis: ‘WIIP’ (sistema externo que gerou a integração) E996PIP.SerExt: ‘AlteracaoTitulosERP’ (nome da integração no sistema externo) E996PIP.SerInt: serviço de integração a ser executado. Pode ser função da wiipo ou nome de web service: ‘AlteraTituloCR’ , ‘BaixaTituloCR’ ou nome do web service (‘com.senior.g5.co.mfi.tes.extrato@GravarMovimentosBancarios’) E996PIP.ConInt: pode ser um .JSON (se for função da wiipo) ou .XML (se for chamada de um web service): ‘{ "CodEmp": 300, "CamposAlterados": "CodBar,TitBan,LinkBoleto", "Titulos": [{ "CodFil": 1, "NumTit": "50069S901", "CodTpt": "01", "CodCli": 4, "CodBar": "34191090737921478893131339210002884730000296817", "TitBan": "109/07792147-8", "NumInt": "8d3d5f5f-f240-487b-a598-811467386843", "SituacoesHabilidadasAlteracao": [], "GrerarNumArb": false, "LinkBoleto": "https://api-boleto-production.s3.amazonaws.com/719e96d1bf9c4e45b643a0d722d50fb1/2c60dd9fbc7c4eb390637a531391b4e6/5fb58f03093b1e08c70d9c9e.html" }] }’ ‘<?xml version="1.0" encoding="ISO-8859-1"?><request id='' user='Agro1' password='QWp+MVlE' encrypted='1' service='com.senior.g5.co.mfi.tes.extrato' port='GravarMovimentosBancarios'><params><prCallMode>1</prCallMode><FlowName></FlowName><FlowInstanceID></FlowInstanceID><GridMovimentosBancarios><line><IdeExt isnull='1'/><CodEmp>300</CodEmp><NumCco>BRASIL</NumCco><NumCgc isnull='1'/><CtaExt isnull='1'/><DigCta isnull='1'/><DigAgc isnull='1'/><DatExt>18/12/2020</DatExt><HisExt><![CDATA[teste h]]></HisExt><CheExt isnull='1'/><VlrExt>600</VlrExt><DecExt>C</DecExt><DocMov>6464</DocMov><IdeTxi isnull='1'/><Conciliacao><line><CodEmp>300</CodEmp><CodFil>1</CodFil><NumTit>BAIXA0</NumTit><CodTpt>01</CodTpt></line></Conciliacao></line></GridMovimentosBancarios></params></request>’ E996PIP.VerInt: 0 (versão do web service; funções da wiipo não utilizam esse campo) E996PIP.DatCri: 1599826579 (data e hora de criação em formato Unix)

Observação

A função BaixaTituloCR utiliza o parâmetro DataMovimentoTesouraria como data de liberação do movimento, e não como data do movimento na tesouraria. Para obter a data de movimento na tesouraria e a data contábil do movimento, o parâmetro DataBaixa é utilizado.

Exemplo de retorno de integração

E996RPP.IdeUni: Cópia do campo E996PIP.IdeUni E996RPP.IdeExt: Cópia do campo E996PIP.IdeExt E996RPP.NomSis: Cópia do campo E996PIP.NomSis E996RPP.SerExt: Cópia do campo E996PIP.SerExt E996RPP.SerInt: Cópia do campo E996PIP.SerInt E996RPP.ConInt: Cópia do campo E996PIP.ConInt E996RPP.VerInt: Cópia do campo E996PIP.VerInt E996RPP.DatCri: Cópia do campo E996PIP.DatCri E996RPP.DatPro: 1611052697 (data e hora de processamento em formato Unix) E996RPP.RetInt: Para as funções wiipo retorna um .JSON; para os web services retorna um .XML (registros sendo processados terão esse campo em branco): ‘{"retorno":"ERRO","retornoTitulos":[{"codEmp":0,"codFil":0,"codTpt":"","numInt":"","numTit":"","retorno":"é necessário associar uma conta interna ao portador da eiipo: empresa 120, portador \"WIIP\"."}]}’ <?xml version="1.0" encoding="ISO-8859-1"?><response service='com.senior.g5.co.mfi.cre.titulos' port='AlteracaoParcialTitulosCR'><params><prError></prError><GridRetorno><line><NumInt>123</NumInt><CodEmp>120</CodEmp><CodFil>3</CodFil><NumTit>JAMESTST</NumTit><CodTpt>01</CodTpt><Retorno>OK</Retorno></line></GridRetorno><Retorno>OK</Retorno></params></response> E996RPP.StsInt: ‘SUCESSO’ (indica se o processo automático conseguiu executar e obter o retorno do web service; se houve algum erro e não foi possível obter o retorno, será retornado ‘ERRO’; se o registro está em processamento, a situação sera ‘PROCESSANDO’)

1.4. Tempo de resposta da integração

Como o processo automático 143 roda a cada 5 minutos e o integrador da wiipo verifica o retorno de processamento das pendências também cada 5 minutos, após a wiipo solicitar a integração de um dado (como uma alteração de título), o tempo de resposta pode ser de até 10 minutos.

Considerando a criação de um boleto, o integrador da wiipo envia os boletos para a wiipo a cada 5 minutos que, somados aos 10 minutos que a wiipo leva para alterar as informações do boleto no ERP (código de barras, nosso número, link do boleto etc.), representa um total de até 15 minutos para um boleto estar sincronizado nos dois sistemas. A mesma lógica se aplica à integração dos outros dados (instruções bancárias, baixas, extratos bancários etc.).

2. Integração de boletos

Exemplo de .JSON utilizado no conteúdo da pendência de integração da alteração de títulos

{ "CodEmp": 300, "CamposAlterados": "CodBar,TitBan,LinkBoleto", "Titulos": [{ "CodFil": 1, "NumTit": "50069S901", "CodTpt": "01", "CodCli": 4, "CodBar": "34191090737921478893131339210002884730000296817", "TitBan": "109/07792147-8", "NumInt": "8d3d5f5f-f240-487b-a598-811467386843", "SituacoesHabilidadasAlteracao": [], "GerarNumArb": false, "LinkBoleto": "https://api-boleto-production.s3.amazonaws.com/719e96d1bf9c4e45b643a0d722d50fb1/2c60dd9fbc7c4eb390637a531391b4e6/5fb58f03093b1e08c70d9c9e.html" }] }

Exemplo de .JSON utilizado no conteúdo da pendência de integração da baixa de títulos

{
 "codEmp": 300,
 "codFil": 1,
 "contaInterna": "BRASIL",
 "dataBaixa": "04/11/2020",
 "dataMovimentoTesouraria": "04/11/2020",
 "titulos": [{
 "codFil": 1,
 "codFpg": "",
 "codTpt": "01",
 "numInt": "AS54",
 "numTit": "TESTBAI01",
 "obsMcr": "baixa tete",
 "vlrBai": 500,
 "vlrCor": 0,
 "vlrDsc": 0,
 "vlrEnc": 0,
 "vlrJrs": 0,
 "vlrMul": 0,
 "vlrOac": 0,
 "vlrOde": 0,
 "VlrDcb": 20.2
 }]
}

3. Instruções bancárias

As instruções bancárias são enviadas à wiipo via consulta na base de dados do ERP por meio do integrador wiipo. São enviadas todas as instruções bancárias referentes ao portador wiipo.

Para que a wiipo possa filtrar e identificar as instruções já processadas, após receber uma instrução é gerada uma solicitação de alteração de instrução bancária para o ERP a fim de alterar o número de remessa (NumArb) da instrução para que não seja mais retornada na consulta de instruções pendentes. O número de remessa informado será um número fixo e fictício, visto que a wiipo não utiliza a rotina de remessa.

Exemplo de .XML utilizado no conteúdo da pendência de integração da alteração de instruções bancárias

<?xml version="1.0" encoding="ISO-8859-1"?>
<request port="AlterarInstrucao" service="com.senior.g5.co.mfi.cre.instrucoesbancarias" encrypted="1" password="QWp+MVlE" user="Agro1" id="">
	<params>
		<prCallMode>1</prCallMode>
		<FlowName/>
		<FlowInstanceID/>
		<GridInstrucoesBancarias>
			<line>
				<CodEmp>300</CodEmp>
				<CodFil>1</CodFil>
				<NumTit>TITPOR</NumTit>
				<CodTpt>01</CodTpt>
				<CodOcr>06</CodOcr>
				<SeqItb>1</SeqItb>
				<NumArb>6</NumArb>
			</line>
		</GridInstrucoesBancarias>
		<CamposAlterados>NumArb</CamposAlterados>
	</params>
</request>

4. Transferência Entre Contas

Ao final do dia é realizada a TED/Transferência entre a conta wiipo e a conta corrente de destino do cliente. Utilizando o processo de pendências de integração entre ERP e serviço wiipo, é disparada a chamada do web service com.senior.g5.co.mfi.tes.transferenciatesouraria, porta TransferenciaTesouraria para que seja registrada a transferência entre as contas no ERP.

Consulte a documentação do web service com.senior.g5.co.mfi.tes.transferenciatesouraria, porta TransferenciaTesouraria para mais informações.

5. Integração de extratos bancários

Exemplo de .XML utilizado no conteúdo da pendência de integração da inclusão de extratos bancários

<?xml version="1.0" encoding="ISO-8859-1"?>
<request port="GravarMovimentosBancarios" service="com.senior.g5.co.mfi.tes.extrato" encrypted="1" password="QWp+MVlE" user="Agro1" id="">
	<params>
		<prCallMode>1</prCallMode>
		<FlowName/>
		<FlowInstanceID/>
		<GridMovimentosBancarios>
			<line>
				<CodEmp>300</CodEmp>
				<NumCco>BRASIL</NumCco>
				<DatExt>18/12/2020</DatExt>
				<HisExt>
					<![CDATA[teste h]]>
				</HisExt>
				<VlrExt>600</VlrExt>
				<DecExt>C</DecExt>
				<DocMov>6464</DocMov>
				<Conciliacao>
					<line>
						<CodEmp>300</CodEmp>
						<CodFil>1</CodFil>
						<NumTit>BAIXA0</NumTit>
						<CodTpt>01</CodTpt>
					</line>
				</Conciliacao>
			</line>
		</GridMovimentosBancarios>
	</params>
</request>

5. Integração com o eDocs

5.1. Tipos de integração com 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.

5.2. Comunicação com o eDocs

- Chamada WS do serviço "Email", método "MarcarEnvioEmail":

<nfe:MarcarEnvioEmail>

   <nfe:usuario> Usuário da F191CPT </nfe:usuario>

   <nfe:senha> Senha da F191CPT </nfe:senha>

   <nfe:tipoDocumento> tipo do documento no eDocs, fazendo de/para com o DisAut da Série </nfe:tipoDocumento>

   <nfe:tipoOperacao> "0" </nfe:tipoOperacao>

   <nfe:chave> E140IDE.ChvDoe </nfe:chave>

   <nfe:enderecosEnvio> E085CLI.EMANFE ou E085CLI.INTNET ; E073TRA.INTNET (pode ser parametrizado por meio do identificador de regra VEN-140IDEMAWP)</nfe:enderecosEnvio>

   <nfe:enviarBoleto> "true" </nfe:enviarBoleto>

   <nfe:conteudoAdicional><![CDATA[ Texto fixo ERP* ou Parametrizado pelo IR VEN-140IDEPRWP ]]></nfe:conteudoAdicional>

</nfe:MarcarEnvioEmail>

*Texto fixo ERP: "1 (E140PAR.CODPAR). Vencimento 31/12/2020 (E140PAR.VCTPAR); Valor R$ 50,00 (Sigla Moeda e E140PAR.VLRPAR); Boleto: https://linkboleto.com/exemplo.html (E140PAR.E301MOR where TIPOBS = "L").

A integração das notas pode ser via web service ou arquivo. Nas duas formas, o eDocs processa o .XML da nota fiscal e faz a emissão dela. Quando uma nota tiver parcelas com portador wiipo e o sistema estiver parametrizado para realizar o envio de e-mail dessas parcelas, será adicionado uma tag no .XML da nota para informar que o e-mail não deve ser enviado pelo eDocs na emissão da nota:

• no .XML de NF-e e CT-e: na tag <infSenior>, será adicionada a subtag <ativarEnvioEmail>0</ativarEnvioEmail>;
• no .XML de NFS-e: na tag <InfSenior>, será adicionada a subtag <AtivarEnvioEmail>0</AtivarEnvioEmail>.