定期购买

这是我们崭新的REST API的文档页面-并不是要找到它。此API尚未准备好供公众使用。随着我们的成长,我们正在砍伐和改变很多。因此,如果您构建使用它的东西,那么很可能在以后的更新中中断。 不要说您没有被警告!

网址:

//api.meituohu.com/v2/recurringpurchases

方法):

获取,删除,放置,发布

回应格式:

JSON,XML

描述:

使用此方法,您可以检索用户的重复购买设置列表,创建新的重复购买,更新现有重复购买并删除重复购买。

参量

名称类型描述
数字重复购买的唯一编号
描述定期购买的说明
购买细节目的与购买有关的信息将在计划的时间间隔内创建
付款详情目的与重复购买的付款细节有关的信息。该对象的字段与购买付款行项目相同。有关其他付款字段,请参阅 采购文件
频率目的有关重复购买频率的信息
持续时间目的有关定期购买时间的信息
购买细节字段
供应商代码周期性采购的供应商代码
供应商参考定期购买的参考文字
供应商名称重复购买的供应商名称
总金额数字重复购买的总金额(包括增值税)(如果有)
净额数字重复购买的金额(不包括增值税)(如果有)
增值税金额数字重复购买的增值税金额(如果有)
LineItems对象清单与重复购买的订单项相关的信息。该对象的字段与购买订单项相同。有关这些字段的更多信息,请参阅 采购文件
频率场
类型The frequency at which the purchase is being created. Possible values are 每月一次, 每年, 每周, 多月 and 定期地 (repeated after X number of days)
DayOfMonth数字需要在哪个月的一天创建重复购买。频率类型的值应介于1到28之间‘Monthly’ or ‘MultiMonth’. For an ‘Annually’重复购买,此字段的值应为指定月份的有效日期。
平日创建每周定期购买的星期几。需要完整指定工作日名称,例如,星期三。
月数字符串清单创建多个月定期购买的月份列表。如果需要指定一个月的姓名,例如‘Annually’频率,此数组应仅包含1个月的名称。月份名称应为字符串(月份的全名,例如,一月)
开始日期日期日期 on which creation of periodically recurring purchases is to be started。例如JSON格式:[JSONDATE],XML格式:[XMLDATE]
间隔数字天数间隔,在此间隔之后创建定期重复购买
持续时间字段
类型系统需要继续为用户创建重复购买的持续时间。可能的值是RecurIndefinitely,RecurForFixedNumberOfTimes,RecurTillSpecificDate和NA(已禁用)
递归计数数字如果是持续时间类型,则需要创建重复购买的次数‘RecurForFixedNumberOfTimes’
直到指定日期日期持续时间类型的特定日期,直到需要创建重复购买为止‘RecurTillSpecificDate’。例如JSON格式:[JSONDATE],XML格式:[XMLDATE]

订单项排序

1。‘Number’ field of a recurring purchase line item also represents the 分类 订购.
2.要重新排列订单项,需要更改它们在LineItems列表中的位置。

GET操作

GET(重复购买)返回用户的重复购买设置列表。

网址: / recurringpurchases?page = {page}&perpage={perpage}&sortby={sortby}&order={order}&filterby={filterby}

GET的示例响应,重复购买清单

 
{
    "Data": [
        {
            "描述": "每月一次 Repeated Purchase",
            "持续时间": {
                "类型": "RecurTillSpecificDate"
            },
             "频率": {
                "DayOfMonth": 8,
                "月数": [
                    "August"
                ],
                "类型": "多月"
            },
            "购买细节": {
                "供应商代码": "YAHO01",
                "供应商名称": "Yahoo",
                "供应商参考": "",
                "总金额": 172.8,
                "LineItems": null,
                "净额": 0,
                "付款详情": null,
                "VATAmount": 0
            },
            "数": 1
        },
        {
            "描述": "",
            "持续时间": {
                "类型": "RecurIndefinitely"
            },
             "频率": {
                "DayOfMonth": 4,
                "月数": [
                    "March",
                    "May"
                ],
                "类型": "多月"
            },
            "购买细节": {
                "供应商代码": "QUCI01",
                "供应商名称": "QucikEC test 2",
                "供应商参考": "",
                "总金额": 0,
                "LineItems": null,
                "净额": 0,
                "付款详情": null,
                "VATAmount": 0
            },
            "数": 15
        }
    ],
    "MetaData": {
        "FirstPageUrl": "/v2/recurringpurchases?page=1&perpage=2&sortby=SupplierName&order=Desc",
        "LastPageUrl": "/v2/recurringpurchases?page=9&perpage=2&sortby=SupplierName&order=Desc",
        "NextPageUrl": "/v2/recurringpurchases?page=2&perpage=2&sortby=SupplierName&order=Desc",
        "PreviousPageUrl": null,
        "TotalRecords": 17
    }
}

请求参数

名称描述
页码
每页数 of records to be fetched
分类by名称 of the column on which 分类ing needs to be applied. The acceptable values for this parameter are:
1.
2. 日期
3. 供应商名称
4. 供应商参考
5. 评论
6.
订购排序方向可以是 升序 上升或 描述 下降。
过滤可以按重复购买频率类型过滤列表。将此参数设置为“All”或为空或从URL中排除(如果要检索所有重复购买的商品)。此参数的可接受值为:
1. 所有
2. 每月一次
3. 每年
4. 每周
5. 多月
6. 定期地

要获取具有所有详细信息的特定重复购买的详细信息,请使用以下URL。的‘Number’每个订单项的字段不仅可以唯一标识一个订单项,还可以代表其‘sort’ 订购. The ‘sort’订单决定了某个项目在用户界面上的订单项列表中的位置。

