GetbeelDocs

Exclude or correct a VAT register row

The same as Rettifica in Tasse → Registri IVA: exclude keeps the row out of the liquidazione; adjust sets the VAT that counts (vat_amount), for example the deductible share of a car or phone cost. A reason is required and kept with the row for the accountant. It replaces an earlier adjustment of the row. GET vat-registers and vat-settlements show the effect; a liquidazione already saved stays as it was until it is prepared again (POST /filings, type vat_payment). Live keys only.

PUT
/companies/me/vat-adjustments/{key}

The same as Rettifica in Tasse → Registri IVA: exclude keeps the row out of the liquidazione; adjust sets the VAT that counts (vat_amount), for example the deductible share of a car or phone cost. A reason is required and kept with the row for the accountant. It replaces an earlier adjustment of the row. GET vat-registers and vat-settlements show the effect; a liquidazione already saved stays as it was until it is prepared again (POST /filings, type vat_payment). Live keys only.

Authorization

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Path Parameters

key*string

The key of a row of GET /companies/me/vat-registers: register:source:document_id

Request Body

application/json
  1. body
action*string

exclude: the row does not enter the liquidazione. adjust: vat_amount is the VAT that counts instead.

Value in"exclude""adjust"
vat_amount?|

Required for adjust: the VAT of the row that counts

reason*string

Why (kept with the row for the accountant), e.g. "IVA indetraibile al 60% (auto aziendale)"

Length3 <= length <= 500

Response Body

OK

application/json
  1. response
object*string
key*string
register*string
Value in"sales""purchases"
source*string
Value in"issued_invoice""received_invoice""autofattura"
document_id*string
action*string
Value in"exclude""adjust"
vat_amount*|null
reason*string
Example Request
curl -X PUT 'https://www.getbeel.com/api/v1/companies/me/vat-adjustments/string' \  -H 'Content-Type: application/json' \  -d '{  "action": "exclude",  "reason": "string"}'
Example Response
{  "object": "vat_adjustment",  "key": "string",  "register": "sales",  "source": "issued_invoice",  "document_id": "string",  "action": "exclude",  "vat_amount": "122.00",  "reason": "string"}