Tenant Receipt Voucher Listing - GET

Tenant Receipt Voucher Listing - GET API Endpoint
StoRegister - Login

Tenant Receipt Voucher Listing API

This endpoint retrieves a list of receipts associated with the logged-in tenant. It provides details about rental transactions, including payment information, transaction ID, and related assets.

GET
/v1/transaction/voucher/receipt/list
Request Content Type
application/json
Response Content Type
application/json

Request Header

  • Authorization: X-API-Key string required

    X-API-Key is a string of letters and numbers used to authenticate and control access to the API. It can be generated in the StoRegister management application.

  • Authorization: X-Token string required

    X-Token represents the user session token. It is a string of characters that uniquely identifies the user's session.

Response Payload:

  • succeeded boolean

    Indicates whether the request to retrieve receipt information was successful.

  • status string

    Describes the status of the request to retrieve receipt information.

  • data array

    An array containing receipt information upon a successful request.

  • pagination object

    Details about pagination, including current page number, total number of pages, and overall count of items.

  • errors array

    Holds any error information if applicable.

Receipt Details

Details about the Receipt for the logged-in user.

array data

  • id unique-identifier

    Unique identifier for the receipt transaction.

  • transactDate string

    Date of the receipt transaction.

  • transactId string

    Transaction ID associated with the receipt entry.

  • transactionType string

    Type of transaction (e.g., RENTAL, etc.).

  • transactionTypeValue string

    Human-readable value corresponding to the transaction type.

  • grossAmount object

    Details about the gross amount (amount and formatted amount).

  • advanceAmount object

    Details about the advance amount (amount and formatted amount); it represents the amount the company owes to the tenant.

  • transactionAssetsInfoId unique-identifier

    Transaction assets information ID used to download the PDF document of the corresponding receipt.

Request Header

Authorization: X-API-Key --api-key--
Authorization: X-Token --user-session-token--

API Response

{
    "data": [
        {
            "id": "d721485e-cd39-48bb-aca8-47d2939956fe",
            "transactDate": "08-02-2024",
            "transactId": "CRV40",
            "transactionType": "RENTAL",
            "transactionTypeValue": "Rental",
            "grossAmount": {
                "price": 41.660,
                "formattedPrice": "41,66 €"
            },
            "advanceAmount": {
                "price": 0.000,
                "formattedPrice": "0,00 €"
            },
            "transactionAssetsInfoId": "64d9a319-b2c7-4570-b36d-5af0b9163bd5"
        },
        // ... (Additional receipt information)
    ],
    "pagination": {
        "pageNumber": 1,
        "pageCount": 1,
        "totalCount": 1
    },
    "succeeded": true,
    "status": "SUCCESS",
    "errors": null
}

Error Codes

  • INVALID_PARAM_CONTACT_BOOK_ID

    INVALID_PARAM_CONTACT_BOOK_ID refers to invalid Contact Id, please find Contact Book Id.

  • INVALID_PARAM_BUSINESS_INFO_ID

    INVALID_PARAM_BUSINESS_INFO_ID refers to invalid Buisness Id, something went wrong.

  • NO_RECORDS_FOUND

    NO_RECORDS_FOUND means there is no relevant information found.

  • FAILED

    FAILED refers to an unsuccessful API call.

  • SOMETHING_WENT_WRONG

    SOMETHING_WENT_WRONG refers to technical glitch. Please contact administrator.
API Reference documentation