Änderungs-API für Bestellung
Verwenden Sie die Bestelländerungs-API, um Bestellungen zu ändern, die sich bereits im Flug befinden, entweder in Genehmigungen oder an den Lieferanten gesendet.
Übersicht
Verwenden Sie diese API, um Bestellungen zu ändern, die sich bereits im Flug befinden, entweder in Genehmigungen oder an den Lieferanten gesendet.
Bestelländerungen GET API ist nicht dazu gedacht, Bestellrevisionen an ERP abzurufen.
Verwenden Sie für PO-Revisionen immer die PO-GET-API mit exportiert = false und verwenden SIE den Wert "Version", um zu identifizieren, ob es sich bei der PO um eine neue oder um eine überarbeitete PO handelt.
Aktionen
Mit der API für Bestelländerungen können Sie:
| Verb | Pfad | Aktion | Beschreibung | ||
|---|---|---|---|---|---|
| PUT | /api/purchase_order_changes/:id/add_approver |
add_approver | Manuell eine genehmigende Stelle für eine Bestellkopfänderung hinzufügen | ||
| BEITRAG | /api/purchase_order_changes |
erstellen | Bestelländerung erstellen. Der Post-Aufruf FÜR Bestellungen kann nicht im Entwurfs- oder ausstehenden Genehmigungsstatus gesendet werden. | ||
| ABFRAGEN | /api/purchase_order_changes |
index | Abfrage für Bestelländerungen starten | ||
| PUT | /api/purchase_order_changes/:id/remove_approval |
remove_approval | Eine manuell hinzugefügte genehmigende Stelle entfernen | ||
| ABFRAGEN | /api/purchase_order_changes/:id |
anzeigen | Bestelländerung anzeigen | ||
| PUT | /api/purchase_order_changes/:id/submit_for_approval |
submit_for_approval | Bestelländerung zur Genehmigung einreichen | ||
| PUT | /api/purchase_order_changes/:id |
aktualisierung | Bestelländerung aktualisieren. Datensätze, die über das Coupa Supplier Portal erstellt wurden, können nicht aktualisiert werden. | ||
Elemente
| Element | Beschreibung | Anf. | Eindeutig | Zulässiger Wert | In | Out | Datentyp |
|---|---|---|---|---|---|---|---|
| quittiert-at | acknowledged_at | ja | datum | ||||
| genehmigungen | <approver> attribut mit <login> Wert muss für PUT/PATCH zu einer bestehenden PO-Änderungsanforderung hinzugefügt werden. |
Ja* | Der aktuelle Genehmiger <login> muss in Coupa vorhanden sein |
ja | ja | Genehmigung | |
| anhänge | Anhänge | ja | Anhang | ||||
| created-at | Automatisch von Coupa erstellt im Format JJJJ-MM-TTTHH:MM:SS+HH:MMZ | ja | datum/Uhrzeit | ||||
| erstellt von | Benutzer der Erstellung | ja | Benutzer | ||||
| aktuelle-Genehmigung | Aktuell/Genehmigung ausstehend | ja | Genehmigung | ||||
| abteilung | abteilung | ja | Abteilung | ||||
| easy_form_response_id | Einfache Formularantwort ID | ja | |||||
| exported | Gibt an, ob die Transaktion exportiert wurde | ja | boolean | ||||
| hide-price | Preis für Lieferant ausblenden. Richtig oder falsch | Nein | Nein | ja | Auftragskopfänderung | ||
| iD | Eindeutige Kennung von Coupa für die Bestellungsänderungsanforderung. Erforderlich für PUT-UPDATE auf bestehende Änderungsanfrage | Ja* | Gültige Bestelländerungsanforderungs-ID | ja | ja | ganze Zahl | |
| begründung | begründung | ja | |||||
| order-header-id | ID des Auftrags, der geändert wird. Erforderlich für NEUE ÄNDERUNGSANFRAGE | Ja* | Gültige Bestellkopf-ID | ja | ja | ganze Zahl | |
| bestellzeilen-Änderungen | Änderungen der Bestellposition | ja | ja | ||||
| zahlungsmethode | payment_method | ja | string(255) | ||||
| zahlungsbedingung | zahlungsbedingungen | ja | ja | Zahlungsbedingung | |||
| p-Card | p-Card | ja | ja | P-Card | |||
| po-number | Bestellnummer | ja | string(20) | ||||
| preis versteckt | Preis für Lieferant ausblenden. Richtig oder falsch | ja | boolean | ||||
| ablehnungsgrund | Ablehnungsgrund | ja | Kommentar | ||||
| anforderer | Anmeldedaten des beantragenden Kontos | ja | Benutzer | ||||
| requisition-header-id | requisition_header_id | ja | ganze Zahl | ||||
| ship-to-Address | Lieferadresse | ja | Adresse | ||||
| ship-to-User | Empfänger | ja | ja | Benutzer | |||
| lieferbedingung | versandbedingungen | ja | ja | Versandbedingung | |||
| source-part-num | source_part_num | ja | ja | string(255) | |||
| status | Bestellstatus | ja | string(255) | ||||
| Lieferant | Lieferant | ja | Lieferant | ||||
| sende-E-Mails | Übertragungs-E-Mail, durch Kommas getrennte Liste | Nein | Nein | beliebig | ja | ja | text |
| getriebemethoden-Override | Außerkraftsetzung der Übertragungsmethode | Nein | Nein | supplier_default, email, do_not_transmit | ja | ja | string(30) |
| updated-at | Automatisch von Coupa erstellt im Format JJJJ-MM-TTTHH:MM:SS+HH:MMZ | ja | datum/Uhrzeit | ||||
| 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 | ganze Zahl | ||||
| manufacturer_name | Name des Herstellers | ja | ja | string(255) | |||
| manufacturer_part_number | Teilenummer des Herstellers | ja | ja | string(255) | |||
| extra_line_attribute | ja | ja | |||||
| service_type | ja | ||||||
| währung | ja | ja | |||||
| meilensteine | ja | ja | |||||
| wiederkehrende-Regeln | Wiederkehrende Regeln | ja | - | ||||
| gesamt | Summe im Dokument zur Bestelländerung | ja | dezimalzahl(32,4) | ||||
| ausstehend-abbrechen | Soll die Bestellung storniert werden? Richtig oder falsch | ja | boolean | ||||
| zeilenzählung | Anzahl der Positionen im Dokument zur Bestelländerung | ja | ganze Zahl | ||||
| lines-pending-add-count | Anzahl der noch zu ergänzenden Positionen im Dokument zur Bestelländerung | ja | ganze Zahl | ||||
| lines-pending-delete-count | Anzahl der noch zu löschenden Positionen im Dokument zur Bestelländerung | ja | ganze Zahl |
Beispielaufrufe
Eine Auftragsänderungsanforderung erstellen
Erstellen Sie eine Bestelländerung mithilfe der API, indem Sie einen authentifizierten API-Aufruf senden: BEITRAG https://{your_instance}.coupahost.com/api/purchase_order_changes
Nutzdaten
Um zu POSTEN, müssen Sie die ID der ursprünglichen Kopfzeile und alle Elemente angeben, die Sie ändern möchten. Verwenden Sie für die Attributänderungen dasselbe Format wie in der ursprünglichen Auftragsbestätigung.
<?xml version="1.0" encoding="UTF-8"?>
<order-header-change>
<order-header-id>1000</order-header-id>
<!-- Requested changes to the PO -->
</order-header-change>201 Erfolgsreaktion
Coupa gibt eine neue <order-header-change> mit einer ID für die Änderung und die vollständige Bestellung zurück, einschließlich aller Änderungen, die Sie in IHRER Post-Nutzlast angegeben haben.
<?xml version="1.0" encoding="UTF-8"?>
<order-header-change>
<id type="integer">501</id>
<created-at type="dateTime">2018-04-06T23:14:50+05:30</created-at>
<updated-at type="dateTime">2018-04-06T23:14:51+05:30</updated-at>
<order-header-id type="integer">123750</order-header-id>
<!-- Original PO with requested changes -->
</order-header-change>Die <status> der Bestellung wird genehmigt, wenn die Änderung keine neuen Genehmigungen erforderte, oder Pending_Approval, wenn die Änderung keine neuen Genehmigungen erfordert.
Aktualisieren einer Bestelländerungsanfrage
Sie können eine Bestelländerung ändern, deren Genehmigung aussteht, indem Sie einen authentifizierten API-Aufruf senden: POSTEN Sie https://{your_instance}.coupahost.com/api/purchase_order_changes/ {id}, wobei {id} das ist. Sie können eine bereits genehmigte Bestelländerung nicht ändern. <id type="integer"> Attribut in der 201-Antwort
Nutzdaten
Das Nutzdatenformat ist im Wesentlichen das gleiche wie das POSTFORMAT, mit der Ausnahme, dass Sie den aktuellen Genehmiger für die Bestelländerung einbeziehen müssen.
<?xml version="1.0" encoding="UTF-8"?>
<order-header-change>
<approver>
Name <login>des Genehmigers</login>
</approver>
<!-- Requested changes to the PO -->
</order-header-change>200 Response
Die Antwort ist die gleiche wie bei einem POST: <order-header-change> mit der ID und der vollständigen Bestellung, einschließlich aller Änderungen, die Sie in Ihrer PUT-Nutzlast angegeben HABEN.
<?xml version="1.0" encoding="UTF-8"?>
<order-header-change>
<id type="integer">501</id>
<created-at type="dateTime">2018-04-06T23:14:50+05:30</created-at>
<updated-at type="dateTime">2018-04-06T23:14:51+05:30</updated-at>
<order-header-id type="integer">123750</order-header-id>
<!-- Original PO with requested changes -->
</order-header-change>400 Fehlerhafte Anfrageantwort
Wenn Sie eine fehlerhafte Anfrage senden, stellt Coupa eine Liste mit Fehlern bereit.
<?xml version="1.0" encoding="UTF-8"?>
<errors>
<error>
<!-- List of errors -->
</error>
</errors>