Write-Offs API

Fetch a Write-Off

fetchWriteOff

GET /billing/{tenantLocator}/writeOffs/{locator}

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	locator	required

Response:WriteOffResponse
Security Group:write-offs   Permission:read

Fetch Multiple Write-Offs

fetchMultipleWriteOffs

GET /billing/{tenantLocator}/writeOffs/list

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
offset	query	int?	optional
count	query	int?	optional
accountLocator	query	locator?	optional
extended	query	boolean?	optional

Response:WriteOffListResponse
Security Group:write-offs   Permissions:read,list

WriteOffListResponse

required
listCompleted boolean
items WriteOffResponse[]

WriteOffResponse

required
locator locator
accountLocator locator
currency string
writeOffState Enum draft | distributed | reversed
amount number
creditType Enum creditDistribution | disbursement | payment | refund | shortfallWriteOff | writeOff
createdAt datetime
createdBy uuid
targets CreditItem[]

optional
reversalReason string?

Write-Off an Invoice

writeOffInvoice

PATCH /billing/{tenantLocator}/invoices/{locator}/writeOff

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	locator	required

Response:WriteOffResponse
Security Group:invoices   Permission:write

Reverse a Write-Off

reverseWriteOff

PATCH /billing/{tenantLocator}/writeOffs/{locator}/reverse

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	locator	required

Response:WriteOffResponse
Security Group:write-offs   Permission:write