Chilkat Online Tools

Objective-C / Zoho CRM REST APIs / Purchase Orders

Back to Collection Items

#import <CkoHttp.h>
#import <CkoJsonObject.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.

// {
//   "data": [
//     {
//       "Owner": {
//         "id": "{{user-id}}"
//       },
//       "Vendor_Name": {
//         "id": "{{vendor-id}}"
//       },
//       "Contact_Name": {
//         "id": "{{contact-id}}"
//       },
//       "Discount": 127.67,
//       "Description": "Design your own layouts that align your business processes precisely. Assign them to profiles appropriately.",
//       "Shipping_State": "Shipping_State",
//       "Tax": 127.67,
//       "PO_Date": "2018-01-25",
//       "Billing_Country": "Billing_Country",
//       "Carrier": "USPS",
//       "Status": "Delivered",
//       "Sales_Commission": 127.67,
//       "PO_Number": "PO_Number",
//       "Due_Date": "2018-01-25",
//       "Billing_Street": "Billing_Street",
//       "Adjustment": 127.67,
//       "Terms_and_Conditions": "Design your own layouts that align your business processes precisely. Assign them to profiles appropriately.",
//       "Billing_Code": "Billing_Code",
//       "Product_Details": [
//         {
//           "product": {
//             "id": "1000000071967"
//           },
//           "quantity": 150,
//           "Discount": 20,
//           "product_description": "product_description",
//           "Unit Price": 10,
//           "line_tax": [
//             {
//               "percentage": 10.5,
//               "name": "Sales Tax"
//             },
//             {
//               "percentage": 6.5,
//               "name": "Common Tax"
//             }
//           ]
//         },
//         {
//           "product": {
//             "id": "100000008007"
//           },
//           "quantity": 151,
//           "Discount": 21,
//           "product_description": "product_description",
//           "Unit Price": 11,
//           "line_tax": [
//             {
//               "percentage": 11.5,
//               "name": "Sales Tax"
//             },
//             {
//               "percentage": 7.5,
//               "name": "Common Tax"
//             }
//           ]
//         }
//       ],
//       "Subject": "Subject",
//       "Tracking_Number": "Tracking_Number",
//       "Excise_Duty": 127.67,
//       "Shipping_City": "Shipping_City",
//       "Shipping_Country": "Shipping_Country",
//       "Shipping_Code": "Shipping_Code",
//       "Billing_City": "Billing_City",
//       "Requisition_No": "Requisition_No",
//       "Billing_State": "Billing_State",
//       "$line_tax": [
//         {
//           "percentage": 12.5,
//           "name": "Sales Tax"
//         },
//         {
//           "percentage": 8.5,
//           "name": "Common Tax"
//         }
//       ],
//       "Shipping_Street": "Shipping_Street"
//     }
//   ]
// }

CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"data[0].Owner.id" value: @"{{user-id}}"];
[json UpdateString: @"data[0].Vendor_Name.id" value: @"{{vendor-id}}"];
[json UpdateString: @"data[0].Contact_Name.id" value: @"{{contact-id}}"];
[json UpdateNumber: @"data[0].Discount" numericStr: @"127.67"];
[json UpdateString: @"data[0].Description" value: @"Design your own layouts that align your business processes precisely. Assign them to profiles appropriately."];
[json UpdateString: @"data[0].Shipping_State" value: @"Shipping_State"];
[json UpdateNumber: @"data[0].Tax" numericStr: @"127.67"];
[json UpdateString: @"data[0].PO_Date" value: @"2018-01-25"];
[json UpdateString: @"data[0].Billing_Country" value: @"Billing_Country"];
[json UpdateString: @"data[0].Carrier" value: @"USPS"];
[json UpdateString: @"data[0].Status" value: @"Delivered"];
[json UpdateNumber: @"data[0].Sales_Commission" numericStr: @"127.67"];
[json UpdateString: @"data[0].PO_Number" value: @"PO_Number"];
[json UpdateString: @"data[0].Due_Date" value: @"2018-01-25"];
[json UpdateString: @"data[0].Billing_Street" value: @"Billing_Street"];
[json UpdateNumber: @"data[0].Adjustment" numericStr: @"127.67"];
[json UpdateString: @"data[0].Terms_and_Conditions" value: @"Design your own layouts that align your business processes precisely. Assign them to profiles appropriately."];
[json UpdateString: @"data[0].Billing_Code" value: @"Billing_Code"];
[json UpdateString: @"data[0].Product_Details[0].product.id" value: @"1000000071967"];
[json UpdateInt: @"data[0].Product_Details[0].quantity" value: [NSNumber numberWithInt: 150]];
[json UpdateInt: @"data[0].Product_Details[0].Discount" value: [NSNumber numberWithInt: 20]];
[json UpdateString: @"data[0].Product_Details[0].product_description" value: @"product_description"];
[json UpdateInt: @"data[0].Product_Details[0].\"Unit Price\"" value: [NSNumber numberWithInt: 10]];
[json UpdateNumber: @"data[0].Product_Details[0].line_tax[0].percentage" numericStr: @"10.5"];
[json UpdateString: @"data[0].Product_Details[0].line_tax[0].name" value: @"Sales Tax"];
[json UpdateNumber: @"data[0].Product_Details[0].line_tax[1].percentage" numericStr: @"6.5"];
[json UpdateString: @"data[0].Product_Details[0].line_tax[1].name" value: @"Common Tax"];
[json UpdateString: @"data[0].Product_Details[1].product.id" value: @"100000008007"];
[json UpdateInt: @"data[0].Product_Details[1].quantity" value: [NSNumber numberWithInt: 151]];
[json UpdateInt: @"data[0].Product_Details[1].Discount" value: [NSNumber numberWithInt: 21]];
[json UpdateString: @"data[0].Product_Details[1].product_description" value: @"product_description"];
[json UpdateInt: @"data[0].Product_Details[1].\"Unit Price\"" value: [NSNumber numberWithInt: 11]];
[json UpdateNumber: @"data[0].Product_Details[1].line_tax[0].percentage" numericStr: @"11.5"];
[json UpdateString: @"data[0].Product_Details[1].line_tax[0].name" value: @"Sales Tax"];
[json UpdateNumber: @"data[0].Product_Details[1].line_tax[1].percentage" numericStr: @"7.5"];
[json UpdateString: @"data[0].Product_Details[1].line_tax[1].name" value: @"Common Tax"];
[json UpdateString: @"data[0].Subject" value: @"Subject"];
[json UpdateString: @"data[0].Tracking_Number" value: @"Tracking_Number"];
[json UpdateNumber: @"data[0].Excise_Duty" numericStr: @"127.67"];
[json UpdateString: @"data[0].Shipping_City" value: @"Shipping_City"];
[json UpdateString: @"data[0].Shipping_Country" value: @"Shipping_Country"];
[json UpdateString: @"data[0].Shipping_Code" value: @"Shipping_Code"];
[json UpdateString: @"data[0].Billing_City" value: @"Billing_City"];
[json UpdateString: @"data[0].Requisition_No" value: @"Requisition_No"];
[json UpdateString: @"data[0].Billing_State" value: @"Billing_State"];
[json UpdateNumber: @"data[0].$line_tax[0].percentage" numericStr: @"12.5"];
[json UpdateString: @"data[0].$line_tax[0].name" value: @"Sales Tax"];
[json UpdateNumber: @"data[0].$line_tax[1].percentage" numericStr: @"8.5"];
[json UpdateString: @"data[0].$line_tax[1].name" value: @"Common Tax"];
[json UpdateString: @"data[0].Shipping_Street" value: @"Shipping_Street"];

[http SetRequestHeader: @"Authorization" value: @"{{authorization-token}}"];
[http SetRequestHeader: @"Content-Type" value: @"application/json"];

CkoHttpResponse *resp = [http PostJson3: @"https://domain.com/crm/v2/Purchase_Orders" contentType: @"application/json" json: json];
if (http.LastMethodSuccess == NO) {
    NSLog(@"%@",http.LastErrorText);
    return;
}

NSLog(@"%d",[resp.StatusCode intValue]);
NSLog(@"%@",resp.BodyStr);

Curl Command

curl -X POST
	-H "Authorization: Bearer <access_token>"
	-H "Authorization: {{authorization-token}}"
	-H "Content-Type: application/json"
	-d '{
	"data": [
		{
			"Owner": {
				"id": "{{user-id}}"
			},
			"Vendor_Name": {
				"id": "{{vendor-id}}"
			},
			"Contact_Name": {
				"id": "{{contact-id}}"
			},
			"Discount": 127.67,
			"Description": "Design your own layouts that align your business processes precisely. Assign them to profiles appropriately.",
			"Shipping_State": "Shipping_State",
			"Tax": 127.67,
			"PO_Date": "2018-01-25",
			"Billing_Country": "Billing_Country",
			"Carrier": "USPS",
			"Status": "Delivered",
			"Sales_Commission": 127.67,
			"PO_Number": "PO_Number",
			"Due_Date": "2018-01-25",
			"Billing_Street": "Billing_Street",
			"Adjustment": 127.67,
			"Terms_and_Conditions": "Design your own layouts that align your business processes precisely. Assign them to profiles appropriately.",
			"Billing_Code": "Billing_Code",
			"Product_Details": [
				{
					"product": {
						"id": "1000000071967"
					},
					"quantity": 150,
					"Discount": 20,
					"product_description": "product_description",
					"Unit Price": 10,
					"line_tax": [
						{
							"percentage": 10.5,
							"name": "Sales Tax"
						},
						{
							"percentage": 6.5,
							"name": "Common Tax"
						}
					]
				},
				{
					"product": {
						"id": "100000008007"
					},
					"quantity": 151,
					"Discount": 21,
					"product_description": "product_description",
					"Unit Price": 11,
					"line_tax": [
						{
							"percentage": 11.5,
							"name": "Sales Tax"
						},
						{
							"percentage": 7.5,
							"name": "Common Tax"
						}
					]
				}
			],
			"Subject": "Subject",
			"Tracking_Number": "Tracking_Number",
			"Excise_Duty": 127.67,
			"Shipping_City": "Shipping_City",
			"Shipping_Country": "Shipping_Country",
			"Shipping_Code": "Shipping_Code",
			"Billing_City": "Billing_City",
			"Requisition_No": "Requisition_No",
			"Billing_State": "Billing_State",
			"$line_tax": [
				{
					"percentage": 12.5,
					"name": "Sales Tax"
				},
				{
					"percentage": 8.5,
					"name": "Common Tax"
				}
			],
			"Shipping_Street": "Shipping_Street"
		}
	]
}'
https://domain.com/crm/v2/Purchase_Orders

