Budgetpositionen-API (/budget lines)
Verwenden Sie die Budgetlinien-API, um Budgetlinien zu erstellen und zu aktualisieren, die Sie mit Ihren Konten verknüpft haben.
Verwenden Sie die Budgetlinien-API, um Budgetlinien zu erstellen und zu aktualisieren, die Sie mit Ihren Konten verknüpft haben.
Die URL für den Zugriff auf Budgetzeilen lautet: https://<instance>/api/budget lines
Weitere Informationen finden Sie unter Integrations-Best Practices.
Hinweis
- Wenn diese API mit einem statischen Kontenplan-basierten Budgetzeitraum eingereicht wird, müssen alle enthaltenen Segmentwerte aus einem bestehenden Konto stammen.
- Wenn Sie diese API mit einem dynamischen Kontenplan einreichen, müssen alle enthaltenen Segmentwerte mit vorhandenen Kontensegmenten oder Nachschlagewerten übereinstimmen. Diese API erstellt das Konto nicht direkt.
Aktionen
Mit der Budgetpositionen-API können Sie:
| Verb | Pfad | Aktion | Beschreibung |
|---|---|---|---|
| PUT | /api/budget_lines/:id/adjust |
anpassen | Anpassung von Budgetpositionen für Budgetpositionen erstellen |
| BEITRAG | /api/budget_lines |
erstellen | Budgetposition erstellen |
| ABFRAGEN | /api/budget_lines |
index | Budgetzeilen abfragen |
| ABFRAGEN | /api/budget_lines/:id |
anzeigen | Budgetposition anzeigen |
| PUT | /api/budget_lines/:id |
aktualisieren | Budgetposition aktualisieren |
Elemente
Die folgenden Elemente sind für die Budgetlinien-API verfügbar:
| Element | Beschreibung | Pflichtfeld? | Eindeutig? | Zulässiger Wert | Api_In Field? | Api_Out-Feld? | Datentyp |
|---|---|---|---|---|---|---|---|
| betrag | betrag | ja | dezimalzahl | ||||
| 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 | ||||
| währung | Währung der Transaktion | ja | ja | Währung | |||
| beschreibung | beschreibung | ja | ja | zeichenfolge | |||
| error-on-overrun | Übermittlung von Anforderungen verhindern, die das Budget überschreiten würden | ja | ja | boolean | |||
| iD | Eindeutige Coupa-ID | ja | ganze Zahl | ||||
| anmerkungen | anmerkungen | ja | ja | text | |||
| überlaufberechnung | overrun_Calculation | ja | ja | ganze Zahl | |||
| verantwortlicher | budgetverantwortlicher | ja | ja | Benutzer | |||
| owner-is-approver | Besitzer ist Genehmiger? | ja | ja | ganze Zahl | |||
| pending_requisitions_amount | Menge, die durch ausstehende Anforderungen verbraucht wird | ja | dezimalzahl | ||||
| zeitraum | Dies ist der Spitzname für die Budgetposition. Benutzer können dieses Feld über die Benutzeroberfläche anzeigen und danach suchen. | ja | ja | ja | Zeitraum | ||
| verbleiben | verbleiben | ja | dezimalzahl | ||||
| verbleibendes Budget | Verbleibendes Budget | ja | dezimalzahl | ||||
| segment-1 | Geben Sie optional jedes Segment einzeln an. Dies ist erforderlich, wenn eines der Segmente das Bindestrich- "-" -Zeichen enthält, wodurch verhindert wird, dass der Budgetierungssegmentcode automatisch geteilt wird | ja | ja | zeichenfolge | |||
| segment-10 | Geben Sie optional jedes Segment einzeln an. Dies ist erforderlich, wenn eines der Segmente das Bindestrich- "-" -Zeichen enthält, wodurch verhindert wird, dass der Budgetierungssegmentcode automatisch geteilt wird | ja | ja | zeichenfolge | |||
| segment-11 | Geben Sie optional jedes Segment einzeln an. Dies ist erforderlich, wenn eines der Segmente das Bindestrich- "-" -Zeichen enthält, wodurch verhindert wird, dass der Budgetierungssegmentcode automatisch geteilt wird | ja | ja | zeichenfolge | |||
| segment-12 | Geben Sie optional jedes Segment einzeln an. Dies ist erforderlich, wenn eines der Segmente das Bindestrich- "-" -Zeichen enthält, wodurch verhindert wird, dass der Budgetierungssegmentcode automatisch geteilt wird | ja | ja | zeichenfolge | |||
| segment-13 | Geben Sie optional jedes Segment einzeln an. Dies ist erforderlich, wenn eines der Segmente das Bindestrich- "-" -Zeichen enthält, wodurch verhindert wird, dass der Budgetierungssegmentcode automatisch geteilt wird | ja | ja | zeichenfolge | |||
| segment-14 | Geben Sie optional jedes Segment einzeln an. Dies ist erforderlich, wenn eines der Segmente das Bindestrich- "-" -Zeichen enthält, wodurch verhindert wird, dass der Budgetierungssegmentcode automatisch geteilt wird | ja | ja | zeichenfolge | |||
| segment-15 | Geben Sie optional jedes Segment einzeln an. Dies ist erforderlich, wenn eines der Segmente das Bindestrich- "-" -Zeichen enthält, wodurch verhindert wird, dass der Budgetierungssegmentcode automatisch geteilt wird | ja | ja | zeichenfolge | |||
| segment-16 | Geben Sie optional jedes Segment einzeln an. Dies ist erforderlich, wenn eines der Segmente das Bindestrich- "-" -Zeichen enthält, wodurch verhindert wird, dass der Budgetierungssegmentcode automatisch geteilt wird | ja | ja | zeichenfolge | |||
| segment-17 | Geben Sie optional jedes Segment einzeln an. Dies ist erforderlich, wenn eines der Segmente das Bindestrich- "-" -Zeichen enthält, wodurch verhindert wird, dass der Budgetierungssegmentcode automatisch geteilt wird | ja | ja | zeichenfolge | |||
| segment-18 | Geben Sie optional jedes Segment einzeln an. Dies ist erforderlich, wenn eines der Segmente das Bindestrich- "-" -Zeichen enthält, wodurch verhindert wird, dass der Budgetierungssegmentcode automatisch geteilt wird | ja | ja | zeichenfolge | |||
| segment-19 | Geben Sie optional jedes Segment einzeln an. Dies ist erforderlich, wenn eines der Segmente das Bindestrich- "-" -Zeichen enthält, wodurch verhindert wird, dass der Budgetierungssegmentcode automatisch geteilt wird | ja | ja | zeichenfolge | |||
| segment-2 | Geben Sie optional jedes Segment einzeln an. Dies ist erforderlich, wenn eines der Segmente das Bindestrich- "-" -Zeichen enthält, wodurch verhindert wird, dass der Budgetierungssegmentcode automatisch geteilt wird | ja | ja | zeichenfolge | |||
| segment-20 | Geben Sie optional jedes Segment einzeln an. Dies ist erforderlich, wenn eines der Segmente das Bindestrich- "-" -Zeichen enthält, wodurch verhindert wird, dass der Budgetierungssegmentcode automatisch geteilt wird | ja | ja | zeichenfolge | |||
| segment-3 | Geben Sie optional jedes Segment einzeln an. Dies ist erforderlich, wenn eines der Segmente das Bindestrich- "-" -Zeichen enthält, wodurch verhindert wird, dass der Budgetierungssegmentcode automatisch geteilt wird | ja | ja | zeichenfolge | |||
| segment-4 | Geben Sie optional jedes Segment einzeln an. Dies ist erforderlich, wenn eines der Segmente das Bindestrich- "-" -Zeichen enthält, wodurch verhindert wird, dass der Budgetierungssegmentcode automatisch geteilt wird | ja | ja | zeichenfolge | |||
| segment-5 | Geben Sie optional jedes Segment einzeln an. Dies ist erforderlich, wenn eines der Segmente das Bindestrich- "-" -Zeichen enthält, wodurch verhindert wird, dass der Budgetierungssegmentcode automatisch geteilt wird | ja | ja | zeichenfolge | |||
| segment-6 | Geben Sie optional jedes Segment einzeln an. Dies ist erforderlich, wenn eines der Segmente das Bindestrich- "-" -Zeichen enthält, wodurch verhindert wird, dass der Budgetierungssegmentcode automatisch geteilt wird | ja | ja | zeichenfolge | |||
| segment-7 | Geben Sie optional jedes Segment einzeln an. Dies ist erforderlich, wenn eines der Segmente das Bindestrich- "-" -Zeichen enthält, wodurch verhindert wird, dass der Budgetierungssegmentcode automatisch geteilt wird | ja | ja | zeichenfolge | |||
| segment-8 | Geben Sie optional jedes Segment einzeln an. Dies ist erforderlich, wenn eines der Segmente das Bindestrich- "-" -Zeichen enthält, wodurch verhindert wird, dass der Budgetierungssegmentcode automatisch geteilt wird | ja | ja | zeichenfolge | |||
| segment-9 | Geben Sie optional jedes Segment einzeln an. Dies ist erforderlich, wenn eines der Segmente das Bindestrich- "-" -Zeichen enthält, wodurch verhindert wird, dass der Budgetierungssegmentcode automatisch geteilt wird | ja | ja | zeichenfolge | |||
| set-amount-from-xml | set_amount_from_xml | ja | |||||
| updated-at | Automatisch von Coupa erstellt im Format JJJJ-MM-TTTHH:MM:SS+HH:MMZ | ja | datum/Uhrzeit | ||||
| aktualisiert von | Benutzer der Aktualisierung | ja | Benutzer |
Hinweis
- Begrenzen Sie bei großen Datensätzen und Leistungsoptimierungen Ihr Ergebnis immer mit einigen GET-Kriterien.
- Sie können POST verwenden, um neue Budgetzeilen für vorhandene Budgetperioden und vorhandene Kontosegmente (d. h. Segment-1, Segment-2 usw.) zu erstellen. Dies bedeutet, dass Sie mit der API keine neuen Budgetperioden erstellen können.
- Sobald die Budgetzeile erstellt und einem Kontotyp (d. h. einem Kontenplan) und einem bestimmten Konto zugeordnet ist, können Sie diese Informationen nicht mehr ändern.