3.13. New operation
(deprecated for Albania – will be replaced with other custom method)
Connection URL
| TEST URL | http://nap.dev.icash.bg/clientapi/v1/new-operation |
| ( AL ) PRODUCTION URL | – |
| ( BG ) PRODUCTION URL | https://v5.icash.bg/clientapi/v1/new-operation |
POST REQUEST
| Param | Description | Field type | Required. |
| api_key | API Key | String | YES |
| nonce | Nonce | Integer | YES |
| signature | Signature | String | YES |
| ses | Session indentificator | String | YES |
| ImportSource | Import software name | String(30) | YES |
| ImportRefID | ID from import software | String(30) | No |
| OperationType | Operation type | ENUM(Sell, ReturnClient,Delivery) | YES |
| OperationElectronicReceipt | YES – Electronic receipt without print ( No print fiscal receipt)
NO – POS ( разпечатва касов бон) |
ENUM(YES, NO)
Default NO |
No |
| CashRegisterID | Cash Register Indentificator | Integer | YES |
| StoreID | Store ID | Integer | YES |
| ContragentID | Client Indentificator | Integer | No |
| Comment | Comment | String(255) | No |
| StornoType | Type of return | ENUM(0,1,2)
Default 0 |
YES -return |
| FiskBonRcpNum | Fiscal receipt indentifier | Integer | YES -return |
| FiskDeviceNum | Number of cash register | Integer ( >= 10000000) | YES -return |
| FiskBonDate | Fiscal receipt print date time | String (DD-MM-YY HH:mm) | YES -Return |
| FiskBonUUID | UNS- Unique number of sale | String (/^([a-zA-Z0-9]{8})-([a-zA-Z0-9]{4})-(\d{7})$/) | YES -Return |
| OperationCustomStates | Custom state | String(20) | No |
JSON response on success
| Param | Description | Field type | Required |
| nonce | Nonce from request | Integer | YES |
| status | Request status | Integer
1 – successful |
YES |
| data | Result | result | YES |
Structure of type “result”
| Param | Description | Field type | Required |
| OperationID | Operation ID | Integer | YES |
| OperationFiskBonUUID | Operation unique number | String | YES-Sell
No-ReturnClient |
Example:
| { „nonce“: „1553006277“, „status“: 1, „data“: { „OperationID“: 56071, „OperationFiskBonUUID“: „DY406477-0001-0000435“ } } |
JSON response on unsuccess
| Param | Description | Field type | Required |
| nonce | Nonce from request | Integer | YES |
| status | Request status | Integer
0 – unsuccess request |
YES |
| error_message | Error Description | String | YES |
Example:
| { „nonce“: „1553006276“, „status“: 0, „error_message“: „Wrong value for OperationType“ } |