Kumusoft Solutions
EFRIS API
EFRIS API
  1. Return Codes
  • 🚀 Getting started
  • 🔐 Authentication
    • Getting started
    • Calling Kumusoft APIs
    • API Keys
    • Generate auth Token
      POST
  • 🧾 Invoicing
    • How to generate a Fiscal invoice
    • Generate fiscal invoice
      POST
    • Preview fiscal invoice
      POST
    • Search invoices
      POST
    • Invoice detils
      GET
  • 📦 Stock Management
    • All stock items
      GET
    • Search stock items
      POST
    • Reduce stock
      POST
    • Increase stock
      POST
    • Register stock item
      POST
  • 📃 Credit Notes
    • Issue credit note
  • ⚙️ Masterdata
    • Registration details
    • Get Masterdata
  • 📋 Reference
    • Overview
    • Data Sources
    • Invoice Types
    • Tax Rules
    • Return Codes
      • Overview
      • General system return codes
      • Taxpayer return codes
      • Invoice return codes
      • Credit note return codes
      • Stock management return codes
      • Device return codes
      • Invoice industry codes
  1. Return Codes

Stock management return codes

Stock Management Return Codes are returned during product registration, product maintenance, stock movements, inventory updates, and inventory validations.
These codes are primarily used by the following EFRIS interfaces:
Product Registration (T130)
Stock In (T131)
Stock Adjustment (T139)
Kumusoft Validation Layer
The Kumusoft EFRIS API performs extensive validation before submitting requests to EFRIS. As a result, many validation errors documented in this section may never be encountered during normal API usage.
This reference is provided primarily for troubleshooting, diagnostics, support investigations, and understanding responses returned directly by the underlying EFRIS platform.
Whenever possible, validation errors are detected and reported by the Kumusoft platform before the request is submitted to EFRIS.

Stock Management Codes Summary#

Code RangeDescription
600 - 655Product Registration Validation Errors
656 - 669Stock Transaction Validation Errors
670 - 684Excise Duty and Product Configuration Errors

Product Registration Validation Errors#

These errors occur when creating or updating products.
CodeDescription
600GoodsCode cannot be empty
601GoodsCode cannot be greater than 50 characters
602GoodsCode already exists
603GoodsName cannot be empty
604GoodsName cannot be greater than 200 characters
605MeasureUnit cannot be empty
606Invalid MeasureUnit
607Unit price cannot be empty
608Unit price exceeds maximum length
609Invalid unit price value
610Unit price cannot be zero
611Unit price cannot be negative
612Currency cannot be empty
613Invalid currency
614Commodity category cannot be empty
615Commodity category exceeds maximum length
616Invalid commodity category
617Commodity category has been deleted
618Commodity category has been disabled
619Commodity category is not a leaf node
620HaveExciseTax cannot be empty
621Invalid HaveExciseTax value
622HavePieceUnit is required when HaveExciseTax = 101
623Invalid HavePieceUnit value
624Description exceeds maximum length
625Stock prewarning cannot be empty
626Stock prewarning exceeds maximum length
627Invalid stock prewarning value
628Stock prewarning cannot be zero
629Stock prewarning cannot be negative
630Piece unit price cannot be empty
631Piece unit price exceeds maximum length
632Invalid piece unit price value
633Piece unit price cannot be zero
634Piece unit price cannot be negative
635Package scaled value cannot be empty
636Package scaled value exceeds maximum length
637Invalid package scaled value
638Package scaled value cannot be zero
639Package scaled value cannot be negative
645Piece Measure Unit must be empty when HavePieceUnit = 102
646Piece Unit Price must be empty when HavePieceUnit = 102
647Package Scaled Value must be empty when HavePieceUnit = 102
648Piece Scaled Value must be empty when HavePieceUnit = 102
649Piece Measure Unit is required when HavePieceUnit = 101
650Invalid Piece Measure Unit
651Piece Scaled Value cannot be empty
652Piece Scaled Value exceeds maximum length
653Invalid Piece Scaled Value
654Piece Scaled Value cannot be zero
655Piece Scaled Value cannot be negative

Stock Transaction Validation Errors#

These errors occur when processing inventory transactions.
Applicable Interfaces:
T131 (Stock In)
T139 (Stock Adjustment)
CodeDescription
656Commodity Goods ID cannot be empty
657Commodity Goods ID exceeds maximum length
658Commodity Goods ID or Goods Code does not exist
659Quantity cannot be empty
660Quantity exceeds maximum length
661Invalid quantity value
662Quantity cannot be zero
663Quantity cannot be negative
664Unit Price cannot be empty
665Unit Price exceeds maximum length
666Invalid Unit Price value
667Unit Price cannot be zero
668Unit Price cannot be negative
669Remarks exceed maximum length

Excise Duty and Product Configuration Errors#

These errors occur when registering or maintaining products that are subject to excise duty rules.
CodeDescription
670Excise Duty Code must be empty when HaveExciseTax = 102
671Excise Duty Code is required when HaveExciseTax = 101
672Invalid Excise Duty Code
673Excise Duty Code has been deleted
674Excise Duty Code is not a leaf node
675Excise Duty Code is not effective
676Excise duty configuration requires HavePieceUnit = 101
677Package Scaled Value must equal 1 when Measure Unit equals Piece Measure Unit
678Piece Scaled Value must equal 1 when Measure Unit equals Piece Measure Unit
679Piece Measure Unit must match Excise Duty Measure Unit
680Invalid currency
681Taxpayer is not configured for Local Excise Duty
682Service products cannot participate in inventory operations
683Invalid operation type
684Product does not exist

Commonly Encountered Errors#

Code 602 - Goods Code Already Exists#

Occurs when attempting to register a product using a code that already exists.
Resolution
Use a unique product code.
Search for the existing product before creating a new one.

Code 658 - Product Does Not Exist#

Occurs when a stock transaction references a product that does not exist in EFRIS.
Resolution
Register the product first.
Verify the Goods Code or Commodity Goods ID.

Code 682 - Service Product Cannot Participate in Inventory Operations#

Occurs when inventory operations are attempted against a service item.
Resolution
Only inventory products can be used in stock operations.
Service products should be invoiced directly without inventory movements.

Best Practices#

Register products before performing stock transactions.
Use unique product codes.
Use valid units of measure obtained from Registration Details.
Validate commodity categories before product creation.
Configure excise duty settings correctly for excisable products.
Ensure inventory transactions reference existing products.
Avoid using deleted or inactive commodity categories.

Related Documentation#

Stock Management
Registration Details
Tax Rules
Units of Measure
Currency Codes
General System Return Codes
Return Codes Overview
Note: Product Registration and Stock Management are among the most heavily validated EFRIS operations. Most stock-related errors can be avoided by validating product master data before attempting inventory transactions.
Previous
Credit note return codes
Next
Device return codes
Built with