Budget & kostnader – bygg på Flowtly

Använd denna kuraterade snapshot av Flowtlys OpenAPI för att planera integrationer, automatisera flöden och synka data teamen behöver.

Dokumentationsstatus

Senast synkad 2025-12-11 09:43 (app‑version 2.0.0)

Endast ett urval av entiteter är publikt. Kör båda sync‑kommandon när Flowtly släpper nytt.

Budget & kostnader

Styr finansiella planer, allokeringar och transaktioner.

Entitetsöversikt

Budgetar

Exponera Flowtly‑budgetar i finansverktyg så allokeringar, alerts och approvals hålls synkade.

API‑slutpunkter

GET /api/budgets

Lista budgetar

Hämta paginerade budgetar med valfri filtrering på typ eller giltighet.

POST /api/budgets

Skapa budget

Posta en ny budget med dataintervall, gruppering och konfigurationsflaggor.

GET /api/budgets/{id}

Hämta budget via ID

Hämta en specifik budget för att granska allokeringar och metadata.

PATCH /api/budgets/{id}

Uppdatera budget

Patcha budgetdatum, granularitet eller konfigurationsflaggor.

DELETE /api/budgets/{id}

Radera budget

Ta bort en budget som inte längre ska spåras.

GET /api/budget-contractors

List budget-contractors

Retrieve budget-contractor records.

POST /api/budget-contractors

Create budget-contractor

Create a new budget-contractor mapping.

GET /api/budget-contractors/{id}

Get budget-contractor

Fetch a budget-contractor by ID.

DELETE /api/budget-contractors/{id}

Delete budget-contractor

Remove a budget-contractor mapping.

GET /api/budget-employees

List budget-employees

Retrieve employee budget allocations.

POST /api/budget-employees

Create budget-employee

Create a new budget-employee allocation.

GET /api/budget-employees/{id}

Get budget-employee

Fetch a budget-employee allocation.

DELETE /api/budget-employees/{id}

Delete budget-employee

Remove a budget-employee allocation.

GET /api/budget-groups

List budget-groups

Retrieve budget groups.

POST /api/budget-groups

Create budget-group

Create a new budget group.

GET /api/budget-groups/{id}

Get budget-group

Fetch a budget group by ID.

PATCH /api/budget-groups/{id}

Update budget-group

Patch a budget group.

DELETE /api/budget-groups/{id}

Delete budget-group

Remove a budget group.

GET /api/budget-invoices

List budget-invoices

Retrieve budget-linked invoices.

POST /api/budget-invoices

Create budget-invoice

Create a budget invoice mapping.

GET /api/budget-invoices/{id}

Get budget-invoice

Fetch a budget invoice mapping.

DELETE /api/budget-invoices/{id}

Delete budget-invoice

Remove a budget invoice mapping.

GET /api/budget-projects

List budget-projects

Retrieve project allocations under budgets.

POST /api/budget-projects

Create budget-project

Create a budget-project allocation.

GET /api/budget-projects/{id}

Get budget-project

Fetch a budget-project allocation.

DELETE /api/budget-projects/{id}

Delete budget-project

Remove a budget-project allocation.

Användningsfall

Provisionera årliga kostnadsställen från ERP och håll Flowtly uppdaterat med senaste gränser.
Synka kampanjbudgetar så prestandaverktyg kan stoppa spend när Flowtly flaggar överdrag.

Schemafält

Budget-budget.read_budget_employee.read
Fält Typ Beskrivning
id string Unikt budget‑ID.
name string Beskrivande budgetnamn.
type string Budgetens omfattning (global eller per anställd).
granularity string Rapporteringsnivå som månad eller kvartal.
budgetGroup string | null IRI för budgetgruppen denna budget tillhör.
dateFrom string | null Start för budgetens giltighet.
dateTo string | null Slut för budgetens giltighet.
config array Aktiva alternativ, t.ex. spend‑alerts.
budgetEmployees array Medarbetarallokeringar i budgeten.

Exempel

POST /api/budgets

Skapa en global marknadsbudget

Sätter upp en FY25‑marknadsbudget kopplad till en befintlig budgetgrupp med automationsflaggor.

