Công cụ CTAS Life

Xem ngữ cảnh của tôi

Returns the signed-in CTAS user, the current date and time in Vietnam (Asia/Ho_Chi_Minh), the scopes of this connection and, for CTAS Work, every organization in the connection with the user's role, permissions and whether the connection can be used there. Call it once at the start of a conversation and reuse the answer.

Ghi khoản chi

Records an entry in a Chia Chia group: an expense (default), income, transfer between two members, or a fund deposit or withdrawal. Send the total, who paid and who takes part with split_mode; the server computes every share and refuses totals that do not add up, saying by how much. Member ids come from get_group. Returns the entry and the new balance of the user.

Thêm người vào nhóm

Adds a person (just a name, no CTAS account needed) to a Chia Chia group so expenses can be split with them. If someone with exactly that name is already in the group, returns them with created=false instead of adding a duplicate.

Tạo nhóm Chia Chia

Creates a Chia Chia group with the user as owner and, optionally, the names of the other people in it (they need no CTAS account) and a shared fund. Fails with PLAN_EXPIRED when the account has no free group slot. Returns the group with member ids.

Xoá khoản chi

Deletes an entry from a Chia Chia group; balances no longer count it and the group activity records who deleted it. Returns the new balance of the user in the group.

Xem ai nợ ai

Returns the balance of every member of a Chia Chia group (positive: is owed; negative: owes) and the fewest transfers that settle everyone up, as the app shows them. settle_fund=true also pays out the fund cash to the people it belongs to.

Xem một khoản chi

Returns one entry of a Chia Chia group in full: amount, payers and how it is split (with names and weights), items, extras, note, whether it has a receipt photo, whether it was deleted, and its change history.

Xem một nhóm Chia Chia

Returns one Chia Chia group: its members (people and the shared fund, with ids to use in other tools), each member balance, the fewest transfers that settle everyone up, fund cash, currency and the current invite code. Bank accounts show only their last four digits.

Xem báo cáo nhóm

Returns the spending report of a Chia Chia group: total spent, by category, by day, top payer and per member paid, consumed and balance. With member_id, returns that member instead: whom they paid for, who paid for them, transfers, fund deposits, by category and their latest entries.

Rời nhóm Chia Chia

Makes the user leave a Chia Chia group. Their name and entries stay in the group for the others; an owner who leaves hands ownership to the next admin. Coming back needs an invite code from someone still in the group.

Xem hoạt động Chia Chia

Lists recent Chia Chia activity, newest first, as one-line summaries (who added, changed or deleted which entry, who joined or left): across all of the user's groups, or in one group with group_id.

Xem khoản chi của nhóm

Lists the entries of a Chia Chia group (expenses, incomes, transfers, fund deposits and withdrawals), newest first, with payer and split names. Filter by kind, member (as payer or participant), category, words in the title or a date range. response_format=detailed adds notes, items, weights and payer mode.

Xem các nhóm Chia Chia

Lists the Chia Chia (shared expenses) groups the user belongs to, most recently active first, with their own member id and balance in each (positive: the group owes them; negative: they owe), total spent and fund cash. Amounts are integers in the smallest unit of the group currency. Archived groups only with archived=true.

Bỏ người khỏi nhóm

Removes a member from a Chia Chia group. A member with no entries is deleted; one who appears in entries is only hidden (left=true) and their balance stays. Removing a name someone has claimed needs a group manager; the owner cannot be removed.

Sửa khoản chi

Changes an entry of a Chia Chia group. Send only the fields to change; the rest stay. If only the amount changes, a single payer pays the new total and weighted splits keep their weights; fixed per-person amounts must be sent again. The server recomputes every share and returns the entry and the new balance of the user.

Sửa nhóm Chia Chia

Changes a Chia Chia group: name, type, emoji, currency (only while it has no entries), the shared fund (on, or off once its cash is zero) or archived. Currency and fund need a group manager. Send only the fields to change.

Sửa người trong nhóm

Changes a member of a Chia Chia group: rename them, set role admin or member (group owner only), or set settled_by_member_id so another member pays and receives on their behalf (null undoes it). Send only the fields to change.

Đổi ngày dương ↔ âm

Converts one day between the solar (Gregorian) and Vietnamese lunar calendar, 1900 to 2100: give date (solar) or lunar_day, lunar_month, lunar_year and lunar_leap. Returns both dates, weekday, can chi of day/month/year, solar term, truc, hoang dao or hac dao spirit, auspicious hours and holidays. A pure calculation.

Xoá ngày riêng

Deletes a Lich Am day by its client_id from list_lunar_events. A day in a family book disappears for everyone in that book; the phones drop it and its reminders on their next sync.

Tìm ngày tốt

Finds good days for an undertaking (wedding, opening, moving house, ground breaking, travel, signing a contract, buying a vehicle) in a range of at most 90 days, 1900 to 2100, by Vietnamese tradition. Drops nguyet ky, tam nuong, bad truc and, with birth_year, days clashing with that person; scores the rest. Costs 3 units of the rate budget, so pick the range first.

Xem chi tiết một ngày

Returns one solar day (1900 to 2100) in full by the Vietnamese lunar calendar: lunar date, can chi, solar term, holidays, truc with the activities it favours and avoids, hoang dao or hac dao spirit, auspicious hours, nguyet ky and tam nuong warnings, and tuoi xung (the clashing earthly branch; with birth_year, whether it clashes with that person). A pure calculation.

Xem một sổ ngày

Returns one Lich Am family book: its name, the user's role, its members with their roles and when they joined, the number of days, and its current invite code. Its days are listed by list_lunar_events with this book_id.

Xem lịch một tháng

Returns one month of the Vietnamese lunar calendar, one short row per day: solar date, weekday, lunar day and month, can chi of the day, hoang dao or not, solar term starting that day and holidays. calendar=solar (default) takes a Gregorian month; calendar=lunar takes a lunar month, leap=true for its leap month. 1900 to 2100. A pure calculation.

Xem sổ ngày của nhà

Lists the Lich Am family books (so ngay cua nha) the user is in: shared lists of family days such as death anniversaries that every member sees and is reminded of. Returns each book with the user's role, member names and number of days.

Xem ngày riêng sắp tới

Lists the user's Lich Am days (death anniversaries, birthdays, anniversaries, others) and those of the family books they are in, each with its next occurrence as a solar date and days until it, soonest first. days_ahead (1 to 366) keeps only days coming up within that window. Filter by book_id or kind.

Lưu ngày riêng

Creates a Lich Am day (death anniversary, birthday, anniversary, other) on the lunar or solar calendar, or changes one when client_id is given (send only the fields to change). book_id puts it in a family book the user is in, so everyone there sees it; leave it out for a personal day. It syncs to the user's phones, which remind on it. Returns the day with its next occurrence.

Xem tài khoản CTAS Life

Returns the user's CTAS Life account: whether Premium is active and until when, AI credit balance and today's use, how many Chia Chia groups they own and the limit, Lich Am settings (birth year, primary calendar) and the bank account they receive money on, with only its last four digits.