Informes CCS

Reporter permite generar archivos XML de CCS (Cadastro de Clientes do Sistema Financeiro Nacional) según lo define el Banco Central de Brasil (BACEN). Esta guía muestra cómo crear informes CCS automatizados con Reporter: ACCS001, ACCS005 y ACCS010. Combinas los datos de CRM (titulares y alias) con las estructuras de Midaz.

Antes de usar las plantillas de CCS

Los siguientes ejemplos mapean la fuente de datos reservada de CRM llamada plugin_crm. Configura esa fuente de datos antes de importar o guardar una plantilla de CCS: necesita la conexión de MongoDB de CRM y DATASOURCE_CRM_MIDAZ_ORGANIZATION_ID, que limita el alcance de los registros de CRM a una sola organización de Midaz. Sigue Reporter mediante Helm o la referencia de variables de entorno. plugin_crm se gestiona mediante el entorno. No intentes crearlo ni aplicarle PATCH mediante la API de fuentes de datos habitual. En los despliegues de un solo tenant, Manager puede sembrar la entrada y completar un ID de organización ausente o vacío al inicio; un valor persistido no vacío se conserva. Los despliegues multi-tenant omiten esa siembra y requieren su propia vía de aprovisionamiento específica del tenant. Antes de considerar lista una plantilla de CCS, impórtala o guárdala, genera un informe, confirma que los campos de CRM se descifran y verifica que la salida contenga registros solo de la organización de Midaz prevista. RPT-0075 es una verificación de alcance fail-closed: puede significar que los metadatos de la organización están ausentes o vacíos, pero también puede significar que Reporter no pudo leer el registro de fuentes de datos. Usa Solución de problemas de RPT-0075 en lugar de suponer que falta una variable de entorno.

Los informes CCS deben seguir estrictamente los formatos definidos por BACEN. Reporter permite automatizar la generación de XML, pero sigues siendo responsable de validar la salida y garantizar el cumplimiento de los requisitos regulatorios.

¿Qué es CCS?

El CCS (Cadastro de Clientes do Sistema Financeiro Nacional) es un registro que mapea las relaciones entre los clientes y las instituciones financieras. Su propósito es permitir que los reguladores y otras entidades autorizadas identifiquen dónde mantiene un cliente relaciones financieras. Las instituciones deben presentar los informes de CCS en formato XML, siguiendo los esquemas ACCS de BACEN. Cada tipo de archivo tiene una función específica: desde actualizaciones diarias hasta transferencias de relaciones. Reporter automatiza y estandariza este proceso, garantizando que las presentaciones de CCS sean técnicamente válidas y estén alineadas con el negocio.

ACCS001: archivo de actualización diaria

Qué es

El ACCS001 es el archivo de actualización diaria. Informa inclusiones, cambios o exclusiones de relaciones de clientes (personas físicas o jurídicas) con la institución. Es el archivo de CCS más frecuente, y mantiene el registro sincronizado con las operaciones diarias.

Plantilla completa

