Chilkat Online Tools

Ruby / easybill REST API / To complete a document.

Back to Collection Items

require 'chilkat'

# This example assumes the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

http = Chilkat::CkHttp.new()

http.SetRequestHeader("Authorization","{{apiKey}}")
http.SetRequestHeader("Accept","application/json")

# resp is a CkHttpResponse
resp = http.QuickRequest("PUT","https://api.easybill.de/rest/v1/documents/:id/done?reason_for_change=<string>")
if (http.get_LastMethodSuccess() == false)
    print http.lastErrorText() + "\n";
    exit
end

sbResponseBody = Chilkat::CkStringBuilder.new()
resp.GetBodySb(sbResponseBody)

jResp = Chilkat::CkJsonObject.new()
jResp.LoadSb(sbResponseBody)
jResp.put_EmitCompact(false)

print "Response Body:" + "\n";
print jResp.emit() + "\n";

respStatusCode = resp.get_StatusCode()
print "Response Status Code = " + respStatusCode.to_s() + "\n";
if (respStatusCode >= 400)
    print "Response Header:" + "\n";
    print resp.header() + "\n";
    print "Failed." + "\n";

    exit
end

# Sample JSON response:
# (Sample code for parsing the JSON response is shown below)

# {
#   "address": {
#     "salutation": "<integer>",
#     "personal": "<boolean>",
#     "title": "<string>",
#     "first_name": "<string>",
#     "last_name": "<string>",
#     "suffix_1": "<string>",
#     "suffix_2": "<string>",
#     "company_name": "<string>",
#     "street": "<string>",
#     "zip_code": "<string>",
#     "city": "<string>",
#     "state": "<string>",
#     "country": "<string>"
#   },
#   "attachment_ids": [
#     "<integer>",
#     "<integer>"
#   ],
#   "label_address": {
#     "salutation": "<integer>",
#     "personal": "<boolean>",
#     "title": "<string>",
#     "first_name": "<string>",
#     "last_name": "<string>",
#     "suffix_1": "<string>",
#     "suffix_2": "<string>",
#     "company_name": "<string>",
#     "street": "<string>",
#     "zip_code": "<string>",
#     "city": "<string>",
#     "state": "<string>",
#     "country": "<string>"
#   },
#   "amount": "<integer>",
#   "amount_net": "<integer>",
#   "bank_debit_form": null,
#   "billing_country": "<string>",
#   "calc_vat_from": 0,
#   "cancel_id": "<long>",
#   "cash_allowance": null,
#   "cash_allowance_days": null,
#   "cash_allowance_text": null,
#   "contact_id": null,
#   "contact_label": "",
#   "contact_text": "",
#   "created_at": "<dateTime>",
#   "currency": "EUR",
#   "customer_id": null,
#   "customer_snapshot": {
#     "last_name": "<string>",
#     "company_name": "<string>",
#     "acquire_options": 2,
#     "additional_groups_ids": [
#       "<integer>",
#       "<integer>"
#     ],
#     "bank_account": "<string>",
#     "bank_account_owner": "<string>",
#     "bank_bic": "<string>",
#     "bank_code": "<string>",
#     "bank_iban": "<string>",
#     "bank_name": "<string>",
#     "birth_date": "<date>",
#     "cash_allowance": "<float>",
#     "cash_allowance_days": 7,
#     "cash_discount": "<float>",
#     "cash_discount_type": "AMOUNT",
#     "city": "<string>",
#     "state": "<string>",
#     "country": "<string>",
#     "created_at": "<date>",
#     "updated_at": "<string>",
#     "delivery_title": "<string>",
#     "delivery_city": "<string>",
#     "delivery_state": "<string>",
#     "delivery_company_name": "<string>",
#     "delivery_country": "<string>",
#     "delivery_first_name": "<string>",
#     "delivery_last_name": "<string>",
#     "delivery_personal": "<boolean>",
#     "delivery_salutation": 0,
#     "delivery_street": "<string>",
#     "delivery_suffix_1": "<string>",
#     "delivery_suffix_2": "<string>",
#     "delivery_zip_code": "<string>",
#     "display_name": "<string>",
#     "emails": [
#       "<string>",
#       "<string>"
#     ],
#     "fax": "<string>",
#     "first_name": "<string>",
#     "grace_period": "<integer>",
#     "due_in_days": "<integer>",
#     "group_id": "<integer>",
#     "id": "<long>",
#     "info_1": "<string>",
#     "info_2": "<string>",
#     "internet": "<string>",
#     "login_id": "<long>",
#     "mobile": "<string>",
#     "note": "<string>",
#     "number": "<string>",
#     "payment_options": 1,
#     "personal": false,
#     "phone_1": "<string>",
#     "phone_2": "<string>",
#     "postbox": "<string>",
#     "postbox_city": "<string>",
#     "postbox_state": "<string>",
#     "postbox_country": "<string>",
#     "postbox_zip_code": "<string>",
#     "sale_price_level": "SALEPRICE6",
#     "salutation": 0,
#     "sepa_agreement": "BASIC",
#     "sepa_agreement_date": "<date>",
#     "sepa_mandate_reference": "<string>",
#     "since_date": "<date>",
#     "street": "<string>",
#     "suffix_1": "<string>",
#     "suffix_2": "<string>",
#     "tax_number": "<string>",
#     "court": "<string>",
#     "court_registry_number": "<string>",
#     "tax_options": "nStbIm",
#     "title": "<string>",
#     "archived": "<boolean>",
#     "vat_identifier": "<string>",
#     "zip_code": "<string>",
#     "document_pdf_type": "default",
#     "buyer_reference": "<string>",
#     "foreign_supplier_number": "<string>"
#   },
#   "discount": null,
#   "discount_type": null,
#   "document_date": "<date>",
#   "due_date": "<date>",
#   "edited_at": "<dateTime>",
#   "external_id": null,
#   "replica_url": null,
#   "grace_period": "<integer>",
#   "due_in_days": "<integer>",
#   "id": "<long>",
#   "is_acceptable_on_public_domain": false,
#   "is_archive": false,
#   "is_draft": "<boolean>",
#   "is_replica": false,
#   "is_oss": false,
#   "item_notes": [
#     "<string>",
#     "<string>"
#   ],
#   "items": [
#     {
#       "number": null,
#       "description": null,
#       "document_note": "<string>",
#       "quantity": 1,
#       "quantity_str": "<string>",
#       "unit": null,
#       "type": "POSITION",
#       "position": "<integer>",
#       "single_price_net": null,
#       "single_price_gross": "<float>",
#       "vat_percent": 0,
#       "discount": null,
#       "discount_type": null,
#       "position_id": null,
#       "total_price_net": "<float>",
#       "total_price_gross": "<float>",
#       "total_vat": "<float>",
#       "serial_number_id": "<string>",
#       "serial_number": "<string>",
#       "booking_account": null,
#       "export_cost_1": null,
#       "export_cost_2": null,
#       "cost_price_net": null,
#       "cost_price_total": "<float>",
#       "cost_price_charge": "<float>",
#       "cost_price_charge_type": "PERCENT",
#       "itemType": "UNDEFINED",
#       "id": "<long>"
#     },
#     {
#       "number": null,
#       "description": null,
#       "document_note": "<string>",
#       "quantity": 1,
#       "quantity_str": "<string>",
#       "unit": null,
#       "type": "POSITION",
#       "position": "<integer>",
#       "single_price_net": null,
#       "single_price_gross": "<float>",
#       "vat_percent": 0,
#       "discount": null,
#       "discount_type": null,
#       "position_id": null,
#       "total_price_net": "<float>",
#       "total_price_gross": "<float>",
#       "total_vat": "<float>",
#       "serial_number_id": "<string>",
#       "serial_number": "<string>",
#       "booking_account": null,
#       "export_cost_1": null,
#       "export_cost_2": null,
#       "cost_price_net": null,
#       "cost_price_total": "<float>",
#       "cost_price_charge": "<float>",
#       "cost_price_charge_type": "PERCENT",
#       "itemType": "UNDEFINED",
#       "id": "<long>"
#     }
#   ],
#   "last_postbox_id": "<long>",
#   "login_id": "<long>",
#   "number": null,
#   "order_number": "",
#   "buyer_reference": "",
#   "paid_amount": "<integer>",
#   "paid_at": "<date>",
#   "pdf_pages": "<integer>",
#   "pdf_template": "<string>",
#   "project_id": null,
#   "recurring_options": {
#     "next_date": "<date>",
#     "frequency": "MONTHLY",
#     "frequency_special": null,
#     "interval": 1,
#     "end_date_or_count": null,
#     "status": "WAITING",
#     "as_draft": false,
#     "is_notify": false,
#     "send_as": null,
#     "is_sign": false,
#     "is_paid": false,
#     "paid_date_option": "created_date",
#     "is_sepa": false,
#     "sepa_local_instrument": null,
#     "sepa_sequence_type": null,
#     "sepa_reference": null,
#     "sepa_remittance_information": null,
#     "target_type": "INVOICE"
#   },
#   "ref_id": null,
#   "root_id": null,
#   "service_date": {
#     "type": "SERVICE",
#     "date": "<date>",
#     "date_from": "<date>",
#     "date_to": "<date>",
#     "text": null
#   },
#   "shipping_country": null,
#   "status": null,
#   "text": "<string>",
#   "text_prefix": "<string>",
#   "text_tax": null,
#   "title": null,
#   "type": "INVOICE",
#   "use_shipping_address": false,
#   "vat_country": null,
#   "vat_id": "",
#   "fulfillment_country": null,
#   "vat_option": null,
#   "file_format_config": [
#     {
#       "type": "xrechnung2_2_xml"
#     },
#     {
#       "type": "xrechnung3_0_xml"
#     }
#   ]
# }

