Skip to main content
Superlógica Assinaturas is a subscription management platform that helps businesses manage their recurring revenue, customer subscriptions, and billing processes. It provides tools for managing clients, subscriptions, and recurring payments.

Configuring Superlógica Assinaturas as a Source

In the Sources tab, click on the “Add source” button located on the top right of your screen. Then, select the Superlógica Assinaturas option from the list of connectors. Click Next and you’ll be prompted to add your access.

1. Add account access

You’ll need to provide the following credentials to connect to Superlógica Assinaturas:
  • App Token: The app token from Superlógica.
  • Access Token: The access token from Superlógica.
If you don’t know how to generate the tokens, please check this documentation.
The tokens are valid for 1 year, after that to continue using the APIs a new one must be generated.

2. Select streams

Choose which data streams you want to sync - you can select all streams or pick specific ones that matter most to you.
Tip: The stream can be found more easily by typing its name.
Select the streams and click Next.

3. Configure data streams

Customize how you want your data to appear in your catalog. Select a name for each table (which will contain the fetched data) and the type of sync.
  • Table name: we suggest a name, but feel free to customize it. You have the option to add a prefix and make this process faster!
  • Sync Type: you can choose between INCREMENTAL and FULL_TABLE.
    • Incremental: every time the extraction happens, we’ll get only the new data - which is good if, for example, you want to keep every record ever fetched.
    • Full table: every time the extraction happens, we’ll get the current state of the data - which is good if, for example, you don’t want to have deleted data in your catalog.
Once you are done configuring, click Next.

4. Configure data source

Describe your data source for easy identification within your organization, not exceeding 140 characters. To define your Trigger, consider how often you want data to be extracted from this source. This decision usually depends on how frequently you need the new table data updated (every day, once a week, or only at specific times). Optionally, you can determine when to execute a full sync. This will complement the incremental data extractions, ensuring that your data is completely synchronized with your source every once in a while. Once you are ready, click Next to finalize the setup.

5. Check your new source

You can view your new source on the Sources page. If needed, manually trigger the source extraction by clicking on the arrow button. Once executed, your data will appear in your Catalog.
For you to be able to see it on your Catalog, you need at least one successful source run.

Streams and Fields

Below you’ll find all available data streams from Superlógica Assinaturas and their corresponding fields:
Stream for managing client information.Key Fields:
  • id_sacado_sac - Payer ID (Primary Key)
  • st_nome_sac - Client name
  • st_nomeref_sac - Reference name
  • st_cgc_sac - Client CPF/CNPJ
  • st_email_sac - Client email
  • st_telefone_sac - Client phone
Address Information:
  • st_endereco_sac - Client address
  • st_complemento_sac - Address complement
  • st_cidade_sac - Client city
  • st_estado_sac - Client state
  • st_cep_sac - Client ZIP code
  • st_bairro_sac - Neighborhood
  • st_pais_sac - Country
  • st_paisentrega_sac - Delivery country
  • st_numero_sac - Number
Registration Information:
  • st_inscricao_sac - State registration
  • st_inscmunicipal_sac - Municipal registration
  • dt_cadastro_sac - Registration date
  • dt_alteracao_sincro - Modification date
  • fl_desativar_sac - Deactivate flag
  • fl_status_sac - Client status
  • dt_desativacao_sac - Deactivation date
Personal Information:
  • st_sexo_sac - Gender
  • st_nacionalidade_sac - Nationality
  • dt_nascimento_sac - Birth date
  • st_naturalidade_sac - Place of birth
  • st_carteiraidentidade_sac - Identity card
  • dt_emissaocarteira_sac - ID card issue date
  • st_orgao_sac - Issuing agency
  • fl_pessoajuridica_sac - Legal entity flag
  • fl_entidadepublica_sac - Public entity flag
Contact Information:
  • st_celular_sac - Mobile phone
  • st_fax_sac - Fax number
  • tx_observacao_sac - Observations
  • tx_contatos_sac - Contacts
Financial Information:
  • st_diavencimento_sac - Due day
  • vl_txpis_sac - PIS tax
  • vl_txinss_sac - INSS tax
  • vl_txirrf_sac - IRRF tax
  • vl_txcontribuicaosocial_sac - Social contribution tax
  • vl_txcofins_sac - COFINS tax
  • vl_txissqn_sac - ISSQN tax
  • vl_txdesconto_sac - Discount tax
Tax Withholding Flags:
  • fl_reterissqn_sac - Withhold ISSQN
  • fl_reterpis_sac - Withhold PIS
  • fl_reterinss_sac - Withhold INSS
  • fl_reterirrf_sac - Withhold IRRF
  • fl_retercontribuicaosocial_sac - Withhold social contribution
  • fl_retercofins_sac - Withhold COFINS
