Inhalt

Einführung

Die API-Schnittstelle der Print Lounge ermöglicht einen automatisierten, maschinengeeigneten Zugriff auf Daten aus der Print Lounge. Dies ermöglicht eine Integration in interne Prozesse und Tools. Die API ist ein zusätzliches Modul und kann für jeden Mandanten aktiviert werden. Für die Nutzung sind keine speziellen Pakete oder Optionen erforderlich. Die verfügbaren Daten entsprechen den Daten aus der Print Lounge. Auf dieser Seite werden generelle API-Informationen bereitgestellt. Der Abruf von Print Lounge-Daten geschieht über die URL.

...

HTTP Methode

Pfad

Parameter

Request-Body

Beispiel

Rückgabeformat

GET

/api/article

-

http://shop.printlounge.local
/api/article

[  
   {  
      "id":"39293",
      "name":"Handelsware",
      "nameIntern":"intern",
      "fullDescription":"<p>full<\/p>\r\n",
      "detailedDescription":"<p>detailed<\/p>\r\n",
      "additionalInformation":"<p>additional<\/p>\r\n",
      "articleType":"25",
      "articleSapNumber":"sap",
      "productionTime":"1",
      "deliveryTime":"2"
   },
   {  
      "id":"39294",
      "name":"PrintOnDemand",
      "nameIntern":"",
      "fullDescription":"",
      "detailedDescription":"",
      "additionalInformation":"",
      "articleType":"26",
      "articleSapNumber":"SAP-Nummer12",
      "productionTime":"0",
      "deliveryTime":"0"
   }
]

Wobei articleType sein kann:

25: Handelsware
80: Handeslware mit Upload
27: Handelsware Plus
26: Print on Demand
139: Mietartikel
100: Artikelpaket
152: Mailing
106: Global

GET

/api/article/{article-id}

http://shop.printlounge.local
/api/article/4711

{  
   "id":"39293",
   "name":"Handelsware",
   "nameIntern":"intern",
   "fullDescription":"<p>full<\/p>\r\n",
   "detailedDescription":"<p>detailed<\/p>\r\n",
   "additionalInformation":"<p>additional<\/p>\r\n",
   "articleType":"25",
   "articleSapNumber":"sap",
   "productionTime":"1",
   "deliveryTime":"2"
}

Verfügbare Daten

Bestellung

HTTP Methode

Pfad

Parameter

Request-Body

Beispiel

Rückgabeformat

Fürs eine Auflistung der aktuellsten Bestellungen, siehe Bestellstatus:
/api/order/

[
  {
    "id": 1235,
    "internalOrderCode": "ABCDEG",
    "orderCode": "MY4720",
    "status": 1,
    "orderStatus": 61,
    "statusPaid": 1,
    "lastModified": "2021-11-11 11:11:11",
    "createDate": "2021-11-11 11:11:11"
  },
  {
    "id": 1234,
    "internalOrderCode": "ABCDEF",
    "orderCode": "MY4710",
    "status": 1,
    "orderStatus": 61,
    "statusPaid": 0,
    "lastModified": "2020-11-11 11:11:11",
    "createDate": "2020-11-11 11:11:11"
  }
]

GET

/api/cart/{order-code}

-

https://shop.printlounge.local/api/cart/XABCDE