# Sample code for parsing the JSON response...
# Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code

Date_from = Chilkat::CkDtObj.new()
Date_to = Chilkat::CkDtObj.new()

Salutation = jResp.stringOf("address.salutation")
Personal = jResp.stringOf("address.personal")
Title = jResp.stringOf("address.title")
First_name = jResp.stringOf("address.first_name")
Last_name = jResp.stringOf("address.last_name")
Suffix_1 = jResp.stringOf("address.suffix_1")
Suffix_2 = jResp.stringOf("address.suffix_2")
Company_name = jResp.stringOf("address.company_name")
Street = jResp.stringOf("address.street")
Zip_code = jResp.stringOf("address.zip_code")
City = jResp.stringOf("address.city")
State = jResp.stringOf("address.state")
Country = jResp.stringOf("address.country")
label_addressSalutation = jResp.stringOf("label_address.salutation")
label_addressPersonal = jResp.stringOf("label_address.personal")
label_addressTitle = jResp.stringOf("label_address.title")
label_addressFirst_name = jResp.stringOf("label_address.first_name")
label_addressLast_name = jResp.stringOf("label_address.last_name")
label_addressSuffix_1 = jResp.stringOf("label_address.suffix_1")
label_addressSuffix_2 = jResp.stringOf("label_address.suffix_2")
label_addressCompany_name = jResp.stringOf("label_address.company_name")
label_addressStreet = jResp.stringOf("label_address.street")
label_addressZip_code = jResp.stringOf("label_address.zip_code")
label_addressCity = jResp.stringOf("label_address.city")
label_addressState = jResp.stringOf("label_address.state")
label_addressCountry = jResp.stringOf("label_address.country")
amount = jResp.stringOf("amount")
amount_net = jResp.stringOf("amount_net")
bank_debit_form = jResp.stringOf("bank_debit_form")
billing_country = jResp.stringOf("billing_country")
calc_vat_from = jResp.IntOf("calc_vat_from")
cancel_id = jResp.stringOf("cancel_id")
cash_allowance = jResp.stringOf("cash_allowance")
cash_allowance_days = jResp.stringOf("cash_allowance_days")
cash_allowance_text = jResp.stringOf("cash_allowance_text")
contact_id = jResp.stringOf("contact_id")
contact_label = jResp.stringOf("contact_label")
contact_text = jResp.stringOf("contact_text")
created_at = jResp.stringOf("created_at")
v_currency = jResp.stringOf("currency")
customer_id = jResp.stringOf("customer_id")
customer_snapshotLast_name = jResp.stringOf("customer_snapshot.last_name")
customer_snapshotCompany_name = jResp.stringOf("customer_snapshot.company_name")
Acquire_options = jResp.IntOf("customer_snapshot.acquire_options")
Bank_account = jResp.stringOf("customer_snapshot.bank_account")
Bank_account_owner = jResp.stringOf("customer_snapshot.bank_account_owner")
Bank_bic = jResp.stringOf("customer_snapshot.bank_bic")
Bank_code = jResp.stringOf("customer_snapshot.bank_code")
Bank_iban = jResp.stringOf("customer_snapshot.bank_iban")
Bank_name = jResp.stringOf("customer_snapshot.bank_name")
Birth_date = jResp.stringOf("customer_snapshot.birth_date")
Cash_allowance = jResp.stringOf("customer_snapshot.cash_allowance")
Cash_allowance_days = jResp.IntOf("customer_snapshot.cash_allowance_days")
Cash_discount = jResp.stringOf("customer_snapshot.cash_discount")
Cash_discount_type = jResp.stringOf("customer_snapshot.cash_discount_type")
customer_snapshotCity = jResp.stringOf("customer_snapshot.city")
customer_snapshotState = jResp.stringOf("customer_snapshot.state")
customer_snapshotCountry = jResp.stringOf("customer_snapshot.country")
Created_at = jResp.stringOf("customer_snapshot.created_at")
Updated_at = jResp.stringOf("customer_snapshot.updated_at")
Delivery_title = jResp.stringOf("customer_snapshot.delivery_title")
Delivery_city = jResp.stringOf("customer_snapshot.delivery_city")
Delivery_state = jResp.stringOf("customer_snapshot.delivery_state")
Delivery_company_name = jResp.stringOf("customer_snapshot.delivery_company_name")
Delivery_country = jResp.stringOf("customer_snapshot.delivery_country")
Delivery_first_name = jResp.stringOf("customer_snapshot.delivery_first_name")
Delivery_last_name = jResp.stringOf("customer_snapshot.delivery_last_name")
Delivery_personal = jResp.stringOf("customer_snapshot.delivery_personal")
Delivery_salutation = jResp.IntOf("customer_snapshot.delivery_salutation")
Delivery_street = jResp.stringOf("customer_snapshot.delivery_street")
Delivery_suffix_1 = jResp.stringOf("customer_snapshot.delivery_suffix_1")
Delivery_suffix_2 = jResp.stringOf("customer_snapshot.delivery_suffix_2")
Delivery_zip_code = jResp.stringOf("customer_snapshot.delivery_zip_code")
Display_name = jResp.stringOf("customer_snapshot.display_name")
Fax = jResp.stringOf("customer_snapshot.fax")
customer_snapshotFirst_name = jResp.stringOf("customer_snapshot.first_name")
Grace_period = jResp.stringOf("customer_snapshot.grace_period")
Due_in_days = jResp.stringOf("customer_snapshot.due_in_days")
Group_id = jResp.stringOf("customer_snapshot.group_id")
Id = jResp.stringOf("customer_snapshot.id")
Info_1 = jResp.stringOf("customer_snapshot.info_1")
Info_2 = jResp.stringOf("customer_snapshot.info_2")
Internet = jResp.stringOf("customer_snapshot.internet")
Login_id = jResp.stringOf("customer_snapshot.login_id")
Mobile = jResp.stringOf("customer_snapshot.mobile")
Note = jResp.stringOf("customer_snapshot.note")
v_Number = jResp.stringOf("customer_snapshot.number")
Payment_options = jResp.IntOf("customer_snapshot.payment_options")
customer_snapshotPersonal = jResp.BoolOf("customer_snapshot.personal")
Phone_1 = jResp.stringOf("customer_snapshot.phone_1")
Phone_2 = jResp.stringOf("customer_snapshot.phone_2")
Postbox = jResp.stringOf("customer_snapshot.postbox")
Postbox_city = jResp.stringOf("customer_snapshot.postbox_city")
Postbox_state = jResp.stringOf("customer_snapshot.postbox_state")
Postbox_country = jResp.stringOf("customer_snapshot.postbox_country")
Postbox_zip_code = jResp.stringOf("customer_snapshot.postbox_zip_code")
Sale_price_level = jResp.stringOf("customer_snapshot.sale_price_level")
customer_snapshotSalutation = jResp.IntOf("customer_snapshot.salutation")
Sepa_agreement = jResp.stringOf("customer_snapshot.sepa_agreement")
Sepa_agreement_date = jResp.stringOf("customer_snapshot.sepa_agreement_date")
Sepa_mandate_reference = jResp.stringOf("customer_snapshot.sepa_mandate_reference")
Since_date = jResp.stringOf("customer_snapshot.since_date")
customer_snapshotStreet = jResp.stringOf("customer_snapshot.street")
customer_snapshotSuffix_1 = jResp.stringOf("customer_snapshot.suffix_1")
customer_snapshotSuffix_2 = jResp.stringOf("customer_snapshot.suffix_2")
Tax_number = jResp.stringOf("customer_snapshot.tax_number")
Court = jResp.stringOf("customer_snapshot.court")
Court_registry_number = jResp.stringOf("customer_snapshot.court_registry_number")
Tax_options = jResp.stringOf("customer_snapshot.tax_options")
customer_snapshotTitle = jResp.stringOf("customer_snapshot.title")
Archived = jResp.stringOf("customer_snapshot.archived")
Vat_identifier = jResp.stringOf("customer_snapshot.vat_identifier")
customer_snapshotZip_code = jResp.stringOf("customer_snapshot.zip_code")
Document_pdf_type = jResp.stringOf("customer_snapshot.document_pdf_type")
Buyer_reference = jResp.stringOf("customer_snapshot.buyer_reference")
Foreign_supplier_number = jResp.stringOf("customer_snapshot.foreign_supplier_number")
discount = jResp.stringOf("discount")
discount_type = jResp.stringOf("discount_type")
document_date = jResp.stringOf("document_date")
due_date = jResp.stringOf("due_date")
edited_at = jResp.stringOf("edited_at")
external_id = jResp.stringOf("external_id")
replica_url = jResp.stringOf("replica_url")
grace_period = jResp.stringOf("grace_period")
due_in_days = jResp.stringOf("due_in_days")
id = jResp.stringOf("id")
is_acceptable_on_public_domain = jResp.BoolOf("is_acceptable_on_public_domain")
is_archive = jResp.BoolOf("is_archive")
is_draft = jResp.stringOf("is_draft")
is_replica = jResp.BoolOf("is_replica")
is_oss = jResp.BoolOf("is_oss")
last_postbox_id = jResp.stringOf("last_postbox_id")
login_id = jResp.stringOf("login_id")
v_number = jResp.stringOf("number")
order_number = jResp.stringOf("order_number")
buyer_reference = jResp.stringOf("buyer_reference")
paid_amount = jResp.stringOf("paid_amount")
paid_at = jResp.stringOf("paid_at")
pdf_pages = jResp.stringOf("pdf_pages")
pdf_template = jResp.stringOf("pdf_template")
project_id = jResp.stringOf("project_id")
Next_date = jResp.stringOf("recurring_options.next_date")
Frequency = jResp.stringOf("recurring_options.frequency")
Frequency_special = jResp.stringOf("recurring_options.frequency_special")
Interval = jResp.IntOf("recurring_options.interval")
End_date_or_count = jResp.stringOf("recurring_options.end_date_or_count")
Status = jResp.stringOf("recurring_options.status")
As_draft = jResp.BoolOf("recurring_options.as_draft")
Is_notify = jResp.BoolOf("recurring_options.is_notify")
Send_as = jResp.stringOf("recurring_options.send_as")
Is_sign = jResp.BoolOf("recurring_options.is_sign")
Is_paid = jResp.BoolOf("recurring_options.is_paid")
Paid_date_option = jResp.stringOf("recurring_options.paid_date_option")
Is_sepa = jResp.BoolOf("recurring_options.is_sepa")
Sepa_local_instrument = jResp.stringOf("recurring_options.sepa_local_instrument")
Sepa_sequence_type = jResp.stringOf("recurring_options.sepa_sequence_type")
Sepa_reference = jResp.stringOf("recurring_options.sepa_reference")
Sepa_remittance_information = jResp.stringOf("recurring_options.sepa_remittance_information")
Target_type = jResp.stringOf("recurring_options.target_type")
ref_id = jResp.stringOf("ref_id")
root_id = jResp.stringOf("root_id")
v_Type = jResp.stringOf("service_date.type")
Date = jResp.stringOf("service_date.date")
jResp.DtOf("service_date.date_from",false,Date_from)
jResp.DtOf("service_date.date_to",false,Date_to)
Text = jResp.stringOf("service_date.text")
shipping_country = jResp.stringOf("shipping_country")
status = jResp.stringOf("status")
text = jResp.stringOf("text")
text_prefix = jResp.stringOf("text_prefix")
text_tax = jResp.stringOf("text_tax")
title = jResp.stringOf("title")
v_type = jResp.stringOf("type")
use_shipping_address = jResp.BoolOf("use_shipping_address")
vat_country = jResp.stringOf("vat_country")
vat_id = jResp.stringOf("vat_id")
fulfillment_country = jResp.stringOf("fulfillment_country")
vat_option = jResp.stringOf("vat_option")
i = 0
count_i = jResp.SizeOfArray("attachment_ids")
while i < count_i
    jResp.put_I(i)
    strVal = jResp.stringOf("attachment_ids[i]")
    i = i + 1
