Sale credit note examples

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

How to use these examples

• Replace identifiers (document_number, billing_reference.id, party IDs) with your own values.

• Ensure billing_reference points to the original invoice being adjusted.

• Keep discrepancy_response aligned with your business reason and profile rules.

Example 1: Minimal standard credit note

Use this when issuing a straightforward credit note for returned items with standard VAT. See the Minimal example in the right-side code samples panel.

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

Use this when crediting line items while also adjusting freight, fees, or discounts. See the Sales credit note with document-level charges + allowances example in the right-side code samples panel.

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

Use this when a specific credited line needs per-line charge and allowance adjustments. See the Sales 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 your adjustments are applied at line level.