增值税回收集成

增值税回收应用类别简化了SAP Concur客户的增值税回收流程。增值税回收合作伙伴的认证应用程序将使用“快速连接”流程从我们客户的SAP Concur网站获取费用报告和发票数据,并使用SAP Concur费用和发票api执行他们的应用程序。要获得认证,合作伙伴必须支持两个产品:使用SAP Concur标准版和专业版的费用与发票。

合作伙伴的应用程序应该使用API​​的搜索参数,因此响应仅包括在客户SAP Confor系统内达到批准工作流结束的费用报告或发票。达到批准过程结束的那些费用报告和发票(“提取”或“付款确认”)无法再在SAP Confor系统中进行编辑。因此,仅通过获取最终确定的数据来简化合作伙伴的应用程序。

学习

使用以下资源熟悉SAP Confur产品,然后在您自己的沙箱中提交费用报告或发票。这将更好地定位您进行端到端的测试,并能够将用户的体验与您通过API获取的内容相关联。

  • 培训工具包-这些资源可以帮助您学习SAP Concur产品基础知识、管理和报告。
  • 技术服务分享短片-这里找到的视频将帮助您了解独特的交易类型,可能发生在费用产品和它们对提取文件中的财务状况的影响。

一体化

快速连接

快速连接企业应用程序的范围

快速连接描述客户用于将其SAP Concur站点与应用程序中心合作伙伴的企业应用程序连接的流程。有关详细信息,请参阅Quick Connect范围文档,以指导您完成将此必需部件开发到认证应用程序的过程。

公司简介

公司简介API v1

获取增值税恢复的费用报告数据

SAP Concur客户的费用和发票网站通常计划每晚才能享受批准工作流程(每周几次关闭或其他间隔以及按需间隔关闭一些接近)。在SAP Concur系统内关闭费用或发票期间,此过程会导致自上次关闭以来一直批准的费用报告或发票的编译列表。此过程将状态更改为“提取”。此时,用户,审批人或管理员不再编辑这些费用报告或发票。

客户可以使用SAP Concur“费用支付”(ACH电子报销服务)和/或付款确认导入文件流程。后者用于更新不经过费用支付流程的报告。一旦成功完成这些选项中的任何一个,报表的付款状态将从P_PAID更新为P_PAYC(付款确认的缩写)。

注意:使用费用支付的客户可能不会使用此选项偿还100%的员工。可以使用其他报销选项,例如A / P检查或工资单。如果客户不使用付款确认导入文件将这些报告更新为确认,则使用后一种方法报销的报告将留在付款状态= P_PAID。(大多数客户不使用此文件将报告更新为“已确认”。)通过费用支付支付的报告总是更新到P_Payc一旦SAP Concur收到付款已定居的银行通知。此客户方案将包括跨越费用报告范围(P_PAID和P_PAYC)的2个不同状态。因此,合作伙伴应在客户的提取运行之后不久即将获得P_PAID结果,这通常是每晚,并且将在费用薪酬状态更新之前。当合作伙伴无法在提取过程之后立即获得报告时,出现了挑战。如果时间持续时间足够长,则费用薪酬或付款确认文件进程可能已将某些报告的状态更改为P_Payc。

合作伙伴的行动:

请注意,如果客户使用上面的任何一个选项。如果您在呼叫到V3 Get Reports API期间遇到任何中断,则上述进程中的一个或两个可能会在中断时将报告更新为P_Payc。这意味着您可能必须运行Get Reports请求2个不同的时间,以便获取所需时间范围的完整报告列表:

  • 支付状态= P_PAID
  • 支付状态= P_PAYC

合作伙伴的应用程序有3个步骤获取费用报告数据:

第一步:获取费用报告清单。

费用报告v3

搜索参数应该集中在不能在SAP Concur User界面中编辑的报告上。使用下面的搜索参数。API请求应该一次只执行一天。这个API请求将产生匹配这些搜索参数的报告列表。

注意:结果中可能会返回多个页面。确保您知道如何成功地为每个后续页面发出请求,直到到达最后一个页面。

范围 样本值
paymentStatusCode P_PAID
paidDateBefore 2018-01-27
paidDateAfter 2018-01-25

注:审核以上费用支付及付款确认摘录相关内容。您可能必须使用2个不同的支付状态参数运行您的Report v3 API查询。

步骤2:获取报告细节

对于第一步API请求中返回的每个惟一的Report ID,将重复此步骤。

获取费用报告详细信息V2 API

每个API请求插入一个报告ID。制作所有请求,直到获取在搜索结果中返回的每份报告的详细信息之前。

第三步:获取图片

图像v1 API

GET Report Details API请求将生成一个Entry ID,该ID将在此API请求中使用。结果将生成一个URL,合作伙伴可以在单独的浏览器会话中使用该URL来呈现图像。此URL是短暂的(15分钟)。如果URL过期,那么合作伙伴可以重试相同的调用,以获得另一个URI来呈现图像。

对于这个API,参数变量{id}是从v2 GET Report Details API获得的:EntryID

获取增值税退税发票数据

合作伙伴的应用程序将采取3个步骤来获取发票数据(与费用的步骤略有不同):

步骤1:获取付款请求摘要列表

支付请求摘要v3 API

搜索参数应专注于无法再在SAP Confur用户界面中编辑的发票。使用以下搜索参数:

范围 样本值
extractedDateBefore 2018-01-27
提取addateafter. 2018-01-25

API请求应该一次只执行一天。这个API请求将导致匹配这些搜索参数的发票列表。

注意:结果中可能会返回多个页面。

第2步:获取发票(付款请求)详细信息

对于第一步API请求中返回的每个惟一的Payment Request ID,将重复此步骤。

GET Payment Request {id} v3 API

在每个API请求中插入一个付款请求ID,直到您获取搜索结果中返回的每张发票的详细信息。

第三步:获取图像

与上面一样。使用从响应中获得的ReceiptImage ID,该响应提供支付请求(发票)的详细信息。