Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen Revision Vorhergehende Überarbeitung
webservices:soap_webservices:deliveries [2017/02/07 17:03]
127.0.0.1 Externe Bearbeitung
webservices:soap_webservices:deliveries [2020/05/06 13:59] (aktuell)
d0dge
Zeile 1: Zeile 1:
 ====== Deliveries ====== ====== Deliveries ======
-<WRAP important>​Diese Seite enthält noch nicht alle Informationen bzw. befindet sich aktuell in der Überarbeitung</​WRAP>​ 
- 
- 
-===== WSDL-URI ====== 
- 
- 
-<​code>​http://​hostname/​dirname/​soap/​index.php?​op=deliveries&​wsdl</​code>​ 
- 
-z.B. [[https://​test.tecart-system.de/​soap/​index.php?​op=deliveries&​wsdl|https://​test.tecart-system.de/​soap/​index.php?​op=deliveries&​wsdl]] 
- 
- 
-===== Methods ====== 
- 
- 
- 
-==== crmAddDelivery ===== 
- 
- 
-(Version >= 4.1)  
- 
-**Syntax**: 
-  int crmAddDelivery($session_id,​ $crmDeliveryItem) 
- 
-**Beschreibung**:​ 
- 
-Erzeugt einen neuen Lieferschein. Gibt bei Erfolg die ID des Datensatzes zurück. 
- 
- 
-Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen. 
- 
- 
-//​crmDeliveryItem//​ kann ein assoziatives Array oder ein Objekt sein. 
- 
- 
-**Eigenschaften**:​ 
-  ​ 
-  Type(Length) ​     Eigenschaft ​         Beschreibung 
-  ------------------------------------------------------------------- 
-  int   $cid Kontakt-ID 
-  int               ​$ext_id ​              ​Externe ID ( ab Version 4.2 ) 
-  int   $client_account_id Rechnungskonto-ID 
-  string  ​ $realnumber Belegnummer 
-  int   $date Datum als Unit-Timestamp 
-  int   $printed Druckdatum als Unit-Timestamp 
-  string  ​ $text Text 
-  string  ​ $notes Notizen 
-  int   $reversed zurückgerufen 
-  string  ​ $name Name 
-  int   $invoice_id Rechnungs-ID 
-  int   $delivery_target Lieferziel 
-  int   $delivery_appointed Lieferungstichtag 
-  double  ​ $total_netto Gesamt - netto 
-  double  ​ $tax_value USt-Betrag 
-  double  ​ $total_brutto Gesamt - brutto 
-  int   $is_delivered Lieferdatum als Unit-Timestamp 
-  int   $flow_status Status 
-  string  ​ $shipping_postcode Lieferschein:​ PLZ 
-  string  ​ $shipping_city Lieferschein:​ Ort 
-  string  ​ $shipping_county Lieferschein:​ Land 
-  string  ​ $shipping_name_1 Lieferschein:​ Name 1 
-  string  ​ $shipping_name_2 Lieferschein:​ Name 2 
-  string  ​ $shipping_name_3 Lieferschein:​ Name 3 
-  string  ​ $shipping_address_1 Lieferschein:​ Adresse 1 
-  string  ​ $shipping_address_2 Lieferschein:​ Adresse 2 
-  ​ 
-  string  ​ $user29 Benutzerdefiniertes Feld Nr. 29 
-  string  ​ $user30 Benutzerdefiniertes Feld Nr. 30 
-     : ​                : ​                           : 
-  string  ​ $user80 Benutzerdefiniertes Feld Nr. 80  
- 
- 
-**Beispiel**:​ 
-<sxh php> 
- 
-<?php 
-ini_set("​soap.wsdl_cache_enabled",​ "​0"​);​ 
- 
-try { 
-  $client_logon = new SOAPClient("​https://​test.tecart-system.de/​soap/​index.php?​op=logon&​wsdl"​);​ 
-     ​$session_id = $client_logon->​crmLogin('​test',​ '​test'​);​ 
-     if (!$session_id) die("​invalid login"​);​ 
-  ​ 
-     $data = array( 
-       '​name'​ =>​ 'API Test Delivery',​ 
-       '​realnumber'​ =>​ '​10000001',​ 
-       '​notes'​ =>​ 'Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.',​ 
-       '​cid'​ =>​ 1, 
-       '​client_account_id'​ =>​ 1, 
-       '​invoice_id'​ =>​ 1 
-     ); 
- 
-   ​$client_deliveries = new SOAPClient("​https://​test.tecart-system.de/​soap/​index.php?​op=deliveries&​wsdl"​);​ 
-   ​$delivery_id = $client_deliveries->​crmAddDelivery($session_id,​ $data); 
- 
-   echo $delivery_id;​ 
- 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-?> 
- 
-</​sxh>​ 
- 
----- 
- 
- 
-==== crmChangeDelivery ===== 
- 
- 
-(Version >= 4.1)  
- 
-**Syntax**: 
-  int crmChangeDelivery($session_id,​ $delivery_id,​ $crmDeliveryItem) 
- 
-**Beschreibung**:​ 
- 
-Ändert den Lieferschein mit der übergebenen ID. Gibt bei Erfolg die ID des Datensatzes zurück. 
- 
- 
-Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen. 
- 
- 
-//​crmDeliveryItem//​ kann ein assoziatives Array oder ein Objekt sein. 
- 
- 
-**Eigenschaften:​**:​ 
- 
-Eigenschaften:​ sind die selben wie für [[#​crmAddDelivery]] 
- 
- 
-**Beispiel**:​ 
-<sxh php> 
- 
-<?php 
- 
-try { 
-  $data = array('​name'​ => 'API Test Updated Delivery'​);​ 
-     $res = $client_deliveries->​crmChangeDelivery($session_id,​ $delivery_id,​ $data); 
- 
-   echo $res; 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-?> 
- 
-</​sxh>​ 
- 
----- 
- 
- 
-==== crmGetDelivery ===== 
- 
- 
-(Version >= 4.1)  
- 
-**Syntax**: 
-  array crmGetDelivery($session_id,​ $delivery_id) 
- 
-**Beschreibung**:​ 
- 
-Gibt den Lieferschein mit der übergebenen ID als Array zurück. 
- 
- 
-Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen. 
- 
- 
-**Eigenschaften des zurückgegebenen Array:**: 
-  ​ 
-  Type(Length)  ​ Eigenschaft Beschreibung 
-  --------------------------------------------------------------------------------- 
-  int   $id Delivery-ID 
-  int               ​$ext_id ​                              ​Externe ID ( ab Version 4.2 ) 
-  int   $cid Kontakt-ID 
-  int   $client_account_id Rechnungskonto-ID 
-  string  ​ $realnumber Belegnummer 
-  int   $date Datum als Unit-Timestamp 
-  int   $printed Druckdatum als Unit-Timestamp 
-  string  ​ $text Text 
-  string  ​ $notes Notizen 
-  int   $reversed zurückgerufen 
-  string  ​ $name Name 
-  int   $invoice_id Rechnungs-ID 
-  int   $delivery_target Lieferziel 
-  int   $delivery_appointed Lieferungstichtag 
-  double  ​ $total_netto Gesamt - netto 
-  double  ​ $tax_value USt-Betrag 
-  double  ​ $total_brutto Gesamt - brutto 
-  int   $is_delivered Lieferdatum als Unit-Timestamp 
-  int   $flow_status Status 
-  string  ​ $shipping_postcode Lieferschein:​ PLZ 
-  string  ​ $shipping_city Lieferschein:​ Ort 
-  string  ​ $shipping_county Lieferschein:​ Land 
-  string  ​ $shipping_name_1 Lieferschein:​ Name 1 
-  string  ​ $shipping_name_2 Lieferschein:​ Name 2 
-  string  ​ $shipping_name_3 Lieferschein:​ Name 3 
-  string  ​ $shipping_address_1 Lieferschein:​ Adresse 1 
-  string  ​ $shipping_address_2 Lieferschein:​ Adresse 2 
-  array  ​ $crmOriginalContactElements Original-Daten des Kontaktes 
-  array  ​ $crmOriginalClientAccountElements Original-Daten des Rechnungskontos 
-  int   $createuser Benutzer-ID,​ der Buchung erzeugt hat 
-  int   $createtime Zeitstempel,​ an dem Buchung erzeugt wurde 
-  int   $chguser Benutzer-ID,​ der Buchung zuletzt geändert hat 
-  int   $chgtime Zeitstempel,​ an dem zuletzt geändert wurde 
-  ​ 
-  string  ​ $user29 Benutzerdefiniertes Feld Nr. 29 
-  string  ​ $user30 Benutzerdefiniertes Feld Nr. 30 
-     : ​                :​ :​ 
-  string  ​ $user80 Benutzerdefiniertes Feld Nr. 80  
- 
- 
-**Beispiel**:​ 
-<sxh php> 
- 
-<?php 
- 
-try { 
-  $result = $client_deliveries->​crmGetDelivery($session_id,​ $delivery_id);​ 
- 
-   ​foreach($result as $key => $val) { 
- echo "$key => $val<​br>​\n";​ 
-  } 
-     echo "<​hr/>";​ 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-?> 
- 
-</​sxh>​ 
- 
----- 
- 
- 
-==== crmDeleteDelivery ===== 
- 
- 
-(Version >= 4.1)  
- 
-**Syntax**: 
-  array crmDeleteDelivery($session_id,​ $delivery_id) 
- 
-**Beschreibung**:​ 
- 
-Entfernt den Lieferschein mit der übergebenen ID. 
- 
- 
-Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen. 
- 
- 
-**Beispiel**:​ 
-<sxh php> 
- 
-<?php 
- 
-try { 
-  $result = $client_deliveries->​crmDeleteDelivery($session_id,​ $delivery_id);​ 
- 
-   echo $result; 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-?> 
- 
-</​sxh>​ 
- 
----- 
- 
- 
-==== crmSearchDeliveries ===== 
- 
- 
-(Version >= 4.1)  
- 
-**Syntax**: 
-  array crmSearchDeliveries($session_id,​ $crmSearchDeliveriesParams) 
- 
-**Beschreibung**:​ 
- 
-Sucht anhand der übergebenen Parameter nach Gutschriften. Gibt im Erfolgsfall ein Array mit Gutschriften zurück. 
- 
- 
-Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen. 
- 
- 
-//​crmSearchDeliveriesParams//​ kann ein assoziatives Array oder ein Objekt sein. 
- 
- 
-**Eigenschaften von ****//​crmSearchDeliveriesParams//​**:​ 
-  ​ 
-  Type(Length) ​     Eigenschaft ​         Beschreibung 
-  ------------------------------------------------------------------- 
-  string  ​ $search Suchbegriff 
-  string  ​ $client_account_id Rechnungskonto-ID 
-  string  ​ $is_payed ist Lieferschein bezahlt 
-  int   $status Status 
-  int   $count maximale Anzahl an Elementen, die zurückgegeben wird 
-  int   $offset Position der Ergebnisse, ab der zurückgegeben werden soll 
-  bool  ​ $sorting Einstellung,​ ob Elemente sortiert zurückgegeben werden 
- 
- 
-**Beispiel**:​ 
-<sxh php> 
- 
-<?php 
- 
-try { 
-  $sparams = array('​search'​ => "name LIKE '%API Test Delivery%'"​);​ 
-     ​$deliveries = $client_deliveries->​crmSearchDeliveries($session_id,​ $sparams); 
-  ​ 
-     ​foreach($deliveries as $voucher) { 
- foreach($voucher as $key => $val) { 
-     echo "$key => $val<​br>​\n";​ 
- } 
- echo "<​hr/>"; ​   ​ 
-  } 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-?> 
- 
-</​sxh>​ 
- 
----- 
- 
- 
-==== crmgotoNextFlowStatus ===== 
- 
- 
-(Version >= 4.1)  
- 
-**Syntax**: 
-  int crmgotoNextFlowStatus($session_id,​ $delivery_id) 
- 
-**Beschreibung**:​ 
- 
-Setzt den Status der Gutschrift auf die nächste Stufe. 
- 
- 
-Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen. 
- 
- 
-**Beispiel**:​ 
-<sxh php> 
- 
-<?php 
- 
-try { 
-  $client_deliveries->​crmgotoNextFlowStatus($session_id,​ $delivery_id);​ 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-?> 
- 
-</​sxh>​ 
- 
----- 
- 
- 
-==== crmFromInvoice ===== 
- 
- 
-(Version >= 4.1)  
- 
-**Syntax**: 
-  array crmFromInvoice($session_id,​ $invoice_id,​ $item_ids = false) 
- 
-**Beschreibung**:​ 
- 
-Erzeugt eine Gutschrift aus einer Rechnung. Gibt im Erfolgsfall die ID der erzeugten Gutschrift zurück.. 
- 
- 
-Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen. 
- 
- 
-//​item_ids//​ ist eine Doppelpunkt getrennte Liste von Artikel-IDs. 
- 
- 
-**Beispiel**:​ 
-<sxh php> 
- 
-<?php 
- 
-try { 
-  $result = $client_deliveries->​crmFromInvoice($session_id,​ $invoice_id,​ '​1:​2:​3'​);​ 
-  ​ 
-     echo $result; 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-?> 
- 
-</​sxh>​ 
- 
----- 
- 
- 
-==== crmGetFlowStatus ===== 
- 
- 
-(Version >= 4.1)  
- 
-**Syntax**: 
-  int crmGetFlowStatus($session_id,​ $delivery_id) 
- 
-**Beschreibung**:​ 
- 
-Holt den aktuellen Status des Lieferscheins. 
- 
- 
-Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen. 
- 
- 
-**Beispiel**:​ 
-<sxh php> 
- 
-<?php 
- 
-try { 
-  $status = $client_deliveries->​crmGetFlowStatus($session_id,​ $delivery_id);​ 
-  ​ 
-     echo $status; 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-?> 
- 
-</​sxh>​ 
- 
----- 
- 
- 
-==== crmGetDocument ===== 
- 
- 
-(Version >= 4.1)  
- 
-**Syntax**: 
-  array crmGetDocument($session_id,​ $delivery_id) 
- 
-**Beschreibung**:​ 
- 
-Holt das zun Lieferschein gehörige Dokument aus dem TecArt-System. Gibt ein Array zurück. 
- 
- 
-Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen. 
- 
- 
-**Eigenschaften des zurückgegebenen Array** 
-  ​ 
-  Type(Length) ​     Eigenschaft ​         Beschreibung 
-  ------------------------------------------------------------------- 
-  string  ​ $filename Dateiname des Dokumentes 
-  string  ​ $content base64-codierte Inhalt der Datei 
- 
- 
-**Beispiel**:​ 
-<sxh php> 
- 
-<?php 
- 
-try { 
-  $document = $client_deliveries->​crmGetDocument($session_id,​ $delivery_id);​ 
-  ​ 
-     echo "";​ 
-      var_dump($document);​ 
-      echo "";​ 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-?> 
- 
-</​sxh>​ 
- 
----- 
- 
- 
-==== crmGetArticles ===== 
- 
- 
-(Version >= 4.1)  
- 
-**Syntax**: 
-  array crmGetArticles($session_id,​ $delivery_id) 
- 
-**Beschreibung**:​ 
- 
-Führt Lieferschein zu Inkasso-Vorgang über. Im Erfolgsfall wird die ID zurückgegeben 
- 
- 
-Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen. 
- 
- 
-**Beispiel**:​ 
-<sxh php> 
- 
-<?php 
- 
-try { 
-  $articles = $client_deliveries->​crmGetArticles($session_id,​ $delivery_id);​ 
-  ​ 
-     ​foreach($articles as $article) { 
-       ​foreach($article as $key => $val) { 
- echo "$key => $val<​br>​\n";​ 
-  } 
-     } 
-     echo "<​hr/>";​ 
- 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-?> 
- 
-</​sxh>​ 
- 
----- 
- 
- 
-==== crmAddArticleToList ===== 
- 
- 
-(Version >= 4.1)  
- 
-**Syntax**: 
-  array crmAddArticleToList($session_id,​ $delivery_id,​ $article_id) 
- 
-**Beschreibung**:​ 
- 
-Fügt den Artikel mit der übergebenen ID zu einem Lieferschein hinzu. Im Erfolgsfall wird 1 zurückgegeben. 
- 
- 
-Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen. 
- 
- 
-**Beispiel**:​ 
-<sxh php> 
- 
-<?php 
- 
-try { 
-  $success = $client_deliveries->​crmAddArticleToList($session_id,​ $delivery_id,​ 10);    ​ 
-     echo $success; 
- 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-?> 
- 
-</​sxh>​ 
- 
----- 
- 
- 
-==== crmAddTextToList ===== 
- 
- 
-(Version >= 4.1)  
- 
-**Syntax**: 
-  array crmAddTextToList($session_id,​ $delivery_id,​ $text) 
- 
-**Beschreibung**:​ 
- 
-Fügt einen Artikel-Text zu einem Lieferschein hinzu. Im Erfolgsfall wird 1 zurückgegeben. 
- 
- 
-Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen. 
- 
- 
-**Beispiel**:​ 
-<sxh php> 
- 
-<?php 
- 
-try { 
-  $success = $client_deliveries->​crmAddTextToList($session_id,​ $delivery_id,​ 'Das ist ein Text'​);​ 
-     echo $success; 
- 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-?> 
- 
-</​sxh>​ 
- 
----- 
- 
- 
-==== crmAddSpecialToList ===== 
- 
- 
-(Version >= 4.1)  
- 
-**Syntax**: 
-  array crmAddSpecialToList($session_id,​ $delivery_id,​ $crmBillingItem) 
- 
-**Beschreibung**:​ 
- 
-Fügt einen Sonderartikel zu einem Lieferschein hinzu. Im Erfolgsfall wird 1 zurückgegeben. 
- 
- 
-Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen. 
- 
- 
-//​crmBillingItem//​ kann ein assoziatives Array oder ein Objekt sein. 
- 
- 
-**Eigenschaften**:​ 
-  ​ 
-  Typ             ​Eigenschaft ​                         Beschreibung 
-  --------------------------------------------------------------------------------------------- 
-  int             ​$quantity ​                           Menge 
-  string ​         $realnumber ​                         Artikelnummer 
-  string ​         $name                                Bezeichnung 
-  int             ​$taxrate ​                            ​Steuersatz-Index 
-  double ​         $discount ​                           Rabatt 
-  int             ​$interval ​                           Abrechnungszeitraum-Index 
-  string ​         $description ​                        ​Beschreibung 
-  int             ​$ext_id ​                             Externe ID ( ab Version 4.2 ) 
- 
- 
-**Beispiel**:​ 
-<sxh php> 
- 
-<?php 
- 
-try { 
-  $data = array( 
-       '​quantity'​ =>​ 10, 
-       '​realnumber'​ =>​ '​100001',​ 
-       '​name'​ =>​ 'API Special Article',​ 
-       '​description'​ =>​ 'API Special Article',​ 
-       '​taxrate'​ =>​ 19, 
-       '​discount'​ =>​ 100, 
-       '​interval'​ =>​ 1 
-     ); 
- 
-   ​$success = $client_deliveries->​crmAddSpecialToList($session_id,​ $delivery_id,​ $data); 
-   echo $success; 
- 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-?> 
- 
-</​sxh>​ 
- 
----- 
- 
- 
-==== crmAddGrouplineToList ===== 
- 
- 
-(Version >= 4.1)  
- 
-**Syntax**: 
-  array crmAddGrouplineToList($session_id,​ $delivery_id,​ $crmBillingItem) 
- 
-**Beschreibung**:​ 
- 
-Fügt eine Gruppenzeile zu einem Lieferschein hinzu. Im Erfolgsfall wird 1 zurückgegeben. 
- 
- 
-Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen. 
- 
- 
-//​crmBillingItem//​ kann ein assoziatives Array oder ein Objekt sein. 
- 
- 
-**Eigenschaften**:​ 
-  ​ 
-  Typ             ​Eigenschaft ​                         Beschreibung 
-  --------------------------------------------------------------------------------------------- 
-  int             ​$quantity ​                            Menge 
-  string ​         $name                                 ​Bezeichnung 
-  int             ​$taxrate ​                             Steuersatz-Index 
-  double ​         $discount ​                            ​Rabatt 
-  int             ​$interval ​                            ​Abrechnungszeitraum-Index 
-  string ​         $description ​                         Beschreibung 
-  int             ​$ext_id ​                              ​Externe ID ( ab Version 4.2 ) 
- 
- 
-**Beispiel**:​ 
-<sxh php> 
- 
-<?php 
- 
-try { 
-  $data = array( 
-       '​quantity'​ =>​ 3, 
-       '​name'​ =>​ 'API Groupline',​ 
-       '​description'​ =>​ 'API Groupline',​ 
-       '​taxrate'​ =>​ 19, 
-       '​discount'​ =>​ 100, 
-       '​interval'​ =>​ 1 
-     ); 
- 
-   ​$success = $client_deliveries->​crmAddGrouplineToList($session_id,​ $delivery_id,​ $data); 
-   echo $success; 
- 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-?> 
- 
-</​sxh>​ 
- 
----- 
- 
- 
-==== crmAddMultipleToList ===== 
- 
- 
-(Version >= 4.1)  
- 
-**Syntax**: 
-  array crmAddMultipleToList($session_id,​ $delivery_id,​ $crmMultipleListItems) 
- 
-**Beschreibung**:​ 
- 
-Fügt der Artikelliste mehrere Artikel und Texte und Gruppenzeilen zu einem Lieferschein hinzu. Im Erfolgsfall wird 1 zurückgegeben. 
- 
- 
-Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen. 
- 
- 
-//​crmMultipleListItems//​ ist ein Array von Artikeln, die Eigenschaften sind die selben wie [[#​crmAddArticleToList]],​ [[#​crmAddTextToList]],​ [[#​crmAddSpecialToList]] und [[#​crmAddGrouplineToList]]. 
-Die Unterscheidung erfolgt über das Feld "​type"​. 
- 
- 
-**Eigenschaften**:​ 
-  ​ 
-  Typ             ​Eigenschaft ​                         Beschreibung 
-  --------------------------------------------------------------------------------------------- 
-  array           ​$crmMultipleListItems ​               Artikelliste 
- 
- 
-**Beispiel**:​ 
-<sxh php> 
- 
-<?php 
- 
-try { 
- 
-   ​$items = array(); 
- 
-   ​$items['​crmMultipleListItems'​][] = array('​type'​ => '​article',​ '​id'​ => 10); 
-   ​$items['​crmMultipleListItems'​][] = array('​type'​ => '​text','​text'​ => '​API-AddMultiple Text'​);​ 
- 
-   ​$specialItem = array( 
- '​quantity'​ =>​ 10, 
- '​realnumber'​ =>​ '​100001',​ 
- '​name'​ =>​ 'API Special Article',​ 
- '​description'​ =>​ 'API Special Article',​ 
- '​taxrate'​ =>​ 19, 
- '​discount'​ =>​ 100, 
- '​interval'​ =>​ 1, 
- '​type'​ =>​ '​special'​ 
-  );    ​ 
-     ​$items['​crmMultipleListItems'​][] = $specialItem;​ 
- 
-   $data = array( 
-     '​quantity'​ =>​ 3, 
-     '​name'​ =>​ 'API Groupline',​ 
-     '​description'​ =>​ 'API Groupline',​ 
-     '​taxrate'​ =>​ 19, 
-     '​discount'​ =>​ 100, 
-     '​interval'​ =>​ 1, 
-     '​type'​ =>​ '​groupline'​ 
-   ); 
-   ​$items['​crmMultipleListItems'​][] = $specialItem;​ 
-  
- 
-   ​$success = $client_deliveries->​crmAddMultipleToList($session_id,​ $delivery_id,​ $items); 
- 
-   echo $success; 
- 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-?> 
- 
-</​sxh>​ 
- 
----- 
- 
- 
-==== crmRemoveArticleFromList ===== 
- 
- 
-(Version >= 4.1)  
- 
-**Syntax**: 
-  array crmRemoveArticleFromList($session_id,​ $delivery_id,​ $article_id) 
- 
-**Beschreibung**:​ 
- 
-Löscht den Artikel mit der angegeben ID aus der Artikelliste des Lieferschein. Im Erfolgsfall wird 1 zurückgegeben. 
- 
- 
-Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen. 
- 
- 
-**Beispiel**:​ 
-<sxh php> 
- 
-<?php 
- 
-try { 
-  $success = $client_deliveries->​crmRemoveArticleFromList($session_id,​ $delivery_id,​ 11); 
-  ​ 
-     echo $success; 
- 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-?> 
- 
-</​sxh>​ 
- 
----- 
- 
- 
-==== crmUnlockDelivery ===== 
- 
- 
-(Version >= 4.1)  
- 
-**Syntax**: 
-  int crmUnlockDelivery($session_id,​ $delivery_id) 
- 
-**Beschreibung**:​ 
- 
-Gibt einen Lieferschein zur Bearbeitung wieder frei. Gibt im Erfolgsfall die ID der Gutschrift zurück. 
- 
- 
-Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen. 
- 
- 
-**Beispiel**:​ 
-<sxh php> 
- 
-<?php 
- 
-try { 
-  $result = $client_deliveries->​crmUnlockDelivery($session_id,​ $delivery_id);​ 
-     echo $result; 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-?> 
- 
-</​sxh>​ 
- 
----- 
- 
- 
-==== crmReverseDelivery ===== 
- 
- 
-(Version >= 4.1)  
- 
-**Syntax**: 
-  int crmReverseDelivery($session_id,​ $delivery_id) 
- 
-**Beschreibung**:​ 
- 
-Storniert einen Lieferschein. Gibt im Erfolgsfall die ID des Lieferscheins zurück. 
- 
- 
-Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen. 
- 
- 
-**Beispiel**:​ 
-<sxh php> 
- 
-<?php 
- 
-try { 
-  $result = $client_deliverys->​crmReverseDelivery($session_id,​ $delivery_id);​ 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-   echo $result; 
- 
-?> 
- 
-</​sxh>​ 
- 
----- 
- 
- 
-==== crmToDelivered ===== 
- 
- 
-(Version >= 4.1)  
- 
-**Syntax**: 
-  int crmToDelivered($session_id,​ $delivery_id) 
- 
-**Beschreibung**:​ 
- 
-Setzt des Status eines Lieferschein aus geliefert und im Erfolgsfall die ID des Lieferscheins zurück. 
- 
- 
-Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen. 
- 
- 
-**Beispiel**:​ 
-<sxh php> 
- 
-<?php 
- 
-try { 
-  $result = $client_deliverys->​crmToDelivered($session_id,​ $delivery_id);​ 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-   echo $result; 
- 
-?> 
- 
-</​sxh>​ 
- 
----- 
- 
- 
-==== crmgetIdByExtId ===== 
- 
- 
-(Version >= 4.2) 
- 
-**Syntax:** 
- 
- array crmgetIdByExtId( string $session_id,​ string $external_id )  ​ 
- 
-**Beschreibung** 
- 
-Liefert interne ID(s) von Lieferscheine mit der übergebenen externen ID zurück. 
- 
- 
-**Eigenschaften der zurückgegebenen ****//​delivery Objekte//​**:​ 
-  ​ 
-  Type(Length) ​           Eigenschaft ​                 Beschreibung 
-  --------------------------------------------------------------------------------------------- 
-  int $id  ​     Delivery-Id ​ 
- 
- 
-**Beispiel:​** 
-<sxh php> 
- 
-<?php 
- 
-try { 
-  $result = $client_deliveries->​crmgetIdByExtId($session_id,​ 12345); 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-foreach($result as $id) { 
-  ​ 
-     echo $id."<​br> ​ "; 
-} 
- 
-?> 
- 
-</​sxh>​ 
- 
-------- 
- 
- 
-==== crmgetAllExtIds ===== 
- 
- 
-(Version >= 4.2) 
- 
-**Syntax:** 
- 
- array crmgetAllExtIds( string $session_id )  ​ 
- 
-**Beschreibung** 
- 
-Liefert eine Liste aller externen IDs in Lieferscheine zurück. 
- 
- 
-**Eigenschaften der zurückgegebenen ****//​delivery Objekte//​**:​ 
-  ​ 
-  Type(Length) ​           Eigenschaft ​                 Beschreibung 
-  --------------------------------------------------------------------------------------------- 
-  int $id  ​     externe Delivery-Id ​ 
- 
- 
-**Beispiel:​** 
-<sxh php> 
- 
-<?php 
- 
-try {  
-  $result = $client_deliveries->​crmgetAllExtIds($session_id);​ 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-foreach($result as $id) { 
-  ​ 
-     echo $id."<​br> ​ "; 
-} 
- 
-?> 
- 
-</​sxh>​ 
- 
-------- 
- 
- 
-==== crmsetDuplicateConfig ===== 
- 
- 
-(Version >= 4.4) 
- 
-**Syntax:** 
-  int | string <​errormessage>​ crmDuplicateConfig( string $session_id,​ crmDuplicatecheckFields $crmDuplicatecheckFields ) 
- 
-**Beschreibung:​** 
- 
-Ermöglicht eine temporäre Überschreibung der Dublettenprüfungsfelder für die Laufzeit der angemeldeten Session. 
- 
- 
-**Eigenschaften des zu übergebenden ****//​crmDuplicatecheckFields Objektes//​**:​ 
-  ​ 
-  Type(Length) ​           Eigenschaft ​                 Beschreibung 
-  --------------------------------------------------------------------------------------------- 
-  string $fields  ​    ​implodiertes Array ( implode(',',​ $myFields) ) mit gewünschten Feldern, ​ 
-   ​    auf die eine Dublettenprüfung angewendet werden soll; 
-   ​    wenn Eigenschaft auf NULL gesetzt wird, wird Override zurückgesetzt 
- 
- 
-**Beispiel:​** 
-<sxh php> 
- 
-<?php 
- 
-ini_set("​soap.wsdl_cache_enabled",​ "​0"​);​ 
- 
-try { 
-  $client_logon = new SOAPClient("​https://​test.tecart-system.de/​soap/​index.php?​op=logon&​wsdl"​);​ 
-     ​$session_id = $client_logon->​crmLogin('​test',​ '​test'​);​ 
-     if (!$session_id) die("​invalid login"​);​ 
- 
-   ​$client_deliveries = new SOAPClient("​https://​test.tecart-system.de/​soap/​index.php?​op=deliveries&​wsdl"​);​ 
- 
-   ​$fields ​ = array('​fields'​ => implode(',',​ array('​name',​ '​notes'​)) ); 
-   ​$success = $client_deliveries->​crmsetDuplicateConfig($session_id,​ $fields); 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-echo ($success == 1 ? '​override successful'​ : $success).'​ 
-'; 
- 
-?> 
- 
-</​sxh>​ 
- 
----- 
- 
- 
-==== crmgetDuplicateConfig ===== 
- 
- 
-(Version >= 4.4) 
- 
-**Syntax:** 
-  string crmgetDuplicateConfig( string $session_id ) 
- 
-**Beschreibung:​** 
- 
-Gibt implodiertes Array als Zeichenkette mit aktueller Feldkonfiguration der Dublettenprüfung zurück. 
- 
- 
-Sollte aktuell keine temporäre Überschreibung der Feldkonfiguration aktiv sein (siehe **[[#​crmsetDuplicateConfig]]**),​ wird die durch die Administration konfigurierte Feldliste zurückgegeben. 
- 
- 
-**Beispiel:​** 
-<sxh php> 
- 
-<?php 
- 
-ini_set("​soap.wsdl_cache_enabled",​ "​0"​);​ 
- 
-try { 
-  $client_logon = new SOAPClient("​https://​test.tecart-system.de/​soap/​index.php?​op=logon&​wsdl"​);​ 
-     ​$session_id = $client_logon->​crmLogin('​test',​ '​test'​);​ 
-     if (!$session_id) die("​invalid login"​);​ 
- 
-   ​$client_deliveries = new SOAPClient("​https://​test.tecart-system.de/​soap/​index.php?​op=deliveries&​wsdl"​);​ 
- 
-   ​$fields = $client_notes->​crmgetDuplicateConfig($session_id);​ 
-} 
-catch (SOAPFault $f) { 
-  print $f->​faultstring;​ 
-} 
- 
-$fields = explode(',',​ $fields); 
-echo ''​.print_r($fields,​ true).'';​ 
- 
-?> 
- 
-</​sxh>​ 
- 
----- 
  
 +Bitte besuchen Sie unsere neue Entwickler-Dokumentation unter [[https://​docs.tecart.de/​display/​public/​WIKI/​Deliveries+SOAP]]