end
i = 0
count_i = jResp.SizeOfArray("customer_snapshot.additional_groups_ids")
while i < count_i
    jResp.put_I(i)
    strVal = jResp.stringOf("customer_snapshot.additional_groups_ids[i]")
    i = i + 1
end
i = 0
count_i = jResp.SizeOfArray("customer_snapshot.emails")
while i < count_i
    jResp.put_I(i)
    strVal = jResp.stringOf("customer_snapshot.emails[i]")
    i = i + 1
end
i = 0
count_i = jResp.SizeOfArray("item_notes")
while i < count_i
    jResp.put_I(i)
    strVal = jResp.stringOf("item_notes[i]")
    i = i + 1
end
i = 0
count_i = jResp.SizeOfArray("items")
while i < count_i
    jResp.put_I(i)
    v_number = jResp.stringOf("items[i].number")
    description = jResp.stringOf("items[i].description")
    document_note = jResp.stringOf("items[i].document_note")
    quantity = jResp.IntOf("items[i].quantity")
    quantity_str = jResp.stringOf("items[i].quantity_str")
    unit = jResp.stringOf("items[i].unit")
    v_type = jResp.stringOf("items[i].type")
    position = jResp.stringOf("items[i].position")
    single_price_net = jResp.stringOf("items[i].single_price_net")
    single_price_gross = jResp.stringOf("items[i].single_price_gross")
    vat_percent = jResp.IntOf("items[i].vat_percent")
    discount = jResp.stringOf("items[i].discount")
    discount_type = jResp.stringOf("items[i].discount_type")
    position_id = jResp.stringOf("items[i].position_id")
    total_price_net = jResp.stringOf("items[i].total_price_net")
    total_price_gross = jResp.stringOf("items[i].total_price_gross")
    total_vat = jResp.stringOf("items[i].total_vat")
    serial_number_id = jResp.stringOf("items[i].serial_number_id")
    serial_number = jResp.stringOf("items[i].serial_number")
    booking_account = jResp.stringOf("items[i].booking_account")
    export_cost_1 = jResp.stringOf("items[i].export_cost_1")
    export_cost_2 = jResp.stringOf("items[i].export_cost_2")
    cost_price_net = jResp.stringOf("items[i].cost_price_net")
    cost_price_total = jResp.stringOf("items[i].cost_price_total")
    cost_price_charge = jResp.stringOf("items[i].cost_price_charge")
    cost_price_charge_type = jResp.stringOf("items[i].cost_price_charge_type")
    itemType = jResp.stringOf("items[i].itemType")
    id = jResp.stringOf("items[i].id")
    i = i + 1
