Create a credit note

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

x-monite-versionstringRequired
x-monite-entity-idstringRequired
The ID of the entity that owns the requested resource.

Request

This endpoint expects an object.
document_idstringRequired<=255 characters
A unique credit note number assigned by the credit note issuer for tracking purposes
issued_atstringRequiredformat: "date"

The date when the credit note was issued, in the YYYY-MM-DD format

based_onstringOptionalformat: "uuid"
ID of the payable this credit note is based on. The credit note will be linked to this payable
based_on_document_idstringOptional<=255 characters
The document ID of the original payable that this credit note refers to
counterpart_address_idstringOptionalformat: "uuid"
The ID of the counterpart's address
counterpart_bank_account_idstringOptionalformat: "uuid"
The ID of the counterpart's bank account
counterpart_idstringOptionalformat: "uuid"

The ID of the counterpart (vendor/supplier)

counterpart_vat_id_idstringOptionalformat: "uuid"
The ID of the counterpart's VAT registration
currencyenumOptional
The currency code of the credit note
descriptionstringOptional<=255 characters
An arbitrary description of this credit note
project_idstringOptionalformat: "uuid"
The ID of the project this credit note belongs to
senderstringOptional<=255 characters
The email address from which the credit note was received
subtotalintegerOptional>=0
The subtotal amount before taxes
tag_idslist of stringsOptional
List of tag IDs associated with this credit note
taxintegerOptional>=0<=10000
The tax percentage applied to the subtotal
tax_amountintegerOptional>=0
The calculated tax amount
total_amountintegerOptional>=0
The total amount including taxes

Response

Successful Response
idstringformat: "uuid"
The unique identifier of the credit note
created_atdatetime
Date and time when the credit note was created in the system
updated_atdatetime
Date and time of the last update to the credit note
entity_idstringformat: "uuid"
The ID of the entity to which the credit note belongs
originstring<=128 characters
The origin or source system of the credit note
source_of_datastring<=128 characters

How the data was input (ocr/user_specified)

statusstring<=30 characters
The current status of the credit note in its lifecycle
based_onstring or nullformat: "uuid"
ID of the payable this credit note is based on
based_on_document_idstring or null<=255 characters
The document ID of the original payable that this credit note refers to
counterpartobject or null

Object representing de-normalized counterpart data

counterpart_address_idstring or nullformat: "uuid"
ID of the counterpart's address
counterpart_bank_account_idstring or nullformat: "uuid"
ID of the counterpart's bank account
counterpart_idstring or nullformat: "uuid"
ID of the counterpart
counterpart_rawobject or null
Object representing counterpart data which was extracted by OCR. Used for informational purposes.
counterpart_vat_id_idstring or nullformat: "uuid"
ID of the counterpart's VAT registration
created_by_external_user_idstring or null<=255 characters
External system's user ID for the creator
created_by_external_user_namestring or null<=255 characters
Name of the external user who created the credit note
created_by_user_idstring or nullformat: "uuid"
ID of the user who created the credit note
currencystring or null<=5 characters
The currency code
currency_exchangeobject or null
descriptionstring or null<=255 characters
Description of the credit note
document_idstring or null<=255 characters
The credit note's unique document number
file_idstring or nullformat: "uuid"
The id of the credit note file stored in the file saver.
file_urlstring or null
The URL of the credit note file stored in the file saver.
issued_atstring or nullformat: "date"
Date when the credit note was issued
ocr_request_idstring or nullformat: "uuid"
ID of the OCR processing request
ocr_statusstring or null<=10 characters
Status of OCR processing
project_idstring or nullformat: "uuid"
ID of the associated project
senderstring or null<=255 characters
Email address of the sender
subtotalinteger or null
The subtotal amount before taxes
tagslist of objects or null
List of tags associated with this credit note
taxinteger or null
The tax percentage
tax_amountinteger or null
The calculated tax amount
total_amountinteger or null
The total amount including taxes

Errors