Delen via


U hebt een budget nodig (onafhankelijke uitgever)

Met A Budget (YNAB) kunt u een persoonlijke toepassing bouwen om te communiceren met uw eigen budget of een toepassing bouwen die andere YNABer kan autoriseren en gebruiken.

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst Class Regions
Copilot Studio Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Logic-apps Standaard Alle Logic Apps-regio's , met uitzondering van het volgende:
     - Azure Government-regio's
     - Azure China-regio's
     - Us Department of Defense (DoD)
Power Apps Premium Alle Power Apps-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Contactpersoon
Naam Troy Taylor
URL https://www.hitachisolutions.com
E-mailen ttaylor@hitachisolutions.com
Connectormetagegevens
Uitgever Troy Taylor
Webpagina https://www.youneedabudget.com/
Privacybeleid https://www.youneedabudget.com/privacy-policy/
Categorieën Finance

Een verbinding maken

De connector ondersteunt de volgende verificatietypen:

standaard Parameters voor het maken van verbinding. Alle regio's Niet deelbaar

Verstek

Van toepassing: Alle regio's

Parameters voor het maken van verbinding.

Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.

Naam Typologie Description Verplicht
Toegangstoken (in de vorm Bearer AccessToken) beveiligde string Het Toegangstoken (in de vorm Bearer AccessToken) voor deze API Klopt

Beperkingslimieten

Name Aanroepen Verlengingsperiode
API-aanroepen per verbinding 100 60 seconden

Acties

Account maken

Hiermee maakt u een nieuw account.

Account ophalen op id

Hiermee wordt één account geretourneerd.

Accounts ophalen

Retourneert alle accounts.

Betalen per id ophalen

Retourneert één payee.

Betalende locaties ophalen

Retourneert alle payee-locaties.

Betalende locaties per payee ophalen

Retourneert alle payee-locaties voor een opgegeven betabetaler.

Betalers ophalen

Retourneert alle betalers.

Budget ophalen op id

Retourneert één budget met alle gerelateerde entiteiten. Deze resource is in feite een volledige budgetexport.

Budgetinstellingen ophalen op id

Hiermee worden instellingen voor een budget geretourneerd

Budgetmaand ophalen

Retourneert één budgetmaand.

Budgetmaanden ophalen

Retourneert alle budgetmaanden.

Budgetten ophalen

Retourneert een budgetlijst met overzichtsgegevens.

Categorie Maand bijwerken

Werk een categorie voor een specifieke maand bij. Alleen budgeted het bedrag kan worden bijgewerkt.

Categorie ophalen op id

Retourneert één categorie. Bedragen (gebudgetteerd, activiteit, saldo, enzovoort) zijn specifiek voor de huidige budgetmaand (UTC).

Categorieën ophalen

Retourneert alle categorieën gegroepeerd op categoriegroep. Bedragen (gebudgetteerd, activiteit, saldo, enzovoort) zijn specifiek voor de huidige budgetmaand (UTC).

Gebruiker ophalen

Hiermee worden geverifieerde gebruikersgegevens geretourneerd.

Geplande transactie ophalen op id

Retourneert één geplande transactie.

Geplande transacties ophalen

Retourneert alle geplande transacties.

Maandcategorie ophalen op id

Retourneert één categorie voor een specifieke budgetmaand. Bedragen (gebudgetteerd, activiteit, saldo, enzovoort) zijn specifiek voor de huidige budgetmaand (UTC).

Payee-locatie ophalen op id

Retourneert één payee-locatie.

Transactie bijwerken

Hiermee wordt één transactie bijgewerkt.

Transactie maken

Hiermee maakt u één transactie of meerdere transacties. Als u een hoofdtekst met een transaction object opgeeft, wordt één transactie gemaakt en als u een hoofdtekst met een transactions matrix opgeeft, worden er meerdere transacties gemaakt. Geplande transacties kunnen niet worden gemaakt op dit eindpunt.

Transactie ophalen op id

Retourneert één transactie.

Transacties bijwerken

Hiermee worden meerdere transacties bijgewerkt op id of import_id.

Transacties bulksgewijs maken

Hiermee maakt u meerdere transacties. Hoewel dit eindpunt nog steeds wordt ondersteund, wordt het aanbevolen om POST /budgetten/{budget_id}/transacties te gebruiken om meerdere transacties te maken.

Transacties importeren

Hiermee importeert u beschikbare transacties op alle gekoppelde rekeningen voor het opgegeven budget. Met gekoppelde accounts kunnen transacties rechtstreeks vanuit een opgegeven financiële instelling worden geïmporteerd en met dit eindpunt wordt die import gestart. Het verzenden van een aanvraag naar dit eindpunt is het equivalent van het klikken op 'Importeren' voor elk account in de webtoepassing of het tikken op de banner 'Nieuwe transacties' in de mobiele toepassingen. Het antwoord voor dit eindpunt bevat de transactie-id's die zijn geïmporteerd.

Transacties ophalen

Retourneert budgettransacties.

Transacties ophalen per account

Retourneert alle transacties voor een opgegeven account.

Transacties ophalen per categorie

Retourneert alle transacties voor een opgegeven categorie.

Transacties ophalen per payee

Retourneert alle transacties voor een opgegeven payee.

Account maken

