Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

06 - Dívidas e Ônus Enviadas como Bens e Direitos


Nomenclatura de arquivo

Entrada de dados do sistema, o sistema recebe o arquivo JSON de uma competência específica com o seguinte padrão de nomenclatura: AAAAMM_SIGLA_SEQUENCIAL.json (ex.: 202513_CC_00001.json)

O sistema ignorará arquivos que não sigam estritamente o padrão de nomenclatura abaixo.

  • Formato: AAAAMM_CC_NNNNN.json
  • AAAAMM: Competência (Ano e Mês). Ex: 202513 (Anual).
  • CC: Sigla da Interface de Origem (2 letras maiúsculas). Ex: DP, MN.
  • NNNNN: Sequencial numérico (5 dígitos). Ex: 00001.
  • Extensão: Obrigatório ser .json.

Exemplos:

(seleção) 202513_CC_00001.json (Válido)

(seleção) 202113_CF_99999.json (Válido)

(erro) 202513_CC_1.json (Inválido - sequencial curto)

(erro) dados_importacao.json (Inválido - fora do padrão)

Inicialmente só serão aceitas competências anuais para processamento, portanto, é imprescindível que os arquivos importados estejam no formato de competência anual com os dígitos finais referentes ao mês com o valor "13", conforme exemplo acima.

JSON de exemplo