Postman Collection Item JSON

{
  "name": "Purchase Orders",
  "request": {
    "method": "POST",
    "header": [
      {
        "key": "Authorization",
        "value": "{{authorization-token}}"
      },
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ],
    "body": {
      "mode": "raw",
      "raw": "{\n\t\"data\": [\n\t\t{\n\t\t\t\"Owner\": {\n\t\t\t\t\"id\": \"{{user-id}}\"\n\t\t\t},\n\t\t\t\"Vendor_Name\": {\n\t\t\t\t\"id\": \"{{vendor-id}}\"\n\t\t\t},\n\t\t\t\"Contact_Name\": {\n\t\t\t\t\"id\": \"{{contact-id}}\"\n\t\t\t},\n\t\t\t\"Discount\": 127.67,\n\t\t\t\"Description\": \"Design your own layouts that align your business processes precisely. Assign them to profiles appropriately.\",\n\t\t\t\"Shipping_State\": \"Shipping_State\",\n\t\t\t\"Tax\": 127.67,\n\t\t\t\"PO_Date\": \"2018-01-25\",\n\t\t\t\"Billing_Country\": \"Billing_Country\",\n\t\t\t\"Carrier\": \"USPS\",\n\t\t\t\"Status\": \"Delivered\",\n\t\t\t\"Sales_Commission\": 127.67,\n\t\t\t\"PO_Number\": \"PO_Number\",\n\t\t\t\"Due_Date\": \"2018-01-25\",\n\t\t\t\"Billing_Street\": \"Billing_Street\",\n\t\t\t\"Adjustment\": 127.67,\n\t\t\t\"Terms_and_Conditions\": \"Design your own layouts that align your business processes precisely. Assign them to profiles appropriately.\",\n\t\t\t\"Billing_Code\": \"Billing_Code\",\n\t\t\t\"Product_Details\": [\n\t\t\t\t{\n\t\t\t\t\t\"product\": {\n\t\t\t\t\t\t\"id\": \"1000000071967\"\n\t\t\t\t\t},\n\t\t\t\t\t\"quantity\": 150,\n\t\t\t\t\t\"Discount\": 20,\n\t\t\t\t\t\"product_description\": \"product_description\",\n\t\t\t\t\t\"Unit Price\": 10,\n\t\t\t\t\t\"line_tax\": [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"percentage\": 10.5,\n\t\t\t\t\t\t\t\"name\": \"Sales Tax\"\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"percentage\": 6.5,\n\t\t\t\t\t\t\t\"name\": \"Common Tax\"\n\t\t\t\t\t\t}\n\t\t\t\t\t]\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"product\": {\n\t\t\t\t\t\t\"id\": \"100000008007\"\n\t\t\t\t\t},\n\t\t\t\t\t\"quantity\": 151,\n\t\t\t\t\t\"Discount\": 21,\n\t\t\t\t\t\"product_description\": \"product_description\",\n\t\t\t\t\t\"Unit Price\": 11,\n\t\t\t\t\t\"line_tax\": [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"percentage\": 11.5,\n\t\t\t\t\t\t\t\"name\": \"Sales Tax\"\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"percentage\": 7.5,\n\t\t\t\t\t\t\t\"name\": \"Common Tax\"\n\t\t\t\t\t\t}\n\t\t\t\t\t]\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"Subject\": \"Subject\",\n\t\t\t\"Tracking_Number\": \"Tracking_Number\",\n\t\t\t\"Excise_Duty\": 127.67,\n\t\t\t\"Shipping_City\": \"Shipping_City\",\n\t\t\t\"Shipping_Country\": \"Shipping_Country\",\n\t\t\t\"Shipping_Code\": \"Shipping_Code\",\n\t\t\t\"Billing_City\": \"Billing_City\",\n\t\t\t\"Requisition_No\": \"Requisition_No\",\n\t\t\t\"Billing_State\": \"Billing_State\",\n\t\t\t\"$line_tax\": [\n\t\t\t\t{\n\t\t\t\t\t\"percentage\": 12.5,\n\t\t\t\t\t\"name\": \"Sales Tax\"\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"percentage\": 8.5,\n\t\t\t\t\t\"name\": \"Common Tax\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"Shipping_Street\": \"Shipping_Street\"\n\t\t}\n\t]\n}"
    },
    "url": {
      "raw": "{{api-domain}}/crm/v2/Purchase_Orders",
      "host": [
        "{{api-domain}}"
      ],
      "path": [
        "crm",
        "v2",
        "Purchase_Orders"
      ]
    },
    "description": "To add new entities to a module."
  },
  "response": [
  ]
}