#SAMPLE INVOICE WITH BUYER DETAILS
{
"ReceiptType": "FiscalInvoice",
"ReceiptCurrency": "USD",
"InvoiceNo": "TEST-INV-A001",
"ReferenceNumber": "AXIS",
"InvoiceAmount": 1200,
"InvoiceTaxAmount": 156.52,
"ReceiptNotes": "This is a Test receipt",
"ReceiptLinesTaxInclusive": true,
"MoneyTypeCode": "Cash",
"ReceiptPrintForm": "InvoiceA4",
"BuyerRegisterName": "Axis Solutions Africa",
"BuyerTradeName": "Axis Solutions",
"VatNumber": 220192567,
"BuyerTIN": 2000152399,
"BuyerPhoneNo": "08677004041",
"BuyerEmail": "developers@axissol.com",
"BuyerProvince": "Harare",
"BuyerStreet": "Arundel Road, Alexandra Park",
"BuyerHouseNo": "14",
"BuyerCity": "Harare",
"ReceiptLines": [
{
"ReceiptLineType": "Sale",
"ReceiptLineNo": 1,
"ReceiptLineHSCode": "99001000",
"ReceiptLineName": "Test Item",
"ReceiptLinePrice": 0.2,
"ReceiptLineQuantity": 6000,
"ReceiptLineTotal": 1200,
"TaxCode": "A",
"TaxPercent": 15
}
]
}
#SAMPLE INVOICE WITH BUYER DETAILS AND DISCOUNTS
{
"receiptType": "FiscalInvoice",
"receiptCurrency": "USD",
"invoiceNo": "INVNUMBER3",
"referenceNumber": "",
"invoiceAmount": 2.00,
"invoiceTaxAmount": 0.13,
"receiptNotes": "Normal Invoice tendered",
"receiptLinesTaxInclusive": true,
"moneyTypeCode": "Cash",
"receiptPrintForm": "Receipt48",
"buyerRegisterName": "Tesla Motor Spares",
"buyerTradeName": "Tesla Motors",
"vatNumber": "220000009",
"buyerTIN": "2000000009",
"buyerPhoneNo": "0714707876",
"buyerEmail": "email@customer.com",
"buyerProvince": "Midlands",
"buyerStreet": "Corner street",
"buyerHouseNo": "11",
"buyerCity": "Gweru",
"receiptLines": [
{
"receiptLineType": "Sale",
"receiptLineNo": 1,
"receiptLineHSCode": "17019100",
"receiptLineName": "Hullets Brown Sugar",
"receiptLinePrice": 2.00,
"receiptLineQuantity": 1.00,
"receiptLineTotal": 2.00,
"taxCode": "B",
"taxPercent": 0.00
},
{
"receiptLineType": "Sale",
"receiptLineNo": 1,
"receiptLineHSCode": "17019100",
"receiptLineName": "Hullets Salt",
"receiptLinePrice": 1.00,
"receiptLineQuantity": 1.00,
"receiptLineTotal": 1.00,
"taxCode": "A",
"taxPercent": 0.15
},
{
"receiptLineType": "Discount",
"receiptLineNo": 1,
"receiptLineHSCode": "17019100",
"receiptLineName": "Discount for Hullets Brown Sugar",
"receiptLinePrice": -1.00,
"receiptLineQuantity": 1.00,
"receiptLineTotal": -1.00,
"taxCode": "B",
"taxPercent": 0.00
}
]
}
#SAMPLE INVOICE CASH SALE
{
"ReceiptType": "FiscalInvoice",
"ReceiptCurrency": "USD",
"InvoiceNo": "TEST-INV-A001",
"ReferenceNumber": "AXIS",
"InvoiceAmount": 1200,
"InvoiceTaxAmount": 156.52,
"ReceiptNotes": "This is a Test receipt",
"ReceiptLinesTaxInclusive": true,
"MoneyTypeCode": "Cash",
"ReceiptPrintForm": "InvoiceA4",
"BuyerRegisterName": "",
"BuyerTradeName": "",
"VatNumber": ,
"BuyerTIN": ,
"BuyerPhoneNo": "",
"BuyerEmail": "",
"BuyerProvince": "",
"BuyerStreet": "",
"BuyerHouseNo": "",
"BuyerCity": "",
"ReceiptLines": [
{
"ReceiptLineType": "Sale",
"ReceiptLineNo": 1,
"ReceiptLineHSCode": "99001000",
"ReceiptLineName": "Test Item",
"ReceiptLinePrice": 0.2,
"ReceiptLineQuantity": 6000,
"ReceiptLineTotal": 1200,
"TaxCode": "A",
"TaxPercent": 15
}
]
}
#CREDIT NOTE
{
"ReceiptType": "CreditNote",
"ReceiptCurrency": "USD",
"InvoiceNo": "TEST-CRN-A001",
"ReferenceNumber": "TEST-INV-A001",
"InvoiceAmount": -1200,
"InvoiceTaxAmount": -156.52,
"ReceiptNotes": "Wrong Goods Sold",
"ReceiptLinesTaxInclusive": true,
"MoneyTypeCode": "Cash",
"ReceiptPrintForm": "InvoiceA4",
"BuyerRegisterName": "Axis Solutions Africa",
"BuyerTradeName": "Axis Solutions",
"VatNumber": 220192567,
"BuyerTIN": 2000152399,
"BuyerPhoneNo": "08677004041",
"BuyerEmail": "developers@axissol.com",
"BuyerProvince": "Harare",
"BuyerStreet": "Arundel Road, Alexandra Park",
"BuyerHouseNo": "14",
"BuyerCity": "Harare",
"ReceiptLines": [
{
"ReceiptLineType": "Sale",
"ReceiptLineNo": 1,
"ReceiptLineHSCode": "99001000",
"ReceiptLineName": "Test Item",
"ReceiptLinePrice": -0.2,
"ReceiptLineQuantity": 6000,
"ReceiptLineTotal": 1200,
"TaxCode": "A",
"TaxPercent": 15
}
]
}
#SAMPLE RESPONSES
## GET STATUS
{
"Code": "1",
"Message": "GetStatus",
"QRCode": "",
"FDMSInvoiceNo": "",
"FiscalDayNo": "",
"VerificationCode": "",
"VerificationLink": "https://fdmstest.zimra.co.zw",
"DeviceID": "18489",
"Data": {
"fiscalDayStatus": "FiscalDayClosed",
"fiscalDayReconciliationMode": "Auto",
"fiscalDayServerSignature": {
"certificateThumbprint": "F9B28",
"hash": "DmQbYlC0V",
"signature": "I4="
},
"fiscalDayClosed": "2024-10-04T16:23:19",
"lastReceiptGlobalNo": 3,
"lastFiscalDayNo": 2,
"operationID": "0HN713L9NBGKM:00000001"
}
}
##GETCONFIG
{
"Code": "1",
"Message": "GetConfig",
"QRCode": "",
"FDMSInvoiceNo": "",
"FiscalDayNo": "",
"VerificationCode": "",
"VerificationLink": "https://fdmstest.zimra.co.zw",
"DeviceID": "18489",
"Data": {
"taxPayerName": "Axis Solutions Pvt Ltd",
"taxPayerTIN": "2000152399",
"vatNumber": "220192567",
"deviceSerialNo": "C6BCACD98A5B7890",
"deviceBranchName": "Axis Solutions",
"deviceBranchAddress": {
"province": "Harare",
"city": "Harare",
"street": "Bargate Road, Vainona",
"houseNo": "60"
},
"deviceBranchContacts": {
"phoneNo": "0778612578",
"email": "developers@axissol.com"
},
"deviceOperatingMode": "Online",
"taxPayerDayMaxHrs": 24,
"applicableTaxes": [
{
"taxName": "Exempt",
"validFrom": "2023-01-01T00:00:00",
"taxID": 1
},
{
"taxPercent": 0.0,
"taxName": "Zero rate 0%",
"validFrom": "2023-01-01T00:00:00",
"taxID": 2
},
{
"taxPercent": 15.0,
"taxName": "Standard rated 15%",
"validFrom": "2023-01-01T00:00:00",
"taxID": 3
},
{
"taxPercent": 5.0,
"taxName": "Non-VAT Withholding Tax",
"validFrom": "2024-01-01T00:00:00",
"taxID": 514
}
],
"certificateValidTill": "2027-10-04T09:42:17",
"qrUrl": "https://fdmstest.zimra.co.zw",
"taxpayerDayEndNotificationHrs": 2,
"operationID": "0HN713L9NBKM0:00000001"
}
}
##OPEN FISCAL DAY
{
"Code": "1",
"Message": "Fiscal Day Opened: FiscalDayOpened ",
"QRCode": "",
"FDMSInvoiceNo": "",
"FiscalDayNo": "",
"VerificationCode": "",
"VerificationLink": "https://fdmstest.zimra.co.zw",
"DeviceID": "18489",
"Data": {
"fiscalDayNo": 3,
"operationID": "0HN713L9NBKUQ:00000001",
"LastFiscalDayReport": {
"FiscalDayOpened": "2024-10-07T10:26:41",
"FiscalDayClosed": "2024-10-07T10:26:41",
"DeviceSerialNumber": "C6BCACD98A5B7890",
"FiscalDayNumber": "2",
"DailyTotals": {}
}
}
}
##SUBMIT RECEIPT
{
"Code": "1",
"Message": "Fiscal Invoice Queued",
"QRCode": "https://fdmstest.zimra.co.zw/000001848907102024000000000450BB025DA548377B",
"FDMSInvoiceNo": "4",
"FiscalDayNo": "3",
"VerificationCode": "50BB-025D-A548-377B",
"VerificationLink": "https://fdmstest.zimra.co.zw",
"DeviceID": "18489",
"Data": {
"receipt": {
"receiptType": "FiscalInvoice",
"receiptCurrency": "USD",
"receiptCounter": 1,
"receiptGlobalNo": 4,
"invoiceNo": "AXIMOS-1234567890",
"buyerData": {
"buyerRegisterName": "Test Company",
"buyerTradeName": "Test Company",
"buyerTIN": "1234567890",
"VATNumber": "123456789",
"buyerContacts": {
"phoneNo": "0770000000",
"email": "test@test.com"
},
"buyerAddress": {
"province": "Harare",
"street": "Test Street",
"houseNo": "01",
"city": "Harare"
}
},
"receiptNotes": "Test Invoice",
"receiptDate": "2024-10-07T10:27:57",
"creditDebitNote": null,
"receiptLinesTaxInclusive": true,
"receiptLines": [
{
"receiptLineName": "Test Item - Vatable Item",
"receiptLineNo": 1,
"receiptLineQuantity": 1.00,
"receiptLineType": "Sale",
"receiptLineTotal": 100.00,
"taxID": 3,
"receiptLineHSCode": "",
"receiptLinePrice": 100.00,
"taxCode": "A",
"taxPercent": 15.00
},
{
"receiptLineName": "Test - No Vat Item",
"receiptLineNo": 2,
"receiptLineQuantity": 1.00,
"receiptLineType": "Sale",
"receiptLineTotal": 100.00,
"taxID": 2,
"receiptLineHSCode": "",
"receiptLinePrice": 100.00,
"taxCode": "B",
"taxPercent": 0.0
}
],
"receiptTaxes": [
{
"salesAmountWithTax": 100.00,
"taxAmount": 0.00,
"taxID": 2,
"taxCode": "B",
"taxPercent": 0.0
},
{
"salesAmountWithTax": 100.00,
"taxAmount": 13.04,
"taxID": 3,
"taxCode": "A",
"taxPercent": 15.00
}
],
"receiptPayments": [
{
"moneyTypeCode": "CASH",
"paymentAmount": 200.00
}
],
"receiptTotal": 200.00,
"receiptPrintForm": "InvoiceA4",
"receiptDeviceSignature": {
"hash": "hbH5YKsQWn4xeCvPuAfTEqUKJ252S9IJmKFJyFm1aJg=",
"signature": "YBdilBDZqtgCM/EDmwl8SwfTuAxrwsrEyYgJjNJ3uxk282BgUn9E9QeKH9S7MzpxQtHKxyAEsbBjUrK9VgdsrTji9r20EQKMDEZByLM4EXOP2shC9HtQ713+FF7W2pObvrYtkzd6DBph6wficL6/ry0A0vTxGFPnYABe9i44YVXLonxv7FeCq739XxR1ffE2J0ewGjT3A3aToeUnTRbSp2wr95aJczT5Xu1HgOCyZvzEpMUhkyno8a1FKcFX1LOTsP1dLi3QbDGnu9GvdtpikgEYU4/tbbBpcblCMWqLCd5zH0HrL1Mn1+KyH9+HtHs2BzHf60mP0pWjwvub66jQhA=="
}
}
}
}