Purchase credit note examples

This page provides ready-to-use purchase credit note payloads for common UAE scenarios. All examples target POST /api/purchase-credit-notes/{business_profile_id} and reference an existing purchase invoice.

How to use these examples

• Replace invoice references, profile IDs, and party identifiers with your own values.

• Ensure billing_reference points to the original purchase invoice.

• Keep discrepancy_response aligned with your business adjustment reason.

Example 1: Minimal purchase credit note

Use this for a straightforward purchase credit note with one taxable returned line. See the Minimal purchase credit note example in the right-side code samples panel.

Example 2: Purchase credit note with document-level charges and allowances

Use this when credits include freight, fees, or discounts applied at document total level. See the Purchase credit note with document-level charges + allowances example in the right-side code samples panel.

Example 3: Purchase credit note with line-level charges and allowances

Use this when adjustments must be applied on specific credited lines. See the Purchase credit note with line-level charges + allowances example in the right-side code samples panel.

Recommended progression

1. Validate with Example 1 in sandbox.

2. Add document-level adjustments using Example 2.

3. Use Example 3 when adjustments must be calculated per line.