{"info":{"_postman_id":"e6415b7f-11ec-4753-b175-57d7cfce413b","name":"RRA-ALGO EBM INTEGRATION API VER 8.5","description":"

EBM Integration Guide — Version 8.5

ALGORITHM EBM INTEGRATION API Documentation VER 8.5, API for RRA INTEGRATION DOCUMENTATION VCIS/VSDC

This document describes the API specification to integrate with Electronic Invoicing Systems (EBM)

Overview
The 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).

DATAFLOW DIAGRAM

Collection variables

http://localhost:8080 — API server base URL
\n
Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg= — API authentication/security key
\n
999000025 — taxpayer/company TIN
\n

Request formats

Use 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.

Recommended integration sequence

General EBM operations

Health Check — confirm the service is Ready and the company is registered.
\n
Register General Items — register non-fuel goods/services.
\n
Submit Inventory — report physical stock for existing items when required.
\n
Submit Purchase — submit stock-in purchase records.
\n
Issue General Invoice — issue sales receipts using the appropriate calculation type.
\n

Fuel operations

Health Check.
\n
Get Fuel Items — retrieve RRA fuel products and regulated prices.
\n
Map Fuel Items — map local item codes. Documented rules require taxCode=F and itemCategory=PETROL or DIESEL.
\n
Get Fuel Dealers — required when issuing Resale sales.
\n
Submit Fuel Opening Stock — declare opening/tank stock for mapped fuel items.
\n
Issue Fuel Consumption Invoice — saleType=Consumption, mapped fuel item, RRP-band validation and VAT validation.
\n
Issue Fuel Resale Invoice — saleType=Resale, registered dealer clientTin, discount > 0, and matching total discount.
\n

Tourism levy

For hospitality taxpayers charging the tourism levy, use the tourism levy examples. Supply line TtaxRate and a matching header totalLevy.

Tax code mapping documented by this collection

A — 0% Exempted or Zero Rated
\n
B — 18% Taxable
\n
C — 0% Export
\n
D — 0% Non Taxable Taxayers
\n
F — 18% Fuel
\n

Fuel validation summary

Fuel receipts use taxCode=F.
\n
Fuel items must be mapped before invoicing.
\n
Fuel receipts use Consumption or Resale.
\n
Consumption unitPrice must be inside the regulated RRP band.
\n
Resale requires a registered dealer clientTin.
\n
Resale requires line discount value > 0.
\n
totalVat must equal computed VAT.
\n

VAT Calculation Template: https://docs.google.com/spreadsheets/d/1s1nWalN8aWtl19X0VnJYwxIpHbsufF0J/edit#gid=733547670

TAG DESCRIPTION:https://docs.google.com/spreadsheets/d/1K4ho8xq8UKbehpaFTM77TZspReov7lTp/edit?gid=562461827#gid=562461827

This documentation is limited to the behavior and rules represented in the supplied API collection; it does not add unsupported business rules.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"EBM Integration Guide — Version 8.5","slug":"ebm-integration-guide-version-85"}],"owner":"29070467","collectionId":"e6415b7f-11ec-4753-b175-57d7cfce413b","publishedId":"2sBYHQ1NJu","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-10-08T14:30:45.000Z"},"item":[{"name":"00 - Integration Guide","item":[],"id":"c3b8253d-abe5-4eb7-a86b-2eb3c7f78c97","description":"

EBM Integration Guide — Version 8.5

Collection variables

http://localhost:8080 — API server base URL
\n
Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg= — API authentication/security key
\n
999000025 — taxpayer/company TIN
\n

Request formats

Use 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.

Recommended integration sequence

General EBM operations

Health Check — confirm the service is Ready and the company is registered.
\n
Register General Items — register non-fuel goods/services.
\n
Submit Inventory — report physical stock for existing items when required.
\n
Submit Purchase — submit stock-in purchase records.
\n
Issue General Invoice — issue sales receipts using the appropriate calculation type.
\n

Fuel operations

Health Check.
\n
Get Fuel Items — retrieve RRA fuel products and regulated prices.
\n
Map Fuel Items — map local item codes. Documented rules require taxCode=F and itemCategory=PETROL or DIESEL.
\n
Get Fuel Dealers — required when issuing Resale sales.
\n
Submit Fuel Opening Stock — declare opening/tank stock for mapped fuel items.
\n
Issue Fuel Consumption Invoice — saleType=Consumption, mapped fuel item, RRP-band validation and VAT validation.
\n
Issue Fuel Resale Invoice — saleType=Resale, registered dealer clientTin, dcValue > 0, and matching totalDcValue.
\n

Tourism levy

For hospitality taxpayers charging the tourism levy, use the tourism levy examples. Supply line TtaxRate and a matching header totalLevy.

Tax code mapping documented by this collection

A — 0% Exempted
\n
B — 18% Taxable
\n
C — 0% Export
\n
D — 0% Non Taxable
\n
F — Fuel
\n

Fuel validation summary

Fuel receipts use taxCode=F.
\n
Fuel items must be mapped before invoicing.
\n
Fuel receipts use Consumption or Resale.
\n
Consumption unitPrice must be inside the regulated RRP band.
\n
Resale requires a registered dealer clientTin.
\n
Resale requires line dcValue > 0.
\n
totalDcValue must equal the sum of line dcValue.
\n
totalVat must equal computed VAT.
\n

VAT Calculation Template: https://docs.google.com/spreadsheets/d/1s1nWalN8aWtl19X0VnJYwxIpHbsufF0J/edit#gid=733547670

TAG DESCRIPTION:https://docs.google.com/spreadsheets/d/1K4ho8xq8UKbehpaFTM77TZspReov7lTp/edit?gid=562461827#gid=562461827

This documentation is limited to the behavior and rules represented in the supplied API collection; it does not add unsupported business rules.

\n","_postman_id":"c3b8253d-abe5-4eb7-a86b-2eb3c7f78c97"},{"name":"01 - Health & Registration","item":[{"name":"Health Check — JSON","id":"b26c35e8-8b1e-4061-bb1d-aa74fb5acf22","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"companyTin\": \"999000025\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/healthcheck","description":"

Service health / registration probe (JSON). For: ALL taxpayers integrating with the service. Send companyTin; a ready service returns status=Ready with sdc_id and skmm status.

\n","urlObject":{"path":["vsdc","v1","healthcheck"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"58e9da3f-ed92-47ad-8423-930b0ad99604","name":"SUCCESSFULL RESPONSE","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"companyTin\": \"999000025\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/healthcheck"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 24 Feb 2026 10:31:43 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"sdc_id\": \"SDC009000057\",\n \"companyTin\": \"999000025\",\n \"skmm status\": true,\n \"status\": \"Ready\",\n \"timestamp\": \"2026-02-24T10:31:43.441101900Z\"\n}"},{"id":"c8a990cd-0a2a-442b-bc3a-df85b777e355","name":"ERRORED RESPONSE","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"companyTin\": \"999000026\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/healthcheck"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 24 Feb 2026 11:16:11 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"sdc_id\": \"\",\n \"companyTin\": \"999000026\",\n \"skmm status\": false,\n \"status\": \"Not Ready\",\n \"timestamp\": \"2026-02-24T11:16:11.108558200Z\"\n}"}],"_postman_id":"b26c35e8-8b1e-4061-bb1d-aa74fb5acf22"},{"name":"Health Check — XML","id":"2356d119-3dba-435d-8636-0d0e30c215f3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"},{"key":"Content-Type","value":"application/xml","type":"text"}],"body":{"mode":"raw","raw":"\r\n999000025","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/healthcheck","description":"

Service health / registration probe (XML). For: ALL taxpayers integrating with the service. Body is just ; returns with status, skmm status and sdc_id.

\n","urlObject":{"path":["vsdc","v1","healthcheck"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"4bd5d647-25f2-40ec-8fb2-c8f40d04fb8a","name":"SUCCESSFULL RESPONSE","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"body":{"mode":"raw","raw":"\r\n999000025","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/healthcheck"},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"RateLimit-Limit","value":"100"},{"key":"RateLimit-Remaining","value":"99"},{"key":"X-RateLimit-Limit","value":"100"},{"key":"X-RateLimit-Remaining","value":"99"},{"key":"Content-Type","value":"application/xml","description":"","type":"text"},{"key":"Content-Length","value":"277"},{"key":"Date","value":"Mon, 11 May 2026 17:05:51 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"\n\n 999000025\n Ready\n true\n SDC009000057\n 2026-05-11T17:05:51.828454200Z\n"},{"id":"cd9576f3-151f-4633-9cf3-eeb90e68e94d","name":"ERRORED RESPONSE","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"}],"body":{"mode":"raw","raw":"\r\n9990000251","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/healthcheck"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"xml","header":[{"key":"RateLimit-Limit","value":"100"},{"key":"RateLimit-Remaining","value":"99"},{"key":"X-RateLimit-Limit","value":"100"},{"key":"X-RateLimit-Remaining","value":"99"},{"key":"Content-Type","value":"application/xml","description":"","type":"text"},{"key":"Content-Length","value":"260"},{"key":"Date","value":"Mon, 11 May 2026 17:07:35 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"\n\n \n Not Ready\n false\n Not Ready\n 2026-05-11T17:07:35.575747800Z\n"}],"_postman_id":"2356d119-3dba-435d-8636-0d0e30c215f3"}],"id":"91047e41-d1f9-4f7f-bb82-c9f7d2ac068b","description":"

Start here. Verify service availability and taxpayer registration.

\n","_postman_id":"91047e41-d1f9-4f7f-bb82-c9f7d2ac068b"},{"name":"02 - General Item Registration","item":[{"name":"Register General Items — JSON","id":"5a069b27-c28f-490a-8541-24590c77696e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"companyTin\": \"999000025\",\r\n \"reference\": \"INV0003\",\r\n \"userName\": \"OKOBI\",\r\n \"requestDate\": \"2022-09-26\",\r\n \"items\": [\r\n {\r\n \"description\": \"FANTA 1.5l\",\r\n \"itemClsCd\": \"41278976\",\r\n \"itemCd\": \"FANT004\",\r\n \"taxCode\": \"B\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/SendItems","description":"

JSON variant of SendItems. For: all taxpayers (non-fuel item registration).

\n","urlObject":{"path":["vsdc","v1","SendItems"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"c95ec41c-83a1-45f9-a0aa-38d6b67e4f3d","name":"SUCCESS","originalRequest":{"method":"POST","header":[],"url":"http://localhost:8080/vsdc/v1/SendItems"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"RESPONSE\":{\"STATUS\":\"SUCCESS\",\"MESSAGE\":\"Operation completed\"}}"}],"_postman_id":"5a069b27-c28f-490a-8541-24590c77696e"},{"name":"Register General Items — XML","id":"484a4d55-9a1d-40df-a29f-0d8db48119d1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/xml","type":"text"}],"body":{"mode":"raw","raw":"\r\n999000025\r\nINV0003\r\nOKOBI\r\n2022-09-26\r\n\r\n FANTA 1.5l\r\n 41278976\r\n FANT004\r\n B\r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/SendItems","description":"

Registers item master data (non-fuel). For: all taxpayers that sell goods/services other than fuel. Repeat blocks per product. taxCode: A = 0% exempt, B = 18% taxable, C = 0% export, D = 0% non-taxable, F = fuel.

