Add Unallocated Sale Receipt

A sales receipt is a transaction which records the receipts of the amount from a customer.

Business Rules

The followings must be present to record a sale receipt

•	Customer Account No
•	Bank Code
•	Payment Date
•	Amount

In case of multiple sale receipts, maximum of 50 transactions are allowed in one API call.

The Receipts Object
ApiToken

String

*(Required)

API authorisation token obtained via authentication API.
CustomerAccountNo

String (50)

*(Required)

Account no. allocated to the customer, refer to the customer list for account no. information.
BankCode

String (20)

*(Required)

Bank Account Code is defined in the Chart of Accounts. The Currency of the Bank Account and Customer Account must match.
PaymentDate

Date (YYYY-MM-DD)

*(Required)

Payment Date
PaymentMode

Enum

(Optional)

Payment Mode ('Cash','Cheque','Credit Card','Offset','Online','Pay Order').
RefNo

String (500)

(Optional)

Reference number
Amount

decimal (15, 2)

*(Required)

Amount received.
WHTCode

String (20)

*(Optional)

Withholding Tax Code. Refer to Tax and Year-end in settings to find the Withholding Tax Codes. This is required when WHT Amount is provided.
WHTAmount

decimal (15, 2)

(Optional)

WHT Amount
Notes

String (500)

(Optional)

Notes
CurrencyCode

String (5)

*(Optional)

Required for foreign Currency Transactions. Currency code for the Bank Account, e.g. PKR or USD. The Bank and Customer Currency Codes must match. Currency Codes can be found in the Currencies List.
ExchangeRate

decimal (15, 8)

*(Optional)

The exchange rate for foreign currency transactions. Base Currency to Foreign Currency. Required when a foreign currency transaction is recorded.
Sample Object
{
    "ApiToken": "13059c5c63849edbc32b234d6da8a82b",
    "Receipts": [
        {
            
            "CustomerAccountNo": "1001",
            "BankCode": "230901",
            "PaymentDate": "2022-02-23",
            "PaymentMode":"Cash",
            "RefNo":"RefNo 1",
            "Amount":"5000",
            "WHTCode":"WHT102",
            "WHTAmount":"500",
            "Notes":"Amount Received",
            "CurrencyRef":"PKR",
            "ExchangeRate":"1"
        },
        {
            
            "CustomerAccountNo": "1002S",
            "BankCode": "230901",
            "PaymentDate": "2022-02-23",
            "PaymentMode":"Cash",
            "RefNo":"RefNo 2",
            "Amount":"5000",
            "WHTCode":"WHT102",
            "WHTAmount":"500",
            "Notes":"Amount Received",
            "CurrencyRef":"PKR",
            "ExchangeRate":"1"
        }     
    ]
}
API URL

https://api.fastaccounts.io/index.php/api/invoice/unallocated_receipt

Sample Response
{"Status":1,"Code":"200","Message":"The request was successfully completed.","VoucherID":"29,30"}
Status Codes
Status Code Type Message
200 Success The request was successfully completed.
201 Error Invalid Key Details.
202 Error Data is not valid in API request.
203 Error Data is not valid in API products.
204 Error Validation failed.
205 Error Invalid IP Address.
400 Error Bad Request.
403 Error Forbidden.
404 Error Not Found.
500 Error Internal Server Error.