{
 "id": 645135
 "client_id": 1234
 "order_customer_id": 3124
 "order_budgetgroup_user_id": 564231
 "order_budgetgruppe": "example content"
 "order_code": "example content"
 "order_number": 231
 "external_order_code": "example content"
 "order_desc": "example content"
 "order_total": 0
 "order_deliver_address_company": "example content"
 "order_deliver_address_company2": "example content"
 "order_deliver_address_name": "example content"
 "order_deliver_address_firstname": "example content"
 "order_deliver_address_lastname": "example content"
 "order_deliver_address_title": "example content"
 "order_deliver_address_street": "example content"
 "order_deliver_address_zip": 12345
 "order_deliver_address_town": "example content"
 "order_deliver_address_country_code": "example content"
 "order_deliver_address_email": "example content"
 "order_deliver_address_email2": "example content"
 "order_payment_method": 0
 "order_deliver_address_department": "example content"
 "order_deliver_address_cost_center": "example content"
 "order_deliver_address_customer_order_number": "example content"
 "order_deliver_address_phone": "example content"
 "order_deliver_address_fax": "example content"
 "order_deliver_address_country": "example content"
 "order_bank_code": "example content"
 "order_bank_name": "example content"
 "order_depositor": "example content"
 "order_tax_id": "example content"
 "invoice_address_company1": "example content"
 "invoice_address_company2": "example content"
 "invoice_address_company3": "example content"
 "invoice_address_title": "example content"
 "invoice_address_name": "example content"
 "invoice_address_firstname": "example content"
 "invoice_address_lastname": "example content"
 "invoice_address_phone": "example content"
 "invoice_address_street": "example content"
 "invoice_address_zip": 12345
 "invoice_address_town": "example content"
 "invoice_address_country": "example content"
 "invoice_address_country_code": "example content"
 "order_customer_user_id": 984563
 "order_user_name": "example content"
 "serviceprovider_id": 0
 "serviceprovider_x_id": 0
 "serviceprovider_status": "example content"
 "cart_table": 1
 "order_express_delivery": 0
 "order_express_delivery_surcharge": "example content"
 "order_delivery_method": "example content"
 "order_comment": "example content"
 "order_budget_before": 0.00
 "order_budget_booking": 0.00
 "order_budget_booking_after": 0.00
 "order_status": 62
 "order_delivery_date": "example content"
 "packages": 0
 "weight": 0
 "barcode": "example content"
 "order_approval": "example content"
 "approval_email": "example content"
 "order_approval_explaination": "example content"
 "pdate": "example content"
 "sdate": "example content"
 "mdate": "example content"
 "cdate": "example content"
 "status": 3
 "status_paid": 0
 "date_paid": "example content"
 "status_sendmail": 1
 "opentrans_status": 0
 "printshop": 0
 "order_type_print_job": 1
 "order_type_pdf": 0
 "emailing_name": "example content"
 "emailing_email": "example content"
 "emailing_additional_text": "example content"
 "invoice_number": 0
 "individual_order_code": "example content"
 "individual_order_item_code": 0
 "individual_invoice_number": "example content"
 "individual_order_item_code_invoice": 0
 "coupon_code": 0
 "payment_interface": 0
 "md5_order_consolidation": 0
 "md5": "example content"
 "collective_price_scale": 0
 "approved_by": "example content"
 "order_language": "example content"
 "order_budged": "example content"
 "shipping_charges": 9.99
 "vat_amount": 0.00
 "net_amount": 10.00
 "gross_amount": 10.00
 "auth_micropayment": "example content"
 "budgedgroup_discount": 0
 "budgedgroup_discount_amount": "example content"
 "position_feedback": 0
 "vat_included": 54
 "date_of_invoice": "example content"
 "cartItems":  {
  "1": {
   "id": 121314
   "client_id": 1234
   "order_id": 645135
   "parent_id": 0
   "type": 1
   "aid": 231450
   "article_type": 26
   "persdata": "example content"
   "persdata_array": "example content"
   "additional_fields_array": "example content"
   "cart_additional_fields_array": "example content"
   "article_options_remark": "example content"
   "quantity": 370169
   "quantity_value": 1
   "remark": "example content"
   "filename": "example content"
   "pdf_filenames": "example content"
   "cost_center": "example content"
   "mdate": "example content"
   "cdate": "example content"
   "rdate": "example content"
   "r_remark": "example content"
   "r_short": "example content"
   "r_email": "example content"
   "s_desc": "example content"
   "s_quantity_value": 1
   "s_cost_center": "example content"
   "s_total": "example content"
   "s_ntotal": 1
   "s_vat": 2
   "mailing_count": 0
   "status": "example content"
   "send_reminder": 0
   "printshop": 0
   "payment_interface": 0
   "md5": "example content"
   "show": 1
   "jobname": "example content"
   "premium_interactive_editor": 0
   "premium_image_upload": 0
   "page_count": 1
   "download_count": 0
   "article_options": "example content"
   "pdf_download_only": 0
   "local_order_workflow_step_id": 0
   "uploadpath": "example content"
   "direct_download": 0
   "cart_addresses_array": 0
   "serviceprovider_id": 0
   "serviceprovider_status": "example content"
   "order_number": 133
   "do_not_calculate": 0
   "postage_graduation": 0
   "ftp_checksum": "example content"
   "ftp_download": 0
   "ftp_error": 0
   "data_id": 0
   "status_sendmail": 1
   "reorder": 0
   "article_reorder": 0
   "voucher": 0
   "voucher_id": 0
   "voucher_array": "example content"
   "approval_address_id": 0
   "mailing": 0
   "report_group_id": 0
  }
 }
}