\n","urlObject":{"path":["vsdc","v1","SendItems"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"ca1cfaa7-7ea9-40e0-bafc-bee4fecf5bbb","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/xml"}],"body":{"mode":"raw","raw":"\r\n999000025\r\nINV0003\r\nOKOBI\r\n2022-09-26\r\n\r\n FANTA 1.5l\r\n 41278976\r\n FANT005\r\n B\r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/SendItems"},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/xml;charset=ISO-8859-1"},{"key":"content-length","value":"406"},{"key":"date","value":"Mon, 12 Oct 2026 06:46:29 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"999000025SUCCESSINV0003ITEMSDC0090000561VALG01VNA082026-10-12 08:46:292026-10-12 08:46:29"}],"_postman_id":"484a4d55-9a1d-40df-a29f-0d8db48119d1"}],"id":"2094362f-5aee-48a1-b846-5c93daa7ae29","description":"

\n","_postman_id":"2094362f-5aee-48a1-b846-5c93daa7ae29"},{"name":"03 - General Inventory","item":[{"name":"Submit Inventory — XML","id":"e7fd25aa-4c26-49dc-93ff-6c07c6119a4c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/xml","type":"text"}],"body":{"mode":"raw","raw":"\r\n999000025\r\nINV0006\r\nIyanya OKOBI\r\n2025-01-16\r\n\r\n TEA0098\r\n GREEN TEA\r\n 258\r\n 12\r\n WA00134\r\n 2023-08-24\r\n\r\n\r\n 1000P1R221\r\n COFFE 150 KG\r\n 1000\r\n 30.5\r\n WA00135\r\n 2023-08-24\r\n\r\n\r\n TEA00981\r\n GREEN TEA2023 \r\n 258\r\n 12\r\n WA00134\r\n 2023-08-24\r\n\r\n\r\n 1000P1R221z12\r\n AMIN TR 150 KG\r\n 1000\r\n 30.5\r\n WA00135\r\n 2023-08-24\r\n\r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/SendInventory","description":"

Submits a stock count. For: any taxpayer reporting physical stock. Each block needs itemCd, description, qty, avg_price; batch and expire optional. The item must already exist (send it via SendItems first).

\n","urlObject":{"path":["vsdc","v1","SendInventory"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"ee33d48e-bde8-4c1e-a5f8-1f8780a40bf5","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/xml"}],"body":{"mode":"raw","raw":"\r\n999000025\r\nINV00012\r\nIyanya OKOBI\r\n2026-10-12\r\n\r\n TEA0098\r\n GREEN TEA\r\n 258\r\n 12\r\n WA00134\r\n 2023-08-24\r\n\r\n\r\n 1000P1R221\r\n COFFE 150 KG\r\n 1000\r\n 30.5\r\n WA00135\r\n 2023-08-24\r\n\r\n\r\n TEA00981\r\n GREEN TEA2023 \r\n 258\r\n 12\r\n WA00134\r\n 2023-08-24\r\n\r\n\r\n 1000P1R221z12\r\n AMIN TR 150 KG\r\n 1000\r\n 30.5\r\n WA00135\r\n 2023-08-24\r\n\r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/SendInventory"},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/xml;charset=ISO-8859-1"},{"key":"content-length","value":"412"},{"key":"date","value":"Mon, 12 Oct 2026 06:49:22 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"999000025SUCCESSINV00012INVENTORYSDC0090000564VALG01VNA082026-10-12 08:49:222026-10-12 08:49:22"}],"_postman_id":"e7fd25aa-4c26-49dc-93ff-6c07c6119a4c"},{"name":"Submit Inventory — JSON","id":"6090fe57-f20b-4d64-bc64-a73a72d3ca02","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"companyTin\": \"999000025\",\r\n \"reference\": \"INV0006\",\r\n \"userName\": \"Iyanya OKOBI\",\r\n \"inventoryDate\": \"2025-01-16\",\r\n \"items\": [\r\n {\r\n \"itemCd\": \"TEA0098\",\r\n \"description\": \"GREEN TEA\",\r\n \"qty\": 258,\r\n \"avg_price\": 12,\r\n \"batch\": \"WA00134\",\r\n \"expire\": \"2023-08-24\"\r\n },\r\n {\r\n \"itemCd\": \"1000P1R221\",\r\n \"description\": \"COFFE 150 KG\",\r\n \"qty\": 1000,\r\n \"avg_price\": 30.5,\r\n \"batch\": \"WA00135\",\r\n \"expire\": \"2023-08-24\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/SendInventory","description":"

JSON variant of SendInventory. For: any taxpayer reporting physical stock.

\n","urlObject":{"path":["vsdc","v1","SendInventory"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"6613da10-f3f1-47e6-93c5-c40b367036f2","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"companyTin\": \"999000025\",\r\n \"reference\": \"INV000123\",\r\n \"userName\": \"Iyanya OKOBI\",\r\n \"inventoryDate\": \"2025-01-16\",\r\n \"items\": [\r\n {\r\n \"itemCd\": \"TEA0098\",\r\n \"description\": \"GREEN TEA\",\r\n \"qty\": 258,\r\n \"avg_price\": 12,\r\n \"batch\": \"WA00134\",\r\n \"expire\": \"2023-08-24\"\r\n },\r\n {\r\n \"itemCd\": \"1000P1R221\",\r\n \"description\": \"COFFE 150 KG\",\r\n \"qty\": 1000,\r\n \"avg_price\": 30.5,\r\n \"batch\": \"WA00135\",\r\n \"expire\": \"2023-08-24\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/SendInventory"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/json;charset=ISO-8859-1"},{"key":"content-length","value":"302"},{"key":"date","value":"Mon, 12 Oct 2026 06:50:39 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"RESPONSE\": {\n \"DISTRIBUTOR_TIN\": 999000025,\n \"MESSAGE\": {\n \"flag\": \"INVENTORY\",\n \"ysdcrecnum\": \"\",\n \"num\": \"INV000123\",\n \"ysdcid\": \"SDC009000056\",\n \"ysdcintdata\": \"\",\n \"ysdcmrc\": \"VALG01VNA08\",\n \"ysdcitems\": 2,\n \"ysdcmrctim\": \"2026-10-12 08:50:39\",\n \"ysdcregsig\": \"\",\n \"ysdctime\": \"2026-10-12 08:50:39\"\n },\n \"STATUS\": \"SUCCESS\",\n \"QR_CODE\": \"\"\n }\n}"}],"_postman_id":"6090fe57-f20b-4d64-bc64-a73a72d3ca02"},{"name":"Stock Transfer— XML","id":"e597fb1c-c766-4b13-919a-4e02e4afa740","request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="}],"body":{"mode":"raw","raw":"\r\n 999000025\r\n TR-KIT-0002\r\n stockkeeper\r\n 2026-10-08\r\n PRINCIPAL DRY\r\n Kitchen\r\n 29500\r\n 4500\r\n 2\r\n\r\n \r\n RICE-25KG\r\n Rice 25kg bag\r\n 2\r\n 10000\r\n B\r\n 3050.85\r\n DRY GOODS\r\n \r\n\r\n \r\n OIL-20L\r\n Cooking oil 20L jerrican\r\n 1\r\n 9500\r\n B\r\n 1449.15\r\n DRY GOODS\r\n \r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/StockTransfer","urlObject":{"protocol":"http","port":"8080","path":["vsdc","v1","StockTransfer"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"6688b77e-0bbb-46a3-85f6-4de67829c7a2","name":"Stock Transfer— XML","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="}],"body":{"mode":"raw","raw":"\r\n 999000025\r\n TR-KIT-0002\r\n stockkeeper\r\n 2026-10-08\r\n PRINCIPAL DRY\r\n Kitchen\r\n 29500\r\n 4500\r\n 2\r\n\r\n \r\n RICE-25KG\r\n Rice 25kg bag\r\n 2\r\n 10000\r\n B\r\n 3050.85\r\n DRY GOODS\r\n \r\n\r\n \r\n OIL-20L\r\n Cooking oil 20L jerrican\r\n 1\r\n 9500\r\n B\r\n 1449.15\r\n DRY GOODS\r\n \r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/StockTransfer"},"_postman_previewlanguage":"xml","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/xml"},{"key":"content-length","value":"130"},{"key":"date","value":"Thu, 08 Oct 2026 17:01:15 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"\n null\nSUCCESS\n null\nTR-KIT-0002\n"}],"_postman_id":"e597fb1c-c766-4b13-919a-4e02e4afa740"},{"name":"Stock Transfer— JSON","id":"093b50dc-4987-44e8-aea6-b5c685d15313","request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="}],"body":{"mode":"raw","raw":"{\r\n \"request\": {\r\n \"companyTin\": \"999000025\",\r\n \"reference\": \"TR-KIT-0003\",\r\n \"userName\": \"stockkeeper\",\r\n \"requestDate\": \"2026-10-08\",\r\n \"sourceWarehouse\": \"PRINCIPAL DRY\",\r\n \"destinationWarehouse\": \"Kitchen\",\r\n \"totalAmount\": 29500,\r\n \"totalVat\": 4500,\r\n \"itemsCount\": 2,\r\n \"items\": [\r\n {\r\n \"itemCode\": \"RICE-25KG\",\r\n \"description\": \"Rice 25kg bag\",\r\n \"quantity\": 2,\r\n \"unitPrice\": 10000,\r\n \"taxCode\": \"B\",\r\n \"vatAmount\": 3050.85,\r\n \"itemCategory\": \"DRY GOODS\"\r\n },\r\n {\r\n \"itemCode\": \"OIL-20L\",\r\n \"description\": \"Cooking oil 20L jerrican\",\r\n \"quantity\": 1,\r\n \"unitPrice\": 9500,\r\n \"taxCode\": \"B\",\r\n \"vatAmount\": 1449.15,\r\n \"itemCategory\": \"DRY GOODS\"\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/StockTransfer","urlObject":{"protocol":"http","port":"8080","path":["vsdc","v1","StockTransfer"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"0b3f206a-907f-42ed-9ed2-9cf1839bac84","name":"Stock Transfer— JSON","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="}],"body":{"mode":"raw","raw":"{\r\n \"request\": {\r\n \"companyTin\": \"999000025\",\r\n \"reference\": \"TR-KIT-0003\",\r\n \"userName\": \"stockkeeper\",\r\n \"requestDate\": \"2026-10-08\",\r\n \"sourceWarehouse\": \"PRINCIPAL DRY\",\r\n \"destinationWarehouse\": \"Kitchen\",\r\n \"totalAmount\": 29500,\r\n \"totalVat\": 4500,\r\n \"itemsCount\": 2,\r\n \"items\": [\r\n {\r\n \"itemCode\": \"RICE-25KG\",\r\n \"description\": \"Rice 25kg bag\",\r\n \"quantity\": 2,\r\n \"unitPrice\": 10000,\r\n \"taxCode\": \"B\",\r\n \"vatAmount\": 3050.85,\r\n \"itemCategory\": \"DRY GOODS\"\r\n },\r\n {\r\n \"itemCode\": \"OIL-20L\",\r\n \"description\": \"Cooking oil 20L jerrican\",\r\n \"quantity\": 1,\r\n \"unitPrice\": 9500,\r\n \"taxCode\": \"B\",\r\n \"vatAmount\": 1449.15,\r\n \"itemCategory\": \"DRY GOODS\"\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/StockTransfer"},"_postman_previewlanguage":"json","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/json"},{"key":"content-length","value":"88"},{"key":"date","value":"Thu, 08 Oct 2026 17:04:40 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"RESPONSE\": {\n \"MESSAGE\": null,\n \"STATUS\": \"SUCCESS\",\n \"TAXPAYER_TIN\": null,\n \"NUM\": \"TR-KIT-0003\"\n }\n}"}],"_postman_id":"093b50dc-4987-44e8-aea6-b5c685d15313"}],"id":"2fb657a4-5c49-4df6-8530-a24438355d5f","description":"

Submit physical inventory for existing items.

\n","_postman_id":"2fb657a4-5c49-4df6-8530-a24438355d5f"},{"name":"04 - Purchases","item":[{"name":"Submit Purchase — JSON","id":"6f4c68ca-8876-45f4-a6bb-5218599fadc5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"companyTin\": \"999000025\",\r\n \"currency\": \"RWF\",\r\n \"exchangeRate\": 1.0,\r\n \"purchaseNumber\": \"1225299-ZR00134\",\r\n \"userName\": \"Kofi Ghana\",\r\n \"flag\": \"PURCHASE\",\r\n \"totalVat\": 159.0000,\r\n \"transactionDate\": \"2023-07-17T00:00:00Z\",\r\n \"totalAmount\": 4219.0000,\r\n \"voucherAmount\": 0.0,\r\n \"businessPartnerName\": \"China Mall\",\r\n \"businessPartnerTin\": \"100000001\",\r\n \"saleType\": \"NORMAL\",\r\n \"discountType\": null,\r\n \"discountAmount\": 0.0,\r\n \"sdcreference\": \"sdc/1234\",\r\n \"groupReferenceId\": \"\",\r\n \"items\": [\r\n {\r\n \"itemCode\": \"CODE00WER3455\",\r\n \"itemCategory\": \"\",\r\n \"expireDate\": \"\",\r\n \"description\": \"JACK DANIELS\",\r\n \"quantity\": 10.0,\r\n \"discountAmount\": 0.0,\r\n \"taxCode\": \"B\",\r\n \"batchCode\": \"\",\r\n \"unitPrice\": 121.9000,\r\n \"taxRate\": 18.00\r\n },\r\n {\r\n \"itemCode\": \"CHANDRA8091\",\r\n \"itemCategory\": \"\",\r\n \"expireDate\": \"\",\r\n \"description\": \"ROD-CONN, STABIRIO RH1\",\r\n \"quantity\": 10.0,\r\n \"taxCode\": \"A\",\r\n \"batchCode\": \"\",\r\n \"unitPrice\": 200,\r\n \"taxRate\": 0.00\r\n },\r\n {\r\n \"itemCode\": \"CHai098i01\",\r\n \"itemCategory\": \"\",\r\n \"expireDate\": \"\",\r\n \"description\": \"ROD-CONN, STAB RH\",\r\n \"quantity\": 10.0,\r\n \"taxCode\": \"B\",\r\n \"batchCode\": \"\",\r\n \"unitPrice\": 100,\r\n \"taxRate\": 18.00\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/SendPurchase","description":"