Expandir
Bloco de código
languagejs
{
  "Empresa": {
    "CodigoEmpresa": "12345",
	"SiglaInterface": "CF",
    "CompetênciaCompetencia": "202504202513",
    "ListaDeclarantes": [
      {
        "NomeCliente": "João Silva",
        "NumeroDocumentoCliente": "123.456.789-00",
        "TipoPessoa": "F",
        "Email": "[email protected]",
        "LogradouroCliente": "Av. Cliente, Bairro Cliente, Cidade Cliente - RJ",
        "CEPCliente": "87654321",
        "ListaFontePagadora": [
          {
            "NomeFontePagadora": "BancoXYZ",
            "DocumentoFontePagadora": "12.ABC.12B/0001-01",
            "ListaAgenciaConta": [
              {
                "Agencia": "0101",
                "NumeroConta": "12345678901234567890-02",
                "TipoBeneficiario": "Titular",
                "ListaRendimentosIsentos": [
                  {
                    "TipoRendimento": "12",
                    "Produto": "Rendimento Exemplo",
                    "Valor": "10000,00"
                  }
                ],
                "ListaRendimentosTributacaoExclusiva": [
                  {
                    "TipoRendimento": "06",
                    "Produto": "RDB/CDB",
                    "RendimentoBruto": "1000,00",
                    "ImpostoRetido": "150,00",
                    "Valor": "10000,00"
                  }
                ],
                "ListaBensEDireitos": [
                  {
                    "Grupo": "01",
                    "Codigo": "001111",
                    "CodigoDivida": "01",
                    "CNPJFundo": "98.765.432/0001-09",
                    "Produto": "Bem Exemplo",
                    "SaldoEmCotasCompetenciaAnterior": "1234567890,123456781234",
                    "SaldoEmCotasCompetenciaAtual": "1234567890,123456781234",
                    "SituacaoCompetênciaAnteriorSituacaoCompetenciaAnterior": "9000,00",
                    "SituacaoAtual": "12000,00"
                  }
                ],
                "ListaDividasEOnusReais": [
                  {
                    "Codigo": "6789011",
                    "Produto": "Produto Exemplo",
                    "Contrato": "1234567890123456789012",
                    "DataContratacao": "2025-03-28",
                    "SituacaoAnterior": "5000,00",
                    "SituacaoAtual": "3000,00",
                    "PrestacoesPagasPeriodo": "2000,00"
                  }
                ]
              }
            ]
          },
          {
            "NomeFontePagadora": "BancoXYZ Investimentos",
            "DocumentoFontePagadora": "12.123.12A/0001-01",
            "ListaAgenciaConta": [
              {
                "Agencia": "0103",
                "NumeroConta": "127890-02",
                "TipoBeneficiario": "Titular",
                "ListaBensEDireitos": [
                  {
                    "Grupo": "02",
                    "Codigo": "001212",
                    "CNPJFundo": "98.222.432/0001-09",
                    "Produto": "Bem Exemplo",
                    "SaldoEmCotasCompetenciaAnterior": "1234567890,123456781234",
                    "SaldoEmCotasAtual": "1234567890,123456781234",
                    "SituacaoCompetênciaAnteriorSituacaoCompetenciaAnterior": "9000,00",
                    "SituacaoAtual": "12000,00"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}



Tabela 01: 

Atributo / Tipo / TamanhoObrigatórioTipoDescriçãoObservações

CodigoEmpresa

9(006)

SimNuméricoCódigo identificador da empresa.Empresa logada

Competência

9(006)

SimNumérico (AAAAMM)Período de referência no formato AAAAMM.Para envio de arquivo anual, inserir AAAA13. Exemplo: '202513'

SiglaInterface

X(002)

SimTextoSigla da interface a ser importada

NomeCliente

X(255)

SimTextoNome completo do cliente.

NumeroDocumentoCliente

X(014)

SimTexto (CPF/CNPJ)CPF ou CNPJ do cliente.

TipoPessoa

X(001)

SimTexto (F/J)Indica se é Pessoa Física (F) ou Jurídica (J).

Email

X(050)

NãoTexto (E-mail)Endereço de e-mail do cliente.Recomendado para envio do informe

LogradouroCliente

X(255)

NãoTextoEndereço completo do cliente.

CEPCliente

X(008)

NãoNuméricoCódigo postal do cliente.

NomeFontePagadora

X(050)

SimTextoInstituição financeira que realizou pagamentos.

DocumentoFontePagadora

X(014)

SimTexto (CNPJ)CNPJ da fonte pagadora.

Agencia

X(010)

Condicional*NuméricoCódigo da agência bancária.*Obrigatório para declaráveis de Rendimentos de aplicações financeiras se houver conta

NumeroConta

X(032)

NumeroContaCondicional*Texto (Numérico)Número da conta bancária do cliente.

*Obrigatório para declaráveis de Rendimentos de aplicações financeiras se houver conta

TipoBeneficiario

X(001)

Condicional*TextoIndica se o cliente é Titular ou Dependente.*Crucial para operações em fundos. Define se é titular, dependente, etc. Pode ser obrigatório para TipoRendimento específicos

TipoRendimento

X(006)

SimTextoCódigo do tipo de rendimento isento.

Produto

X(100)

SimTextoNome do produto financeiro que gerou o rendimento.*Obrigatório condicionado ao tipo de rendimento. Se for informado um código de rendimento isento, o produto deve ser informado, caso contrário manter o campo como traço, indicando que não se aplica.

TipoRendimento

X(006)

SimTextoCódigo do tipo de rendimento tributado.

Produto

X(100)

Condicional*TextoNome do investimento ou aplicação financeira.*Obrigatório para a maioria dos TipoRendimento relacionados a investimentos (ex: 01, 06). Opcional ou não se aplica para outros (ex: 09 - JCP)*Obrigatório condicionado ao tipo de rendimento. Se for informado um código de rendimento isento, o produto deve ser informado, caso contrário manter o campo como traço, indicando que não se aplica.

RendimentoBruto

9(012)

SimRendimentoBrutoCondicional*MonetárioValor bruto antes dos impostos.*Quase sempre obrigatório Obrigatório para rendimentos tributáveis. Pode ser zero ou não se aplicar para rendimentos isentos ou de operações específicas (ex: "92"), mesmo que o valor seja 0.00 (zero).

ImpostoRetido

9(012)

ImpostoRetidoCondicional*MonetárioValor do imposto retido na fonte.*Obrigatório se houve informar a retenção de IR na fonte . Deve ser informado mesmo que o valor seja 0.00 (zero).

Grupo

X(006)

Condicional*TextoCódigo do grupo de bens e direitos.*Usado em sistemas internos para agrupar rendimentos. Normalmente opcional.

Codigo

X(006)

Condicional*TextoCódigo do bem dentro do grupo.*Código interno do produto. Normalmente opcional.

CNPJFundo

X(014)

Condicional*SimTexto (CNPJ)CNPJ do fundo vinculado ao bem.Campo condicional. Se o CNPJ do fundo for enviado os próximos campos relacionados devem ser preenchidos.

Produto

X(100)

Produto

SimTextoNome do ativo financeiro ou bem patrimonial.*Obrigatório condicionado à fundos. Se for informado um CNPJ de fundos,  o produto deve ser informado, caso contrário manter o campo como traço, indicando que não se aplica.

SaldoEmCotasCompetenciaAnterior

9(018, 004)

SimNuméricoSaldo do bem na competência anterior.*Obrigatório condicionado à fundos. Se for informado um CNPJ de fundos,  o saldo em cotas deve ser informado, mesmo zerado.

SaldoEmCotasCompetenciaAtual

9(018, 004)

SaldoEmCotasCompetenciaAtual

SimNuméricoSaldo atualizado do bem na competência atual.*Obrigatório condicionado à fundos. Se for informado um CNPJ de fundos.

SituacaoCompetênciaAnterior

9(018)

SimMonetárioValor do bem na competência anterior.*Obrigatório condicionado à fundos. Se for informado um CNPJ de fundos,  o valor deve ser informado, mesmo zerado.

SituacaoAtual

9(018)

SimMonetárioValor atualizado do bem na competência atual.*Obrigatório condicionado à fundos. Se for informado um CNPJ de fundos.

Codigo

9(006)

SimTextoCódigo do tipo de dívida.

Produto

X(100)

Produto

SimTextoNome do financiamento ou obrigação.*Obrigatório condicionado ao tipo de dívida. Se for informado um código de dívida, o produto deve ser informado, caso contrário manter o campo como traço, indicando que não se aplica.

Contrato

X(050)

Condicional*Texto (Numérico)Número do contrato vinculado à dívida.*Obrigatório para rendimentos de previdência e operações de crédito

DataContratacao

Date(008)

Condicional*Data (AAAA-MM-DD)Data da contratação do financiamento/empréstimo.*Obrigatório para alguns TipoRendimento de previdência

SituacaoAnterior

9(018)

Condicional*MonetárioValor da dívida na competência anterior.*Usado para planos de previdência.

SituacaoAtual

9(018)

Condicional*MonetárioValor atualizado da dívida na competência atual.*Usado para planos de previdência

PrestacoesPagasPeriodo

9(018, 002)

Condicional*MonetárioTotal pago no período.*Usado para planos de previdência (PGBL)

CodigoDivida

9(006)

Condicional*TextoCódigo da Dívida informada como Bem ou Direito*Usado para operações de crédito privado (ex: CRI, CRA)

...

CódigoDescrição do Bens e DireitosGrupoNº Grupo
101Prédio residencialBens Imóveis01
202Prédio comercialBens Imóveis01
303GalpãoBens Imóveis01
11ApartamentoBens Imóveis01
12CasaBens Imóveis01
13TerrenoBens Imóveis01
14Imóvel ruralBens Imóveis01
15Sala ou conjuntoBens Imóveis01
16ConstruçãoBens Imóveis01
17BenfeitoriasBens Imóveis01
18LojaBens Imóveis01
99Outros bens imóveisBens Imóveis01
101Veículo automotor terrestre (caminhão, automóvel, moto etc.)Bens Móveis02
202AeronaveBens Móveis02
303EmbarcaçãoBens Móveis02
404Bem relacionado com o exercício da atividade autônomaBens Móveis02
505Jóia, quadro, objeto de arte, de coleção, antiguidade etc.Bens Móveis02
99Outros bens móveisBens Móveis02
101Ações (inclusive as listadas em bolsa)Participações Societárias03
202Quotas ou quinhões de capitalParticipações Societárias03
99Outras participações societáriasParticipações Societárias03
101Depósito em conta poupançaAplicações e Investimentos04
202Títulos públicos e privados sujeitos à tributaçãoAplicações e Investimentos04
303Títulos isentos de tributaçãoAplicações e Investimentos04
404Ativos negociados em bolsa no Brasil (exceto ações e fundos)Aplicações e Investimentos04
505Ouro, ativo financeiroAplicações e Investimentos04
99Outras aplicações e investimentosAplicações e Investimentos04
101Empréstimos concedidosCréditos05
202Crédito decorrente de alienaçãoCréditos05
99Outros créditosCréditos05
101Depósito em conta corrente ou conta pagamentoDepósito à Vista e Numerário06
10Dinheiro em espécie - moeda nacionalDepósito à Vista e Numerário06
11Dinheiro em espécie - moeda estrangeiraDepósito à Vista e Numerário06
99Outros depósitos à vistaDepósito à Vista e Numerário06
101Fundos de Investimentos sujeitos à tributação periódicaFundos07
202Fundos de Investimento nas Cadeias Produtivas Agroindustriais (Fiagro)Fundos07
303Fundos de Investimento Imobiliário (FII)Fundos07
404Fundos de Investimento em Ações e FGTSFundos07
505Fundos de Investimento em Ações - Mercado de AcessoFundos07
606Fundos de Investimento em Participações e outrosFundos07
707Fundos de Investimento em Participações em InfraestruturaFundos07
808Fundos de Índice de Renda FixaFundos07
909Demais Fundos de Índice de Mercado (ETFs)Fundos07
10Fundos de Investimento em Direitos Creditórios (FIDC)Fundos07
11Fundos de Investimentos sem tributação periódicaFundos07
99Outros fundosFundos07
101Criptoativo Bitcoin - BTCCriptoativos08
202Outras criptomoedasCriptoativos08
303Criptoativos conhecidos como stablecoinsCriptoativos08
10Criptoativos conhecidos como NFTsCriptoativos08
99Outros criptoativosCriptoativos08
101Licença e concessão especiaisOutros Bens e Direitos99
202Título de clube e assemelhadoOutros Bens e Direitos99
303Direito de autor, de inventor e patenteOutros Bens e Direitos99
404Direito de lavra e assemelhadoOutros Bens e Direitos99
505Consórcio não contempladoOutros Bens e Direitos99
606VGBL - Vida Gerador de Benefício LivreOutros Bens e Direitos99
707Juros Sobre Capital Próprio creditado, mas não pagoOutros Bens e Direitos99
99Outros bens e direitosOutros Bens e Direitos99

...

CódigoDescrição da Dívida e Ônus Reais
11Estabelecimento bancário comercial
12Sociedades de crédito, financiamento e investimento
13Outras pessoas jurídicas
14Pessoas físicas
15Empréstimos contraídos no exterior
16Outras dívidas e ônus reais


Tabela 06: Tipo de dívida oriunda de bens e direitos.

CódigoDescrição da Dívida e Ônus Reais
01Alienação Fidejussória
02Hipotecas
03Penhor
04Leasing


99Outras (descrever no campo produto)

...