Wobei type sein kann:

1: Article
2: Versand
3: Handling
4: Dienstleisterversand
5: Artikeloption
6: Artikel freies Kontingent
7: Artikel Lagerrückführung
8: Zusätzliche Gebühr für kleine Mengen
9: credit fpr handling cost
10: Kundendiscount
11: Payment
12: Artikeldiscpount
13: Kostenlose Position durch Admin hinzugefügt
14: Artikelbestellgebühr
15: Artikel dynamische Option
16: Postaktuell Artikel
17: Kostenübernahme
18: Werbezuschüsse
19: Zusätzlicher Aufpreis
101: Externer Artikel über OCI-Punchout empfangen

...

HTTP Methode

Pfad

Parameter

Request-Body

Beispiel

Rückgabeformat

GET

/api/order/

Zum Blättern:

limit
lastSeenId

Zum Filtern:

orderStatus
status
statusPaid

/api/order/?limit=20&lastSeenId=4711&orderStatus=61&status=1&statusPaid=1

[
  {
    "id": 1235,
    "internalOrderCode": "ABCDEG",
    "orderCode": "MY4720",
    "status": 1,
    "orderStatus": 62,
    "statusPaid": 1,
    "lastModified": "2021-11-11 11:11:11",
    "createDate": "2021-11-11 11:11:11"
  },
  {
    "id": 1234,
    "internalOrderCode": "ABCDEF",
    "orderCode": "MY4710",
    "status": 1,
    "orderStatus": 61,
    "statusPaid": 0,
    "lastModified": "2020-11-11 11:11:11",
    "createDate": "2020-11-11 11:11:11"
  }
]

GET

/api/order/{order-code}

-

https://shop.printlounge.local/api/order

{
 "order_code": "XABCDE"
 "order_status": 61
}

PUT/PATCH

/api/order/{order-code}

-

{"order_status":"137"}

http://shop.printlounge.local/api/order/39293

...

Status	Bezeichnung
61	in Produktion
62	im Versand
63	geliefert
69	Storno
73	auf Freigabe warten
74	Freigabe abgelehnt
88	Freigabe erteilt
117	erledigt
137	abgerechnet
140	warte auf Zahlungsanbieter
144	warte auf Kostenfreigabe

Addressen

HTTP Methode

Pfad

Parameter

Request-Body

Beispiel

Rückgabeformat

GET

/api/order/{{OrderCode}}/addresses/deliver

/api/order/{{OrderCode}}/addresses/invoice

-

/api/order/RQREJC/addresses/deliver

/api/order/RQREJC/addresses/invoice

{
"company1": "Firma",
"company2": "Firma2",
"company3": null,
"name": "Ansprechpartner",
"firstName": "",
"lastName": "",
"title": "",
"street": "Street",
"zip": "12345",
"town": "Stadt",
"country": "Deutschland",
"countryCode": "DE",
"email": "mail@lead-print.com",
"department": null,
"telephone": "",
"fax": null
}

PUT/PATCH

/api/order/{{OrderCode}}/addresses/deliver

/api/order/{{OrderCode}}/addresses/invoice

-

{
"company1": "Firma",
"company2": "Firma2",
"company3": null,
"name": "Ansprechpartner",
"firstName": "",
"lastName": "",
"title": "",
"street": "Street",
"zip": "12345",
"town": "Stadt",
"country": "Deutschland",
"countryCode": "DE",
"email": "mail@lead-print.com",
"department": null,
"telephone": "",
"fax": null
}

/api/order/RQREJC/addresses/deliver

/api/order/RQREJC/addresses/invoice

true

Wenn die Daten nicht valide sind:

