Retrieves a list of purchase order receipts

Returns every delivery received on your Purchase Orders — one receipt each time items were received in the app (or through receivePurchaseOrder) — with the invoice number, invoice date, received date and the quantity received for each line.

Endpoint: https://po.mimoran.com/api/v1/graphql.php

query {
    purchaseOrderReceipts(
        since: 1 //int, optional - only receipts with receipt_id greater than this value
        limit: 50 //int, optional - default 50, max 250
        from_received_date: "string" //optional, format Y-m-d - eg: 2026-11-01
        to_received_date: "string" //optional, format Y-m-d - eg: 2026-11-30 (this day is included)
    ) {
        receipt_id
        purchase_order_id
        purchase_code
        received_date //format Y-m-d
        invoice_number
        invoice_date //returned exactly as entered
        note
        location_id
        location_name
        undone //true if this receipt was undone in the app
        undone_at //format Y-m-d H:i:s, null if not undone
        items {
            purchase_order_product_id
            variant_id
            product_sku
            qty_received //quantity received for this line in this delivery
        }
    }
}

Notes:

• Receipts are returned in ascending receipt_id order. To keep in sync, store the highest receipt_id you have read and pass it as since on the next call. Repeat until the result is empty.
• Prefer since over the date filters for syncing: the received date can be set to an earlier day when receiving, so a new receipt may carry a past date.
• A receipt that is undone after you have read it is not returned again by since. To check the current state of a Purchase Order's receipts, use purchaseOrder and read receipts[].undone.
• An invalid date returns an error such as from_received_date must be YYYY-MM-DD.
• Supplier tax registration numbers (TRN) are available as account_number in suppliers.