Páginas filhas
  • 6 - Configuração Adapters

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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:

  1. No Configurador (SIFACFG), acesse Ambientes/Schedule/Adapter E.a.i

  2. 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:

Image RemovedImage Added


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.

AdapterRotina ProtheusMensagem ÚnicaMensagem¹Descrição¹EnviaRecebeMétodo ProtheusOperaçãoCondição de envioCanal de EnvioAlias***Versão
Alias
Formato*Rota
Formato

FATA140

CommercialFamily

Whois Mensagem ÚnicaAPCFG0601 - SimWHOISWHOIS MENSAGEM UNICASimSimSíncronoTodas
2 - EAI - REST

XML
Cadastro de filiaisAPCFG2301 - SimBRANCHFILIAIS
Cadastro de Categoria
SimNãoAssíncronoTodas
ACU_ECFLAG="1"

PAD.APP 

2.000Rota TOTVS CRM

3 – EAI – PAD. APP.

JSON
APCFG230Branch
TOTVSCRM
Cadastro
de filiais
Unidade de MedidaQIEA0301 - SimUNITOFMEASUREUNIDADE DE MEDIDASimNãoAssíncronoTodas
3 – EAI – PAD.
APP 2.001Rota TOTVS CRMJSONLOJA701RetailSalesRetailSalesNão
APP.

JSONTOTVSCRM
Cadastro Grupo de ProdutosMATA0351 - SimSTOCKGROUPGRUPO DE PRODUTOSSimNão
Sim
AssíncronoTodas
3 – EAI – PAD. APP
2
.
007Rota TOTVS CRM


JSON
MATA010
TOTVSCRM
Item
Cadastro Transportadora ²
Produto
MATA0501 - SimCARRIERTRANSPORTADORASimNãoAssíncronoTodas

LjxjCsCoPr()


3 – EAI – PAD. APP
4.005

Rota TOTVS CRM

JSONFATA150Item
.

JSONTOTVSCRM
Cadastro Condição de PagamentoMATA3601 - SimPAYMENTCONDITIONCONDICAO DE PAGAMENTO
Categoria X Produto
SimNãoAssíncronoTodas
LjxjCsCoPr()

3 – EAI – PAD. APP.
4.005


JSON
ACVRota TOTVS CRMJSON
TOTVSCRM
Cadastro de VendedorMATA0401 - SimSELLERVENDEDOR
MATA550ItemGridGrade de Produto
SimNãoAssíncronoTodas
3 – EAI – PAD. APP.
1.000


JSON
SB4JSONMATA225Stocklevel
TOTVSCRM
Cadastro de ProdutoMATA0101 - SimITEMPRODUTO
Saldo de Produto
Sim
Não
SimAssíncronoTodas
3 – EAI – PAD. APP
3
.
000
SB2


JSON

SB8

SBF

JSON
TOTVSCRM
Cadastro de Tabela de PreçoOMSA0101 - SimPRICELISTHEADERITEMTABELA DE PRECOSimNão
LOJA704ItemReserveReserva de ItemNãoSim
AssíncronoTodas
3 – EAI – PAD. APP
1.000

Rota TOTVS CRM

JSONAGRA045WarehouseLocais de Estoque
.

JSONTOTVSCRM
Cadastro de Cliente/FornecedorMATA030 / CRMA980 **1 - SimCUSTOMERVENDORCLIENTE/FORNECEDORSimSimAssíncronoTodas
3 – EAI – PAD. APP
1
.
003Rota TOTVS CRM


JSON
OMSA010PriceListHeaderitemPriceListHeaderitemSim
TOTVSCRM
Pedido de Venda FaturamentoMATA4101 - SimORDERPEDIDO DE VENDANãoSimAssíncronoTodas
3 – EAI – PAD. APP.
2.000Rota TOTVS CRMJSONMATA030CustomerVendorCliente/FornecedorNão


JSONTOTVSCRM
Cadastro de Cotação de MoedaMATA0901 - SimCURRENCYQUOTECOTACAO DE MOEDASimNão
Sim
AssíncronoTodas
3 – EAI – PAD. APP
2.005

Rota TOTVS CRM

JSON
.

JSONTOTVSCRM
Saldo de ProdutoMATA2251 - SimSTOCKLEVELSALDO DE ESTOQUE
MATA410BDocumenttraceabilityorderRastreabilidade de Pedido
SimNãoAssíncronoTodas
3 – EAI – PAD. APP
1
.
000
Rota TOTVS CRM
SB2
JSON
LOJA140RetailSalesCancellationCancelamento da vendaNão
TOTVSCRM
Rastreabilidade de Pedido ³MATA410B1 - SimDOCUMENTTRACEABILITYORDERRASTREABILIDADE DE PEDIDOSimNão
Sim
AssíncronoTodasRTRIM(SC5->C5_ORIGEM) = 'MSGEAI'3 – EAI – PAD. APP.
1.002

Rota TOTVS CRM

JSON

Importante (informação)



JSONTOTVSCRM
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.

    1. No Configurador (SIFACFG), acesse Ambientes/Schedule/Emp.Fil.Msg.Unica.
    2. 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.

...