openapi: 3.0.0
info:
title: batches vendor-credits API
description: Batches help you track inventory items by batch numbers, manufacturing dates, and expiration dates.
contact: {}
version: 1.0.0
servers:
- url: https://www.zohoapis.com/inventory/v1
description: API Endpoint
tags:
- name: vendor-credits
description: Vendor-Credits Module
paths:
/vendorcredits:
x-mcp-group:
- Vendor Credits
parameters:
- $ref: '#/components/parameters/organization_id'
post:
tags:
- vendor-credits
operationId: create_vendor_credit
summary: Create a vendor credit
description: Create a vendor credit for a vendor.
parameters:
- name: ignore_auto_number_generation
in: query
description: Ignore auto number generation for this vendor credit only. On enabling this option vendor credit number is mandatory.
required: false
schema:
type: boolean
- name: bill_id
in: query
description: Bill Associated with the Vendor Credit
required: false
schema:
type: string
example: '460000000057075'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/create-a-vendor-credit-request'
responses:
'201':
description: Created
content:
application/json:
schema:
$ref: '#/components/schemas/create-a-vendor-credit-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.debitnotes.CREATE
get:
tags:
- vendor-credits
operationId: list_vendor_credits
summary: List vendor credits
description: List vendor credits with pagination.
parameters:
- name: vendor_credit_number
in: query
description: 'Search vendor credits by vendor credit number. Variants: vendor_credit_number_startswith and vendor_credit_number_contains'
required: false
schema:
type: string
example: DN-00002
- name: date
in: query
description: 'General Format: yyyy-mm-dd. Search vendor credits by date. Variants: date.start, date.end, date.before and date.after'
required: false
schema:
type: string
example: '2014-08-28'
- name: status
in: query
description: 'Search vendor credits by vendor credit status. Allowed statuses are open, closed and void. Allowed Values: open, closed and void'
required: false
schema:
type: string
example: open
- name: total
in: query
description: 'Search vendor credits by total amount. Variants: total_start, total_end, total_less_than, total_less_equals, total_greater_than and total_greater_equals'
required: false
schema:
type: string
example: 30
- name: reference_number
in: query
description: 'Search vendor credits by vendor credit reference number. Variants: reference_number_startswith and reference_number_contains'
required: false
schema:
type: string
example: ''
- name: customer_name
in: query
description: 'Search vendor credits by vendor name. Variants: customer_name_startswith and customer_name_contains'
required: false
schema:
type: string
example: Bowman and Co
- name: item_name
in: query
description: 'Search vendor credits by item name. Variants: item_name_startswith and item_name_contains'
required: false
schema:
type: string
example: ''
- name: item_description
in: query
description: 'Search vendor credits by vendor credit item description. Variants: item_description_startswith and item_description_contains'
required: false
schema:
type: string
example: ''
- name: notes
in: query
description: 'Search vendor credits by vendor credit notes. Variants: notes_startswith and notes_contains'
required: false
schema:
type: string
example: ''
- name: custom_field
in: query
description: 'Search vendor credits by custom field. Variants : custom_field_startswith and custom_field_contains'
required: false
schema:
type: string
example: ''
- name: last_modified_time
in: query
description: Search vendor credits by vendor credit last modfified time
required: false
schema:
type: string
example: 2014-08-28T22:53:31-0700
- name: customer_id
in: query
description: Search vendor credits by vendor credit customer ID
required: false
schema:
type: string
example: ''
- name: line_item_id
in: query
description: Search vendor credits by vendor credit line item ID
required: false
schema:
type: string
example: '460000000020077'
- name: item_id
in: query
description: Search vendor credits by vendor credit item ID
required: false
schema:
type: string
example: '460000000020071'
- name: tax_id
in: query
description: Search vendor credits by vendor credit tax ID
required: false
schema:
type: string
example: ''
- name: filter_by
in: query
description: 'Filter vendor credits by statuses. Allowed Values: Status.All, Status.Open, Status.Draft, Status.Closed and Status.Void.'
required: false
schema:
type: string
example: ''
- name: search_text
in: query
description: Search vendor credits by vendor credit number or vendor name or vendor credit reference number.
required: false
schema:
type: string
example: ''
- name: sort_column
in: query
description: 'Sort vendor credits by following columns vendor_name, vendorcredit_number, balance, total, date and created_time. Allowed Values: vendor_name, vendor_credit_number, balance, total, date, created_time, last_modified_time and reference_number.'
required: false
schema:
type: string
example: created_time
- name: page
in: query
description: Page number to be fetched. Default value is 1.
required: false
schema:
type: integer
default: 1
example: 1
- name: per_page
in: query
description: Number of records to be fetched per page. Default value is 200.
required: false
schema:
type: integer
default: 200
example: 200
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/list-vendor-credits-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.debitnotes.READ
/vendorcredits/{vendor_credit_id}:
x-mcp-group:
- Vendor Credits
parameters:
- name: vendor_credit_id
in: path
required: true
description: Unique identifier of the vendor credit.
schema:
type: string
example: '3000000002075'
- $ref: '#/components/parameters/organization_id'
put:
tags:
- vendor-credits
operationId: update_vendor_credit
summary: Update vendor credit
description: Update an existing vendor credit.
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/update-vendor-credit-request'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/update-vendor-credit-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.debitnotes.UPDATE
get:
tags:
- vendor-credits
operationId: get_vendor_credit
summary: Get vendor credit
description: Get details of a vendor credit.
parameters:
- name: print
in: query
description: 'Export vendor credit pdf with default print option. Allowed Values: true, false, on and off.'
required: false
schema:
type: boolean
- name: accept
in: query
description: 'You can get vendor credit details as json/pdf/html. Default format is html. Allowed Values: json, xml, csv, xls, pdf, html and jhtml.'
required: false
schema:
type: string
example: ''
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/get-vendor-credit-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.debitnotes.READ
delete:
tags:
- vendor-credits
operationId: delete_vendor_credit
summary: Delete vendor credit
description: Delete a vendor credit.
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/delete-vendor-credit-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.debitnotes.DELETE
/vendorcredits/{vendor_credit_id}/status/open:
x-mcp-group:
- Vendor Credits
parameters:
- name: vendor_credit_id
in: path
required: true
description: Unique identifier of the vendor credit.
schema:
type: string
example: '3000000002075'
- $ref: '#/components/parameters/organization_id'
post:
tags:
- vendor-credits
operationId: mark_vendor_credit_as_open
summary: Convert to open
description: Change an existing vendor credit status to open.
responses:
'201':
description: Created
content:
application/json:
schema:
$ref: '#/components/schemas/convert-to-open-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.debitnotes.CREATE
/vendorcredits/{vendor_credit_id}/status/void:
x-mcp-group:
- Vendor Credits
parameters:
- name: vendor_credit_id
in: path
required: true
description: Unique identifier of the vendor credit.
schema:
type: string
example: '3000000002075'
- $ref: '#/components/parameters/organization_id'
post:
tags:
- vendor-credits
operationId: mark_vendor_credit_as_void
summary: Void vendor credit
description: Mark an existing vendor credit as void.
responses:
'201':
description: Created
content:
application/json:
schema:
$ref: '#/components/schemas/void-vendor-credit-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.debitnotes.CREATE
/vendorcredits/{vendor_credit_id}/submit:
x-mcp-group:
- Vendor Credits
parameters:
- name: vendor_credit_id
in: path
required: true
description: Unique identifier of the vendor credit.
schema:
type: string
example: '3000000002075'
- $ref: '#/components/parameters/organization_id'
post:
tags:
- vendor-credits
operationId: submit_vendor_credit
summary: Submit a Vendor credit for approval
description: Submit a Vendor credit for approval.
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/submit-a-vendor-credit-for-approval-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.debitnotes.CREATE
/vendorcredits/{vendor_credit_id}/approve:
x-mcp-group:
- Vendor Credits
parameters:
- name: vendor_credit_id
in: path
required: true
description: Unique identifier of the vendor credit.
schema:
type: string
example: '3000000002075'
- $ref: '#/components/parameters/organization_id'
post:
tags:
- vendor-credits
operationId: approve_vendor_credit
summary: Approve a Vendor credit
description: Approve a Vendor credit.
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/approve-a-vendor-credit-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.debitnotes.CREATE
/vendorcredits/{vendor_credit_id}/bills:
x-mcp-group:
- Vendor Credits
parameters:
- name: vendor_credit_id
in: path
required: true
description: Unique identifier of the vendor credit.
schema:
type: string
example: '3000000002075'
- $ref: '#/components/parameters/organization_id'
get:
tags:
- vendor-credits
operationId: list_vendor_credited_bills
summary: List bills credited
description: List bills to which the vendor credit is applied.
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/list-bills-credited-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.debitnotes.READ
post:
tags:
- vendor-credits
operationId: apply_vendor_credit_to_bill
summary: Apply credits to a bill
description: Apply vendor credit to existing bills.
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/apply-credits-to-a-bill-request'
responses:
'201':
description: Created
content:
application/json:
schema:
$ref: '#/components/schemas/apply-credits-to-a-bill-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.debitnotes.CREATE
/vendorcredits/{vendor_credit_id}/bills/{vendor_credit_bill_id}:
x-mcp-group:
- Vendor Credits
parameters:
- name: vendor_credit_id
in: path
required: true
description: Unique identifier of the vendor credit.
schema:
type: string
example: '3000000002075'
- $ref: '#/components/parameters/organization_id'
delete:
tags:
- vendor-credits
operationId: delete_vendor_credited_bill
summary: Delete bills credited
description: Delete the credits applied to a bill.
parameters:
- name: vendor_credit_bill_id
in: path
required: true
description: Unique identifier of the vendor credit bill.
schema:
type: string
example: '460000000057075'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/delete-bills-credited-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.debitnotes.DELETE
/vendorcredits/{vendor_credit_id}/refunds:
x-mcp-group:
- Vendor Credits
parameters:
- name: vendor_credit_id
in: path
required: true
description: Unique identifier of the vendor credit.
schema:
type: string
example: '3000000002075'
- $ref: '#/components/parameters/organization_id'
post:
tags:
- vendor-credits
operationId: refund_vendor_credit
summary: Refund a vendor credit
description: Refund vendor credit amount.
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/refund-a-vendor-credit-request'
responses:
'201':
description: Created
content:
application/json:
schema:
$ref: '#/components/schemas/refund-a-vendor-credit-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.debitnotes.CREATE
get:
tags:
- vendor-credits
operationId: list_refunds_of_a_vendor_credit
summary: List refunds of a vendor credit
description: List all refunds of an existing vendor credit.
parameters:
- name: page
in: query
description: Page number to be fetched. Default value is 1.
required: false
schema:
type: integer
default: 1
example: 1
- name: per_page
in: query
description: Number of records to be fetched per page. Default value is 200.
required: false
schema:
type: integer
default: 200
example: 200
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/list-refunds-of-a-vendor-credit-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.debitnotes.READ
/vendorcredits/{vendor_credit_id}/refunds/{vendor_credit_refund_id}:
x-mcp-group:
- Vendor Credits
parameters:
- name: vendor_credit_id
in: path
required: true
description: Unique identifier of the vendor credit.
schema:
type: string
example: '3000000002075'
- $ref: '#/components/parameters/organization_id'
put:
tags:
- vendor-credits
operationId: update_vendor_credit_refund
summary: Update vendor credit refund
description: Update the refunded transaction.
parameters:
- name: vendor_credit_refund_id
in: path
required: true
description: Unique identifier of the vendor credit refund.
schema:
type: string
example: '3000000003151'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/update-vendor-credit-refund-request'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/update-vendor-credit-refund-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.debitnotes.UPDATE
get:
tags:
- vendor-credits
operationId: get_vendor_credit_refund
summary: Get vendor credit refund
description: Get refund of a particular vendor credit.
parameters:
- name: vendor_credit_refund_id
in: path
required: true
description: Unique identifier of the vendor credit refund.
schema:
type: string
example: '3000000003151'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/get-vendor-credit-refund-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.debitnotes.READ
delete:
tags:
- vendor-credits
operationId: delete_vendor_credit_refund
summary: Delete vendor credit refund
description: Delete a vendor credit refund.
parameters:
- name: vendor_credit_refund_id
in: path
required: true
description: Unique identifier of the vendor credit refund.
schema:
type: string
example: '3000000003151'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/delete-vendor-credit-refund-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.debitnotes.DELETE
/vendorcredits/refunds:
x-mcp-group:
- Vendor Credits
parameters:
- $ref: '#/components/parameters/organization_id'
get:
tags:
- vendor-credits
operationId: list_refunds_of_all_vendor_credits
summary: List vendor credit refunds
description: List all refunds with pagination.
parameters:
- name: customer_id
in: query
description: Search vendor credits by vendor credit customer ID
required: false
schema:
type: string
example: ''
- name: last_modified_time
in: query
description: Search vendor credits by vendor credit last modfified time
required: false
schema:
type: string
example: 2014-08-28T22:53:31-0700
- name: sort_column
in: query
description: 'Sort vendor credits by following columns vendor_name, vendorcredit_number, balance, total, date and created_time. Allowed Values: vendor_name, vendor_credit_number, balance, total, date, created_time, last_modified_time and reference_number.'
required: false
schema:
type: string
example: created_time
- name: page
in: query
description: Page number to be fetched. Default value is 1.
required: false
schema:
type: integer
default: 1
example: 1
- name: per_page
in: query
description: Number of records to be fetched per page. Default value is 200.
required: false
schema:
type: integer
default: 200
example: 200
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/list-vendor-credit-refunds-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.debitnotes.READ
/vendorcredits/{vendor_credit_id}/comments:
x-mcp-group:
- Vendor Credits
parameters:
- name: vendor_credit_id
in: path
required: true
description: Unique identifier of the vendor credit.
schema:
type: string
example: '3000000002075'
- $ref: '#/components/parameters/organization_id'
post:
tags:
- vendor-credits
operationId: add_vendor_credit_comment
summary: Add a comment
description: Add a comment to an existing vendor credit.
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/add-a-comment-request'
responses:
'201':
description: Created
content:
application/json:
schema:
$ref: '#/components/schemas/add-a-comment-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.debitnotes.CREATE
get:
tags:
- vendor-credits
operationId: list_vendor_credit_comments
summary: List vendor credit comments & history
description: Get history and comments of a vendor credit.
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/list-vendor-credit-comments-and-history-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.debitnotes.READ
/vendorcredits/{vendor_credit_id}/comments/{comment_id}:
x-mcp-group:
- Vendor Credits
parameters:
- name: vendor_credit_id
in: path
required: true
description: Unique identifier of the vendor credit.
schema:
type: string
example: '3000000002075'
- $ref: '#/components/parameters/organization_id'
delete:
tags:
- vendor-credits
operationId: delete_vendor_credit_comment
summary: Delete a comment
description: Delete a vendor credit comment.
parameters:
- name: comment_id
in: path
required: true
description: Unique identifier of the comment.
schema:
type: string
example: '3000000002089'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/delete-a-comment-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.debitnotes.DELETE
components:
schemas:
vendor_credit_number:
description: Number of the Vendor Credit
type: string
example: DN-00002
transaction_id:
description: Transaction ID that caused the Comment
type: string
example: '460000000069087'
item_custom_fields:
type: array
description: List of custom fields associated with the line item
items:
type: object
properties:
label:
$ref: '#/components/schemas/label'
value:
$ref: '#/components/schemas/value'
imported_transactions:
type: array
items:
type: object
properties:
imported_transaction_id:
$ref: '#/components/schemas/imported_transaction_id'
date:
$ref: '#/components/schemas/date'
amount:
$ref: '#/components/schemas/amount'
payee:
$ref: '#/components/schemas/payee'
description:
$ref: '#/components/schemas/description'
reference_number:
$ref: '#/components/schemas/reference_number'
status:
$ref: '#/components/schemas/status'
account_id:
$ref: '#/components/schemas/account_id'
reverse_charge_tax_amount:
description: Tax amount of the reverse charge
type: number
format: double
example: 100
x-node_available_in:
- in
x-node_unavailable_in: []
taxes:
type: array
items:
type: object
properties:
tax_name:
$ref: '#/components/schemas/tax_name'
tax_amount:
$ref: '#/components/schemas/tax_amount'
vendor_name:
description: Name of the Vendor Associated with the Vendor Credit
type: string
example: Bowman and Co
batches:
description: Batch details for the line item. Reference an existing batch using batch_id. Applicable only for items with batch tracking enabled.
type: array
items:
type: object
required:
- batch_id
- out_quantity
properties:
batch_id:
description: Unique identifier of an existing batch.
type: string
example: '6780203000000214019'
out_quantity:
description: Quantity removed from the batch.
type: number
format: float
example: 2
storages:
description: Bin/storage locations from which stock was issued for this batch.
type: array
x-node_available_in:
- Batch with Bin tracked items
items:
type: object
required:
- storage_id
- out_quantity
properties:
storage_id:
description: Unique identifier of the bin/storage location.
type: string
example: '6780203000000093226'
out_quantity:
description: Quantity removed from the bin.
type: number
format: float
example: 2
update-vendor-credit-refund-request:
required:
- date
- amount
- account_id
type: object
properties:
date:
$ref: '#/components/schemas/date'
refund_mode:
$ref: '#/components/schemas/refund_mode'
reference_number:
$ref: '#/components/schemas/reference_number'
amount:
$ref: '#/components/schemas/amount'
exchange_rate:
$ref: '#/components/schemas/exchange_rate'
account_id:
$ref: '#/components/schemas/account_id'
description:
$ref: '#/components/schemas/description'
item_id:
description: ID of the item.
type: string
example: '460000000020071'
sub_total:
type: number
format: double
example: 30
comments:
type: array
items:
type: object
properties:
comment_id:
$ref: '#/components/schemas/comment_id'
vendor_credit_id:
$ref: '#/components/schemas/vendor_credit_id'
description:
$ref: '#/components/schemas/description'
commented_by_id:
$ref: '#/components/schemas/commented_by_id'
commented_by:
$ref: '#/components/schemas/commented_by'
comment_type:
$ref: '#/components/schemas/comment_type'
date:
$ref: '#/components/schemas/date'
date_description:
$ref: '#/components/schemas/date_description'
time:
$ref: '#/components/schemas/time'
operation_type:
$ref: '#/components/schemas/operation_type'
transaction_id:
$ref: '#/components/schemas/transaction_id'
transaction_type:
$ref: '#/components/schemas/transaction_type'
account_id:
description: ID of the account, the line item is associated with
type: string
example: '460000000020097'
serial_numbers:
description: Serial numbers for the line item. Applicable only for items with serial tracking enabled.
type: array
items:
type: string
example: ARMP-0078
documents:
type: array
description: List of documents associated with the vendor credit
items:
type: object
properties:
document_id:
$ref: '#/components/schemas/document_id'
file_name:
$ref: '#/components/schemas/file_name'
date:
description: The date the vendor credit is created. [yyyy-mm-dd]
type: string
example: '2014-08-28'
bills_credited:
type: array
items:
type: object
properties:
bill_id:
description: ID of the Bill Credited
type: string
example: '460000000057075'
vendor_credit_bill_id:
$ref: '#/components/schemas/vendor_credit_bill_id'
date:
description: Date of the Bill Credit
type: string
example: '2014-08-30'
bill_number:
description: Number of the Bill Credited
type: string
amount:
description: Amount that is credited in the bill
type: number
format: double
example: 13
item_total:
description: Total price of the Item
type: number
format: double
example: 30
update-vendor-credit-request:
required:
- vendor_id
type: object
properties:
vendor_id:
$ref: '#/components/schemas/vendor_id'
vat_treatment:
$ref: '#/components/schemas/vat_treatment'
vendor_credit_number:
description: Mandatory if auto number generation is disabled.
type: string
example: DN-00002
gst_treatment:
$ref: '#/components/schemas/gst_treatment'
tax_treatment:
$ref: '#/components/schemas/tax_treatment'
gst_no:
$ref: '#/components/schemas/gst_no'
source_of_supply:
$ref: '#/components/schemas/source_of_supply'
destination_of_supply:
$ref: '#/components/schemas/destination_of_supply'
place_of_supply:
$ref: '#/components/schemas/place_of_supply'
pricebook_id:
$ref: '#/components/schemas/pricebook_id'
reference_number:
$ref: '#/components/schemas/reference_number'
is_update_customer:
$ref: '#/components/schemas/is_update_customer'
date:
$ref: '#/components/schemas/date'
exchange_rate:
$ref: '#/components/schemas/exchange_rate'
is_inclusive_tax:
$ref: '#/components/schemas/is_inclusive_tax'
location_id:
$ref: '#/components/schemas/location_id'
line_items:
description: Line items of a vendor credit.
type: array
items:
type: object
properties:
item_id:
$ref: '#/components/schemas/item_id'
line_item_id:
$ref: '#/components/schemas/line_item_id'
account_id:
$ref: '#/components/schemas/account_id'
name:
$ref: '#/components/schemas/name'
hsn_or_sac:
$ref: '#/components/schemas/hsn_or_sac'
reverse_charge_tax_id:
$ref: '#/components/schemas/reverse_charge_tax_id'
location_id:
$ref: '#/components/schemas/location_id'
description:
$ref: '#/components/schemas/description'
item_order:
$ref: '#/components/schemas/item_order'
quantity:
$ref: '#/components/schemas/quantity'
unit:
$ref: '#/components/schemas/unit'
rate:
$ref: '#/components/schemas/rate'
tax_id:
$ref: '#/components/schemas/tax_id'
tds_tax_id:
$ref: '#/components/schemas/tds_tax_id'
tax_treatment_code:
$ref: '#/components/schemas/tax_treatment_code'
tags:
$ref: '#/components/schemas/tags'
item_custom_fields:
$ref: '#/components/schemas/item_custom_fields'
project_id:
$ref: '#/components/schemas/project_id'
project_name:
$ref: '#/components/schemas/project_name'
serial_numbers:
$ref: '#/components/schemas/serial_numbers'
batches:
$ref: '#/components/schemas/batches-update'
storages:
$ref: '#/components/schemas/storages-update'
notes:
$ref: '#/components/schemas/notes'
documents:
$ref: '#/components/schemas/documents'
custom_fields:
$ref: '#/components/schemas/custom_fields'
custom_fields:
type: array
description: List of custom fields associated with the vendor credit
items:
type: object
properties:
customfield_id:
$ref: '#/components/schemas/customfield_id'
label:
$ref: '#/components/schemas/label'
value:
$ref: '#/components/schemas/value'
apply-credits-to-a-bill-request:
required:
- bills
type: object
properties:
bills:
description: Amount applied from vendor credits to specified bills.
type: array
items:
type: object
required:
- bill_id
- amount_applied
properties:
bill_id:
description: Bill Associated with the Vendor Credit
type: string
example: '460000000057075'
amount_applied:
description: Amount applied to the bill.
type: number
format: double
example: 10
value:
description: Value of the Custom Field
type: string
reverse_charge_tax_id:
description: ID of the reverse charge tax
type: string
example: 460000000057089
x-node_available_in:
- in
- gcc
x-node_unavailable_in: []
batches-update:
description: Batch details for the line item. Reference an existing batch using batch_id. Applicable only for items with batch tracking enabled.
type: array
items:
type: object
required:
- batch_id
- out_quantity
properties:
batch_id:
description: Unique identifier of an existing batch.
type: string
example: '6780203000000214019'
out_quantity:
description: Quantity removed from the batch.
type: number
format: float
example: 2
storages:
description: Bin/storage locations from which stock was issued for this batch.
type: array
x-node_available_in:
- Batch with Bin tracked items
items:
type: object
required:
- storage_id
- out_quantity
properties:
storage_id:
description: Unique identifier of the bin/storage location.
type: string
example: '6780203000000093226'
out_quantity:
description: Quantity removed from the bin.
type: number
format: float
example: 2
storage_out_id:
description: Unique identifier of the storage record. Applicable only when updating an existing storage entry.
type: string
example: '6780203000000997441'
reverse_charge_tax_percentage:
description: Tax percentage of the reverse charge
type: number
format: double
example: 10
x-node_available_in:
- in
x-node_unavailable_in: []
filed_in_vat_return_type:
description: Type of the VAT Return the Vendor Credit is filed in
type: string
x-node_available_in:
- uk
x-node_unavailable_in: []
create-a-vendor-credit-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: Vendor credit has been created.
readOnly: true
vendor_credit:
$ref: '#/components/schemas/vendor_credit-response'
document_id:
description: ID of the Document
type: string
stock_on_hand:
description: Stock on Hand for that Item
type: string
reverse_charge_vat_amount:
description: Percentage of the Reverse Charge
type: string
x-node_available_in:
- uk
- eu
x-node_unavailable_in: []
vat_treatment:
description: VAT treatment for the invoice. VAT treatment denotes the location of the customer, if the customer resides in UK then the VAT treatment is uk. If the vendor is in an EU country & VAT registered, you are resides in Northen Ireland and purchasing Goods then his VAT treatment is eu_vat_registered and if he resides outside the EU then his VAT treatment is overseas(For Pre Brexit, this can be split as eu_vat_registered, eu_vat_not_registered and non_eu).
type: string
x-node_available_in:
- uk
x-node_unavailable_in: []
tags:
type: array
description: List of tags associated with the line item
items:
type: object
properties:
tag_id:
$ref: '#/components/schemas/tag_id'
tag_option_id:
$ref: '#/components/schemas/tag_option_id'
status:
type: string
example: open
submit-a-vendor-credit-for-approval-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: The vendor credit has been submitted for approval successfully.
readOnly: true
acquisition_vat_summary:
description: Summary of the VAT Acquistion
x-node_available_in:
- uk
- eu
x-node_unavailable_in: []
type: array
items:
type: object
properties:
tax:
$ref: '#/components/schemas/tax'
label:
description: Label of the Custom Field
type: string
total_refunded_amount:
type: number
format: double
example: 0
vendor_credit_refund_id:
description: ID of the Vendor Credit Refund
type: string
example: '3000000003151'
transaction_type:
description: Transaction Type that caused the Comment
type: string
example: vendor_credit
hsn_or_sac:
description: HSN Code
type: string
x-node_available_in:
- in
x-node_unavailable_in: []
quantity:
description: Quantity of the line item.
type: number
format: double
example: 1
vendor_credit_refunds:
type: array
items:
type: object
properties:
vendor_credit_refund_id:
$ref: '#/components/schemas/vendor_credit_refund_id'
vendor_credit_id:
$ref: '#/components/schemas/vendor_credit_id'
date:
$ref: '#/components/schemas/date'
refund_mode:
$ref: '#/components/schemas/refund_mode'
reference_number:
$ref: '#/components/schemas/reference_number'
description:
$ref: '#/components/schemas/description'
amount_bcy:
$ref: '#/components/schemas/amount_bcy'
amount_fcy:
$ref: '#/components/schemas/amount_fcy'
filed_in_vat_return_id:
$ref: '#/components/schemas/filed_in_vat_return_id'
filed_in_vat_return_name:
$ref: '#/components/schemas/filed_in_vat_return_name'
filed_in_vat_return_type:
$ref: '#/components/schemas/filed_in_vat_return_type'
acquisition_vat_amount:
description: Amount of the VAT Acquistion
type: string
x-node_available_in:
- uk
- eu
x-node_unavailable_in: []
refund-a-vendor-credit-request:
required:
- date
- amount
- account_id
type: object
properties:
date:
description: Date of Vendor Credit Refund
type: string
example: '2014-08-30'
refund_mode:
$ref: '#/components/schemas/refund_mode'
reference_number:
$ref: '#/components/schemas/reference_number'
amount:
$ref: '#/components/schemas/amount'
exchange_rate:
$ref: '#/components/schemas/exchange_rate'
account_id:
$ref: '#/components/schemas/account_id'
description:
$ref: '#/components/schemas/description'
is_update_customer:
description: Check if customer should be updated
type: boolean
example: false
tax_percentage:
description: Percentage of Tax
type: number
format: double
name:
description: Name of the line item.
type: string
example: Premium Plan - Web hosting
bill_id:
description: Bill Associated with the Vendor Credit
type: string
example: '460000000057075'
bill_number:
type: string
add-a-comment-request:
required:
- description
type: object
properties:
description:
description: Description of the Comment
type: string
example: Credits applied to Bill 1
customer_name:
description: Vendor associated with the Entity
type: string
example: Bowman and Co
gst_treatment:
description: Choose whether the contact is GST registered/unregistered/consumer/overseas. Allowed values are business_gst , business_none , overseas , consumer .
type: string
example: business_gst
x-node_available_in:
- in
x-node_unavailable_in: []
source_of_supply:
description: Place from where the goods/services are supplied. (If not given, place of contact given for the contact will be taken)
type: string
example: TN
x-node_available_in:
- in
x-node_unavailable_in: []
time:
description: Time of the Comment
type: string
example: 10:52 PM
vendor_credit-response:
type: object
properties:
vendor_credit_id:
$ref: '#/components/schemas/vendor_credit_id'
vendor_credit_number:
$ref: '#/components/schemas/vendor_credit_number'
date:
$ref: '#/components/schemas/date'
source_of_supply:
$ref: '#/components/schemas/source_of_supply'
destination_of_supply:
$ref: '#/components/schemas/destination_of_supply'
place_of_supply:
$ref: '#/components/schemas/place_of_supply'
gst_no:
$ref: '#/components/schemas/gst_no'
gst_treatment:
$ref: '#/components/schemas/gst_treatment'
tax_treatment:
$ref: '#/components/schemas/tax_treatment'
pricebook_id:
$ref: '#/components/schemas/pricebook_id'
is_reverse_charge_applied:
$ref: '#/components/schemas/is_reverse_charge_applied'
status:
$ref: '#/components/schemas/status'
reference_number:
$ref: '#/components/schemas/reference_number'
vendor_id:
$ref: '#/components/schemas/vendor_id'
vendor_name:
$ref: '#/components/schemas/vendor_name'
currency_id:
$ref: '#/components/schemas/currency_id'
currency_code:
$ref: '#/components/schemas/currency_code'
exchange_rate:
$ref: '#/components/schemas/exchange_rate'
price_precision:
$ref: '#/components/schemas/price_precision'
vat_treatment:
$ref: '#/components/schemas/vat_treatment'
filed_in_vat_return_id:
$ref: '#/components/schemas/filed_in_vat_return_id'
filed_in_vat_return_name:
$ref: '#/components/schemas/filed_in_vat_return_name'
filed_in_vat_return_type:
$ref: '#/components/schemas/filed_in_vat_return_type'
is_inclusive_tax:
$ref: '#/components/schemas/is_inclusive_tax'
location_id:
$ref: '#/components/schemas/location_id'
location_name:
$ref: '#/components/schemas/location_name'
line_items:
description: Line items of a vendor credit.
type: object
properties:
item_id:
$ref: '#/components/schemas/item_id'
line_item_id:
$ref: '#/components/schemas/line_item_id'
sku:
$ref: '#/components/schemas/sku'
account_id:
$ref: '#/components/schemas/account_id'
product_type:
$ref: '#/components/schemas/product_type'
location_id:
$ref: '#/components/schemas/location_id'
location_name:
$ref: '#/components/schemas/location_name'
reverse_charge_tax_id:
$ref: '#/components/schemas/reverse_charge_tax_id'
reverse_charge_tax_name:
$ref: '#/components/schemas/reverse_charge_tax_name'
reverse_charge_tax_percentage:
$ref: '#/components/schemas/reverse_charge_tax_percentage'
reverse_charge_tax_amount:
$ref: '#/components/schemas/reverse_charge_tax_amount'
account_name:
$ref: '#/components/schemas/account_name'
name:
$ref: '#/components/schemas/name'
description:
$ref: '#/components/schemas/description'
item_order:
$ref: '#/components/schemas/item_order'
quantity:
$ref: '#/components/schemas/quantity'
unit:
$ref: '#/components/schemas/unit'
bcy_rate:
$ref: '#/components/schemas/bcy_rate'
rate:
$ref: '#/components/schemas/rate'
tax_id:
$ref: '#/components/schemas/tax_id'
tds_tax_id:
$ref: '#/components/schemas/tds_tax_id'
tax_treatment_code:
$ref: '#/components/schemas/tax_treatment_code'
tax_exemption_id:
$ref: '#/components/schemas/tax_exemption_id'
tax_exemption_code:
$ref: '#/components/schemas/tax_exemption_code'
tax_name:
$ref: '#/components/schemas/tax_name'
tax_type:
$ref: '#/components/schemas/tax_type'
tax_percentage:
$ref: '#/components/schemas/tax_percentage'
item_total:
$ref: '#/components/schemas/item_total'
item_total_inclusive_of_tax:
$ref: '#/components/schemas/item_total_inclusive_of_tax'
hsn_or_sac:
$ref: '#/components/schemas/hsn_or_sac'
acquisition_vat_id:
$ref: '#/components/schemas/acquisition_vat_id'
acquisition_vat_name:
$ref: '#/components/schemas/acquisition_vat_name'
acquisition_vat_percentage:
$ref: '#/components/schemas/acquisition_vat_percentage'
acquisition_vat_amount:
$ref: '#/components/schemas/acquisition_vat_amount'
reverse_charge_vat_id:
$ref: '#/components/schemas/reverse_charge_vat_id'
reverse_charge_vat_name:
$ref: '#/components/schemas/reverse_charge_vat_name'
reverse_charge_vat_percentage:
$ref: '#/components/schemas/reverse_charge_vat_percentage'
reverse_charge_vat_amount:
$ref: '#/components/schemas/reverse_charge_vat_amount'
stock_on_hand:
$ref: '#/components/schemas/stock_on_hand'
tags:
$ref: '#/components/schemas/tags'
item_custom_fields:
$ref: '#/components/schemas/item_custom_fields'
acquisition_vat_summary:
$ref: '#/components/schemas/acquisition_vat_summary'
acquisition_vat_total:
$ref: '#/components/schemas/acquisition_vat_total'
reverse_charge_vat_summary:
$ref: '#/components/schemas/reverse_charge_vat_summary'
reverse_charge_vat_total:
$ref: '#/components/schemas/reverse_charge_vat_total'
documents:
$ref: '#/components/schemas/documents'
custom_fields:
$ref: '#/components/schemas/custom_fields'
sub_total:
$ref: '#/components/schemas/sub_total'
total:
$ref: '#/components/schemas/total'
total_credits_used:
$ref: '#/components/schemas/total_credits_used'
total_refunded_amount:
$ref: '#/components/schemas/total_refunded_amount'
balance:
$ref: '#/components/schemas/balance'
notes:
$ref: '#/components/schemas/notes'
comments:
$ref: '#/components/schemas/comments'
vendor_credit_refunds:
$ref: '#/components/schemas/vendor_credit_refunds'
bills_credited:
$ref: '#/components/schemas/bills_credited'
created_time:
$ref: '#/components/schemas/created_time'
last_modified_time:
$ref: '#/components/schemas/last_modified_time'
acquisition_vat_total:
description: Total of the VAT Acquistion
type: number
format: double
x-node_available_in:
- uk
- eu
x-node_unavailable_in: []
line_item_id:
description: ID of the Line Item
type: string
example: '460000000020077'
currency_id:
description: ID of the Currency Involved in the Vendor Credit
type: string
example: '3000000000083'
reference_number:
description: Reference number for the refund recorded.
type: string
comment_id:
description: ID of the Comment
type: string
example: '3000000002089'
location_id:
description: Location ID
type: string
example: '460000000038080'
operation_type:
description: Type of operation that caused the Comment
type: string
example: Added
description:
description: Description of the line item.
type: string
has_attachment:
description: Check if Vendor Credit has attachment
type: boolean
example: false
storages:
description: Bin/storage locations allocated (or consumed, for assemblies) for the line item. Applicable only for items with bin tracking enabled.
type: array
items:
type: object
required:
- storage_id
- out_quantity
properties:
storage_id:
description: Unique identifier of the bin/storage location.
type: string
example: '6780203000000093225'
out_quantity:
description: Quantity removed from the bin.
type: number
format: float
example: 2
serial_numbers:
description: Serial numbers allocated to this bin.
type: array
x-node_available_in:
- Serial with Bin tracked items
items:
type: string
example: ARMP-0078
total_credits_used:
type: number
format: double
example: 0
update-vendor-credit-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: Vendor credit information has been updated.
readOnly: true
vendor_credit:
type: object
properties:
vendor_credit_id:
$ref: '#/components/schemas/vendor_credit_id'
vendor_credit_number:
$ref: '#/components/schemas/vendor_credit_number'
date:
$ref: '#/components/schemas/date'
source_of_supply:
$ref: '#/components/schemas/source_of_supply'
destination_of_supply:
$ref: '#/components/schemas/destination_of_supply'
place_of_supply:
$ref: '#/components/schemas/place_of_supply'
gst_no:
$ref: '#/components/schemas/gst_no'
gst_treatment:
$ref: '#/components/schemas/gst_treatment'
tax_treatment:
$ref: '#/components/schemas/tax_treatment'
pricebook_id:
$ref: '#/components/schemas/pricebook_id'
is_reverse_charge_applied:
$ref: '#/components/schemas/is_reverse_charge_applied'
status:
$ref: '#/components/schemas/status'
reference_number:
$ref: '#/components/schemas/reference_number'
vendor_id:
$ref: '#/components/schemas/vendor_id'
vendor_name:
$ref: '#/components/schemas/vendor_name'
currency_id:
$ref: '#/components/schemas/currency_id'
currency_code:
$ref: '#/components/schemas/currency_code'
exchange_rate:
$ref: '#/components/schemas/exchange_rate'
price_precision:
$ref: '#/components/schemas/price_precision'
vat_treatment:
$ref: '#/components/schemas/vat_treatment'
taxes:
$ref: '#/components/schemas/taxes'
is_inclusive_tax:
$ref: '#/components/schemas/is_inclusive_tax'
location_id:
$ref: '#/components/schemas/location_id'
location_name:
$ref: '#/components/schemas/location_name'
line_items:
description: Line items of a vendor credit.
type: object
properties:
item_id:
$ref: '#/components/schemas/item_id'
line_item_id:
$ref: '#/components/schemas/line_item_id'
sku:
$ref: '#/components/schemas/sku'
location_id:
$ref: '#/components/schemas/location_id'
location_name:
$ref: '#/components/schemas/location_name'
account_id:
$ref: '#/components/schemas/account_id'
product_type:
$ref: '#/components/schemas/product_type'
reverse_charge_tax_id:
$ref: '#/components/schemas/reverse_charge_tax_id'
reverse_charge_tax_name:
$ref: '#/components/schemas/reverse_charge_tax_name'
reverse_charge_tax_percentage:
$ref: '#/components/schemas/reverse_charge_tax_percentage'
reverse_charge_tax_amount:
$ref: '#/components/schemas/reverse_charge_tax_amount'
account_name:
$ref: '#/components/schemas/account_name'
name:
$ref: '#/components/schemas/name'
description:
$ref: '#/components/schemas/description'
item_order:
$ref: '#/components/schemas/item_order'
quantity:
$ref: '#/components/schemas/quantity'
unit:
$ref: '#/components/schemas/unit'
bcy_rate:
$ref: '#/components/schemas/bcy_rate'
rate:
$ref: '#/components/schemas/rate'
tax_id:
$ref: '#/components/schemas/tax_id'
tds_tax_id:
$ref: '#/components/schemas/tds_tax_id'
tax_treatment_code:
$ref: '#/components/schemas/tax_treatment_code'
tax_exemption_id:
$ref: '#/components/schemas/tax_exemption_id'
tax_exemption_code:
$ref: '#/components/schemas/tax_exemption_code'
tax_name:
$ref: '#/components/schemas/tax_name'
tax_type:
$ref: '#/components/schemas/tax_type'
tax_percentage:
$ref: '#/components/schemas/tax_percentage'
item_total:
$ref: '#/components/schemas/item_total'
item_total_inclusive_of_tax:
$ref: '#/components/schemas/item_total_inclusive_of_tax'
hsn_or_sac:
$ref: '#/components/schemas/hsn_or_sac'
acquisition_vat_id:
$ref: '#/components/schemas/acquisition_vat_id'
acquisition_vat_name:
$ref: '#/components/schemas/acquisition_vat_name'
acquisition_vat_percentage:
$ref: '#/components/schemas/acquisition_vat_percentage'
acquisition_vat_amount:
$ref: '#/components/schemas/acquisition_vat_amount'
reverse_charge_vat_id:
$ref: '#/components/schemas/reverse_charge_vat_id'
reverse_charge_vat_name:
$ref: '#/components/schemas/reverse_charge_vat_name'
reverse_charge_vat_percentage:
$ref: '#/components/schemas/reverse_charge_vat_percentage'
reverse_charge_vat_amount:
$ref: '#/components/schemas/reverse_charge_vat_amount'
stock_on_hand:
$ref: '#/components/schemas/stock_on_hand'
tags:
$ref: '#/components/schemas/tags'
item_custom_fields:
$ref: '#/components/schemas/item_custom_fields'
acquisition_vat_summary:
$ref: '#/components/schemas/acquisition_vat_summary'
acquisition_vat_total:
$ref: '#/components/schemas/acquisition_vat_total'
reverse_charge_vat_summary:
$ref: '#/components/schemas/reverse_charge_vat_summary'
reverse_charge_vat_total:
$ref: '#/components/schemas/reverse_charge_vat_total'
documents:
$ref: '#/components/schemas/documents'
custom_fields:
$ref: '#/components/schemas/custom_fields'
sub_total:
$ref: '#/components/schemas/sub_total'
total:
$ref: '#/components/schemas/total'
total_credits_used:
$ref: '#/components/schemas/total_credits_used'
total_refunded_amount:
$ref: '#/components/schemas/total_refunded_amount'
balance:
$ref: '#/components/schemas/balance'
notes:
$ref: '#/components/schemas/notes'
comments:
$ref: '#/components/schemas/comments'
vendor_credit_refunds:
type: array
items:
type: object
properties:
vendor_credit_refund_id:
$ref: '#/components/schemas/vendor_credit_refund_id'
vendor_credit_id:
$ref: '#/components/schemas/vendor_credit_id'
date:
description: Date of the Vendor Credit Refund
type: string
refund_mode:
$ref: '#/components/schemas/refund_mode'
reference_number:
$ref: '#/components/schemas/reference_number'
description:
$ref: '#/components/schemas/description'
amount_bcy:
$ref: '#/components/schemas/amount_bcy'
amount_fcy:
$ref: '#/components/schemas/amount_fcy'
bills_credited:
$ref: '#/components/schemas/bills_credited'
created_time:
$ref: '#/components/schemas/created_time'
last_modified_time:
$ref: '#/components/schemas/last_modified_time'
date_description:
description: Description of the Date of the Comment
type: string
example: 32 minutes ago
list-vendor-credits-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: success
readOnly: true
vendorcredits:
type: array
items:
type: object
properties:
vendor_credit_id:
$ref: '#/components/schemas/vendor_credit_id'
vendor_credit_number:
$ref: '#/components/schemas/vendor_credit_number'
status:
$ref: '#/components/schemas/status'
reference_number:
$ref: '#/components/schemas/reference_number'
date:
$ref: '#/components/schemas/date'
total:
$ref: '#/components/schemas/total'
balance:
$ref: '#/components/schemas/balance'
vendor_id:
$ref: '#/components/schemas/vendor_id'
vendor_name:
$ref: '#/components/schemas/vendor_name'
currency_id:
$ref: '#/components/schemas/currency_id'
currency_code:
$ref: '#/components/schemas/currency_code'
created_time:
$ref: '#/components/schemas/created_time'
last_modified_time:
$ref: '#/components/schemas/last_modified_time'
has_attachment:
$ref: '#/components/schemas/has_attachment'
exchange_rate:
$ref: '#/components/schemas/exchange_rate'
amount:
type: number
format: double
description: Amount that is credited in the bill
example: 13
project_name:
description: Name of the project.
type: string
example: Sample Project
notes:
description: Notes for the Vendor Credit
type: string
currency_code:
description: Code of the Currency Involved in the Vendor Credit
type: string
example: USD
reverse_charge_vat_summary:
description: Summary of the Reverse Charge
type: array
items:
type: object
properties:
tax:
$ref: '#/components/schemas/tax'
x-node_available_in:
- uk
- eu
x-node_unavailable_in: []
reverse_charge_vat_id:
description: ID of the Reverse Charge
type: string
x-node_available_in:
- uk
- eu
x-node_unavailable_in: []
tax_treatment_code:
description: Specify reason for using out of scope.Supported values for UAE are uae_same_tax_group, uae_reimbursed_expense and uae_others. Supported values for Bahrain are bahrain_same_tax_group, bahrain_transfer_of_concern, bahrain_disbursement, bahrain_head_to_branch_transaction and bahrain_others.
type: string
example: uae_others
x-node_available_in:
- gcc
x-node_unavailable_in: []
last_modified_time:
description: Last Modified Time of Vendor Credit
type: string
example: 2014-08-28T22:53:31-0700
imported_transaction_id:
description: ID of the Imported Transaction
type: string
example: '460000000013297'
storages-update:
description: Bin/storage locations allocated (or consumed, for assemblies) for the line item. Applicable only for items with bin tracking enabled.
type: array
items:
type: object
required:
- storage_id
- out_quantity
properties:
storage_id:
description: Unique identifier of the bin/storage location.
type: string
example: '6780203000000093225'
out_quantity:
description: Quantity removed from the bin.
type: number
format: float
example: 2
storage_out_id:
description: Unique identifier of the storage record. Applicable only when updating an existing storage entry.
type: string
example: '6780203000000997440'
serial_numbers:
description: Serial numbers allocated to this bin.
type: array
x-node_available_in:
- Serial with Bin tracked items
items:
type: string
example: ARMP-0078
is_inclusive_tax:
description: Used to specify whether the line item rates are inclusive or exclusive of tax.
type: boolean
example: false
x-node_available_in: []
x-node_unavailable_in:
- us
get-vendor-credit-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: success
readOnly: true
vendor_credit:
type: object
properties:
vendor_credit_id:
$ref: '#/components/schemas/vendor_credit_id'
vendor_credit_number:
$ref: '#/components/schemas/vendor_credit_number'
date:
$ref: '#/components/schemas/date'
status:
$ref: '#/components/schemas/status'
reference_number:
$ref: '#/components/schemas/reference_number'
source_of_supply:
$ref: '#/components/schemas/source_of_supply'
destination_of_supply:
$ref: '#/components/schemas/destination_of_supply'
place_of_supply:
$ref: '#/components/schemas/place_of_supply'
gst_no:
$ref: '#/components/schemas/gst_no'
gst_treatment:
$ref: '#/components/schemas/gst_treatment'
tax_treatment:
$ref: '#/components/schemas/tax_treatment'
pricebook_id:
$ref: '#/components/schemas/pricebook_id'
is_reverse_charge_applied:
$ref: '#/components/schemas/is_reverse_charge_applied'
vendor_id:
$ref: '#/components/schemas/vendor_id'
vendor_name:
$ref: '#/components/schemas/vendor_name'
currency_id:
$ref: '#/components/schemas/currency_id'
currency_code:
$ref: '#/components/schemas/currency_code'
exchange_rate:
$ref: '#/components/schemas/exchange_rate'
price_precision:
$ref: '#/components/schemas/price_precision'
vat_treatment:
$ref: '#/components/schemas/vat_treatment'
filed_in_vat_return_id:
$ref: '#/components/schemas/filed_in_vat_return_id'
filed_in_vat_return_name:
$ref: '#/components/schemas/filed_in_vat_return_name'
filed_in_vat_return_type:
$ref: '#/components/schemas/filed_in_vat_return_type'
is_inclusive_tax:
$ref: '#/components/schemas/is_inclusive_tax'
location_id:
$ref: '#/components/schemas/location_id'
location_name:
$ref: '#/components/schemas/location_name'
line_items:
description: Line items of a vendor credit.
type: object
properties:
item_id:
$ref: '#/components/schemas/item_id'
line_item_id:
$ref: '#/components/schemas/line_item_id'
sku:
$ref: '#/components/schemas/sku'
location_id:
$ref: '#/components/schemas/location_id'
location_name:
$ref: '#/components/schemas/location_name'
account_id:
$ref: '#/components/schemas/account_id'
product_type:
$ref: '#/components/schemas/product_type'
reverse_charge_tax_id:
$ref: '#/components/schemas/reverse_charge_tax_id'
reverse_charge_tax_name:
$ref: '#/components/schemas/reverse_charge_tax_name'
reverse_charge_tax_percentage:
$ref: '#/components/schemas/reverse_charge_tax_percentage'
reverse_charge_tax_amount:
$ref: '#/components/schemas/reverse_charge_tax_amount'
account_name:
$ref: '#/components/schemas/account_name'
name:
$ref: '#/components/schemas/name'
description:
$ref: '#/components/schemas/description'
item_order:
$ref: '#/components/schemas/item_order'
quantity:
$ref: '#/components/schemas/quantity'
unit:
$ref: '#/components/schemas/unit'
bcy_rate:
$ref: '#/components/schemas/bcy_rate'
rate:
$ref: '#/components/schemas/rate'
tax_id:
$ref: '#/components/schemas/tax_id'
tax_treatment_code:
$ref: '#/components/schemas/tax_treatment_code'
tax_exemption_id:
$ref: '#/components/schemas/tax_exemption_id'
tax_exemption_code:
$ref: '#/components/schemas/tax_exemption_code'
tax_name:
$ref: '#/components/schemas/tax_name'
tax_type:
$ref: '#/components/schemas/tax_type'
tax_percentage:
$ref: '#/components/schemas/tax_percentage'
item_total:
$ref: '#/components/schemas/item_total'
item_total_inclusive_of_tax:
$ref: '#/components/schemas/item_total_inclusive_of_tax'
hsn_or_sac:
$ref: '#/components/schemas/hsn_or_sac'
acquisition_vat_id:
$ref: '#/components/schemas/acquisition_vat_id'
acquisition_vat_name:
$ref: '#/components/schemas/acquisition_vat_name'
acquisition_vat_percentage:
$ref: '#/components/schemas/acquisition_vat_percentage'
acquisition_vat_amount:
$ref: '#/components/schemas/acquisition_vat_amount'
reverse_charge_vat_id:
$ref: '#/components/schemas/reverse_charge_vat_id'
reverse_charge_vat_name:
$ref: '#/components/schemas/reverse_charge_vat_name'
reverse_charge_vat_percentage:
$ref: '#/components/schemas/reverse_charge_vat_percentage'
reverse_charge_vat_amount:
$ref: '#/components/schemas/reverse_charge_vat_amount'
stock_on_hand:
$ref: '#/components/schemas/stock_on_hand'
tags:
$ref: '#/components/schemas/tags'
item_custom_fields:
$ref: '#/components/schemas/item_custom_fields'
project_id:
$ref: '#/components/schemas/project_id'
project_name:
$ref: '#/components/schemas/project_name'
acquisition_vat_summary:
$ref: '#/components/schemas/acquisition_vat_summary'
acquisition_vat_total:
$ref: '#/components/schemas/acquisition_vat_total'
reverse_charge_vat_summary:
$ref: '#/components/schemas/reverse_charge_vat_summary'
reverse_charge_vat_total:
$ref: '#/components/schemas/reverse_charge_vat_total'
documents:
$ref: '#/components/schemas/documents'
custom_fields:
$ref: '#/components/schemas/custom_fields'
sub_total:
$ref: '#/components/schemas/sub_total'
total:
$ref: '#/components/schemas/total'
total_credits_used:
$ref: '#/components/schemas/total_credits_used'
total_refunded_amount:
$ref: '#/components/schemas/total_refunded_amount'
balance:
$ref: '#/components/schemas/balance'
notes:
$ref: '#/components/schemas/notes'
comments:
$ref: '#/components/schemas/comments'
vendor_credit_refunds:
$ref: '#/components/schemas/vendor_credit_refunds'
bills_credited:
$ref: '#/components/schemas/bills_credited'
created_time:
$ref: '#/components/schemas/created_time'
last_modified_time:
$ref: '#/components/schemas/last_modified_time'
commented_by:
description: Name of the User who caused the comment
type: string
example: rajdeep.a
sku:
description: SKU of the Item
type: string
place_of_supply:
description: 'The place of supply is where a transaction is considered to have occurred for VAT purposes. For the supply of goods, the place of supply is the location of the goods when the supply occurs. For the supply of services, the place of supply should be where the supplier is established. (If not given, place of contact given for the contact will be taken)
Supported codes for UAE emirates are : Abu Dhabi - AB,Ajman - AJ,Dubai - DU,Fujairah - FU,Ras al-Khaimah - RA,Sharjah - SH,Umm al-Quwain - UM.
Supported codes for the GCC countries are : United Arab Emirates - AE,Saudi Arabia - SA,Bahrain - BH,Kuwait - KW,Oman - OM,Qatar - QA.'
type: string
example: DU
x-node_available_in:
- gcc
x-node_unavailable_in: []
reverse_charge_vat_total:
description: Total of the Reverse Charge
type: number
format: double
x-node_available_in:
- uk
- eu
x-node_unavailable_in: []
project_id:
description: ID of the project
type: string
example: 90300000087378
refund_mode:
description: Mode of Refund
type: string
example: cash
tax_treatment:
description: 'VAT treatment for the vendor credit. Choose whether the vendor falls under: vat_registered,vat_not_registered,gcc_vat_not_registered,gcc_vat_registered,non_gcc.dz_vat_registered and dz_vat_not_registered are supported only for UAE.home_country_mexico,border_region_mexico,non_mexico supported only for MX.'
type: string
example: vat_registered
x-node_available_in:
- gcc
- mx
x-node_unavailable_in: []
destination_of_supply:
description: Place where the goods/services are supplied to. (If not given, organisation's home state will be taken)
type: string
example: TN
x-node_available_in:
- in
x-node_unavailable_in: []
add-a-comment-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: Comments added.
readOnly: true
comment:
type: object
properties:
comment_id:
$ref: '#/components/schemas/comment_id'
vendor_credit_id:
$ref: '#/components/schemas/vendor_credit_id'
description:
description: Description of the Comment
type: string
example: Credits applied to Bill 1
commented_by_id:
$ref: '#/components/schemas/commented_by_id'
commented_by:
$ref: '#/components/schemas/commented_by'
date:
description: Date of the Comment
type: string
example: '2017-01-18'
comment_type:
description: Type of the comment
type: string
example: system
filed_in_vat_return_name:
description: Name of the VAT Return the Vendor Credit is filed in
type: string
x-node_available_in:
- uk
x-node_unavailable_in: []
update-vendor-credit-refund-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: The refund information has been saved.
readOnly: true
vendor_credit_refund:
$ref: '#/components/schemas/vendor_credit_refund'
refund-a-vendor-credit-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: The refund information for this vendor credit has been saved.
readOnly: true
vendor_credit_refund:
$ref: '#/components/schemas/vendor_credit_refund'
exchange_rate:
description: Exchange rate of the currency.
type: number
format: double
example: 1
list-vendor-credit-comments-and-history-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: success
readOnly: true
comments:
type: array
items:
type: object
properties:
comment_id:
$ref: '#/components/schemas/comment_id'
vendor_credit_id:
$ref: '#/components/schemas/vendor_credit_id'
description:
description: Description of the Comment
type: string
example: Credits applied to Bill 1
commented_by_id:
$ref: '#/components/schemas/commented_by_id'
commented_by:
$ref: '#/components/schemas/commented_by'
comment_type:
$ref: '#/components/schemas/comment_type'
date:
description: Date of the Comment
type: string
example: '2017-01-18'
date_description:
$ref: '#/components/schemas/date_description'
time:
$ref: '#/components/schemas/time'
operation_type:
$ref: '#/components/schemas/operation_type'
transaction_id:
$ref: '#/components/schemas/transaction_id'
transaction_type:
$ref: '#/components/schemas/transaction_type'
void-vendor-credit-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: The vendor credit has been voided.
readOnly: true
reverse_charge_tax_name:
description: Enter the tax name of the reverse charge
type: string
example: intra
x-node_available_in:
- in
x-node_unavailable_in: []
unit:
description: Unit of the line item e.g. kgs, Nos.
type: string
example: Nos
delete-a-comment-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: The comment has been deleted.
readOnly: true
approve-a-vendor-credit-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: You have approved the vendor credit.
readOnly: true
created_time:
description: Time of Vendor Credit Creation
type: string
example: 2014-08-28T22:53:31-0700
payee:
description: Payee of the Transaction
type: string
example: John Roberts
item_order:
description: Order of the line item
type: integer
example: 0
tag_option_id:
description: ID of the tag option
type: string
list-refunds-of-a-vendor-credit-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: success
readOnly: true
vendor_credit_refunds:
type: array
items:
type: object
properties:
vendor_credit_refund_id:
$ref: '#/components/schemas/vendor_credit_refund_id'
vendor_credit_id:
$ref: '#/components/schemas/vendor_credit_id'
date:
description: Date of the Vendor Credit Refund
type: string
example: '2017-01-22'
refund_mode:
$ref: '#/components/schemas/refund_mode'
reference_number:
$ref: '#/components/schemas/reference_number'
amount:
$ref: '#/components/schemas/amount'
vendor_credit_number:
$ref: '#/components/schemas/vendor_credit_number'
customer_name:
$ref: '#/components/schemas/customer_name'
description:
description: Description of the Vendor Credit Refund
type: string
example: Cheque deposit
amount_bcy:
$ref: '#/components/schemas/amount_bcy'
amount_fcy:
$ref: '#/components/schemas/amount_fcy'
rate:
description: Rate of the line item.
type: number
format: double
example: 30
commented_by_id:
description: ID of the User who caused the comment
type: string
example: '3000000000741'
product_type:
description: 'Type of the product. Allowed Values: goods, digital_service and service.'
type: string
x-node_available_in:
- uk
- eu
x-node_unavailable_in: []
tax_exemption_code:
description: Code of the Tax Exemption associated
type: string
x-node_available_in:
- in
- au
x-node_unavailable_in: []
tax_exemption_id:
description: ID of the Tax Exemption associated
type: string
x-node_available_in:
- in
- au
x-node_unavailable_in: []
get-vendor-credit-refund-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: success
readOnly: true
vendor_credit_refund:
$ref: '#/components/schemas/vendor_credit_refund'
is_reverse_charge_applied:
description: Applicable for transactions where you pay reverse charge
type: boolean
example: true
x-node_available_in:
- in
x-node_unavailable_in: []
file_name:
description: Name of the file
type: string
tax_id:
description: ID of the Tax associated with the Vendor Credit
type: string
vendor_credit_id:
description: ID of the Vendor Credit
type: string
example: '3000000002075'
acquisition_vat_percentage:
description: Percentage of the VAT Acquistion
type: string
x-node_available_in:
- uk
- eu
x-node_unavailable_in: []
vendor_credit_bill_id:
description: ID of the Vendor Credited Bill ID
type: string
filed_in_vat_return_id:
description: ID of the VAT Return the Vendor Credit is filed in
type: string
x-node_available_in:
- uk
x-node_unavailable_in: []
tag_id:
description: ID of the tag
type: string
location_name:
description: Name of the location.
type: string
convert-to-open-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: The status of the vendor credit has been changed to open.
readOnly: true
delete-vendor-credit-refund-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: The refund has been successfully deleted.
readOnly: true
amount_fcy:
description: Refund Amount in Foreign Currency
type: number
format: double
example: 13
balance:
description: Balance in the Vendor Credit
type: number
format: double
example: 30
amount_bcy:
description: Refund Amount in Base Currency
type: number
format: double
example: 13
pricebook_id:
description: ID of the pricebook
type: string
delete-bills-credited-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: Credits applied to the bill have been deleted.
readOnly: true
list-bills-credited-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: success
readOnly: true
bills_credited:
type: array
items:
type: object
properties:
vendor_credit_id:
$ref: '#/components/schemas/vendor_credit_id'
bill_id:
$ref: '#/components/schemas/bill_id'
vendor_credit_bill_id:
$ref: '#/components/schemas/vendor_credit_bill_id'
date:
$ref: '#/components/schemas/date'
bill_number:
$ref: '#/components/schemas/bill_number'
price_precision:
type: integer
example: 2
item_total_inclusive_of_tax:
description: Total price of the Item inclusive of Tax
type: number
format: double
example: 30
acquisition_vat_id:
description: ID of the VAT Acquistion
type: string
x-node_available_in:
- uk
- eu
x-node_unavailable_in: []
create-a-vendor-credit-request:
required:
- vendor_id
type: object
properties:
vendor_id:
$ref: '#/components/schemas/vendor_id'
vat_treatment:
$ref: '#/components/schemas/vat_treatment'
vendor_credit_number:
description: Mandatory if auto number generation is disabled.
type: string
example: DN-00002
gst_treatment:
$ref: '#/components/schemas/gst_treatment'
tax_treatment:
$ref: '#/components/schemas/tax_treatment'
gst_no:
$ref: '#/components/schemas/gst_no'
source_of_supply:
$ref: '#/components/schemas/source_of_supply'
destination_of_supply:
$ref: '#/components/schemas/destination_of_supply'
place_of_supply:
$ref: '#/components/schemas/place_of_supply'
pricebook_id:
$ref: '#/components/schemas/pricebook_id'
reference_number:
$ref: '#/components/schemas/reference_number'
is_update_customer:
$ref: '#/components/schemas/is_update_customer'
date:
$ref: '#/components/schemas/date'
exchange_rate:
$ref: '#/components/schemas/exchange_rate'
is_inclusive_tax:
$ref: '#/components/schemas/is_inclusive_tax'
location_id:
$ref: '#/components/schemas/location_id'
line_items:
description: Line items of a vendor credit.
type: array
items:
type: object
properties:
item_id:
$ref: '#/components/schemas/item_id'
line_item_id:
$ref: '#/components/schemas/line_item_id'
account_id:
$ref: '#/components/schemas/account_id'
name:
$ref: '#/components/schemas/name'
hsn_or_sac:
$ref: '#/components/schemas/hsn_or_sac'
reverse_charge_tax_id:
$ref: '#/components/schemas/reverse_charge_tax_id'
location_id:
$ref: '#/components/schemas/location_id'
description:
$ref: '#/components/schemas/description'
item_order:
$ref: '#/components/schemas/item_order'
quantity:
$ref: '#/components/schemas/quantity'
unit:
$ref: '#/components/schemas/unit'
rate:
$ref: '#/components/schemas/rate'
tax_id:
$ref: '#/components/schemas/tax_id'
tds_tax_id:
$ref: '#/components/schemas/tds_tax_id'
tax_treatment_code:
$ref: '#/components/schemas/tax_treatment_code'
tags:
$ref: '#/components/schemas/tags'
item_custom_fields:
$ref: '#/components/schemas/item_custom_fields'
project_id:
$ref: '#/components/schemas/project_id'
project_name:
$ref: '#/components/schemas/project_name'
serial_numbers:
$ref: '#/components/schemas/serial_numbers'
batches:
$ref: '#/components/schemas/batches'
storages:
$ref: '#/components/schemas/storages'
notes:
$ref: '#/components/schemas/notes'
documents:
$ref: '#/components/schemas/documents'
custom_fields:
$ref: '#/components/schemas/custom_fields'
delete-vendor-credit-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: The vendor credit has been deleted.
readOnly: true
customfield_id:
description: ID of the Custom Field
type: string
reverse_charge_vat_percentage:
description: Percentage of the Reverse Charge
type: string
x-node_available_in:
- uk
- eu
x-node_unavailable_in: []
total:
type: number
format: double
example: 30
tds_tax_id:
description: TDS Tax ID of the Tax associated with the Vendor Credit
type: string
x-node_available_in:
- mx
x-node_unavailable_in: []
acquisition_vat_name:
description: Name of the VAT Acquistion
type: string
x-node_available_in:
- uk
- eu
x-node_unavailable_in: []
bcy_rate:
description: Rate of the Item in Base Currency
type: number
format: double
example: 30
tax_amount:
description: Amount of the Tax
type: number
format: double
account_name:
description: Name of the account the line item is associated with
type: string
example: IT and Internet Expenses
tax_type:
description: Type of the Tax
type: string
reverse_charge_vat_name:
description: Name of the Reverse Charge
type: string
x-node_available_in:
- uk
- eu
x-node_unavailable_in: []
vendor_credit_refund:
type: object
properties:
vendor_credit_refund_id:
$ref: '#/components/schemas/vendor_credit_refund_id'
vendor_credit_id:
$ref: '#/components/schemas/vendor_credit_id'
date:
$ref: '#/components/schemas/date'
refund_mode:
$ref: '#/components/schemas/refund_mode'
reference_number:
$ref: '#/components/schemas/reference_number'
amount:
$ref: '#/components/schemas/amount'
exchange_rate:
$ref: '#/components/schemas/exchange_rate'
account_id:
$ref: '#/components/schemas/account_id'
account_name:
$ref: '#/components/schemas/account_name'
description:
$ref: '#/components/schemas/description'
imported_transactions:
$ref: '#/components/schemas/imported_transactions'
apply-credits-to-a-bill-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: Credits have been applied to the bill(s).
readOnly: true
bills:
description: Amount applied from vendor credits to specified bills.
tax:
type: object
properties:
tax_name:
$ref: '#/components/schemas/tax_name'
tax_amount:
$ref: '#/components/schemas/tax_amount'
list-vendor-credit-refunds-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: success
readOnly: true
vendor_credit_refunds:
type: array
items:
type: object
properties:
vendor_credit_refund_id:
$ref: '#/components/schemas/vendor_credit_refund_id'
vendor_credit_id:
$ref: '#/components/schemas/vendor_credit_id'
date:
description: Date of the Vendor Credit Refund
type: string
example: '2017-01-22'
refund_mode:
$ref: '#/components/schemas/refund_mode'
reference_number:
$ref: '#/components/schemas/reference_number'
amount:
$ref: '#/components/schemas/amount'
vendor_credit_number:
$ref: '#/components/schemas/vendor_credit_number'
customer_name:
$ref: '#/components/schemas/customer_name'
description:
description: Description of the Vendor Credit Refund
type: string
example: Cheque deposit
amount_bcy:
$ref: '#/components/schemas/amount_bcy'
amount_fcy:
$ref: '#/components/schemas/amount_fcy'
gst_no:
description: 15 digit GST identification number of the vendor.
type: string
example: 22AAAAA0000A1Z5
x-node_available_in:
- in
x-node_unavailable_in: []
tax_name:
description: Name of the Tax
type: string
vendor_id:
description: ID of the vendor the vendor credit associated with the Vendor Credit
type: string
example: '460000000020029'
parameters:
organization_id:
name: organization_id
description: ID of the organization
in: query
required: true
schema:
type: string
example: '10234695'
securitySchemes:
Zoho_Auth:
type: oauth2
flows:
implicit:
authorizationUrl: https://accounts.zoho.com/oauth/v2/auth
scopes:
ZohoInventory.items.CREATE: Create Items
ZohoInventory.items.READ: Read Items
ZohoInventory.items.UPDATE: Update Items
ZohoInventory.items.DELETE: Delete Items