Cadastro de Adapters:
O cadastro de adapters são rotinas responsáveis por realizar o processamento das mensagens enviadas e recebidas, possibilitando a inclusão, alteração e exclusão do adapter no Protheus
Pré-requisitos:
- Para realizar o cadastro/configuração do adapter é necessário ter uma ROTA cadastrada, para cadastrá-la acesse o link: Cadastro de Rotas EAI.
Configurações Adapters:
No Configurador (SIFACFG), acesse Ambientes/Schedule/Adapter E.a.i
Efetue a Inclusão de uma nova rotina para os Adapters do sistema Protheus.
Configure a rotina do Adapter, de acordo com a tabela abaixo que já foram pré estabelecidos para a integração:
Mensagem única: Sim
Rotina: Nome do adapter
Mensagem: Nome da mensagem única que o Adapter EAI espera receber.
Descrição: Identificação da mensagem.
Envia: SIM (se envia a informação para o TOTVS CRM) ou NÃO ( Se não envia nenhuma informação deste adapter para o TOTVS CRM).
Recebe: SIM (se recebe a informação do TOTVS CRM) ou NÃO ( Se não recebe nenhuma informação deste adapter do TOTVS CRM).
Método: Síncrono/Assincrono
Canal de Envio: Para TOTVS CRM = 3-PAD.APP
Formato: JSON
Roteamento de mensagens: Informar a rota criada no cadastro de rota e se envia de acordo com a integração (ver tabela abaixo).
Exemplo de Cadastro:
Efetue a inclusão dos Adapters, conforme tabela abaixo:
Obs.: Recomendado se o cliente estiver em produção fazer o cadastro dos Adapters todos como Envia e Recebe "Não" e ir ativando eles conforme for fazendo as cargas de pré-requisito.
Adapter | Rotina Protheus | Mensagem Única | Mensagem¹ | Descrição¹ | Envia | Recebe | Método Protheus | Operação | Condição de envio | Canal de Envio | Alias | ***Versão | Formato | *Rota |
Whois Mensagem Única | APCFG060 | 1 - Sim | WHOIS | WHOIS MENSAGEM UNICA | Sim | Sim | Síncrono | Todas | 2 - EAI - REST | XML | ||||
Cadastro de filiais | APCFG230 | 1 - Sim | BRANCH | FILIAIS | Sim | Não | Assíncrono | Todas | 3 – EAI – PAD. APP. | JSON | TOTVSCRM | |||
Cadastro Unidade de Medida | QIEA030 | 1 - Sim | UNITOFMEASURE | UNIDADE DE MEDIDA | Sim | Não | Assíncrono | Todas | 3 – EAI – PAD. APP. | JSON | TOTVSCRM | |||
Cadastro Grupo de Produtos | MATA035 | 1 - Sim | STOCKGROUP | GRUPO DE PRODUTOS | Sim | Não | Assíncrono | Todas | 3 – EAI – PAD. APP. | JSON | TOTVSCRM | |||
Cadastro Transportadora ² | MATA050 | 1 - Sim | CARRIER | TRANSPORTADORA | Sim | Não | Assíncrono | Todas | 3 – EAI – PAD. APP. | JSON | TOTVSCRM | |||
Cadastro Condição de Pagamento | MATA360 | 1 - Sim | PAYMENTCONDITION | CONDICAO DE PAGAMENTO | Sim | Não | Assíncrono | Todas | 3 – EAI – PAD. APP. | JSON | TOTVSCRM | |||
Cadastro de Vendedor | MATA040 | 1 - Sim | SELLER | VENDEDOR | Sim | Não | Assíncrono | Todas | 3 – EAI – PAD. APP. | JSON | TOTVSCRM | |||
Cadastro de Produto | MATA010 | 1 - Sim | ITEM | PRODUTO | Sim | Sim | Assíncrono | Todas | 3 – EAI – PAD. APP. | JSON | TOTVSCRM | |||
Cadastro de Tabela de Preço | OMSA010 | 1 - Sim | PRICELISTHEADERITEM | TABELA DE PRECO | Sim | Não | Assíncrono | Todas | 3 – EAI – PAD. APP. | JSON | TOTVSCRM | |||
Cadastro de Cliente/Fornecedor | MATA030 / CRMA980 ** | 1 - Sim | CUSTOMERVENDOR | CLIENTE/FORNECEDOR | Sim | Sim | Assíncrono | Todas | 3 – EAI – PAD. APP. | JSON | TOTVSCRM | |||
Pedido de Venda Faturamento | MATA410 | 1 - Sim | ORDER | PEDIDO DE VENDA | Não | Sim | Assíncrono | Todas | 3 – EAI – PAD. APP. | JSON | TOTVSCRM | |||
Cadastro de Cotação de Moeda | MATA090 | 1 - Sim | CURRENCYQUOTE | COTACAO DE MOEDA | Sim | Não | Assíncrono | Todas | 3 – EAI – PAD. APP. | JSON | TOTVSCRM | |||
Saldo de Produto | MATA225 | 1 - Sim | STOCKLEVEL | SALDO DE ESTOQUE | Sim | Não | Assíncrono | Todas | 3 – EAI – PAD. APP. | SB2 | JSON | TOTVSCRM | ||
Rastreabilidade de Pedido ³ | MATA410B | 1 - Sim | DOCUMENTTRACEABILITYORDER | RASTREABILIDADE DE PEDIDO | Sim | Não | Assíncrono | Todas | RTRIM(SC5->C5_ORIGEM) = 'MSGEAI' | 3 – EAI – PAD. APP. | JSON | TOTVSCRM |
Importante:
MATA030 / CRMA980 **: Necessário verificar o parâmetro no Protheus MV_MVCSA1, caso o parâmetro esteja como ".T." deve ser usado o adapter "CRMA980" caso esteja como ".F." deve ser usado o "MATA030".
* Rota: Informar a Rota de acordo com o Cadastro de Rotas EAI.
** Versão: Manter a versão que for carrega ao incluir a Rotina no Protheus.
*** Recomendado na configuração deixar tanto o “Envia” como o “Recebe” com “Não”, pois o cliente está em produção e existe uma sequência correta de cargas antes que se faça a integração de Vendedor, Produto e Cliente, deixando já ativo o diagrama começara a enviar para a integração estes cadastros com erro.
1 - Mensagem e Descrição precisa ser colocado exatamente como está no quadro
2 - Para a integração de Transportadora é necessário que o cliente esteja com o Acumulado do Faturamento atualizado superior à 15/09/2023, verificando o extrato de fontes é preciso ter o fonte MATI050O.prw com data superior à 31/05/2023.
3 - Não esquecer de colocar o filtro na condição deste adapter, pois só devem ser enviadas para integração status de pedidos que vieram da integração.