{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"9273a2a0-eeb2-4a12-814e-f3c80e5596ff","name":"ZRA SMART INVOICE API VER ISHYIGA 1.4 INGWE","description":"ZRA SMART INVOICE API Documentation VER ISHYIGA 1.4 INGWE , API for SMART INVOICE INTEGRATION DOCUMENTATION VCIS/VSDC\n\nThis document describes the API specification to integrate with Electronic Invoicing Systems (Smart invoice)\n\nOverview  \nThe following specific requirements are for the systems to communicate with Smart invoice VCIS, the Certified Invoicing System to be used together with a Virtual Sales Data Controller (VSDC).\n\nDATA FLOW DIAGRAM : [https://wirepickpay.com/DataFlow.php](https://wirepickpay.com/DataFlow.php)\n\nThis Api have an Authentication\n\n\"COMPANY_TPIN\": \"1004097050\",  \n\"COMPANY_NAMES\": \"WIREPICK INC \",  \n\"COMPANY_SECURITY_KEY\": \"AQPBBLMHBBKGGGC3FVVOAGLDWL32GGLF\"\n\nSMART INVOICE API Receive data in two ways\n\n1.XML FORMAT  \n2.JSON FORMAT.\n\nTAX TYPE & TAX CODE MAPPING\n\n| **ZRA TAX CODE** | **SYSTEM TAX CODE** | **DESCRIPTION** | **TAX RATE** |\n| --- | --- | --- | --- |\n| A | A | Standard Rated(16%) | 16 |\n| B | B | Minimum Taxable Value (MTV-16%) | 16 |\n| C1 | C | C1 (Exports(0%)) | 0 |\n| C2 | D | C2 (Zero-rating LPO) | 0 |\n| C3 | E | C3 (Zero-rated by nature) | 0 |\n| D | F | Exempt | 0 |\n\n**ERROR CODE LIST**\n\n| **CODE** | **ERROR** | **ACCEPTED** |\n| --- | --- | --- |\n| B05 | CLIENT NAME MISSING | <2 char |\n| B051 | TAX NUMBER FORMAT NOT ACCEPTED | !EMPTY or !10 |\n| B06 | CLIENT NAME DIFFERENT FOR PREVIOUS ONE | PREVIOUS TPIN NUMBER |\n| B07 | CODE MISSING | null |\n| B09 | DESCRIPTION MISSING | null |\n| B10 | QUANTITY MISSING | \\>0 |\n| B11 | QUANTITY IS NEGATIVE | <0 |\n| B12 | QUANTITY NOT A NUMBER | character |\n| B13 | TAX_RATE NOT ACCEPTED | !0 or !16 |\n| B16 | INVOICE TOTAL AMOUNT DIFFERENT TO GROSS_AMOUNT | \\>0.05 |\n| B18 | INVOICE TOTAL TAXES AMOUNT DIFFERENT TAXES | \\>0.05 |\n| B19 | INVOICE REFERENCE MISSING | null |\n| B20 | INVOICE REFERENCE ALREADY SENT | TRUE |\n| B21 | NEGATIVE SALE PRICE NOT ALLOWED | <=0 |\n| B22 | ZERO TOTAL INVOICE NOT SUPPORTED | <=0 |\n| R1 | REFUND TOTAL AMOUNT DIFFERENT TO ORIGINAL INVOICE AMOUNT |  |\n| R2 | REFUND TOTAL VAT AMOUNT DIFFERENT TO ORIGINAL INVOICE VAT AMOUNT |  |\n| R3 | REFUND ITEM MISSING , ITEM NOT FOUND |  |\n| R4 | REFUND ITEM DIFFERENT FROM INVOICE ITEM , CHECK ITEM NAME AND CODE |  |\n| R5 | MISSING REFUND_ID | REFUND_ID |\n| F01 | FLAG NUMBER FORMAT | INVOICE, REFUND, PROFORMA, PARTIAL REFUND, INVENTORY, ITEM |\n| F02 | INVOICE ALREADY REFUNDED |  |\n| B70 | WRONG CURRENCY | ZMW when EXCHANGE_RATE is 1 |\n| IS100 | INTERNAL ERROR |  |\n| B15 | CHECK NUMBER OF ITEMS WITH EXPECTED SIZE |  |\n| B27 | TAXRATE DIFFERENT FROM PREVIOUS ONE |  |\n| B061 | ITEM CODE DIFFERENT FOR PREVIOUS ONE |  |\n| B28 | CLIENT TAX NUMBER DIFFERENT FROM PREVIOUS ONE |  |\n| B29 | CLIENT TAX NUMBER IS FOR ANOTHER CLIENT |  |\n| B31 | LEVY A AMOUNT ARE DIFFERENT |  |\n| B32 | LEVY B AMOUNT ARE DIFFERENT |  |\n| B33 | LEVY C AMOUNT ARE DIFFERENT |  |\n| B34 | TOTAL LEVY AMOUNT ARE DIFFERENT |  |\n| B35 | LEVY D AMOUNT ARE DIFFERENT |  |\n| B01 | INCORRECT CLIENT TPIN PIN |  |\n| A01 | COMPANY_NAMES: COMPANY_TPIN: COMPANY_SECURITY_KEY: DOES NOT EXISTS |  |\n| A02 | EMPTY LIST |  |\n| A03 | REFUND BYPASS( EXCEEDING ORGINAL INVOICE AMOUNT) |  |\n| A04 | UNKNOWN FLAG NAME | INVOICE,REFUND |\n| A05 | MISSING ORIGINAL INVOICE NUMBER |  |\n| A06 | INVALID UNITY PRICE |  |\n| A07 | INVALID DISCOUNT |  |\n| A08 | INVALID TAXCODE | A,B,C1,C2,C3  <br>,D |\n| A09 | INVALID TAXRATE | 0 OR 16 |\n| A12 | INCOME MSG FAILED TO BE LOGGED | SEND INVOICE FIRST |\n| A10 | NOT ENGINE SIZE FOUND (CONTACT AUTHORITY TECH TEAM) | ENGINE SHOULD HAVE SIZE |\n| A11 | ITEM COUNT NOT A NUMBER | \\>0 |\n| A13 | EVAT NOT ABLE TO REACH ITS DATABASE |  |\n| A14 | ENCOUTED ITEMS SYS ERROR CONTACT TECH TEAM |  |\n| D01 | INVOICE ALREADY EXIST |  |\n| D02 | MISSING ITEM NAME |  |\n| D03 | MISSING ITEM CODE |  |\n| D07 | MISSING ITEM ORIGIN COUNTRY CODE | 08Default (ZMW) FOR ZAMBIA |\n| D08 | MISSING PACKAGING UNIT |  |\n| D09 | MISSING QUANTITY UNIT |  |\n| D10 | MISSING ITEM CATEGORY NAME |  |\n| T03 | TPIN NUMBER NOT FOUND | When the requestED TPIN NUMBER is not found in synchronized ZRA data |\n| T04 | TPIN STOPPED |  |\n| T05 | TPIN PROTECTED |  |\n| T06 | INCORRECT CLIENT TPIN |  |\n| N01 | ITEM NOT FOUND |  |\n| N02 | ITEM NOT VALIDATED, PENDING |  |\n| D04 | NO RESPONSE FOUND SEND INVOICE FIRST | SEND INVOICE |\n| D05 | INVOICE UNDER STAMPING | PULL RESPONSE AFTER 3 SECOND |\n| D06 | STAMPING ENGINE IS DOWN | CHECK IF SDK OR SERVER MACHINE IS RUNNING |\n| P01 | PRODUCT ALREADY EXIST |  |\n| H01 | WRONG COMMAND | ID REQUEST |\n| H02 | WRONG TIME FORMAT |  |\n| H03 | INVENTORY EXISTS |  |\n| H04 | INVENTORY NOT RECEIVED |  |\n\n## INVOICE\n\nInvoice  \nInvoce (Normal Sale) refers to a receipt that shall be produced and offered to the client. It is any receipt produced while the Electronic Billing Machine is in its normal registration mode, used to register sales of goods and/or services, including corrections and discounts.\n\nThe following is an example of how data to be sent should be structured.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"20074551","team":1173044,"collectionId":"9273a2a0-eeb2-4a12-814e-f3c80e5596ff","publishedId":"2sA3dxEXY4","public":true,"publicUrl":"https://documenter-api.postman.tech/view/20074551/2sA3dxEXY4","privateUrl":"https://go.postman.co/documentation/20074551-9273a2a0-eeb2-4a12-814e-f3c80e5596ff","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2024-07-03T15:46:05.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/1ca5890209e433edab5554dc15f08e09e0ee429b0aafa436cbcd1e46deab2354","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2sA3dxEXY4"}