Explicativo sobre as integrações EAI do Protheus com destino a sistemas de terceiros
Produto: | Protheus |
Versões: | A partir da 12.1.27 |
Ocorrência: | Explicativo sobre a integração EAI Protheus (SIGAFAT) com destino à outros sistemas |
Ambiente: | Faturamento (SIGAFAT) |
Índice
1. ConceitoA integração ocorre via XML ou JSON do Protheus para outro sistema: Image Modified
2. |
Preparando para integrarConfigurações e integração Deck of Cards |
---|
startHidden | false |
---|
effectDuration | 0.5 |
---|
id | Integrar Cliente |
---|
effectType | horizontal |
---|
loopCards | true |
---|
| |
|
XAH Card |
---|
default | true |
---|
id | (2) Cadastrar Adapter |
---|
label | (2) Cadastrar Adapter |
---|
| Aviso |
---|
title | Envio para mais de uma rota a partir da origem |
---|
| Quando por exemplo, o Protheus A está enviando para o Protheus B e Protheus C ao mesmo tempo, o campo "XX4_METODO (Método)" do Protheus Origem (A) fica como "2 - Assíncrono" e os Protheus Destino (B e C) ficam com o valor "1 - Síncrono" no Adapter. Image Added
Com isso, basta informar mais de uma rota no Adapter: Image Added
|
Essa etapa, deve cadastrar o |
|
|
adapter Adapter da rotina que deseja integrar. Exemplo: - Cadastro de cliente = Cadastro do Adapter CRMA980 ou MATA030
- Cadastro de vendedor = Cadastro do Adapter MATA040
1 - Ir na rotina "Adapters EAI (CFGA020)"
2 - Incluir o Adapter com a rotina desejada: - "Mensagem Unica (XX4_UNMESS)" = '1 - Sim'
- "Rotina* (XX4_ROTINA)" = fonte da rotina (que integrará, exemplos de fontes dentro da caixa azul, no tópico "Conceito" na ilustração)
- "Envia (XX4_SENDER)" = '1 - Sim'
- "Recebe (XX4_RECEIV)" = '1 - Sim'
- "Método (XX4_METODO)" = '1 - Sincrono'
|
|
|
ou ' (Avaliar como está sendo implementado a integração, o suporte não oferece apoio na configuração completa da implementação entre dois sistemas- - Assíncrono' no Protheus Origem se tiver mais que uma rota a ser enviada)
- "Operação (XX4_TPOPER)" = '1 - Todas'
- "Canal Envio (XX4_CHANEL)" = '3 - EAI - PAD. APP'
- "Versão Envio (XX4_SNDVER)" = Gatilhado automaticamente (após escolher a "Rotina* (XX4_ROTINA)")
- "Formato (XX4_FORMAT)" = 'XML' ou 'JSON' (Avaliar como está sendo implementado a integração, o suporte não oferece apoio na configuração completa da implementação entre dois sistemas)
|
|
|
Deixar como estão, mesmo que em branco para o teste Card |
---|
default | true |
---|
id | (5) Integrando |
---|
label | (5) Integrando |
---|
| Com o Protheus que envia configurado, basta inserir um registro na rotina/fonte que o Adapter foi cadastrado. Exemplo: - Tendo um Adapter do (CRMA980 ou MATA030 - Cliente), cadastrando um cliente no Protheus (MATA030 ou CRMA980), gerará o registro de integração EAI "CUSTOMERVENDOR".
- Tendo um Adapter do (MATA040 - Vendedor), cadastrando um vendedor no Protheus (MATA040), gerará o registro de integração EAI "SELLER".
|
|
Ao salvar o registro no Protheus (tópico 5), será gerado no Protheus (Enviador) um registro na tabela XX3 de logs de envio EAI. Aviso |
---|
title | Sinal que foi ou não foi integrado |
---|
| Os valores do campo 'XX3_STATUS' de quando a mensagem sai do Protheus e chega até o outro sistema são: 2, 3 e 7: - Caso na tentativa de integração o XX3_STATUS fique com algum valor acima, orientamos que contate a Equipe do Produto destino para melhor análise do motivo do sistema destino não estar aceitando a integração.
O campo XX3_TRANS mostra o EAI (JSON ou XML) que está sendo enviado e o campo XX3_RETURN mostra o EAI (JSON ou XML) de retorno (resposta do outro sistema ou da tentativa). |
3. Exemplo de integração Protheus → Protheus |
Image Removed Image Added
4. Exemplo de integração Protheus → Sistema destino Image Added
|