Wie migriere ich zur neuen line_items-Struktur, um Header über die API zu verwenden?
Sie können beim Erstellen von Transaktionen in Zoho Books Header als Zeilen in der Artikeltabelle hinzufügen. Mit Headern können Sie zusammengehörige Artikel unter einer Überschrift gruppieren.
Sie können Header in den folgenden Transaktionen hinzufügen:
Verkäufe: Angebote, Verkaufsaufträge, Verkaufsbelege, Rechnungen, wiederkehrende Rechnungen und Gutschriften.
Einkäufe: Bestellungen, Eingangsrechnungen und Lieferantengutschriften.
Bisher stellte für API-Benutzer jeder Eintrag im Array line_items einen regulären Artikel dar. Dasselbe Array enthält nun auch Header-Zeilen, die über ein neues Feld namens line_item_category gekennzeichnet werden. Artikel und Header werden nach item_order sortiert.
Wenn Sie Transaktionen mit Headern über die API erstellen, aktualisieren oder abrufen möchten, aktualisieren Sie Ihre Payloads auf die neue Struktur.
Info: Diese Migration ist nur erforderlich, wenn Sie Header über die API verwenden möchten. Ihre bestehenden Integrationen funktionieren weiterhin ohne Änderungen.
Wichtige Änderungen in der Struktur line_items:
line_item_categoryakzeptiertheader. Bei regulären Artikeln kann dieses Feld ausgelassen werden.item_orderlegt die Position der Zeile in der Artikeltabelle fest.- Header-Zeilen benötigen nur
description,item_orderundline_item_category: "header". - GET-Antworten enthalten Header-Zeilen in
line_items. Wenn Ihr Code davon ausgeht, dass jeder Eintrag ein Artikel ist, fügen Sie eine Prüfung aufline_item_categoryhinzu, um diese Zeilen zu überspringen oder entsprechend zu verarbeiten.
Hinweis:
Weitere Informationen finden Sie in der Zoho Books-API-Dokumentation zum aktualisierten line_items-Schema. Für weitere Unterstützung wenden Sie sich an unser Support-Team unter support@zohobooks.com.
Ja
Nein
Vielen Dank für Ihre Rückmeldung!