Conta Simples

Manage your Conta Simples digital account.

Authentication

This connector uses Token-based authentication.

info

Set up your connection in the Abstra Console before using it in your workflows.

How to use

Using the Smart Chat

Execute the action "CHOOSE_ONE_ACTION_BELOW" from my connector "YOUR_CONNECTOR_NAME" using the params "PARAMS_HERE".

Using the Web Editor

from abstra.connectors import run_connection_action

result = run_connection_action(
  connection_name="your_connection_name",
  action_name="your_action_name",
  params={
    "param1": "value1",
    "param2": "value2"
  })

Available Actions

This connector provides 19 actions:

Action	Purpose	Parameters
post_oauth_v1_access_token	Obtém um token de acesso JWT via OAuth 2.0 Client Credentials. As credenciais api_key e api_secret devem ser enviadas no header Authorization: Basic, com o valor em base64 da string api_key:api_secret. As credenciais são gerenciadas pelo Internet Banking da Conta Simpleshttps://ib.contasimples.com/integracoes/api/credenciais. Importante: - O token expira em 30 minutos expires_in: 1800. - Renove o token antes da expiração para evitar interrupções. - Use Content-Type: application/x-www-form-urle	No parameters
get_credit_cards_v1_cards	Retorna a lista paginada de cartões corporativos da empresa, com filtros opcionais por status, tipo, e-mail do responsável, nome do produto e últimos 4 dígitos. Filtros disponíveis: - status: ACTIVATED, BLOCKED, CANCELLED, INACTIVATED - type: PHYSICAL, VIRTUAL - email: e-mail do responsável pelo cartão - productName: nome do produto do cartão - last4: últimos 4 dígitos do número do cartão Use nextPageStartKey para navegar entre páginas paginação por cursor.	email (string) status (string) type (string) productName (string) last4 (string) nextPageStartKey (string) limit (integer)
post_credit_cards_v1_by_id_block	Bloqueia um cartão corporativo pelo ID. Opcionalmente, informe o motivo do bloqueio no corpo da requisição. Importante: um cartão bloqueado pode ser desbloqueado posteriormente via endpoint de desbloqueio.	id (string) data: { . reason (string) } (object) required
post_credit_cards_v1_by_id_unblock	Desbloqueia um cartão corporativo previamente bloqueado pelo ID.	id (string)
get_categories_v1_categories	Retorna as categorias disponíveis para a empresa. Cada item pode incluir estabelecimentos vinculados e metadados de tipo por exemplo, categoria personalizada ou padrão.	No parameters
post_categories_v1_categories	Cria uma nova categoria personalizada para a empresa autenticada. O nome deve ser único entre as categorias da empresa. O contexto da empresa é obtido a partir do token de acesso.	data: { . name (string) } (object) required
get_categories_v1_categories_by_id	Retorna os dados de uma categoria da empresa pelo identificador numérico, incluindo estabelecimentos vinculados e metadados de tipo. O escopo é sempre a empresa associada ao token.	id (integer)
get_statements_v1_credit_card	Consulta o extrato de transações de cartão por período. Retorna uma lista paginada de transações com dados do cartão, categoria, centro de custo, status e anexos. Regras: - O período entre startDate e endDate não pode exceder 62 dias. - O limit deve estar entre 5 e 100 itens por página. - Use nextPageStartKey para navegar entre páginas paginação por cursor.	limit (integer) required startDate (string) required endDate (string) required types (array) cardIds (array) nextPageStartKey (string)
patch_statements_v1_credit_card_by_transaction_id	Atualiza informações editáveis de uma transação de cartão de crédito, identificada por transactionId. Use este endpoint para enriquecer despesas no seu fluxo de conciliação ou ERP — por exemplo, registrar contexto da compra, conciliar a transação ou classificá-la por categoria. Campos editáveis hoje: - notes — observação da transação máximo 1000 caracteres. Envie string vazia '' para limpar. - isConciled — marca a transação como conciliada true ou desconciliada false. - categoryId — ID numéric	transactionId (string) data: { . notes (string) . isConciled (boolean) . categoryId (integer) . costCenterId (string) } (object) required
get_attachments_v1_content_by_attachment_id	Faz o download do conteúdo binário de um anexo vinculado a uma transação. Os IDs dos anexos são retornados no array attachments de cada transação no endpoint de extrato. Formatos suportados: - image/png — Screenshots, fotos - image/jpeg — Fotos, recibos escaneados - application/pdf — Notas fiscais, documentos	attachmentId (string)
get_users_v1_users	Retorna a lista paginada de usuários da empresa, com filtro opcional por e-mail. Use nextPageStartKey para navegar entre páginas paginação por cursor.	email (string) limit (integer) nextPageStartKey (string)
get_users_v1_users_by_user_id	Retorna os dados de um usuário específico da empresa pelo userId. Use este endpoint quando você já conhece o identificador do usuário e quer consultar ou atualizar o contexto de um único usuário sem paginar a listagem completa. Regras: - O userId é o campo id retornado por GET /users/v1/users/br/api-reference/get-users-v1-users. - Retorna 404 se o usuário não pertencer à empresa autenticada.	userId (string)
delete_users_v1_users_by_user_id	Remove um usuário da empresa pelo ID. Regras: - O userId deve ser um UUID v4 válido de um usuário existente na empresa. - Não é possível excluir o usuário com perfil principal MAIN.	userId (string)
get_users_v1_roles	Retorna a lista de papéis roles da empresa, incluindo permissões associadas a cada papel. Cada papel contém informações como nome, perfil, descrição, quantidade de usuários vinculados e os grupos de permissões claims atribuídos.	No parameters
post_users_v1_invites	Envia um convite para um novo usuário se juntar à empresa. O convite é enviado para o e-mail informado com o papel role especificado. Regras: - O roleId deve ser um UUID v4 válido de um papel existente na empresa. - O email deve ser um endereço de e-mail válido. - Não é possível enviar convite para um e-mail que já possui convite pendente ou que já está vinculado à empresa.	data: { . roleId (string) . email (string) } (object) required
get_users_v1_invites	Retorna a lista paginada de convites de usuários da empresa, com filtros opcionais por status e papel role. Use nextPageStartKey para navegar entre páginas paginação por cursor.	status (string) roleId (string) limit (integer) nextPageStartKey (string)
get_statements_v1_banking	Consulta o extrato de transações bancárias da empresa com suporte a filtros e paginação por cursor. Regras: - startDate é obrigatório quando endDate é informado e vice-versa. - O limit deve estar entre 1 e 50 itens por página padrão: 20. - Use nextPageStartKey para navegar entre páginas paginação por cursor. - Os filtros de valor amountEq, amountGt, amountLt são mutuamente exclusivos.	accountId (integer) startDate (string) endDate (string) limit (integer) nextPageStartKey (string) sorting (string) hasAttachments (boolean) wasConciled (boolean) categoryIds (array) costCenterIds (array) responsibleEmail (string) status (array) amountEq (number) amountGt (number) amountLt (number)
get_cost_centers_v1_cost_centers	Use este endpoint para listar todos os centros de custo disponíveis para a empresa autenticada. O contexto da empresa é obtido automaticamente a partir do token de acesso. O uso mais comum é obter o id de um centro de custo para classificar transações via PATCH /statements/v1/credit-card/transactionId. Regras: - Retorna todos os centros de custo da empresa, sem paginação. - O campo responsible é opcional; quando ausente, o centro de custo não possui responsável vinculado.	No parameters
custom	Call any endpoint of the connected service while reusing the connection auth. Pass the full URL as _url. Other reserved keys: _method, _query, _body, _headers. Remaining params flow naturally — empty → GET, non-empty → POST JSON body.	_url (string) required _method (string) _query (object) _body (undefined) _headers (object)