Registers a purchase (JSON). For: any taxpayer recording stock-in purchases. taxRate is the whole percentage (18 for 18%); per-line taxCode drives the tax banding.

\n","urlObject":{"path":["vsdc","v1","SendPurchase"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"de53cd7e-b276-4842-ac8d-1919a4206e41","name":"SUCCESSFULL RESPONSE","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="}],"body":{"mode":"raw","raw":"{\r\n \"currency\": \"RWF\",\r\n \"companyTin\": \"999000025\",\r\n \"exchangeRate\": 1,\r\n \"purchaseNumber\": \"1225299-ZR00138\",\r\n \"userName\": \"Kofi Ghana\",\r\n \"flag\": \"PURCHASE\",\r\n \"totalVat\": 18,\r\n \"transactionDate\": \"2023-07-17T00:00:00Z\",\r\n \"totalAmount\": 2118,\r\n \"voucherAmount\": 0,\r\n \"businessPartnerName\": \"China Mall\",\r\n \"businessPartnerTin\": \"100000001\",\r\n \"saleType\": \"NORMAL\",\r\n \"discountType\": \"\",\r\n \"discountAmount\": 0,\r\n \"sdcreference\": \"sdc/1234\",\r\n \"groupReferenceId\": \"\",\r\n \"items\": [\r\n {\r\n \"itemCode\": \"CODE00WER3455\",\r\n \"itemCategory\": \"\",\r\n \"expireDate\": \"\",\r\n \"description\": \"JACK DANIELS\",\r\n \"quantity\": 1,\r\n \"discountAmount\": 0,\r\n \"taxCode\": \"B\",\r\n \"batchCode\": \"\",\r\n \"unitPrice\": 118,\r\n \"taxRate\": 18\r\n },\r\n {\r\n \"itemCode\": \"CHANDRA8091\",\r\n \"itemCategory\": \"\",\r\n \"expireDate\": \"\",\r\n \"description\": \"ROD-CONN, STABIRIO RH1\",\r\n \"quantity\": 10,\r\n \"taxCode\": \"A\",\r\n \"batchCode\": \"\",\r\n \"unitPrice\": 200,\r\n \"taxRate\": 0\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/SendPurchase"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Content-Length","value":"307"},{"key":"Date","value":"Tue, 24 Feb 2026 09:15:59 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"RESPONSE\": {\n \"DISTRIBUTOR_TIN\": 999000025,\n \"MESSAGE\": {\n \"flag\": \"PURCHASE\",\n \"ysdcrecnum\": \"\",\n \"num\": \"1225299-ZR00138\",\n \"ysdcid\": \"SDC009000057\",\n \"ysdcintdata\": \"\",\n \"ysdcmrc\": \"VALG01VNA08\",\n \"ysdcitems\": 2,\n \"ysdcmrctim\": \"2026-02-24 11:15:59\",\n \"ysdcregsig\": \"\",\n \"ysdctime\": \"2026-02-24 11:15:59\"\n },\n \"STATUS\": \"SUCCESS\",\n \"QR_CODE\": \"\"\n }\n}"},{"id":"fd66789b-82ae-45d3-84ba-1533ead9b3c5","name":"ERRORED RESPONSE","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="}],"body":{"mode":"raw","raw":"{\r\n \"currency\": \"RWF\",\r\n \"companyTin\": \"999000025\",\r\n \"exchangeRate\": 1,\r\n \"purchaseNumber\": \"1225299-ZR00138\",\r\n \"userName\": \"Kofi Ghana\",\r\n \"flag\": \"PURCHASE\",\r\n \"totalVat\": 18,\r\n \"transactionDate\": \"2023-07-17T00:00:00Z\",\r\n \"totalAmount\": 2118,\r\n \"voucherAmount\": 0,\r\n \"businessPartnerName\": \"China Mall\",\r\n \"businessPartnerTin\": \"100000001\",\r\n \"saleType\": \"NORMAL\",\r\n \"discountType\": \"\",\r\n \"discountAmount\": 0,\r\n \"sdcreference\": \"sdc/1234\",\r\n \"groupReferenceId\": \"\",\r\n \"items\": [\r\n {\r\n \"itemCode\": \"CODE00WER3455\",\r\n \"itemCategory\": \"\",\r\n \"expireDate\": \"\",\r\n \"description\": \"JACK DANIELS\",\r\n \"quantity\": 1,\r\n \"discountAmount\": 0,\r\n \"taxCode\": \"B\",\r\n \"batchCode\": \"\",\r\n \"unitPrice\": 118,\r\n \"taxRate\": 18\r\n },\r\n {\r\n \"itemCode\": \"CHANDRA8091\",\r\n \"itemCategory\": \"\",\r\n \"expireDate\": \"\",\r\n \"description\": \"ROD-CONN, STABIRIO RH1\",\r\n \"quantity\": 10,\r\n \"taxCode\": \"A\",\r\n \"batchCode\": \"\",\r\n \"unitPrice\": 200,\r\n \"taxRate\": 0\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/SendPurchase"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Content-Length","value":"131"},{"key":"Date","value":"Tue, 24 Feb 2026 09:16:53 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"RESPONSE\": {\n \"MESSAGE\": \"Purchase Aleady Exist\",\n \"STATUS\": \"ERROR\",\n \"TAXPAYER_TIN\": 999000025,\n \"NUM\": \"1225299-ZR00138\",\n \"ERROR_CODE\": 400\n }\n}"}],"_postman_id":"6f4c68ca-8876-45f4-a6bb-5218599fadc5"},{"name":"Submit Purchase — XML","id":"6ff5adef-6e99-4fda-9fa1-d67cb7cdbb72","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/xml","type":"text"}],"body":{"mode":"raw","raw":"\r\n999000025\r\nRWF\r\n1\r\n1225299-ZR0013\r\nKofi Ghana\r\nPURCHASE\r\n159\r\n2023-07-17T00:00:00Z\r\n4219\r\n0\r\nChina Mall\r\n100000001\r\nNORMAL\r\n\r\n0\r\nsdc/1234\r\n\r\n\r\n CODE00WER3455\r\n \r\n \r\n JACK DANIELS\r\n 10\r\n 0\r\n B\r\n \r\n 121.9\r\n 18\r\n\r\n\r\n CHANDRA8091\r\n \r\n \r\n ROD-CONN, STABIRIO RH1\r\n 10\r\n A\r\n \r\n 200\r\n 0\r\n\r\n\r\n CHai098i01\r\n \r\n \r\n ROD-CONN, STAB RH\r\n 10\r\n B\r\n \r\n 100\r\n 18\r\n\r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/SendPurchase","description":"

Registers a purchase (XML). For: any taxpayer recording stock-in purchases. Same fields as the JSON variant - repeat blocks per purchased line.

\n","urlObject":{"path":["vsdc","v1","SendPurchase"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"f05bd550-91d5-445b-8e61-77776f63194b","name":"SUCCESSFULL RESPONSE","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"\r\n999000025\r\nRWF\r\n1\r\n1225299-ZR0013\r\nKofi Ghana\r\nPURCHASE\r\n159\r\n2023-07-17T00:00:00Z\r\n4219\r\n0\r\nChina Mall\r\n100000001\r\nNORMAL\r\n\r\n0\r\nsdc/1234\r\n\r\n\r\n CODE00WER3455\r\n \r\n \r\n JACK DANIELS\r\n 10\r\n 0\r\n B\r\n \r\n 121.9\r\n 18\r\n\r\n\r\n CHANDRA8091\r\n \r\n \r\n ROD-CONN, STABIRIO RH1\r\n 10\r\n A\r\n \r\n 200\r\n 0\r\n\r\n\r\n CHai098i01\r\n \r\n \r\n ROD-CONN, STAB RH\r\n 10\r\n B\r\n \r\n 100\r\n 18\r\n\r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/SendPurchase"},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"RateLimit-Limit","value":"100"},{"key":"RateLimit-Remaining","value":"98"},{"key":"X-RateLimit-Limit","value":"100"},{"key":"X-RateLimit-Remaining","value":"98"},{"key":"Content-Type","value":"application/xml","description":"","type":"text"},{"key":"Content-Length","value":"417"},{"key":"Date","value":"Mon, 11 May 2026 14:47:24 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"\n 999000025\n SUCCESS\n \n 1225299-ZR0013\n PURCHASE\n SDC009000057\n \n \n 3\n \n VALG01VNA08\n 2026-05-11 16:47:24\n 2026-05-11 16:47:24\n \n \n"},{"id":"0d25d7e8-8818-4763-9858-04fed76e8e82","name":"ERRORED RESPONSE","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"\r\n999000025\r\nRWF\r\n1\r\n1225299-ZR0013\r\nKofi Ghana\r\nPURCHASE\r\n159\r\n2023-07-17T00:00:00Z\r\n4219\r\n0\r\nChina Mall\r\n100000001\r\nNORMAL\r\n\r\n0\r\nsdc/1234\r\n\r\n\r\n CODE00WER3455\r\n \r\n \r\n JACK DANIELS\r\n 10\r\n 0\r\n B\r\n \r\n 121.9\r\n 18\r\n\r\n\r\n CHANDRA8091\r\n \r\n \r\n ROD-CONN, STABIRIO RH1\r\n 10\r\n A\r\n \r\n 200\r\n 0\r\n\r\n\r\n CHai098i01\r\n \r\n \r\n ROD-CONN, STAB RH\r\n 10\r\n B\r\n \r\n 100\r\n 18\r\n\r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/SendPurchase"},"status":"Bad Request","code":400,"_postman_previewlanguage":"xml","header":[{"key":"RateLimit-Limit","value":"100"},{"key":"RateLimit-Remaining","value":"99"},{"key":"X-RateLimit-Limit","value":"100"},{"key":"X-RateLimit-Remaining","value":"99"},{"key":"Content-Type","value":"application/xml","description":"","type":"text"},{"key":"Content-Length","value":"182"},{"key":"Date","value":"Mon, 11 May 2026 14:49:12 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"\n 999000025\n ERROR\n 400\n Purchase Aleady Exist\n 1225299-ZR0013\n"}],"_postman_id":"6ff5adef-6e99-4fda-9fa1-d67cb7cdbb72"}],"id":"f8aaf880-4499-48ae-95a8-15ce806624ae","description":"

Submit purchase records for stock-in transactions.

\n","_postman_id":"f8aaf880-4499-48ae-95a8-15ce806624ae"},{"name":"05 - General Invoicing","item":[{"name":"Issue General Invoice — JSON","id":"f6281136-ae4f-4f2d-a86a-0abffbfed448","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{ \"companyTin\":\"999000025\",\r\n \"calculationType\": \"INCLUSIVE\",\r\n \"fileName\": \"\",\r\n \"flag\": \"INVOICE\",\r\n \"saleType\": \"NORMAL\",\r\n \"voucherAmount\": \"\",\r\n \"discountAmount\": \"\",\r\n \"businessPartnerName\": \"Client\",\r\n \"invoiceDate\": \"2023-04-19\",\r\n \"userName\": \"sapUser\",\r\n \"itemsCount\": \"1\",\r\n \"clientTin\": \"100000002\",\r\n \"totalAmount\": \"118\",\r\n \"totalVat\": \"18\",\r\n \"clientTinPin\": \"\",\r\n \"exchangeRate\": \"1\",\r\n \"invoiceNumber\": \"SAP12320t01\",\r\n \"callback\": \"\",\r\n \"currency\": \"RWF\",\r\n \"discountType\": \"\",\r\n \"items\": [{\r\n \"unitPrice\": \"118\",\r\n \"quantity\": \"1\",\r\n \"itemCategory\": \"\",\r\n \"itemCode\": \"000020\",\r\n \"batch\": \"\",\r\n \"description\": \"MANGODB\",\r\n \"discount\": \"0\",\r\n \"taxCode\": \"B\",\r\n \"taxRate\": \"18\",\r\n \"expire\": \"\"\r\n }]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/Receipt","description":"

Non-fuel invoice (JSON). For: all taxpayers issuing sales receipts. calculationType describes the UNIT PRICE basis: INCLUSIVE = unitPrice already contains VAT; EXCLUSIVE = unitPrice is the net price and VAT is added on top. totalAmount is ALWAYS the VAT-inclusive receipt total; totalVat must equal the computed VAT (else invalid_total_vat).

\n","urlObject":{"path":["vsdc","v1","Receipt"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"07e7c1fc-4c50-4809-a7af-a7b4c99df725","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"","value":"","disabled":true},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{ \"companyTin\":\"999000025\",\r\n \"calculationType\": \"INCLUSIVE\",\r\n \"fileName\": \"\",\r\n \"flag\": \"INVOICE\",\r\n \"saleType\": \"NORMAL\",\r\n \"voucherAmount\": \"\",\r\n \"discountAmount\": \"\",\r\n \"businessPartnerName\": \"Client\",\r\n \"invoiceDate\": \"2023-04-19\",\r\n \"userName\": \"sapUser\",\r\n \"itemsCount\": \"1\",\r\n \"clientTin\": \"100000002\",\r\n \"totalAmount\": \"118\",\r\n \"totalVat\": \"18\",\r\n \"clientTinPin\": \"\",\r\n \"exchangeRate\": \"1\",\r\n \"invoiceNumber\": \"SAP12320t01\",\r\n \"callback\": \"\",\r\n \"currency\": \"RWF\",\r\n \"discountType\": \"\",\r\n \"items\": [{\r\n \"unitPrice\": \"118\",\r\n \"quantity\": \"1\",\r\n \"itemCategory\": \"\",\r\n \"itemCode\": \"000020\",\r\n \"batch\": \"\",\r\n \"description\": \"MANGODB\",\r\n \"discount\": \"0\",\r\n \"taxCode\": \"B\",\r\n \"taxRate\": \"18\",\r\n \"expire\": \"\"\r\n }]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/Receipt"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/json;charset=ISO-8859-1"},{"key":"content-length","value":"449"},{"key":"date","value":"Mon, 12 Oct 2026 05:40:02 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"RESPONSE\": {\n \"DISTRIBUTOR_TIN\": 999000025,\n \"MESSAGE\": {\n \"flag\": \"INVOICE\",\n \"ysdcrecnum\": \"42/42 NS ISH:42\",\n \"num\": \"SAP12320t01\",\n \"ysdcid\": \"SDC009000056\",\n \"ysdcintdata\": \"VBPL-5CTP-62J3-HP2Y-MW2E-V3QC-QU\",\n \"ysdcmrc\": \"VALG01VNA08\",\n \"ysdcitems\": 1,\n \"ysdcmrctim\": \"2026-10-12 07:40:02\",\n \"ysdcregsig\": \"RSQI-MK6D-HBVZ-KGYT\",\n \"ysdctime\": \"2026-10-12 07:40:02\"\n },\n \"STATUS\": \"SUCCESS\",\n \"QR_CODE\": \"2026-10-12 07:40:02#SDC009000056#42#RSQIMK6DHBVZKGYT#VBPL5CTP62J3HP2YMW2EV3QCQU\"\n }\n}"},{"id":"e01ab602-f51b-4c5c-acb8-82a096625563","name":"ERRORED","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"","value":"","disabled":true},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{ \"companyTin\":\"999000025\",\r\n \"calculationType\": \"INCLUSIVE\",\r\n \"fileName\": \"\",\r\n \"flag\": \"INVOICE\",\r\n \"saleType\": \"NORMAL\",\r\n \"voucherAmount\": \"\",\r\n \"discountAmount\": \"\",\r\n \"businessPartnerName\": \"Client\",\r\n \"invoiceDate\": \"2023-04-19\",\r\n \"userName\": \"sapUser\",\r\n \"itemsCount\": \"1\",\r\n \"clientTin\": \"100000002\",\r\n \"totalAmount\": \"118\",\r\n \"totalVat\": \"16\",\r\n \"clientTinPin\": \"\",\r\n \"exchangeRate\": \"1\",\r\n \"invoiceNumber\": \"SAP12320t02\",\r\n \"callback\": \"\",\r\n \"currency\": \"RWF\",\r\n \"discountType\": \"\",\r\n \"items\": [{\r\n \"unitPrice\": \"118\",\r\n \"quantity\": \"1\",\r\n \"itemCategory\": \"\",\r\n \"itemCode\": \"000020\",\r\n \"batch\": \"\",\r\n \"description\": \"MANGODB\",\r\n \"discount\": \"0\",\r\n \"taxCode\": \"B\",\r\n \"taxRate\": \"18\",\r\n \"expire\": \"\"\r\n }]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/Receipt"},"_postman_previewlanguage":"json","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"98"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"98"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/json;charset=ISO-8859-1"},{"key":"content-length","value":"115"},{"key":"date","value":"Mon, 12 Oct 2026 05:43:44 GMT"},{"key":"connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"num\": \"SAP12320t02\",\n \"errors\": [\n \"invalid_total_vat 16.00 #18.00\"\n ],\n \"timestamp\": \"2026-10-12 07:43:44\",\n \"status\": 400\n}"}],"_postman_id":"f6281136-ae4f-4f2d-a86a-0abffbfed448"},{"name":"Issue General Invoice — XML","id":"e318f8f0-ae65-42b5-8ae1-c747707bd185","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="}],"body":{"mode":"raw","raw":"\r\n999000025\r\nINCLUSIVE\r\n\r\nINVOICE\r\nNORMAL\r\n\r\n\r\nClient\r\n2023-04-19\r\nsapUser\r\n1\r\n100000002\r\n118\r\n18\r\n\r\n1\r\nSAP12320t05\r\n\r\nRWF\r\n\r\n\r\n 118\r\n 1\r\n \r\n 000020\r\n \r\n MANGODB\r\n 0\r\n B\r\n 18\r\n \r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/Receipt","description":"

\n","urlObject":{"path":["vsdc","v1","Receipt"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"6c4a2b11-41d2-4f2e-9ea8-5954e79794e9","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"","value":"","disabled":true},{"key":"Content-Type","value":"application/json","disabled":true}],"body":{"mode":"raw","raw":"\r\n999000025\r\nINCLUSIVE\r\n\r\nINVOICE\r\nNORMAL\r\n\r\n\r\nClient\r\n2023-04-19\r\nsapUser\r\n1\r\n100000002\r\n118\r\n18\r\n\r\n1\r\nSAP12320t03\r\n\r\nRWF\r\n\r\n\r\n 118\r\n 1\r\n \r\n 000020\r\n \r\n MANGODB\r\n 0\r\n B\r\n 18\r\n \r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/Receipt"},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/xml;charset=ISO-8859-1"},{"key":"content-length","value":"560"},{"key":"date","value":"Mon, 12 Oct 2026 05:47:32 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"999000025SUCCESSSAP12320t03INVOICESDC009000056PA22-LBS3-RNAG-HK4S-7EE4-ZSQU-DUDID2-X2QI-MOWT-YM22143/43 NS ISH:43VALG01VNA082026-10-12 07:47:322026-10-12 07:47:322026-10-12 07:47:32#SDC009000056#43#DID2X2QIMOWTYM22#PA22LBS3RNAGHK4S7EE4ZSQUDU\r\n"},{"id":"2a7dc71d-06e3-46bc-a874-fbc1696dd8e6","name":"ERRORED","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"","value":"","disabled":true},{"key":"Content-Type","value":"application/json","disabled":true}],"body":{"mode":"raw","raw":"\r\n999000025\r\nINCLUSIVE\r\n\r\nINVOICE\r\nNORMAL\r\n\r\n\r\nClient\r\n2023-04-19\r\nsapUser\r\n1\r\n100000002\r\n118\r\n16\r\n\r\n1\r\nSAP12320t04\r\n\r\nRWF\r\n\r\n\r\n 118\r\n 1\r\n \r\n 000020\r\n \r\n MANGODB\r\n 0\r\n B\r\n 18\r\n \r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/Receipt"},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"98"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"98"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/xml;charset=ISO-8859-1"},{"key":"content-length","value":"115"},{"key":"date","value":"Mon, 12 Oct 2026 05:48:17 GMT"},{"key":"connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\"num\":\"SAP12320t04\",\"errors\":[\"invalid_total_vat 16.00 #18.00\"],\"timestamp\":\"2026-10-12 07:48:17\",\"status\":400}\r\n"}],"_postman_id":"e318f8f0-ae65-42b5-8ae1-c747707bd185"},{"name":"Issue Invoice — EXCLUSIVE Pricing — JSON","id":"32c2a602-d7a1-4645-ad9b-90488173a7b3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"companyTin\": \"999000025\",\r\n \"calculationType\": \"EXCLUSIVE\",\r\n \"flag\": \"INVOICE\",\r\n \"saleType\": \"NORMAL\",\r\n \"invoiceNumber\": \"INV-EXCL-001\",\r\n \"invoiceDate\": \"2026-10-08\",\r\n \"userName\": \"posUser\",\r\n \"itemsCount\": \"1\",\r\n \"businessPartnerName\": \"CLIENT NAME\",\r\n \"currency\": \"RWF\",\r\n \"totalAmount\": \"1180\",\r\n \"totalVat\": \"180\",\r\n \"items\": [\r\n {\r\n \"itemCode\": \"SVC001\",\r\n \"description\": \"SERVICE ITEM\",\r\n \"quantity\": \"10\",\r\n \"unitPrice\": \"100\",\r\n \"taxCode\": \"B\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/Receipt","description":"

EXCLUSIVE example: unitPrice 100 is the NET price; the service adds VAT -> line total 1180. totalAmount is still the inclusive total (1180) and totalVat is the computed VAT (180).

\n","urlObject":{"path":["vsdc","v1","Receipt"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"d535651f-db53-4003-a8b4-f6d7ef8191fd","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{ \"companyTin\":\"999000025\",\r\n \"calculationType\": \"EXCLUSIVE\",\r\n \"fileName\": \"\",\r\n \"flag\": \"INVOICE\",\r\n \"saleType\": \"NORMAL\",\r\n \"voucherAmount\": \"\",\r\n \"discountAmount\": \"\",\r\n \"businessPartnerName\": \"Client\",\r\n \"invoiceDate\": \"2023-04-19\",\r\n \"userName\": \"sapUser\",\r\n \"itemsCount\": \"1\",\r\n \"clientTin\": \"100000002\",\r\n \"totalAmount\": \"118\",\r\n \"totalVat\": \"18\",\r\n \"clientTinPin\": \"\",\r\n \"exchangeRate\": \"1\",\r\n \"invoiceNumber\": \"SAP12320t06\",\r\n \"callback\": \"\",\r\n \"currency\": \"RWF\",\r\n \"discountType\": \"\",\r\n \"items\": [{\r\n \"unitPrice\": \"100\",\r\n \"quantity\": \"1\",\r\n \"itemCategory\": \"\",\r\n \"itemCode\": \"000020\",\r\n \"batch\": \"\",\r\n \"description\": \"MANGODB\",\r\n \"discount\": \"0\",\r\n \"taxCode\": \"B\",\r\n \"taxRate\": \"18\",\r\n \"expire\": \"\"\r\n }]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/Receipt"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/json;charset=ISO-8859-1"},{"key":"content-length","value":"449"},{"key":"date","value":"Mon, 12 Oct 2026 05:59:28 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"RESPONSE\": {\n \"DISTRIBUTOR_TIN\": 999000025,\n \"MESSAGE\": {\n \"flag\": \"INVOICE\",\n \"ysdcrecnum\": \"45/45 NS ISH:45\",\n \"num\": \"SAP12320t06\",\n \"ysdcid\": \"SDC009000056\",\n \"ysdcintdata\": \"DRT3-6VBA-U3SG-6QIZ-3EWW-S2WS-DE\",\n \"ysdcmrc\": \"VALG01VNA08\",\n \"ysdcitems\": 1,\n \"ysdcmrctim\": \"2026-10-12 07:59:28\",\n \"ysdcregsig\": \"PSSD-W5PH-35MJ-VLNK\",\n \"ysdctime\": \"2026-10-12 07:59:28\"\n },\n \"STATUS\": \"SUCCESS\",\n \"QR_CODE\": \"2026-10-12 07:59:28#SDC009000056#45#PSSDW5PH35MJVLNK#DRT36VBAU3SG6QIZ3EWWS2WSDE\"\n }\n}"}],"_postman_id":"32c2a602-d7a1-4645-ad9b-90488173a7b3"},{"name":"Issue Invoice — EXCLUSIVE Pricing — XML","id":"d96a8f61-2d64-4db9-a2ee-0a247eee65d2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="}],"body":{"mode":"raw","raw":"\r\n999000025\r\nEXCLUSIVE\r\n\r\nINVOICE\r\nNORMAL\r\n\r\n\r\nClient\r\n2023-04-19\r\nsapUser\r\n1\r\n100000002\r\n118\r\n18\r\n\r\n1\r\nSAP12320t07\r\n\r\nRWF\r\n\r\n\r\n 100\r\n 1\r\n \r\n 000020\r\n \r\n MANGODB\r\n 0\r\n B\r\n 18\r\n \r\n\r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/Receipt","description":"

EXCLUSIVE example: unitPrice 100 is the NET price; the service adds VAT -> line total 1180. totalAmount is still the inclusive total (1180) and totalVat is the computed VAT (180).

\n","urlObject":{"path":["vsdc","v1","Receipt"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"ceab6e86-d218-4b77-9782-861c6b23cb9b","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/json","disabled":true}],"body":{"mode":"raw","raw":"\r\n999000025\r\nEXCLUSIVE\r\n\r\nINVOICE\r\nNORMAL\r\n\r\n\r\nClient\r\n2023-04-19\r\nsapUser\r\n1\r\n100000002\r\n118\r\n18\r\n\r\n1\r\nSAP12320t07\r\n\r\nRWF\r\n\r\n\r\n 100\r\n 1\r\n \r\n 000020\r\n \r\n MANGODB\r\n 0\r\n B\r\n 18\r\n \r\n\r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/Receipt"},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/xml;charset=ISO-8859-1"},{"key":"content-length","value":"560"},{"key":"date","value":"Mon, 12 Oct 2026 06:01:38 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"999000025SUCCESSSAP12320t07INVOICESDC009000056M7WU-PM3L-IHOS-MZA6-SFZM-MW5M-XQ6UF3-L365-IFM3-DKC7146/46 NS ISH:46VALG01VNA082026-10-12 08:01:382026-10-12 08:01:382026-10-12 08:01:38#SDC009000056#46#6UF3L365IFM3DKC7#M7WUPM3LIHOSMZA6SFZMMW5MXQ\r\n"}],"_postman_id":"d96a8f61-2d64-4db9-a2ee-0a247eee65d2"},{"name":"Issue General Proforma— JSON","id":"0bb71bf3-b9c4-43eb-a0ec-1376f69cd306","request":{"method":"POST","header":[],"url":"","urlObject":{"query":[],"variable":[]}},"response":[{"id":"b8acea78-d750-4d19-bc02-3ec7dc0d9ab0","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="}],"body":{"mode":"raw","raw":"{ \"companyTin\":\"999000025\",\r\n \"calculationType\": \"INCLUSIVE\",\r\n \"fileName\": \"\",\r\n \"flag\": \"PROFORMA\",\r\n \"saleType\": \"NORMAL\",\r\n \"voucherAmount\": \"\",\r\n \"discountAmount\": \"\",\r\n \"businessPartnerName\": \"Client\",\r\n \"invoiceDate\": \"2023-04-19\",\r\n \"userName\": \"sapUser\",\r\n \"itemsCount\": \"1\",\r\n \"clientTin\": \"100000002\",\r\n \"totalAmount\": \"118\",\r\n \"totalVat\": \"18\",\r\n \"clientTinPin\": \"\",\r\n \"exchangeRate\": \"1\",\r\n \"invoiceNumber\": \"SAP12320t01\",\r\n \"callback\": \"\",\r\n \"currency\": \"RWF\",\r\n \"discountType\": \"\",\r\n \"items\": [{\r\n \"unitPrice\": \"118\",\r\n \"quantity\": \"1\",\r\n \"itemCategory\": \"\",\r\n \"itemCode\": \"000020\",\r\n \"batch\": \"\",\r\n \"description\": \"MANGODB\",\r\n \"discount\": \"0\",\r\n \"taxCode\": \"B\",\r\n \"taxRate\": \"18\",\r\n \"expire\": \"\"\r\n }]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/Receipt"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/json;charset=ISO-8859-1"},{"key":"content-length","value":"359"},{"key":"date","value":"Mon, 12 Oct 2026 06:32:50 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"RESPONSE\": {\n \"DISTRIBUTOR_TIN\": 999000025,\n \"MESSAGE\": {\n \"flag\": \"PROFORMA\",\n \"ysdcrecnum\": \"1/47 PS ISH:47\",\n \"num\": \"SAP12320t01\",\n \"ysdcid\": \"SDC009000056\",\n \"ysdcintdata\": \"#\",\n \"ysdcmrc\": \"VALG01VNA08\",\n \"ysdcitems\": 1,\n \"ysdcmrctim\": \"2026-10-12 08:32:50\",\n \"ysdcregsig\": \"#\",\n \"ysdctime\": \"2026-10-12 08:32:50\"\n },\n \"STATUS\": \"SUCCESS\",\n \"QR_CODE\": \"2026-10-12 08:32:50#SDC009000056#1####\"\n }\n}"}],"_postman_id":"0bb71bf3-b9c4-43eb-a0ec-1376f69cd306"},{"name":"Issue General Proforma— XML","id":"e08d568c-7ebf-44c0-9e4e-18f7b72497d7","request":{"method":"POST","header":[],"url":"","urlObject":{"query":[],"variable":[]}},"response":[{"id":"e1614b48-c7df-49b4-b155-f46681b3d092","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="}],"body":{"mode":"raw","raw":"\r\n999000025\r\nINCLUSIVE\r\n\r\nPROFORMA\r\nNORMAL\r\n\r\n\r\nClient\r\n2023-04-19\r\nsapUser\r\n1\r\n100000002\r\n118\r\n18\r\n\r\n1\r\nSAP12320t02\r\n\r\nRWF\r\n\r\n\r\n 118\r\n 1\r\n \r\n 000020\r\n \r\n MANGODB\r\n 0\r\n B\r\n 18\r\n \r\n\r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/Receipt"},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/xml;charset=ISO-8859-1"},{"key":"content-length","value":"470"},{"key":"date","value":"Mon, 12 Oct 2026 06:38:14 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"999000025SUCCESSSAP12320t02PROFORMASDC009000056##12/48 PS ISH:48VALG01VNA082026-10-12 08:38:142026-10-12 08:38:142026-10-12 08:38:14#SDC009000056#2####\r\n"}],"_postman_id":"e08d568c-7ebf-44c0-9e4e-18f7b72497d7"},{"name":"Issue General REFUND— JSON","id":"ea9f48b2-535d-41fc-9b19-a280d74bd284","request":{"method":"POST","header":[],"url":"","urlObject":{"query":[],"variable":[]}},"response":[{"id":"69bcd546-3053-48af-9ccd-90f2a5e96091","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="}],"body":{"mode":"raw","raw":"{ \"companyTin\":\"999000025\",\r\n \"calculationType\": \"INCLUSIVE\",\r\n \"fileName\": \"\",\r\n \"flag\": \"REFUND\",\r\n \"saleType\": \"NORMAL\",\r\n \"voucherAmount\": \"\",\r\n \"discountAmount\": \"\",\r\n \"businessPartnerName\": \"Client\",\r\n \"invoiceDate\": \"2023-04-19\",\r\n \"userName\": \"sapUser\",\r\n \"itemsCount\": \"1\",\r\n \"clientTin\": \"100000002\",\r\n \"totalAmount\": \"118\",\r\n \"totalVat\": \"18\",\r\n \"clientTinPin\": \"\",\r\n \"exchangeRate\": \"1\",\r\n \"invoiceNumber\": \"SAP12320t01\",\r\n \"callback\": \"\",\r\n \"currency\": \"RWF\",\r\n \"discountType\": \"\",\r\n \"items\": [{\r\n \"unitPrice\": \"118\",\r\n \"quantity\": \"1\",\r\n \"itemCategory\": \"\",\r\n \"itemCode\": \"000020\",\r\n \"batch\": \"\",\r\n \"description\": \"MANGODB\",\r\n \"discount\": \"0\",\r\n \"taxCode\": \"B\",\r\n \"taxRate\": \"18\",\r\n \"expire\": \"\"\r\n }]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/Receipt"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/json;charset=ISO-8859-1"},{"key":"content-length","value":"448"},{"key":"date","value":"Mon, 12 Oct 2026 06:41:13 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"RESPONSE\": {\n \"DISTRIBUTOR_TIN\": 999000025,\n \"MESSAGE\": {\n \"flag\": \"REFUND\",\n \"ysdcrecnum\": \"47/49 NR ISH:49\",\n \"num\": \"SAP12320t01\",\n \"ysdcid\": \"SDC009000056\",\n \"ysdcintdata\": \"OXL4-KCXQ-3N7N-7OHN-D4U3-MNFF-RQ\",\n \"ysdcmrc\": \"VALG01VNA08\",\n \"ysdcitems\": 1,\n \"ysdcmrctim\": \"2026-10-12 08:41:13\",\n \"ysdcregsig\": \"CZO4-KT7O-WHNN-6NFL\",\n \"ysdctime\": \"2026-10-12 08:41:13\"\n },\n \"STATUS\": \"SUCCESS\",\n \"QR_CODE\": \"2026-10-12 08:41:13#SDC009000056#47#CZO4KT7OWHNN6NFL#OXL4KCXQ3N7N7OHND4U3MNFFRQ\"\n }\n}"}],"_postman_id":"ea9f48b2-535d-41fc-9b19-a280d74bd284"},{"name":"Issue General REFUND— XML","id":"c613208e-255e-48bf-b9a0-68886044a303","request":{"method":"POST","header":[],"url":"","urlObject":{"query":[],"variable":[]}},"response":[{"id":"49581113-3e53-421b-999b-75364ba4cfe0","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="}],"body":{"mode":"raw","raw":"\r\n999000025\r\nINCLUSIVE\r\n\r\nREFUND\r\nNORMAL\r\n\r\n\r\nClient\r\n2023-04-19\r\nsapUser\r\n1\r\n100000002\r\n118\r\n18\r\n\r\n1\r\nSAP12320t05\r\n\r\nRWF\r\n\r\n\r\n 118\r\n 1\r\n \r\n 000020\r\n \r\n MANGODB\r\n 0\r\n B\r\n 18\r\n \r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/Receipt"},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/xml;charset=ISO-8859-1"},{"key":"content-length","value":"559"},{"key":"date","value":"Mon, 12 Oct 2026 06:43:18 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"999000025SUCCESSSAP12320t05REFUNDSDC009000056UYU6-7FCF-IXM7-ZHIY-TETX-MAGF-XI6VSC-ED5H-H7QR-Y6NR148/50 NR ISH:50VALG01VNA082026-10-12 08:43:172026-10-12 08:43:172026-10-12 08:43:17#SDC009000056#48#6VSCED5HH7QRY6NR#UYU67FCFIXM7ZHIYTETXMAGFXI\r\n"}],"_postman_id":"c613208e-255e-48bf-b9a0-68886044a303"}],"id":"2462ab5e-dfba-4f76-8295-7fab3d660d33","description":"

General sales receipts, including inclusive and exclusive pricing.

\n","_postman_id":"2462ab5e-dfba-4f76-8295-7fab3d660d33"},{"name":"06 - Tourism Levy","item":[{"name":"Issue Tourism Levy Invoice — XML","id":"9e8e73e4-2b02-4514-b41a-e54e870abb9f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"},{"key":"Content-Type","value":"application/xml","type":"text"}],"body":{"mode":"raw","raw":"\r\n\r\n INVOICE\r\n 999000025\r\n posUser\r\n 1\r\n INV-TT-001\r\n 2026-10-08\r\n NORMAL\r\n CLIENT NAME\r\n RWF\r\n 1180\r\n 180\r\n 29.13\r\n INCLUSIVE\r\n \r\n SVC001\r\n ACCOMMODATION 1 NIGHT\r\n 10\r\n 118\r\n B\r\n 3\r\n \r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/Receipt","description":"

Tourism-tax invoice (XML). For hospitality taxpayers charging the tourism levy: line carries 3 (whole percent) and header holds the computed tourism total

\n","urlObject":{"path":["vsdc","v1","Receipt"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"3a2072a2-40dc-4a23-a9ca-7c1575ecac0f","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/xml"}],"body":{"mode":"raw","raw":"\r\n\r\n INVOICE\r\n 999000025\r\n posUser\r\n 1\r\n INV-TT-001\r\n 2026-10-08\r\n NORMAL\r\n CLIENT NAME\r\n RWF\r\n 1180\r\n 180\r\n 29.13\r\n INCLUSIVE\r\n \r\n SVC001\r\n ACCOMMODATION 1 NIGHT\r\n 10\r\n 118\r\n B\r\n 3\r\n \r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/Receipt"},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/xml;charset=ISO-8859-1"},{"key":"content-length","value":"559"},{"key":"date","value":"Mon, 12 Oct 2026 06:52:56 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"999000025SUCCESSINV-TT-001INVOICESDC0090000567Y4U-5VWA-MKNG-LHT5-6SMX-OS7H-TIXWK3-N7ET-3JD3-OM6T149/51 NS ISH:51VALG01VNA082026-10-12 08:52:562026-10-12 08:52:562026-10-12 08:52:56#SDC009000056#49#XWK3N7ET3JD3OM6T#7Y4U5VWAMKNGLHT56SMXOS7HTI\r\n"}],"_postman_id":"9e8e73e4-2b02-4514-b41a-e54e870abb9f"},{"name":"Issue Tourism Levy Invoice — JSON","id":"2af9b14c-9e21-4967-aea9-f883cf0c5731","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"companyTin\": \"999000025\",\r\n \"calculationType\": \"INCLUSIVE\",\r\n \"flag\": \"INVOICE\",\r\n \"saleType\": \"NORMAL\",\r\n \"invoiceNumber\": \"INV-TT-001\",\r\n \"invoiceDate\": \"2026-10-08\",\r\n \"userName\": \"posUser\",\r\n \"itemsCount\": \"1\",\r\n \"businessPartnerName\": \"CLIENT NAME\",\r\n \"currency\": \"RWF\",\r\n \"totalAmount\": \"1180\",\r\n \"totalVat\": \"180\",\r\n \"totalLevy\": \"29.13\",\r\n \"items\": [\r\n {\r\n \"itemCode\": \"SVC001\",\r\n \"description\": \"ACCOMMODATION 1 NIGHT\",\r\n \"quantity\": \"10\",\r\n \"unitPrice\": \"118\",\r\n \"taxCode\": \"B\",\r\n \"TtaxRate\": \"3\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/Receipt","description":"

Tourism-tax invoice (JSON). Same contract as the XML variant - TtaxRate per line, totalLevy header must equal the computed tourism tax.

\n","urlObject":{"path":["vsdc","v1","Receipt"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"f15b5fdf-0f9b-41b8-8b3a-c39a2def6277","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"companyTin\": \"999000025\",\r\n \"calculationType\": \"INCLUSIVE\",\r\n \"flag\": \"INVOICE\",\r\n \"saleType\": \"NORMAL\",\r\n \"invoiceNumber\": \"INV-TT-002\",\r\n \"invoiceDate\": \"2026-10-08\",\r\n \"userName\": \"posUser\",\r\n \"itemsCount\": \"1\",\r\n \"businessPartnerName\": \"CLIENT NAME\",\r\n \"currency\": \"RWF\",\r\n \"totalAmount\": \"1180\",\r\n \"totalVat\": \"180\",\r\n \"totalLevy\": \"29.13\",\r\n \"items\": [\r\n {\r\n \"itemCode\": \"SVC001\",\r\n \"description\": \"ACCOMMODATION 1 NIGHT\",\r\n \"quantity\": \"10\",\r\n \"unitPrice\": \"118\",\r\n \"taxCode\": \"B\",\r\n \"TtaxRate\": \"3\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/Receipt"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"98"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"98"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/json;charset=ISO-8859-1"},{"key":"content-length","value":"448"},{"key":"date","value":"Mon, 12 Oct 2026 06:53:51 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"RESPONSE\": {\n \"DISTRIBUTOR_TIN\": 999000025,\n \"MESSAGE\": {\n \"flag\": \"INVOICE\",\n \"ysdcrecnum\": \"50/52 NS ISH:52\",\n \"num\": \"INV-TT-002\",\n \"ysdcid\": \"SDC009000056\",\n \"ysdcintdata\": \"NK2J-NWYF-NO2E-57RT-7SFI-RT4X-IE\",\n \"ysdcmrc\": \"VALG01VNA08\",\n \"ysdcitems\": 1,\n \"ysdcmrctim\": \"2026-10-12 08:53:51\",\n \"ysdcregsig\": \"D25B-IYS5-W45U-7WCY\",\n \"ysdctime\": \"2026-10-12 08:53:51\"\n },\n \"STATUS\": \"SUCCESS\",\n \"QR_CODE\": \"2026-10-12 08:53:51#SDC009000056#50#D25BIYS5W45U7WCY#NK2JNWYFNO2E57RT7SFIRT4XIE\"\n }\n}"}],"_postman_id":"2af9b14c-9e21-4967-aea9-f883cf0c5731"}],"id":"9fe371e0-afef-4f74-9b79-f491101273e2","description":"