{# reporter:output-encoding=utf-16be #}<?xml version="1.0" encoding="UTF-16"?>
<CCSDOC xmlns="http://www.bcb.gov.br/ccs/ACCS001.xsd">
    <BCARQ>
        <IdentdEmissor>12345678</IdentdEmissor>
        <IdentdDestinatario>00000000</IdentdDestinatario>
        <NomArq>ACCS001</NomArq>
        <NumRemessaArq>12233444</NumRemessaArq>
    </BCARQ>
    <SISARQ>
        <CCSArqAtlzDiaria>
            <Repet_ACCS001_Pessoa>
{%- for alias in plugin_crm.aliases -%}
{%- for holder in plugin_crm.holders -%}
{%- if holder.document == alias.document %}
                <Grupo_ACCS001_Pessoa>
                    <TpOpCCS>I</TpOpCCS>
                    <QualifdrOpCCS>N</QualifdrOpCCS>
                    <TpPessoa>{%- if holder.type == "NATURAL_PERSON" -%}F{%- else -%}J{%- endif -%}</TpPessoa>
                    <CNPJ_CPFPessoa>{{holder.document}}</CNPJ_CPFPessoa>
                    <DtIni>{{alias.banking_details.opening_date}}</DtIni>
                    <DtFim></DtFim>
                </Grupo_ACCS001_Pessoa>
{%- endif -%}
{%- endfor %}
{%- endfor %}
            </Repet_ACCS001_Pessoa>
            <QtdOpCCS>{% count_by plugin_crm.aliases %}</QtdOpCCS>
            <DtMovto>{% date_time "YYYY-MM-dd" %}</DtMovto>
        </CCSArqAtlzDiaria>
    </SISARQ>
</CCSDOC>

Lógica aplicada

Los bucles anidados cruzan plugin_crm.aliases (cuentas) con plugin_crm.holders (titulares), lo que permite una asociación precisa entre los datos de las cuentas y sus respectivos titulares.

El campo <TpPessoa> es condicional:
- F para personas físicas
- J para personas jurídicas
Valores fijos en este ejemplo:
- <TpOpCCS> = I (Inclusión) Este escenario establece el campo en I. Aun así, el campo debe reflejar la operación real que informas.
  Los valores válidos según BACEN son:
  - I = Inclusión (cuentas nuevas en la base de datos de la institución)
  - A = Actualización (cambios en la información de cuentas existentes)
  - E = Exclusión (el registro original debe descartarse)
- <QualifdrOpCCS> = N (Normal) De manera similar, este campo debe representar el calificador correcto de la cuenta.
  Los valores válidos incluyen:
  - N = Normal
  - P = Popular
  - C = Conglomerado
Funciones usadas:
- count_by plugin_crm.aliases cuenta los registros de alias por cuenta.
- date_time “YYYY-MM-dd” inserta dinámicamente la fecha actual en el formato especificado.

Ejemplo renderizado

<?xml version="1.0" encoding="UTF-16"?>
<CCSDOC xmlns="http://www.bcb.gov.br/ccs/ACCS001.xsd">
    <BCARQ>
        <IdentdEmissor>12345678</IdentdEmissor>
        <IdentdDestinatario>00000000</IdentdDestinatario>
        <NomArq>ACCS001</NomArq>
        <NumRemessaArq>12233444</NumRemessaArq>
    </BCARQ>
    <SISARQ>
        <CCSArqAtlzDiaria>
            <Repet_ACCS001_Pessoa>
                <Grupo_ACCS001_Pessoa>
                    <TpOpCCS>I</TpOpCCS>
                    <QualifdrOpCCS>N</QualifdrOpCCS>
                    <TpPessoa>F</TpPessoa>
                    <CNPJ_CPFPessoa>12345678900</CNPJ_CPFPessoa>
                    <DtIni>2025-02-01</DtIni>
                    <DtFim></DtFim>
                </Grupo_ACCS001_Pessoa>
            </Repet_ACCS001_Pessoa>
            <QtdOpCCS>1</QtdOpCCS>
            <DtMovto>2025-02-01</DtMovto>
        </CCSArqAtlzDiaria>
    </SISARQ>
</CCSDOC>

ACCS005: archivo de detalle de relaciones

Qué es

Generas el ACCS005 con Reporter cuando BACEN solicita información detallada sobre las relaciones con los clientes. Enumera todos los vínculos entre un cliente y los activos financieros (BDV: Bens, Direitos e Valores). También puede incluir personas relacionadas, como socios o representantes legales.

Plantilla completa

{# reporter:output-encoding=utf-16be #}<?xml version="1.0" encoding="UTF-16"?>
<CCSDOC xmlns="http://www.bcb.gov.br/ccs/ACCS005.xsd">
    <BCARQ>
        <IdentdEmissor>12345678</IdentdEmissor>
        <IdentdDestinatario>00000001</IdentdDestinatario>
        <NomArq>ACCS005</NomArq>
        <NumRemessaArq>{% date_time "YYYYMMddHHmm" %}</NumRemessaArq>
    </BCARQ>
    <SISARQ>
        <CCSArqInfDettRelctPessoa>
            <CNPJBaseEntRespons>{{plugin_crm.holders.0.document|slice:':8'}}</CNPJBaseEntRespons>
            <NumCtrlCCSOr>000000</NumCtrlCCSOr>
            <Repet_CCS0005_BDV>
                {%- for account in midaz_onboarding.account %}
                {%- for alias in plugin_crm.aliases %}
                {%- if alias.account_id == account.id %}
                {%- for holder in plugin_crm.holders %}
                {%- if holder.document == alias.document %}
                <Grupo_CCS0005_BDV>
                    <SitInfDettPessoa></SitInfDettPessoa>
                    <Grupo_CCS0005_Part>
                        <CNPJBasePart>{{holder.document|slice:"0:8"}}</CNPJBasePart>
                        <TpBDV>{% if account.type == "deposit" %}1{% elif account.type == "savings" %}2{% elif account.type == "payment" %}3{% else %}6{% endif %}</TpBDV>
                        {%- if alias.banking_details.branch %}
                        <AgIF>{{alias.banking_details.branch}}</AgIF>
                        {%- endif %}
                        {%- if alias.banking_details.type == "CACC" %}
                        <CtCli>{{alias.banking_details.account}}</CtCli>
                        {%- elif alias.banking_details.type == "payment" %}
                        <CtPgto>{{alias.banking_details.account}}</CtPgto>
                        {%- endif %}
                        <TpVincBDV>1</TpVincBDV>
                        <NomPessoa>{{holder.name}}</NomPessoa>
                        <DtIni>{{alias.banking_details.opening_date}}</DtIni>
                        <DtFim></DtFim>
                        {%- if holder.type == "NATURAL_PERSON" and holder.natural_person %}
                        <Repet_CCS0005_Vincd>
                            <Grupo_CCS0005_Vincd>
                                <Grupo_CCS0005_PessoaVincd>
                                    <TpVinc>3</TpVinc>
                                    <CNPJ_CPFPessoaVincd>{{holder.document}}</CNPJ_CPFPessoaVincd>
                                    <NomPessoaVincd>{{holder.natural_person.mother_name}}</NomPessoaVincd>
                                    <DtIniVinc>{{alias.banking_details.opening_date}}</DtIniVinc>
                                    <DtFimVinc></DtFimVinc>
                                </Grupo_CCS0005_PessoaVincd>
                            </Grupo_CCS0005_Vincd>
                        </Repet_CCS0005_Vincd>
                        {%- endif %}
                    </Grupo_CCS0005_Part>
                </Grupo_CCS0005_BDV>
                {%- endif %}
                {%- endfor %}
                {%- endif %}
                {%- endfor %}
                {%- endfor %}
            </Repet_CCS0005_BDV>
            <DtMovto>{% date_time "YYYY-MM-dd" %}</DtMovto>
        </CCSArqInfDettRelctPessoa>
    </SISARQ>
</CCSDOC>

Lógica aplicada

La lógica aplica bucles anidados para iterar sobre cuentas, alias y titulares, lo que permite una extracción estructurada de todas las entidades relevantes.

El campo <TpBDV> usa lógica condicional para determinar el tipo de cuenta:
- 1 = depósito
- 2 = ahorro
- 3 = pago
- 6 = otros
Para la extracción del CNPJ, slice:“0:8” recupera solo los primeros 8 dígitos (base del CNPJ).
Reporter renderiza la etiqueta <Repet_CCS0005_Vincd> solo cuando el titular de la cuenta es una persona física y tiene personas asociadas (por ejemplo, un apoderado o representante legal).

El ejemplo a continuación incluye el nombre de la madre como marcador de posición para una persona vinculada. Esa etiqueta no se refiere a la madre. El ejemplo muestra la función en acción.

La función date_time genera marcas de tiempo dinámicamente en tiempo de ejecución, lo que garantiza que el informe refleje el contexto de ejecución actual.

Ejemplo renderizado

<?xml version="1.0" encoding="UTF-16"?>
<CCSDOC xmlns="http://www.bcb.gov.br/ccs/ACCS005.xsd">
    <BCARQ>
        <IdentdEmissor>12345678</IdentdEmissor>
        <IdentdDestinatario>00000001</IdentdDestinatario>
        <NomArq>ACCS005</NomArq>
        <NumRemessaArq>202502011230</NumRemessaArq>
    </BCARQ>
    <SISARQ>
        <CCSArqInfDettRelctPessoa>
            <CNPJBaseEntRespons>12345678</CNPJBaseEntRespons>
            <NumCtrlCCSOr>000000</NumCtrlCCSOr>
            <Repet_CCS0005_BDV>
                <Grupo_CCS0005_BDV>
                    <SitInfDettPessoa></SitInfDettPessoa>
                    <Grupo_CCS0005_Part>
                        <CNPJBasePart>12345678</CNPJBasePart>
                        <TpBDV>1</TpBDV>
                        <AgIF>001</AgIF>
                        <CtCli>12345-6</CtCli>
                        <TpVincBDV>1</TpVincBDV>
                        <NomPessoa>João Silva</NomPessoa>
                        <DtIni>2020-01-01</DtIni>
                        <DtFim></DtFim>
                        <Repet_CCS0005_Vincd>
                            <Grupo_CCS0005_Vincd>
                                <Grupo_CCS0005_PessoaVincd>
                                    <TpVinc>3</TpVinc>
                                    <CNPJ_CPFPessoaVincd>12345678900</CNPJ_CPFPessoaVincd>
                                    <NomPessoaVincd>Maria Silva</NomPessoaVincd>
                                    <DtIniVinc>2020-01-01</DtIniVinc>
                                    <DtFimVinc></DtFimVinc>
                                </Grupo_CCS0005_PessoaVincd>
                            </Grupo_CCS0005_Vincd>
                        </Repet_CCS0005_Vincd>
                    </Grupo_CCS0005_Part>
                </Grupo_CCS0005_BDV>
            </Repet_CCS0005_BDV>
            <DtMovto>2025-02-01</DtMovto>
        </CCSArqInfDettRelctPessoa>
    </SISARQ>
</CCSDOC>

ACCS010: archivo de transferencia de relaciones

Qué es

Generas el ACCS010 con Reporter cuando las instituciones transfieren relaciones con clientes, algo común en ventas de portafolios o fusiones. Enumera las relaciones transferidas e identifica a la nueva institución responsable.

Plantilla completa

{# reporter:output-encoding=utf-16be #}<?xml version="1.0" encoding="UTF-16"?>
<CCSDOC xmlns="http://www.bcb.gov.br/ccs/ACCS010.xsd">
    <BCARQ>
        <IdentdEmissor>12345678</IdentdEmissor>
        <IdentdDestinatario>00000000</IdentdDestinatario>
        <NomArq>ACCS010</NomArq>
        <NumRemessaArq>{% date_time "YYYYMMdd" %}0001</NumRemessaArq>
    </BCARQ>
    <SISARQ>
        <CCSArqTransRelac>
            <CNPJBaseNovRespons>12345679</CNPJBaseNovRespons>
            {%- for alias in plugin_crm.aliases %}
            {%- for holder in plugin_crm.holders %}
            {%- if alias.holder_id == holder._id and (holder.type == "LEGAL_PERSON" or holder.type == "NATURAL_PERSON") %}
            <Repet_ACCS010_Pessoa>
                <CNPJBasePart></CNPJBasePart>
                <TpPessoa>{% if holder.type == "NATURAL_PERSON" %}F{% else %}J{% endif %}</TpPessoa>
                <CNPJ_CPFPessoa>{{holder.document}}</CNPJ_CPFPessoa>
                <DtIni>{{alias.banking_details.opening_date}}</DtIni>
                <DtFim></DtFim>
            </Repet_ACCS010_Pessoa>
            {%- endif %}
            {%- endfor %}
            {%- endfor %}
            <QtdOpCCS>{% count_by plugin_crm.aliases %}</QtdOpCCS>
        </CCSArqTransRelac>
    </SISARQ>
</CCSDOC>

Lógica aplicada

Bucles duales iteran sobre los alias y los titulares.
<TpPessoa> define si el titular es persona física (F) o persona jurídica (J).
<CNPJBaseNovRespons> identifica a la nueva institución responsable.
<QtdOpCCS> usa count_by para garantizar que el número de relaciones informadas coincida con el conjunto de datos.
Las fechas (<DtIni> y <DtFim>) hacen seguimiento de la vigencia de la relación.

Ejemplo renderizado

<?xml version="1.0" encoding="UTF-16"?>
<CCSDOC xmlns="http://www.bcb.gov.br/ccs/ACCS010.xsd">
    <BCARQ>
        <IdentdEmissor>12345678</IdentdEmissor>
        <IdentdDestinatario>00000000</IdentdDestinatario>
        <NomArq>ACCS010</NomArq>
        <NumRemessaArq>202502010001</NumRemessaArq>
    </BCARQ>
    <SISARQ>
        <CCSArqTransRelac>
            <CNPJBaseNovRespons>87654321</CNPJBaseNovRespons>
            <Repet_ACCS010_Pessoa>
                <CNPJBasePart>12345678</CNPJBasePart>
                <TpPessoa>F</TpPessoa>
                <CNPJ_CPFPessoa>12345678900</CNPJ_CPFPessoa>
                <DtIni>2019-05-10</DtIni>
                <DtFim></DtFim>
            </Repet_ACCS010_Pessoa>
            <QtdOpCCS>1</QtdOpCCS>
        </CCSArqTransRelac>
    </SISARQ>
</CCSDOC>

Si bien Reporter proporciona la automatización técnica, las instituciones deben garantizar la exactitud y la consistencia de los datos presentados a BACEN. Valida siempre el XML renderizado contra el esquema oficial antes de la presentación, e involucra a los equipos de contabilidad o cumplimiento en el proceso de revisión.

Resumen

Conceptos

Guías

Integración

Console

Operaciones

Antes de usar las plantillas de CCS

¿Qué es CCS?

ACCS001: archivo de actualización diaria

Qué es

Plantilla completa

Lógica aplicada

Ejemplo renderizado

ACCS005: archivo de detalle de relaciones

Qué es

Plantilla completa

Lógica aplicada

Ejemplo renderizado

ACCS010: archivo de transferencia de relaciones

Qué es

Plantilla completa

Lógica aplicada

Ejemplo renderizado

​Antes de usar las plantillas de CCS

​¿Qué es CCS?

​ACCS001: archivo de actualización diaria

​Qué es

​Plantilla completa

​Lógica aplicada

​Ejemplo renderizado

​ACCS005: archivo de detalle de relaciones

​Qué es

​Plantilla completa

​Lógica aplicada

​Ejemplo renderizado

​ACCS010: archivo de transferencia de relaciones

​Qué es

​Plantilla completa

​Lógica aplicada

​Ejemplo renderizado

Antes de usar las plantillas de CCS

¿Qué es CCS?

ACCS001: archivo de actualización diaria

Qué es

Plantilla completa

Lógica aplicada

Ejemplo renderizado

ACCS005: archivo de detalle de relaciones

Qué es

Plantilla completa

Lógica aplicada

Ejemplo renderizado

ACCS010: archivo de transferencia de relaciones

Qué es

Plantilla completa

Lógica aplicada

Ejemplo renderizado