POST /invoices/{invoice-id}/record_tax_withheld
Records tax_withheld by the customer against the invoice specified. This operation is allowed only when all of the following conditions are true:
- Tax Amount Withheld is enabled.
- The
invoicedoes not have alinked_taxes_withheldrecord associated with it already. invoice.amount_dueis greater than zero.invoice.statusis one of the following:payment_due,not_paid, orposted.
Servers
- {protocol}://{site}.{environment}:{port}/api/v2
- {protocol}://{site}-test.{environment}:{port}/api/v2
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
invoice-id |
String | Yes |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
chargebee-request-origin-device |
String | No |
The device from which the customer has made the request |
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/x-www-form-urlencoded" |
chargebee-event-webhook |
String | No |
skip only webhooks Valid values:
|
chargebee-business-entity-id |
String | No |
If the site has multiple business entities, you can use this custom HTTP header to specify the business entity for which Chargebee should perform the operation. |
chargebee-event-actions |
String | No |
skip all actions to be done on the events Valid values:
|
chargebee-request-origin-user |
String | No |
The email address of your customer/user. Use this when the email address has only ASCII characters. |
chargebee-request-origin-ip |
String | No |
The IP address of the customer where the request originated |
chargebee-request-origin-user-encoded |
String | No |
The Base64-encoded email address of your customer/user. Use this if the email address has UTF-8 characters. When this header is provided, the header chargebee-request-origin-user is ignored. |
chargebee-event-email |
String | No |
skip only emails Valid values:
|
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
tax_withheld |
Object | No |
Parameters for tax_withheld |
tax_withheld.reference_number |
String | No |
A unique external reference number for the tax withheld. Typically, this is the reference number used by the system you are integrating the API with. Depending on your integration, this could be the reference number issued by the taxation authority to identify the customer or the specific tax transaction. |
tax_withheld.description |
String | No |
The description for this tax withheld. |
tax_withheld.amount |
Integer | Yes |
The amount withheld by the customer as tax from the invoice. This must not exceed |
tax_withheld.date |
Integer | No |
Date or time associated with this tax amount withheld. The default value is the time of invoking this operation. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.