Objective-C / Egyptian eInvoicing SDK R1.5 / 2.3.2. Submit Return - Coffee and Restaurant
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.
// {
// "receipts": [
// {
// "header": {
// "dateTimeIssued": "2022-06-13T00:34:00Z",
// "receiptNumber": "{{receiptNumber1}}",
// "uuid": "{{returnreceiptUuid1}}",
// "previousUUID": "",
// "referenceUUID": "{{receiptUuid1}}",
// "referenceOldUUID": "",
// "currency": "EGP",
// "exchangeRate": 0,
// "sOrderNameCode": "sOrderNameCode",
// "orderdeliveryMode": "FC"
// },
// "documentType": {
// "receiptType": "RC",
// "typeVersion": "1.0"
// },
// "seller": {
// "rin": "674859545",
// "companyTradeName": "شركة الصوفى",
// "branchCode": "0",
// "branchAddress": {
// "country": "EG",
// "governate": "cairo",
// "regionCity": "city center",
// "street": "16 street",
// "buildingNumber": "14BN",
// "postalCode": "74235",
// "floor": "1F",
// "room": "3R",
// "landmark": "tahrir square",
// "additionalInformation": "talaat harb street"
// },
// "deviceSerialNumber": "Sofy123",
// "activityCode": "4620"
// },
// "buyer": {
// "type": "F",
// "id": "313717919",
// "name": "taxpayer 1",
// "mobileNumber": "+201020567462",
// "paymentNumber": "987654"
// },
// "itemData": [
// {
// "internalCode": "880609",
// "description": "Samsung A02 32GB_LTE_BLACK_DS_SM-A022FZKDMEB_A022 _ A022_SM-A022FZKDMEB",
// "itemType": "GS1",
// "itemCode": "037000401629",
// "unitType": "EA",
// "quantity": 35,
// "unitPrice": 247.96000,
// "netSale": 7810.74000,
// "totalSale": 8678.60000,
// "total": 8887.04360,
// "commercialDiscountData": [
// {
// "amount": 867.86000,
// "description": "XYZ"
// }
// ],
// "itemDiscountData": [
// {
// "amount": 10,
// "description": "ABC"
// },
// {
// "amount": 10,
// "description": "XYZ"
// }
// ],
// "valueDifference": 20,
// "taxableItems": [
// {
// "taxType": "T1",
// "amount": 1096.30360,
// "subType": "V009",
// "rate": 14
// }
// ]
// }
// ],
// "totalSales": 8678.60000,
// "totalCommercialDiscount": 867.86000,
// "totalItemsDiscount": 20,
// "extraReceiptDiscountData": [
// {
// "amount": 0,
// "description": "ABC"
// }
// ],
// "netAmount": 7810.74000,
// "feesAmount": 0,
// "totalAmount": 8887.04360,
// "taxTotals": [
// {
// "taxType": "T1",
// "amount": 1096.30360
// }
// ],
// "paymentMethod": "C",
// "adjustment": 0
// }
// ]
// }
CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"receipts[0].header.dateTimeIssued" value: @"2022-06-13T00:34:00Z"];
[json UpdateString: @"receipts[0].header.receiptNumber" value: @"{{receiptNumber1}}"];
[json UpdateString: @"receipts[0].header.uuid" value: @"{{returnreceiptUuid1}}"];
[json UpdateString: @"receipts[0].header.previousUUID" value: @""];
[json UpdateString: @"receipts[0].header.referenceUUID" value: @"{{receiptUuid1}}"];
[json UpdateString: @"receipts[0].header.referenceOldUUID" value: @""];
[json UpdateString: @"receipts[0].header.currency" value: @"EGP"];
[json UpdateInt: @"receipts[0].header.exchangeRate" value: [NSNumber numberWithInt: 0]];
[json UpdateString: @"receipts[0].header.sOrderNameCode" value: @"sOrderNameCode"];
[json UpdateString: @"receipts[0].header.orderdeliveryMode" value: @"FC"];
[json UpdateString: @"receipts[0].documentType.receiptType" value: @"RC"];
[json UpdateString: @"receipts[0].documentType.typeVersion" value: @"1.0"];
[json UpdateString: @"receipts[0].seller.rin" value: @"674859545"];
[json UpdateString: @"receipts[0].seller.companyTradeName" value: @"شركة الصوفى"];
[json UpdateString: @"receipts[0].seller.branchCode" value: @"0"];
[json UpdateString: @"receipts[0].seller.branchAddress.country" value: @"EG"];
[json UpdateString: @"receipts[0].seller.branchAddress.governate" value: @"cairo"];
[json UpdateString: @"receipts[0].seller.branchAddress.regionCity" value: @"city center"];
[json UpdateString: @"receipts[0].seller.branchAddress.street" value: @"16 street"];
[json UpdateString: @"receipts[0].seller.branchAddress.buildingNumber" value: @"14BN"];
[json UpdateString: @"receipts[0].seller.branchAddress.postalCode" value: @"74235"];
[json UpdateString: @"receipts[0].seller.branchAddress.floor" value: @"1F"];
[json UpdateString: @"receipts[0].seller.branchAddress.room" value: @"3R"];
[json UpdateString: @"receipts[0].seller.branchAddress.landmark" value: @"tahrir square"];
[json UpdateString: @"receipts[0].seller.branchAddress.additionalInformation" value: @"talaat harb street"];
[json UpdateString: @"receipts[0].seller.deviceSerialNumber" value: @"Sofy123"];
[json UpdateString: @"receipts[0].seller.activityCode" value: @"4620"];
[json UpdateString: @"receipts[0].buyer.type" value: @"F"];
[json UpdateString: @"receipts[0].buyer.id" value: @"313717919"];
[json UpdateString: @"receipts[0].buyer.name" value: @"taxpayer 1"];
[json UpdateString: @"receipts[0].buyer.mobileNumber" value: @"+201020567462"];
[json UpdateString: @"receipts[0].buyer.paymentNumber" value: @"987654"];
[json UpdateString: @"receipts[0].itemData[0].internalCode" value: @"880609"];
[json UpdateString: @"receipts[0].itemData[0].description" value: @"Samsung A02 32GB_LTE_BLACK_DS_SM-A022FZKDMEB_A022 _ A022_SM-A022FZKDMEB"];
[json UpdateString: @"receipts[0].itemData[0].itemType" value: @"GS1"];
[json UpdateString: @"receipts[0].itemData[0].itemCode" value: @"037000401629"];
[json UpdateString: @"receipts[0].itemData[0].unitType" value: @"EA"];
[json UpdateInt: @"receipts[0].itemData[0].quantity" value: [NSNumber numberWithInt: 35]];
[json UpdateNumber: @"receipts[0].itemData[0].unitPrice" numericStr: @"247.96000"];
[json UpdateNumber: @"receipts[0].itemData[0].netSale" numericStr: @"7810.74000"];
[json UpdateNumber: @"receipts[0].itemData[0].totalSale" numericStr: @"8678.60000"];
[json UpdateNumber: @"receipts[0].itemData[0].total" numericStr: @"8887.04360"];
[json UpdateNumber: @"receipts[0].itemData[0].commercialDiscountData[0].amount" numericStr: @"867.86000"];
[json UpdateString: @"receipts[0].itemData[0].commercialDiscountData[0].description" value: @"XYZ"];
[json UpdateInt: @"receipts[0].itemData[0].itemDiscountData[0].amount" value: [NSNumber numberWithInt: 10]];
[json UpdateString: @"receipts[0].itemData[0].itemDiscountData[0].description" value: @"ABC"];
[json UpdateInt: @"receipts[0].itemData[0].itemDiscountData[1].amount" value: [NSNumber numberWithInt: 10]];
[json UpdateString: @"receipts[0].itemData[0].itemDiscountData[1].description" value: @"XYZ"];
[json UpdateInt: @"receipts[0].itemData[0].valueDifference" value: [NSNumber numberWithInt: 20]];
[json UpdateString: @"receipts[0].itemData[0].taxableItems[0].taxType" value: @"T1"];
[json UpdateNumber: @"receipts[0].itemData[0].taxableItems[0].amount" numericStr: @"1096.30360"];
[json UpdateString: @"receipts[0].itemData[0].taxableItems[0].subType" value: @"V009"];
[json UpdateInt: @"receipts[0].itemData[0].taxableItems[0].rate" value: [NSNumber numberWithInt: 14]];
[json UpdateNumber: @"receipts[0].totalSales" numericStr: @"8678.60000"];
[json UpdateNumber: @"receipts[0].totalCommercialDiscount" numericStr: @"867.86000"];
[json UpdateInt: @"receipts[0].totalItemsDiscount" value: [NSNumber numberWithInt: 20]];
[json UpdateInt: @"receipts[0].extraReceiptDiscountData[0].amount" value: [NSNumber numberWithInt: 0]];
[json UpdateString: @"receipts[0].extraReceiptDiscountData[0].description" value: @"ABC"];
[json UpdateNumber: @"receipts[0].netAmount" numericStr: @"7810.74000"];
[json UpdateInt: @"receipts[0].feesAmount" value: [NSNumber numberWithInt: 0]];
[json UpdateNumber: @"receipts[0].totalAmount" numericStr: @"8887.04360"];
[json UpdateString: @"receipts[0].taxTotals[0].taxType" value: @"T1"];
[json UpdateNumber: @"receipts[0].taxTotals[0].amount" numericStr: @"1096.30360"];
[json UpdateString: @"receipts[0].paymentMethod" value: @"C"];
[json UpdateInt: @"receipts[0].adjustment" value: [NSNumber numberWithInt: 0]];
// Adds the "Authorization: Bearer <access_token>" header.
http.AuthToken = @"<access_token>";
CkoHttpResponse *resp = [http PostJson3: @"https://domain.com/api/v1/receiptsubmissions" 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>"
-d '{
"receipts": [
{
"header": {
"dateTimeIssued": "2022-06-13T00:34:00Z",
"receiptNumber": "{{receiptNumber1}}",
"uuid": "{{returnreceiptUuid1}}",
"previousUUID": "",
"referenceUUID":"{{receiptUuid1}}",
"referenceOldUUID": "",
"currency": "EGP",
"exchangeRate": 0,
"sOrderNameCode": "sOrderNameCode",
"orderdeliveryMode": "FC"
},
"documentType": {
"receiptType": "RC",
"typeVersion": "1.0"
},
"seller": {
"rin": "674859545",
"companyTradeName": "شركة الصوفى",
"branchCode": "0",
"branchAddress": {
"country": "EG",
"governate": "cairo",
"regionCity": "city center",
"street": "16 street",
"buildingNumber": "14BN",
"postalCode": "74235",
"floor": "1F",
"room": "3R",
"landmark": "tahrir square",
"additionalInformation": "talaat harb street"
},
"deviceSerialNumber": "Sofy123",
"activityCode": "4620"
},
"buyer": {
"type": "F",
"id": "313717919",
"name": "taxpayer 1",
"mobileNumber": "+201020567462",
"paymentNumber": "987654"
},
"itemData": [
{
"internalCode": "880609",
"description": "Samsung A02 32GB_LTE_BLACK_DS_SM-A022FZKDMEB_A022 _ A022_SM-A022FZKDMEB",
"itemType": "GS1",
"itemCode": "037000401629",
"unitType": "EA",
"quantity": 35,
"unitPrice": 247.96000 ,
"netSale": 7810.74000 ,
"totalSale": 8678.60000 ,
"total": 8887.04360 ,
"commercialDiscountData": [
{
"amount": 867.86000,
"description": "XYZ"
}
],
"itemDiscountData": [
{
"amount": 10,
"description":"ABC"
},
{
"amount": 10,
"description": "XYZ"
}
],
"valueDifference": 20,
"taxableItems": [
{
"taxType": "T1",
"amount": 1096.30360 ,
"subType": "V009",
"rate": 14
}
]
}
],
"totalSales": 8678.60000,
"totalCommercialDiscount": 867.86000,
"totalItemsDiscount": 20,
"extraReceiptDiscountData": [
{
"amount": 0,
"description": "ABC"
}
],
"netAmount": 7810.74000,
"feesAmount": 0,
"totalAmount": 8887.04360,
"taxTotals": [
{
"taxType": "T1",
"amount": 1096.30360
}
],
"paymentMethod": "C",
"adjustment": 0
}
]
}'
https://domain.com/api/v1/receiptsubmissions
Postman Collection Item JSON
{
"name": "2.3.2. Submit Return - Coffee and Restaurant",
"request": {
"auth": {
"type": "bearer",
"bearer": [
{
"key": "token",
"value": "{{generatedAccessToken}}",
"type": "string"
}
]
},
"method": "POST",
"header": [
],
"body": {
"mode": "raw",
"raw": "{\r\n \"receipts\": [\r\n {\r\n \"header\": {\r\n \"dateTimeIssued\": \"2022-06-13T00:34:00Z\",\r\n \"receiptNumber\": \"{{receiptNumber1}}\",\r\n \"uuid\": \"{{returnreceiptUuid1}}\",\r\n \"previousUUID\": \"\",\r\n\t\t\t\t\"referenceUUID\":\"{{receiptUuid1}}\",\r\n \"referenceOldUUID\": \"\",\r\n \"currency\": \"EGP\",\r\n \"exchangeRate\": 0,\r\n \"sOrderNameCode\": \"sOrderNameCode\",\r\n \"orderdeliveryMode\": \"FC\"\r\n },\r\n \"documentType\": {\r\n \"receiptType\": \"RC\",\r\n \"typeVersion\": \"1.0\"\r\n },\r\n \"seller\": {\r\n \"rin\": \"674859545\",\r\n \"companyTradeName\": \"شركة الصوفى\",\r\n \"branchCode\": \"0\",\r\n \"branchAddress\": {\r\n \"country\": \"EG\",\r\n \"governate\": \"cairo\",\r\n \"regionCity\": \"city center\",\r\n \"street\": \"16 street\",\r\n \"buildingNumber\": \"14BN\",\r\n \"postalCode\": \"74235\",\r\n \"floor\": \"1F\",\r\n \"room\": \"3R\",\r\n \"landmark\": \"tahrir square\",\r\n \"additionalInformation\": \"talaat harb street\"\r\n },\r\n \"deviceSerialNumber\": \"Sofy123\",\r\n \"activityCode\": \"4620\"\r\n },\r\n \"buyer\": {\r\n \"type\": \"F\",\r\n \"id\": \"313717919\",\r\n \"name\": \"taxpayer 1\",\r\n \"mobileNumber\": \"+201020567462\",\r\n \"paymentNumber\": \"987654\"\r\n },\r\n \"itemData\": [\r\n {\r\n \"internalCode\": \"880609\",\r\n \"description\": \"Samsung A02 32GB_LTE_BLACK_DS_SM-A022FZKDMEB_A022 _ A022_SM-A022FZKDMEB\",\r\n \"itemType\": \"GS1\",\r\n \"itemCode\": \"037000401629\",\r\n \"unitType\": \"EA\",\r\n \"quantity\": 35,\r\n \"unitPrice\": 247.96000 ,\r\n \"netSale\": 7810.74000 ,\r\n \"totalSale\": 8678.60000 ,\r\n \"total\": 8887.04360 ,\r\n \"commercialDiscountData\": [\r\n {\r\n \"amount\": 867.86000, \r\n \"description\": \"XYZ\"\r\n }\r\n ],\r\n \"itemDiscountData\": [\r\n {\r\n \"amount\": 10,\r\n \"description\":\"ABC\"\r\n },\r\n {\r\n \"amount\": 10,\r\n \"description\": \"XYZ\"\r\n }\r\n ],\r\n \"valueDifference\": 20,\r\n \"taxableItems\": [\r\n {\r\n \"taxType\": \"T1\",\r\n \"amount\": 1096.30360 ,\r\n \"subType\": \"V009\",\r\n \"rate\": 14\r\n }\r\n ]\r\n }\r\n ],\r\n \"totalSales\": 8678.60000,\r\n \"totalCommercialDiscount\": 867.86000,\r\n \"totalItemsDiscount\": 20,\r\n \"extraReceiptDiscountData\": [\r\n {\r\n \"amount\": 0,\r\n \"description\": \"ABC\"\r\n }\r\n ],\r\n \"netAmount\": 7810.74000,\r\n \"feesAmount\": 0,\r\n \"totalAmount\": 8887.04360,\r\n \"taxTotals\": [\r\n {\r\n \"taxType\": \"T1\",\r\n \"amount\": 1096.30360\r\n }\r\n ],\r\n \"paymentMethod\": \"C\",\r\n \"adjustment\": 0\r\n }\r\n ]\r\n \r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "{{apiBaseUrl}}/api/v1/receiptsubmissions",
"host": [
"{{apiBaseUrl}}"
],
"path": [
"api",
"v1",
"receiptsubmissions"
]
}
},
"response": [
]
}
