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.
- 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 |
- 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.