end
i = 0
count_i = jResp.SizeOfArray("file_format_config")
while i < count_i
    jResp.put_I(i)
    v_type = jResp.stringOf("file_format_config[i].type")
    i = i + 1
end

Curl Command

curl -X PUT
	-H "Authorization: {{apiKey}}"
	-H "Accept: application/json"
https://api.easybill.de/rest/v1/documents/:id/done?reason_for_change=<string>

Postman Collection Item JSON

{
  "name": "To complete a document.",
  "request": {
    "method": "PUT",
    "header": [
      {
        "key": "Accept",
        "value": "application/json"
      }
    ],
    "url": {
      "raw": "{{baseUrl}}/documents/:id/done?reason_for_change=<string>",
      "host": [
        "{{baseUrl}}"
      ],
      "path": [
        "documents",
        ":id",
        "done"
      ],
      "query": [
        {
          "key": "reason_for_change",
          "value": "<string>",
          "description": "A string that is saved on the document version as reason."
        }
      ],
      "variable": [
        {
          "key": "id",
          "value": "<long>",
          "description": "(Required) ID of document"
        }
      ]
    }
  },
  "response": [
    {
      "name": "Successful operation",
      "originalRequest": {
        "method": "PUT",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          },
          {
            "description": "Added as a part of security scheme: apikey",
            "key": "Authorization",
            "value": "<API Key>"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/documents/:id/done?reason_for_change=<string>",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "documents",
            ":id",
            "done"
          ],
          "query": [
            {
              "key": "reason_for_change",
              "value": "<string>",
              "description": "A string that is saved on the document version as reason."
            }
          ],
          "variable": [
            {
              "key": "id"
            }
          ]
        }
      },
      "status": "OK",
      "code": 200,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n  \"address\": {\n    \"salutation\": \"<integer>\",\n    \"personal\": \"<boolean>\",\n    \"title\": \"<string>\",\n    \"first_name\": \"<string>\",\n    \"last_name\": \"<string>\",\n    \"suffix_1\": \"<string>\",\n    \"suffix_2\": \"<string>\",\n    \"company_name\": \"<string>\",\n    \"street\": \"<string>\",\n    \"zip_code\": \"<string>\",\n    \"city\": \"<string>\",\n    \"state\": \"<string>\",\n    \"country\": \"<string>\"\n  },\n  \"attachment_ids\": [\n    \"<integer>\",\n    \"<integer>\"\n  ],\n  \"label_address\": {\n    \"salutation\": \"<integer>\",\n    \"personal\": \"<boolean>\",\n    \"title\": \"<string>\",\n    \"first_name\": \"<string>\",\n    \"last_name\": \"<string>\",\n    \"suffix_1\": \"<string>\",\n    \"suffix_2\": \"<string>\",\n    \"company_name\": \"<string>\",\n    \"street\": \"<string>\",\n    \"zip_code\": \"<string>\",\n    \"city\": \"<string>\",\n    \"state\": \"<string>\",\n    \"country\": \"<string>\"\n  },\n  \"amount\": \"<integer>\",\n  \"amount_net\": \"<integer>\",\n  \"bank_debit_form\": null,\n  \"billing_country\": \"<string>\",\n  \"calc_vat_from\": 0,\n  \"cancel_id\": \"<long>\",\n  \"cash_allowance\": null,\n  \"cash_allowance_days\": null,\n  \"cash_allowance_text\": null,\n  \"contact_id\": null,\n  \"contact_label\": \"\",\n  \"contact_text\": \"\",\n  \"created_at\": \"<dateTime>\",\n  \"currency\": \"EUR\",\n  \"customer_id\": null,\n  \"customer_snapshot\": {\n    \"last_name\": \"<string>\",\n    \"company_name\": \"<string>\",\n    \"acquire_options\": 2,\n    \"additional_groups_ids\": [\n      \"<integer>\",\n      \"<integer>\"\n    ],\n    \"bank_account\": \"<string>\",\n    \"bank_account_owner\": \"<string>\",\n    \"bank_bic\": \"<string>\",\n    \"bank_code\": \"<string>\",\n    \"bank_iban\": \"<string>\",\n    \"bank_name\": \"<string>\",\n    \"birth_date\": \"<date>\",\n    \"cash_allowance\": \"<float>\",\n    \"cash_allowance_days\": 7,\n    \"cash_discount\": \"<float>\",\n    \"cash_discount_type\": \"AMOUNT\",\n    \"city\": \"<string>\",\n    \"state\": \"<string>\",\n    \"country\": \"<string>\",\n    \"created_at\": \"<date>\",\n    \"updated_at\": \"<string>\",\n    \"delivery_title\": \"<string>\",\n    \"delivery_city\": \"<string>\",\n    \"delivery_state\": \"<string>\",\n    \"delivery_company_name\": \"<string>\",\n    \"delivery_country\": \"<string>\",\n    \"delivery_first_name\": \"<string>\",\n    \"delivery_last_name\": \"<string>\",\n    \"delivery_personal\": \"<boolean>\",\n    \"delivery_salutation\": 0,\n    \"delivery_street\": \"<string>\",\n    \"delivery_suffix_1\": \"<string>\",\n    \"delivery_suffix_2\": \"<string>\",\n    \"delivery_zip_code\": \"<string>\",\n    \"display_name\": \"<string>\",\n    \"emails\": [\n      \"<string>\",\n      \"<string>\"\n    ],\n    \"fax\": \"<string>\",\n    \"first_name\": \"<string>\",\n    \"grace_period\": \"<integer>\",\n    \"due_in_days\": \"<integer>\",\n    \"group_id\": \"<integer>\",\n    \"id\": \"<long>\",\n    \"info_1\": \"<string>\",\n    \"info_2\": \"<string>\",\n    \"internet\": \"<string>\",\n    \"login_id\": \"<long>\",\n    \"mobile\": \"<string>\",\n    \"note\": \"<string>\",\n    \"number\": \"<string>\",\n    \"payment_options\": 1,\n    \"personal\": false,\n    \"phone_1\": \"<string>\",\n    \"phone_2\": \"<string>\",\n    \"postbox\": \"<string>\",\n    \"postbox_city\": \"<string>\",\n    \"postbox_state\": \"<string>\",\n    \"postbox_country\": \"<string>\",\n    \"postbox_zip_code\": \"<string>\",\n    \"sale_price_level\": \"SALEPRICE6\",\n    \"salutation\": 0,\n    \"sepa_agreement\": \"BASIC\",\n    \"sepa_agreement_date\": \"<date>\",\n    \"sepa_mandate_reference\": \"<string>\",\n    \"since_date\": \"<date>\",\n    \"street\": \"<string>\",\n    \"suffix_1\": \"<string>\",\n    \"suffix_2\": \"<string>\",\n    \"tax_number\": \"<string>\",\n    \"court\": \"<string>\",\n    \"court_registry_number\": \"<string>\",\n    \"tax_options\": \"nStbIm\",\n    \"title\": \"<string>\",\n    \"archived\": \"<boolean>\",\n    \"vat_identifier\": \"<string>\",\n    \"zip_code\": \"<string>\",\n    \"document_pdf_type\": \"default\",\n    \"buyer_reference\": \"<string>\",\n    \"foreign_supplier_number\": \"<string>\"\n  },\n  \"discount\": null,\n  \"discount_type\": null,\n  \"document_date\": \"<date>\",\n  \"due_date\": \"<date>\",\n  \"edited_at\": \"<dateTime>\",\n  \"external_id\": null,\n  \"replica_url\": null,\n  \"grace_period\": \"<integer>\",\n  \"due_in_days\": \"<integer>\",\n  \"id\": \"<long>\",\n  \"is_acceptable_on_public_domain\": false,\n  \"is_archive\": false,\n  \"is_draft\": \"<boolean>\",\n  \"is_replica\": false,\n  \"is_oss\": false,\n  \"item_notes\": [\n    \"<string>\",\n    \"<string>\"\n  ],\n  \"items\": [\n    {\n      \"number\": null,\n      \"description\": null,\n      \"document_note\": \"<string>\",\n      \"quantity\": 1,\n      \"quantity_str\": \"<string>\",\n      \"unit\": null,\n      \"type\": \"POSITION\",\n      \"position\": \"<integer>\",\n      \"single_price_net\": null,\n      \"single_price_gross\": \"<float>\",\n      \"vat_percent\": 0,\n      \"discount\": null,\n      \"discount_type\": null,\n      \"position_id\": null,\n      \"total_price_net\": \"<float>\",\n      \"total_price_gross\": \"<float>\",\n      \"total_vat\": \"<float>\",\n      \"serial_number_id\": \"<string>\",\n      \"serial_number\": \"<string>\",\n      \"booking_account\": null,\n      \"export_cost_1\": null,\n      \"export_cost_2\": null,\n      \"cost_price_net\": null,\n      \"cost_price_total\": \"<float>\",\n      \"cost_price_charge\": \"<float>\",\n      \"cost_price_charge_type\": \"PERCENT\",\n      \"itemType\": \"UNDEFINED\",\n      \"id\": \"<long>\"\n    },\n    {\n      \"number\": null,\n      \"description\": null,\n      \"document_note\": \"<string>\",\n      \"quantity\": 1,\n      \"quantity_str\": \"<string>\",\n      \"unit\": null,\n      \"type\": \"POSITION\",\n      \"position\": \"<integer>\",\n      \"single_price_net\": null,\n      \"single_price_gross\": \"<float>\",\n      \"vat_percent\": 0,\n      \"discount\": null,\n      \"discount_type\": null,\n      \"position_id\": null,\n      \"total_price_net\": \"<float>\",\n      \"total_price_gross\": \"<float>\",\n      \"total_vat\": \"<float>\",\n      \"serial_number_id\": \"<string>\",\n      \"serial_number\": \"<string>\",\n      \"booking_account\": null,\n      \"export_cost_1\": null,\n      \"export_cost_2\": null,\n      \"cost_price_net\": null,\n      \"cost_price_total\": \"<float>\",\n      \"cost_price_charge\": \"<float>\",\n      \"cost_price_charge_type\": \"PERCENT\",\n      \"itemType\": \"UNDEFINED\",\n      \"id\": \"<long>\"\n    }\n  ],\n  \"last_postbox_id\": \"<long>\",\n  \"login_id\": \"<long>\",\n  \"number\": null,\n  \"order_number\": \"\",\n  \"buyer_reference\": \"\",\n  \"paid_amount\": \"<integer>\",\n  \"paid_at\": \"<date>\",\n  \"pdf_pages\": \"<integer>\",\n  \"pdf_template\": \"<string>\",\n  \"project_id\": null,\n  \"recurring_options\": {\n    \"next_date\": \"<date>\",\n    \"frequency\": \"MONTHLY\",\n    \"frequency_special\": null,\n    \"interval\": 1,\n    \"end_date_or_count\": null,\n    \"status\": \"WAITING\",\n    \"as_draft\": false,\n    \"is_notify\": false,\n    \"send_as\": null,\n    \"is_sign\": false,\n    \"is_paid\": false,\n    \"paid_date_option\": \"created_date\",\n    \"is_sepa\": false,\n    \"sepa_local_instrument\": null,\n    \"sepa_sequence_type\": null,\n    \"sepa_reference\": null,\n    \"sepa_remittance_information\": null,\n    \"target_type\": \"INVOICE\"\n  },\n  \"ref_id\": null,\n  \"root_id\": null,\n  \"service_date\": {\n    \"type\": \"SERVICE\",\n    \"date\": \"<date>\",\n    \"date_from\": \"<date>\",\n    \"date_to\": \"<date>\",\n    \"text\": null\n  },\n  \"shipping_country\": null,\n  \"status\": null,\n  \"text\": \"<string>\",\n  \"text_prefix\": \"<string>\",\n  \"text_tax\": null,\n  \"title\": null,\n  \"type\": \"INVOICE\",\n  \"use_shipping_address\": false,\n  \"vat_country\": null,\n  \"vat_id\": \"\",\n  \"fulfillment_country\": null,\n  \"vat_option\": null,\n  \"file_format_config\": [\n    {\n      \"type\": \"xrechnung2_2_xml\"\n    },\n    {\n      \"type\": \"xrechnung3_0_xml\"\n    }\n  ]\n}"
    },
    {
      "name": "Not found",
      "originalRequest": {
        "method": "PUT",
        "header": [
          {
            "description": "Added as a part of security scheme: apikey",
            "key": "Authorization",
            "value": "<API Key>"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/documents/:id/done?reason_for_change=<string>",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "documents",
            ":id",
            "done"
          ],
          "query": [
            {
              "key": "reason_for_change",
              "value": "<string>",
              "description": "A string that is saved on the document version as reason."
            }
          ],
          "variable": [
            {
              "key": "id"
            }
          ]
        }
      },
      "status": "Not Found",
      "code": 404,
      "_postman_previewlanguage": "text",
      "header": [
      ],
      "cookie": [
      ],
      "body": ""
    },
    {
      "name": "Resource is locked. This status is returned if a process is currently running which locks the requested resource. Try again later.",
      "originalRequest": {
        "method": "PUT",
        "header": [
          {
            "description": "Added as a part of security scheme: apikey",
            "key": "Authorization",
            "value": "<API Key>"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/documents/:id/done?reason_for_change=<string>",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "documents",
            ":id",
            "done"
          ],
          "query": [
            {
              "key": "reason_for_change",
              "value": "<string>",
              "description": "A string that is saved on the document version as reason."
            }
          ],
          "variable": [
            {
              "key": "id"
            }
          ]
        }
      },
      "status": "Conflict",
      "code": 409,
      "_postman_previewlanguage": "text",
      "header": [
      ],
      "cookie": [
      ],
      "body": ""
    },
    {
      "name": "Too Many Requests",
      "originalRequest": {
        "method": "PUT",
        "header": [
          {
            "description": "Added as a part of security scheme: apikey",
            "key": "Authorization",
            "value": "<API Key>"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/documents/:id/done?reason_for_change=<string>",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "documents",
            ":id",
            "done"
          ],
          "query": [
            {
              "key": "reason_for_change",
              "value": "<string>",
              "description": "A string that is saved on the document version as reason."
            }
          ],
          "variable": [
            {
              "key": "id"
            }
          ]
        }
      },
      "status": "Too Many Requests",
      "code": 429,
      "_postman_previewlanguage": "text",
      "header": [
      ],
      "cookie": [
      ],
      "body": ""
    }
  ]
}