SAP Concur Developer Center |参会人员v1.1

此API已弃用。

使用已弃用API的合作伙伴和客户应该联系SAP Concur，并讨论如何转移到最新版本。

为指定的费用条目创建或更新一个或多个与会者记录。参会者是额外的从这笔费用中受益的人。

与会者外部ID注意事项

与会者可以通过他们的外部ID在Concur之外被唯一标识。这个值可以来自记录的参与者系统，也可以由Concur生成，这取决于配置。为了使用Concur web服务管理(添加或更新)与会者，与会者必须有一个External ID值。

在Concur中共享的与会者(由系统拥有)通常具有External ID值，这些值是在与会者被添加到系统时建立的。与这些参与者打交道的开发人员应该在请求URI中使用必需的查询参数，并且不应该包括可选的AttendeeID查询参数。请求中的External ID值将标识与会者。这些请求必须包括SystemOwner元素(设置为Yes)，以表明参与者是共享列表的一部分。

私有的与会者或允许手动添加(不推荐)的共享列表的一部分的与会者可能没有外部ID，因此他们最初不能用该值唯一标识。需要更新私有与会者(属于报表所有者)或没有外部id的共享与会者的开发人员应该使用可选的AttendeeID查询参数来标识与会者。这些开发人员必须提供一个External ID值，以便在以后的请求中使用该值来标识参与者。对于私有参与者，这个请求应该包括SystemOwner元素，设置为No，以表明参与者是私有的。对于共享与会者，这个请求应该包括SystemOwner元素，设置为Yes。

注:

发布费用报告信息是一个多级过程。参考费用报告v3发布新费用报告和条目所需步骤的文档。

支持内容类型

应用程序/ XML

邮政会员到费用报告条目

要求

头

RFC 7235授权-授权头与OAuth令牌为有效的Concur用户。OAuth消费者必须具有以下角色之一，以便在他们不拥有的报告中发布与会者的费用:
- Web服务管理为职业
- 可以管理对于标准

参数

参数	描述
Reportid.	必需的费用报告的唯一标识符
目录/与会者	必需的费用条目和参会者关键字的唯一标识符
attendeeId	与会者的唯一标识符。仅用于某些情况下更新现有与会者。如果开发人员不知道与会者的外部ID，他们应该使用这个查询参数

的Reportid.值返回获取报告列表函数，并作为Report-Details-Url元素的费用报告头v1.1函数。属性中返回entryId值ReportKey元素的得到报告细节函数。
的attendeeId值在AttendeeKey元素的得到报告细节函数，并作为Attendee-Details-Url该函数返回的值。

URI模板

         https://www.concursolutions.com/api/expense/expensereport/v1.1/report/ {reportId} /条目/ {entryId} /与会者https://www.concursolutions.com/api/expense/expensereport/v1.1/report/ {reportId} /条目/ {entryId} /与会者/ {attendeeId}
        

有效载荷

该请求包含一个与会者父元素与一个出席者每个包括的参加者的元素。更新操作只允许每个请求有一个参与者。的出席者元素包含以下子元素：

元素名称	必须(必须包含值)?	描述
AttendeeType	Y	Concur用于标识与会者的与会者类型代码。8个字母字符。客户端可以添加他们自己的自定义参与者类型代码。标准的与会者类型代码是:BUSGUEST(商务客人)和SPOUSE(员工配偶)。使用出席者类型v1功能的与会者列表web服务，以获得可用类型的完整列表。最多8个字符。
量	N	与该与会者相关的费用金额。如果出席人数没有加到全部费用条目的数量，用户必须在提交报告之前在Concur UI中更正条目。
姓	Y	与会者的姓。最多132个字符。
FirstName	取决于配置	与会者的名字。最大的50个字符。
标题	取决于配置	与会者的职称。最多32个字符。
苗	Y	与会者的唯一标识符，通常由客户的外部记录系统提供。最大48个字符。
公司	取决于配置	与会者的公司名称。最多150个字符。
通过Custom20 Custom1	取决于配置	费用参与者表单上的自定义字段。根据配置可能需要。
CrnCode	Y	的3字母ISO 4217货币代码对于费用交易金额。示例：usd。最多3个字符。
SystemOwner	N	为新与会者:选择“是”时，表示与会者属主为“系统”。共享与会者列表需要这个所有者。当不设置为Yes时，参与者所有者被设置为报表所有者。对于现有与会者:必须设置为Yes，才能更新现有系统所有的与会者。非系统拥有的与会者的所有者将被设置为System。当设置为No时，参与者所有者将与报表所有者进行比较。如果报表所有者和参与者所有者匹配，则更新参与者。如果报表所有者和参与者所有者不匹配，参与者将不被更新。
AssociatedAttendeesCount	N	未命名但与此与会者相关联的与会者的数量。这个数字是包含在出席总人数的费用。
UpdateExisting	N	请求是否应使用匹配的外部ID更新与会者。如果设置为false，请求不会更新匹配的参加者。如果未提供，或设置为true，请求将更新匹配的参加者。格式：真/假

