- 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.
1.1 Abra o Postman e crie uma Request de Post, e coloque o endereço do RAC do cliente criado
1.2 Na aba “Authorization” coloque em “Type”: “Bearer Token” e ao lado direito coloque a variável “{{rac-token}}”
1.3 Na aba “Headers” acrescente a “Key”: “Content-Type” com o “Value”: “application/x-www-form-urlencoded”
1.4 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.
1.5 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.
2. 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.
2.1 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.2 Após clicar em “Configuration” na opção “Post” e clicar em “Try it Out”
2.3 Segue abaixo o “Configuration” padrão que de ser alterado os campos em vermelho com as informações do ERP do cliente e do CRM
{ "erpName": "ERP PROTHEUS – Nome Cliente", "masterCRMName": "", "erpurl": "http://IP:Porta/rest/totvseai/standardmessage/v1/transactions/", "erpClientId": "", "erpClientSecret": "", "masterCRMURLCustomer": "https://app2.mastercrm.ws/api/v1/integration/record", "masterCRMClientId": "", "masterCRMClientSecret": "", "erpCompanyId": "", "erpBranchId": "", "masterCRMURLLogin": "https://app2.mastercrm.ws/api/login", "masterCRMDefaultEmailType": "301f0e6e-4270-472b-aa96-45ab017bcbb1", "masterCRMDefaultPhoneType": "d870427c-bbad-4eb8-9af5-5183b47f648f", "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": null, "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", "masterCRMDefaultDocumentTypeIR": "" "masterCRMDefaultAddressType": "b604f287-36bf-4e6d-ae83-c75c46a2fbeb", "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", "erpWarehouseCode": "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", "erpDefaultCurrencySymbol": "R$", "masterCRMURLCurrencyQuotation": "https://app2.mastercrm.ws/api/v1/integration/record", "masterCRMURLPriceTableItem": "https://app2.mastercrm.ws/api/v1/integration/record", "masterCRMURLPaymentMethod": null, "masterCRMURLFreight": null, "hubURLAnalyticsSyncControls": "https://master-crm-api.totvs.app/", "erpURLAnalyticsSyncControls": " http://IP:Porta/rest/", "masterCRMURLAnalyticsSyncControls": "https://app2.mastercrm.ws/", "hubUrlapi": "https://master-crm-api.totvs.app/", "masterCRMURLPaymentTerms": "https://app2.mastercrm.ws/api/v1/integration/record", }
Observação: "
masterCRMName": "" = Nome da Empresa de acesso ao TOTVS CRM
"erpurl": http://IP:Porta/rest/totvseai/standardmessage/v1/transactions/ = substituir o IP e a Porta pelas do endereço do ambiente REST do cliente, manter a informação “/rest/totvseai/standardmessage/v1/transactions/” "erpClientId": "" = Usuário do Protheus para integração
"erpClientSecret": "" = Senha do Usuário Protheus para integração
"masterCRMClientId": "" = Usuário do TOTVS CRM para integração
"masterCRMClientSecret": "" = Senha do Usuário do TOTVS CRM para integração
"erpCompanyId": "" = Grupo de Empresas do Protheus
"erpBranchId": "" = Código de uma das Filiais do Protheus
"masterCRMDefaultDocumentTypeIR": "" = Id do Tipo de Documento IR criado no TOTVS CRM
"erpURLAnalyticsSyncControls": " http://IP:Porta/rest/" = substituir o IP e a Porta pelas do endereço do ambiente REST do cliente.
2.4 Copiar o Json e colar dentro da janela de Value, conforme imagem abaixo e clicar em Executar
2.5 Deverá ter um retorno de Código 201 com sucesso na criação no “Configuration”.