{
    "success": false,
    "message": "Validation errors",
    "data": {
"countryCode": [
    "validation.size.string"
   ]
}
}

Wenn keine Daten übermittelt wurden:

{
    "success": false,
    "message": "no data to found",
    "data": []
}

Tracking/Sendungsverfolgung

...

HTTP Methode

Pfad

Parameter

Request-Body

Beispiel

Rückgabeformat

GET

/api/cart-item/{cart-item-id}

http://shop.printlounge.local
/api/cart-item/4711

{
  "id": "4711",
  "client_id": "42",
  "order_id": "123",
  "parent_id": "4710",
  "type": "5",
  "aid": "0",
  "article_type": "0",
  "persdata": "",
  "persdata_array": "",
  "additional_fields_array": "",
  "cart_additional_fields_array": "",
  "article_options_remark": "",
  "quantity": "1",
  "quantity_value": "1",
  "remark": "",
  "filename": "",
  "pdf_filenames": "",
  "cost_center": "",
  "mdate": "2021-08-12 16:09:08",
  "cdate": "2021-08-10 11:18:18",
  "rdate": "0000-00-00 00:00:00",
  "r_remark": null,
  "r_short": "",
  "r_email": "",
  "s_desc": "B-Option: Eins",
  "s_quantity_value": "1 St\u00fcck",
  "s_cost_center": "",
  "s_total": "\u00a3 1,00",
  "s_ntotal": "100",
  "s_vat": "1",
  "mailing_count": "0",
  "status": "OK",
  "send_reminder": "0",
  "printshop": "0",
  "payment_interface": "0",
  "md5": "4b0c123b9ae682cd9b57224e90a651bf",
  "show": "1",
  "jobname": "",
  "premium_interactive_editor": "0",
  "premium_image_upload": "0",
  "page_count": "0",
  "download_count": "0",
  "article_options": "",
  "pdf_download_only": "0",
  "local_order_workflow_step_id": "0",
  "uploadpath": "",
  "direct_download": "0",
  "cart_addresses_array": "0",
  "serviceprovider_id": "80882",
  "serviceprovider_status": "new",
  "order_number": "0",
  "do_not_calculate": "0",
  "postage_graduation": "0",
  "ftp_checksum": "",
  "ftp_download": "0",
  "ftp_error": "0",
  "data_id": "0",
  "status_sendmail": "1",
  "reorder": "0",
  "article_reorder": "0",
  "voucher": "0",
  "voucher_id": "0",
  "voucher_array": "",
  "approval_address_id": "0",
  "mailing": "0",
  "report_group_id": "0"
}

Infos

HTTP Methode	Pfad	Parameter	Request-Body	Beispiel	Rückgabeformat
GET	/api/cart-item/{cart-item-id}/info			https://dev.localhost/api/cart-item/4711/info	[ { "name": "articleOptionId", "value": 5692 }, { "name": "sapNumber", "value": "mySAP-1" } ]
GET	/api/cart-item/{cart-item-id}/info/sapNumber			https://dev.localhost/api/cart-item/4711/info/sapNumber	"mySAP-1"

DHL Mailoptimizer/Portooptimierung

...

HTTP Methode

Pfad

Parameter

Beispiel

Rückgabeformat

GET

/api/article-option/printfile/{option_id}

http://shop.printlounge.local/api/article-option/printfile/56269

{
"link": "shop.printlounge.local",
"file": "56269_test.pdf"
}

POST

/api/article-option/printfile/{option_id}

link

file

http://t.printlounge.local/api/article-option/printfile/56269

{
"status": "OK"
}

Rückgabewerte/Response codes

...

Versionen im Vergleich

Alte Version 52

Neue Version 53

Schlüssel

Einführung

Verfügbare Daten

Bestellung

Addressen

Tracking/Sendungsverfolgung

Infos

DHL Mailoptimizer/Portooptimierung

Rückgabewerte/Response codes

Seitenvergleich

Versionen im Vergleich

Alte Version 52

Neue Version 53

Schlüssel

Einführung

Verfügbare Daten

Bestellung

Addressen

Tracking/Sendungsverfolgung

Infos

DHL Mailoptimizer/Portooptimierung

Rückgabewerte/Response codes