Vendor bills

Delete a vendor bill

Soft-deletes a vendor bill. A bill that has been paid can only be deleted by also asking for its payment transactions to be adjusted. Requires the vendor_bills:delete permission.

DELETE

https://services.magicdoor.com/accounting/company-portal/vendor-bills/{vendorBillId}

Authorization

Authorizationstringrequired

Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Path parameters

vendorBillIdstringrequired

Snowflake id of the vendor bill.

example: 1830472847398404200

Body

application/json

A body is required, even though the only field in it has a default.

adjustPaymentsboolean

true unallocates the transactions that paid this bill before deleting it. false refuses to delete a bill that has any payment allocation.

default: falseexample: false

Response

204 · The bill was deleted. The response has no body.

401 · The access token is missing, expired, or not for this company.

403 · The caller does not hold the `vendor_bills:delete` permission.

404 · No vendor bill with this id belongs to the caller's company, or it has been deleted.

422 · The bill has payment allocations and `adjustPayments` was `false`.

Request

curl --request DELETE \
  --url 'https://services.magicdoor.com/accounting/company-portal/vendor-bills/1830472847398404200' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "adjustPayments": false
}'

Body

{
  "adjustPayments": false
}