Basic Information

appmixer.zoho.books.CreateInvoice

1.0.0

Public

Create an invoice for your customer.

Input Ports

in

FieldTypeDescription
Organization ID select -
Customer ID text ID of the customer.
Currency ID text The currenct id of the currency
Contact Persons text Array of contact person(s) for whom invoice has to be sent. JSON array of strings format expected, example: ["416723000000074089", "416723000000074090"] or [].
Invoice Number text Search invoices by invoice number. Variants: invoice_number_startswith and invoice_number_contains. Max-length [100]
Place of Supply 🇮🇳 , GCC only text Place where the goods/services are supplied to. (If not given, place of contact given for the contact will be taken)
VAT Treatment 🇬🇧 only text (Optional) VAT treatment for the invoices. VAT treatment denotes the location of the customer, if the customer resides in UK then the VAT treatment is uk. If the customer is in an EU country & VAT registered, you are resides in Northen Ireland and selling Goods then his VAT treatment is eu_vat_registered, if he resides outside of the UK then his VAT treatment is overseas (For Pre Brexit, this can be split as eu_vat_registered, eu_vat_not_registered and non_eu).
Tax Treatment GCC mx only text VAT treatment for the invoice .Choose whether the contact falls under: vat_registered,vat_not_registered,gcc_vat_not_registered,gcc_vat_registered,non_gcc. dz_vat_registered and dz_vat_not_registered supported only for UAE. home_country_mexico,border_region_mexico,non_mexico supported only for MX.
GST Treatment 🇮🇳 only select Choose whether the contact is GST registered/unregistered/consumer/overseas.
CFDI Usage mx only select Choose CFDI Usage.
GST No 🇮🇳 only text 15 digit GST identification number of the customer.
Reference number text The reference number of the invoice.
Template ID text ID of the pdf template associated with the invoice.
Date date-time Default date format is yyyy-mm-dd. Variants: due_date_start, due_date_end, due_date_before and due_date_after.
Payment Terms text Payment terms in days e.g. 15, 30, 60. Invoice due date will be calculated based on this. Max-length [100]
Payment Terms Label text Used to override the default payment terms label. Default value for 15 days is 'Net 15 Days'. Max-length [100]
Due Date date-time Default date format is yyyy-mm-dd. Variants: due_date_start, due_date_end, due_date_before and due_date_after.
Discount text Discount applied to the invoice. It can be either in % or in amount. e.g. 12.5% or 190. Max-length [100]
Is Discount Before Tax toggle Used to specify how the discount has to applied. Either before or after the calculation of tax.
Discount Type select How the discount is specified.
Is Inclusive Tax toggle Used to specify whether the line item rates are inclusive or exclusivr of tax.
Exchange Rate text Exchange rate of the currency.
Recurring Invoice ID text ID of the recurring invoice from which the invoice is created.
Invoiced Estimate ID text ID of the invoice from which the invoice is created.
Salesperson Name text Name of the salesperson. Max-length [200]
Custom Fields text Custom fields for an invoice. JSON array of objects expected, example: [{"customfield_id": "1", "value": "foo"}, {"customfield_id": "2", "value": "bar"}] or [].
Line items textarea JSON array of objects expected. For more details refer to Zoho Books API docs..
Payment Options text Payment options for the invoice, online payment gateways and bank accounts. Will be displayed in the pdf. JSON array of objects expected, example: {"payment_gateways": [{"configured": true, "gateway_name": "stripe"}]} or {}.
Allow Partial Payments toggle Boolean to check if partial payments are allowed for the contact
Custom Body text -
Custom Subject text -
Notes textarea The notes added below expressing gratitude or for conveying some information.
Terms textarea The terms added below expressing gratitude or for conveying some information.
Shipping Charge number Shipping charges applied to the invoice. Max-length [100]
Adjustment number Adjustments made to the invoice.
Adjustment Description text Customize the adjustment description. E.g. Rounding off.
Reason text -
Tax Authority ID 🇺🇸 only text ID of the tax authority. Tax authority depends on the location of the customer. For example, if the customer is located in NY, then the tax authority is NY tax authority.
Tax Exemption ID 🇮🇳 , 🇺🇸 only text ID of the tax exemption.
AvaTax Use Code, Avalara Integration only text Used to group like customers for exemption purposes. It is a custom value that links customers to a tax rule. Select from Avalara [standard codes][1] or enter a custom code. Max-length [25]
AvaTax Exempt No, Avalara Integration only text Exemption certificate number of the customer. Max-length [25]
Tax ID text ID of the tax.
Expense ID text -
Sales Order Item ID text ID of the sales order line item which is invoices.
AvaTax Tax Code, Avalara Integration only text A tax code is a unique label used to group Items (products, services, or charges) together. Refer the [link][2] for more deails. Max-length [25]
Time Entry IDs text IDs of the time entries associated with the project.
Ignore Auto Number Generation toggle Ignore auto invoice number generation for this invoice. This mandates the invoice number.
Send toggle Send the invoice to the contact person(s) associated with the invoice.

Output Ports

Full Metadata