Changelog

Histórico de mudanças da API Conta Simples

Para entender as convenções, versionamento e política de breaking changes, veja Convenções do Changelog.

[2026-06-26]

Added

Adiciona endpoint de criação de VCN (POST /credit-cards/v1/vcns): emite um cartão virtual (VCN) para reservas de turismo (hotel e aéreo) com os metadados da reserva, retornando PAN, CVV e validade. Requer mTLS além da autenticação por API key/secret. Ver referência. Em breve — ainda não disponível em Sandbox/Produção.
Endpoint de consulta de saldo da conta (GET /accounts/v1/balance): retorna o saldo disponível da conta da empresa autenticada em BRL. Ver referência.

[2026-06-23]

Added

Endpoint de criação de centro de custo (POST /cost-centers/v1/cost-centers): cria um novo centro de custo para a empresa; o campo name é obrigatório e deve ser único por empresa. Ver referência.
Endpoint de consulta de centro de custo por ID (GET /cost-centers/v1/cost-centers/{id}): retorna os dados de um centro de custo específico pelo UUID. Ver referência.
Endpoint de atualização de centro de custo (PATCH /cost-centers/v1/cost-centers/{id}): renomeia um centro de custo existente; o novo nome deve ser único na empresa. Ver referência.
Endpoint de exclusão de centro de custo (DELETE /cost-centers/v1/cost-centers/{id}): exclui um centro de custo pelo UUID; retorna 204 em caso de sucesso. Ver referência.

Deprecated

Campo responsible na resposta de GET /cost-centers/v1/cost-centers: será removido em versão futura. Não utilize este campo em novas integrações. Ver referência.

[2026-06-18]

Added

Endpoint de atualização de fornecedor (PUT /suppliers/v1/suppliers/{id}): atualiza o nome de um fornecedor existente da empresa; o campo name é obrigatório e deve ser único por empresa. Ver referência.
Endpoint de exclusão de fornecedor (DELETE /suppliers/v1/suppliers/{id}): exclui um fornecedor existente da empresa pelo ID numérico. Retorna 204 em caso de sucesso. Ver referência.

[2026-06-11]

Added

Endpoint de atualização de nome de categoria (PATCH /categories/v1/categories/{id}): renomeia uma categoria customizada existente; apenas o campo name é atualizado — os estabelecimentos vinculados e o tipo da categoria permanecem inalterados. O novo nome deve ser único na empresa. Ver referência.
Endpoint de exclusão de categorias (DELETE /categories/v1/categories): deleta uma ou mais categorias customizadas em uma única requisição. Se a categoria tiver estabelecimentos vinculados, informe moveTo para reatribuí-los antes da exclusão — omitir retorna 422. Ver referência.

[2026-06-03]

Added

Endpoint de atualização parcial de usuário (PATCH /users/v1/users/{userId}): atualiza name e/ou roleId de um usuário ativo da empresa; ao menos um campo obrigatório por requisição. Ver referência.
Adiciona endpoint de listagem de fornecedores (GET /suppliers/v1/suppliers). Ver referência.
Adiciona endpoint de consulta de fornecedor por ID (GET /suppliers/v1/suppliers/{id}). Ver referência.
Adiciona endpoint de criação de fornecedor (POST /suppliers/v1/suppliers). Ver referência.

[2026-05-28]

Added

Endpoint de listagem de centros de custo (GET /cost-centers/v1/cost-centers): lista todos os centros de custo da empresa autenticada. A resposta inclui id, name, companyId e o campo opcional responsible com nome e ID do responsável vinculado. Ver referência.

Changed

Endpoint PATCH /statements/v1/credit-card/{transactionId}: adicionado campo costCenterId (UUID) para classificar a transação por centro de custo. Ver referência.

[2026-05-27]

Added

Endpoint de consulta de usuário por ID (GET /users/v1/users/{userId}): retorna os dados de um usuário específico da empresa pelo identificador (UUID v4); resposta alinhada ao item da listagem (UserDto), com 404 quando o usuário não pertencer à empresa autenticada.

[2026-05-26]

Added

Endpoint de atualização de transação de cartão (PATCH /statements/v1/credit-card/{transactionId}): atualiza notes, isConciled e categoryId de uma transação de cartão de crédito; ao menos um campo obrigatório por requisição.

[2026-05-14]

Changed

Endpoint de extrato de cartão (GET /statements/v1/credit-card): adicionado parâmetro opcional cardIds (string, separado por vírgula) para filtrar transações por um ou mais cartões simultaneamente.

[2026-04-28]

Added

Endpoint de criação de categoria (POST /categories/v1/categories): cria uma categoria personalizada para a empresa; o nome deve ser único entre as categorias da empresa.
Endpoint de consulta de categoria por ID (GET /categories/v1/categories/{id}): retorna uma categoria da empresa pelo identificador numérico; resposta alinhada ao item da listagem (estabelecimentos e tipo).

[2026-04-17]

Added

Endpoint de listagem de categorias (GET /categories/v1/categories): retorna as categorias disponíveis para a empresa.

[2026-04-10]

Added

Endpoint de extrato bancário (GET /statements/v1/banking): consulta paginada de transações bancárias da empresa com suporte a filtros por período, conta, categoria, centro de custo, status, valor e responsável.

[2026-04-02]

Changed

Resposta do extrato de cartão (GET /statements/v1/credit-card): cada anexo em attachments pode incluir o campo opcional type com o MIME (image/jpeg, image/png ou application/pdf) quando a extensão do nome do arquivo for reconhecida.

[2026-03-27]

Added

Endpoint de exclusão de usuários (DELETE /users/v1/users/{userId}): permite remover um usuário da empresa pelo ID.

[2026-03-25]

Added

Endpoint de criação de convites de usuários (POST /users/v1/invites): permite enviar convites para novos usuários se juntarem à empresa, informando e-mail e papel (role).

[2026-03-24]

Added

Endpoint de listagem de papéis (roles) (/users/v1/roles): retorna os papéis da empresa com perfil, permissões (claims) e quantidade de usuários vinculados.

[2026-03-23]

Added

Endpoint de listagem de convites de usuários (/users/v1/invites): consulta paginada de convites com filtros por status e papel (role).

[2026-03-17]

Changed

Endpoint de extrato de cartão (/statements/v1/credit-card): documentação atualizada de POST para GET, com parâmetros de filtro (limit, startDate, endDate, types, nextPageStartKey) enviados via query string.

[2026-03-16]

Added

Endpoints de gestão de cartões corporativos: listagem com filtros, bloqueio e desbloqueio de cartões.
Endpoint de listagem de usuários da empresa, com filtro por e-mail e paginação por cursor.