Á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

JSON de exemplo


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
Expandir
Bloco de código
languagejs
{
  "Empresa": {
    "CodigoEmpresa": "12345",
	"SiglaInterface": "CF",
    "Competência": "202504",
    "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",
    "Competencia": "202513",
    "ListaFontePagadoraListaDeclarantes": [
          {
            "NomeFontePagadoraNomeCliente": "BancoXYZJoão Silva",
            "DocumentoFontePagadora": "12.ABC.12B/0001-01"NumeroDocumentoCliente": "123.456.789-00",
            "ListaAgenciaContaTipoPessoa": ["F",
        "Email": "[email protected]",
        {
        "LogradouroCliente": "Av. Cliente, Bairro Cliente, Cidade Cliente - RJ",
        "AgenciaCEPCliente": "010187654321",
        "ListaFontePagadora": [
        "NumeroConta  {
            "NomeFontePagadora": "12345678901234567890-02BancoXYZ",
                "TipoBeneficiarioDocumentoFontePagadora": "Titular12.ABC.12B/0001-01",
                "ListaRendimentosIsentosListaAgenciaConta": [
                  {
                    "TipoRendimentoAgencia": "120101",
                    "ProdutoNumeroConta": "Rendimento Exemplo12345678901234567890-02",
                    "ValorTipoBeneficiario": "Titular"10000,00"
                  }
                ],
                "ListaRendimentosTributacaoExclusiva"ListaRendimentosIsentos": [
                  {
                    "TipoRendimento": "0612",
                    "Produto": "RDB/CDBRendimento Exemplo",
                    "RendimentoBrutoValor": "100010000,00",
                  }
   "ImpostoRetido": "150,00",
            ],
        "Valor": "10000,00"
       "ListaRendimentosTributacaoExclusiva": [
          }
        {
        ],
                "ListaBensEDireitosTipoRendimento": ["06",
                  {  "Produto": "RDB/CDB",
                    "GrupoRendimentoBruto": "011000,00",
                    "CodigoImpostoRetido": "0011150,00",
                    "CodigoDividaValor": "0110000,00",
                     "CNPJFundo": "98.765.432/0001-09",
     }
               "Produto": "Bem Exemplo" ],
                    "SaldoEmCotasCompetenciaAnteriorListaBensEDireitos": "1234567890,12345678",[
                    "SaldoEmCotasCompetenciaAtual": "1234567890,12345678",{
                    "SituacaoCompetênciaAnteriorGrupo": "9000,0001",
                    "SituacaoAtualCodigo": "1200011",00"
                  }
  "CodigoDivida": "01",
                      ]"CNPJFundo": "98.765.432/0001-09",
                    "ListaDividasEOnusReaisProduto": ["Bem Exemplo",
                  {  "SaldoEmCotasCompetenciaAnterior": "1234567890,1234",
                    "CodigoSaldoEmCotasCompetenciaAtual": "678901234567890,1234",
                    "ProdutoSituacaoCompetenciaAnterior": "Produto Exemplo9000,00",
                    "ContratoSituacaoAtual": "123456789012345678901212000,00",
                  }
   "DataContratacao": "2025-03-28",
             ],
                "SituacaoAnteriorListaDividasEOnusReais": "5000,00",[
                    "SituacaoAtual": "3000,00",{
                    "PrestacoesPagasPeriodoCodigo": "200011",00"
                  }
     "Produto": "Produto Exemplo",
             ]
       "Contrato": "1234567890123456789012",
      }
            ]
          },
  "DataContratacao": "2025-03-28",
        {
            "NomeFontePagadoraSituacaoAnterior": "BancoXYZ Investimentos5000,00",
            "DocumentoFontePagadora        "SituacaoAtual": "12.123.12A/0001-013000,00",
                    "ListaAgenciaContaPrestacoesPagasPeriodo": ["2000,00"
              {
    }
            "Agencia": "0103",
   ]
             "NumeroConta": "127890-02", }
            ]
    "TipoBeneficiario": "Titular",
     },
          {
 "ListaBensEDireitos": [
          "NomeFontePagadora": "BancoXYZ Investimentos",
      {
      "DocumentoFontePagadora": "12.123.12A/0001-01",
             "GrupoListaAgenciaConta": "02",
[
              {
                "CodigoAgencia": "00120103",
                    "CNPJFundoNumeroConta": "98.222.432/0001-09127890-02",
                    "ProdutoTipoBeneficiario": "Bem ExemploTitular",
                    "SaldoEmCotasCompetenciaAnteriorListaBensEDireitos": "1234567890,12345678",[
                    "SaldoEmCotasAtual": "1234567890,12345678",{
                    "SituacaoCompetênciaAnteriorGrupo": "9000,0002",
                    "SituacaoAtualCodigo": "12"12000,00"
                    } "CNPJFundo": "98.222.432/0001-09",
                ]    "Produto": "Bem Exemplo",
              }      "SaldoEmCotasCompetenciaAnterior": "1234567890,1234",
            ]
        "SaldoEmCotasAtual":  }
        ]
      }
    ]
  }
}

Tabela 01: 

