You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: api-guides/e-receipts-enterprise-app-integration-guide.html
+35-22Lines changed: 35 additions & 22 deletions
Original file line number
Diff line number
Diff line change
@@ -665,7 +665,8 @@ <h2 id="app-center-flow---connecting-from-sap-concur-app-center">App Center Flow
665
665
666
666
<p><strong>Example of App Listing:</strong></p>
667
667
668
-
<p><imgsrc="/assets/img/api-guides/e-receipts-enterprise/step-1.png" alt="Example of App Center Listing Page" /></p>
668
+
<divclass="language-plaintext highlighter-rouge"><divclass="highlight"><preclass="highlight"><code>
669
+
</code></pre></div></div>
669
670
670
671
<ol>
671
672
<li>
@@ -678,12 +679,9 @@ <h2 id="app-center-flow---connecting-from-sap-concur-app-center">App Center Flow
678
679
</li>
679
680
<li>
680
681
<p>Your landing page should allow an admin user to log in/authenticate.</p>
681
-
</li>
682
-
</ol>
683
-
684
-
<p><imgsrc="/assets/img/api-guides/e-receipts-enterprise/step-4.png" alt="Screenshot of Login Page" /></p>
685
682
686
-
<ol>
683
+
<p><imgsrc="/assets/img/api-guides/e-receipts-enterprise/step-4.png" alt="Screenshot of Login Page" /></p>
684
+
</li>
687
685
<li>
688
686
<p>The redirect URI will contain id and requestToken parameters. Example: <codeclass="language-plaintext highlighter-rouge">https://{partner-redirect-URI}?id=e693e3d8-00f5-4e8d-9b87-9b42896e01bd&requestToken=at-si86uekvgga2qj2i1bfj89juqgn&userId=715810de-a259-4f7d-bad7-35badc9980bb</code></p>
689
687
</li>
@@ -739,10 +737,18 @@ <h2 id="app-center-flow---connecting-from-sap-concur-app-center">App Center Flow
739
737
<p>After admin user has successfully completed the login process, store the following with company’s profile in your database:</p>
740
738
741
739
<ul>
742
-
<li><codeclass="language-plaintext highlighter-rouge">refresh_token</code>: (36 characters including dashes) valid for six months from the day and time issued.</li>
743
-
<li><codeclass="language-plaintext highlighter-rouge">refresh_expires_in</code>: expiration date & time in Epoch time format, please convert to UTC format.</li>
744
-
<li><codeclass="language-plaintext highlighter-rouge">geolocation</code>: to be used as the base URI when making API calls on behalf of the user.</li>
745
-
<li><codeclass="language-plaintext highlighter-rouge">id</code>: (36 characters including dashes) The company <codeclass="language-plaintext highlighter-rouge">uuid</code> used for identity the connected company.</li>
740
+
<li>
741
+
<p><codeclass="language-plaintext highlighter-rouge">refresh_token</code>: (36 characters including dashes) valid for six months from the day and time issued.</p>
742
+
</li>
743
+
<li>
744
+
<p><codeclass="language-plaintext highlighter-rouge">refresh_expires_in</code>: expiration date & time in Epoch time format, please convert to UTC format.</p>
745
+
</li>
746
+
<li>
747
+
<p><codeclass="language-plaintext highlighter-rouge">geolocation</code>: to be used as the base URI when making API calls on behalf of the user.</p>
748
+
</li>
749
+
<li>
750
+
<p><codeclass="language-plaintext highlighter-rouge">id</code>: (36 characters including dashes) The company <codeclass="language-plaintext highlighter-rouge">uuid</code> used for identity the connected company.</p>
751
+
</li>
746
752
</ul>
747
753
</li>
748
754
<li>
@@ -766,17 +772,22 @@ <h3 id="refreshing-a-token">Refreshing a Token</h3>
766
772
</li>
767
773
<li>
768
774
<p>The below elements are returned with the new <codeclass="language-plaintext highlighter-rouge">access_token</code>, replace previously stored values for the company in your database:</p>
<li>If a company’s integration is idle for six months the <codeclass="language-plaintext highlighter-rouge">refresh_token</code> will expire and the company’s partner account and SAP Concur account will be de-linked. To prevent this from happening, build a scheduled job that scans your database for expiration dates and refreshes tokens X days prior to expiration. Refer <ahref="https://developer.concur.com/api-reference/authentication/apidoc.html#refreshing-a-token-">Refreshing a Token</a> API for the post body description and example.</li>
<p>If a company’s integration is idle for six months the <codeclass="language-plaintext highlighter-rouge">refresh_token</code> will expire and the company’s partner account and SAP Concur account will be de-linked. To prevent this from happening, build a scheduled job that scans your database for expiration dates and refreshes tokens X days prior to expiration. Refer <ahref="https://developer.concur.com/api-reference/authentication/apidoc.html#refreshing-a-token-">Refreshing a Token</a> API for the post body description and example.</p>
<h3id="linking-user-accounts">Linking User Accounts</h3>
799
810
800
-
<p>Consult with the customer which employee’s will be invited to utilize the integration. Common method for inviting employees to create or link an account (if employee has an existing account) is via an email invitation. If an employee does not have an existing account, invite employee to create an account. Ensure that employee’s is link to the company’s account. If an employee has an existing account, link the existing account to the company’s account. <strong>Recommendation:</strong> Provide a dashboard to company to manage employee’s utilizing the integration.</p>
811
+
<p>Consult with the customer which employee’s will be invited to utilize the integration. Common method for inviting employees to create or link an account (if employee has an existing account) is via an email invitation. If an employee does not have an existing account, invite employee to create an account. Ensure that employee’s is link to the company’s account. If an employee has an existing account, link the existing account to the company’s account.</p>
812
+
813
+
<p><strong>Recommendation:</strong> Provide a dashboard to company to manage employee’s utilizing the integration.</p>
801
814
802
815
<h3id="getting-all-active-users">Getting All Active Users</h3>
0 commit comments