Hospitality/tourism levy invoice examples.

\n","_postman_id":"9fe371e0-afef-4f74-9b79-f491101273e2"},{"name":"10 - Fuel Product & Mapping","item":[{"name":"Get Fuel Items — XML","id":"f8a0ccff-966d-4c11-bcd0-f7e032c9c9b5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/xml","type":"text"}],"url":"http://localhost:8080/vsdc/v1/getFuelItems","description":"

Returns the RRA-managed fuel product list for your company TIN (item codes, names, regulated prices). For: licensed fuel/petroleum taxpayers only.

\n","urlObject":{"path":["vsdc","v1","getFuelItems"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"10239aa2-4916-4e57-a8e6-be0f34bb723a","name":"SUCCESS","originalRequest":{"method":"GET","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/xml"}],"body":{"mode":"raw","raw":"\r\n999000025","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/getFuelItems"},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"98"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"98"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/xml"},{"key":"content-length","value":"559"},{"key":"date","value":"Mon, 12 Oct 2026 06:56:16 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"\n\nSDC009000056\n999000025\n2026-10-12\n\n Diesel fuel\n 1510150500\n RW-2TYXL10-00001\n F\n 1876.0\n\n\n Gasoline or Petrol\n 1510150600\n RW-2TYXL10-00002\n F\n 1876.0\n\n\n"}],"_postman_id":"f8a0ccff-966d-4c11-bcd0-f7e032c9c9b5"},{"name":"Get Fuel Items — JSON","id":"4330e356-8f73-4374-9c20-09ab13828e08","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"companyTin\": \"999000025\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/getFuelItems","description":"

JSON variant of the fuel product list. For: licensed fuel/petroleum taxpayers only.

\n","urlObject":{"path":["vsdc","v1","getFuelItems"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"95cac64c-c188-420d-84e1-207b3d0e1fb1","name":"SUCCESS","originalRequest":{"method":"POST","header":[],"url":"http://localhost:8080/vsdc/v1/getFuelItems"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"RESPONSE\":{\"STATUS\":\"SUCCESS\",\"MESSAGE\":\"Operation completed\"}}"}],"_postman_id":"4330e356-8f73-4374-9c20-09ab13828e08"},{"name":"Map Fuel Items — XML","id":"1d2231e7-472a-4287-987a-ca242ff84711","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/xml","type":"text"}],"body":{"mode":"raw","raw":"\r\n\r\n 999000025\r\n MA0001\r\n vivo\r\n 2022-09-26\r\n \r\n ENGEN ECODRIVE DIESEL\r\n ENGEN18\r\n F\r\n DIESEL\r\n \r\n \r\n ENGEN ECODRIVE PETROL\r\n ENGEN17\r\n F\r\n PETROL\r\n \r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/mapFuelItem","description":"

Maps your local item codes to RRA fuel products. For: licensed fuel/petroleum taxpayers - must be done before any fuel receipt can be issued. Rules: taxCode must be F, itemCategory must be PETROL or DIESEL. Repeat blocks for several mappings.

\n","urlObject":{"path":["vsdc","v1","mapFuelItem"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"3266b5ef-e476-417c-ae20-5764fbc37df2","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/xml"}],"body":{"mode":"raw","raw":"\r\n\r\n 999000025\r\n MA0001\r\n vivo\r\n 2022-09-26\r\n \r\n ENGEN ECODRIVE DIESEL\r\n ENGEN18\r\n F\r\n DIESEL\r\n \r\n \r\n ENGEN ECODRIVE PETROL\r\n ENGEN17\r\n F\r\n PETROL\r\n \r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/mapFuelItem"},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"95"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"95"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/xml"},{"key":"content-length","value":"654"},{"key":"date","value":"Mon, 12 Oct 2026 06:57:52 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"\n\n999000025\nMA0001\n\n ENGEN18\n ENGEN ECODRIVE DIESEL\n SUCCESS\n RW-2TYXL10-00001\n Diesel fuel\n 1876.0\n\n\n ENGEN17\n ENGEN ECODRIVE PETROL\n SUCCESS\n RW-2TYXL10-00002\n Gasoline or Petrol\n 1876.0\n\nSUCCESS\n\n"}],"_postman_id":"1d2231e7-472a-4287-987a-ca242ff84711"},{"name":"Map Fuel Items — JSON","id":"8e8da492-7b86-4892-bd8d-19c06351858c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"companyTin\": \"999000025\",\r\n \"reference\": \"MA0001\",\r\n \"userName\": \"vivo\",\r\n \"requestDate\": \"2022-09-26\",\r\n \"items\": [\r\n {\r\n \"description\": \"ENGEN ECODRIVE DIESEL\",\r\n \"itemCd\": \"ENGEN18\",\r\n \"taxCode\": \"F\",\r\n \"itemCategory\": \"DIESEL\"\r\n },\r\n {\r\n \"description\": \"ENGEN ECODRIVE PETROL\",\r\n \"itemCd\": \"ENGEN17\",\r\n \"taxCode\": \"F\",\r\n \"itemCategory\": \"PETROL\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/mapFuelItem","description":"

JSON variant of mapFuelItem. For: licensed fuel/petroleum taxpayers. Repeated blocks become a JSON items[] array with the same field names.

\n","urlObject":{"path":["vsdc","v1","mapFuelItem"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"f7b15f7c-c349-42a3-ad46-98e113a1a9e7","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"companyTin\": \"999000025\",\r\n \"reference\": \"MA0002\",\r\n \"userName\": \"vivo\",\r\n \"requestDate\": \"2022-09-26\",\r\n \"items\": [\r\n {\r\n \"description\": \"ENGEN ECODRIVE DIESEL\",\r\n \"itemCd\": \"ENGEN18\",\r\n \"taxCode\": \"F\",\r\n \"itemCategory\": \"DIESEL\"\r\n },\r\n {\r\n \"description\": \"ENGEN ECODRIVE PETROL\",\r\n \"itemCd\": \"ENGEN17\",\r\n \"taxCode\": \"F\",\r\n \"itemCategory\": \"PETROL\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/mapFuelItem"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/json"},{"key":"content-length","value":"400"},{"key":"date","value":"Mon, 12 Oct 2026 07:09:57 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"RESPONSE\": {\n \"reference\": \"MA0002\",\n \"STATUS\": \"SUCCESS\",\n \"companyTin\": 999000025,\n \"items\": [\n {\n \"description\": \"ENGEN ECODRIVE DIESEL\",\n \"itemCd\": \"ENGEN18\",\n \"fuelItemNm\": \"Diesel fuel\",\n \"rrpPrice\": 1876,\n \"status\": \"SUCCESS\",\n \"fuelItemCd\": \"RW-2TYXL10-00001\"\n },\n {\n \"description\": \"ENGEN ECODRIVE PETROL\",\n \"itemCd\": \"ENGEN17\",\n \"fuelItemNm\": \"Gasoline or Petrol\",\n \"rrpPrice\": 1876,\n \"status\": \"SUCCESS\",\n \"fuelItemCd\": \"RW-2TYXL10-00002\"\n }\n ]\n }\n}"}],"_postman_id":"8e8da492-7b86-4892-bd8d-19c06351858c"}],"id":"316f136f-43f2-4e4a-bbed-b1fc783582b5","description":"