状态码

看到HTTP状态代码

有效载荷

这个请求将返回一个attendee-batch-result具有以下子元素的父元素：

元素名称	描述
records-succeeded	成功添加/更新的参与者记录的数量。
记录 - 失败	失败的参与者记录数。
AttendeeInfoList	这个父元素包含一个AttendeeStatus元素用于每个成功参加者记录。的AttendeeStatus元素包含以下子元素：
指数	与会者记录的记录号。
状态	请求的状态。
Attendee-Details-Url	访问此参加者详细信息的URL。
错误	这个父元素包含一个错误元素用于每个失败的与会者记录。的错误父元素包含一个或多个错误子元素。

错误

元素名称	描述
指数	与会者记录的记录号。
消息	错误消息。

例子

要求

         文章https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nxxKgLlnROz3zHJBCRksaas23dsfs/entry/n7We3qWw99u1KoWTMaLhSC$ pxbyzq1udhn./参加者授权:OAuth｛令牌｝
        

         <与会者xmlns =“http://www.concursolutions.com/api/expense/expensereport/2011/03”><出席者>< AttendeeType >BUSGUEST< / AttendeeType >戴维斯< / LastName ><名>帕特< / FirstName ></span>首席财务官<span class="nt">< /名称></span><span class="nt">< ExternalId ></span>224234<span class="nt">< / ExternalId ></span><span class="nt"><公司></span>Len Dev<span class="nt">> < /公司</span><span class="nt">< Custom1 ></span>N<span class="nt">< / Custom1 ></span><span class="nt">< Custom2 ></span>会议<span class="nt"></ custom2></span><span class="nt"><crncode></span>美元<span class="nt">< / CrnCode ></span><span class="nt">< /与会者></span><span class="nt"><出席者></span><span class="nt">< AttendeeType ></span>BUSGUEST<span class="nt">< / AttendeeType ></span><span class="nt"><lastname></span>弗莱彻<span class="nt">< / LastName ></span><span class="nt"><名></span>艾琳<span class="nt">< / FirstName ></span><span class="nt"><title></span>会计部经理<span class="nt">< /名称></span><span class="nt">< ExternalId ></span>344534<span class="nt">< / ExternalId ></span><span class="nt"><公司></span>Len Dev<span class="nt">> < /公司</span><span class="nt">< Custom1 ></span>N<span class="nt">< / Custom1 ></span><span class="nt">< Custom2 ></span>会议<span class="nt"></ custom2></span><span class="nt"><crncode></span>美元<span class="nt">< / CrnCode ></span><span class="nt">< AssociatedAttendeesCount ></span>5<span class="nt">< / AssociatedAttendeesCount ></span><span class="nt">< /与会者></span><span class="nt"></与会者></span></code></pre>
        </div>
       </div>
       <h4 id="request-create-an-attendee-owned-by-the-system">请求:创建系统拥有的与会者</h4>
       <p>这允许您为配置为共享列表(集中管理)的与会者类型创建与会者。</p>
       <div class="language-shell highlighter-rouge">
        <div class="highlight">
         <pre class="highlight"><code>文章https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nxxKgLlnROz3zHJBCRksaas23dsfs/entry/n7We3qWw99u1KoWTMaLhSC<span class="nv">$ pxbyzq1udhn.</span>/参加者授权:OAuth<span class="o">｛</span>令牌<span class="o">｝</span></code></pre>
        </div>
       </div>
       <div class="language-xml highlighter-rouge">
        <div class="highlight">
         <pre class="highlight"><code><span class="nt"><与会者</span><span class="na">xmlns =</span><span class="s">“http://www.concursolutions.com/api/expense/expensereport/2011/03”</span><span class="nt">></span><span class="nt"><出席者></span><span class="nt">< AttendeeType ></span>BUSGUEST<span class="nt">< / AttendeeType ></span><span class="nt"><lastname></span>Gato<span class="nt">< / LastName ></span><span class="nt"><名></span>Bailey.<span class="nt">< / FirstName ></span><span class="nt"><title></span>财务经理<span class="nt">< /名称></span><span class="nt">< ExternalId ></span>998238<span class="nt">< / ExternalId ></span><span class="nt"><公司></span>Len Dev<span class="nt">> < /公司</span><span class="nt">< Custom1 ></span>N<span class="nt">< / Custom1 ></span><span class="nt">< Custom2 ></span>会议<span class="nt"></ custom2></span><span class="nt"><crncode></span>美元<span class="nt">< / CrnCode ></span><span class="nt">< SystemOwner ></span>是的<span class="nt">< / SystemOwner ></span><span class="nt">< /与会者></span><span class="nt"></与会者></span></code></pre>
        </div>
       </div>
       <h4 id="response-1">回复</h4>
       <div class="language-shell highlighter-rouge">
        <div class="highlight">
         <pre class="highlight"><code>HTTP/1.1 200 OK内容类型:application/xml</code></pre>
        </div>
       </div>
       <div class="language-xml highlighter-rouge">
        <div class="highlight">
         <pre class="highlight"><code><span class="nt">< attendee-batch-result</span><span class="na">xmlns =</span><span class="s">“http://www.concursolutions.com/api/expense/expensereport/2011/03”</span><span class="na">XMLNS：i =</span><span class="s">“http://www.w3.org/2001/XMLSchema-instance”</span><span class="nt">></span><span class="nt">< records-succeeded ></span>2<span class="nt">< / records-succeeded ></span><span class="nt"><记录失败></span>0<span class="nt">< / records-failed ></span><span class="nt"><与会者愿意></span><span class="nt"><rendereestatus></span><span class="nt"><指数></span>1<span class="nt"></索引></span><span class="nt">< >状态</span>成功<span class="nt"></ status></span><span class="nt">< Attendee-Details-Url ></span>https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nxxKgLlnROzjLoLX67fYGzI pMGj4dZdfU美元/条目/ nE0avYnILMdxd6MTj0 sM6iloOYz0Mzl pX美元/人/ nFaAj038Hxv6eoOU9SvVwhK0Rj5Kc7Twl<span class="nt">< / Attendee-Details-Url ></span><span class="nt"></ rendeEestatus></span><span class="nt"><rendereestatus></span><span class="nt"><指数></span>2<span class="nt"></索引></span><span class="nt">< >状态</span>成功<span class="nt"></ status></span><span class="nt">< Attendee-Details-Url ></span>https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nxxKgLlnROzjLoLX67fYGzI pMGj4dZdfU美元/条目/ nE0avYnILMdxd6MTj0 sM6iloOYz0Mzl pX美元/人/ nFaAj038Hxv3gxNiO5ei3 peY761ggLnBh美元<span class="nt">< / Attendee-Details-Url ></span><span class="nt"></ rendeEestatus></span><span class="nt">< / AttendeeInfoList ></span><span class="nt">< / attendee-batch-result ></span></code></pre>
        </div>
       </div>
       <h4 id="response-error-present">响应:错误</h4>
       <div class="language-shell highlighter-rouge">
        <div class="highlight">
         <pre class="highlight"><code>HTTP/1.1 200 OK内容类型:application/xml</code></pre>
        </div>
       </div>
       <div class="language-xml highlighter-rouge">
        <div class="highlight">
         <pre class="highlight"><code><span class="nt">< attendee-batch-result</span><span class="na">xmlns =</span><span class="s">“http://www.concursolutions.com/api/expense/expensereport/2011/03”</span><span class="na">XMLNS：i =</span><span class="s">“http://www.w3.org/2001/XMLSchema-instance”</span><span class="nt">></span><span class="nt">< records-succeeded ></span>1<span class="nt">< / records-succeeded ></span><span class="nt"><记录失败></span>1<span class="nt">< / records-failed ></span><span class="nt"><错误></span><span class="nt">< >错误</span><span class="nt"><指数></span>1<span class="nt"></索引></span><span class="nt"><消息></span>AttendeeType不存在:BUSGUEST1<span class="nt"></ message></span><span class="nt">> < /错误</span><span class="nt">> < /错误</span><span class="nt"><与会者愿意></span><span class="nt"><rendereestatus></span><span class="nt"><指数></span>2<span class="nt"></索引></span><span class="nt">< >状态</span>成功<span class="nt"></ status></span><span class="nt">< Attendee-Details-Url ></span>https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nxxKgLlnROzjLoLX67fYGzI pMGj4dZdfU美元/条目/ nE0avYnILMdxd6MTj0 sM6iloOYz0Mzl pX美元/人/ nFaAj038HwYk7lweHaEerudeUKgVs8ATS<span class="nt">< / Attendee-Details-Url ></span><span class="nt"></ rendeEestatus></span><span class="nt">< / AttendeeInfoList ></span><span class="nt">< / attendee-batch-result ></span></code></pre>
        </div>
       </div>
      </div>
      <!--/col-md-9-->
     </div>
     <!--/row-->
    </div>
    <!--/container-->
   </div>
   <footer class="hidden-print">
    <div class="footer">
     <div class="container">
      <div class="row">
       <div class="col-md-3 company-description">
        <p>SAP Concur是一家领先的差旅和费用管理解决方案提供商。<a href="//www.g-goddess.com/developer/en-us/about-concur">更多的<i class="fas fa-angle-right"></i></a></p>
       </div>
       <div class="col-md-3">
        <h2 class="headline">对SAP一致</h2>
        <ul class="list-unstyled link-list">
         <li><a href="//www.g-goddess.com/developer/en-us/media-resources/press-releases">新闻稿</a><i class="fas fa-angle-right"></i></li>
         <li><a href="//www.g-goddess.com/developer/en-us/about/news">在新闻中</a><i class="fas fa-angle-right"></i></li>
         <li><a href="//www.g-goddess.com/developer/en-us/events">事件</a><i class="fas fa-angle-right"></i></li>
        </ul>
       </div>
       <div class="col-md-3">
        <h2 class="headline">接触</h2>
        <address>东北108大街601号，1000室<br>Bellevue，WA 98004 USA<br>电话:+1 425 590 5000<br>传真：+1 425 590 5999</address>
       </div>
      </div>
      <div class="row footer-github">
       <div class="col-md-12 text-center">
        <a href="https://github.com/concur/developer.concur.com/blob/preview/src/api-reference/expense/attendees/v1dot1.attendees.markdown"><i class="fab fa-github fa-2x"></i>在GitHub上编辑此页面</a>
        <span>|</span>
        <a href="https://github.com/concur/developer.concur.com/commit/95a09406">产于95年a09406</a>
       </div>
      </div>
      <div class="row footer-copyright">
       <div class="col-md-8">
        <p>©版权所有。<a href="//www.g-goddess.com/developer/en-us/privacy-policy">隐私政策</a>|<a href="//www.g-goddess.com/developer/terms-of-use-2021.html">使用条款</a>|<a href="//www.g-goddess.com/developer/tools-support/deprecation-policy.html">API弃用策略</a></p>
       </div>
       <!-- Social Links -->
       <div class="col-md-4">
        <ul class="list-inline social-icons">
         <li><a href="https://www.facebook.com/SAPConcur" target="_blank"><span class="sr-only">Facebook</span><span class="fa-stack fa-lg"><i class="fas fa-circle fa-stack-2x"></i><i class="fab fa-facebook-f fa-stack-1x fa-inverse"></i></span></a></li>
         <li><a href="https://www.linkedin.com/company/5822" target="_blank"><span class="sr-only">LinkedIn</span><span class="fa-stack fa-lg"><i class="fas fa-circle fa-stack-2x"></i><i class="fab fa-linkedin-in fa-stack-1x fa-inverse"></i></span></a></li>
         <li><a href="https://twitter.com/sapconcur" target="_blank"><span class="sr-only">推特</span><span class="fa-stack fa-lg"><i class="fas fa-circle fa-stack-2x"></i><i class="fab fa-twitter fa-stack-1x fa-inverse"></i></span></a></li>
         <li><a href="https://www.youtube.com/playlist?list=PLLNSVdjqNPVseaDkR5hSF4CDjnlLK7_nq" target="_blank"><span class="sr-only">YouTube</span><span class="fa-stack fa-lg"><i class="fas fa-circle fa-stack-2x"></i><i class="fab fa-youtube fa-stack-1x fa-inverse"></i></span></a></li>
        </ul>
       </div>
       <!-- End Social Links -->
      </div>
      <!--/.footer-copyright-->
     </div>
     <!--/.container-->
    </div>
    <!--/.footer-->
   </footer>
  </div>
  <!--/wrapper-->
  <!-- JS Global Compulsory -->
  <!-- forms -->
  <!-- Swagger -->
  <!-- <script src="//www.g-goddess.com/developer/swagger-ui/lib/jquery-1.8.0.min.js" type="text/javascript"></script> -->
  <!-- JS Implementing Plugins -->
  <!-- JS Page Level -->
 </body>
</html>