API Docs. Elcoin Ltd

Hold Instruction. Fetch data by request POST

Get Hold Instruction data by request

# ENDPOINT

/api/holdInstruction/getData/holdInstructionSearchRequest

# REQUEST arguments

Variable	Value	Example	Usage	Description
X-App-Sig header 0	DEV-SKIP	DEV-SKIP	M	Dev Authentication

# REQUEST BODY

# RESPONSE

# REQUEST arguments

Variable	Name	Type	Format	Usage	Description
X-App-Sig	X-App-Sig	header	string	M	Dev Authentication
Example	DEV-SKIP

# REQUEST BODY

Schema: holdInstructionSearchRequest

Type: object

Variable	Name	Type	Format	Description
account	account	string		account
client_code	Client code	string		Unique client identifier. Issued automatically by the System upon new Customer registration.
create_date_from	Create date from	string
create_date_to	Create date to	string
description	description	string		Description of a given record
document_reference	document_reference	string		The unique payment ID as assigned by the ABS system upon Payment registration in the ABS
instruction_type	instruction_type	string		Type hold instruction
limit	limit	integer	int64	Count records for part data to get
offset_version	Offset version	INTEGER
offsetid	Offsetid	integer
only_active	Only active	boolean		List of allowed values in field (value=>name): 0 false 1 true
page	page	integer	int64	Part data with number of page
page_changes_version_offset	Page changes version offset	INTEGER
processing_status	Processing Status	string		Status of remote client data processing received from the external system List of allowed values in field (value=>name): 0 COMPLETED 1 PREPARE 2 PROCESSING 3 PROCESSING ERROR 4 READY 5 SENT 6 TRANSACTION
processing_step	Processing step	string		Step of remote client data processing received from the external system List of allowed values in field (value=>name): 0 ERROR 1 NORMAL
skip_total_records	Skip total records	boolean		List of allowed values in field (value=>name): 0 false 1 true

# REQUEST BODY EXAMPLE

							{
    "client_code":"EN00000G6",
    "account":"12345678900EURX"
}

# POSITIVE RESPONSE

200 - Response successfully when status is OK

Schema: holdInstruction

Type: application/json

Variable	Name	Type	Description
status	status	string	Request execution status
error_description	Error Description	string	Description of error
error	Error Code	string	Error code
data_type	data_type	string	Type of data
total_records	total_records	string	Total count of records
data	data	array	data of Response

attribute: data

Variable	Name	Type	Format	Description
account	account	string		account
account_scheme	account_scheme	string
action	Action	string
base_account	base_account	string		Base multicurrency account
client_code	Client code	string		Unique client identifier. Issued automatically by the System upon new Customer registration.
consolidated_amount_check	Consolidated amount check	boolean
create_date	Create Date	string	DATETIME	The date entry was created on
create_user	Create User	string		The username of ABS user who has created an entry
description	description	string		Description of a given record
document_reference	document_reference	string		The unique payment ID as assigned by the ABS system upon Payment registration in the ABS
error_description	Error Description	string		Description of error
form_title	form_title	string		Service field
hold_amount	hold_amount	number	decimal	Hold amount
hold_amount_agent	Hold amount agent	number
hold_amount_agent_num	Hold amount agent num	STRING
hold_amount_num	Hold amount num	double
hold_amount_tax	Hold amount tax	number
hold_amount_tax_num	Hold amount tax num	STRING
hold_balance	hold_balance	number	decimal	Hold balance
hold_balance_agent	Hold balance agent	number
hold_balance_agent_num	Hold balance agent num	STRING
hold_balance_num	Hold balance num	double
hold_balance_tax	Hold balance tax	number
hold_balance_tax_num	Hold balance tax num	STRING
hold_currency	hold_currency	string		Hold currency
hold_currency_exponenta	Hold currency exponenta	INTEGER
hold_payment_type	hold_payment_type	string		Type of hold payment
id	id	integer	INT64	Record's sequence number generated in the system.
instruction_type	instruction_type	string		Type hold instruction
insufficient_funds	insufficient_funds	boolean		Status of funds
modify_date	Modify Date	string	DATETIME	The date entry was last modified on
modify_user	Modify User	string		The username of ABS user who has made last changes to the entry
no_amount_check	No amount check	boolean
no_limits_check	No limits check	boolean
payment_type	payment_type	string		Payment type
processing_status	Processing Status	string		Status of remote client data processing received from the external system
processing_step	Processing step	string		Step of remote client data processing received from the external system
state	state	integer	INT64	Record state for replication
system	system	string
uid	uid	string		Unique record identifier which is used to distinguish between existing records
version	version	integer	INT64	Record version for replication

