Changelog

---

[2026-06-03]

Added

• Partial user update endpoint (PATCH /users/v1/users/{userId}): updates name and/or roleId for an active company user; at least one field required per request. See reference.
• Adds supplier list endpoint (GET /suppliers/v1/suppliers). See reference.
• Adds get supplier by ID endpoint (GET /suppliers/v1/suppliers/{id}). See reference.
• Adds create supplier endpoint (POST /suppliers/v1/suppliers). See reference.

---

[2026-05-28]

Added

• List cost centers endpoint (GET /cost-centers/v1/cost-centers): returns all cost centers for the authenticated company. The response includes id, name, companyId, and the optional responsible field with the name and ID of the assigned owner. See reference.

Changed

• Endpoint PATCH /statements/v1/credit-card/{transactionId}: added costCenterId (UUID) field to classify the transaction by cost center. See reference.

---

[2026-05-27]

Added

• Get user by ID endpoint (GET /users/v1/users/{userId}): returns details of a specific company user by UUID v4 identifier; response matches the list item structure (UserDto), with 404 when the user does not belong to the authenticated company.

---

[2026-05-26]

Added

• Update card transaction endpoint (PATCH /statements/v1/credit-card/{transactionId}): updates notes, isConciled, and categoryId on a credit card transaction; at least one field required per request.

---

[2026-05-14]

Changed

• Card statement endpoint (GET /statements/v1/credit-card): added optional cardIds query parameter (comma-separated string) to filter transactions by one or more cards at once.

---

[2026-04-28]

Added

• Create category endpoint (POST /categories/v1/categories): creates a custom category for the company; the name must be unique among the company’s categories.
• Get category by ID endpoint (GET /categories/v1/categories/{id}): returns a company category by numeric ID; response matches list items (establishments and type).

---

[2026-04-17]

Added

• List categories endpoint (GET /categories/v1/categories): returns categories available to the company.

---

[2026-04-10]

Added

• Banking statement endpoint (GET /statements/v1/banking): paginated company bank transactions with filters by period, account, category, cost center, status, amount, and responsible user.

---

[2026-04-02]

Changed

• Card statement response (GET /statements/v1/credit-card): each item in attachments may include an optional type field with the MIME type (image/jpeg, image/png, or application/pdf) when the file name extension is recognized.

[2026-03-27]

Added

• Delete user endpoint (DELETE /users/v1/users/{userId}): removes a user from the company by ID.

---

[2026-03-25]

Added

• Create user invites endpoint (POST /users/v1/invites): send invites for new users to join the company with email and role.

---

[2026-03-24]

Added

• List roles endpoint (/users/v1/roles): returns company roles with profile, permissions (claims), and linked user counts.

---

[2026-03-23]

Added

• List user invites endpoint (/users/v1/invites): paginated invites with filters by status and role.

---

[2026-03-17]

Changed

• Card statement (/statements/v1/credit-card): documentation updated from POST to GET, with filter parameters (limit, startDate, endDate, types, nextPageStartKey) sent in the query string.

---

[2026-03-16]

Added

• Corporate card management endpoints: list with filters, block, and unblock cards.
• List company users endpoint, with email filter and cursor-based pagination.

---

[2026-02-25]

Added

• List credit cards endpoint.

---

[2026-02-09]

Added

• Login endpoint for Conta Simples API authentication.

---

[2026-02-03]

Added

• Endpoint to download transaction attachments.

---

[2026-01-19]

Added

• Card statement endpoint extended with new fields related to attachments.

---

[2025-10-15]

Added

• Card statement endpoint.
• Initial API schema definition for transactions and cards.