Retrieve RRA fuel products and map local item codes.

\n","_postman_id":"316f136f-43f2-4e4a-bbed-b1fc783582b5"},{"name":"11 - Fuel Dealers","item":[{"name":"Get Fuel Dealers — XML","id":"085ec62c-6996-497a-b557-744af748f0c3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/xml","type":"text"}],"url":"http://localhost:8080/vsdc/v1/FuelDealer","description":"

Returns the fuel dealers registered for your company TIN. For: fuel taxpayers issuing Resale sales - a Resale receipt requires a clientTin from this list.

\n","urlObject":{"path":["vsdc","v1","FuelDealer"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"9b3fb1bd-8505-4682-86bd-cbdbc8536bcb","name":"SUCCESS","originalRequest":{"method":"GET","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/xml","disabled":true}],"body":{"mode":"raw","raw":"\r\n999000025","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/FuelDealer"},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/xml"},{"key":"content-length","value":"1663"},{"key":"date","value":"Mon, 12 Oct 2026 07:15:05 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"\n\n \n 100005060\n Resale\n \n \n 100005062\n Resale\n \n \n 100005073\n Resale\n \n \n 100005078\n Resale\n \n \n 100069714\n Resale\n \n \n 100200300\n Resale\n \n \n 100300020\n Resale\n \n \n 105678901\n Resale\n \n \n 106789012\n Resale\n \n \n 107890123\n Resale\n \n \n 108209514\n Resale\n \n \n 108744206\n Resale\n \n \n 109876543\n Resale\n \n \n 901010101\n Resale\n \n \n 901010111\n Resale\n \n \n 901010122\n Resale\n \n \n 910000193\n Resale\n \n \n 999000099\n Resale\n \n \n 999999999\n Resale\n \n"}],"_postman_id":"085ec62c-6996-497a-b557-744af748f0c3"},{"name":"Get Fuel Dealers — JSON","id":"cef0dbec-d361-4569-a77d-f892e9018376","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"companyTin\": \"999000025\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/FuelDealer","description":"

JSON variant - registered fuel dealers for the company TIN. For: fuel taxpayers issuing Resale sales.

\n","urlObject":{"path":["vsdc","v1","FuelDealer"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"f499ab39-3311-44c8-a3fb-48c85c3283d2","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n\t\"companyTin\": \"999000025\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/FuelDealer"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/json"},{"key":"content-length","value":"788"},{"key":"date","value":"Mon, 12 Oct 2026 07:16:06 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"fuelDealers\": {\n \"dealer\": [\n {\n \"tin\": 100005060,\n \"dealerType\": \"Resale\"\n },\n {\n \"tin\": 100005062,\n \"dealerType\": \"Resale\"\n },\n {\n \"tin\": 100005073,\n \"dealerType\": \"Resale\"\n },\n {\n \"tin\": 100005078,\n \"dealerType\": \"Resale\"\n },\n {\n \"tin\": 100069714,\n \"dealerType\": \"Resale\"\n },\n {\n \"tin\": 100200300,\n \"dealerType\": \"Resale\"\n },\n {\n \"tin\": 100300020,\n \"dealerType\": \"Resale\"\n },\n {\n \"tin\": 105678901,\n \"dealerType\": \"Resale\"\n },\n {\n \"tin\": 106789012,\n \"dealerType\": \"Resale\"\n },\n {\n \"tin\": 107890123,\n \"dealerType\": \"Resale\"\n },\n {\n \"tin\": 108209514,\n \"dealerType\": \"Resale\"\n },\n {\n \"tin\": 108744206,\n \"dealerType\": \"Resale\"\n },\n {\n \"tin\": 109876543,\n \"dealerType\": \"Resale\"\n },\n {\n \"tin\": 901010101,\n \"dealerType\": \"Resale\"\n },\n {\n \"tin\": 901010111,\n \"dealerType\": \"Resale\"\n },\n {\n \"tin\": 901010122,\n \"dealerType\": \"Resale\"\n },\n {\n \"tin\": 910000193,\n \"dealerType\": \"Resale\"\n },\n {\n \"tin\": 999000099,\n \"dealerType\": \"Resale\"\n },\n {\n \"tin\": 999999999,\n \"dealerType\": \"Resale\"\n }\n ]\n }\n}"}],"_postman_id":"cef0dbec-d361-4569-a77d-f892e9018376"}],"id":"e01353a1-e5dd-459d-ac47-090df22d1212","description":"

