Objective-C / New FreshBooks / Update Prepayment Credit
Back to Collection Items
#import <CkoHttp.h>
#import <CkoJsonObject.h>
#import <CkoStringBuilder.h>
#import <CkoHttpResponse.h>
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
CkoHttp *http = [[CkoHttp alloc] init];
BOOL success;
// Use this online tool to generate code from sample JSON: Generate Code to Create JSON
// The following JSON is sent in the request body.
// {
// "credit_note": {
// "credit_number": "0000070",
// "currency_code": "CAD",
// "create_date": "2020-07-31",
// "notes": "PrePayment for work",
// "credit_type": "prepayment",
// "terms": "Will be applied to future invoice",
// "language": "en",
// "lines": [
// {
// "id": "20375-1",
// "name": "Credit",
// "description": "Current Credit Balance",
// "taxName1": null,
// "taxAmount1": 0,
// "taxName2": null,
// "taxAmount2": 0,
// "compounded_tax": false,
// "qty": 1,
// "unit_cost": {
// "amount": "150",
// "code": "CAD"
// }
// },
// {
// "name": "Credit",
// "description": "Current Credit Balance",
// "taxName1": null,
// "taxAmount1": 0,
// "taxName2": null,
// "taxAmount2": 0,
// "compounded_tax": false,
// "qty": 1,
// "unit_cost": {
// "amount": "100",
// "code": "CAD"
// }
// }
// ],
// "clientid": 123
// }
// }
CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"credit_note.credit_number" value: @"0000070"];
[json UpdateString: @"credit_note.currency_code" value: @"CAD"];
[json UpdateString: @"credit_note.create_date" value: @"2020-07-31"];
[json UpdateString: @"credit_note.notes" value: @"PrePayment for work"];
[json UpdateString: @"credit_note.credit_type" value: @"prepayment"];
[json UpdateString: @"credit_note.terms" value: @"Will be applied to future invoice"];
[json UpdateString: @"credit_note.language" value: @"en"];
[json UpdateString: @"credit_note.lines[0].id" value: @"20375-1"];
[json UpdateString: @"credit_note.lines[0].name" value: @"Credit"];
[json UpdateString: @"credit_note.lines[0].description" value: @"Current Credit Balance"];
[json UpdateNull: @"credit_note.lines[0].taxName1"];
[json UpdateInt: @"credit_note.lines[0].taxAmount1" value: [NSNumber numberWithInt: 0]];
[json UpdateNull: @"credit_note.lines[0].taxName2"];
[json UpdateInt: @"credit_note.lines[0].taxAmount2" value: [NSNumber numberWithInt: 0]];
[json UpdateBool: @"credit_note.lines[0].compounded_tax" value: NO];
[json UpdateInt: @"credit_note.lines[0].qty" value: [NSNumber numberWithInt: 1]];
[json UpdateString: @"credit_note.lines[0].unit_cost.amount" value: @"150"];
[json UpdateString: @"credit_note.lines[0].unit_cost.code" value: @"CAD"];
[json UpdateString: @"credit_note.lines[1].name" value: @"Credit"];
[json UpdateString: @"credit_note.lines[1].description" value: @"Current Credit Balance"];
[json UpdateNull: @"credit_note.lines[1].taxName1"];
[json UpdateInt: @"credit_note.lines[1].taxAmount1" value: [NSNumber numberWithInt: 0]];
[json UpdateNull: @"credit_note.lines[1].taxName2"];
[json UpdateInt: @"credit_note.lines[1].taxAmount2" value: [NSNumber numberWithInt: 0]];
[json UpdateBool: @"credit_note.lines[1].compounded_tax" value: NO];
[json UpdateInt: @"credit_note.lines[1].qty" value: [NSNumber numberWithInt: 1]];
[json UpdateString: @"credit_note.lines[1].unit_cost.amount" value: @"100"];
[json UpdateString: @"credit_note.lines[1].unit_cost.code" value: @"CAD"];
[json UpdateInt: @"credit_note.clientid" value: [NSNumber numberWithInt: 123]];
CkoStringBuilder *sbRequestBody = [[CkoStringBuilder alloc] init];
[json EmitSb: sbRequestBody];
CkoHttpResponse *resp = [http PTextSb: @"PUT" url: @"https://api.freshbooks.com/accounting/account/{{accountid}}/credit_notes/credit_notes/{{creditnote}}" textData: sbRequestBody charset: @"utf-8" contentType: @"application/json" md5: NO gzip: NO];
if (http.LastMethodSuccess == NO) {
NSLog(@"%@",http.LastErrorText);
return;
}
NSLog(@"%d",[resp.StatusCode intValue]);
NSLog(@"%@",resp.BodyStr);
Curl Command
curl -X PUT
-d '{
"credit_note": {
"credit_number": "0000070",
"currency_code": "CAD",
"create_date": "2020-07-31",
"notes": "PrePayment for work",
"credit_type": "prepayment",
"terms": "Will be applied to future invoice",
"language": "en",
"lines": [
{
"id": "20375-1",
"name": "Credit",
"description": "Current Credit Balance",
"taxName1": null,
"taxAmount1": 0,
"taxName2": null,
"taxAmount2": 0,
"compounded_tax": false,
"qty": 1,
"unit_cost": {
"amount": "150",
"code": "CAD"
}
},
{
"name": "Credit",
"description": "Current Credit Balance",
"taxName1": null,
"taxAmount1": 0,
"taxName2": null,
"taxAmount2": 0,
"compounded_tax": false,
"qty": 1,
"unit_cost": {
"amount": "100",
"code": "CAD"
}
}
],
"clientid": {{clientId}}
}
}'
https://api.freshbooks.com/accounting/account/{{accountid}}/credit_notes/credit_notes/{{creditnote}}
Postman Collection Item JSON
{
"name": "Update Prepayment Credit",
"request": {
"auth": {
"type": "noauth"
},
"method": "PUT",
"header": [
{
"key": "",
"value": "",
"type": "text",
"disabled": true
}
],
"body": {
"mode": "raw",
"raw": "{\n \"credit_note\": {\n \"credit_number\": \"0000070\",\n \"currency_code\": \"CAD\",\n \"create_date\": \"2020-07-31\",\n \"notes\": \"PrePayment for work\",\n \"credit_type\": \"prepayment\",\n \"terms\": \"Will be applied to future invoice\",\n \"language\": \"en\",\n \"lines\": [\n {\n \"id\": \"20375-1\",\n \"name\": \"Credit\",\n \"description\": \"Current Credit Balance\",\n \"taxName1\": null,\n \"taxAmount1\": 0,\n \"taxName2\": null,\n \"taxAmount2\": 0,\n \"compounded_tax\": false,\n \"qty\": 1,\n \"unit_cost\": {\n \"amount\": \"150\",\n \"code\": \"CAD\"\n }\n },\n {\n \"name\": \"Credit\",\n \"description\": \"Current Credit Balance\",\n \"taxName1\": null,\n \"taxAmount1\": 0,\n \"taxName2\": null,\n \"taxAmount2\": 0,\n \"compounded_tax\": false,\n \"qty\": 1,\n \"unit_cost\": {\n \"amount\": \"100\",\n \"code\": \"CAD\"\n }\n }\n ],\n \"clientid\": {{clientId}}\n }\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.freshbooks.com/accounting/account/{{accountid}}/credit_notes/credit_notes/{{creditnote}}",
"protocol": "https",
"host": [
"api",
"freshbooks",
"com"
],
"path": [
"accounting",
"account",
"{{accountid}}",
"credit_notes",
"credit_notes",
"{{creditnote}}"
]
}
},
"response": [
]
}