Hiermee maakt u een nieuw account.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget ('laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget en 'standaard' op te geven als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget)

Naam
name True string

De naam van het account.

Type2
type True string

Het accounttype

Saldo
balance True integer

Het huidige saldo van de rekening in milliunits-indeling.

Retouren

Accountantwoord
AccountResponse

Account ophalen op id

Hiermee wordt één account geretourneerd.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Account-ID
account_id True uuid

De id van het account.

Retouren

Accountantwoord
AccountResponse

Accounts ophalen

Retourneert alle accounts.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Laatste kennis van server
last_knowledge_of_server integer

De kennis van de server starten. Indien opgegeven, worden alleen entiteiten opgenomen die sindsdien zijn gewijzigd last_knowledge_of_server .

Retouren

Antwoord op accounts
AccountsResponse

Betalen per id ophalen

Retourneert één payee.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Betalen-id
payee_id True string

De id van de betabetaler.

Retouren

Antwoord van payee
PayeeResponse

Betalende locaties ophalen

Retourneert alle payee-locaties.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Retouren

Antwoord op betalende locaties
PayeeLocationsResponse

Betalende locaties per payee ophalen

Retourneert alle payee-locaties voor een opgegeven betabetaler.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Betalen-id
payee_id True string

De id van de betabetaler.

Retouren

Antwoord op betalende locaties
PayeeLocationsResponse

Betalers ophalen

Retourneert alle betalers.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Laatste kennis van server
last_knowledge_of_server integer

De kennis van de server starten. Indien opgegeven, worden alleen entiteiten opgenomen die sindsdien zijn gewijzigd last_knowledge_of_server .

Retouren

Antwoord van payees
PayeesResponse

Budget ophalen op id

Retourneert één budget met alle gerelateerde entiteiten. Deze resource is in feite een volledige budgetexport.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget.

Laatste kennis van server
last_knowledge_of_server integer

De kennis van de server starten. Indien opgegeven, worden alleen entiteiten opgenomen die sindsdien zijn gewijzigd last_knowledge_of_server .

Retouren

Antwoord voor budgetdetails
BudgetDetailResponse

Budgetinstellingen ophalen op id

Hiermee worden instellingen voor een budget geretourneerd

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Retouren

Antwoord voor budgetinstellingen
BudgetSettingsResponse

Budgetmaand ophalen

Retourneert één budgetmaand.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Maand
month True date

De budgetmaand in ISO-indeling (bijvoorbeeld 2016-12-01). ("current" kan ook worden gebruikt om de huidige kalendermaand (UTC) op te geven)

Retouren

Antwoord op maanddetails
MonthDetailResponse

Budgetmaanden ophalen

Retourneert alle budgetmaanden.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Laatste kennis van server
last_knowledge_of_server integer

De kennis van de server starten. Indien opgegeven, worden alleen entiteiten opgenomen die sindsdien zijn gewijzigd last_knowledge_of_server .

Retouren

Antwoord op maandsamenvattingen
MonthSummariesResponse

Budgetten ophalen

Retourneert een budgetlijst met overzichtsgegevens.

Parameters

Name Sleutel Vereist Type Description
Accounts opnemen
include_accounts boolean

Of u de lijst met budgetrekeningen wilt opnemen.

Retouren

Antwoord op budgetoverzicht
BudgetSummaryResponse

Categorie Maand bijwerken

Werk een categorie voor een specifieke maand bij. Alleen budgeted het bedrag kan worden bijgewerkt.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Maand
month True date

De budgetmaand in ISO-indeling (bijvoorbeeld 2016-12-01). ("current" kan ook worden gebruikt om de huidige kalendermaand (UTC) op te geven)

Categorie-ID
category_id True string

De id van de categorie.

Gebudgetteerde
budgeted True integer

Gebudgetteerd bedrag in milliunits-indeling.

Retouren

Antwoord op categorie opslaan
SaveCategoryResponse

Categorie ophalen op id

Retourneert één categorie. Bedragen (gebudgetteerd, activiteit, saldo, enzovoort) zijn specifiek voor de huidige budgetmaand (UTC).

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Categorie-ID
category_id True string

De id van de categorie.

Retouren

Antwoord op categorie
CategoryResponse

Categorieën ophalen

Retourneert alle categorieën gegroepeerd op categoriegroep. Bedragen (gebudgetteerd, activiteit, saldo, enzovoort) zijn specifiek voor de huidige budgetmaand (UTC).

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Laatste kennis van server
last_knowledge_of_server integer

De kennis van de server starten. Indien opgegeven, worden alleen entiteiten opgenomen die sindsdien zijn gewijzigd last_knowledge_of_server .

Retouren

Antwoord op categorieën
CategoriesResponse

Gebruiker ophalen

Hiermee worden geverifieerde gebruikersgegevens geretourneerd.

Retouren

Gebruikersantwoord
UserResponse

Geplande transactie ophalen op id

Retourneert één geplande transactie.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Geplande transactie-id
scheduled_transaction_id True string

De id van de geplande transactie.

Retouren

Reactie op geplande transactie
ScheduledTransactionResponse

Geplande transacties ophalen

Retourneert alle geplande transacties.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Laatste kennis van server
last_knowledge_of_server integer

De kennis van de server starten. Indien opgegeven, worden alleen entiteiten opgenomen die sindsdien zijn gewijzigd last_knowledge_of_server .

Retouren

Reactie op geplande transacties
ScheduledTransactionsResponse

Maandcategorie ophalen op id

Retourneert één categorie voor een specifieke budgetmaand. Bedragen (gebudgetteerd, activiteit, saldo, enzovoort) zijn specifiek voor de huidige budgetmaand (UTC).

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Maand
month True date

De budgetmaand in ISO-indeling (bijvoorbeeld 2016-12-01). ("current" kan ook worden gebruikt om de huidige kalendermaand (UTC) op te geven)

Categorie-ID
category_id True string

De id van de categorie.

Retouren

Antwoord op categorie
CategoryResponse

Payee-locatie ophalen op id

Retourneert één payee-locatie.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Id van payee-locatie
payee_location_id True string

Id van betalende locatie.

Retouren

Antwoord op payee-locatie
PayeeLocationResponse

Transactie bijwerken

Hiermee wordt één transactie bijgewerkt.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Transactie-id
transaction_id True string

De id van de transactie.

Account-ID
account_id True string

De account-id.

Datum
date True date

De transactiedatum in ISO-indeling (bijvoorbeeld 2016-12-01). Toekomstige datums (geplande transacties) zijn niet toegestaan. Gesplitste transactiedatums kunnen niet worden gewijzigd en als er een andere datum wordt opgegeven, wordt deze genegeerd.

Aantal
amount True integer

Het transactiebedrag in milliunits-indeling. Gesplitste transactiebedragen kunnen niet worden gewijzigd en als er een ander bedrag wordt opgegeven, wordt dit genegeerd.

Betalen-id
payee_id uuid

De payee voor de transactie. Als u een overdracht tussen twee accounts wilt maken, gebruikt u de betalingsbetaler die verwijst naar het doelaccount. Accountoverdrachtsbetalers worden opgegeven als transfer_payee_id op de accountresource.

Begunstigde
payee_name string

De naam van de betabetaler. Als er een payee_name waarde wordt opgegeven en payee_id een null-waarde heeft, wordt de payee_name waarde gebruikt om de betaler op te lossen door (1) een overeenkomende regel voor hernoeming van de betabetaler (alleen als import_id deze ook is opgegeven) of (2) een betaler met dezelfde naam of (3) het maken van een nieuwe betaler.

Categorie-ID
category_id uuid

De categorie voor de transactie. Als u een gesplitste transactie wilt configureren, kunt u null opgeven voor category_id en een subtransactions matrix opgeven als onderdeel van het transactieobject. Als een bestaande transactie een splitsing is, kan deze category_id niet worden gewijzigd. Creditcardbetalingscategorieën zijn niet toegestaan en worden genegeerd indien opgegeven.

Notitie
memo string

De memo.

Ontvangen
cleared string

De gewiste status van de transactie.

Goedgekeurd
approved boolean

Of de transactie al dan niet is goedgekeurd. Indien niet opgegeven, wordt transactie standaard niet goedgekeurd.

Vlagkleur
flag_color string

De transactievlag.

Import-id
import_id string

Indien opgegeven, wordt deze import_id aan de nieuwe transactie toegewezen en beschouwd als 'geïmporteerd'. We proberen deze geïmporteerde transactie ook te koppelen aan een bestaande door de gebruiker ingevoerde transactie op hetzelfde account, met hetzelfde bedrag en met een datum +/-10 dagen vanaf de geïmporteerde transactiedatum.

Transacties die worden geïmporteerd via import op basis van bestanden of direct importeren (niet via de API) krijgen een import_id in de indeling YNAB:[milliunit_amount]:[iso_date]:[occurrence]'. Een transactie met een datum van 2015-12-30 in het bedrag van -$ 294,23 USD heeft bijvoorbeeld een import_id van 'YNAB:-294230:2015-12-30:1'. Als een tweede transactie op hetzelfde account werd geïmporteerd en dezelfde datum en hetzelfde bedrag had, zou de import_id 'YNAB:-294230:2015-12-30:2' zijn. Als u een consistente indeling gebruikt, voorkomt u duplicaten via Direct Import en File Based Import.

Als import_id wordt weggelaten of opgegeven als null, wordt de transactie beschouwd als een door de gebruiker ingevoerde transactie. Als zodanig komt het in aanmerking om te worden vergeleken met transacties die later worden geïmporteerd (via DI, FBI of API).

Aantal
amount True integer

De hoeveelheid subtransacties in milliunits-indeling.

Betalen-id
payee_id uuid

De beloning voor de subverzending.

Begunstigde
payee_name string

De naam van de betabetaler. Als er een payee_name waarde wordt opgegeven en payee_id een null-waarde heeft, wordt de payee_name waarde gebruikt om de betaler op te lossen met (1) een overeenkomende regel voor hernoeming van de betabetaler (alleen als import_id ook is opgegeven bij bovenliggende transactie) of (2) een betaler met dezelfde naam of (3) het maken van een nieuwe betaler.

Categorie-ID
category_id uuid

De categorie voor de subtransactie. Creditcardbetalingscategorieën zijn niet toegestaan en worden genegeerd indien opgegeven.

Notitie
memo string

De memo.

Retouren

Reactie op transactie
TransactionResponse

Transactie maken

Hiermee maakt u één transactie of meerdere transacties. Als u een hoofdtekst met een transaction object opgeeft, wordt één transactie gemaakt en als u een hoofdtekst met een transactions matrix opgeeft, worden er meerdere transacties gemaakt. Geplande transacties kunnen niet worden gemaakt op dit eindpunt.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Account-ID
account_id True string

De account-id.

Datum
date True date

De transactiedatum in ISO-indeling (bijvoorbeeld 2016-12-01). Toekomstige datums (geplande transacties) zijn niet toegestaan. Gesplitste transactiedatums kunnen niet worden gewijzigd en als er een andere datum wordt opgegeven, wordt deze genegeerd.

Aantal
amount True integer

Het transactiebedrag in milliunits-indeling. Gesplitste transactiebedragen kunnen niet worden gewijzigd en als er een ander bedrag wordt opgegeven, wordt dit genegeerd.

Betalen-id
payee_id uuid

De payee voor de transactie. Als u een overdracht tussen twee accounts wilt maken, gebruikt u de betalingsbetaler die verwijst naar het doelaccount. Accountoverdrachtsbetalers worden opgegeven als transfer_payee_id op de accountresource.

Begunstigde
payee_name string

De naam van de betabetaler. Als er een payee_name waarde wordt opgegeven en payee_id een null-waarde heeft, wordt de payee_name waarde gebruikt om de betaler op te lossen door (1) een overeenkomende regel voor hernoeming van de betabetaler (alleen als import_id deze ook is opgegeven) of (2) een betaler met dezelfde naam of (3) het maken van een nieuwe betaler.

Categorie-ID
category_id uuid

De categorie voor de transactie. Als u een gesplitste transactie wilt configureren, kunt u null opgeven voor category_id en een subtransactions matrix opgeven als onderdeel van het transactieobject. Als een bestaande transactie een splitsing is, kan deze category_id niet worden gewijzigd. Creditcardbetalingscategorieën zijn niet toegestaan en worden genegeerd indien opgegeven.

Notitie
memo string

De memo.

Ontvangen
cleared string

De gewiste status van de transactie.

Goedgekeurd
approved boolean

Of de transactie al dan niet is goedgekeurd. Indien niet opgegeven, wordt transactie standaard niet goedgekeurd.

Vlagkleur
flag_color string

De transactievlag.

Import-id
import_id string

Indien opgegeven, wordt deze import_id aan de nieuwe transactie toegewezen en beschouwd als 'geïmporteerd'. We proberen deze geïmporteerde transactie ook te koppelen aan een bestaande door de gebruiker ingevoerde transactie op hetzelfde account, met hetzelfde bedrag en met een datum +/-10 dagen vanaf de geïmporteerde transactiedatum.

Transacties die worden geïmporteerd via import op basis van bestanden of direct importeren (niet via de API) krijgen een import_id in de indeling YNAB:[milliunit_amount]:[iso_date]:[occurrence]'. Een transactie met een datum van 2015-12-30 in het bedrag van -$ 294,23 USD heeft bijvoorbeeld een import_id van 'YNAB:-294230:2015-12-30:1'. Als een tweede transactie op hetzelfde account werd geïmporteerd en dezelfde datum en hetzelfde bedrag had, zou de import_id 'YNAB:-294230:2015-12-30:2' zijn. Als u een consistente indeling gebruikt, voorkomt u duplicaten via Direct Import en File Based Import.

Als import_id wordt weggelaten of opgegeven als null, wordt de transactie beschouwd als een door de gebruiker ingevoerde transactie. Als zodanig komt het in aanmerking om te worden vergeleken met transacties die later worden geïmporteerd (via DI, FBI of API).

Aantal
amount True integer

De hoeveelheid subtransacties in milliunits-indeling.

Betalen-id
payee_id uuid

De beloning voor de subverzending.

Begunstigde
payee_name string

De naam van de betabetaler. Als er een payee_name waarde wordt opgegeven en payee_id een null-waarde heeft, wordt de payee_name waarde gebruikt om de betaler op te lossen met (1) een overeenkomende regel voor hernoeming van de betabetaler (alleen als import_id ook is opgegeven bij bovenliggende transactie) of (2) een betaler met dezelfde naam of (3) het maken van een nieuwe betaler.

Categorie-ID
category_id uuid

De categorie voor de subtransactie. Creditcardbetalingscategorieën zijn niet toegestaan en worden genegeerd indien opgegeven.

Notitie
memo string

De memo.

Account-ID
account_id True string

De account-id.

Datum
date True date

De transactiedatum in ISO-indeling (bijvoorbeeld 2016-12-01). Toekomstige datums (geplande transacties) zijn niet toegestaan. Gesplitste transactiedatums kunnen niet worden gewijzigd en als er een andere datum wordt opgegeven, wordt deze genegeerd.

Aantal
amount True integer

Het transactiebedrag in milliunits-indeling. Gesplitste transactiebedragen kunnen niet worden gewijzigd en als er een ander bedrag wordt opgegeven, wordt dit genegeerd.

Betalen-id
payee_id uuid

De payee voor de transactie. Als u een overdracht tussen twee accounts wilt maken, gebruikt u de betalingsbetaler die verwijst naar het doelaccount. Accountoverdrachtsbetalers worden opgegeven als transfer_payee_id op de accountresource.

Begunstigde
payee_name string

De naam van de betabetaler. Als er een payee_name waarde wordt opgegeven en payee_id een null-waarde heeft, wordt de payee_name waarde gebruikt om de betaler op te lossen door (1) een overeenkomende regel voor hernoeming van de betabetaler (alleen als import_id deze ook is opgegeven) of (2) een betaler met dezelfde naam of (3) het maken van een nieuwe betaler.

Categorie-ID
category_id uuid

De categorie voor de transactie. Als u een gesplitste transactie wilt configureren, kunt u null opgeven voor category_id en een subtransactions matrix opgeven als onderdeel van het transactieobject. Als een bestaande transactie een splitsing is, kan deze category_id niet worden gewijzigd. Creditcardbetalingscategorieën zijn niet toegestaan en worden genegeerd indien opgegeven.

Notitie
memo string

De memo.

Ontvangen
cleared string

De gewiste status van de transactie.

Goedgekeurd
approved boolean

Of de transactie al dan niet is goedgekeurd. Indien niet opgegeven, wordt transactie standaard niet goedgekeurd.

Vlagkleur
flag_color string

De transactievlag.

Import-id
import_id string

Indien opgegeven, wordt deze import_id aan de nieuwe transactie toegewezen en beschouwd als 'geïmporteerd'. We proberen deze geïmporteerde transactie ook te koppelen aan een bestaande door de gebruiker ingevoerde transactie op hetzelfde account, met hetzelfde bedrag en met een datum +/-10 dagen vanaf de geïmporteerde transactiedatum.

Transacties die worden geïmporteerd via import op basis van bestanden of direct importeren (niet via de API) krijgen een import_id in de indeling YNAB:[milliunit_amount]:[iso_date]:[occurrence]'. Een transactie met een datum van 2015-12-30 in het bedrag van -$ 294,23 USD heeft bijvoorbeeld een import_id van 'YNAB:-294230:2015-12-30:1'. Als een tweede transactie op hetzelfde account werd geïmporteerd en dezelfde datum en hetzelfde bedrag had, zou de import_id 'YNAB:-294230:2015-12-30:2' zijn. Als u een consistente indeling gebruikt, voorkomt u duplicaten via Direct Import en File Based Import.

Als import_id wordt weggelaten of opgegeven als null, wordt de transactie beschouwd als een door de gebruiker ingevoerde transactie. Als zodanig komt het in aanmerking om te worden vergeleken met transacties die later worden geïmporteerd (via DI, FBI of API).

Aantal
amount True integer

De hoeveelheid subtransacties in milliunits-indeling.

Betalen-id
payee_id uuid

De beloning voor de subverzending.

Begunstigde
payee_name string

De naam van de betabetaler. Als er een payee_name waarde wordt opgegeven en payee_id een null-waarde heeft, wordt de payee_name waarde gebruikt om de betaler op te lossen met (1) een overeenkomende regel voor hernoeming van de betabetaler (alleen als import_id ook is opgegeven bij bovenliggende transactie) of (2) een betaler met dezelfde naam of (3) het maken van een nieuwe betaler.

Categorie-ID
category_id uuid

De categorie voor de subtransactie. Creditcardbetalingscategorieën zijn niet toegestaan en worden genegeerd indien opgegeven.

Notitie
memo string

De memo.

Retouren

Antwoord op transacties opslaan
SaveTransactionsResponse

Transactie ophalen op id

Retourneert één transactie.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Transactie-id
transaction_id True string

De id van de transactie.

Retouren

Reactie op transactie
TransactionResponse

Transacties bijwerken

Hiermee worden meerdere transacties bijgewerkt op id of import_id.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

ID-kaart
id True string

De id.

Account-ID
account_id True string

De account-id.

Datum
date True date

De transactiedatum in ISO-indeling (bijvoorbeeld 2016-12-01). Toekomstige datums (geplande transacties) zijn niet toegestaan. Gesplitste transactiedatums kunnen niet worden gewijzigd en als er een andere datum wordt opgegeven, wordt deze genegeerd.

Aantal
amount True integer

Het transactiebedrag in milliunits-indeling. Gesplitste transactiebedragen kunnen niet worden gewijzigd en als er een ander bedrag wordt opgegeven, wordt dit genegeerd.

Betalen-id
payee_id uuid

De payee voor de transactie. Als u een overdracht tussen twee accounts wilt maken, gebruikt u de betalingsbetaler die verwijst naar het doelaccount. Accountoverdrachtsbetalers worden opgegeven als transfer_payee_id op de accountresource.

Begunstigde
payee_name string

De naam van de betabetaler. Als er een payee_name waarde wordt opgegeven en payee_id een null-waarde heeft, wordt de payee_name waarde gebruikt om de betaler op te lossen door (1) een overeenkomende regel voor hernoeming van de betabetaler (alleen als import_id deze ook is opgegeven) of (2) een betaler met dezelfde naam of (3) het maken van een nieuwe betaler.

Categorie-ID
category_id uuid

De categorie voor de transactie. Als u een gesplitste transactie wilt configureren, kunt u null opgeven voor category_id en een subtransactions matrix opgeven als onderdeel van het transactieobject. Als een bestaande transactie een splitsing is, kan deze category_id niet worden gewijzigd. Creditcardbetalingscategorieën zijn niet toegestaan en worden genegeerd indien opgegeven.

Notitie
memo string

De memo.

Ontvangen
cleared string

De gewiste status van de transactie.

Goedgekeurd
approved boolean

Of de transactie al dan niet is goedgekeurd. Indien niet opgegeven, wordt transactie standaard niet goedgekeurd.

Vlagkleur
flag_color string

De transactievlag.

Import-id
import_id string

Indien opgegeven, wordt deze import_id aan de nieuwe transactie toegewezen en beschouwd als 'geïmporteerd'. We proberen deze geïmporteerde transactie ook te koppelen aan een bestaande door de gebruiker ingevoerde transactie op hetzelfde account, met hetzelfde bedrag en met een datum +/-10 dagen vanaf de geïmporteerde transactiedatum.

Transacties die worden geïmporteerd via import op basis van bestanden of direct importeren (niet via de API) krijgen een import_id in de indeling YNAB:[milliunit_amount]:[iso_date]:[occurrence]'. Een transactie met een datum van 2015-12-30 in het bedrag van -$ 294,23 USD heeft bijvoorbeeld een import_id van 'YNAB:-294230:2015-12-30:1'. Als een tweede transactie op hetzelfde account werd geïmporteerd en dezelfde datum en hetzelfde bedrag had, zou de import_id 'YNAB:-294230:2015-12-30:2' zijn. Als u een consistente indeling gebruikt, voorkomt u duplicaten via Direct Import en File Based Import.

Als import_id wordt weggelaten of opgegeven als null, wordt de transactie beschouwd als een door de gebruiker ingevoerde transactie. Als zodanig komt het in aanmerking om te worden vergeleken met transacties die later worden geïmporteerd (via DI, FBI of API).

Aantal
amount True integer

De hoeveelheid subtransacties in milliunits-indeling.

Betalen-id
payee_id uuid

De beloning voor de subverzending.

Begunstigde
payee_name string

De naam van de betabetaler. Als er een payee_name waarde wordt opgegeven en payee_id een null-waarde heeft, wordt de payee_name waarde gebruikt om de betaler op te lossen met (1) een overeenkomende regel voor hernoeming van de betabetaler (alleen als import_id ook is opgegeven bij bovenliggende transactie) of (2) een betaler met dezelfde naam of (3) het maken van een nieuwe betaler.

Categorie-ID
category_id uuid

De categorie voor de subtransactie. Creditcardbetalingscategorieën zijn niet toegestaan en worden genegeerd indien opgegeven.

Notitie
memo string

De memo.

Retouren

Antwoord op transacties opslaan
SaveTransactionsResponse

Transacties bulksgewijs maken

Hiermee maakt u meerdere transacties. Hoewel dit eindpunt nog steeds wordt ondersteund, wordt het aanbevolen om POST /budgetten/{budget_id}/transacties te gebruiken om meerdere transacties te maken.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Account-ID
account_id True string

De account-id.

Datum
date True date

De transactiedatum in ISO-indeling (bijvoorbeeld 2016-12-01). Toekomstige datums (geplande transacties) zijn niet toegestaan. Gesplitste transactiedatums kunnen niet worden gewijzigd en als er een andere datum wordt opgegeven, wordt deze genegeerd.

Aantal
amount True integer

Het transactiebedrag in milliunits-indeling. Gesplitste transactiebedragen kunnen niet worden gewijzigd en als er een ander bedrag wordt opgegeven, wordt dit genegeerd.

Betalen-id
payee_id uuid

De payee voor de transactie. Als u een overdracht tussen twee accounts wilt maken, gebruikt u de betalingsbetaler die verwijst naar het doelaccount. Accountoverdrachtsbetalers worden opgegeven als transfer_payee_id op de accountresource.

Begunstigde
payee_name string

De naam van de betabetaler. Als er een payee_name waarde wordt opgegeven en payee_id een null-waarde heeft, wordt de payee_name waarde gebruikt om de betaler op te lossen door (1) een overeenkomende regel voor hernoeming van de betabetaler (alleen als import_id deze ook is opgegeven) of (2) een betaler met dezelfde naam of (3) het maken van een nieuwe betaler.

Categorie-ID
category_id uuid

De categorie voor de transactie. Als u een gesplitste transactie wilt configureren, kunt u null opgeven voor category_id en een subtransactions matrix opgeven als onderdeel van het transactieobject. Als een bestaande transactie een splitsing is, kan deze category_id niet worden gewijzigd. Creditcardbetalingscategorieën zijn niet toegestaan en worden genegeerd indien opgegeven.

Notitie
memo string

De memo.

Ontvangen
cleared string

De gewiste status van de transactie.

Goedgekeurd
approved boolean

Of de transactie al dan niet is goedgekeurd. Indien niet opgegeven, wordt transactie standaard niet goedgekeurd.

Vlagkleur
flag_color string

De transactievlag.

Import-id
import_id string

Indien opgegeven, wordt deze import_id aan de nieuwe transactie toegewezen en beschouwd als 'geïmporteerd'. We proberen deze geïmporteerde transactie ook te koppelen aan een bestaande door de gebruiker ingevoerde transactie op hetzelfde account, met hetzelfde bedrag en met een datum +/-10 dagen vanaf de geïmporteerde transactiedatum.

Transacties die worden geïmporteerd via import op basis van bestanden of direct importeren (niet via de API) krijgen een import_id in de indeling YNAB:[milliunit_amount]:[iso_date]:[occurrence]'. Een transactie met een datum van 2015-12-30 in het bedrag van -$ 294,23 USD heeft bijvoorbeeld een import_id van 'YNAB:-294230:2015-12-30:1'. Als een tweede transactie op hetzelfde account werd geïmporteerd en dezelfde datum en hetzelfde bedrag had, zou de import_id 'YNAB:-294230:2015-12-30:2' zijn. Als u een consistente indeling gebruikt, voorkomt u duplicaten via Direct Import en File Based Import.

Als import_id wordt weggelaten of opgegeven als null, wordt de transactie beschouwd als een door de gebruiker ingevoerde transactie. Als zodanig komt het in aanmerking om te worden vergeleken met transacties die later worden geïmporteerd (via DI, FBI of API).

Aantal
amount True integer

De hoeveelheid subtransacties in milliunits-indeling.

Betalen-id
payee_id uuid

De beloning voor de subverzending.

Begunstigde
payee_name string

De naam van de betabetaler. Als er een payee_name waarde wordt opgegeven en payee_id een null-waarde heeft, wordt de payee_name waarde gebruikt om de betaler op te lossen met (1) een overeenkomende regel voor hernoeming van de betabetaler (alleen als import_id ook is opgegeven bij bovenliggende transactie) of (2) een betaler met dezelfde naam of (3) het maken van een nieuwe betaler.

Categorie-ID
category_id uuid

De categorie voor de subtransactie. Creditcardbetalingscategorieën zijn niet toegestaan en worden genegeerd indien opgegeven.

Notitie
memo string

De memo.

Retouren

Bulksgewijs antwoord
BulkResponse

Transacties importeren

Hiermee importeert u beschikbare transacties op alle gekoppelde rekeningen voor het opgegeven budget. Met gekoppelde accounts kunnen transacties rechtstreeks vanuit een opgegeven financiële instelling worden geïmporteerd en met dit eindpunt wordt die import gestart. Het verzenden van een aanvraag naar dit eindpunt is het equivalent van het klikken op 'Importeren' voor elk account in de webtoepassing of het tikken op de banner 'Nieuwe transacties' in de mobiele toepassingen. Het antwoord voor dit eindpunt bevat de transactie-id's die zijn geïmporteerd.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Retouren

Antwoord voor het importeren van transacties
TransactionsImportResponse

Transacties ophalen

Retourneert budgettransacties.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Sinds datum
since_date date

Indien opgegeven, worden alleen transacties op of na deze datum opgenomen. De datum moet iso zijn opgemaakt (bijvoorbeeld 2016-12-30).

Typologie
type string

Indien opgegeven, worden alleen transacties van het opgegeven type opgenomen. 'niet-gecategoriseerd' en 'niet-goedgekeurd' worden momenteel ondersteund.

Laatste kennis van server
last_knowledge_of_server integer

De kennis van de server starten. Indien opgegeven, worden alleen entiteiten opgenomen die sindsdien zijn gewijzigd last_knowledge_of_server .

Retouren

Antwoord op transacties
TransactionsResponse

Transacties ophalen per account

Retourneert alle transacties voor een opgegeven account.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Account-ID
account_id True string

De id van het account.

Sinds datum
since_date date

Indien opgegeven, worden alleen transacties op of na deze datum opgenomen. De datum moet iso zijn opgemaakt (bijvoorbeeld 2016-12-30).

Typologie
type string

Indien opgegeven, worden alleen transacties van het opgegeven type opgenomen. 'niet-gecategoriseerd' en 'niet-goedgekeurd' worden momenteel ondersteund.

Laatste kennis van server
last_knowledge_of_server integer

De kennis van de server starten. Indien opgegeven, worden alleen entiteiten opgenomen die sindsdien zijn gewijzigd last_knowledge_of_server .

Retouren

Antwoord op transacties
TransactionsResponse

Transacties ophalen per categorie

Retourneert alle transacties voor een opgegeven categorie.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Categorie-ID
category_id True string

De id van de categorie.

Sinds datum
since_date date

Indien opgegeven, worden alleen transacties op of na deze datum opgenomen. De datum moet iso zijn opgemaakt (bijvoorbeeld 2016-12-30).

Typologie
type string

Indien opgegeven, worden alleen transacties van het opgegeven type opgenomen. 'niet-gecategoriseerd' en 'niet-goedgekeurd' worden momenteel ondersteund.

Laatste kennis van server
last_knowledge_of_server integer

De kennis van de server starten. Indien opgegeven, worden alleen entiteiten opgenomen die sindsdien zijn gewijzigd last_knowledge_of_server .

Retouren

Antwoord op hybride transacties
HybridTransactionsResponse

Transacties ophalen per payee

Retourneert alle transacties voor een opgegeven payee.

Parameters

Name Sleutel Vereist Type Description
Budget-id
budget_id True string

De id van het budget. 'laatst gebruikt' kan worden gebruikt om het laatst gebruikte budget op te geven en 'standaard' kan worden gebruikt als standaardbudgetselectie is ingeschakeld (zie: https://api.youneedabudget.com/#oauth-default-budget).

Betalen-id
payee_id True string

De id van de betabetaler.

Sinds datum
since_date date

Indien opgegeven, worden alleen transacties op of na deze datum opgenomen. De datum moet iso zijn opgemaakt (bijvoorbeeld 2016-12-30).

Typologie
type string

Indien opgegeven, worden alleen transacties van het opgegeven type opgenomen. 'niet-gecategoriseerd' en 'niet-goedgekeurd' worden momenteel ondersteund.

Laatste kennis van server
last_knowledge_of_server integer

De kennis van de server starten. Indien opgegeven, worden alleen entiteiten opgenomen die sindsdien zijn gewijzigd last_knowledge_of_server .

Retouren

Antwoord op hybride transacties
HybridTransactionsResponse

Definities

UserResponse

Name Pad Type Description
Gegevens
data Data

User

Name Pad Type Description
ID-kaart
id string

De id.

DateFormat

De datumnotatie voor het budget. In sommige gevallen is de indeling niet beschikbaar en wordt deze opgegeven als null.

Name Pad Type Description
Formaat
format string

De indeling.

CurrencyFormat

De valutanotatie voor het budget. In sommige gevallen is de indeling niet beschikbaar en wordt deze opgegeven als null.

Name Pad Type Description
ISO-code
iso_code string

De ISO-code.

Voorbeeldindeling
example_format string

De voorbeeldindeling.

Decimale cijfers
decimal_digits integer

De decimale cijfers.

Decimaalteken
decimal_separator string

Het decimaalteken.

Symbool eerst
symbol_first boolean

Of het symbool het eerst is.

Groepsscheidingsteken
group_separator string

Het groepsscheidingsteken.

Valutasymbool
currency_symbol string

Het valutasymbool.

Symbool weergegeven
display_symbol boolean

Of het symbool wordt weergegeven.

BudgetSummaryResponse

Name Pad Type Description
Gegevens1
data Data1

BudgetSamenvatting

Name Pad Type Description
ID-kaart
id string

De id.

Naam
name string

De naam.

Laatst gewijzigd op
last_modified_on date-time

De laatste keer dat er wijzigingen zijn aangebracht in het budget van een web- of mobiele client.

Eerste maand
first_month date

De vroegste budgetmaand.

Vorige maand
last_month date

De laatste budgetmaand.

Datumnotatie
date_format DateFormat

De datumnotatie voor het budget. In sommige gevallen is de indeling niet beschikbaar en wordt deze opgegeven als null.

Valutanotatie
currency_format CurrencyFormat

De valutanotatie voor het budget. In sommige gevallen is de indeling niet beschikbaar en wordt deze opgegeven als null.

Accounts
accounts array of Account

De budgetaccounts (alleen opgenomen als include_accounts=true opgegeven als queryparameter).

BudgetDetailResponse

Name Pad Type Description
Gegevens2
data Data2

BudgetDetail

Name Pad Type Description
ID-kaart
id string

De id.

Naam
name string

De naam.

Laatst gewijzigd op
last_modified_on date-time

De laatste keer dat er wijzigingen zijn aangebracht in het budget van een web- of mobiele client.

Eerste maand
first_month date

De vroegste budgetmaand.

Vorige maand
last_month date

De laatste budgetmaand.

Datumnotatie
date_format DateFormat

De datumnotatie voor het budget. In sommige gevallen is de indeling niet beschikbaar en wordt deze opgegeven als null.

Valutanotatie
currency_format CurrencyFormat

De valutanotatie voor het budget. In sommige gevallen is de indeling niet beschikbaar en wordt deze opgegeven als null.

Accounts
accounts array of Account

De budgetaccounts (alleen opgenomen als include_accounts=true opgegeven als queryparameter).

Begunstigden
payees array of Payee
Payee-locaties
payee_locations array of PayeeLocation
Categoriegroepen
category_groups array of CategoryGroup
Categorieën
categories array of Category
Maanden
months array of MonthDetail
Transactions
transactions array of TransactionSummary
Subtransacties
subtransactions array of SubTransaction
Geplande transacties
scheduled_transactions array of ScheduledTransactionSummary
Geplande subtransacties
scheduled_subtransactions array of ScheduledSubTransaction

BudgetSettingsResponse

Name Pad Type Description
Gegevens3
data Data3

BudgetSettings

Name Pad Type Description
Datumnotatie
date_format DateFormat

De datumnotatie voor het budget. In sommige gevallen is de indeling niet beschikbaar en wordt deze opgegeven als null.

Valutanotatie
currency_format CurrencyFormat

De valutanotatie voor het budget. In sommige gevallen is de indeling niet beschikbaar en wordt deze opgegeven als null.

AccountsResponse

Name Pad Type Description
Data4
data Data4

AccountResponse

Name Pad Type Description
Gegevens5
data Data5

Account

Name Pad Type Description
ID-kaart
id string

De id.

Naam
name string

De naam.

Typologie
type Type

Het type account. Opmerking: PayPal, merchantAccount, investmentAccount en hypotheektypen zijn afgeschaft en worden in de toekomst verwijderd.

Op budget
on_budget boolean

Of dit account budget heeft of niet

Closed
closed boolean

Of dit account al dan niet is gesloten

Opmerking
note string

De notitie.

Saldo
balance integer

Het huidige saldo van de rekening in milliunits-indeling.

Gewist saldo
cleared_balance integer

Het huidige gewiste saldo van het account in milliunits-indeling.

Onduidelijk saldo
uncleared_balance integer

Het huidige onduidelijke saldo van het account in milliunits-indeling.

Payee-id overdragen
transfer_payee_id string

De id van de betabetaler die moet worden gebruikt bij het overdragen naar dit account.

Direct importeren gekoppeld
direct_import_linked boolean

Of de rekening al dan niet is gekoppeld aan een financiële instelling voor automatische transactieimport.

Fout bij direct importeren
direct_import_in_error boolean

Als een account dat is gekoppeld aan een financiële instelling (direct_import_linked=true) en de gekoppelde verbinding niet in orde is, is dit waar.

Verwijderd
deleted boolean

Of het account al dan niet is verwijderd. Verwijderde accounts worden alleen opgenomen in deltaaanvragen.

CategoriesResponse

Name Pad Type Description
Gegevens6
data Data6

CategoryResponse

Name Pad Type Description
Gegevens7
data Data7

CategoryGroupWithCategories

Name Pad Type Description
ID-kaart
id string

De id.

Naam
name string

De naam.

Verborgen
hidden boolean

Of de categoriegroep al dan niet verborgen is.

Verwijderd
deleted boolean

Of de categoriegroep al dan niet is verwijderd. Verwijderde categoriegroepen worden alleen opgenomen in deltaaanvragen.

Categorieën
categories array of Category

Categoriegroepcategorieën. Bedragen (gebudgetteerd, activiteit, saldo, enzovoort) zijn specifiek voor de huidige budgetmaand (UTC).

CategoryGroup

Name Pad Type Description
ID-kaart
id string

De id.

Naam
name string

De naam.

Verborgen
hidden boolean

Of de categoriegroep al dan niet verborgen is.

Verwijderd
deleted boolean

Of de categoriegroep al dan niet is verwijderd. Verwijderde categoriegroepen worden alleen opgenomen in deltaaanvragen.

Categorie

Name Pad Type Description
ID-kaart
id string

De id.

Categoriegroep-id
category_group_id string

De categoriegroep-id.

Naam
name string

De naam.

Verborgen
hidden boolean

Of de categorie al dan niet verborgen is.

Oorspronkelijke categoriegroep-id
original_category_group_id uuid

Als de categorie is verborgen, is dit de id van de categoriegroep waartoe deze oorspronkelijk behoort voordat deze werd verborgen.

Opmerking
note string

De notitie.

Gebudgetteerde
budgeted integer

Gebudgetteerd bedrag in milliunits-indeling.

Activity
activity integer

Activiteitshoeveelheid in milliunits-indeling.

Saldo
balance integer

Balans in milliunits-indeling.

Doeltype
goal_type GoalType

Het type doel, als de categorie een doel heeft (TB='Target Category Balance', TBD='Target Category Balance by Date', MF='Monthly Funding', NEED='Plan Your Spending')

Maand voor het maken van doelen
goal_creation_month date

De maand is een doel gemaakt.

Doeldoel
goal_target integer

Het doelbedrag in milliunits.

Doelmaand
goal_target_month date

De oorspronkelijke doelmaand voor het doel dat moet worden voltooid. Alleen bepaalde doeltypen geven deze datum op.

Doelpercentage voltooid
goal_percentage_complete integer

Het percentage voltooiing van het doel.

Doelmaanden naar budget
goal_months_to_budget integer

Het aantal maanden, inclusief de huidige maand, links in de huidige doelperiode.

Doel onder Gefinancierd
goal_under_funded integer

Het bedrag van de financiering dat in de huidige maand nog nodig is om op schema te blijven om het doel binnen de huidige doelperiode te voltooien. Dit bedrag komt over het algemeen overeen met het bedrag 'Ondergefinancierd' in de web- en mobiele clients, behalve wanneer u een categorie bekijkt met een bestedingsdoel in een toekomstige maand. De web- en mobiele clients negeren alle financiering van een eerdere doelperiode bij het weergeven van een categorie met een bestedingsdoel in een toekomstige maand.

Algemeen gefinancierd doel
goal_overall_funded integer

Het totale bedrag dat is gefinancierd naar het doel binnen de huidige doelperiode.

Doel algemeen links
goal_overall_left integer

Het bedrag dat nog nodig is om het doel binnen de huidige doelperiode te voltooien.

Verwijderd
deleted boolean

Of de categorie al dan niet is verwijderd. Verwijderde categorieën worden alleen opgenomen in deltaaanvragen.

SaveCategoryResponse

Name Pad Type Description
Gegevens8
data Data8

PayeesResponse

Name Pad Type Description
Data9
data Data9

PayeeResponse

Name Pad Type Description
Data10
data Data10

Begunstigde

Name Pad Type Description
ID-kaart
id string

De id.

Naam
name string

De naam.

Account-id overdragen
transfer_account_id string

Indien een overboekingsbetaler, waarnaar account_id deze betadiging overdraagt.

Verwijderd
deleted boolean

Of de betabetale al dan niet is verwijderd. Verwijderde betadigers worden alleen opgenomen in deltaaanvragen.

PayeeLocationsResponse

Name Pad Type Description
Data11
data Data11

PayeeLocationResponse

Name Pad Type Description
Data12
data Data12

PayeeLocation

Name Pad Type Description
ID-kaart
id string

De id.

Betalen-id
payee_id string

De id van de payee.

Breedtegraad
latitude string

De breedtegraad.

Lengtegraad
longitude string

De lengtegraad.

Verwijderd
deleted boolean

Of de payee-locatie al dan niet is verwijderd. Verwijderde payee-locaties worden alleen opgenomen in deltaaanvragen.

TransactionsResponse

Name Pad Type Description
Data13
data Data13

HybridTransactionsResponse

Name Pad Type Description
Data14
data Data14

SaveTransactionsResponse

Name Pad Type Description
Data15
data Data15

TransactionResponse

Name Pad Type Description
Data16
data Data16

TransactionSummary

Name Pad Type Description
ID-kaart
id string

De id.

Datum
date date

De transactiedatum in ISO-indeling (bijvoorbeeld 2016-12-01).

Aantal
amount integer

Het transactiebedrag in milliunits-indeling.

Notitie
memo string

De memo.

Ontvangen
cleared Cleared

De gewiste status van de transactie.

Goedgekeurd
approved boolean

Of de transactie al dan niet is goedgekeurd.

Vlagkleur
flag_color FlagColor

De transactievlag.

Account-ID
account_id string

De account-id.

Betalen-id
payee_id string

De id van de payee.

Categorie-ID
category_id string

De categorie-id.

Account-id overdragen
transfer_account_id uuid

Als een overdrachtstransactie, het account waarnaar deze overdraagt.

Transactie-id overdragen
transfer_transaction_id string

Als een overdrachtstransactie, de id van de transactie aan de andere kant van de overdracht.

Overeenkomende transactie-id
matched_transaction_id string

Als de transactie overeenkomt, wordt de id van de overeenkomende transactie.

Import-id
import_id string

Als de transactie is geïmporteerd, is dit veld een unieke import-id (per account). Als deze transactie is geïmporteerd via import op basis van bestanden of direct importeren en niet via de API, heeft de import_id de volgende indeling: 'YNAB:[milliunit_amount]:[iso_date]:[exemplaar]'. Een transactie met een datum van 2015-12-30 in het bedrag van -$ 294,23 USD heeft bijvoorbeeld een import_id van 'YNAB:-294230:2015-12-30:1'. Als een tweede transactie op hetzelfde account werd geïmporteerd en dezelfde datum en hetzelfde bedrag had, zou de import_id 'YNAB:-294230:2015-12-30:2' zijn.

Verwijderd
deleted boolean

Of de transactie al dan niet is verwijderd. Verwijderde transacties worden alleen opgenomen in deltaaanvragen.

TransactionDetail

Name Pad Type Description
ID-kaart
id string

De id.

Datum
date date

De transactiedatum in ISO-indeling (bijvoorbeeld 2016-12-01).

Aantal
amount integer

Het transactiebedrag in milliunits-indeling.

Notitie
memo string

De memo.

Ontvangen
cleared Cleared

De gewiste status van de transactie.

Goedgekeurd
approved boolean

Of de transactie al dan niet is goedgekeurd.

Vlagkleur
flag_color FlagColor

De transactievlag.

Account-ID
account_id string

De account-id.

Betalen-id
payee_id string

De id van de payee.

Categorie-ID
category_id string

De categorie-id.

Account-id overdragen
transfer_account_id uuid

Als een overdrachtstransactie, het account waarnaar deze overdraagt.

Transactie-id overdragen
transfer_transaction_id string

Als een overdrachtstransactie, de id van de transactie aan de andere kant van de overdracht.

Overeenkomende transactie-id
matched_transaction_id string

Als de transactie overeenkomt, wordt de id van de overeenkomende transactie.

Import-id
import_id string

Als de transactie is geïmporteerd, is dit veld een unieke import-id (per account). Als deze transactie is geïmporteerd via import op basis van bestanden of direct importeren en niet via de API, heeft de import_id de volgende indeling: 'YNAB:[milliunit_amount]:[iso_date]:[exemplaar]'. Een transactie met een datum van 2015-12-30 in het bedrag van -$ 294,23 USD heeft bijvoorbeeld een import_id van 'YNAB:-294230:2015-12-30:1'. Als een tweede transactie op hetzelfde account werd geïmporteerd en dezelfde datum en hetzelfde bedrag had, zou de import_id 'YNAB:-294230:2015-12-30:2' zijn.

Verwijderd
deleted boolean

Of de transactie al dan niet is verwijderd. Verwijderde transacties worden alleen opgenomen in deltaaanvragen.

Accountnaam
account_name string

De accountnaam.

Begunstigde
payee_name string

De naam van de betabetaler.

Categorie
category_name string

De categorienaam.

Subtransacties
subtransactions array of SubTransaction

Als een gesplitste transactie, worden de subtransacties doorgevoerd.

HybridTransaction

Name Pad Type Description
ID-kaart
id string

De id.

Datum
date date

De transactiedatum in ISO-indeling (bijvoorbeeld 2016-12-01).

Aantal
amount integer

Het transactiebedrag in milliunits-indeling.

Notitie
memo string

De memo.

Ontvangen
cleared Cleared

De gewiste status van de transactie.

Goedgekeurd
approved boolean

Of de transactie al dan niet is goedgekeurd.

Vlagkleur
flag_color FlagColor

De transactievlag.

Account-ID
account_id string

De account-id.

Betalen-id
payee_id string

De id van de payee.

Categorie-ID
category_id string

De categorie-id.

Account-id overdragen
transfer_account_id uuid

Als een overdrachtstransactie, het account waarnaar deze overdraagt.

Transactie-id overdragen
transfer_transaction_id string

Als een overdrachtstransactie, de id van de transactie aan de andere kant van de overdracht.

Overeenkomende transactie-id
matched_transaction_id string

Als de transactie overeenkomt, wordt de id van de overeenkomende transactie.

Import-id
import_id string

Als de transactie is geïmporteerd, is dit veld een unieke import-id (per account). Als deze transactie is geïmporteerd via import op basis van bestanden of direct importeren en niet via de API, heeft de import_id de volgende indeling: 'YNAB:[milliunit_amount]:[iso_date]:[exemplaar]'. Een transactie met een datum van 2015-12-30 in het bedrag van -$ 294,23 USD heeft bijvoorbeeld een import_id van 'YNAB:-294230:2015-12-30:1'. Als een tweede transactie op hetzelfde account werd geïmporteerd en dezelfde datum en hetzelfde bedrag had, zou de import_id 'YNAB:-294230:2015-12-30:2' zijn.

Verwijderd
deleted boolean

Of de transactie al dan niet is verwijderd. Verwijderde transacties worden alleen opgenomen in deltaaanvragen.

Type3
type Type3

Of de hybride transactie een reguliere transactie of een subtransactie vertegenwoordigt

Bovenliggende transactie-id
parent_transaction_id string

Voor subtransactiestypen is dit de id van de bovenliggende transactie. Voor transactietypen is deze id altijd null.

Accountnaam
account_name string

De accountnaam.

Begunstigde
payee_name string

De naam van de betabetaler.

Categorie
category_name string

De categorienaam.

TransactionsImportResponse

Name Pad Type Description
Data17
data Data17

BulkResponse

Name Pad Type Description
Data18
data Data18

SubTransaction

Name Pad Type Description
ID-kaart
id string

De id.

Transactie-id
transaction_id string

De transactie.

Aantal
amount integer

De hoeveelheid subtransacties in milliunits-indeling.

Notitie
memo string

De memo.

Betalen-id
payee_id string

De id van de payee.

Begunstigde
payee_name string

De naam van de betabetaler.

Categorie-ID
category_id string

De categorie-id.

Categorie
category_name string

De categorienaam.

Account-id overdragen
transfer_account_id uuid

Als een overdracht, de account_id waarnaar de subverzending wordt overgedragen.

Transactie-id overdragen
transfer_transaction_id string

Als een overdracht, de id van de transactie aan de andere kant van de overdracht.

Verwijderd
deleted boolean

Of de subtransactie al dan niet is verwijderd. Verwijderde subtransacties worden alleen opgenomen in deltaaanvragen.

ScheduledTransactionsResponse

Name Pad Type Description
Data19
data Data19

ScheduledTransactionResponse

Name Pad Type Description
Data20
data Data20

ScheduledTransactionSummary

Name Pad Type Description
ID-kaart
id string

De id.

Eerste datum
date_first date

De eerste datum waarvoor de geplande transactie is gepland.

Volgende datum
date_next date

De volgende datum waarvoor de geplande transactie is gepland.

Frequentie
frequency Frequency

De frequentie.

Aantal
amount integer

Het geplande transactiebedrag in milliunits-indeling.

Notitie
memo string

De memo.

FlagColor1
flag_color FlagColor1

De geplande transactievlag.

Account-ID
account_id string

De account-id.

Betalen-id
payee_id string

De id van de payee.

Categorie-ID
category_id string

De categorie-id.

Account-id overdragen
transfer_account_id uuid

Als een overdracht, de account_id waarnaar de geplande transactie wordt overgedragen.

Verwijderd
deleted boolean

Of de geplande transactie al dan niet is verwijderd. Verwijderde geplande transacties worden alleen opgenomen in deltaaanvragen.

ScheduledTransactionDetail

Name Pad Type Description
ID-kaart
id string

De id.

Eerste datum
date_first date

De eerste datum waarvoor de geplande transactie is gepland.

Volgende datum
date_next date

De volgende datum waarvoor de geplande transactie is gepland.

Frequentie
frequency Frequency

De frequentie.

Aantal
amount integer

Het geplande transactiebedrag in milliunits-indeling.

Notitie
memo string

De memo.

FlagColor1
flag_color FlagColor1

De geplande transactievlag.

Account-ID
account_id string

De account-id.

Betalen-id
payee_id string

De id van de payee.

Categorie-ID
category_id string

De categorie-id.

Account-id overdragen
transfer_account_id uuid

Als een overdracht, de account_id waarnaar de geplande transactie wordt overgedragen.

Verwijderd
deleted boolean

Of de geplande transactie al dan niet is verwijderd. Verwijderde geplande transacties worden alleen opgenomen in deltaaanvragen.

Accountnaam
account_name string

De accountnaam.

Begunstigde
payee_name string

De naam van de betabetaler.

Categorie
category_name string

De categorienaam.

subtransacties
subtransactions array of ScheduledSubTransaction

Als een gesplitste geplande transactie, worden de subtransacties doorgevoerd.

ScheduledSubTransaction

Name Pad Type Description
ID-kaart
id string

De id.

Geplande transactie-id
scheduled_transaction_id string

De geplande transactie-id.

Aantal
amount integer

De geplande hoeveelheid subtransacties in milliunits-indeling.

Notitie
memo string

De memo.

Betalen-id
payee_id string

De id van de payee.

Categorie-ID
category_id string

De categorie-id.

Account-id overdragen
transfer_account_id uuid

Als een overdracht, de account_id waarnaar de geplande subtransactie wordt overgedragen.

Verwijderd
deleted boolean

Of de geplande subverzending al dan niet is verwijderd. Verwijderde geplande subtransacties worden alleen opgenomen in deltaaanvragen.

MonthSummariesResponse

Name Pad Type Description
Data21
data Data21

MonthDetailResponse

Name Pad Type Description
Data22
data Data22

MonthSummary

Name Pad Type Description
Maand
month date

De maand.

Opmerking
note string

De notitie.

Inkomsten
income integer

Het totale aantal transacties dat is gecategoriseerd in 'Inflow: Gereed om toe te wijzen' in de maand.

Gebudgetteerde
budgeted integer

Het totale bedrag dat in de maand is gebudgetteerd.

Activity
activity integer

Het totale aantal transacties in de maand, met uitzondering van de transacties die zijn gecategoriseerd in 'Inflow: Gereed om toe te wijzen'.

Gebudgetteerd
to_be_budgeted integer

Het beschikbare bedrag voor 'Gereed om toe te wijzen'.

Leeftijd van geld
age_of_money integer

De leeftijd van geld vanaf de maand.

Verwijderd
deleted boolean

Of de maand al dan niet is verwijderd. Verwijderde maanden worden alleen opgenomen in deltaaanvragen.

MonthDetail

Name Pad Type Description
Maand
month date

De maand.

Opmerking
note string

De notitie.

Inkomsten
income integer

Het totale aantal transacties dat is gecategoriseerd in 'Inflow: Gereed om toe te wijzen' in de maand.

Gebudgetteerde
budgeted integer

Het totale bedrag dat in de maand is gebudgetteerd.

Activity
activity integer

Het totale aantal transacties in de maand, met uitzondering van de transacties die zijn gecategoriseerd in 'Inflow: Gereed om toe te wijzen'.

Gebudgetteerd
to_be_budgeted integer

Het beschikbare bedrag voor 'Gereed om toe te wijzen'.

Leeftijd van geld
age_of_money integer

De leeftijd van geld vanaf de maand.

Verwijderd
deleted boolean

Of de maand al dan niet is verwijderd. Verwijderde maanden worden alleen opgenomen in deltaaanvragen.

Categorieën
categories array of Category

De categorieën budgetmaanden. Bedragen (gebudgetteerd, activiteit, saldo, enzovoort) zijn specifiek voor de parameter {month} die is opgegeven.

Bulk

Name Pad Type Description
Transactie-id's
transaction_ids array of string

De lijst met transactie-id's die zijn gemaakt.

Dubbele import-id's
duplicate_import_ids array of string

Als er geen transacties zijn gemaakt omdat ze al een import_id overeenkomende transactie op hetzelfde account hadden, worden de opgegeven import_id(s) opgenomen in deze lijst.

Ontvangen

De gewiste status van de transactie.

De gewiste status van de transactie.

Ontvangen
string

Gegevens

Name Pad Type Description
User
user User

Gegevens1

Name Pad Type Description
Budgetten
budgets array of BudgetSummary
Budgetoverzicht
default_budget BudgetSummary

Gegevens2

Name Pad Type Description
Budgetdetails
budget BudgetDetail
Kennis van server
server_knowledge integer

De kennis van de server.

Gegevens3

Name Pad Type Description
Budgetinstellingen
settings BudgetSettings

Data4

Name Pad Type Description
Accounts
accounts array of Account
Kennis van server
server_knowledge integer

De kennis van de server.

Gegevens5

Name Pad Type Description
Account
account Account

Gegevens6

Name Pad Type Description
Categoriegroepen
category_groups array of CategoryGroupWithCategories

De categoriegroepen.

Kennis van server
server_knowledge integer

De kennis van de server.

Gegevens7

Name Pad Type Description
Categorie
category Category

Gegevens8

Name Pad Type Description
Categorie
category Category
Kennis van server
server_knowledge integer

De kennis van de server.

Data9

Name Pad Type Description
Begunstigden
payees array of Payee

De betalers.

Kennis van server
server_knowledge integer

De kennis van de server.

Data10

Name Pad Type Description
Begunstigde
payee Payee

Data11

Name Pad Type Description
Payee-locaties
payee_locations array of PayeeLocation

De betalende locaties.

Data12

Name Pad Type Description
Payee-locatie
payee_location PayeeLocation

Data13

Name Pad Type Description
Transactions
transactions array of TransactionDetail

De transacties.

Kennis van server
server_knowledge integer

De kennis van de server.

Data14

Name Pad Type Description
Transactions
transactions array of HybridTransaction

De transacties.

Data15

Name Pad Type Description
Transactie-id's
transaction_ids array of string

De transactie-id's die zijn opgeslagen.

Transactiedetails
transaction TransactionDetail
transacties
transactions array of TransactionDetail

Als er meerdere transacties zijn opgegeven, worden de transacties opgeslagen.

Dubbele import-id's
duplicate_import_ids array of string

Als er meerdere transacties zijn opgegeven, wordt er een lijst met import_ids gemaakt die niet zijn gemaakt vanwege een bestaande import_id gevonden op hetzelfde account.

Kennis van server
server_knowledge integer

De kennis van de server.

Data16

Name Pad Type Description
Transactiedetails
transaction TransactionDetail

Data17

Name Pad Type Description
Transactie-id's
transaction_ids array of string

De lijst met transactie-id's die zijn geïmporteerd.

Data18

Name Pad Type Description
Bulk
bulk Bulk

Data19

Name Pad Type Description
scheduled_transactions
scheduled_transactions array of ScheduledTransactionDetail
Kennis van server
server_knowledge integer

De kennis van de server.

Data20

Name Pad Type Description
Details van geplande transactie
scheduled_transaction ScheduledTransactionDetail

Data21

Name Pad Type Description
Maanden
months array of MonthSummary
Kennis van server
server_knowledge integer

De kennis van de server.

Data22

Name Pad Type Description
Maanddetails
month MonthDetail

FlagColor

De transactievlag.

De transactievlag.

Vlagkleur
string

FlagColor1

De geplande transactievlag.

De geplande transactievlag.

FlagColor1
string

Frequentie

De frequentie.

De frequentie.

Frequentie
string

GoalType

Het type doel, als de categorie een doel heeft (TB='Target Category Balance', TBD='Target Category Balance by Date', MF='Monthly Funding', NEED='Plan Your Spending')

Het type doel, als de categorie een doel heeft (TB='Target Category Balance', TBD='Target Category Balance by Date', MF='Monthly Funding', NEED='Plan Your Spending')

Doeltype
string

Typologie

Het type account. Opmerking: PayPal, merchantAccount, investmentAccount en hypotheektypen zijn afgeschaft en worden in de toekomst verwijderd.

Het type account. Opmerking: PayPal, merchantAccount, investmentAccount en hypotheektypen zijn afgeschaft en worden in de toekomst verwijderd.

Typologie
string

Type3

Of de hybride transactie een reguliere transactie of een subtransactie vertegenwoordigt

Of de hybride transactie een reguliere transactie of een subtransactie vertegenwoordigt

Type3
string