Retrieve registered fuel dealers for Resale transactions.

\n","_postman_id":"e01353a1-e5dd-459d-ac47-090df22d1212"},{"name":"12 - Fuel Opening Stock","item":[{"name":"Submit Fuel Opening Stock — XML","id":"715df9a2-8688-4ed2-bf4e-0346237753ca","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/xml","type":"text"}],"body":{"mode":"raw","raw":"\r\n999000025\r\nFS0002\r\nadmin\r\n\r\n ENGEN18\r\n ENGEN ECODRIVE DIESEL\r\n 1803\r\n 1803\r\n 2932.32\r\n F\r\n 2932.32\r\n\r\n\r\n ENGEN17\r\n ENGEN ECODRIVE PETROL\r\n 1803\r\n 1803\r\n 2932.32\r\n F\r\n 2932.32\r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/SubmitFuelStock","description":"

Declares opening stock quantities and prices for fuel items already mapped via mapFuelItem. For: licensed fuel/petroleum taxpayers (tank opening stock).

\n","urlObject":{"path":["vsdc","v1","SubmitFuelStock"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"9f52ceb3-9f6d-4272-a060-5ba3ad54124a","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/xml"}],"body":{"mode":"raw","raw":"\r\n999000025\r\nFS0002\r\nadmin\r\n\r\n ENGEN18\r\n ENGEN ECODRIVE DIESEL\r\n 1803\r\n 1803\r\n 2932.32\r\n F\r\n 2932.32\r\n\r\n\r\n ENGEN17\r\n ENGEN ECODRIVE PETROL\r\n 1803\r\n 1803\r\n 2932.32\r\n F\r\n 2932.32\r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/SubmitFuelStock"},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/xml"},{"key":"content-length","value":"410"},{"key":"date","value":"Mon, 12 Oct 2026 07:30:49 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"999000025SUCCESSFS0002FUELSTOCKSDC0090000562VALG01VNA082026-10-12 09:30:492026-10-12 09:30:49"}],"_postman_id":"715df9a2-8688-4ed2-bf4e-0346237753ca"},{"name":"Submit Fuel Opening Stock — JSON","id":"54853b37-08c0-48ae-90c1-2b87fb58f8ea","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"companyTin\": \"999000025\",\r\n \"reference\": \"FS0002\",\r\n \"userName\": \"admin\",\r\n \"items\": [\r\n {\r\n \"itemCd\": \"ENGEN18\",\r\n \"itemNm\": \"ENGEN ECODRIVE DIESEL\",\r\n \"newPrice\": 1803,\r\n \"oldPrice\": 1803,\r\n \"currQty\": 2932.32,\r\n \"taxCode\": \"F\",\r\n \"openingStock\": 2932.32\r\n },\r\n {\r\n \"itemCd\": \"ENGEN17\",\r\n \"itemNm\": \"ENGEN ECODRIVE PETROL\",\r\n \"newPrice\": 1803,\r\n \"oldPrice\": 1803,\r\n \"currQty\": 2932.32,\r\n \"taxCode\": \"F\",\r\n \"openingStock\": 2932.32\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/SubmitFuelStock","description":"

JSON variant of SubmitFuelStock. For: licensed fuel/petroleum taxpayers.

\n","urlObject":{"path":["vsdc","v1","SubmitFuelStock"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"722f6214-fd13-42e0-ab1f-7a8bb54287b4","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"companyTin\": \"999000025\",\r\n \"reference\": \"FS0002\",\r\n \"userName\": \"admin\",\r\n \"items\": [\r\n {\r\n \"itemCd\": \"ENGEN18\",\r\n \"itemNm\": \"ENGEN ECODRIVE DIESEL\",\r\n \"newPrice\": 1803,\r\n \"oldPrice\": 1803,\r\n \"currQty\": 2932.32,\r\n \"taxCode\": \"F\",\r\n \"openingStock\": 2932.32\r\n },\r\n {\r\n \"itemCd\": \"ENGEN17\",\r\n \"itemNm\": \"ENGEN ECODRIVE PETROL\",\r\n \"newPrice\": 1803,\r\n \"oldPrice\": 1803,\r\n \"currQty\": 2932.32,\r\n \"taxCode\": \"F\",\r\n \"openingStock\": 2932.32\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/SubmitFuelStock"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"98"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"98"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/json"},{"key":"content-length","value":"299"},{"key":"date","value":"Mon, 12 Oct 2026 07:31:45 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"RESPONSE\": {\n \"DISTRIBUTOR_TIN\": 999000025,\n \"MESSAGE\": {\n \"flag\": \"FUELSTOCK\",\n \"ysdcrecnum\": \"\",\n \"num\": \"FS0002\",\n \"ysdcid\": \"SDC009000056\",\n \"ysdcintdata\": \"\",\n \"ysdcmrc\": \"VALG01VNA08\",\n \"ysdcitems\": 2,\n \"ysdcmrctim\": \"2026-10-12 09:31:45\",\n \"ysdcregsig\": \"\",\n \"ysdctime\": \"2026-10-12 09:31:45\"\n },\n \"STATUS\": \"SUCCESS\",\n \"QR_CODE\": \"\"\n }\n}"}],"_postman_id":"54853b37-08c0-48ae-90c1-2b87fb58f8ea"}],"id":"25bb7ea3-77f4-4188-b5c8-007fd29ba7ee","description":"

