v1

latestOpenAPI 3.0.12026-07-24310590875.6 KB

vendor-credits

Update a vendor credit

Update details about a vendor credit line item. You can also update other vendor credit line item details.

You can use the PATCH operation to modify line item details, such as amount, quantity, and description. The vendor credit line item id does not change with a PATCH operation.

patch/v3/vendor-credits/{vendorCreditId}

Path parameters

vendorCreditIdstring required

BILL-generated ID of the vendor credit. The value begins with vcr.

Example:{{vendor_credit_id}}

Headers

sessionIdstring nullable

API session ID generated with /v3/login

Example:{{session_id}}

devKeystring nullable

Developer key generated with your BILL developer account

Example:{{developer_key}}

Request body

vendorIdstring

BILL-generated ID of the vendor. The value begins with 009.

referenceNumberstring

User-generated vendor credit number. This value can be in your chosen number scheme.

creditDatestring date

Vendor credit issued date. This value is in the yyyy-MM-dd format.

descriptionstring

Vendor credit description

applyToChartOfAccountIdstring

BILL-generated ID of the chart of accounts used when the vendor credit is applied to a bill payment. The value begins with 0ca.

applyToBankAccountIdstring

BILL-generated ID of the bank account used when the vendor credit is applied to a bill payment. The value begins with bac.

Note: You can set only one of applyToChartOfAccountId or applyToBankAccountId.

Example request

{
  "description": "Happy Vendor Credit (amount updated)",
  "vendorCreditLineItems": [
    {
      "id": "{{vendor_credit_line_item_id01}}",
      "description": "Classic extreme drum sticks",
      "amount": 19.99
    }
  ]
}

Response

Update a vendor credit response

idstring

BILL-generated ID of the vendor credit. The value begins with vcr.

vendorIdstring

BILL-generated ID of the vendor. The value begins with 009.

referenceNumberstring

User-generated vendor credit number. This value can be in your chosen number scheme.

creditDatestring date

Vendor credit issued date. This value is in the yyyy-MM-dd format.

descriptionstring

Vendor credit description

archivedboolean

Set as true if the vendor credit is archived

applyToChartOfAccountIdstring

BILL-generated ID of the chart of accounts used when the vendor credit is applied to a bill payment. The value begins with 0ca.

applyToBankAccountIdstring

BILL-generated ID of the bank account used when the vendor credit is applied to a bill payment. The value begins with bac.

Note: You can set only one of applyToChartOfAccountId or applyToBankAccountId.

amountnumber

Vendor credit amount

appliedAmountnumber

Vendor credit amount applied to invoices

status'FULLY_APPLIED' | 'NOT_APPLIED' | 'PARTIALLY_APPLIED' | 'IN_PROCESS' | 'UNDEFINED'

Vendor credit status.

createdTimestring date-time

Vendor credit created time

updatedTimestring date-time

Vendor credit updated time