# RESPONSE POSITIVE EXAMPLE

							{
    "status": "ok",
    "error_description": "",
    "error": {},
    "data_type": "",
    "total_records": 3,
    "data": [
        {
            "id": 19055,
            "uid": "c27ce732-daec-d984-6b14-a4c74c510b26",
            "version": 458070981,
            "state": 0,
            "modify_date": "2020-11-02T12:53:19.988",
            "modify_user": "root",
            "create_date": "2020-06-25T18:08:52.470",
            "create_user": "jjakubova",
            "client_code": "EN00000G6",
            "base_account": "123456789000",
            "account": "12345678900EURX",
            "instruction_type": "HOLD",
            "hold_currency": "EUR",
            "hold_amount": 1.11,
            "hold_balance": 1.11,
            "document_reference": "PFEE200600GKUCUF",
            "payment_type": "",
            "description": "",
            "insufficient_funds": true,
            "processing_status": "",
            "error_description": "",
            "system": "BANK",
            "processing_step": "NORMAL",
            "hold_amount_tax": 0.00000000,
            "hold_balance_tax": 0.00000000,
            "hold_amount_agent": 0.00000000,
            "hold_balance_agent": 0.00000000,
            "account_scheme": "DEFAULT",
            "details": "154000 e-Wallet management service 01.06.2020 - 30.06.2020"
        },
        {
            "id": 85,
            "uid": "8e82eacc-b267-7487-6814-09c520787494",
            "version": 458070809,
            "state": 0,
            "modify_date": "2020-11-02T12:53:19.945",
            "modify_user": "root",
            "create_date": "2020-05-04T17:21:33.334",
            "create_user": "root",
            "client_code": "EN00000G6",
            "base_account": "123456789000",
            "account": "12345678900EURX",
            "instruction_type": "HOLD",
            "hold_currency": "EUR",
            "hold_amount": 1.05,
            "hold_balance": 1.05,
            "document_reference": "PFEE200500052A3J",
            "payment_type": "",
            "description": "",
            "insufficient_funds": true,
            "processing_status": "",
            "error_description": "",
            "system": "BANK",
            "processing_step": "NORMAL",
            "hold_amount_tax": 0.00000000,
            "hold_balance_tax": 0.00000000,
            "hold_amount_agent": 0.00000000,
            "hold_balance_agent": 0.00000000,
            "account_scheme": "DEFAULT",
            "details": "151000 Open e-Cash Account 04.05.2020"
        },
        {
            "id": 81,
            "uid": "ec117438-8055-93b6-6814-89c45066af0c",
            "version": 458070805,
            "state": 0,
            "modify_date": "2020-11-02T12:53:19.944",
            "modify_user": "root",
            "create_date": "2020-05-04T16:35:33.161",
            "create_user": "root",
            "client_code": "EN00000G6",
            "base_account": "123456789000",
            "account": "12345678900EURX",
            "instruction_type": "HOLD",
            "hold_currency": "EUR",
            "hold_amount": 0.85,
            "hold_balance": 0.85,
            "document_reference": "PFEE20050003K8ND",
            "payment_type": "",
            "description": "",
            "insufficient_funds": true,
            "processing_status": "",
            "error_description": "",
            "system": "BANK",
            "processing_step": "NORMAL",
            "hold_amount_tax": 0.00000000,
            "hold_balance_tax": 0.00000000,
            "hold_amount_agent": 0.00000000,
            "hold_balance_agent": 0.00000000,
            "account_scheme": "DEFAULT",
            "details": "154000 e-Wallet management service 08.04.2020 - 30.04.2020"
        }
    ]
}

# NEGATIVE RESPONSE

200 - Response with error when status is ERROR

Schema: HeaderResponseStatusError

Type: application/json

Variable	Name	Type	Description
status	status	string	Request execution status
error_description	Error Description	string	Description of error
error	Error Code	string	Error code
data_type	data_type	string	Type of data
total_records	total_records	string	Total count of records
data	data	object	Empty object

# Other endpoints

Name	Endpoint
Hold Instruction. Fetch data by ID / UID	/model/holdInstruction/getDb/{id}
Hold Instruction. Validate data	/model/holdInstruction/validate
Hold Instruction. Prepare data	/model/holdInstruction/prepare
Hold Instruction. Create/update data	/model/holdInstruction/putDb
Hold Instruction. Delete item by ID	/api/holdInstruction/deleteItem/{id}
Hold Instruction. Check Available Funds	/api/holdInstruction/checkAvailableFunds/holdInstructionSetModel
Hold Instruction. Set HoldInstruction	/api/setHoldInstruction/holdInstructionSetModel