- Auth
- Account Ledger
- Activity Log
- Announcement
- Asset
- Sales
- GetTotalRevenue
- GetTotalReceivables
- GetTotalInwardPayment
- GetTotalOverDuePayment
- SalesRatio
- GetGrowthByMonth
- GetGrowthByQuarter
- GetGrowthByYear
- GetSnapshotReceivables
- GetSalesByInvoiceTypes
- GetIncomeByInvoiceTypes
- GetGstInvoices
- GetRecurringInvoices
- GetClientsAcquired
- GetSalesByMonthGraph
- GetSalesByYearGraph
- GetSalesByProductGraph
- GetSalesByServiceGraph
- GetSalesByClientGraph
- GetSalesByCountryGraph
- GetSalesByUserGraph
- GetRevenueBySource
- GetSalesByRegionGraph
- Client
- Client Ledger
- CreditNote
- Cron-jobs
- Currency Conversion
- Document
- Discount
- Employee
- GetEmployeesByMonth
- GetEmployees
- AddEmployee
- GetEmployeeDetail
- UpdateEmployee
- DeleteEmployee
- FileImport
- UpdateSalaryComponent
- UpdateFileUrl
- UpdateInvoiceNumber
- PrepareSalaryComponents
- UpdateEmployeeName
- UpdateEmployeeEmail
- UpdateEmployeePhone
- UpdateEmployeeDob
- UpdateEmployeeLocation
- UpdateEmployeePanNumber
- UpdateEmployeeAdharNumber
- UpdateEmployeeEsiNumber
- UpdateEmployeeEpsNumber
- UpdateEmployeeUanNumber
- UpdateEmployeePfNumber
- UpdateEmployeeCountry
- UpdateEmployeeBankAccountDetails
- UpdateEmployeeCurrentAddress
- UpdateEmployeePermanentAddress
- LinkUser
- UpdateEmployeeDocumentInfo
- UpdateEmployeeProfilePicture
- Email
- Expense
- File
- Hr
- Inventory Ledger
- Invoice
- Item
- Organization
- GetOrganizations
- AddOrganization
- UpdateOrganization
- GetOrganizationDetail
- DeleteOrganization
- UpdateOrganizationBusinessProfile
- ExtendSubscription
- UpdateGSTDetails
- UpdateVATDetails
- UpdateInvoiceOnOrderSetting
- UpdateReminderSetting
- UpdateInvoiceSettings
- UpdatePurchaseOrderSettings
- UpdateProposalSettings
- UpdatePreferences
- GetOrganizationPreferences
- UpdatePaymentSettings
- UpdateDefaultPaymentSettings
- UpdateLogo
- UpdateFromEmail
- OrganizationDeactive
- GetOrganizationSubscriptions
- GetOrganizationDashboardView
- GetOrganizationDashboardSnapshot
- GetSnapshotReceivables
- DeleteSelectiveData
- DeletePermanent
- GetClientCountries
- GetVendorCountries
- GetLeadCountries
- InviteUsers
- AcceptInvitation
- UpdatePlatformCredits
- UpdateCreditNoteSettings
- UpdateDebitNoteSettings
- Order
- Outward Payment
- Operations
- Payment
- Product
- Proposal
- Platform Plan
- Platform Subscription
- Platform Payment
- ProductCategory
- Purchase Order
- Purchase
- Recurring Expense
- Recurring Invoice
- Report
- GetSalesByClient
- GetSalesByProduct
- GetSalesByProductCategory
- GetSalesByService
- GetSalesByMonth
- GetSalesByYear
- GetSalesByQuarter
- GetSalesByCountry
- GetTaxSummary
- GetInvoiceDetailReport
- GetExpensesByMonth
- GetProfitAndLossReportV2
- GetBalanceSheetReport
- GetTrialBalanceReport
- GetGeneralLedger
- GetSalesByHsn
- GetTaxesByMonth
- GetOtherSales
- Routes
- Settlement
- Services
- Tax
- Trip
- User
- User Invites
- Vendor
- Vendor Ledger
- Projects
- Pre Sales
- Task
- Payroll
- Account
- Enquiry
- Account Transfer
- File Import
- File Import Error
- Brand
- Salary Component
- Leaves Configuration
- Tax Calendar
- Contract
- GST-Reports
- Organization Backup
- Bank Account
- Leave Policy
- Leave Application
- Backup Restore
- Finance
- Email-Rule
- Widget
- User Dashboard
- ExpenseCategory
- Lead
- LeadActivity
- Deal
- DebitNote
- SpendCategory
- SpendPolicy
- Employee Spend
- Warehouse
- Branch
CancelInvoice
PATCH
https://api.upbooks.io/api/v1/invoice/{id}/cancel
Request
Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.Example:
Authorization: Bearer ********************Path Params
id
stringÂ
required
Header Params
ORGANIZATION-ID
stringÂ
optional
Example:
000000
Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://api.upbooks.io/api/v1/invoice//cancel' \
--header 'ORGANIZATION-ID: 000000'Responses
🟢200Ok
application/json
Body
data
object (InvoiceDocumentJSON)Â
required
createdAt
string <date-time>
required
updatedAt
string <date-time>
required
__v
number <double>
optional
_id
stringÂ
required
organizationId
stringÂ
required
orders
array[object (IOrderInvoice) {2}]  | nullÂ
optional
orderNumber
string  | nullÂ
optional
invoiceNumber
stringÂ
required
referenceNumber
string  | nullÂ
optional
invoiceDate
string <date-time>
required
dateTime
string <date-time>
required
dueDate
string <date-time>
required
invoiceFile
stringÂ
optional
invoiceStaticFile
stringÂ
optional
status
enum<string>Â
required
Allowed values:
draftconfirmedsentpaidcancelledpartially-paidpartiallyInvoiced
currency
object (ICommonCurrency)Â
optional
currencyConversionRate
object (ICommonCurrencyConversionRate)Â
required
finalAmount
number <double> | nullÂ
optional
taxAmount
number <double> | nullÂ
optional
totalAmount
number <double> | nullÂ
optional
discountAmount
number <double> | nullÂ
optional
terms
string  | nullÂ
optional
notes
string  | nullÂ
optional
client
object (ICommonClient)Â
required
payment
objectÂ
optional
reminders
array [object {2}]Â
optional
nextReminderDue
string <date-time> | nullÂ
optional
recurring
objectÂ
optional
notification
array[object (ICommonNotification) {7}]Â
optional
paidDate
string <date-time> | nullÂ
optional
taxIds
array[string]Â |Â nullÂ
optional
discountIds
array[string] Â |Â nullÂ
optional
taxCalculationMode
optional
salesPerson
array[object (ICommonEmployee) {7}]  | nullÂ
optional
invoiceType
enum<string>Â
optional
Allowed values:
B2BB2CLB2CSEXPORTNILEXEMPT
tax
array[object (ITaxRequest) {11}]  | nullÂ
optional
discount
array[object (IDiscountRequest) {8}]  | nullÂ
optional
bankAccount
optional
taxPerItem
boolean  | nullÂ
optional
discountPerItem
boolean  | nullÂ
optional
taxSummary
boolean  | nullÂ
optional
customInvoiceNumber
boolean  | nullÂ
optional
error
array[object (ICommonErrors) {3}]  | nullÂ
optional
items
array[object (IIinvoiceItem) {14}]Â
optional
message
stringÂ
optional
Example
{
"data": {
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"__v": 0,
"_id": "string",
"organizationId": "string",
"orders": [
{
"orderId": "string",
"orderNumber": "string"
}
],
"orderNumber": "string",
"invoiceNumber": "string",
"referenceNumber": "string",
"invoiceDate": "2019-08-24T14:15:22Z",
"dateTime": "2019-08-24T14:15:22Z",
"dueDate": "2019-08-24T14:15:22Z",
"invoiceFile": "string",
"invoiceStaticFile": "string",
"status": "draft",
"currency": {
"name": "string",
"symbol": "string"
},
"currencyConversionRate": {
"USD": 0,
"EUR": 0,
"GBP": 0,
"INR": 0,
"AUD": 0,
"SGD": 0,
"CAD": 0,
"JPY": 0,
"CNY": 0,
"SAR": 0,
"AED": 0
},
"finalAmount": 0,
"taxAmount": 0,
"totalAmount": 0,
"discountAmount": 0,
"terms": "string",
"notes": "string",
"client": {
"id": "string",
"name": "string",
"clientType": "business",
"billingAddress": {
"locationName": "string",
"street1": "string",
"street2": "string",
"pincode": "string",
"city": "string",
"state": "string",
"country": "string"
},
"contacts": [
{
"isPrimary": true,
"salutation": "Mr.",
"firstName": "string",
"lastName": "string",
"email": "string",
"workPhone": "string",
"mobilePhone": "string",
"designation": "string",
"department": "string"
}
],
"shippingAddress": {
"locationName": "string",
"street1": "string",
"street2": "string",
"pincode": "string",
"city": "string",
"state": "string",
"country": "string"
},
"tax": {
"taxTreatment": "GST",
"taxNumber": "string",
"taxes": [
{
"id": "string",
"name": "string",
"percentage": 0
}
]
}
},
"payment": {
"razorpay": {
"url": "string",
"paymentLinkId": "string"
}
},
"reminders": [
{
"sentOn": "2019-08-24T14:15:22Z",
"type": "first"
}
],
"nextReminderDue": "2019-08-24T14:15:22Z",
"recurring": {
"id": "string",
"frequency": "string",
"enabled": true
},
"notification": [
{
"type": "string",
"mode": "string",
"sentOn": "2019-08-24T14:15:22Z",
"to": "string",
"cc": [
"string"
],
"bcc": [
"string"
],
"subject": "string"
}
],
"paidDate": "2019-08-24T14:15:22Z",
"taxIds": [
"string"
],
"discountIds": [
"string"
],
"taxCalculationMode": "before-discount",
"salesPerson": [
{
"id": "string",
"name": "string",
"employeeNumber": "string",
"email": "string",
"phone": "string",
"type": "full-time",
"employment": [
{
"id": "string",
"isCurrent": true,
"dateOfJoining": "2019-08-24T14:15:22Z",
"dateOfLeaving": "2019-08-24T14:15:22Z",
"specialSchemes": [
{
"enabled": true,
"name": "ESI"
}
],
"salary": {
"componentGroup": {
"id": "string",
"groupName": "string",
"salaryCalculationMode": "month-days",
"sandwichLeaves": true
},
"type": "hourly",
"ctc": 0,
"gross": 0,
"net": 0,
"currency": {
"name": "string",
"symbol": "string"
},
"components": [
{
"name": "string",
"code": "BASIC",
"type": "EARNINGS",
"isTaxable": true,
"isAttendanceBased": true,
"isIncludedInCTC": true,
"isActive": true,
"_id": "string",
"value": {
"amount": 0,
"currency": {
"name": "string",
"symbol": "string"
}
},
"formula": "string",
"custom": true,
"salaryComponentId": "string",
"amount": 0
}
]
},
"designation": "string",
"role": "string",
"supervisor": {},
"leavePolicies": [
{
"id": "string",
"name": "string",
"leaves": [
{
"type": "string",
"probationPeriod": 0,
"noOfLeaves": 0,
"monthlyLimit": 0
}
]
}
],
"spendPolicies": [
{
"id": "string",
"title": "string"
}
]
}
]
}
],
"invoiceType": "B2B",
"tax": [
{
"id": "string",
"name": "string",
"percentage": 0,
"sysgenerated": true,
"amount": 0,
"currency": {
"name": "string",
"symbol": "string"
},
"identifier": "string",
"slab": 0,
"type": "igst",
"taxableAmount": 0,
"regions": [
"string"
]
}
],
"discount": [
{
"id": "string",
"type": "percentage",
"value": 0,
"name": "string",
"discountCode": "string",
"currency": {
"name": "string",
"symbol": "string"
},
"sysgenerated": true,
"amount": 0
}
],
"bankAccount": {
"title": "string",
"currency": {
"name": "string",
"symbol": "string"
},
"accountDetails": {
"sortCode": "string",
"IBANNumber": "string",
"swiftCode": "string",
"ifscCode": "string",
"branch": "string",
"bankName": "string",
"accountNumber": "string",
"name": "string"
}
},
"taxPerItem": true,
"discountPerItem": true,
"taxSummary": true,
"customInvoiceNumber": true,
"error": [
{
"code": "string",
"title": "string",
"dateTime": "2019-08-24T14:15:22Z"
}
],
"items": [
{
"name": "string",
"amount": 0,
"currency": {
"name": "string",
"symbol": "string"
},
"quantity": 0,
"totalAmount": 0,
"taxAmount": 0,
"discountAmount": 0,
"finalAmount": 0,
"hsnCode": "string",
"product": {
"id": "string",
"name": "string",
"amount": 0,
"hsnCode": "string",
"unit": "mm",
"currency": {
"name": "string",
"symbol": "string"
},
"thumbnail": "string",
"productCategories": [
{
"id": "string",
"title": "string",
"thumbnail": "string",
"description": "string"
}
]
},
"service": {
"id": "string",
"title": "string",
"thumbnail": "string",
"paymentType": "one-time",
"paymentFrequency": 0,
"amount": 0,
"hsnCode": "string",
"currency": {
"name": "string",
"symbol": "string"
}
},
"tax": [
{
"id": "string",
"name": "string",
"percentage": 0,
"sysgenerated": true,
"amount": 0,
"currency": {
"name": "string",
"symbol": "string"
},
"identifier": "string",
"slab": 0,
"type": "igst",
"taxableAmount": 0,
"regions": [
"string"
]
}
],
"discount": [
{
"id": "string",
"type": "percentage",
"value": 0,
"name": "string",
"discountCode": "string",
"currency": {
"name": "string",
"symbol": "string"
},
"sysgenerated": true,
"amount": 0
}
],
"orderId": "string"
}
]
},
"message": "string"
}🟢200Success
Modified at 2024-04-09 11:08:31