{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"e6415b7f-11ec-4753-b175-57d7cfce413b","name":"RRA-ALGO EBM INTEGRATION API VER 8.5","description":"# EBM Integration Guide — Version 8.5\n\nALGORITHM EBM INTEGRATION API Documentation VER 8.5, API for RRA INTEGRATION DOCUMENTATION VCIS/VSDC\n\nThis document describes the API specification to integrate with Electronic Invoicing Systems (EBM)\n\nOverview  \nThe following specific requirements are for the systems to communicate with EBM VCIS, the Certified Invoicing System to be used together with a Virtual Sales Data Controller (VSDC).\n\n[DATAFLOW DIAGRAM](https://gra.evatgra.com/DataFlow.php)\n\n## Collection variables\n\n- `{{baseUrl}}` — API server base URL\n    \n- `{{securityKey}}` — API authentication/security key\n    \n- `{{companyTin}}` — taxpayer/company TIN\n    \n\n## Request formats\n\nUse `application/xml` for XML requests and `application/json` for JSON requests. The examples in this collection show the corresponding field names and repeated-item structure.\n\n## Recommended integration sequence\n\n### General EBM operations\n\n1. **Health Check** — confirm the service is Ready and the company is registered.\n    \n2. **Register General Items** — register non-fuel goods/services.\n    \n3. **Submit Inventory** — report physical stock for existing items when required.\n    \n4. **Submit Purchase** — submit stock-in purchase records.\n    \n5. **Issue General Invoice** — issue sales receipts using the appropriate calculation type.\n    \n\n### Fuel operations\n\n1. **Health Check**.\n    \n2. **Get Fuel Items** — retrieve RRA fuel products and regulated prices.\n    \n3. **Map Fuel Items** — map local item codes. Documented rules require `taxCode=F` and `itemCategory=PETROL` or `DIESEL`.\n    \n4. **Get Fuel Dealers** — required when issuing Resale sales.\n    \n5. **Submit Fuel Opening Stock** — declare opening/tank stock for mapped fuel items.\n    \n6. **Issue Fuel Consumption Invoice** — `saleType=Consumption`, mapped fuel item, RRP-band validation and VAT validation.\n    \n7. **Issue Fuel Resale Invoice** — `saleType=Resale`, registered dealer `clientTin`, discount `> 0`, and matching `total discount`.\n    \n\n### Tourism levy\n\nFor hospitality taxpayers charging the tourism levy, use the tourism levy examples. Supply line `TtaxRate` and a matching header `totalLevy`.\n\n## Tax code mapping documented by this collection\n\n- `A` — 0% Exempted or Zero Rated\n    \n- `B` — 18% Taxable\n    \n- `C` — 0% Export\n    \n- `D` — 0% Non Taxable Taxayers\n    \n- `F` — 18% Fuel\n    \n\n## Fuel validation summary\n\n- Fuel receipts use `taxCode=F`.\n    \n- Fuel items must be mapped before invoicing.\n    \n- Fuel receipts use `Consumption` or `Resale`.\n    \n- Consumption `unitPrice` must be inside the regulated RRP band.\n    \n- Resale requires a registered dealer `clientTin`.\n    \n- Resale requires line discount value `> 0`.\n    \n- `totalVat` must equal computed VAT.  \n    \n\nVAT Calculation Template: [https://docs.google.com/spreadsheets/d/1s1nWalN8aWtl19X0VnJYwxIpHbsufF0J/edit#gid=733547670](https://docs.google.com/spreadsheets/d/1s1nWalN8aWtl19X0VnJYwxIpHbsufF0J/edit#gid=733547670)\n\nTAG DESCRIPTION:[https://docs.google.com/spreadsheets/d/1K4ho8xq8UKbehpaFTM77TZspReov7lTp/edit?gid=562461827#gid=562461827](https://docs.google.com/spreadsheets/d/1K4ho8xq8UKbehpaFTM77TZspReov7lTp/edit?gid=562461827#gid=562461827)\n\nThis documentation is limited to the behavior and rules represented in the supplied API collection; it does not add unsupported business rules.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"29070467","team":5872017,"collectionId":"e6415b7f-11ec-4753-b175-57d7cfce413b","publishedId":"2sBYHQ1NJu","public":true,"publicUrl":"https://documenter-api.postman.tech/view/29070467/2sBYHQ1NJu","privateUrl":"https://go.postman.co/documentation/29070467-e6415b7f-11ec-4753-b175-57d7cfce413b","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"ALGORITHM EBM INTEGRATION API Documentation VER 8.3, API for RRA INTEGRATION DOCUMENTATION VCIS/VSDC\nThis document describes the API specification to integrate with Electronic Invoicing Systems (EBM)\n\nThe following specific requirements are for the systems to communicate with EBM VCIS, the Certified Invoicing System"},{"name":"title","value":"EBM VSDC INTEGRATION "}],"appearance":{"default":"system_default","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.12.12","publishDate":"2026-10-08T14:30:45.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"EBM VSDC INTEGRATION ","description":"ALGORITHM EBM INTEGRATION API Documentation VER 8.3, API for RRA INTEGRATION DOCUMENTATION VCIS/VSDC\nThis document describes the API specification to integrate with Electronic Invoicing Systems (EBM)\n\nThe following specific requirements are for the systems to communicate with EBM VCIS, the Certified Invoicing System"},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://postman-image-service.postman.com/api/cloudinary-proxy/postman/image/upload/t_team_logo_pubdoc/v1/team/7e9d265feccb5c176dfb8160f34c0e43b7d63c4bc28934be320e005d516803f5","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2sBYHQ1NJu"}