# Falsche Docs für Auftragsimport (mindestens)

**URL:** <https://forum.shopware.com/t/falsche-docs-fuer-auftragsimport-mindestens/94118>\
**Category:** Shopware 6 (German)\
**Tags:** programming\
**Created:** [27. April 2022 um 10:27 UTC](https://forum.shopware.com/t/falsche-docs-fuer-auftragsimport-mindestens/94118 "2022-04-27T10:27:25Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![chroot](https://dub1.discourse-cdn.com/flex013/user_avatar/forum.shopware.com/chroot/32/16651_2.png) [@chroot](https://forum.shopware.com/u/chroot)\
**Post date:** [27. April 2022 um 10:27 UTC](https://forum.shopware.com/t/falsche-docs-fuer-auftragsimport-mindestens/94118/1 "2022-04-27T10:27:25Z")

</div>

Hallo,

beim Auftragsimport per REST erhalte ich einige unerwartete Fehler.

In Entität `Order`:

- `/0/price/calculatedTaxes: Dieser Wert sollte nicht null sein.` – [Order-Docs](https://shopware.stoplight.io/docs/admin-api/c2NoOjE0MzUxMjcy-order) nennen es jedoch nicht als erforderlich.
- Selbes Spiel bei `/0/shippingCosts/calculatedTaxes`.
- Selbes Spiel in `OrderLineItem`-Entitäten.

In Entität `OrderAddress`:

- `/0/salutationId: Dieser Wert sollte nicht leer sein.`: Ist nicht als erforderlich in den Docs genannt.

Die Docs machen insgesamt einen veralteten Eindruck. Sie haben außerdem den systematischen Fehler, dass Objekt-Arrays nur als Objekte angegeben werden. Beispiel: Order-Entität enthält das Feld `addresses`. Es ist als `object` angegeben, obwohl es ein Array ist. Das ist entsprechend auch so im JSON-Schema angegeben, was die Code-Erzeugung erschwert.

Liebe Shopware-Entwickler, bitte bringt die Docs mal auf den neuesten Stand. Wenn das Object-Array-Problem gelöst werden kann, wäre natürlich optimal.

Meine Shopware-Version: 6.4.10.1

Viele Grüße

---

<div class="post-metadata">

**Author:** ![chroot](https://dub1.discourse-cdn.com/flex013/user_avatar/forum.shopware.com/chroot/32/16651_2.png) [@chroot](https://forum.shopware.com/u/chroot)\
**Post date:** [27. April 2022 um 12:35 UTC](https://forum.shopware.com/t/falsche-docs-fuer-auftragsimport-mindestens/94118/2 "2022-04-27T12:35:55Z")

</div>

Die Information zu `calculatedTaxes` ist auch etwas dürftig:

![image](https://europe1.discourse-cdn.com/flex013/uploads/shopware/original/3X/0/a/0a1dedbd68bf5295f77aeb7928dacc63638a7a58.png)

Es sind keine weiteren Angaben neben `object` vorhanden, wodurch die möglichen Felder nicht erkannt werden können. Da ist auch kein Pfeil zum Aufklappen.

---

<div class="post-metadata">

**Author:** ![chroot](https://dub1.discourse-cdn.com/flex013/user_avatar/forum.shopware.com/chroot/32/16651_2.png) [@chroot](https://forum.shopware.com/u/chroot)\
**Post date:** [28. April 2022 um 10:02 UTC](https://forum.shopware.com/t/falsche-docs-fuer-auftragsimport-mindestens/94118/3 "2022-04-28T10:02:00Z")

</div>

Die beste Information scheinen die Schopware-Quellen selbst zu sein.

- Die dürftige `object`-Information rührt offenbar von PHP-Typ-Verwirrung. Der Schema-Generator scheint nicht zu erkennen, dass es sich bei `XXXCollection`-Klassen um den üblichen PHP-Boilerplate für einen Typ `Liste aus XXXs` handelt.
- Die tatsächlich erforderlichen Felder scheinen solche Felder zu sein, die keine Typ-Annotation `|null` haben, oder keinen Default-Wert im Konstruktor. So genau kann ich es nicht sagen, da ich die Shopware-Quellen nicht ausführlich gewälzt habe.

Kein Pluspunkt für „API first“-Shopware.