iotoms Docs

Get a customer receipt

GET
/api/v1/receivables/receipts/{id}

Returns one customer receipt by id, with the sales it was allocated to and how much is left on account. A reversal receipt also shows which receipt it reverses and why.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Path Parameters

id*string

ID of the record (UUID).

Formatuuid

Header Parameters

X-TenantID*string

Your merchant's tenant code — the value typed in the Domain field on the iotoms login screen. See Concepts.

Response Body

OK

*/*
  1. response
status*string

Outcome of the call: SUCCESS when the request was processed; otherwise an error status.

message*string

Short human-readable message describing the outcome, e.g. which record was saved or why the call failed.

data?

The customer receipt with its allocations.

Example Request
curl -X GET 'https://beta.iotoms.com/api/v1/receivables/receipts/497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'X-TenantID: your-tenant-code'
Example Response
{  "status": "string",  "message": "string",  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "receiptNumber": "string",    "customerNumber": "string",    "amount": 0,    "allocatedAmount": 0,    "unallocatedAmount": 0,    "mode": "CASH",    "status": "POSTED",    "reference": "string",    "receivedOn": "2019-08-24",    "notes": "string",    "dayCycleId": "bbed7a30-80be-4ccf-810d-a33c370a67d1",    "collectedBy": "string",    "reversalOfId": "91205805-6131-4e22-87c1-99e3bbb30d9b",    "reversalReason": "string",    "allocations": [      {        "transactionId": "75906707-8c31-479c-b354-aa805c4cefbc",        "invoiceNumber": "string",        "amount": 0      }    ],    "createdAt": "2019-08-24T14:15:22Z",    "createdBy": "string"  }}