3 - Configuração Configuration

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-CRM - APELIDO",
  "erpClientId": "",
  "erpClientSecret": "",
  "erpCompanyId": "",
  "erpBranchId": "",
  "erpurl": "http://IPREST:Porta/rest/totvseai/standardmessage/v1/transactions/",
  "erpURLAnalyticsSyncControls": "http://IPREST:Porta/rest/",
  "masterCRMName": "apelido",
  "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$"
}

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

Páginas filhas

3 - Configuração Configuration