This document (GRA E-VAT API Documentation or E-VAT API Documentation or VCIS/VSDC API Documentation) describes the API specification for the integration of Taxpayer systems to the Commissioner-General's Electronic Invoicing Systems (E-VAT).
\nOVERVIEW
The following specific requirements are for the systems to communicate with E-VAT VCIS, the Certified Invoicing System to be used together with a Virtual Sales Data Controller (VSDC).
AUTHENTICATION
\nThis API requires an Authentication in the Request Header
\nExample: \"SECURITY_KEY\": \"1234567890987UIEGRTEIIIWOWPPWOOW\"
\nDATA FORMAT
\nE-VAT API Receives data in;
\nJSON
\nXML
\nLEVY MAPPING
\n* LEVY_A : NHIL 2.5 %
* LEVY_B : GETFL 2.5 %
* LEVY_D : CST 5%
* LEVY_E : TOURISM 1%
SPECIAL TAX-EXEMPT TAXPAYER
To serve special tax-exempt taxpayers (taxpayers who are exempted from paying the standard taxes/levies) such as some Mining, Automobile Assembly Plants, etc. Please read more here: Purchase Order (PO) for Taxpayers Who Have Special Exemptions.
Covid Levy Amendments, Effective “1st January 2026” & The Impending VAT Amendments: E-VAT Implementation Guidelines
\n\nEXCEL TEMPLATE OF TAX CALCULATION
https://docs.google.com/spreadsheets/d/1DAcDUBVdoHD7A_yOqMcrzuX4rNc4VGLC/edit?usp=drive_link&ouid=114670877025048538475&rtpof=true&sd=true
SAMPLE INVOICE
\nSample Invoice - ERP:
\nSample Invoice - POS:
\nTAG DESCRIPTIONS
\nINVOICE RESPONSE
\nCURRENCIES SUPPORTED
\nhttps://docs.google.com/spreadsheets/d/1geCW7gk-LvHiAXQsigNDObDsFYCXS-pSGGBKQx78JkI/edit?usp=sharing
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"29596173","collectionId":"eda5eb58-10e5-49ee-95da-8c2d766432f6","publishedId":"2s9YJgSKXe","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-08-05T14:07:23.000Z"},"item":[{"name":"INVOICE","item":[{"name":"INVOICE","id":"fbb78c9a-815c-4dc0-88e0-bbf7a30b519a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"currency\": \"GHS\",\r\n \"exchangeRate\": 1.0,\r\n \"invoiceNumber\": \"NS230818-9X00001\",\r\n \"totalLevy\": 63.99,\r\n \"userName\": \"Kofi Ghana\",\r\n \"flag\": \"INVOICE\",\r\n \"calculationType\": \"INCLUSIVE\",\r\n \"totalVat\": 169.57,\r\n \"transactionDate\": \"2023-07-24T08:43:28Z\",\r\n \"totalAmount\": 1300.0,\r\n \"totalExciseAmount\": 0.00,\r\n \"voucherAmount\": 0.0,\r\n \"businessPartnerName\": \"fred(cash customer)\",\r\n \"businessPartnerTin\": \"C0000000000\",\r\n \"saleType\": \"NORMAL\",\r\n \"discountType\": \"GENERAL\",\r\n \"discountAmount\": 0.0,\r\n \"reference\": \"\",\r\n \"groupReferenceId\": \"\",\r\n \"purchaseOrderReference\": \"\",\r\n \"taxType\": \"FLAT\",\r\n \"items\": [\r\n {\r\n \"itemCode\": \"TXC00389165855\",\r\n \"itemCategory\": \"\",\r\n \"expireDate\": \"2025-01-01\",\r\n \"description\": \"1SFA611130R1101\",\r\n \"quantity\": 10.0,\r\n \"levyAmountA\": 26.66,\r\n \"levyAmountB\": 26.66,\r\n \"levyAmountC\": 10.66,\r\n \"levyAmountD\": 0.0,\r\n \"levyAmountE\": 0.0,\r\n \"discountAmount\": 0.0,\r\n \"exciseAmount\": 0.00, \r\n \"batchCode\": \"\",\r\n \"unitPrice\": 130.0\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer/CXX000000YY-001/invoice","description":"Invoice Invoce (Normal Sale) refers to a receipt that shall be produced and offered to the client. It is any receipt produced while the Electronic Billing Machine is in its normal registration mode, used to register sales of goods and/or services, including corrections and discounts.
\n","urlObject":{"path":["CXX000000YY-001","invoice"],"host":["https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer"],"query":[],"variable":[]}},"response":[{"id":"0cd03027-a777-4aea-82f2-21bf885e9454","name":"JSON_SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"currency\": \"GHS\",\r\n \"exchangeRate\": 1.0,\r\n \"invoiceNumber\": \"NS230918-9X00001\",\r\n \"totalLevy\": 63.99,\r\n \"userName\": \"Kofi Ghana\",\r\n \"flag\": \"INVOICE\",\r\n \"calculationType\": \"INCLUSIVE\",\r\n \"totalVat\": 169.57,\r\n \"transactionDate\": \"2023-09-13T08:43:28Z\",\r\n \"totalAmount\": 1300.0,\r\n \"voucherAmount\": 0.0,\r\n \"businessPartnerName\": \"fred(cash customer)\",\r\n \"businessPartnerTin\": \"C0000000000\",\r\n \"saleType\": \"NORMAL\",\r\n \"discountType\": \"GENERAL\",\r\n \"discountAmount\": 0.0,\r\n \"reference\": \"\",\r\n \"groupReferenceId\": \"\",\r\n \"purchaseOrderReference\": \"\",\r\n \"items\": [\r\n {\r\n \"itemCode\": \"TXC00389165855\",\r\n \"itemCategory\": \"\",\r\n \"expireDate\": \"2025-01-01\",\r\n \"description\": \"1SFA611130R1101\",\r\n \"quantity\": 10.0,\r\n \"levyAmountA\": 26.66,\r\n \"levyAmountB\": 26.66,\r\n \"levyAmountC\": 10.66,\r\n \"levyAmountD\": 0.0,\r\n \"levyAmountE\": 0.0,\r\n \"discountAmount\": 0.0, \r\n \"batchCode\": \"\",\r\n \"unitPrice\": 130.0\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer/CXX000000YY-001/invoice"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Keep-Alive","value":"timeout=20"},{"key":"Content-Type","value":"application/json"},{"key":"X-Powered-By","value":"ARR/3.0"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Mon, 24 Jul 2023 09:09:36 GMT"},{"key":"Content-Length","value":"622"}],"cookie":[],"responseTime":null,"body":"{\n \"response\": {\n \"distributor_tin\": \"C0034186913\",\n \"mesaage\": {\n \"num\": \"NS230724-9000001\",\n \"ysdcid\": \"EV-260623-001\",\n \"ysdcrecnum\": \"83NS\",\n \"ysdcintdata\": \"NUGABIDWABF5MRRN2EXDUSJ7M4\",\n \"ysdcregsig\": \"E4OFBGZX2MT6YBTQ\",\n \"ysdcmrc\": \"2b60f37f175c7c\",\n \"ysdcmrctim\": \"2023/07/24 09:09:36\",\n \"ysdctime\": \"2023/07/24 09:09:36\",\n \"flag\": \"INVOICE\",\n \"ysdcitems\": \"1\"\n },\n \"qr_code\": \"https://verification.vat-gh.com?data=udwCsHNJ1LsF6ljeIIdEdQ1V4srsHpIKgqfS/yD/2/dnhRdAUrVqY5Vjl/0aILYHU9C7vn3HcQqeNiixqXiB1BfxjtBuhZf8UYZwsSWivERBBOSU16BozjS4eTQ/hyXyG/hVInFFTAOODGWa0/6fYS3X+6x/nfShwKe2lRMPV5qgCmRMGx0gsR8w0esCwUO5Wwdjybuu504mY/Av9DLczg==&v=1.0\",\n \"status\": \"SUCCESS\"\n }\n}"},{"id":"5bd37a56-3edb-49c3-8fd1-f054e2c8bc0e","name":"XML_SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"},{"key":"Accept","name":"Content-Type","value":"application/xml","type":"text"}],"body":{"mode":"raw","raw":"\r\nInvoice Invoce (Normal Sale) refers to a receipt that shall be produced and offered to the client. It is any receipt produced while the Electronic Billing Machine is in its normal registration mode, used to register sales of goods and/or services, including corrections and discounts.
\n","urlObject":{"path":["CXX0000XXXY-001","invoice"],"host":["https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer"],"query":[],"variable":[]}},"response":[{"id":"7d7daf93-0122-4f78-a1a4-793d27064a7e","name":"XML_SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"},{"key":"Accept","name":"Content-Type","value":"application/xml","type":"text"}],"body":{"mode":"raw","raw":"\r\nThis includes Partial and Full Refunds
\nFULL REFUND
\nA Full Refund refers to a situation where a customer receives complete reimbursement of the total amount they paid for a product or service. It means that the seller or service provider returns the entire purchase price to the customer.
\nPARTIAL REFUND
A Partial Refund refers to a situation where a customer receives a refund for only a portion of the total amount they paid for a product or service.
REFUND CANCELLATION
\nA Refund Cancellation typically refers to the reversal or annulment of a previously issued refund. It occurs when a seller or service provider decides to nullify or revoke a refund that was previously processed and returned to the customer.
\n","_postman_id":"4749a9dc-9f47-413b-b881-f946e00e0457"},{"name":"PURCHASE","item":[{"name":"PURCHASE","id":"1359dfa7-a003-4481-9b45-97ce555569e1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"currency\": \"GHS\",\r\n \"exchangeRate\": 1.0,\r\n \"invoiceNumber\": \"NS230818-9X00001\",\r\n \"totalLevy\": 63.99,\r\n \"userName\": \"Kofi Ghana\",\r\n \"flag\": \"PURCHASE\",\r\n \"calculationType\": \"INCLUSIVE\",\r\n \"totalVat\": 169.57,\r\n \"transactionDate\": \"2023-07-24T08:43:28Z\",\r\n \"totalAmount\": 1300.0,\r\n \"totalExciseAmount\": 0.00,\r\n \"voucherAmount\": 0.0,\r\n \"businessPartnerName\": \"fred(cash customer)\",\r\n \"businessPartnerTin\": \"C0000000000\",\r\n \"saleType\": \"NORMAL\",\r\n \"discountType\": \"GENERAL\",\r\n \"discountAmount\": 0.0,\r\n \"reference\": \"\",\r\n \"groupReferenceId\": \"\",\r\n \"items\": [\r\n {\r\n \"itemCode\": \"TXC00389165855\",\r\n \"itemCategory\": \"\",\r\n \"expireDate\": \"2025-01-01\",\r\n \"description\": \"1SFA611130R1101\",\r\n \"quantity\": 10.0,\r\n \"levyAmountA\": 26.66,\r\n \"levyAmountB\": 26.66,\r\n \"levyAmountC\": 10.66,\r\n \"levyAmountD\": 0.0,\r\n \"levyAmountE\": 0.0,\r\n \"discountAmount\": 0.0,\r\n \"exciseAmount\": 0.00, \r\n \"batchCode\": \"\",\r\n \"unitPrice\": 130.0\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer/CXX000000YY-001/invoice","urlObject":{"path":["CXX000000YY-001","invoice"],"host":["https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer"],"query":[],"variable":[]}},"response":[{"id":"15ba9619-f9d9-4ef8-9f30-008f3d06b7e7","name":"JSON_SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"currency\": \"GHS\",\r\n \"exchangeRate\": 1.0,\r\n \"invoiceNumber\": \"NS230818-9X00001\",\r\n \"totalLevy\": 63.99,\r\n \"userName\": \"Kofi Ghana\",\r\n \"flag\": \"PURCHASE\",\r\n \"calculationType\": \"INCLUSIVE\",\r\n \"totalVat\": 169.57,\r\n \"transactionDate\": \"2023-07-24T08:43:28Z\",\r\n \"totalAmount\": 1300.0,\r\n \"totalExciseAmount\": 0.00,\r\n \"voucherAmount\": 0.0,\r\n \"businessPartnerName\": \"fred(cash customer)\",\r\n \"businessPartnerTin\": \"C0000000000\",\r\n \"saleType\": \"NORMAL\",\r\n \"discountType\": \"GENERAL\",\r\n \"discountAmount\": 0.0,\r\n \"reference\": \"\",\r\n \"groupReferenceId\": \"\",\r\n \"purchaseOrderReference\": \"\",\r\n \"items\": [\r\n {\r\n \"itemCode\": \"TXC00389165855\",\r\n \"itemCategory\": \"\",\r\n \"expireDate\": \"2025-01-01\",\r\n \"description\": \"1SFA611130R1101\",\r\n \"quantity\": 10.0,\r\n \"levyAmountA\": 26.66,\r\n \"levyAmountB\": 26.66,\r\n \"levyAmountC\": 10.66,\r\n \"levyAmountD\": 0.0,\r\n \"levyAmountE\": 0.0,\r\n \"discountAmount\": 0.0,\r\n \"exciseAmount\": 0.00, \r\n \"batchCode\": \"\",\r\n \"unitPrice\": 130.0\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer/CXX000000YY-001/invoice"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Keep-Alive","value":"timeout=20"},{"key":"Content-Type","value":"application/json"},{"key":"X-Powered-By","value":"ARR/3.0"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Mon, 24 Jul 2023 09:55:18 GMT"},{"key":"Content-Length","value":"311"}],"cookie":[],"responseTime":null,"body":"{\n \"response\": {\n \"distributor_tin\": \"C0034186913\",\n \"mesaage\": {\n \"num\": \"1225299\",\n \"ysdcid\": \"EV-260623-001\",\n \"ysdcrecnum\": \"27\",\n \"ysdcintdata\": \"\",\n \"ysdcregsig\": \"\",\n \"ysdcmrc\": \"2b60f37f175c7c\",\n \"ysdcmrctim\": \"2023/07/24 09:55:18\",\n \"ysdctime\": \"2023/07/24 09:55:18\",\n \"flag\": \"PURCHASE\",\n \"ysdcitems\": \"1\"\n },\n \"qr_code\": \"\",\n \"status\": \"SUCCESS\"\n }\n}"},{"id":"12a2f622-8e76-4890-a4e5-761a34497c4b","name":"XML_SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"},{"key":"Accept","value":"application/xml","type":"text"}],"body":{"mode":"raw","raw":"\r\nPURCHASE
\nA Purchase refers to the act of acquiring or obtaining goods or services in exchange for payment. You are required to record all purchases that you make revenue from, (including raw
materials). For record purposes, this may also include other non-revenue purchases.
PURCHASE RETURN
\nA Purchase Return refers to the act of reversing or nullifying a previously made purchase. It occurs when a buyer or customer decides to cancel their order or transaction.
\n","_postman_id":"21b53835-8ea3-4d10-9af3-ead95e503357"},{"name":"PURCHASE RETURN CANCELLATION","item":[{"name":"JSON","id":"19fdf224-f708-42a3-878a-e39d82b4483f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Security_Key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"invoiceNumber\": \"NS230818-9X060001\",\r\n \"reference\": \"PR-0003\",\r\n \"userName\": \"kofi ghana\",\r\n \"flag\": \"PURCHASE_RETURN_CANCELATION\",\r\n \"transactionDate\": \"2023-08-22T11:25:19.121Z\",\r\n \"totalAmount\": 1300.0\r\n}","options":{"raw":{"language":"json"}}},"url":"https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer/CXX000000YY-001/cancellation","urlObject":{"path":["CXX000000YY-001","cancellation"],"host":["https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer"],"query":[],"variable":[]}},"response":[],"_postman_id":"19fdf224-f708-42a3-878a-e39d82b4483f"},{"name":"XML","id":"e4b63d9c-914a-438f-9da3-834754756208","protocolProfileBehavior":{"disabledSystemHeaders":{"accept":true},"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/xml","type":"text"}],"body":{"mode":"raw","raw":"\r\nPURCHASE RETURN CANCELLATION
\nA Purchase Return Cancellation refers to the reversal or nullification of a previously initiated return of goods or services. It occurs when a buyer or customer decides to cancel their request to return a purchased item or cancel a return process that was already initiated.
\n","_postman_id":"f75d3503-8fad-495c-a443-e61cd5c9994f"},{"name":"CREDIT NOTE/DEBIT NOTE","item":[{"name":"JSON","id":"105dc533-9b13-4d4c-be18-29f6f19ed933","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"noteNumber\": \"34609444488939\",\r\n \"currency\": \"GHS\",\r\n \"exchangeRate\": 1.0,\r\n \"noteAmount\": 1300.0,\r\n \"calculationType\": \"INCLUSIVE\",\r\n \"businessPartnerName\": \"fred(cash customer)\",\r\n \"businessPartnerTin\": \"C0000000000\",\r\n \"userName\": \"Kofi Ghana\",\r\n \"flag\": \"CREDIT_NOTE\",\r\n \"groupReferenceId\": \"2390957437\",\r\n \"transactionDate\": \"2023-09-06T09:05:10.681Z\",\r\n \"remarks\": \"CN\",\r\n \"noteLineFlag\": \"INVOICE\",\r\n \"noteLines\": [\r\n {\r\n \"invoiceNumber\": \"NS230918-9X00001\",\r\n \"invoiceDate\": \"2023-09-06T09:05:10.681Z\",\r\n \"invoiceAmount\": 1300.0\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer/CXX000000YY-001/note","urlObject":{"path":["CXX000000YY-001","note"],"host":["https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer"],"query":[],"variable":[]}},"response":[],"_postman_id":"105dc533-9b13-4d4c-be18-29f6f19ed933"},{"name":"XML","id":"3e9030aa-93d4-4549-9985-2bd60ff4c986","protocolProfileBehavior":{"disabledSystemHeaders":{"accept":true},"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/xml","type":"text"},{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"body":{"mode":"raw","raw":"\r\nCREDIT/DEBIT NOTE
\nA Credit Note, also known as a Credit Memo, is a document issued by a seller or service provider to a customer as a form of credit or refund. It is typically provided when there is a need to rectify a previous transaction, such as returning goods, resolving a billing error, or providing compensation for a service issue. Whereas Refunds (Partial & Full) can only be done on a single invoice, Credit/Debit Notes are used in situations where the said refund/credit applies to multiple invoices.
\nTAG DESCRIPTIONS
\n","_postman_id":"77266244-4499-474d-acd0-c3598ca06b1e"},{"name":"STATEMENT OF ACCOUNT","item":[{"name":"JSON","id":"f9636892-716b-4a8f-86e8-9e99d2855ce8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"currency\": \"GHS\",\r\n \"exchangeRate\": 1,\r\n \"totalVat\": 658.9565217391304,\r\n \"totalAmount\": 5099,\r\n \"totalLevies\": 248.66283839212469,\r\n \"userName\": \"Kofi Ghana\",\r\n \"businessPartnerName\": \"fred(cash customer)\",\r\n \"businessPartnerTin\": \"C0000000000\",\r\n \"groupReferenceId\": \"GRP_REF_9154\",\r\n \"transactionDate\": \"2024-01-06T08:49:08.879Z\",\r\n \"calculationType\":\"INCLUSIVE\",\r\n \"groupInvoiceLines\": [\r\n {\r\n \"currency\": \"GHS\",\r\n \"exchangeRate\": 1,\r\n \"calculationType\":\"INCLUSIVE\",\r\n \"invoiceNumber\": \"QA_INV_7833474375\",\r\n \"reference\":\"\", \r\n \"flag\": \"INVOICE\",\r\n \"invoiceVat\": 235.82608695652173,\r\n \"invoiceAmount\": 1836,\r\n \"invoiceLevies\": 88.9909762100082,\r\n \"transactionDate\": \"2024-01-06T08:49:08.879Z\"\r\n },\r\n {\r\n \"currency\": \"GHS\",\r\n \"exchangeRate\": 1,\r\n \"calculationType\":\"INCLUSIVE\",\r\n \"invoiceNumber\": \"QA_INV_8153543791\",\r\n \"flag\": \"INVOICE\",\r\n \"invoiceVat\": 175.43478260869564,\r\n \"invoiceAmount\": 1354,\r\n \"invoiceLevies\": 66.20180475799836,\r\n \"transactionDate\": \"2024-01-06T08:49:08.879Z\"\r\n },\r\n {\r\n \"currency\": \"GHS\",\r\n \"exchangeRate\": 1,\r\n \"calculationType\":\"INCLUSIVE\",\r\n \"invoiceNumber\": \"QA_INV_5589117822\",\r\n \"reference\":\"\",\r\n \"flag\": \"INVOICE\",\r\n \"invoiceVat\": 247.695652173913,\r\n \"invoiceAmount\": 1909,\r\n \"invoiceLevies\": 93.47005742411813,\r\n \"transactionDate\": \"2024-01-06T08:49:08.879Z\"\r\n }\r\n ,\r\n {\r\n \"currency\": \"GHS\",\r\n \"exchangeRate\": 1,\r\n \"calculationType\":\"INCLUSIVE\",\r\n \"invoiceNumber\": \"QA_INV_5589117823\",\r\n \"reference\":\"\",\r\n \"flag\": \"INVOICE\",\r\n \"invoiceVat\": 247.695652173913,\r\n \"invoiceAmount\": 1909,\r\n \"invoiceLevies\": 93.47005742411813,\r\n \"transactionDate\": \"2024-01-06T08:49:08.879Z\"\r\n }\r\n ,\r\n {\r\n \"currency\": \"GHS\",\r\n \"exchangeRate\": 1,\r\n \"calculationType\":\"INCLUSIVE\",\r\n \"invoiceNumber\": \"QA_INV_5589117823\",\r\n \"reference\":\"00000001\",\r\n \"flag\": \"REFUND\",\r\n \"invoiceVat\": 247.695652173913,\r\n \"invoiceAmount\": 1909,\r\n \"invoiceLevies\": 93.47005742411813,\r\n \"transactionDate\": \"2024-01-06T08:49:08.879Z\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer/CXX000000YY-001/statment_of_account","urlObject":{"path":["CXX000000YY-001","statment_of_account"],"host":["https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer"],"query":[],"variable":[]}},"response":[],"_postman_id":"f9636892-716b-4a8f-86e8-9e99d2855ce8"},{"name":"XML","id":"67f84f0c-e970-4686-b242-10dd25901164","protocolProfileBehavior":{"disabledSystemHeaders":{"accept":true},"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/xml","type":"text"},{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"body":{"mode":"raw","raw":"\r\nSTATEMENT OF ACCOUNT
\nA Statement of Account is a summary of financial transactions and activity between a seller or service provider and a customer over a specific period. It is used to track the folio of a particular customer. IMPLEMENTED FOR THE HOSPITALITY INDUSTRIES, this allows for a single invoice (i.e.: a combination of all invoices from the PMS & PoS) to be printed at the end of a stay.
\nTAG DESCRIPTIONS
\n","_postman_id":"ed709ce5-d44a-4dcf-bc76-6895eb1553dd"},{"name":"HEALTH CHECK","item":[{"name":"HEALTH CHECK","id":"28ead6d2-24e5-47cb-b39e-3e0a8a25fe21","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"url":"https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer/CXX000000YY-001/health","urlObject":{"path":["CXX000000YY-001","health"],"host":["https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer"],"query":[],"variable":[]}},"response":[{"id":"29960835-6f1c-4d67-a108-96b0b8fd78e6","name":"JSON_SUCCESS","originalRequest":{"method":"GET","header":[{"key":"security_key","value":"PPS9JnHHxZgNwQlAKn7PeQ/mCicjy4p0zqLyFN0g53M=","type":"text"}],"url":"https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer/CXX000000YY-001/health"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Keep-Alive","value":"timeout=20"},{"key":"Content-Type","value":"application/json"},{"key":"X-Powered-By","value":"ARR/3.0"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Wed, 30 Aug 2023 12:49:08 GMT"},{"key":"Content-Length","value":"15"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"UP\"\n}"},{"id":"97459797-392e-4618-8255-3bf99409602b","name":"XML_SUCCESS","originalRequest":{"method":"GET","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"url":"https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer/CXX000000YY-001/health"},"_postman_previewlanguage":"xml","header":[{"key":"Content-Type","value":"application/xml","name":"Content-Type","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"Documentation for Errors
\n","_postman_id":"9dacfc83-6f8a-46c7-922c-fe6c2e438c81"},{"name":"TIN VALIDATOR","item":[{"name":"TinDetails","id":"8704d37a-eaa4-4aa1-9881-c0217596e8e3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"urlObject":{"query":[],"variable":[]},"url":""},"response":[{"id":"5cb4e404-95bf-448c-853d-801c7f1a60af","name":"SuccessTinDetails","originalRequest":{"method":"GET","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"url":"https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer/CXX000000YY-001/identification/tin/C0034186913"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Keep-Alive","value":"timeout=20"},{"key":"Content-Type","value":"application/json"},{"key":"X-Powered-By","value":"ARR/3.0"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Mon, 16 Oct 2023 08:48:45 GMT"},{"key":"Content-Length","value":"209"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"SUCCESS\",\n \"data\": {\n \"tin\": \"C0034186913\",\n \"type\": \"C\",\n \"name\": \"SPRING DATA WORKS. LIMITED\",\n \"sector\": \"Other business support service activities n.e.c.\",\n \"address\": \"ACRA, NEAR Dadeban Rd., HOUSE NUMBER 17\"\n }\n}"},{"id":"6b17fec5-4b31-4621-9467-7c62db7659de","name":"TinDetails","originalRequest":{"method":"GET","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="}],"url":"https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer/CXX000000YY-001/identification/tin/C0034186913"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-store"},{"key":"Content-Type","value":"application/json"},{"key":"X-Powered-By","value":"ARR/3.0"},{"key":"Content-Security-Policy","value":"default-src 'self' data: *; style-src 'self' http://* 'unsafe-inline'; script-src 'self' http://* 'unsafe-inline' 'unsafe-eval'; img-src 'self' http://* data:;"},{"key":"Expect-Ct","value":"enforce, max-age=43200"},{"key":"Feature-Policy","value":"fullscreen 'none'"},{"key":"Permissions-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=31536000"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Date","value":"Tue, 11 Mar 2025 11:07:33 GMT"},{"key":"Content-Length","value":"209"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"SUCCESS\",\n \"data\": {\n \"tin\": \"C0034186913\",\n \"type\": \"C\",\n \"name\": \"SPRING DATA WORKS. LIMITED\",\n \"sector\": \"Other business support service activities n.e.c.\",\n \"address\": \"ACRA, NEAR Dadeban Rd., HOUSE NUMBER 17\"\n }\n}"}],"_postman_id":"8704d37a-eaa4-4aa1-9881-c0217596e8e3"},{"name":"GhanaCardDetails","id":"1753f46d-3b03-445c-a79c-30b08c12d41e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"url":"https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer/CXX000000YY-001/identification/nationalId/GHA-000XXXXXX-2","urlObject":{"path":["CXX000000YY-001","identification","nationalId","GHA-000XXXXXX-2"],"host":["https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer"],"query":[],"variable":[]}},"response":[{"id":"ebc61376-b68f-42ed-a20e-a413358e887d","name":"SuccessTinDetails","originalRequest":{"method":"GET","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"url":"https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer/CXX000000YY-001/identification/tin/C0034186913"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Keep-Alive","value":"timeout=20"},{"key":"Content-Type","value":"application/json"},{"key":"X-Powered-By","value":"ARR/3.0"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Mon, 16 Oct 2023 08:48:45 GMT"},{"key":"Content-Length","value":"209"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"SUCCESS\",\n \"data\": {\n \"tin\": \"C0034186913\",\n \"type\": \"C\",\n \"name\": \"SPRING DATA WORKS. LIMITED\",\n \"sector\": \"Other business support service activities n.e.c.\",\n \"address\": \"ACRA, NEAR Dadeban Rd., HOUSE NUMBER 17\"\n }\n}"}],"_postman_id":"1753f46d-3b03-445c-a79c-30b08c12d41e"}],"id":"8f4a6d89-2e5e-4faf-bf6f-db0145a5f04e","_postman_id":"8f4a6d89-2e5e-4faf-bf6f-db0145a5f04e","description":""},{"name":"INVENTORY","item":[{"name":"JSON","id":"d69d2e09-28b8-4bb7-9c43-8f20426a4c73","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Security_Key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"inventories\": [\r\n {\r\n \"code\": \"04004X\",\r\n \"description\": \"Yogo\",\r\n \"quantity\": 3,\r\n \"batchCode\": \"0001\",\r\n \"unitPrice\": 100.0,\r\n \"expiryDate\": \"2024-04-04\"\r\n }\r\n ],\r\n \"inventoryDate\": \"2024-04-04\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer/CXX000000YY-001/inventory","urlObject":{"path":["CXX000000YY-001","inventory"],"host":["https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer"],"query":[],"variable":[]}},"response":[{"id":"54a461fa-c254-4949-9e60-eaabfd688769","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"Security_Key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"inventories\": [\r\n {\r\n \"code\": \"04004X\",\r\n \"description\": \"Yogo\",\r\n \"quantity\": 3,\r\n \"batchCode\": \"0001\",\r\n \"unitPrice\": 100.0,\r\n \"expiryDate\": \"2024-04-04\"\r\n }\r\n ],\r\n \"inventoryDate\": \"2024-04-04\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer/CXX000000YY-001/inventory"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-store"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Content-Type","value":"application/json"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Powered-By","value":"ARR/3.0"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Content-Security-Policy","value":"default-src 'self' data: *; style-src 'self' http://* 'unsafe-inline'; script-src 'self' http://* 'unsafe-inline' 'unsafe-eval'; img-src 'self' http://* data:;"},{"key":"Expect-CT","value":"enforce, max-age=43200"},{"key":"Feature-Policy","value":"fullscreen 'none'"},{"key":"Permission-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=31536000"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Tue, 07 May 2024 16:39:07 GMT"},{"key":"Content-Length","value":"20"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"SUCCESS\"\n}"}],"_postman_id":"d69d2e09-28b8-4bb7-9c43-8f20426a4c73"}],"id":"47a9a3b9-68b2-460c-89c4-4fc117daa705","_postman_id":"47a9a3b9-68b2-460c-89c4-4fc117daa705","description":""},{"name":"INVOICE_CALLBACK","item":[{"name":"INVOICE_CALLBACK","id":"6f55b3c4-95cd-4e39-8e46-50670d8132bd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"\",\r\n \"invoiceNumber\": \"NS240442-001-90003\",\r\n \"flag\": \"INVOICE\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer/CXX000000YY-001/invoice/callback","urlObject":{"path":["CXX000000YY-001","invoice","callback"],"host":["https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer"],"query":[],"variable":[]}},"response":[{"id":"4a1e23ad-e958-4655-893b-dc076f56fd2e","name":"JSON_SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"\",\r\n \"invoiceNumber\": \"NS240442-001-90003\",\r\n \"flag\": \"INVOICE\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://vsdcstaging.vat-gh.com/vsdc/api/v1/taxpayer/CXX000000YY-001/invoice/callback"},"status":"OK ","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-store"},{"key":"Content-Type","value":"application/json"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Powered-By","value":"ARR/3.0"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Content-Security-Policy","value":"default-src 'self' data: *; style-src 'self' http://* 'unsafe-inline'; script-src 'self' http://* 'unsafe-inline' 'unsafe-eval'; img-src 'self' http://* data:;"},{"key":"Expect-CT","value":"enforce, max-age=43200"},{"key":"Feature-Policy","value":"fullscreen 'none'"},{"key":"Permission-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=31536000"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Tue, 07 May 2024 16:41:55 GMT"},{"key":"Content-Length","value":"88"}],"cookie":[],"responseTime":null,"body":"{\n \"response\": {\n \"distributor_tin\": \"C0000000003\",\n \"message\": {\n \"num\": \"NS240442-001-90003\",\n \"ysdcid\": \"E000001001\",\n \"ysdcrecnum\": \"1001-5FC8-NS1\",\n \"ysdcintdata\": \"3UVG-CHSP-T62G-LMFB-4U2G-WBXC-BA\",\n \"ysdcregsig\": \"DZGB-FS7P-EEUH-OQYJ\",\n \"ysdcmrc\": \"00-0C-29-5C-7C-EB\",\n \"ysdcmrctim\": \"2024/04/23 10:05:50\",\n \"ysdctime\": \"2024/04/23 10:05:50\",\n \"flag\": \"INVOICE\",\n \"ysdcitems\": \"1\"\n },\n \"qr_code\": \"https://evat-verification-ey.cimsgh.com?data=Tgwfru4p/COzuGWHqIam5Q4pILJpZgW9+hvGA9k38PED5/xYS3+arhQ6O3Z9/SobvI4I8NOrZyYiNSLfvGSU4J4xL3/53IkvYbhbSmcweQqAtpx3lMY0hQ6UEZWm60yVcGzbRhTkSKGSGz7TfVBGFJ75GIBZJUmDiFMHpurYP/R0BbWBb2CZHvkwpR3UOws9F/dAUtREmAoNOcN7Y0292lzTiSetfcG15e6mB+3G848nsHrOxto+zymE64AkGNaN+aXkPzPmG1gDhZXxmnLU6h7da0A/1ulobMDopVs9DmP1j6oqDUByYibsH17SQy9iixfs5x4GJ4YMYDKAS0lIgw==&v=1.1&t=i\",\n \"status\": \"SUCCESS\"\n }\n}"},{"id":"8f3f4d69-651c-48ac-8893-759029129493","name":"XML_SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"},{"key":"Accept","name":"Content-Type","value":"application/xml","type":"text"}],"body":{"mode":"raw","raw":"\r\n