Declare opening/tank stock for mapped fuel items.

\n","_postman_id":"25bb7ea3-77f4-4188-b5c8-007fd29ba7ee"},{"name":"13 - Fuel Invoicing","item":[{"name":"Issue Fuel Consumption Invoice — XML","id":"5a2abf29-5334-4821-83ce-253a9e30221f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"},{"key":"Content-Type","value":"application/xml","type":"text"}],"body":{"mode":"raw","raw":"\r\n\r\n INVOICE\r\n 999000025\r\n posUser\r\n 1\r\n INV-FUEL-001\r\n 2026-10-08\r\n Consumption\r\n CLIENT NAME\r\n RWF\r\n 18760\r\n 2861.69\r\n INCLUSIVE\r\n \r\n ENGEN18\r\n ENGEN ECODRIVE DIESEL\r\n 10\r\n 1876\r\n F\r\n Fuel\r\n \r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/Receipt","description":"

Fuel Consumption invoice (XML). For: licensed fuel taxpayers selling at retail (pump). itemCode must be mapped via mapFuelItem; saleType=Consumption; unitPrice is the VAT-inclusive pump price and must be inside the regulated RRP band; totalVat must equal the computed VAT.

\n","urlObject":{"path":["vsdc","v1","Receipt"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"afb132b3-bfd2-4d30-bb1a-298ab45541b4","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/xml","disabled":true}],"body":{"mode":"raw","raw":"\r\n\r\n 999000025\r\n EXCLUSIVE\r\n \r\n INVOICE\r\n Consumption\r\n \r\n \r\n Client\r\n 2023-04-19\r\n sapUser\r\n 1\r\n 100000002\r\n 18172\r\n 2772\r\n \r\n 1\r\n QA-E2E-01\r\n \r\n RWF\r\n SELECTIVE\r\n \r\n \r\n ENGEN17\r\n ENGEN ECODRIVE DIESEL\r\n 10\r\n 1540\r\n F\r\n 18\r\n \r\n Diesel\r\n \r\n \r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/Receipt"},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/xml;charset=ISO-8859-1"},{"key":"content-length","value":"558"},{"key":"date","value":"Mon, 12 Oct 2026 08:37:01 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"999000025SUCCESSQA-E2E-01INVOICESDC009000056TJE4-MZFS-XYKS-GRFL-HUWR-542J-PQXOEH-HP2C-XOJA-6R2M151/53 NS ISH:53VALG01VNA082026-10-12 10:37:012026-10-12 10:37:012026-10-12 10:37:01#SDC009000056#51#XOEHHP2CXOJA6R2M#TJE4MZFSXYKSGRFLHUWR542JPQ\r\n"}],"_postman_id":"5a2abf29-5334-4821-83ce-253a9e30221f"},{"name":"Issue Fuel Consumption Invoice — JSON","id":"a7af0b90-8da0-4f0e-b1f9-266294bf4c3d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"companyTin\": \"999000025\",\r\n \"calculationType\": \"INCLUSIVE\",\r\n \"flag\": \"INVOICE\",\r\n \"saleType\": \"Consumption\",\r\n \"invoiceNumber\": \"INV-FUEL-001\",\r\n \"invoiceDate\": \"2026-10-08\",\r\n \"userName\": \"posUser\",\r\n \"itemsCount\": \"1\",\r\n \"businessPartnerName\": \"CLIENT NAME\",\r\n \"clientTin\": \"\",\r\n \"currency\": \"RWF\",\r\n \"exchangeRate\": \"1\",\r\n \"totalAmount\": \"18760\",\r\n \"totalVat\": \"2861.69\",\r\n \"items\": [\r\n {\r\n \"itemCode\": \"ENGEN18\",\r\n \"description\": \"ENGEN ECODRIVE DIESEL\",\r\n \"quantity\": \"10\",\r\n \"unitPrice\": \"1876\",\r\n \"taxCode\": \"F\",\r\n \"itemCategory\": \"Fuel\",\r\n \"dcValue\": \"0\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/Receipt","description":"

Fuel Consumption invoice (JSON). For: licensed fuel taxpayers (retail). Same contract as the XML variant - mapped itemCode, saleType=Consumption, unitPrice inside the RRP band, totalVat = computed VAT.

\n","urlObject":{"path":["vsdc","v1","Receipt"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"a144cf3b-8eb8-4891-b1aa-82e245affdb3","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n\t\"request\": {\r\n\t\t\"companyTin\": \"999000025\",\r\n\t\t\"calculationType\": \"EXCLUSIVE\",\r\n\t\t\"fileName\": \"\",\r\n\t\t\"flag\": \"INVOICE\",\r\n\t\t\"saleType\": \"Consumption\",\r\n\t\t\"voucherAmount\": \"\",\r\n\t\t\"discountAmount\": \"\",\r\n\t\t\"businessPartnerName\": \"Client\",\r\n\t\t\"invoiceDate\": \"2023-04-19\",\r\n\t\t\"userName\": \"sapUser\",\r\n\t\t\"itemsCount\": \"1\",\r\n\t\t\"clientTin\": \"100000002\",\r\n\t\t\"totalAmount\": \"18172\",\r\n\t\t\"totalVat\": \"2772\",\r\n\t\t\"clientTinPin\": \"\",\r\n\t\t\"exchangeRate\": \"1\",\r\n\t\t\"invoiceNumber\": \"QA-E2E-01\",\r\n\t\t\"callback\": \"\",\r\n\t\t\"currency\": \"RWF\",\r\n\t\t\"discountType\": \"SELECTIVE\",\r\n\t\t\"items\": {\r\n\t\t\t\"item\": {\r\n\t\t\t\t\"itemCode\": \"ENGEN17\",\r\n\t\t\t\t\"description\": \"ENGEN ECODRIVE DIESEL\",\r\n\t\t\t\t\"quantity\": \"10\",\r\n\t\t\t\t\"unitPrice\": \"1540\",\r\n\t\t\t\t\"taxCode\": \"F\",\r\n\t\t\t\t\"taxRate\": \"18\",\r\n\t\t\t\t\"expire\": \"\",\r\n\t\t\t\t\"itemCategory\": \"Diesel\"\r\n\t\t\t}\r\n\t\t}\r\n\t}\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/Receipt"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/json;charset=ISO-8859-1"},{"key":"content-length","value":"456"},{"key":"date","value":"Mon, 12 Oct 2026 08:38:41 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"RESPONSE\": {\n \"DISTRIBUTOR_TIN\": 999000025,\n \"MESSAGE\": {\n \"flag\": \"INVOICE\",\n \"ysdcrecnum\": \"51/53 NS ISH:53\",\n \"num\": \"QA-E2E-01\",\n \"ysdcid\": \"SDC009000056\",\n \"ysdcintdata\": \"TJE4-MZFS-XYKS-GRFL-HUWR-542J-PQ\",\n \"ysdcmrc\": \"VALG01VNA08\",\n \"ysdcitems\": 1,\n \"ysdcmrctim\": \"2026-10-12 10:37:01\",\n \"ysdcregsig\": \"XOEH-HP2C-XOJA-6R2M\",\n \"ysdctime\": \"2026-10-12 10:37:01\"\n },\n \"STATUS\": \"SUCCESS\",\n \"QR_CODE\": \"2026-10-12 10:37:01#SDC009000056#51#XOEH-HP2C-XOJA-6R2M#TJE4-MZFS-XYKS-GRFL-HUWR-542J-PQ\"\n }\n}"}],"_postman_id":"a7af0b90-8da0-4f0e-b1f9-266294bf4c3d"},{"name":"Issue Fuel Resale Invoice — JSON","id":"cca03e01-29c8-4830-bf43-9ba4b528e314","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg=","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"companyTin\": \"999000025\",\r\n \"calculationType\": \"INCLUSIVE\",\r\n \"flag\": \"INVOICE\",\r\n \"saleType\": \"Resale\",\r\n \"invoiceNumber\": \"INV-FUEL-RES01\",\r\n \"invoiceDate\": \"2026-10-08\",\r\n \"userName\": \"posUser\",\r\n \"itemsCount\": \"1\",\r\n \"clientTin\": \"100005060\",\r\n \"businessPartnerName\": \"REGISTERED DEALER\",\r\n \"currency\": \"RWF\",\r\n \"exchangeRate\": \"1\",\r\n \"totalAmount\": \"184600\",\r\n \"totalVat\": \"28616.95\",\r\n \"totalDcValue\": \"3000\",\r\n \"items\": [\r\n {\r\n \"itemCode\": \"ENGEN18\",\r\n \"description\": \"ENGEN ECODRIVE DIESEL\",\r\n \"quantity\": \"100\",\r\n \"unitPrice\": \"1876\",\r\n \"dcValue\": \"3000\",\r\n \"taxCode\": \"F\",\r\n \"itemCategory\": \"Diesel\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/Receipt","description":"

Fuel Resale invoice (JSON). For: fuel depots/suppliers selling to registered dealers. Requires saleType=Resale, clientTin of a registered fuel dealer (see FuelDealer), dcValue > 0 on the line and header totalDcValue = sum of line dcValue.

\n","urlObject":{"path":["vsdc","v1","Receipt"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"d6a68037-cea4-44e7-9d51-798e6151e8b5","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"companyTin\": \"999000025\",\r\n \"calculationType\": \"EXCLUSIVE\",\r\n \"flag\": \"INVOICE\",\r\n \"saleType\": \"Resale\",\r\n \"invoiceNumber\": \"INV-FUEL-RES01\",\r\n \"invoiceDate\": \"2026-10-08\",\r\n \"userName\": \"posUser\",\r\n \"itemsCount\": \"1\",\r\n \"clientTin\": \"100005060\",\r\n \"businessPartnerName\": \"REGISTERED DEALER\",\r\n \"currency\": \"RWF\",\r\n \"exchangeRate\": \"1\",\r\n \"totalAmount\": \"178720\",\r\n \"totalVat\": \"27720\",\r\n \"discountAmount\": \"3000\",\r\n \"discountType\": \"SELECTIVE\",\r\n \"items\": [\r\n {\r\n \"itemCode\": \"ENGEN17\",\r\n \"description\": \"ENGEN ECODRIVE DIESEL\",\r\n \"quantity\": \"100\",\r\n \"unitPrice\": \"1540\",\r\n \"discount\": \"3000\",\r\n \"taxCode\": \"F\",\r\n \"itemCategory\": \"Diesel\",\r\n \"taxRate\": \"18\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/Receipt"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/json;charset=ISO-8859-1"},{"key":"content-length","value":"452"},{"key":"date","value":"Mon, 12 Oct 2026 08:48:48 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"RESPONSE\": {\n \"DISTRIBUTOR_TIN\": 999000025,\n \"MESSAGE\": {\n \"flag\": \"INVOICE\",\n \"ysdcrecnum\": \"52/54 NS ISH:54\",\n \"num\": \"INV-FUEL-RES01\",\n \"ysdcid\": \"SDC009000056\",\n \"ysdcintdata\": \"CWNL-DO2E-JZ4W-NIXO-CZ2F-ILCG-WQ\",\n \"ysdcmrc\": \"VALG01VNA08\",\n \"ysdcitems\": 1,\n \"ysdcmrctim\": \"2026-10-12 10:48:48\",\n \"ysdcregsig\": \"P4YO-Z2KD-3D2V-AHVU\",\n \"ysdctime\": \"2026-10-12 10:48:48\"\n },\n \"STATUS\": \"SUCCESS\",\n \"QR_CODE\": \"2026-10-12 10:48:48#SDC009000056#52#P4YOZ2KD3D2VAHVU#CWNLDO2EJZ4WNIXOCZ2FILCGWQ\"\n }\n}"}],"_postman_id":"cca03e01-29c8-4830-bf43-9ba4b528e314"},{"name":"Issue Fuel Resale Invoice — XML","id":"3bb3c968-70ae-4bf9-9d17-8182d3582ad3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"companyTin\": \"999000025\",\r\n \"calculationType\": \"INCLUSIVE\",\r\n \"flag\": \"INVOICE\",\r\n \"saleType\": \"Resale\",\r\n \"invoiceNumber\": \"INV-FUEL-RES01\",\r\n \"invoiceDate\": \"2026-10-08\",\r\n \"userName\": \"posUser\",\r\n \"itemsCount\": \"1\",\r\n \"clientTin\": \"100005060\",\r\n \"businessPartnerName\": \"REGISTERED DEALER\",\r\n \"currency\": \"RWF\",\r\n \"exchangeRate\": \"1\",\r\n \"totalAmount\": \"184600\",\r\n \"totalVat\": \"28616.95\",\r\n \"totalDcValue\": \"3000\",\r\n \"items\": [\r\n {\r\n \"itemCode\": \"ENGEN18\",\r\n \"description\": \"ENGEN ECODRIVE DIESEL\",\r\n \"quantity\": \"100\",\r\n \"unitPrice\": \"1876\",\r\n \"dcValue\": \"3000\",\r\n \"taxCode\": \"F\",\r\n \"itemCategory\": \"Diesel\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/vsdc/v1/Receipt","description":"

\n","urlObject":{"path":["vsdc","v1","Receipt"],"host":["http://localhost:8080"],"query":[],"variable":[]}},"response":[{"id":"4a004731-fd81-4112-9682-3568e4e6e4e9","name":"SUCCESS","originalRequest":{"method":"POST","header":[{"key":"security_key","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"Content-Type","value":"application/json","disabled":true}],"body":{"mode":"raw","raw":"\r\n999000025\r\nEXCLUSIVE\r\nINVOICE\r\nResale\r\nINV-FUEL-RES01\r\n2026-10-08\r\nposUser\r\n1\r\n100005060\r\nREGISTERED DEALER\r\nRWF\r\n1\r\n178720\r\n27720\r\n3000\r\nSELECTIVE\r\n\r\n ENGEN17\r\n ENGEN ECODRIVE DIESEL\r\n 100\r\n 1540\r\n 3000\r\n F\r\n Diesel\r\n 18\r\n\r\n","options":{"raw":{"language":"xml"}}},"url":"http://localhost:8080/vsdc/v1/Receipt"},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"ratelimit-limit","value":"100"},{"key":"ratelimit-remaining","value":"99"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-xss-protection","value":"0"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-type","value":"application/xml;charset=ISO-8859-1"},{"key":"content-length","value":"572"},{"key":"date","value":"Mon, 12 Oct 2026 08:50:40 GMT"},{"key":"keep-alive","value":"timeout=60"},{"key":"connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"999000025SUCCESSINV-FUEL-RES01INVOICESDC009000056CWNL-DO2E-JZ4W-NIXO-CZ2F-ILCG-WQP4YO-Z2KD-3D2V-AHVU152/54 NS ISH:54VALG01VNA082026-10-12 10:48:482026-10-12 10:48:482026-10-12 10:48:48#SDC009000056#52#P4YO-Z2KD-3D2V-AHVU#CWNL-DO2E-JZ4W-NIXO-CZ2F-ILCG-WQ\r\n"}],"_postman_id":"3bb3c968-70ae-4bf9-9d17-8182d3582ad3"}],"id":"035139fd-d1d7-4f21-b486-97b0d269b558","description":"

Fuel Consumption and Fuel Resale invoice examples.

\n","_postman_id":"035139fd-d1d7-4f21-b486-97b0d269b558"}],"variable":[{"key":"baseUrl","value":"http://localhost:8080"},{"key":"securityKey","value":"Z60gftKe9sei3xOZhvvDa0StkVILKR3j5MBM9ygi1zg="},{"key":"companyTin","value":"999000025"}]}