3.24. New complete operation (Albania)
Connection URL
| TEST URL | http://nap.dev.icash.bg/clientapi/v1/new-complete-operation |
| PRODUCTION URL | https://v1.icash.al/clientapi/v1/new-complete-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 |
| FiscalType | Fiscal country type “AL” | String | YES |
| OperationType | Sell | OperationType | OperationType |
| CashRegisterID | Cash register ID | String(20) | YES |
| StoreID | Store ID | Integer | YES |
| ImportSource | Import software name | String | YES |
| ImportRefID | Import software referral ID (unique) | Integer | YES |
| ContragentID | Contragent id | Integer | YES |
| StornoType | Storno type | Integer | NO |
| FiskBonRcpNum | Invoice Number
(required credit/corrective) |
String | YES |
| OperationDocVod | OperationDocVod | Integer | 0,1 |
| OperationComment | Comment for operation | String | NO |
| OperationAlbaniaCurrencyCode | Currency code default ALL | String | YES |
| OperationAlbaniaCurrencyRate | Currency rate (1 for ALL) | Float | YES |
| OperationAlbaniaIsCorrective | Is corrective invoice
default false |
Boolean | YES |
| OperationAlbaniaReverseCharge | Reverce charge
Default 0 |
Integer | YES |
| OperationSaleItems | Sale items – json encoded array of items (see table below) | Json encoded array | YES |
| OperationPayments | Payments array – json encoded array of payments (see table below) | Json encoded array | YES |
| OperationAlbaniaSupplyFromDate | supply from date | date format (DD.MM.YYYY) | NO |
| OperationAlbaniaSupplyToDate | supply to date | date format (DD.MM.YYYY) | NO |
| OperationNextPayDate | next pay date | date format (DD.MM.YYYY) | NO |
JSON OperationSaleItems – Item
| Param | Description | Field type | Required |
| OperationSaleItemCurrencyCode | ALL | Integer | YES |
| SaleItemDiscount | Request status | Integer
1 – successful |
YES |
| Qty | Result | item | YES |
| SaleItemSinglePrice | |||
| SaleItemID | Item id (from get sale items) | Integer | YES |
| SaleItemTaxGroupID | Tax group ID from (get tax group) | integer | YES |
Example:
| [{„OperationSaleItemCurrencyCode“:“ALL“,“SaleItemDiscount“:0,“Qty“:1,“SaleItemSinglePrice“:10,“SaleItemID“:6,“ SaleItemTaxGroupID“:0}] |
JSON OperationPayments – payment
| Param | Description | Field type | Required |
| PaymentCardNum | Number of card | Integer | YES |
| PaymentPayTypeID | From Get payment types | integer | YES |
| PaymentSum | Amount | float | YES |
| PaymentVoucherNum | string | ||
| BankAccountID | ID from | integer | No – get first |
Example:
| [{„PaymentCardNum“:““,“PaymentPayTypeID“:1,“PaymentSum“:10,“PaymentVoucherNum“:““,”BankAccountID”:1}] |
JSON response on success
| Param | Description | Field type | Required |
| nonce | Nonce from request | Integer | YES |
| status | Request status | Integer
1 – successful |
YES |
| data | Result | invoice | YES |
| OperationID | Operation ID | integer | |
| OperationNum | Operation Number | Integer | |
| type | Sell | enum |
Structure of type “invoice”
| Param | Description | Field type | Required |
status |
Inventory number | String(20) | YES |
id |
Store ID | Integer | YES |
| FiscalData_Albania | Data for Albania | FiscalData_Albania | YES |
Structure of type “FiscalData_Albania”
| Param | Description | Field type | Required |
| DocumentAlbaniaFiscNum | FIC | String | YES |
| DocumentAlbaniaFiscError | String | Integer | YES |
Example:
| { „nonce“:“1607972518″, „status“:1, „data“: { „invoice“: { „status“:“ok“, „id“:“856″, „FiscalData_Albania“: { „DocumentAlbaniaFiscNum“:“93b3f81e-f68e-459c-a14b-97fa99375c9a“, “DocumentInvoiceNum” => “999/2021/jkskdjsdj”, “DocumentInvloiceDate” => “2021-09-30 3:55”, „DocumentAlbaniaFiscError“:““ } }, „OperationID“:7802, „OperationNum“:0, „type“:“Sell“ } } |
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“: „1552990901“, „status“: 0, „error_message“: „Session expired“ } |