Add Sales Invoice Receipts

This allows to add sale receipt for specific sale invoice(s) of a customer.

Business Rules

The followings are required information.

•	Customer Account No
•	Bank Code
•	Payment Date
•	Sale Receipt Object (Minimum 1 and maximum 50 allowed) Each Sales Receipt Object must have
•	Invoice Number
•	Amount
The Receipt 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.
CustomerAddress

String (500)

(Optional)

Full address of the Customer
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 for the transaction
PaymentMode

Enum

(Optional)

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

String (500)

(Optional)

Reference number
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 are provided 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.
Notes

String (500)

(Optional)

Notes
Receipts Object
Amount

decimal (15, 2)

*(Required)

Amount received.
GSTCode

String (20)

*(Optional)

GST Code required when GST Amount provided. Refer to Tax and Year-End in Settings to find the GST Code in Sales Tax Codes.
GSTAmount

decimal (15, 2)

(Optional)

GST Withheld Amount, if provided, GST Code is required.
WHTCode

String (20)

(Required when WHTAmount provided)

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

decimal (15, 2)

(Optional)

WHT Amount, if provided, WHT Code is Required too.
DiscountAmount

decimal (15, 2)

(Optional)

Discount Amount offered.
TotalAmount

decimal (15, 2)

*(Required)

Total Amount (Sum of Amount + GST Amount + WHT Amount + Discount Amount). This number must be less than equal to the Invoice Balance
ProjectCode

String (50)

(Optional)

Project Code linked with the project. Refer to the Projects list for Project Code.
Sample Object
{
    "ApiToken": "4b34abe417a6a986f8f751b33cbec4f7",
    "CustomerAccountNo": "1001",
    "CustomerAddress": "Lahore",
    "BankCode": "230902",
    "PaymentDate": "2022-02-23",
    "PaymentMode":"Cash",
    "RefNo":"RefNo 1",
    "Notes":"Amount Received",
    "CurrencyCode":"PKR",
    "ExchangeRate":"1",
    "Receipts": [
        {
            "InvoiceNo":"7",
            "Amount":"1000",
            "GSTCode":"GST201",
            "GSTAmount":"500",
            "WHTCode":"WHT102",
            "WHTAmount":"175.50",
            "DiscountAmount":"15",
            "TotalAmount":"1690.50",
            "ProjectCode":"PJ101"
        },
        {
            "InvoiceNo":"8",
            "Amount":"1500",
            "GSTCode":"GST202",
            "GSTAmount":"600",
            "WHTCode":"WHT101",
            "WHTAmount":"175.50",
            "DiscountAmount":"20",
            "TotalAmount":"2295.50",
            "ProjectCode":"PJ102"
        }     
    ]
}
API URL

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

Sample Response
{"Status":1,"Code":"200","Message":"The request was successfully completed.","VoucherID":"24"}
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.