Additional Information:
  • st_contrato_sac - Contract
  • st_sincro_sac - Synchronization
  • st_codemp_sac - Company code
  • st_senha_sac - Password
  • campo1 - Custom field 1
  • campo2 - Custom field 2
  • campo3 - Custom field 3
  • campo4 - Custom field 4
  • id_grupo_grp - Group ID
  • st_sacadornome_sac - Drawer name
  • st_sacadorcgc_sac - Drawer CGC
  • st_sincroorder_sac - Synchronization order
Calculated Fields:
  • nome_cliente - Client name (calculated)
  • nome_formatado - Formatted name (calculated)
  • st_nomestatus_sac - Name and status (calculated)
Stream for managing subscription and recurring payment information.Client Information:
  • id_sacado_sac - Client ID
  • st_nome_sac - Client name
  • st_nomeref_sac - Client reference name
  • st_endereco_sac - Client address
  • st_complemento_sac - Address complement
  • st_bairro_sac - Neighborhood
  • st_cidade_sac - City
  • st_estado_sac - State
  • st_cep_sac - ZIP code
  • st_rg_sac - RG document
  • st_cgc_sac - CPF/CNPJ document
  • st_ddd_sac - Area code
  • st_telefone_sac - Phone number
  • st_email_sac - Email address
  • fl_status_sac - Client status
Contract Information:
  • st_identificador_plc - Client plan identifier
  • st_identificadorextra_plc - Extra identifier
  • id_planocliente_plc - Client plan ID (Primary Key)
  • dt_contrato_plc - Contract date
  • dt_cancelamento_plc - Cancellation date
  • fl_trial_plc - Trial flag
  • dt_trialinicio_plc - Trial start date
  • dt_trialfim_plc - Trial end date
  • fl_autocontratar_plc - Auto contract flag
  • fl_autorecontratar_plc - Auto renew flag
  • fl_primeiropag_plc - First payment flag
  • dt_primeiropag_plc - First payment date
Plan Information:
  • id_plano_pla - Plan ID
  • st_nome_pla - Plan name
  • id_grade_gpl - Grade ID
  • nm_contratofim_pla - Contract end number
  • fl_autorecontratar_pla - Auto renew plan flag
  • fl_autocontratar_pla - Auto contract plan flag
  • nm_parcelas_pla - Number of installments
  • st_nome_gpl - Grade name
Monthly Fee Information:
  • id_mensalidade_mens - Monthly fee ID
  • id_cliente_mens - Monthly fee client ID
  • id_empresa_mens - Company ID
  • st_descricao_mens - Monthly fee description
  • st_valor_mens - Monthly fee value
  • st_qntd_mens - Monthly fee quantity
  • dt_atualizacao_mens - Update date
  • dt_inicio_mens - Monthly fee start date
  • dt_fim_mens - Monthly fee end date
  • nm_diavencimento_mens - Monthly fee due day
Monthly Flags:
  • fl_jan_mens - January flag
  • fl_fev_mens - February flag
  • fl_mar_mens - March flag
  • fl_abr_mens - April flag
  • fl_mai_mens - May flag
  • fl_jun_mens - June flag
  • fl_jul_mens - July flag
  • fl_ago_mens - August flag
  • fl_set_mens - September flag
  • fl_out_mens - October flag
  • fl_nov_mens - November flag
  • fl_dez_mens - December flag
Financial Information:
  • vl_aproxrenovacao_plc - Approximate renewal value
  • vl_descontorenovacao_plc - Renewal discount value
  • vl_txjuros_mens - Interest tax value
  • vl_txmulta_mens - Fine tax value
  • vl_txdesconto_mens - Discount tax value
Additional Information:
  • st_emailindicacao_plc - Referral email
  • id_vendedor_for - Seller ID
  • nm_parcelasadesao_plc - Adhesion installments number
  • dt_ultimarenovacao_recb - Last renewal date
  • id_proximarenovacao_recb - Next renewal ID
  • id_ticket_tic - Ticket ID
  • st_nome_cup - Coupon name
  • st_frete_plc - Shipping
  • id_produto_prd - Product ID
  • id_conta_cb - Account ID
  • id_filial_fil - Branch ID
  • id_vendedor_mens - Seller ID monthly
  • id_endereco_sen - Address ID
Aggregated Data:
  • quantidade - Quantity
  • total - Total amount
  • mrr - Monthly Recurring Revenue
  • ultimo_fim - Last end date
Calculated Fields:
  • nome_formatado - Formatted name (calculated field)

Data Model

The following diagram illustrates the relationships between the core data streams in Superlógica Assinaturas. The arrows indicate the join keys that link the different entities.