How to use external API in erpnext

In our country have e-invoicing and we need to use erpnext to send a data in json to their server through erp

and this a body of the request that must be excatly like that
so how can I do that ?

{

    "documents": [

        {

            "issuer": {

                "address": {

                    "branchID": "0",

                    "country": "EG",

                    "governate": "Cairo",

                    "regionCity": "Nasr City",

                    "street": "580 Clementina Key",

                    "buildingNumber": "Bldg. 0",

                    "postalCode": "68030",

                    "floor": "1",

                    "room": "123",

                    "landmark": "7660 Melody Trail",

                    "additionalInformation": "beside Townhall"

                },

                "type": "B",

                "id": "559831234",

                "name": "Issuer Company"

            },

            "receiver": {

                "address": {

                    "country": "EG",

                    "governate": "Egypt",

                    "regionCity": "Mufazat al Ismlyah",

                    "street": "580 Clementina Key",

                    "buildingNumber": "Bldg. 0",

                    "postalCode": "68030",

                    "floor": "1",

                    "room": "123",

                    "landmark": "7660 Melody Trail",

                    "additionalInformation": "beside Townhall"

                },

                "type": "B",

                "id": "313717919",

                "name": "Receiver"

            },

            "documentType": "I",

            "documentTypeVersion": "0.9",

            "dateTimeIssued": "2020-12-16T02:04:45Z",

            "taxpayerActivityCode": "4620",

            "internalID": "IID2",

            "purchaseOrderReference": "P-233-A6375",

            "purchaseOrderDescription": "purchase Order description",

            "salesOrderReference": "1231",

            "salesOrderDescription": "Sales Order description",

            "proformaInvoiceNumber": "SomeValue",

            "payment": {

                "bankName": "SomeValue",

                "bankAddress": "SomeValue",

                "bankAccountNo": "SomeValue",

                "bankAccountIBAN": "",

                "swiftCode": "",

                "terms": "SomeValue"

            },

            "delivery": {

                "approach": "SomeValue",

                "packaging": "SomeValue",

                "dateValidity": "2020-09-28T09:30:10Z",

                "exportPort": "SomeValue",

                "countryOfOrigin": "LS",

                "grossWeight": 10.59100,

                "netWeight": 20.58700,

                "terms": "SomeValue"

            },

            "invoiceLines": [

                {

                    "description": "Computer1",

                    "itemType": "GPC",

                    "itemCode": "10003752",

                    "unitType": "EA",

                    "quantity": 7.00000,

                    "internalCode": "IC0",

                    "salesTotal": 662.90000,

                    "total": 2220.08914,

                    "valueDifference": 7.00000,

                    "totalTaxableFees": 618.69212,

                    "netTotal": 649.64200,

                    "itemsDiscount": 5.00000,

                    "unitValue": {

                        "currencySold": "USD",

                        "amountEGP": 94.70000,

                        "amountSold": 4.73500,

                        "currencyExchangeRate": 20.00000

                    },

                    "discount": {

                        "rate": 2,

                        "amount": 13.25800

                    },

                    "taxableItems": [

                        {

                            "taxType": "T1",

                            "amount": 204.67639,

                            "subType": "T1",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T2",

                            "amount": 156.64009,

                            "subType": "T2",

                            "rate": 12

                        },

                        {

                            "taxType": "T3",

                            "amount": 30.00000,

                            "subType": "T3",

                            "rate": 0.00

                        },

                        {

                            "taxType": "T4",

                            "amount": 32.23210,

                            "subType": "T4",

                            "rate": 5.00

                        },

                        {

                            "taxType": "T5",

                            "amount": 90.94988,

                            "subType": "T5",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T6",

                            "amount": 60.00000,

                            "subType": "T6",

                            "rate": 0.00

                        },

                        {

                            "taxType": "T7",

                            "amount": 64.96420,

                            "subType": "T7",

                            "rate": 10.00

                        },

                        {

                            "taxType": "T8",

                            "amount": 90.94988,

                            "subType": "T8",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T9",

                            "amount": 77.95704,

                            "subType": "T9",

                            "rate": 12.00

                        },

                        {

                            "taxType": "T10",

                            "amount": 64.96420,

                            "subType": "T10",

                            "rate": 10.00

                        },

                        {

                            "taxType": "T11",

                            "amount": 90.94988,

                            "subType": "T11",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T12",

                            "amount": 77.95704,

                            "subType": "T12",

                            "rate": 12.00

                        },

                        {

                            "taxType": "T13",

                            "amount": 64.96420,

                            "subType": "T13",

                            "rate": 10.00

                        },

                        {

                            "taxType": "T14",

                            "amount": 90.94988,

                            "subType": "T14",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T15",

                            "amount": 77.95704,

                            "subType": "T15",

                            "rate": 12.00

                        },

                        {

                            "taxType": "T16",

                            "amount": 64.96420,

                            "subType": "T16",

                            "rate": 10.00

                        },

                        {

                            "taxType": "T17",

                            "amount": 64.96420,

                            "subType": "T17",

                            "rate": 10.00

                        },

                        {

                            "taxType": "T18",

                            "amount": 90.94988,

                            "subType": "T18",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T19",

                            "amount": 77.95704,

                            "subType": "T19",

                            "rate": 12.00

                        },

                        {

                            "taxType": "T20",

                            "amount": 64.96420,

                            "subType": "T20",

                            "rate": 10.00

                        }

                    ]

                },

                {

                    "description": "Computer2",

                    "itemType": "GPC",

                    "itemCode": "10001827",

                    "unitType": "EA",

                    "quantity": 5.00000,

                    "internalCode": "IC0",

                    "salesTotal": 947.00000,

                    "total": 3123.51323,

                    "valueDifference": 7.00000,

                    "totalTaxableFees": 858.13160,

                    "netTotal": 928.06000,

                    "itemsDiscount": 5.00000,

                    "unitValue": {

                        "currencySold": "EUR",

                        "amountEGP": 189.40000,

                        "amountSold": 10.00000,

                        "currencyExchangeRate": 18.94000

                    },

                    "discount": {

                        "rate": 2,

                        "amount": 18.94000

                    },

                    "taxableItems": [

                        {

                            "taxType": "T1",

                            "amount": 285.87644,

                            "subType": "T1",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T2",

                            "amount": 218.78299,

                            "subType": "T2",

                            "rate": 12

                        },

                        {

                            "taxType": "T3",

                            "amount": 30.00000,

                            "subType": "T3",

                            "rate": 0.00

                        },

                        {

                            "taxType": "T4",

                            "amount": 46.15300,

                            "subType": "T4",

                            "rate": 5.00

                        },

                        {

                            "taxType": "T5",

                            "amount": 129.92840,

                            "subType": "T5",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T6",

                            "amount": 60.00000,

                            "subType": "T6",

                            "rate": 0.00

                        },

                        {

                            "taxType": "T7",

                            "amount": 92.80600,

                            "subType": "T7",

                            "rate": 10.00

                        },

                        {

                            "taxType": "T8",

                            "amount": 129.92840,

                            "subType": "T8",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T9",

                            "amount": 111.36720,

                            "subType": "T9",

                            "rate": 12.00

                        },

                        {

                            "taxType": "T10",

                            "amount": 92.80600,

                            "subType": "T10",

                            "rate": 10.00

                        },

                        {

                            "taxType": "T11",

                            "amount": 129.92840,

                            "subType": "T11",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T12",

                            "amount": 111.36720,

                            "subType": "T12",

                            "rate": 12.00

                        },

                        {

                            "taxType": "T13",

                            "amount": 92.80600,

                            "subType": "T13",

                            "rate": 10.00

                        },

                        {

                            "taxType": "T14",

                            "amount": 129.92840,

                            "subType": "T14",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T15",

                            "amount": 111.36720,

                            "subType": "T15",

                            "rate": 12.00

                        },

                        {

                            "taxType": "T16",

                            "amount": 92.80600,

                            "subType": "T16",

                            "rate": 10.00

                        },

                        {

                            "taxType": "T17",

                            "amount": 92.80600,

                            "subType": "T17",

                            "rate": 10.00

                        },

                        {

                            "taxType": "T18",

                            "amount": 129.92840,

                            "subType": "T18",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T19",

                            "amount": 111.36720,

                            "subType": "T19",

                            "rate": 12.00

                        },

                        {

                            "taxType": "T20",

                            "amount": 92.80600,

                            "subType": "T20",

                            "rate": 10.00

                        }

                    ]

                },

                {

                    "description": "Computer3",

                    "itemType": "GPC",

                    "itemCode": "10001516",

                    "unitType": "EA",

                    "quantity": 6.57265,

                    "internalCode": "IC0",

                    "salesTotal": 1445.98300,

                    "total": 4522.41770,

                    "valueDifference": 3.00000,

                    "totalTaxableFees": 1228.93264,

                    "netTotal": 1359.22402,

                    "itemsDiscount": 4.00000,

                    "unitValue": {

                        "currencySold": "USD",

                        "amountEGP": 220.00000,

                        "amountSold": 11.00000,

                        "currencyExchangeRate": 20.00000

                    },

                    "discount": {

                        "rate": 6,

                        "amount": 86.75898

                    },

                    "taxableItems": [

                        {

                            "taxType": "T1",

                            "amount": 410.99736,

                            "subType": "T1",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T2",

                            "amount": 314.53880,

                            "subType": "T2",

                            "rate": 12

                        },

                        {

                            "taxType": "T3",

                            "amount": 30.00000,

                            "subType": "T3",

                            "rate": 0.00

                        },

                        {

                            "taxType": "T4",

                            "amount": 67.76120,

                            "subType": "T4",

                            "rate": 5.00

                        },

                        {

                            "taxType": "T5",

                            "amount": 190.29136,

                            "subType": "T5",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T6",

                            "amount": 60.00000,

                            "subType": "T6",

                            "rate": 0.00

                        },

                        {

                            "taxType": "T7",

                            "amount": 135.92240,

                            "subType": "T7",

                            "rate": 10.00

                        },

                        {

                            "taxType": "T8",

                            "amount": 190.29136,

                            "subType": "T8",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T9",

                            "amount": 163.10688,

                            "subType": "T9",

                            "rate": 12.00

                        },

                        {

                            "taxType": "T10",

                            "amount": 135.92240,

                            "subType": "T10",

                            "rate": 10.00

                        },

                        {

                            "taxType": "T11",

                            "amount": 190.29136,

                            "subType": "T11",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T12",

                            "amount": 163.10688,

                            "subType": "T12",

                            "rate": 12.00

                        },

                        {

                            "taxType": "T13",

                            "amount": 135.92240,

                            "subType": "T13",

                            "rate": 10.00

                        },

                        {

                            "taxType": "T14",

                            "amount": 190.29136,

                            "subType": "T14",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T15",

                            "amount": 163.10688,

                            "subType": "T15",

                            "rate": 12.00

                        },

                        {

                            "taxType": "T16",

                            "amount": 135.92240,

                            "subType": "T16",

                            "rate": 10.00

                        },

                        {

                            "taxType": "T17",

                            "amount": 135.92240,

                            "subType": "T17",

                            "rate": 10.00

                        },

                        {

                            "taxType": "T18",

                            "amount": 190.29136,

                            "subType": "T18",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T19",

                            "amount": 163.10688,

                            "subType": "T19",

                            "rate": 12.00

                        },

                        {

                            "taxType": "T20",

                            "amount": 135.92240,

                            "subType": "T20",

                            "rate": 10.00

                        }

                    ]

                },

                {

                    "description": "Computer4",

                    "itemType": "GPC",

                    "itemCode": "10007938",

                    "unitType": "EA",

                    "quantity": 9.00000,

                    "internalCode": "IC0",

                    "salesTotal": 1363.68000,

                    "total": 4221.86535,

                    "valueDifference": 8.00000,

                    "totalTaxableFees": 1150.67128,

                    "netTotal": 1268.22240,

                    "itemsDiscount": 11.00000,

                    "unitValue": {

                        "currencySold": "EUR",

                        "amountEGP": 151.52000,

                        "amountSold": 8.00000,

                        "currencyExchangeRate": 18.94000

                    },

                    "discount": {

                        "rate": 7,

                        "amount": 95.45760

                    },

                    "taxableItems": [

                        {

                            "taxType": "T1",

                            "amount": 385.24093,

                            "subType": "T1",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T2",

                            "amount": 294.82724,

                            "subType": "T2",

                            "rate": 12

                        },

                        {

                            "taxType": "T3",

                            "amount": 30.00000,

                            "subType": "T3",

                            "rate": 0.00

                        },

                        {

                            "taxType": "T4",

                            "amount": 62.86112,

                            "subType": "T4",

                            "rate": 5.00

                        },

                        {

                            "taxType": "T5",

                            "amount": 177.55114,

                            "subType": "T5",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T6",

                            "amount": 60.00000,

                            "subType": "T6",

                            "rate": 0.00

                        },

                        {

                            "taxType": "T7",

                            "amount": 126.82224,

                            "subType": "T7",

                            "rate": 10.00

                        },

                        {

                            "taxType": "T8",

                            "amount": 177.55114,

                            "subType": "T8",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T9",

                            "amount": 152.18669,

                            "subType": "T9",

                            "rate": 12.00

                        },

                        {

                            "taxType": "T10",

                            "amount": 126.82224,

                            "subType": "T10",

                            "rate": 10.00

                        },

                        {

                            "taxType": "T11",

                            "amount": 177.55114,

                            "subType": "T11",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T12",

                            "amount": 152.18669,

                            "subType": "T12",

                            "rate": 12.00

                        },

                        {

                            "taxType": "T13",

                            "amount": 126.82224,

                            "subType": "T13",

                            "rate": 10.00

                        },

                        {

                            "taxType": "T14",

                            "amount": 177.55114,

                            "subType": "T14",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T15",

                            "amount": 152.18669,

                            "subType": "T15",

                            "rate": 12.00

                        },

                        {

                            "taxType": "T16",

                            "amount": 126.82224,

                            "subType": "T16",

                            "rate": 10.00

                        },

                        {

                            "taxType": "T17",

                            "amount": 126.82224,

                            "subType": "T17",

                            "rate": 10.00

                        },

                        {

                            "taxType": "T18",

                            "amount": 177.55114,

                            "subType": "T18",

                            "rate": 14.00

                        },

                        {

                            "taxType": "T19",

                            "amount": 152.18669,

                            "subType": "T19",

                            "rate": 12.00

                        },

                        {

                            "taxType": "T20",

                            "amount": 126.82224,

                            "subType": "T20",

                            "rate": 10.00

                        }

                    ]

                }

            ],

            "totalDiscountAmount": 214.41458,

            "totalSalesAmount": 4419.56300,

            "netAmount": 4205.14842,

            "taxTotals": [

                {

                    "taxType": "T1",

                    "amount": 1286.79112

                },

                {

                    "taxType": "T2",

                    "amount": 984.78912

                },

                {

                    "taxType": "T3",

                    "amount": 120.00000

                },

                {

                    "taxType": "T4",

                    "amount": 209.00742

                },

                {

                    "taxType": "T5",

                    "amount": 588.72078

                },

                {

                    "taxType": "T6",

                    "amount": 240.00000

                },

                {

                    "taxType": "T7",

                    "amount": 420.51484

                },

                {

                    "taxType": "T8",

                    "amount": 588.72078

                },

                {

                    "taxType": "T9",

                    "amount": 504.61781

                },

                {

                    "taxType": "T10",

                    "amount": 420.51484

                },

                {

                    "taxType": "T11",

                    "amount": 588.72078

                },

                {

                    "taxType": "T12",

                    "amount": 504.61781

                },

                {

                    "taxType": "T13",

                    "amount": 420.51484

                },

                {

                    "taxType": "T14",

                    "amount": 588.72078

                },

                {

                    "taxType": "T15",

                    "amount": 504.61781

                },

                {

                    "taxType": "T16",

                    "amount": 420.51484

                },

                {

                    "taxType": "T17",

                    "amount": 420.51484

                },

                {

                    "taxType": "T18",

                    "amount": 588.72078

                },

                {

                    "taxType": "T19",

                    "amount": 504.61781

                },

                {

                    "taxType": "T20",

                    "amount": 420.51484

                }

            ],

            "totalAmount": 14082.88542,

            "extraDiscountAmount": 5.00000,

            "totalItemsDiscountAmount": 25.00000,

        }

    ]

}
1 Like