---
title: "Replaces the Bill resource."
method: PUT
path: "/bills/{id}"
tags: ["Bill"]
---

# Replaces the Bill resource.

`PUT /bills/{id}`

Replaces the Bill resource.

## Path parameters

- `id` string, required

## Request body

- Bill
  - `id` string — Unique identifier for this bill note that no particular pattern in this field is guaranteed, only that this field is unique e.g. "quickbooks-345"
  - `integration` string — The key of the integration source e.g. "quickbooks", or "xero"
  - `vendorId` string — Vendor Id e.g. "15"
  - `vendorName` string, nullable — Vendor full name e.g. "Acme Corp"
  - `currency` string, nullable — Currency code e.g. "USD"
  - `balance` integer — Total balance of the bill in cents e.g. 70000
  - `txnDate` string, date-time, nullable — Transaction date e.g. "2021-05-12"
  - `totalAmount` integer — Total amount of the bill in cents e.g. 550000
  - `apAccountId` string, nullable — Account Id e.g. "15"
  - `apAccountName` string, nullable — Account full name e.g. "Accounts Payable"
  - `modified` string, date-time — Date entry was last modified e.g. "2013-11-18T02:17:40.080Z"
  - `created` string, date-time, nullable — Date entry was created e.g. "2013-11-18T02:17:40.080Z"
  - `srcId` string — The unique identifier of the source 3rd party integration e.g. "GH2JK-67283H-YW82KHX-2883KK-KS78S"
  - `status` string, nullable — Bill status e.g. "Paid"
  - `identifier` string, nullable — The bill number e.g. "4560"
  - `referenceNumber` string, nullable — Reference number e.g. "1234"
  - `dueDate` string, date-time, nullable — Date bill is due e.g. "2021-05-30"
  - `subtotal` integer, nullable — Bill subtotal in cents e.g. 65000
  - `taxAmount` integer, nullable — Bill tax amount in cents e.g. 12000

## Response `200`

Bill resource updated

- Bill
  - `id` string — Unique identifier for this bill note that no particular pattern in this field is guaranteed, only that this field is unique e.g. "quickbooks-345"
  - `integration` string — The key of the integration source e.g. "quickbooks", or "xero"
  - `vendorId` string — Vendor Id e.g. "15"
  - `vendorName` string, nullable — Vendor full name e.g. "Acme Corp"
  - `currency` string, nullable — Currency code e.g. "USD"
  - `balance` integer — Total balance of the bill in cents e.g. 70000
  - `txnDate` string, date-time, nullable — Transaction date e.g. "2021-05-12"
  - `totalAmount` integer — Total amount of the bill in cents e.g. 550000
  - `apAccountId` string, nullable — Account Id e.g. "15"
  - `apAccountName` string, nullable — Account full name e.g. "Accounts Payable"
  - `modified` string, date-time — Date entry was last modified e.g. "2013-11-18T02:17:40.080Z"
  - `created` string, date-time, nullable — Date entry was created e.g. "2013-11-18T02:17:40.080Z"
  - `srcId` string — The unique identifier of the source 3rd party integration e.g. "GH2JK-67283H-YW82KHX-2883KK-KS78S"
  - `status` string, nullable — Bill status e.g. "Paid"
  - `identifier` string, nullable — The bill number e.g. "4560"
  - `referenceNumber` string, nullable — Reference number e.g. "1234"
  - `dueDate` string, date-time, nullable — Date bill is due e.g. "2021-05-30"
  - `subtotal` integer, nullable — Bill subtotal in cents e.g. 65000
  - `taxAmount` integer, nullable — Bill tax amount in cents e.g. 12000

## Other responses

- `400` — Invalid input
- `404` — Resource not found
- `422` — Unprocessable entity

---

[API](https://skmtc.net/bossinsights/apis/boss-insights.md) · [All operations](https://skmtc.net/bossinsights/apis/boss-insights/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bossinsights/boss-insights/versions/d08a107895ad/schema)