{"id":12107,"date":"2025-06-06T05:52:31","date_gmt":"2025-06-06T05:52:31","guid":{"rendered":"https:\/\/tenthplanet.in\/idempiere\/?p=12107"},"modified":"2026-08-24T09:33:05","modified_gmt":"2026-08-24T09:33:05","slug":"how-to-do-hsn-code-api-setup-in-adempiere-retail","status":"publish","type":"post","link":"https:\/\/tenthplanet.in\/idempiere\/how-to-do-hsn-code-api-setup-in-adempiere-retail\/","title":{"rendered":"How to do HSN Code API Setup in ADempiere Retail"},"content":{"rendered":"\n

HSN Code API Setup<\/strong> means configuring your system to automatically fetch or validate HSN codes<\/strong> using an API (Application Programming Interface). This helps ensure accurate tax classification<\/strong> for products as per government standards.<\/p>\n\n\n\n

User Access<\/strong><\/h2>\n\n\n\n

Who Can Access<\/strong><\/h3>\n\n\n\n
    \n
  • Admin<\/li>\n\n\n\n
  • Cashier<\/li>\n\n\n\n
  • Back office<\/li>\n\n\n\n
  • Manager<\/li>\n<\/ul>\n\n\n\n

    What User Can Do<\/strong><\/h3>\n\n\n\n
      \n
    • Configure API URL, credentials, and headers<\/strong><\/li>\n\n\n\n
    • Enable auto-fetch or validation<\/strong> of HSN codes during product creation or update<\/li>\n\n\n\n
    • Test API connection and responses<\/li>\n\n\n\n
    • Sync product master with correct HSN and tax rate<\/strong><\/li>\n<\/ul>\n\n\n\n

      Pre-Requisite Activities<\/strong><\/h2>\n\n\n\n
        \n
      • Obtain API details<\/strong> (URL, key\/token) from the HSN provider<\/li>\n\n\n\n
      • Ensure internet access from the system<\/li>\n\n\n\n
      • Set up product categories and tax mappings<\/li>\n\n\n\n
      • Ensure HSN structure (code, description, tax%)<\/strong> is supported<\/li>\n<\/ul>\n\n\n\n

        Business Rules<\/strong><\/h2>\n\n\n\n
          \n
        • Only valid HSN codes will be accepted during sync or validation<\/li>\n\n\n\n
        • HSN API should use secure HTTPS<\/strong> and be authenticated<\/li>\n\n\n\n
        • If HSN code is missing, product cannot be saved (based on config)<\/li>\n\n\n\n
        • Product tax rate should match the rate returned<\/strong> by the API<\/li>\n\n\n\n
        • Users must not override HSN\/tax unless authorized<\/li>\n<\/ul>\n\n\n\n

          User Interface<\/strong><\/h2>\n\n\n\n

          Step 1 : <\/strong><\/strong><\/strong>Select \u2018Branch<\/strong>\u2019<\/strong> <\/strong>in Menu Branch Configuration -> Branch<\/strong> <\/strong><\/strong>or Search Branch<\/strong> <\/strong><\/strong>in Lookup.<\/p>\n\n\n\n

          \"TenthPlanet<\/figure>\n\n\n\n

          Step 2 : <\/strong>Select Organisation.<\/p>\n\n\n\n

          \"TenthPlanet<\/figure>\n\n\n\n

          Step 3 : <\/strong>Click HSN Code API Config<\/strong> Tab and Click New<\/strong> Button.<\/p>\n\n\n\n

          \"TenthPlanet<\/figure>\n\n\n\n

          Step 4 : <\/strong>Enter Below Credentials for HSN Code API Config<\/p>\n\n\n\n

            \n
          • HSN URL<\/li>\n\n\n\n
          • APIKey<\/li>\n<\/ul>\n\n\n\n
            \"TenthPlanet<\/figure>\n\n\n\n

            Step 5 : <\/strong>Click to Save the Record.<\/p>\n\n\n\n

            \"TenthPlanet<\/figure>\n","protected":false},"excerpt":{"rendered":"

            HSN Code API Setup means configuring your system to automatically fetch or validate HSN codes using an API (Application Programming […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[31,84,32],"tags":[],"class_list":["post-12107","post","type-post","status-publish","format-standard","hentry","category-jaldi-life-style","category-adempiere-master","category-jaldi-super-store"],"_links":{"self":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/12107","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/comments?post=12107"}],"version-history":[{"count":4,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/12107\/revisions"}],"predecessor-version":[{"id":25063,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/12107\/revisions\/25063"}],"wp:attachment":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/media?parent=12107"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/categories?post=12107"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/tags?post=12107"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}