1. 简介
第三方系统将数据传输到企企后,单据生效后,第三方系统需要修改单据,可以使用/v1/update 更新接口对数据进行修改。本教程将介绍如果修改已生效的单据。
1.1. 适用对象及字段
适用对象:销售发票
适用字段:发票号
2. 案例实现
2.1. 销售发票修改发票号
销售发票已生效后。支循序修改销售发票的发票号,数据字典中对应的字段为invoiceTaxies,在企企系统中展示如下:
2.1.1. 新增销售发票
在企企中新增销售发票如下,且单据已生效:
2.1.2. 修改销售发票号
a. 使用接口,POSThttps://api2.77hub.com/v1/update 新增接口。
b. 在请求体(Body)中,以 JSON 格式填写请求参数。
{
"json":"{\"objectType\":\"Invoice\",\"data\":{\"id\":\"N566X462XJ60004\",\"invoiceTaxies\":[{\"invoiceNo\":\"879bkgohh78\",\"amount\":3200,\"amountWithoutTax\":3000,\"taxAmount\":200,\"date\":\"2023-08-14\"}]}}"
}
c. 使用sdk,修改付款单示例如下
public void testUpdate() {
PutUpdateRequest request = new PutUpdateRequest();
ApiParams apiParams = new ApiParams();
apiParams.setJson("{\"objectType\":\"Invoice\",\"data\":{\"id\":\"N566X462XJ60004\",\"invoiceTaxies\":[{\"invoiceNo\":\"879bkgohh78\",\"amount\":3200,\"amountWithoutTax\":3000,\"taxAmount\":200,\"date\":\"2023-08-14\"}]}}");
request.sdkRequestConfig(getSdkRequestConfig(request));
request.setApiParams(apiParams);
PutUpdateResult result = openapi().putUpdate(request);
ApiResponse apiResponse = result.getApiResponse();
System.out.println(apiResponse);
}
d. 返回结果如下:
{"json":"{\"success\":true}"}
e. 如果返回一下报错:
{Error: 已生效的发票只能更新发票号,}
说明在生效态,销售发票只能修改发票号,请修改更新数据。