add_goal_contribution
ChatGPTRecord money set aside for a goal tracked by contributions (negative to withdraw). It neither moves money between accounts nor counts as an expense.
adjust_tax_line
ChatGPTCorrect how one note (sourceKind invoice) or receipt (sourceKind receipt) counts as revenue: include or exclude it, its market (domestic or export), activity, amount in BRL or month. With clearId the correction is removed.
anticipate_installments
ChatGPTRecord that future installments of a card purchase were paid off early at the amount the bank quoted. The payoff becomes one charge on the target bill and the selected installments leave their bills; paying the target bill is a separate pay_card_bill.
confirm_invoice_issuance
ChatGPTLegally issue the reviewed draft. Call only after the person explicitly approves the exact draft and environment. Supply its id and version. Replayed or changed drafts are refused.
confirm_tax_assessment
ChatGPTConfirm the DAS of a month. Without amount it takes the estimate, plus late charges when overdue. It creates a pending expense on accountId (or the profile's payment account) due on dueDate, updates that expense on a revision, adds a supplementary expense when the first one was already paid, or links transactionId, an expense already recorded as the payment. Pass baseRevision from get_tax_period to avoid overwriting a newer revision.
confirm_transaction
ChatGPTMark a pending expense paid, expected income received, or a pending card charge confirmed. For a recurring occurrence it confirms only that occurrence.
create_category
ChatGPTCreate a category or, with parentId, a subcategory (one level). Check list_categories first to avoid duplicates.
create_goal
ChatGPTCreate a savings goal. progressMethod contributions tracks amounts recorded with add_goal_contribution; account_balance tracks the balance of accountId, which is then required.
create_invoice
ChatGPTRecord an invoice the business issued without its XML file. Prefer import_invoices when the person has the file. The customer is a saved customer (customerId from list_issuing_customers) or just a name; never ask for a customer's CPF, CNPJ or other identifier here.
create_invoice_upload
ChatGPTCreate a single-use link, valid for 15 minutes, to upload NF-e or NFS-e XML files from the person's computer for one persona: POST them as multipart form fields named files (curl -F 'files=@path' once per file, up to 200 files and 24 MB). The upload is kept for 24 hours; pass the returned uploadId to preview_invoice_import and import_invoices instead of the files.
create_monitor
ChatGPTHave Saldin watch something and notify the person on their iPhone when it happens, checked every few minutes between 9:00 and 22:00 in their time zone without AI, so there is no need to poll. Kinds: category_spending (the month's spending in categoryId, a category or subcategory, reaches amount; once a month), balance_below (accountId's balance falls below amount; at most every 72 hours), large_expense (each new expense or card charge of at least amount, imports excluded), budget_overrun (committed spending, actual plus pending on the due-month basis, reaches percent of the persona's overall monthly budget, then the limit itself, for the current month and with includeNextMonth the next one; once per month and step; needs an overall budget from set_budget), projected_balance_below (the persona's projected balance in currency, the app's Home projection with pending income, pending expenses and card bills, goes below amount on any day from today through the end of the current month, the projection's horizon; amount may be zero or negative, such as -2000.00 for an overdraft limit; at most every 72 hours). Amounts are in the persona's currency, the account's for balance_below. There is one monitor per kind and target (category, account or currency); creating one that exists adjusts it and keeps it paused if it was, and creating one that was removed brings it back. At most 10 are active.
create_recurrence
ChatGPTCreate recurring income, expense or card charge: accountId for income and expense, cardId for card_charge. For a card charge billed from another currency, original is the amount and currency charged by the merchant; Saldin estimates amount in the card currency from the latest BCB PTAX closing sell quote until each occurrence is confirmed with its actual billed amount. Occurrences appear as pending transactions until confirmed. End it with endDate or count, or neither for an open-ended recurrence.
delete_budget
ChatGPTRemove a budget limit (ids from list_budgets). A month-specific budget is removed. A recurring plan line stops from fromMonth (default: the current month) on, and earlier months keep it. Requires the delete scope.
delete_invoice
ChatGPTDelete an invoice recorded by mistake, with its receipt links. Needs the delete scope.
delete_monitor
ChatGPTRemove a monitor: it stops notifying, leaves the app's list, and Saldin's analyses never create it again. To stop it for a while, pause it with update_monitor instead. Requires the delete scope.
delete_transaction
ChatGPTDelete a transaction and its linked entries: both sides of a transfer, or every installment of a purchase (pass any installment's id). Related transactions stay; delete each one separately when the person asks. A recurring occurrence needs recurrenceScope: this_occurrence removes only that one, this_and_future also ends the recurrence from there. Requires the delete scope.
end_recurrence
ChatGPTEnd a recurrence from a date: removes the occurrence on from and every later one, keeping earlier occurrences. A recurrence with a set count keeps it, so occurrences stay numbered out of the original total (for example after paying the last installments in advance). Requires the delete scope.
find_matching_transactions
ChatGPTTransactions with exactly this amount within some days of a date, across every persona unless scope is given, pending ones included, nearest first with daysFromDate. Use it before recording something a bank reported, to find the same movement already recorded (also as the other side of a transfer or as a pending item to confirm) instead of searching by hand.
get_budget_status
ChatGPTMonthly budget limits, spending, pending commitments and remaining amounts for one persona in its default currency. Spending in other currencies is estimated with the latest BCB PTAX closing sell quote; estimate names the source, date and currencies left out. source says whether the month's own plan or the recurring plan applied.
get_card_bills
ChatGPTBills of one card, oldest first. Each bill has dueMonth (the billDueMonth other tools take), closingDate, dueDate, state (open, closed, partially_paid, paid or overdue), charges, credits, payments, carriedIn (unpaid balance brought from earlier bills), outstanding (what is left to pay) and pendingForecast (pending charges, not owed yet). With fromMonth it returns exactly the bills due from that month through toMonth; without fromMonth it starts twelve months ago and also includes any older bill that still has an outstanding amount.
get_cashflow_projection
ChatGPTDay-by-day projection of one persona's cash in one currency from today through a date up to 400 days ahead, with the lowest point. It starts from the current balance of the accounts counted in totals (or includeAccountIds) and applies, in date order: pending income and expenses on those accounts (source pending_entry, or recurrence for recurrence occurrences), each card bill on its due date for what is left to pay plus its pending charges (card_bill; a balance carried in from an overdue bill is counted once, on the overdue bill), and the hypotheticals passed in (hypothetical), which are never stored. Overdue pending items and bills land on today. Events on one day list money coming in first, and balanceAfter is the running balance; lowest and floor use each day's closing balance, and lowest also considers today's starting balance. Recurrence occurrences exist through recurrencesGeneratedThrough (about twelve months ahead); later ones are not in the projection. Amounts are signed decimal strings: negative leaves the accounts.
get_directory
ChatGPTEverything needed to resolve ids in one call: personas (with default currency), accounts and cards (closing and due days) with their persona, the category tree (parentId marks a subcategory, flow is expense or income) and tags. Call it once at the start instead of list_personas, list_accounts, list_cards, list_categories and list_tags; balances and bills are in get_overview and list_cards.
get_exchange_rates
ChatGPTThe latest PTAX selling rate of USD, EUR, GBP, CAD, AUD, CHF and JPY in reais per unit, published by the Banco Central do Brasil once per business day, with the date it closed. Use it to estimate conversions and say it is an estimate with the rate's date; never change a stored amount with it.
get_invoice
ChatGPTOne invoice with its parties, amounts, retentions and the receipts linked to it.
get_invoice_issuance_guide
ChatGPTRead the curated versioned NFS-e guide before answering general or Saldin setup questions. Topics: index, basics, setup, certificate, service, export, customers, lifecycle, errors, limits. Choose export for export options, errors for save failures/rejections and setup for checklists; request independent topics together. No personal data or tax advice. Use the person's language.
get_invoice_overview
ChatGPTFor a persona and date range: invoices by competence date with what was received and is still open, and the receipts in BRL that still wait for an invoice (income in sales categories and reais credited by a currency exchange, minus what is linked or marked as needing no invoice).
get_issuing_profile
ChatGPTRead the confirmed provider and reusable services for a business persona.
get_issuing_setup_status
ChatGPTRead the business persona's setup readiness, missing codes and plain next steps. Uses cached municipal eligibility only, never refreshes it or accesses certificate secrets. Defaults competence to today and environment to this server's environment. Read before answering about the person's setup.
get_monthly_report
ChatGPTIncome and expense totals plus category breakdown for a month. Native amounts remain per currency; approximateTotals and each foreign category approximate use the persona default currency and the latest BCB PTAX closing sell quote, with source, date and missing currencies. basis "due_month" (default, how the app plans) counts card charges in the month their bill is due; "purchase_date" counts them in the month they were bought. Use the default unless the person asks about when purchases were made, and say which basis the answer uses. With scope "all" (the default) it returns one report per persona in personas and adds nothing across personas.
get_overview
ChatGPTCurrent balance, projected month-end balance, this month's income and expenses (actual and pending, card charges counted in their bill's due month), every account with its balance, every card with its current and open bills, upcoming payments and goals, so list_accounts and list_cards are not needed after it. Balances in several currencies also get approximateTotal in the persona's default currency at the latest PTAX rate. asOf is today's date in the person's time zone. With a persona id it returns that persona; with scope "all" (the default) it returns one such section per persona in personas, plus the next upcoming items of every persona, and adds nothing across personas.
get_tax_overview
ChatGPTA business persona's tax profile, activities, history overrides and payroll, plus every month from trackedFrom with its status and full DAS estimate, computed now from the current records. Filter with year.
get_tax_period
ChatGPTOne month's DAS estimate with every revenue line (included or excluded and why), the tax per segment, the due date and late charges, the assessments confirmed for it (revisions) and the tax expenses that could be its payment.
get_transaction
ChatGPTOne transaction with its version, its operation, the operation's linked entries (both transfer sides, every installment), related refunds and anticipation charges, relatedTransactions (other transactions related to it, such as the other side of a payment between personas) and attached receipts.
get_transfer_history
ChatGPTHow earlier movements between two accounts were recorded, newest first: transfers between them, and pairs of related transactions such as a withdrawal from a business account recorded as an expense there and an income in the personal account. Each item lists both sides with their kind, description and category. Use it to record a new movement between the same accounts the same way.
import_invoices
ChatGPTSave the new documents in NF-e or NFS-e XML files and apply status changes, linking each new invoice to its preselected receipts (exact, explained or close). Invoices with only an approximate match or none are saved without links and listed in unmatched; link them with link_invoice once the person confirms.
link_invoice
ChatGPTLink an invoice to a receipt it was issued for. Without amounts both sides take what is left on the invoice or the receipt, whichever is smaller; pass invoiceAmount and receiptAmount when they differ, such as IOF taken from the conversion. With invoiceId null the receipt (or receiptAmount of it) is marked as needing no invoice.
list_accounts
ChatGPTBank, wallet and cash accounts with their current balance in their own currency.
list_budgets
ChatGPTStored budget limits: month-specific ones, and the recurring plan as one row per line and starting month, with fromMonth and untilMonth.
list_cards
ChatGPTCredit cards with limit, credit used (including future installments) and available credit, plus two bills: currentBill, the next bill to pay (the first one not yet due and not paid), and openBill, the bill new purchases go on now. To pay a bill in full, pay its outstanding.
list_categories
ChatGPTCategory tree (one subcategory level) per persona, each with its flow (expense or income). Use ids when recording transactions and budgets.
list_goals
ChatGPTSavings goals with native progress and, when the goal uses another currency, approximate target and progress in the persona's default currency with the latest BCB PTAX source and date.
list_invoice_issuances
ChatGPTRead recent drafts and issued notes, provider rejection codes, bilingual guidance, cancellation and DANFSE states. Results are newest first. Only use returned note links.
list_invoices
ChatGPTInvoices by competence date (the fiscal reference period), each with its net amount, how much of it is linked to receipts and what is still open.
list_issuing_customers
ChatGPTRead a business persona's saved customers and confirmed last-note defaults.
list_monitors
ChatGPTMonitors that send the person push notifications from the Saldin app: kind, params (thresholds as decimal strings and their currency), title, status (active or paused; removed ones only with includeRemoved), createdBy (ai for Saldin's own analyses, person for the person or an agent acting for them) and lastTriggeredAt.
list_personas
ChatGPTPersonal and business personas this connection can access.
list_recurrences
ChatGPTRecurring income, expenses and card charges, one entry per series with its current terms; its id is what stop_recurrence and end_recurrence take. To find an occurrence, search_transactions by description and date. Editing an occurrence with this_and_future starts a new revision of the series.
list_tags
ChatGPTTags per persona.
pay_card_bill
ChatGPTRecord in Saldin that a full, partial or advance card-bill payment was made. This never sends money, contacts the card issuer or initiates a bank transaction. It updates the Saldin ledger by reducing the paying account balance and the card debt without creating another expense. For a full payment, use the outstanding amount from list_cards or get_card_bills.
prepare_invoice_issuance
ChatGPTPrepare a fiscal draft without submitting it, for a customer already saved in Saldin (customerId from list_issuing_customers). New customers are added only in the Saldin app; never ask for a customer's CPF, CNPJ or other identifier here. For a customer who is not saved yet, give the person a link that opens the app's customer form prefilled: https://saldin.app.br/open/customer# followed by URL-encoded key=value pairs joined with &, using only name, email, phone, country (ISO code), address, street, number, complement, district, postalCode, municipality (IBGE code), city, region and personaId; the person completes and saves it in the app, then call list_issuing_customers again. Refreshes municipal eligibility through the certificate custody worker when needed. Show every returned value and environment to the person. A separate explicit approval is required before confirm_invoice_issuance.
preview_invoice_import
ChatGPTRead NF-e or NFS-e XML files for a persona without saving anything. Each document comes back as new, duplicate, status_changed (cancelled or replaced since it was imported), received (issued to this business, not by it, which is not supported) or invalid, with the receipts it most likely pays: confidence exact, explained (the difference equals a fee charged the same day on the same account), close (within R$ 1) or approximate (within 1%, not preselected).
record_balance_adjustment
ChatGPTCorrect an account or card balance with a dated adjustment that is excluded from income and expense totals. Give exactly one of accountId or cardId. amount is the signed difference, not the new balance: for an account, positive raises the balance; for a card, positive raises the amount owed. To reach a target balance, subtract the current balance (list_accounts) from it. When the difference is real money, such as savings yield (rendimento) or a bank fee, give categoryId with accountId: the difference is then recorded as a confirmed income when positive or an expense when negative, in that category, instead of an adjustment. The category must belong to the account's persona and match that flow, and description defaults to the category name.
record_card_bill_payment
ChatGPTRecord in Saldin that a full, partial or advance card-bill payment was made. This never sends money, contacts the card issuer or initiates a bank transaction. It updates the Saldin ledger by reducing the paying account balance and the card debt without creating another expense. For a full payment, use the outstanding amount from list_cards or get_card_bills.
record_card_purchase
ChatGPTRecord a credit-card purchase on its purchase date; Saldin assigns the bill from the card's closing date. installments splits the total across consecutive bills, the first carrying any remainder cent, and the full amount reserves credit immediately. status defaults to confirmed; pending records a charge that is not confirmed yet. For a foreign-currency purchase, amount is what the card billed and original what was spent abroad.
record_income_or_expense
ChatGPTRecord money received into or paid from a bank, wallet or cash account; for a credit card use record_card_purchase. status "confirmed" (default) means it happened; "pending" means it is expected and not yet paid or received.
record_installment_anticipation
ChatGPTRecord in Saldin that future installments of a card purchase were paid off early at the amount the bank quoted. This never requests an anticipation from the issuer or sends money. The recorded payoff becomes one charge on the target bill and the selected installments leave their bills; recording the target bill payment is a separate record_card_bill_payment call.
record_refund
ChatGPTRecord a partial or full refund of an expense or card purchase. With originalTransactionId (any installment of a purchase) it links to the purchase and takes its card or account and category; give cardId or accountId only when the money came back somewhere else. A card refund credits the card's open bill. It reduces spending in the month received.
record_transfer
ChatGPTMove money between two accounts; to pay a card bill use pay_card_bill. status defaults to confirmed. For different currencies give destinationAmount. Fees are line items, each in its own currency: with feeMode gross, amount and destinationAmount are before the fees, the transfer moves exactly those amounts and each fee becomes its own expense, named by its label, on the account that holds its currency; with net, both amounts are already the actual movements and the fees are only itemized. Between accounts of different personas it records two independent, related transactions instead of a transfer: an expense in the source persona classified with fromCategoryId (an expense category there, for example pró-labore or dividends) and an income in the destination persona classified with toCategoryId. That needs both persona grants and takes no fees (record a fee as its own expense and relate it), and each side is then edited or deleted on its own.
relate_transactions
ChatGPTMark two transactions as related, for example the USD sent for a dollar sale and the BRL received for it, or the two sides of a payment between personas recorded separately. Groups merge when either already has related transactions. Amounts, dates and categories do not change. Needs write access to both personas.
reopen_tax_assessment
ChatGPTUndo the confirmed DAS of a month that is not paid: the pending expense Saldin created is deleted (needs the delete scope) and the month returns to its estimate. The assessment history is kept.
save_tax_activity
ChatGPTWithout id, add an activity to a business persona; with id, change or archive it. anexo is I to V, or fator_r for services that move between Anexos III and V by payroll. segregation covers the mixed activities of Res. CGSN 140 art. 25 par. 1 (rental of movable goods, IPI and ISS, interstate transport, accounting office with fixed ISS, and from 2027 goods without ICMS or services without ISS). issReduction is a municipal reduction as a fraction (0.5); fixedIss is a monthly fixed ISS under art. 33.
search_transactions
ChatGPTTransactions matching optional text and filters, over all dates unless from or to is given, newest first, 50 per page by default; pass nextCursor as cursor for the next page instead of raising limit. Each installment of a card purchase and each recurrence occurrence is its own row, with its id, version (enough for update_transaction, no need to read it again), status and the names of its category, account or card and tags. For a merchant's usual category use suggest_classification, for a movement already recorded find_matching_transactions, and for totals summarize_transactions.
set_bill_closing_date
ChatGPTCorrect when one card bill closes, for a month the bank closes it earlier or later than the card's usual day. Each bill's current closingDate is in list_cards and get_card_bills: the first purchase date that goes to the next bill. The new date must be within 10 days of the usual one, after the previous bill's closing date and no later than the due date; null restores the usual day. Purchases already recorded keep their bills.
set_bill_due_date
ChatGPTCorrect when one card bill falls due, for a month the bank moves it from the card's usual day (a weekend or holiday, for example). Each bill's current dueDate is in list_cards and get_card_bills. The new date must be within 10 days of the usual one, on or after the bill's closing date, after the previous bill's due date and before the next one's; null restores the usual day. It never changes which charges the bill holds.
set_budget
ChatGPTSet an overall (no categoryId) or category budget; setting one that exists replaces its amount. month YYYY-MM sets that month only. Omit month for the recurring monthly plan, which applies from fromMonth (default: the current month) on and replaces any later change to the same line; months before fromMonth keep the plan they had. A month with any month-specific budget uses only its month budgets, so add every category that month needs; get_budget_status reports the plan it used as source.
set_tax_payroll
ChatGPTRecord the payroll paid in each month (pró-labore, salaries, 13th salary, CPP and FGTS), which fator r divides by revenue. Pass several months at once; with clear true the given months are removed.
set_tax_profile
ChatGPTCreate or change a business persona's tax profile: regime (simples or mei), CNPJ opening date, first month in the Simples, first month to estimate (trackedFrom), municipality (IBGE code), cash basis (until 12/2026), revenue basis, IBS/CBS outside the Simples (2027 on), MEI activity, default activity and the account that pays the DAS. Creating a Simples profile needs activity, the main activity with its anexo or fator_r.
set_tax_revenue_month
ChatGPTReplace the revenue Saldin derives for a month with the declared amounts, split into domestic and export, for months before the records start or to match the PGDAS-D. 0.00 and 0.00 confirms a month without revenue. With clear true the override is removed.
show_budget_status
ChatGPTRender the overall and category budget status for one persona and month.
show_card_bills
ChatGPTRender a credit card's bills, due dates, outstanding amounts and payment state.
show_cashflow_projection
ChatGPTRender a persona's cash projection through a date up to 400 days ahead, including its lowest point and optional floor.
show_financial_overview
ChatGPTRender current and projected balances, this month's flows, accounts, cards, upcoming items and goals for one persona or all granted personas.
show_monthly_report
ChatGPTRender one month's income, expenses, categories and commitments for one persona or all granted personas.
stop_recurrence
ChatGPTEnd a recurrence now: removes every pending occurrence dated today or later and keeps confirmed ones. To keep occurrences until a later date, use end_recurrence. Requires the delete scope.
suggest_classification
ChatGPTHow a merchant or description was categorized before, as ranked candidates with their category and subcategory names, how many times each was used, how many on the given card or account and with the given amount, the last use and its descriptions and tags. matchQuality says how the text matched: exact (same merchant or description), contains (the text appears as words) or fuzzy (only similar words, so check it really is the same place before trusting it). Use it instead of searching the merchant's history.
summarize_transactions
ChatGPTTotals of the transactions matching the search_transactions filters, optionally grouped, so totals never need to be added up from rows: spending by category, tag, merchant, card or account, spending per day, or a trend across months in one call. Each persona is its own section in personas (one section when scope is a persona id) and every total is per currency: nothing is added across personas or currencies. totals covers the whole section; with groupBy, groups lists each key with a label and its own totals. income, expense, net (income minus expense) and count cover confirmed transactions; pending has the same figures for pending ones (expected income, pending expenses, future recurrence occurrences). Income and expense follow get_monthly_report: refunds reduce expense, and transfers, card payments and balance adjustments are counted in count but are neither income nor expense. Tag grouping counts a transaction under each of its tags, so tag groups can add up to more than totals, which counts it once; key null holds untagged transactions, and likewise transactions without a category, merchant, card or account. merchant groups by merchant, or by description when there is none, ignoring case and accents. day and month groups run oldest first, the others largest first; each section lists at most 200 groups, with groupCount and truncated telling whether there were more. basis (default "due_month", how the app plans) decides the month of a card charge for month grouping and for fromMonth and toMonth: "due_month" uses the month its bill is due, "purchase_date" the month it was bought. day grouping and from and to always use the transaction date (the purchase date for card charges), like search_transactions. To match get_monthly_report for a month, pass it as fromMonth and toMonth with the same basis. Say which basis an answer uses.
unconfirm_transaction
ChatGPTReturn a confirmed transaction to pending (expected, not yet paid or received); pending entries do not count in current balances.
unlink_invoice
ChatGPTRemove one link between an invoice and a receipt, or a receipt's no-invoice mark. Invoices and transactions stay as they are.
unrelate_transaction
ChatGPTTake a transaction out of its related group. Neither it nor the others change otherwise.
update_invoice
ChatGPTMark an invoice cancelled (its receipt links are removed) or issued again, or change its notes.
update_monitor
ChatGPTPause or resume a monitor (status), or change its title or threshold (amount, percent, includeNextMonth). Its kind and target stay the same; to watch something else, create another monitor. A removed monitor cannot be updated.
update_transaction
ChatGPTChange fields of a transaction; send only the fields that change (a field equal to its current value is ignored). The answer lists the fields that changed and the transaction with every linked row after the change. Pass the version from search_transactions or get_transaction as baseVersion; a conflicting change returns version_conflict with both values. Linked records change together: both transfer sides, every installment of a purchase. For a card purchase pass any installment's id: amount is the new purchase total split again across its installments, installmentAmount changes only this installment (to match the bank's cents) and the total becomes the sum of the installments, firstBillDueMonth moves the whole purchase so its first installment lands on that bill and the others follow, billDueMonth moves only this charge, and installments changes the count. A recurring occurrence needs recurrenceScope; use this_and_future on the occurrence where a change starts.