fbpx
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“
}

 

Този сайт използва бисквитки, тъй като те са важни за работата му. За повече информация и настройки, моля посетете нашата Политика за използване на бисквитки.

Затвори