Histórico da Página
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 |
FATA140
CommercialFamily
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 |
PAD.APP
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 |
LjxjCsCoPr()
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 |
SB8
SBF
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. |
Importante
JSON | TOTVSCRM |
Aviso |
---|
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. |
Caso configure a Condição de Envio( ACU_ECFLAG="1" ) no adapter CommercialFamily, a mensagem será enviada para o TOTVS CRM apenas quando o campo E-Commerce ( ACU_ECFLAG) estiver configurado com a opção 1 - Ativo.
Caso configure a Condição de Envio( LjxjCsCoPr() ) no adapter Item, a mensagem só será enviada para o TOTVS CRM quando o produto cadastrado estiver vinculado a uma Categoria(ACV) e o o seu complemento(SB5) estiver marcado como E-commerce(B5_ECFLAG = 1) .
Cadastro de De/Para de Empresas:
No EAI Protheus deve-se cadastrar um relacionamento entre a Empresa e Filial do TOTVS CRM com uma existente no Protheus. Isto se deve ao fato de que, na Mensagem Única TOTVS
os valores trafegados na mensagem são sempre do sistema que enviou a mensagem, cabendo ao sistema receptor a tradução das informações trafegadas.
- No Configurador (SIFACFG), acesse Ambientes/Schedule/Emp.Fil.Msg.Unica.
- Cadastre De-Para de Empresas e Filiais e configure-os conforme os valores a seguir:
...
** 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. |
...