API für Bestellungen (/purchase_orders)
Verwenden Sie die Bestell-API, um Bestellungen zu erstellen, zu aktualisieren oder abzufragen.
Übersicht
Wenn Sie mit der API für Bestellungen arbeiten, haben Sie einige Ressourcen-Endpunkte, mit denen Sie arbeiten können:
| Ressource | Pfad | Beschreibung |
|---|---|---|
| PO-Header | /api/purchase_orders |
Vollständige Bestellungen, die Bestellpositionen, Zahlungsbedingungen, Adressen und vieles mehr enthalten. |
| PO-Zeilen | /api/purchase_order_lines |
Detaillierte Informationen zu Bestellpositionen wie Artikelinformationen und Buchhaltungsdetails. Siehe Bestellpositionen API und Bestellpositionen Zuordnungen API für Details. |
| Bestelländerungen | /api/purchase_order_changes |
Erstellen und verwalten Sie Änderungsanfragen für Bestellungen, unabhängig davon, ob sie Genehmigungen vorantreiben oder nicht. |
| Reason Insights | /api/reason_insights/ |
Geben Sie Gründe an, wenn Sie eine Bestellung erneut öffnen. |
Aktionen
API für Bestellungen ermöglicht Ihnen:
| Verb | Pfad | Aktion | Beschreibung |
|---|---|---|---|
| PUT | /api/purchase_orders/:id/cancel |
abbrechen | Abbrechen |
| PUT | /api/purchase_orders/:id/close |
schließen | Eine Bestellung schließen. Weitere Informationen finden Sie unter Abschluss von Bestellungen. |
| BEITRAG | /api/purchase_orders |
erstellen | Erstellen Sie eine Bestellung im Rahmen der externen Bestellfunktion. Nicht für Coupa-basierte Bestellungen verwenden. |
| PUT | /api/purchase_orders/:id/ignore_window_and_issue |
ignore_window_and_issue | Ignorieren von Windows und Problem |
| ABFRAGEN | /api/purchase_orders |
index | Bestellungen beanstanden |
| PUT | /api/purchase_orders/:id/issue |
problem | Stellen Sie die Bestellung aus und senden Sie sie an den Lieferanten. |
| PUT | /api/purchase_orders/:id/issue_without_send |
issue_without_send | Ausgabe, ohne die Bestellung an den Lieferanten zu senden. |
| PUT | /api/purchase_orders/:id/release_from_buyer_hold |
release_from_buyer_hold | Für die Prüfung durch den Einkäufer zurückstellte Bestellung freigeben |
| PUT | /api/purchase_orders/:id/reopen |
wiedereröffnen | Öffnen Sie eine Soft-Closed-Bestellung erneut. Weitere Informationen zum Soft-Close finden Sie unter Abschluss von Bestellungen. |
| ABFRAGEN | /api/purchase_orders/:id |
anzeigen | Bestellung anzeigen |
| PATCH | /api/purchase_orders/:id |
update | Bestellung aktualisieren |
| PUT | /api/purchase_orders/:id |
aktualisierung | Bestellung aktualisieren |
Elemente
| Element | Beschreibung | Anf. | Eindeutig | Zulässiger Wert | In | Out | Datentyp |
|---|---|---|---|---|---|---|---|
| quittiert-at | acknowledged_at | ja | datum/Uhrzeit | ||||
| acknowledged-flag | Wurde die Bestellung vom Lieferanten bestätigt? | ja | ja | boolean | |||
| anhänge | anhänge | ja | ja | Anhang | |||
| änderungsart | Letzte Art der Bestelländerung; gibt ob eine Bestellung per Änderungsantrag geändert oder überarbeitet wurde. | ändern, Überarbeiten, Bestätigen | ja | string(255) | |||
| coupa-accelerate-status | Status, der angibt, ob die Rechnung Skontofristen über die statische Skontierung hat | beschleunigt | ja | string(255) | |||
| created-at | Datensatz wurde in Coupa erstellt. | ja | datum/Uhrzeit | ||||
| erstellt von | Coupa-ID des Benutzers, der die Rechnung erstellt hat | ja | Benutzer | ||||
| währung | Währung der Transaktion | ja | ja | Währung | |||
| aktuelle-integrationshistorie-aufzeichnungen | Aktuelle Integrationsverlaufsdatensätze | ja | Datensatz des Integrationsverlaufs | ||||
| exported | Gibt an, ob die Transaktion exportiert wurde | ja | boolean | ||||
| hide-price | Preis für Lieferant ausblenden. Richtig oder falsch | nein | nein | ja | boolean | ||
| iD | Interne Coupa-ID | ja | ganze Zahl | ||||
| internal-revision | Interne Revisionsnummer - Diese Nummer erhöht sich jedes Mal, wenn eine Bestellung geändert wird, und zwar unabhängig davon, ob es sich um eine interne Änderung handelt oder ein erneuter Versand der Bestellung an den Lieferanten ausgelöst wird. | ja | ganze Zahl | ||||
| invoice-stop | Kennzeichnung „Rechnungsstopp“ | ja | boolean | ||||
| last-exported-at | Datum und Uhrzeit, zu der die Transaktion zuletzt exportiert wurde, im Format JJJJ-MM-TTTHH:MM:SS+HH:MMZ | ja | datum/Uhrzeit | ||||
| meilensteine | Meilensteine | ja | ja | Beschaffung::Meilenstein | |||
| auftragszeilen | order_lines | ja | ja | ja | Bestellposition | ||
| zahlungsmethode | payment_method | ja | ja | string(255) | |||
| zahlungsbedingung | Zahlungsbedingungen | ja | ja | Zahlungsbedingung | |||
| p-Card | p-Card | ja | ja | P-Card | |||
| po-number | Bestellnummer | ja | ja | ja | ja | string(20) | |
| preis versteckt | Preis für Lieferant ausblenden. Richtig oder falsch | ja | boolean | ||||
| reason-insight-events | Grund Insight-Ereignisse für Änderungen, Wiedereröffnung usw. | ja | Event für Insight zu Gründen | ||||
| anforderer | Anmeldedaten des beantragenden Kontos | ja | Benutzer | ||||
| anforderungskopfzeile | Anforderungsüberschrift | ja | Anforderungsüberschrift | ||||
| ship-to-Address | ship_to_address | nein | nein | beliebig | ja | ja | Adresse |
| ship-to-Attention | Der Nutzer, für den die Bestellung adressiert wird. Zu Händen des Empfängers versenden. | nein | nein | alle | ja | ja | string(255) |
| ship-to-User | ship_to_user | ja | ja | ja | Benutzer | ||
| lieferbedingung | Zahlungsbedingungen | ja | ja | Versandbedingungen | |||
| status | Bestellstatus | buyer_hold, cancelled, closed, currency_hold, draft, error, expensed, issued, supplier_hold, supplier_window_hold, exported | ja | string(50) | |||
| Lieferant | Interne Coupa-ID des Lieferanten | ja | ja | ja | Lieferant | ||
| lieferanten-Standort | Lieferantenstandort | nein | nein | alle | ja | ja | Lieferantenstandort |
| sende-E-Mails | Übertragungs-E-Mail, durch Kommas getrennte Liste | nein | nein | alle | ja | ja | text |
| getriebemethoden-Override | Außerkraftsetzung der Übertragungsmethode | nein | nein | supplier_default, email, do_not_transmit | ja | ja | string(30) |
| getriebestatus | Übertragungsstatus | nein | nein | created, deferred, deferred_processing, pending_manual, pending_manual_cancel, awaiting_online_purchase, scheduled_for_email, sent_via_email, scheduled_for_cxml, scheduled_for_xml, sent_via_cxml, sent_via_xml, sent_manually, purchased_online, transmission_failure | ja | zeichenfolge | |
| typ | Art der Bestellung | ExternalOrderHeader | ja | string(255) | |||
| updated-at | Zuletzt aktualisiert | ja | datum/Uhrzeit | ||||
| aktualisiert von | Coupa-ID des Benutzers, der die Rechnung erstellt hat | ja | Benutzer | ||||
| version | Lieferanten-Versionsnummer der Bestellung - Diese Nummer erhöht sich mit jeder Änderung einer Bestellung, was dazu führt, dass die Bestellung erneut an den Lieferanten gesendet wird. | ja | ja | ganze Zahl | |||
| klassifizierung | Klassifizierung | msp, lieferant, vms | ja | ja | string(255) | ||
| währung | Währung der Transaktion | ja | |||||
| confirm-by-hrs | Bestätigung bis | ja | ganze Zahl | ||||
| auftragsbestätigungsstufe | Bestätigungsebene | ja | int(11) | ||||
| benutzer-Mitglieder | Benutzermitglieder | ja | Benutzer | ||||
| benutzergruppenmitglieder | Benutzergruppenmitglieder | ja | Benutzer | ||||
Notizen
- Es gibt abhängige Felder, die basierend auf dem Wert aus dem Quellfeld abfragbar werden. Wenn Sie beispielsweise eine Abfrage gegen
po-method=email durchführen, kann po-email als zusätzliches Abfragekriterium hinzugefügt werden. Bitte beachten Sie die Felder mit Ja*. - Für große Datenmengen und zur Leistungsoptimierung sollten Sie Ihr Ergebnis immer mit einigen GET-Kriterien begrenzen.
- Bestelländerungen erhöhen nicht immer die Versionsnummer. Weitere Informationen finden Sie unter Felder, die eine Bestellrevision verursachen. Über das Feld
updated-at kann immer festgestellt werden, ob Änderungen vorgenommen wurden.
Code-Beispiele
Eine Bestellposition mit PUT LÖSCHEN
<?xml version="1.0" encoding="UTF-8"?>
<order-header>
<order-lines>
<order-line>
<id>coupa_line_id</id>
<_delete>wahr</_delete>
</order-line>
</order-lines>
</order-header> Eine sanft geschlossene Auftragsbestätigung erneut öffnen
Weitere Informationen zum Soft-Close finden Sie unter Abschluss von Bestellungen.
Verwenden einer Reason Insight ID
<?xml version="1.0" encoding="UTF-8"?>
<order-header>
<reason-insight-id>1</reason-insight-id>
<reason-insight-event-comment>kommentartext</reason-insight-event-comment>
</order-header>Verwenden eines Reason Insight-Codes
<?xml version="1.0" encoding="UTF-8"?>
<order-header>
<reason-insight-code>code</reason-insight-code>
<reason-insight-event-comment>kommentartext</reason-insight-event-comment>
</order-header>