Java / easybill REST API / Convert an existing document to one of a different type
Back to Collection Items
import com.chilkatsoft.*;
public class ChilkatExample {
static {
try {
System.loadLibrary("chilkat");
} catch (UnsatisfiedLinkError e) {
System.err.println("Native code library failed to load.\n" + e);
System.exit(1);
}
}
public static void main(String argv[])
{
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
CkHttp http = new CkHttp();
boolean success;
http.SetRequestHeader("Authorization","{{apiKey}}");
http.SetRequestHeader("Accept","application/json");
CkHttpResponse resp = http.QuickRequest("POST","https://api.easybill.de/rest/v1/documents/:id/:type?pdf_template=DE");
if (http.get_LastMethodSuccess() == false) {
System.out.println(http.lastErrorText());
return;
}
CkStringBuilder sbResponseBody = new CkStringBuilder();
resp.GetBodySb(sbResponseBody);
CkJsonObject jResp = new CkJsonObject();
jResp.LoadSb(sbResponseBody);
jResp.put_EmitCompact(false);
System.out.println("Response Body:");
System.out.println(jResp.emit());
int respStatusCode = resp.get_StatusCode();
System.out.println("Response Status Code = " + respStatusCode);
if (respStatusCode >= 400) {
System.out.println("Response Header:");
System.out.println(resp.header());
System.out.println("Failed.");
return;
}
// 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
CkDtObj Date_from = new CkDtObj();
CkDtObj Date_to = new CkDtObj();
String strVal;
String description;
String document_note;
int quantity;
String quantity_str;
String unit;
String position;
String single_price_net;
String single_price_gross;
int vat_percent;
String position_id;
String total_price_net;
String total_price_gross;
String total_vat;
String serial_number_id;
String serial_number;
String booking_account;
String export_cost_1;
String export_cost_2;
String cost_price_net;
String cost_price_total;
String cost_price_charge;
String cost_price_charge_type;
String itemType;
String Salutation = jResp.stringOf("address.salutation");
String Personal = jResp.stringOf("address.personal");
String Title = jResp.stringOf("address.title");
String First_name = jResp.stringOf("address.first_name");
String Last_name = jResp.stringOf("address.last_name");
String Suffix_1 = jResp.stringOf("address.suffix_1");
String Suffix_2 = jResp.stringOf("address.suffix_2");
String Company_name = jResp.stringOf("address.company_name");
String Street = jResp.stringOf("address.street");
String Zip_code = jResp.stringOf("address.zip_code");
String City = jResp.stringOf("address.city");
String State = jResp.stringOf("address.state");
String Country = jResp.stringOf("address.country");
String label_addressSalutation = jResp.stringOf("label_address.salutation");
String label_addressPersonal = jResp.stringOf("label_address.personal");
String label_addressTitle = jResp.stringOf("label_address.title");
String label_addressFirst_name = jResp.stringOf("label_address.first_name");
String label_addressLast_name = jResp.stringOf("label_address.last_name");
String label_addressSuffix_1 = jResp.stringOf("label_address.suffix_1");
String label_addressSuffix_2 = jResp.stringOf("label_address.suffix_2");
String label_addressCompany_name = jResp.stringOf("label_address.company_name");
String label_addressStreet = jResp.stringOf("label_address.street");
String label_addressZip_code = jResp.stringOf("label_address.zip_code");
String label_addressCity = jResp.stringOf("label_address.city");
String label_addressState = jResp.stringOf("label_address.state");
String label_addressCountry = jResp.stringOf("label_address.country");
String amount = jResp.stringOf("amount");
String amount_net = jResp.stringOf("amount_net");
String bank_debit_form = jResp.stringOf("bank_debit_form");
String billing_country = jResp.stringOf("billing_country");
int calc_vat_from = jResp.IntOf("calc_vat_from");
String cancel_id = jResp.stringOf("cancel_id");
String cash_allowance = jResp.stringOf("cash_allowance");
String cash_allowance_days = jResp.stringOf("cash_allowance_days");
String cash_allowance_text = jResp.stringOf("cash_allowance_text");
String contact_id = jResp.stringOf("contact_id");
String contact_label = jResp.stringOf("contact_label");
String contact_text = jResp.stringOf("contact_text");
String created_at = jResp.stringOf("created_at");
String v_currency = jResp.stringOf("currency");
String customer_id = jResp.stringOf("customer_id");
String customer_snapshotLast_name = jResp.stringOf("customer_snapshot.last_name");
String customer_snapshotCompany_name = jResp.stringOf("customer_snapshot.company_name");
int Acquire_options = jResp.IntOf("customer_snapshot.acquire_options");
String Bank_account = jResp.stringOf("customer_snapshot.bank_account");
String Bank_account_owner = jResp.stringOf("customer_snapshot.bank_account_owner");
String Bank_bic = jResp.stringOf("customer_snapshot.bank_bic");
String Bank_code = jResp.stringOf("customer_snapshot.bank_code");
String Bank_iban = jResp.stringOf("customer_snapshot.bank_iban");
String Bank_name = jResp.stringOf("customer_snapshot.bank_name");
String Birth_date = jResp.stringOf("customer_snapshot.birth_date");
String Cash_allowance = jResp.stringOf("customer_snapshot.cash_allowance");
int Cash_allowance_days = jResp.IntOf("customer_snapshot.cash_allowance_days");
String Cash_discount = jResp.stringOf("customer_snapshot.cash_discount");
String Cash_discount_type = jResp.stringOf("customer_snapshot.cash_discount_type");
String customer_snapshotCity = jResp.stringOf("customer_snapshot.city");
String customer_snapshotState = jResp.stringOf("customer_snapshot.state");
String customer_snapshotCountry = jResp.stringOf("customer_snapshot.country");
String Created_at = jResp.stringOf("customer_snapshot.created_at");
String Updated_at = jResp.stringOf("customer_snapshot.updated_at");
String Delivery_title = jResp.stringOf("customer_snapshot.delivery_title");
String Delivery_city = jResp.stringOf("customer_snapshot.delivery_city");
String Delivery_state = jResp.stringOf("customer_snapshot.delivery_state");
String Delivery_company_name = jResp.stringOf("customer_snapshot.delivery_company_name");
String Delivery_country = jResp.stringOf("customer_snapshot.delivery_country");
String Delivery_first_name = jResp.stringOf("customer_snapshot.delivery_first_name");
String Delivery_last_name = jResp.stringOf("customer_snapshot.delivery_last_name");
String Delivery_personal = jResp.stringOf("customer_snapshot.delivery_personal");
int Delivery_salutation = jResp.IntOf("customer_snapshot.delivery_salutation");
String Delivery_street = jResp.stringOf("customer_snapshot.delivery_street");
String Delivery_suffix_1 = jResp.stringOf("customer_snapshot.delivery_suffix_1");
String Delivery_suffix_2 = jResp.stringOf("customer_snapshot.delivery_suffix_2");
String Delivery_zip_code = jResp.stringOf("customer_snapshot.delivery_zip_code");
String Display_name = jResp.stringOf("customer_snapshot.display_name");
String Fax = jResp.stringOf("customer_snapshot.fax");
String customer_snapshotFirst_name = jResp.stringOf("customer_snapshot.first_name");
String Grace_period = jResp.stringOf("customer_snapshot.grace_period");
String Due_in_days = jResp.stringOf("customer_snapshot.due_in_days");
String Group_id = jResp.stringOf("customer_snapshot.group_id");
String Id = jResp.stringOf("customer_snapshot.id");
String Info_1 = jResp.stringOf("customer_snapshot.info_1");
String Info_2 = jResp.stringOf("customer_snapshot.info_2");
String Internet = jResp.stringOf("customer_snapshot.internet");
String Login_id = jResp.stringOf("customer_snapshot.login_id");
String Mobile = jResp.stringOf("customer_snapshot.mobile");
String Note = jResp.stringOf("customer_snapshot.note");
String v_Number = jResp.stringOf("customer_snapshot.number");
int Payment_options = jResp.IntOf("customer_snapshot.payment_options");
boolean customer_snapshotPersonal = jResp.BoolOf("customer_snapshot.personal");
String Phone_1 = jResp.stringOf("customer_snapshot.phone_1");
String Phone_2 = jResp.stringOf("customer_snapshot.phone_2");
String Postbox = jResp.stringOf("customer_snapshot.postbox");
String Postbox_city = jResp.stringOf("customer_snapshot.postbox_city");
String Postbox_state = jResp.stringOf("customer_snapshot.postbox_state");
String Postbox_country = jResp.stringOf("customer_snapshot.postbox_country");
String Postbox_zip_code = jResp.stringOf("customer_snapshot.postbox_zip_code");
String Sale_price_level = jResp.stringOf("customer_snapshot.sale_price_level");
int customer_snapshotSalutation = jResp.IntOf("customer_snapshot.salutation");
String Sepa_agreement = jResp.stringOf("customer_snapshot.sepa_agreement");
String Sepa_agreement_date = jResp.stringOf("customer_snapshot.sepa_agreement_date");
String Sepa_mandate_reference = jResp.stringOf("customer_snapshot.sepa_mandate_reference");
String Since_date = jResp.stringOf("customer_snapshot.since_date");
String customer_snapshotStreet = jResp.stringOf("customer_snapshot.street");
String customer_snapshotSuffix_1 = jResp.stringOf("customer_snapshot.suffix_1");
String customer_snapshotSuffix_2 = jResp.stringOf("customer_snapshot.suffix_2");
String Tax_number = jResp.stringOf("customer_snapshot.tax_number");
String Court = jResp.stringOf("customer_snapshot.court");
String Court_registry_number = jResp.stringOf("customer_snapshot.court_registry_number");
String Tax_options = jResp.stringOf("customer_snapshot.tax_options");
String customer_snapshotTitle = jResp.stringOf("customer_snapshot.title");
String Archived = jResp.stringOf("customer_snapshot.archived");
String Vat_identifier = jResp.stringOf("customer_snapshot.vat_identifier");
String customer_snapshotZip_code = jResp.stringOf("customer_snapshot.zip_code");
String Document_pdf_type = jResp.stringOf("customer_snapshot.document_pdf_type");
String Buyer_reference = jResp.stringOf("customer_snapshot.buyer_reference");
String Foreign_supplier_number = jResp.stringOf("customer_snapshot.foreign_supplier_number");
String discount = jResp.stringOf("discount");
String discount_type = jResp.stringOf("discount_type");
String document_date = jResp.stringOf("document_date");
String due_date = jResp.stringOf("due_date");
String edited_at = jResp.stringOf("edited_at");
String external_id = jResp.stringOf("external_id");
String replica_url = jResp.stringOf("replica_url");
String grace_period = jResp.stringOf("grace_period");
String due_in_days = jResp.stringOf("due_in_days");
String id = jResp.stringOf("id");
boolean is_acceptable_on_public_domain = jResp.BoolOf("is_acceptable_on_public_domain");
boolean is_archive = jResp.BoolOf("is_archive");
String is_draft = jResp.stringOf("is_draft");
boolean is_replica = jResp.BoolOf("is_replica");
boolean is_oss = jResp.BoolOf("is_oss");
String last_postbox_id = jResp.stringOf("last_postbox_id");
String login_id = jResp.stringOf("login_id");
String v_number = jResp.stringOf("number");
String order_number = jResp.stringOf("order_number");
String buyer_reference = jResp.stringOf("buyer_reference");
String paid_amount = jResp.stringOf("paid_amount");
String paid_at = jResp.stringOf("paid_at");
String pdf_pages = jResp.stringOf("pdf_pages");
String pdf_template = jResp.stringOf("pdf_template");
String project_id = jResp.stringOf("project_id");
String Next_date = jResp.stringOf("recurring_options.next_date");
String Frequency = jResp.stringOf("recurring_options.frequency");
String Frequency_special = jResp.stringOf("recurring_options.frequency_special");
int Interval = jResp.IntOf("recurring_options.interval");
String End_date_or_count = jResp.stringOf("recurring_options.end_date_or_count");
String Status = jResp.stringOf("recurring_options.status");
boolean As_draft = jResp.BoolOf("recurring_options.as_draft");
boolean Is_notify = jResp.BoolOf("recurring_options.is_notify");
String Send_as = jResp.stringOf("recurring_options.send_as");
boolean Is_sign = jResp.BoolOf("recurring_options.is_sign");
boolean Is_paid = jResp.BoolOf("recurring_options.is_paid");
String Paid_date_option = jResp.stringOf("recurring_options.paid_date_option");
boolean Is_sepa = jResp.BoolOf("recurring_options.is_sepa");
String Sepa_local_instrument = jResp.stringOf("recurring_options.sepa_local_instrument");
String Sepa_sequence_type = jResp.stringOf("recurring_options.sepa_sequence_type");
String Sepa_reference = jResp.stringOf("recurring_options.sepa_reference");
String Sepa_remittance_information = jResp.stringOf("recurring_options.sepa_remittance_information");
String Target_type = jResp.stringOf("recurring_options.target_type");
String ref_id = jResp.stringOf("ref_id");
String root_id = jResp.stringOf("root_id");
String v_Type = jResp.stringOf("service_date.type");
String Date = jResp.stringOf("service_date.date");
jResp.DtOf("service_date.date_from",false,Date_from);
jResp.DtOf("service_date.date_to",false,Date_to);
String Text = jResp.stringOf("service_date.text");
String shipping_country = jResp.stringOf("shipping_country");
String status = jResp.stringOf("status");
String text = jResp.stringOf("text");
String text_prefix = jResp.stringOf("text_prefix");
String text_tax = jResp.stringOf("text_tax");
String title = jResp.stringOf("title");
String v_type = jResp.stringOf("type");
boolean use_shipping_address = jResp.BoolOf("use_shipping_address");
String vat_country = jResp.stringOf("vat_country");
String vat_id = jResp.stringOf("vat_id");
String fulfillment_country = jResp.stringOf("fulfillment_country");
String vat_option = jResp.stringOf("vat_option");
int i = 0;
int count_i = jResp.SizeOfArray("attachment_ids");
while (i < count_i) {
jResp.put_I(i);
strVal = jResp.stringOf("attachment_ids[i]");
i = i+1;
}
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;
}
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;
}
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;
}
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;
}
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;
}
}
}
Curl Command
curl -X POST
-H "Authorization: {{apiKey}}"
-H "Accept: application/json"
https://api.easybill.de/rest/v1/documents/:id/:type?pdf_template=DE
Postman Collection Item JSON
{
"name": "Convert an existing document to one of a different type",
"request": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json"
}
],
"url": {
"raw": "{{baseUrl}}/documents/:id/:type?pdf_template=DE",
"host": [
"{{baseUrl}}"
],
"path": [
"documents",
":id",
":type"
],
"query": [
{
"key": "pdf_template",
"value": "DE",
"description": "The ID of the printer template to use. Defaults to 'DE' if not given."
}
],
"variable": [
{
"key": "id",
"value": "<long>",
"description": "(Required) ID of document"
},
{
"key": "type",
"value": "DUNNING",
"description": "(Required) The target document type"
}
]
}
},
"response": [
{
"name": "Successful operation",
"originalRequest": {
"method": "POST",
"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/:type?pdf_template=DE",
"host": [
"{{baseUrl}}"
],
"path": [
"documents",
":id",
":type"
],
"query": [
{
"key": "pdf_template",
"value": "DE",
"description": "The ID of the printer template to use. Defaults to 'DE' if not given."
}
],
"variable": [
{
"key": "id"
},
{
"key": "type"
}
]
}
},
"status": "Created",
"code": 201,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
},
{
"key": "Location",
"value": "<uri>",
"description": {
"content": "Absolute URL to the newly created document",
"type": "text/plain"
}
}
],
"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": "Invalid target document type",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Added as a part of security scheme: apikey",
"key": "Authorization",
"value": "<API Key>"
}
],
"url": {
"raw": "{{baseUrl}}/documents/:id/:type?pdf_template=DE",
"host": [
"{{baseUrl}}"
],
"path": [
"documents",
":id",
":type"
],
"query": [
{
"key": "pdf_template",
"value": "DE",
"description": "The ID of the printer template to use. Defaults to 'DE' if not given."
}
],
"variable": [
{
"key": "id"
},
{
"key": "type"
}
]
}
},
"status": "Bad Request",
"code": 400,
"_postman_previewlanguage": "text",
"header": [
],
"cookie": [
],
"body": ""
},
{
"name": "Too Many Requests",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Added as a part of security scheme: apikey",
"key": "Authorization",
"value": "<API Key>"
}
],
"url": {
"raw": "{{baseUrl}}/documents/:id/:type?pdf_template=DE",
"host": [
"{{baseUrl}}"
],
"path": [
"documents",
":id",
":type"
],
"query": [
{
"key": "pdf_template",
"value": "DE",
"description": "The ID of the printer template to use. Defaults to 'DE' if not given."
}
],
"variable": [
{
"key": "id"
},
{
"key": "type"
}
]
}
},
"status": "Too Many Requests",
"code": 429,
"_postman_previewlanguage": "text",
"header": [
],
"cookie": [
],
"body": ""
}
]
}