网址 :/ recurringpurchase / {number}

GET的示例响应,重复购买


{
	"描述": "每月一次Interest",
	"持续时间": {
		"类型": "NA"
	},
	"频率": {
		"DayOfMonth": 12,
		"月数": ["May"],
		"类型": "每年"
	},
	"数": 1,
	"购买细节": {
		"总金额": 0.0000,
		"LineItems": [{
			"描述": "每月一次Interest",
			"首页CurrencyRate": 0,
			"首页CurrencyVATAmount": 0,
			"NominalCode": 7502,
			"数": 1,
			"ProductCode": "",
			"ProductName": "",
			"Quantity": 1000.0000,
			"Rate": 0.00,
			"TaxCode": "",
			"VATAmount": 0.00,
			"VATExempt": false,
			"VATLevel": 17.5000,
			"ProjectNumber": 0
		}],
		"净额": 0.000000,
		"付款详情": null,
		"供应商代码": "08C",
		"供应商名称": "Honda 供应商",
		"供应商参考": "",
		"VATAmount": 0.00
	}
}

开机自检操作

重复购买的POST为用户创建重复购买。

网址: /重复购买

可以创建包含或不包含订单项的购买。可以使用多个采购订单项创建重复购买,但是重复购买只能伴随一个支付行。如果指定了订单项,则必须确保‘Number’其中每个字段的字段均为0。订单项在LineItems列表中的放置顺序决定了其排序顺序。

注意:经常性购买始终以本币创建。

周期性采购的POST请求示例


{
   "描述":"描述",
   "持续时间":{
      "递归计数":12,
      "类型":"RecurForFixedNumberOfTimes"
   },
   "频率":{
      "DayOfMonth":10,
      "月数":[
         "February",
         "January",
         "March"
      ],
      "类型":"多月"
   },
   "数":9,
   "购买细节":{
      "总金额":1650.0000,
      "LineItems":[
         {
            "描述":"",
            "首页CurrencyRate":0,
            "首页CurrencyVATAmount":0,
            "NominalCode":10,
            "数":0,
            "ProductCode":"",
            "ProductName":"",
            "Quantity":2.0000,
            "Rate":550.00,
            "TaxCode":"",
            "VATAmount":0.00,
            "VATExempt":false,
            "VATLevel":0.0000,
            "ProjectNumber":0
         },
         {
            "描述":"",
            "首页CurrencyRate":0,
            "首页CurrencyVATAmount":0,
            "NominalCode":10,
            "数":0,
            "ProductCode":"",
            "ProductName":"",
            "Quantity":1.0000,
            "Rate":550.00,
            "TaxCode":"",
            "VATAmount":0.00,
            "VATExempt":false,
            "VATLevel":0.0000,
            "ProjectNumber":0
         }
      ],
      "净额":1650.000000,
      "付款详情":{
         "AccountId":248307,
         "量":50.0000,
         "Method":727693,
         "Note":""
      },
      "供应商代码":"01",
      "供应商名称":"01",
      "供应商参考":"",
      "VATAmount":0.00
   }
}

PUT操作

重复购买的PUT为用户更新了重复购买。

网址: / recurringpurchases / {number}
其中{number}是指重复购买的唯一编号

要更新重复购买,您需要提供完整的重复购买数据,与该重复购买的GET响应相同。并更新必填数据字段,或者如果您要将订单项或付款数据添加到现有的定期购买中,请更新。

要创建新的订单项,请添加带有‘Number’应该指定0。
更新定期购买的商品(如果旧的‘Number’在请求正文中找不到与之关联的订单项‘Number’ is deleted.

如果新的购买编号对于用户而言是唯一的,则可以更新定期购买的编号,方法是在‘Number’PUT请求主体的字段。

定期购买的PUT请求示例


{
   "描述":"描述",
   "持续时间":{
      "递归计数":12,
      "类型":"RecurForFixedNumberOfTimes"
   },
   "频率":{
      "DayOfMonth":10,
      "月数":[
         "February",
         "January",
         "March"
      ],
      "类型":"多月"
   },
   "数":9,
   "购买细节":{
      "总金额":1100.0000,
      "LineItems":[
         {
            "描述":"",
            "首页CurrencyRate":0,
            "首页CurrencyVATAmount":0,
            "NominalCode":10,
            "数":2,
            "ProductCode":"",
            "ProductName":"",
            "Quantity":2.0000,
            "Rate":550.00,
            "TaxCode":"",
            "VATAmount":0.00,
            "VATExempt":false,
            "VATLevel":0.0000,
            "ProjectNumber":0
         }, {
            "描述":"",
            "首页CurrencyRate":0,
            "首页CurrencyVATAmount":0,
            "NominalCode":10,
            "数":1,
            "ProductCode":"",
            "ProductName":"",
            "Quantity":1.0000,
            "Rate":550.00,
            "TaxCode":"",
            "VATAmount":0.00,
            "VATExempt":false,
            "VATLevel":0.0000,
            "ProjectNumber":0
         }
      ],
      "净额":1100.000000,
      "付款详情":{
         "AccountId":248307,
         "量":50.0000,
         "BulkId":0,
         "BulkPaymentNumber":0,
         "Id":0,
         "Method":727693
      },
      "供应商代码":"01",
      "供应商名称":"01",
      "供应商参考":"",
      "VATAmount":0.00
   }
}

删除操作

删除具有URL中提供的编号的重复购买。

网址: / recurringpurchases / {number}

{number}将被有效的重复购买编号代替。

了解KashFlow如何与您的业务和书籍一起使用