Histórico da Página
...
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.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.
32. Para 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.
42. Após 2 Após clicar em “Configuration” na opção “Post” e clicar em “Try it Out”
52. Segue 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
Bloco de código |
---|
{
"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$"
} |
Aviso |
---|
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 6. Copiar o Json e colar dentro da janela de Value, conforme imagem abaixo e clicar em Executar
72. Deverá 5 Deverá ter um retorno de Código 201 com sucesso na criação no “Configuration”.
...