MarminDeveloper Docs
BusinessesPartnersProduct Wiki

Create a sales credit note

Creates a sales credit note conforming to UBL 2.1 specification. See the right panel for request samples and response JSON.

Path parameters
ParameterTypeRequiredDescription
business_profile_idstring
Required
The business profile ID of the supplier issuing the credit note.
Required data

  • Original sales invoice reference — Include the original invoice in billing_reference

  • Business profile identifier — Business profile ID of the supplier (in path)

  • Buyer party details — Customer party fields (name, address, tax scheme)

  • Line items being credited — At least one document line

  • Discrepancy reason — discrepancy_response (DL8.61.1 codes)

  • VAT information — Tax category and scheme per line and for charges/allowances as applicable

System behavior

  • VAT is recalculated according to UAE VAT law

  • Credit note status and transmission events are tracked

Response

Status code: 201 Created

Returns the created credit note object with all calculated fields populated.

Error responses
StatusDescription
400 Bad RequestInvalid request parameters or validation failed. For validation errors, the response includes field-specific errors.
401 UnauthorizedAuthentication required or invalid token.
413 Request Entity Too LargeThe request payload size exceeds the allowed limit of 8MB.
500 Internal Server ErrorAn error occurred while processing the request.
Next