Request‑payload 
{
    "name": "EMEA Marketing FY25",
    "type": "global",
    "granularity": "month",
    "dateFrom": "2024-01-01T00:00:00+00:00",
    "dateTo": "2024-12-31T00:00:00+00:00",
    "budgetGroup": "/api/budget-groups/emarketing",
    "config": [
        "spend_alerts",
        "auto-freeze"
    ]
}
Response‑payload 
{
    "@id": "/api/budgets/bgt_fy25",
    "@type": "Budget",
    "id": "bgt_fy25",
    "name": "EMEA Marketing FY25",
    "type": "global",
    "granularity": "month",
    "dateFrom": "2024-01-01T00:00:00+00:00",
    "dateTo": "2024-12-31T00:00:00+00:00",
    "budgetGroup": "/api/budget-groups/emarketing",
    "config": [
        "spend_alerts",
        "auto-freeze"
    ]
}

Entitetsöversikt

Budgettransaktion

Dela spend‑data i båda riktningar så både inköpssystem och Flowtly ser samma åtaganden.

API‑slutpunkter

GET /api/budget-transactions

Lista budgettransaktioner

Hämta registret över finansiella händelser som påverkar en budget.

POST /api/budget-transactions

Skapa budgettransaktion

Länka en extern transaktion och eventuell anställd till en Flowtly‑budget.

GET /api/budget-transactions/{id}

Hämta budgettransaktion

Inspektera en transaktion kopplad till en budget för att se spend‑påverkan.

PATCH /api/budget-transactions/{id}

Uppdatera budgettransaktion

Justera länkad budget, anställd eller bokat belopp.

DELETE /api/budget-transactions/{id}

Radera budgettransaktion

Ta bort en felaktig budgettransaktionslänk.

GET /api/income-transactions

List income-transactions

Retrieve income transactions.

POST /api/income-transactions

Create income-transaction

Create an income transaction entry.

GET /api/income-transactions/{id}

Get income-transaction

Fetch an income transaction by ID.

PATCH /api/income-transactions/{id}

Update income-transaction

Patch an income transaction entry.

DELETE /api/income-transactions/{id}

Delete income-transaction

Delete an income transaction entry.

GET /api/project-transactions

List project-transactions

Retrieve project transactions.

POST /api/project-transactions

Create project-transaction

Create a project transaction entry.

PATCH /api/project-transactions/{id}

Update project-transaction

Patch a project transaction entry.

DELETE /api/project-transactions/{id}

Delete project-transaction

Delete a project transaction entry.

GET /api/transactions

List transactions

Retrieve generic transactions.

POST /api/transactions

Create transaction

Create a generic transaction.

GET /api/transactions/{id}

Get transaction

Fetch a transaction by ID.

PATCH /api/transactions/{id}

Update transaction

Patch a transaction.

POST /api/transactions/import

Import transactions

Bulk import transactions.

GET /api/transactions/unassigned

List unassigned transactions

Retrieve transactions not yet linked to a budget.

GET /api/transaction-attachments

List transaction-attachments

Retrieve transaction attachments.

POST /api/transaction-attachments

Create transaction-attachment

Create a transaction attachment.

GET /api/transaction-attachments/{id}

Get transaction-attachment

Fetch a transaction attachment by ID.

PATCH /api/transaction-attachments/{id}

Update transaction-attachment

Patch a transaction attachment.

DELETE /api/transaction-attachments/{id}

Delete transaction-attachment

Delete a transaction attachment.

POST /api/transaction-attachments/create

Upload transaction-attachment

Upload a new transaction attachment.

GET /api/transaction-attachments/search

Search transaction-attachments

Search transaction attachments by query.

Användningsfall

Tryck in leverantörsbetalningar från bokföringen så Flowtly speglar verklig spend.
Koppla HR‑ eller leverantörskostnader till budgetar så fort de godkänns i finansstacken.

Schemafält

BudgetTransaction-budget_transaction.read_transaction.read
Fält Typ Beskrivning
budget string IRI som refererar till berörd budget.
transaction object IRI till den ursprungliga ERP‑transaktionen.
employee string | null Anställd kopplad till kostnaden (valfri).
amount integer | null Belopp bokat mot budgeten.

Exempel

POST /api/budget-transactions

Länka en ERP‑transaktion till en budget

Associerar en leverantörsfaktura med FY25‑marknadsbudgeten och loggar ansvarig.

Request‑payload 
{
    "budget": "/api/budgets/bgt_fy25",
    "transaction": "/api/transactions/txn_904",
    "employee": "/api/employees/emp_777",
    "amount": 125000
}
Response‑payload 
{
    "@id": "/api/budget-transactions/btr_11",
    "@type": "BudgetTransaction",
    "id": "btr_11",
    "budget": "/api/budgets/bgt_fy25",
    "transaction": "/api/transactions/txn_904",
    "employee": "/api/employees/emp_777",
    "amount": 125000
}
Whatsapp