Histórico da Página
Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
I. Validação do Checklist e Criação do RAC e Connector
Ao receber o checklist pela abertura do chamado ou por e-mail, é necessário validar se estão com todos os dados necessários para integração, de acesso ao sistema do cliente, de acesso ao sistema CRM, dos pré-requisitos do CRM já configurados como solicitado no checklist e o ambiente REST funcionando.
1. Versões e Atualizações do Sistema
Verificar as versões do sistema do Cliente e solicitar para aplicar as versões mínimas de funcionamento da integração conforme checklist, as versões podem ser verificadas acessando o sistema do cliente e clicando nas teclas Shift+F6, caso não atendam pedir para o cliente atualizar os itens que estão em desacordo além das atualizações que já devem ser enviadas para o cliente aplicar para a integração padrão.
Aplicação Expedição Continua Estoque (o mais atual)
Aplicação Expedição Continua Faturamento (o mais atual)
Aplicação Pacote de Customizações Analytics (Enviar de acordo com a versão do cliente o fonte:
Fontes-Analytics-V0105_12_1_25_tttp120.ptm ou
Fontes-Analytics-V0105_12_1_27_tttp120.ptm)
Executar em modo exclusivo rotina para criação do campo S.T.A.M.P (Configurações Analytics.pptx)
Além das atualizações acima, caso o cliente esteja com mais alguma versão mínima em desacordo com as versões mínimas solicitadas, já enviar para ele que faça as atualizações antes de dar início ao processo de integração, caso contrário terá problemas no processo de integração.
2. Dados do cliente para criação do RAC e Connector.
3. Solicitação da criação do RAC e Connector
Enviar e-mail com o texto abaixo solicitando a criação do RAC e Connector, utilizando os dados do cliente que estão no checklist conforme imagem acima. Exemplo de E-mail para Criação:
3.1. Criação da senha do RAC
Quando criado o RAC, o e-mail colocado em E-mail do Analista de Integração (com o perfil “Admin”) irá receber um e-mail conforme abaixo para fazer a criação da senha do RAC. Clicar em Definir senha e colocar uma senha. Caso seja feito pelo e-mail do cliente, solicitar que ele crie a senha e envie a senha para o analista que está fazendo a configuração, caso o e-mail seja do próprio analista passar para o próximo item para configurar o RAC.
4. Acesso do ERP do Cliente
4.1. Acesso ao sistema ERP
Validar o acesso ao sistema do cliente com as informações passada no checklist, pela forma que ele
passou, caso não consiga o acesso entrar em contato com o cliente informando e pedindo para revisar a forma de acesso.
4.2. Acesso do REST
Verificar o REST do cliente, caso não esteja acessando já relatar ao analista responsável para verificar com o cliente, também solicitar ao cliente para verificar o INI do serviço REST se foi feito as configurações solicitadas no checklist conforme imagem abaixo, ao acessar o link deve abrir a página conforme exemplo abaixo.
5. Acesso e configuração sistema CRM
Verificar se o sistema está acessando com pelo link e usuário e senha que devem ter sido criados pelo analista do CRM que preencheu o checklist.
5.1. Tipo de Documento IR
Verificar no TOTVS CRM se foi criado o tipo de documento IR em “Administrativo\Configuração\Documentos de Identificação”. Estando criado, clicar em Editar para
pegar o Id do registro, que será usado no Configuration.
5.2. Vínculos de Documentos
Verificar se foram feitos todos os vínculos de documento conforme é solicitado no checklist. São 11 vínculos. Contas\Configurações\Documentos do cliente.
5.3. Tipos de Frete
Verificar se foi configurado os Tipos de Frete, são 6 tipos de frete, 4 além dos 2 padrões que já veem no CRM. Precisa ficar configurado conforme está abaixo e no checklist em Vendas\Configurações\Tipos de frete.
5.4. Tipos de Ordem de Venda
Caso seja usado o Pedido de Venda, que está no item 1 do checklist, será necessário configurar os Tipos de Ordem de Venda em Vendas\Configurações\Tipos de ordem de venda.
5.4.1. TES Inteligente:
5.4.2. TES Padrão:
II. Criação do Configuration e SyncControl
1. Autenticando no Swagger
Para fazer a criação do Configuration é preciso primeiro pegar o RAC Token da base para fazer o acesso via Swaager. Para obter ele iremos usar o Postman.
Abra o Postman e crie uma Request de Post, e coloque o endereço do RAC do cliente criado
Na aba “Authorization” coloque em Type: Bearer Token e ao lado direito coloque a variável {{rac-token}}
Na aba Headers acrescente a Key: Content-Type” com o Value: application/x-www-form-urlencoded
Na aba Body acrescente as Key abaixo com seus respectivos valores, username e password são os criados no usuário Integração do RAC.
Com estes dados preenchidos clicar no Botão SEND irá ter um retorno conforme abaixo, copiar a informação dentro do Token para utilizarmos no Swagger.
Com a informação do Token acessar o site https://master-crm-api.totvs.app/swagger/index.html e clicar no botão Authorize para inserir o Token. Digitar a palavra Bearer dar um espaço e colar o Token que foi gerado no Postman.
Para validar se está no ambiente correto, clicar em Application e ir no segundo Get e clicar no botão Try it Out após clicar em Execute. Se tudo tiver sido criado corretamente irá trazer um retorno com código 200, e com as informações do cliente que está logado no Swagger.
2. Criando o Configuration
Após autenticado no ambiente clicar em Configuration na opção Post e clicar em Try it Out.
Segue abaixo o Configuration padrão, devem ser alterados os campos em vermelho com as informações do ERP do cliente e do CRM.
Bloco de código |
---|
{ "erpName": "ERP PROTHEUS-CRM - APELIDO", "masterCRMName": "apelido", "erpClientId": "", "erpClientSecret": "", "erpCompanyId": "", "erpBranchId": "", "erpurl": "http://IPREST:Porta/rest/totvseai/standardmessage/v1/transactions/", "erpURLAnalyticsSyncControls": "http://IPREST:Porta/rest/", "masterCRMClientId": "[email protected]", "masterCRMClientSecret": "", "masterCRMDefaultDocumentTypeIR": "", "hubUrlapi": "https://master-crm-api.totvs.app/", "masterCRMDefaultURL": "https://app2.mastercrm.ws/api/v1/integration/record", "masterCRMURLCustomer": "https://app2.mastercrm.ws/api/v1/integration/record", "masterCRMURLLogin": "https://app2.mastercrm.ws/api/login", "masterCRMURLCity": "https://app2.mastercrm.ws/api/v1/integration/record", "masterCRMURLState": "https://app2.mastercrm.ws/api/v1/integration/record", "masterCRMURLCountry": "https://app2.mastercrm.ws/api/v1/integration/record", "masterCRMURLMeasurementUnit": "https://app2.mastercrm.ws/api/v1/integration/record", "masterCRMURLPriceTable": "https://app2.mastercrm.ws/api/v1/integration/record", "masterCRMURLProductGroup": "https://app2.mastercrm.ws/api/v1/integration/record", "masterCRMURLOrder": "https://app2.mastercrm.ws/api/v1/integration/record", "masterCRMURLRegion": "https://app2.mastercrm.ws/api/v1/integration/record", "masterCRMURLRegionUser": "https://app2.mastercrm.ws/api/v1/integration/record", "masterCRMURLRegionCustomer": "https://app2.mastercrm.ws/api/v1/integration/record", "masterCRMURLCurrency": "https://app2.mastercrm.ws/api/v1/integration/record", "masterCRMURLCurrencyQuotation": "https://app2.mastercrm.ws/api/v1/integration/record", "masterCRMURLPriceTableItem": "https://app2.mastercrm.ws/api/v1/integration/record", "masterCRMURLPaymentMethod": "https://app2.mastercrm.ws/api/v1/integration/record", "masterCRMURLFreight": "https://app2.mastercrm.ws/api/v1/integration/record", "masterCRMURLPaymentTerms": "https://app2.mastercrm.ws/api/v1/integration/record", "masterCRMDefaultEmailType": "301f0e6e-4270-472b-aa96-45ab017bcbb1", "masterCRMDefaultPhoneType": "d870427c-bbad-4eb8-9af5-5183b47f648f", "masterCRMDefaultNaturalPersonType": "8cea3c86-1984-4c77-acf5-3f622c1efe5b", "masterCRMDefaultLegalPersonType": "40694c1a-44f9-4c3b-a5a8-aa63e0742c75", "masterCRMDefaultDocumentTypeIM": "195e4d51-21fb-4721-a249-ea0aa89fc52f", "masterCRMDefaultDocumentTypeSUF": "41eed97d-4e6e-49de-b7a2-eb8a772f80bf", "masterCRMDefaultDocumentTypeCNPJ": "651b2c32-aeca-4373-9cb9-96b132ba5020", "masterCRMDefaultDocumentTypeCPF": "95839570-6791-49f4-88fe-68efd115213d", "masterCRMDefaultDocumentTypeRG": "9aabec6d-a88b-4d09-8ce6-d0eaf5b16d3c", "masterCRMDefaultDocumentTypeIE": "a564151a-931e-43ba-959b-47bab27e274a", "masterCRMDefaultAddressType": "b604f287-36bf-4e6d-ae83-c75c46a2fbeb", "hubURLAnalyticsSyncControls": "https://master-crm-api.totvs.app/", "masterCRMURLAnalyticsSyncControls": "https://app2.mastercrm.ws/", "erpWarehouseCode": null, "erpDefaultCurrencySymbol": "R$" } |
Copiar o Json e colar dentro da janela de Value, conforme imagem abaixo e clicar em Executar