Write-Offs API

Endpoint Index

Action	Endpoint
Fetch a Write-Off	GET /billing/{tenantLocator}/writeOffs/{locator}
Fetch Multiple Write-Offs	GET /billing/{tenantLocator}/writeOffs/list
Write-Off an Invoice	PATCH /billing/{tenantLocator}/invoices/{locator}/writeOff
Reverse a Write-Off	PATCH /billing/{tenantLocator}/writeOffs/{locator}/reverse

Fetch a Write-Off

fetchWriteOff

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

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	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	string?	optional
extended	query	boolean?	optional

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

WriteOffListResponse

required
listCompleted boolean
items WriteOffResponse[]

WriteOffResponse

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

optional
reversalReason string?

Write-Off an Invoice

writeOff

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

Request Parameters:

Name	Position	Type	Required
tenantLocator	path	uuid	required
locator	path	string	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	string	required

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