"1234567890,1234",
                    "SituacaoCompetenciaAnterior": "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)

Condicional*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)

AtributoObrigatórioTipoDescriçãoObservações
CodigoEmpresaSimNuméricoCódigo identificador da empresa.Empresa logada
CompetênciaSimNumérico (AAAAMM)Período de referência no formato AAAAMM.Para envio de arquivo anual, inserir AAAA13. Exemplo: '202513'
SiglaInterfaceSimTextoSigla da interface a ser importada
NomeClienteSimTextoNome completo do cliente.NumeroDocumentoClienteSimTexto (CPF/CNPJ)CPF ou CNPJ do cliente.TipoPessoaSimTexto (F/J)Indica se é Pessoa Física (F) ou Jurídica (J).EmailSimTexto (E-mail)Endereço de e-mail do cliente.LogradouroClienteSimTextoEndereço completo do cliente.CEPClienteSimNuméricoCódigo postal do cliente.NomeFontePagadoraSimTextoInstituição financeira que realizou pagamentos.DocumentoFontePagadoraSimTexto (CNPJ)CNPJ da fonte pagadora.AgenciaSimNuméricoCódigo da agência bancária.NumeroContaSimTexto (Numérico)Número da conta bancária do cliente.TipoBeneficiarioSimTextoIndica se o cliente é Titular ou Dependente.TipoRendimento

SimTextoCódigo do tipo de rendimento isentotributado.

Produto

X(100)

Condicional*SimTextoNome do produto financeiro que gerou o rendimento.TipoRendimentoSimTextoinvestimento ou aplicação financeira.*Obrigatório condicionado ao Código do tipo de rendimento tributado.ProdutoSimTextoNome do investimento ou aplicação financeira.. 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)

RendimentoBruto

SimMonetárioValor bruto antes dos impostos.*Obrigatório para rendimentos tributáveis, mesmo que o valor seja 0.00 (zero).

ImpostoRetido

9(012)

Condicional*ImpostoRetidoSimMonetárioValor do imposto retido na fonteretido na fonte.*Obrigatório informar a retenção de IR na fonte mesmo que o valor seja 0.00 (zero).

Grupo

X(006)

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

Codigo

X(006)

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

CNPJFundo

X(014)

Condicional*CNPJFundoSimTexto (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)

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)

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*ContratoSimTexto (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*SimData (AAAA-MM-DD)Data da contratação do financiamento/empréstimo.*Obrigatório para alguns TipoRendimento de previdência

SituacaoAnterior

9(018)

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

SituacaoAtual

9(018)

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

PrestacoesPagasPeriodo

9(018, 002)

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

CodigoDivida

9(006)

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




tabela 02:

CódigoDescrição do Rendimento Isento
01Bolsas de estudo e de pesquisa caracterizadas como doação, exceto médico-residente ou Pronatec
02Bolsas de estudo e pesquisa para médico-residente e participantes do Pronatec
03Capital das apólices de seguro e pecúlio de previdência privada
04Indenizações por rescisão de contrato de trabalho, PDV e FGTS
05Lucro na alienação de bens de pequeno valor
06Lucro na alienação do único imóvel
07Lucro na alienação de outros bens imóveis
08Lucro na alienação de moeda estrangeira em espécie
09Lucros e dividendos recebidos
10Parcela isenta de aposentadoria de maior de 65 anos
11Pensão, aposentadoria ou reforma por doença grave ou por acidente
12Rendimentos de poupanças, letras hipotecárias, LCI, LCA, CRI, CRA
13Rendimentos de sócio de ME ou optante pelo Simples, exceto pró-labore
14Transferências patrimoniais – doações e heranças
16Imposto de anos anteriores compensado judicialmente
1775% dos rendimentos em moeda estrangeira de servidores do Governo
18Incorporação de reservas ao capital/Bonificações em ações
19Transferências patrimoniais – meação e divórcio
20Ganhos líquidos de ações até R$ 20.000,00
21Ganhos líquidos com ouro até R$ 20.000,00
23Rendimento bruto, transporte de carga (máx. 90%)
24Rendimento bruto, transporte de passageiros (máx. 40%)
25Restituição de imposto sobre a renda de anos-calendário anteriores
26Outros

...

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)


Exemplos de onde as Informações devem ser enviadas:


Para todos os exemplos abaixo, em caso de dúvidas, procurar o FAQ da Receita Federal.

...

9 - Bitcoin (somente compra)


Rendimentos Isentos e Não Tributáveis

1. Poupança: Informar o valor dos Rendimentos no mês/ano
Tipo de Rendimento: 12

...

Observação: Usar a mesma descrição para declarar este item em Bens e Direitos


Rendimentos Sujeitos a Tributação Exclusiva

3. CDB/RDB: Informar Rendimento Bruto e Imposto Retido
Tipo de Rendimento: 06

...

Observação: Usar a mesma descrição para declarar este item em Bens e Direitos


Bens e Direitos

1. Poupança: informar o saldo (anterior e atual)
Grupo 04 
Código 01

...

Observação: Ver as regras para o caso de venda de Critpmoedas.

Dívidas e Ônus Reais

5. Empréstimo Pessoal
Código 11

...