> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-api/caf-api-pt-br/conectar/available-resources/joint-resolution-6/suspected-fraud-creation.md).

# Criação de fraude suspeita

{% hint style="info" %}
**Requisitos de autenticação:**

* Os endpoints comuns usam autenticação `OAuth2` com a URL base: `https://api.us.prd.caf.io`
* Para maior segurança, alguns endpoints também podem oferecer suporte à autenticação `mTLS` com a URL base: `https://mtls.us.prd.caf.io`
* Para informações sobre como implementar `mTLS`, acesse [Usando mTLS](https://docs.caf.io/caf-api/caf-api-pt-br/conectar/authentication/using-mtls.md)
  {% endhint %}

Uma solicitação de criação de suspeita de fraude insere uma suspeita de fraude no banco de dados do seu par, e esses dados ficam disponíveis para os outros pares da rede.

{% openapi src="/files/28338081d0fcc9d493cdf67dcc6283c929f2d75b" path="/suspected-fraud" method="post" %}
[fraud.yaml](https://262277803-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbVxCOSyBojfSIE5fcpfH%2Fuploads%2Fgit-blob-d3ab2969dfa76d80af01feb928533625973ac66d%2Ffraud.yaml?alt=media)
{% endopenapi %}

## Sanitização do payload

Todas as solicitações passam por uma sanitização antes de serem validadas e armazenadas. Ela remove apenas ruídos de formatação e não altera o significado dos valores:

* espaços no início e no fim são removidos dos campos de texto, e campos de texto vazios são tratados como não enviados;
* a máscara é removida de `documento.numero`, `instituicao_responsavel.cnpj_origem` e das chaves Pix do tipo CPF ou CNPJ (`.`, `-` e `/`), então `123.456.789-09` é armazenado como `12345678909`;
* a máscara é removida das chaves Pix do tipo número de telefone (espaços, `(`, `)`, `-` e `.`), mantendo o `+`;
* os valores de CNPJ, ISPB e moeda são convertidos para maiúsculas, e as chaves Pix de e-mail e EVP, para minúsculas;
* `data_hora` é convertido para UTC, mantendo o mesmo instante e as casas fracionárias dos segundos enviados; assim, `2024-01-01T00:00:00-03:00` é armazenado como `2024-01-01T03:00:00Z`;
* objetos e listas vazios são removidos da ocorrência;
* `data_ultima_alteracao` é ignorado quando enviado, pois é calculado pela API.

## Normalização do payload

Por padrão, a ocorrência é armazenada exatamente como foi enviada. Para normalizá-la antes de armazená-la, envie o cabeçalho opcional `X-Normalize-Payload: true`.

| **Cabeçalho**         | **Obrigatório** | **Valores**     | **Padrão** |
| --------------------- | --------------- | --------------- | ---------- |
| `X-Normalize-Payload` | Opcional        | `true`, `false` | `false`    |

Somente o valor `true` ativa a normalização. Quando o cabeçalho está ausente ou contém qualquer outro valor, a solicitação é processada como `false`. O cabeçalho nunca faz com que a solicitação seja rejeitada.

Quando ativada, as seguintes alterações são aplicadas à ocorrência armazenada:

* os campos de texto livre são convertidos para maiúsculas: razão social da instituição responsável, localização, identificação e IP do dispositivo, nome e nome fantasia do titular da conta de destino, e nome e razão social do fraudador;
* `valor_transacao` e `valor_contrato` são arredondados para 2 casas decimais;
* `data_hora` é truncado para milissegundos (`YYYY-MM-DDTHH:mm:ss.000Z`);
* `documento_representante_legal` é ordenado por tipo e número.

{% hint style="info" %}
A normalização altera os valores armazenados. Por exemplo, `valor_transacao` `10.5` é armazenado como `10.50`, e `data_hora` `2024-01-01T03:00:00.123456Z` é armazenado como `2024-01-01T03:00:00.123Z`.
{% endhint %}

## Idempotência

A criação de uma suspeita de fraude é idempotente. Não é necessário enviar uma chave de idempotência: a solicitação é identificada pelo seu conteúdo após a sanitização. Solicitações que diferem apenas por espaços, máscaras ou pelo deslocamento UTC de `data_hora` são consideradas a mesma ocorrência.

* O envio da mesma ocorrência novamente retorna o resultado da primeira solicitação, com o mesmo `fraudToken`, e nenhuma nova ocorrência é criada;
* enquanto a primeira solicitação ainda está sendo processada, uma solicitação equivalente recebe `425 Too Early`. Tente novamente após o intervalo indicado pelo cabeçalho `Retry-After` ;
* o cabeçalho `X-Normalize-Payload` não faz **parte** da identidade da solicitação. Uma nova tentativa para a mesma ocorrência, com um valor diferente para o cabeçalho, retorna o resultado da primeira solicitação, e a ocorrência mantém a forma como foi armazenada por essa primeira solicitação (normalizada ou não).

{% hint style="warning" %}
Solicitações equivalentes são reconhecidas somente durante um período limitado após a primeira solicitação. Depois disso, se a mesma ocorrência for enviada novamente, ela será criada como uma nova suspeita de fraude.
{% endhint %}

## Modelo de dados da ocorrência

Como demonstrado na solicitação de exemplo, uma ocorrência de suspeita de fraude é composta pelas seguintes propriedades:

* `instituicao_responsavel`: é um **campo obrigatório** e é representado pelo esquema do objeto [da instituição responsável](#responsible-institution-object-instituicao_responsavel);
* `informacoes_bancarias_destino`: é um **campo condicional** e é representado pelo [esquema do objeto da conta bancária de destino](#destination-bank-account-object-informacoes_bancarias_destino);
* `informacao_executor`: é um campo **condicional¹** e é representado pelo esquema do objeto de informações do fraudador [esquema do objeto de informações do fraudador](#fraudster-information-object-informacao_executor);
* `informacao_reclamante`: é um campo **condicional¹** e é representado pelo esquema do objeto de informações do reclamante [esquema do objeto de informações do reclamante](#claimer-information-object-informacao_reclamante);
* `registro`: é um campo **obrigatório** e é representado pelo esquema do objeto de ocorrência [esquema do objeto de ocorrência](#occurrence-object-registro).

> **¹**: Pelo menos um dos objetos, `informacao_executor` ou `informacao_reclamante`, deve estar presente.

### Objeto da instituição responsável: `instituicao_responsavel`

Este objeto descreve a instituição financeira que envia a ocorrência. É um **objeto obrigatório**.

| Campo                 | Descrição                                                                 | Obrigatoriedade do campo | Tipo de dado | Opções | Exemplos            |
| --------------------- | ------------------------------------------------------------------------- | ------------------------ | ------------ | ------ | ------------------- |
| cnpj\_origem          | CNPJ da instituição financeira que envia as evidências de fraude.         | Obrigatório              | string       | -      | "52337497000131"    |
| razao\_social\_origem | Razão social da instituição financeira que envia as evidências de fraude. | Obrigatório              | string       | -      | "Empresa XYZ Ltda." |

### Objeto da conta bancária de destino: `informacoes_bancarias_destino`

Este objeto descreve as informações bancárias da conta de destino da ocorrência, quando aplicável. É um **objeto condicional**: se `registro.atividade_relacionada` for igual a 4, 5, 6, 7 ou 8, o objeto `informacoes_bancarias_destino` é **obrigatório**.

| Campo                                       | Descrição                                                                                                                      | Obrigatoriedade do campo                                                                                                                                                                                | Tipo de dado | Opções                                                                                                                                                  | Exemplos                                       |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
| agencia                                     | Código da agência bancária de destino. Deve conter o prefixo da agência e o dígito verificador, sem separador ou hífen.        | <p>Condicional<br>Este campo é <strong>obrigatório</strong> quando <code>chave\_pix.tipo</code> é igual a: 6</p>                                                                                        | string       | -                                                                                                                                                       | "0123"                                         |
| codigo\_instituicao                         | **Obsoleto** ISPB da instituição de destino.                                                                                   | <p>Condicional<br>Este objeto é <strong>obrigatório</strong> quando <code>ispb</code> não é informado</p>                                                                                               | inteiro      | -                                                                                                                                                       | 00000000                                       |
| ispb                                        | ISPB da instituição de destino.                                                                                                | <p>Condicional<br>Este objeto é <strong>obrigatório</strong> quando <code>codigo\_instituicao</code> não é informado</p>                                                                                | string       | -                                                                                                                                                       | "00A0Z000"                                     |
| conta                                       | Detalhes da conta bancária de destino.                                                                                         | <p>Condicional<br>Este objeto é <strong>obrigatório</strong> quando <code>registro.atividade\_relacionada</code> é igual a: 4, 5, 6, 7 ou 8;<br>Ou quando <code>chave\_pix.tipo</code> é igual a: 6</p> | objeto       | -                                                                                                                                                       | -                                              |
| conta.numero                                | Número da conta bancária de destino. Deve ser composto pelo número da conta e pelo dígito verificador, sem separador ou hífen. | Obrigatório                                                                                                                                                                                             | string       | -                                                                                                                                                       | "1234567890"                                   |
| conta.tipo                                  | Tipo de conta bancária de destino.                                                                                             | Obrigatório                                                                                                                                                                                             | inteiro      | <p>1 - Conta de depósito à vista CV (conta corrente)<br>2 - Conta de depósito de poupança CP (conta poupança)<br>3 - Conta de pagamento pré-paga PP</p> | 1                                              |
| conta.titular                               | Detalhes do titular da conta de destino.                                                                                       | <p>Condicional<br>Este campo é <strong>obrigatório</strong> quando <code>registro.atividade\_relacionada</code> é igual a: 4, 5, 6, 7 ou 8</p>                                                          | objeto       | -                                                                                                                                                       | -                                              |
| conta.titular.documento                     | Documento de identificação do titular da conta de destino.                                                                     | Opcional                                                                                                                                                                                                | objeto       | [schema](#document-object)                                                                                                                              | -                                              |
| conta.titular.nome\_completo\_razao\_social | Nome completo do titular da conta de destino.                                                                                  | Opcional                                                                                                                                                                                                | string       | -                                                                                                                                                       | "Maria Silva"                                  |
| conta.titular.nome\_fantasia                | Nome empresarial do titular da conta de destino, quando aplicável.                                                             | Opcional                                                                                                                                                                                                | string       | -                                                                                                                                                       | "Empresa XYZ"                                  |
| conta.documento\_representante\_legal       | Documentos de identificação dos representantes legais do titular da conta, quando aplicável.                                   | Opcional                                                                                                                                                                                                | array        | [schema](#document-object)                                                                                                                              | -                                              |
| chave\_pix                                  | Chave PIX da conta de destino suspeita de fraude.                                                                              | <p>Condicional<br>Este objeto é <strong>obrigatório</strong> quando <code>registro.atividade\_relacionada</code> for igual a: 7</p>                                                                     | objeto       | -                                                                                                                                                       | -                                              |
| chave\_pix.tipo                             | Tipo de chave PIX.                                                                                                             | Obrigatório                                                                                                                                                                                             | inteiro      | <p>1 - CPF<br>2 - CNPJ<br>3 - Número de telefone<br>4 - E-mail<br>5 - Aleatória<br>6 - Conta bancária</p>                                               | 4                                              |
| chave\_pix.valor                            | Valor da chave PIX.                                                                                                            | <p>Condicional<br>Este campo é <strong>obrigatório</strong> quando <code>chave\_pix.tipo</code> for diferente de: 6</p>                                                                                 | string       | -                                                                                                                                                       | "<test@mail.com>"                              |
| linha\_digitavel\_boleto                    | Linha digitável do boleto vinculada à suspeita de fraude na conta de destino.                                                  | <p>Condicional<br>Este campo é <strong>obrigatório</strong> quando <code>registro.atividade\_relacionada</code> for igual a: 9</p>                                                                      | string       | -                                                                                                                                                       | "00190500950448160698093503143373700000001000" |

### Objeto de informações sobre o fraudador: `informacao_executor`

Este objeto representa as informações do fraudador, quando disponíveis. É um **objeto condicional**: se o objeto `informacao_reclamante` não for fornecido, o objeto `informacao_executor` é **obrigatório**. Após [Operadores de apostas não autorizados GMUD | BCB 569](https://docs.caf.io/caf-api/caf-api-pt-br/conectar/available-resources/joint-resolution-6/changelog/2026/2026-12-01-gmud-unauthorized-betting-operators-bcb-569.md), este objeto é **obrigatório** quando `registro.classificacao_irregularidade` for igual a: 1.

| Campo                           | Descrição                                                                                | Obrigatoriedade do campo | Tipo de dado | Opções                     | Exemplos            |
| ------------------------------- | ---------------------------------------------------------------------------------------- | ------------------------ | ------------ | -------------------------- | ------------------- |
| nome                            | Nome completo ou razão social do fraudador.                                              | Obrigatório              | string       | -                          | "João Silva"        |
| documento                       | O documento de identificação do fraudador.                                               | Obrigatório              | objeto       | [schema](#document-object) | -                   |
| razao\_social                   | O nome empresarial do fraudador, quando aplicável.                                       | Opcional                 | string       | -                          | "Empresa XYZ Ltda." |
| documento\_representante\_legal | Os documentos de identificação dos representantes legais do fraudador, quando aplicável. | Opcional                 | array        | [schema](#document-object) | -                   |

### Objeto de informações do reclamante: `informacao_reclamante`

Este objeto representa as informações do reclamante. É um **objeto condicional**: se o objeto `informacao_executor` não for fornecido, o objeto `informacao_reclamante` será **obrigatório**.

| Campo                           | Descrição                                                                                 | Obrigatoriedade do campo | Tipo de dado | Opções                     | Exemplos |
| ------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------ | ------------ | -------------------------- | -------- |
| documento                       | O documento de identificação do reclamante.                                               | Obrigatório              | objeto       | [schema](#document-object) | -        |
| documento\_representante\_legal | Os documentos de identificação dos representantes legais do reclamante, quando aplicável. | Opcional                 | array        | [schema](#document-object) | -        |

### Objeto de ocorrência: `registro`

Este objeto descreve os dados gerais da ocorrência. É um **objeto obrigatório**.

| Campo                         | Descrição                                                                                                                                                         | Obrigatoriedade do campo                                                                                                                                                                    | Tipo de dado | Opções                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Exemplos                                                           |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| data\_hora                    | Data e hora no formato ISO "YYYY:MM::DDThh:mm:ss.sTZD" que indica a ocorrência da tentativa suspeita de fraude.                                                   | Obrigatório                                                                                                                                                                                 | string       | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | "2024-04-03T12:00:00Z"                                             |
| atividade\_relacionada        | Atividade relacionada à ocorrência ou à tentativa de fraude, conforme a lista.                                                                                    | Obrigatório                                                                                                                                                                                 | inteiro      | <p>1 - Abertura de conta de depósito ou conta de pagamento<br>2 - Manutenção de conta de depósito ou conta de pagamento<br>3 - Contratação de operação de crédito<br>4 - Transferências entre contas na mesma instituição<br>5 - Transferência Eletrônica Disponível (TED)<br>6 - Transações de pagamento com cheques<br>7 - Transações de pagamento instantâneo (Pix)<br>8 - Transferências por meio de Documento de Crédito (DOC)<br>9 - Boletos de pagamento<br>10 - Saques em dinheiro<br>11 - Prestação de serviços de ativos virtuais</p> | 5                                                                  |
| classificacao                 | Classificação da ocorrência.                                                                                                                                      | Obrigatório                                                                                                                                                                                 | inteiro      | <p>1 - Fraude confirmada<br>2 - Suspeita de fraude<br>3 - Irregularidade</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 1                                                                  |
| classificacao\_irregularidade | Classificação do tipo de irregularidade.                                                                                                                          | <p>Condicional<br>Este campo é <strong>obrigatório</strong> e <strong>exclusivo</strong> quando <code>registro.classificacao</code> for igual a: 3</p>                                      | inteiro      | 1 - Atuação como operador de apostas não autorizado                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 1                                                                  |
| envolvimento\_reclamante      | Indica se houve envolvimento do cliente na ocorrência ou na tentativa de fraude. O envolvimento do cliente independe de ter sido causado por terceiros ou não.    | Obrigatório                                                                                                                                                                                 | inteiro      | <p>1 - Sim<br>2 - Não</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 1                                                                  |
| valor\_transacao              | Se a indicação de fraude for uma operação de pagamento, informe o valor da transação.                                                                             | <p>Condicional<br>Este campo é <strong>obrigatório</strong> quando <code>registro.atividade\_relacionada</code> é igual a: 4, 5, 6, 7, 8, 9, 10 ou 11</p>                                   | número       | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 1000.00                                                            |
| valor\_contrato               | Se a indicação de fraude for uma operação de crédito, informe o valor do contrato.                                                                                | <p>Condicional<br>Este campo é <strong>obrigatório</strong> quando <code>registro.atividade\_relacionada</code> é igual a: 3</p>                                                            | número       | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 5000.00                                                            |
| canal                         | Forma ou canal de interação utilizado para a execução da ocorrência ou da tentativa de fraude.                                                                    | Opcional                                                                                                                                                                                    | inteiro      | <p>1 - Internet<br>2 - Dispositivo móvel<br>3 - Autoatendimento<br>4 - Rede de parceiros<br>5 - Redes sociais<br>6 - Interbancário<br>7 - Outros</p>                                                                                                                                                                                                                                                                                                                                                                                            | 3                                                                  |
| local                         | Local onde a atividade foi realizada, quando aplicável.                                                                                                           | Opcional                                                                                                                                                                                    | string       | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | "Agência X"                                                        |
| motivo                        | Descrição da causa ou do procedimento que levou à ocorrência ou à tentativa de fraude, quando aplicável.                                                          | <p>Condicional<br>Este campo é <strong>obrigatório</strong> quando <code>registro.modalidade\_fraude</code> é igual a: 98 ou 99;<br>ou <code>registro.classificacao</code> é igual a: 3</p> | string       | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | "Cobrança indevida"                                                |
| modalidade\_fraude            | Modalidade relacionada à ocorrência ou à tentativa de fraude, conforme a lista.                                                                                   | <p>Obrigatório<br>Este campo é <strong>obrigatório</strong> quando <code>registro.classificacao</code> é diferente de: 3</p>                                                                | inteiro      | <p>1 - Fraude própria<br>2 - Conta de passagem<br>3 - Roubo de identidade (ITO)<br>4 - Identidade sintética<br>5 - Tomada de controle da conta (ATO)<br>6 - Fraude amigável/familiar/de terceiros próximos<br>7 - Fraude do comprador<br>8 - Fraude do vendedor<br>9 - Troca de chip (SIM swap)<br>10 - Fraude com boletos adulterados<br>11 - Fraude em benefícios<br>12 - Sequestro ou extorsão<br>98 - Inconclusiva<br>99 - Modalidade não listada</p>                                                                                       | 5                                                                  |
| dispositivo                   | Informações sobre o dispositivo utilizado.                                                                                                                        | Opcional                                                                                                                                                                                    | objeto       | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | -                                                                  |
| dispositivo.identificacao     | Identificação do dispositivo utilizado na execução da ocorrência ou da tentativa de fraude.                                                                       | Opcional                                                                                                                                                                                    | string       | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | "ID-1234"                                                          |
| dispositivo.ip                | Descrição das informações relativas ao endereço de Protocolo de Internet (IP) do dispositivo utilizado na ocorrência ou na tentativa de fraude, quando aplicável. | Opcional                                                                                                                                                                                    | string       | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | "192.168.0.1"                                                      |
| operadora\_aposta\_dominio    | Domínio/URL relacionado à operadora de apostas irregular                                                                                                          | <p>Condicional<br>Este campo é <strong>opcional</strong> e <strong>exclusivo</strong> quando <code>registro.classificacao\_irregularidade</code> é igual a: 1</p>                           | string       | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | "irregular-bet.com"                                                |
| ativo\_virtual                | Informações sobre o ativo virtual.                                                                                                                                | <p>Condicional<br>Este campo é <strong>obrigatório</strong> quando <code>registro.atividade\_relacionada</code> é igual a: 11</p>                                                           | objeto       | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | -                                                                  |
| ativo\_virtual.tipo\_operacao | Classifica a natureza da operação informada.                                                                                                                      | Obrigatório                                                                                                                                                                                 | inteiro      | <p>1 - Compra<br>2 - Venda<br>3 - Transferência / saque para carteira externa<br>4 - Recebimento de carteira externa<br>5 - Transferência interna entre clientes<br>6 - Conversão entre ativos virtuais<br>7 - Depósito<br>99 - Outro</p>                                                                                                                                                                                                                                                                                                       | 1                                                                  |
| ativo\_virtual.moeda          | Símbolo da moeda do ativo virtual movimentado.                                                                                                                    | Obrigatório                                                                                                                                                                                 | string       | <p>Expressão regular: <code>^\[A-Z0-9]{1,10}$</code><br>Também deve corresponder a um símbolo canônico de ativo virtual (por exemplo, BTC, ETH, LTC, DOGE).</p>                                                                                                                                                                                                                                                                                                                                                                                 | "BTC"                                                              |
| ativo\_virtual.quantidade     | Quantidade do ativo virtual associado à indicação de fraude.                                                                                                      | Obrigatório                                                                                                                                                                                 | string       | Expressão regular: `^\d+[.,]\d+$`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | "0,00000001"                                                       |
| ativo\_virtual.transacao\_id  | Identificador único da transação (hash).                                                                                                                          | Opcional                                                                                                                                                                                    | string       | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | "1843b174549cfbe3f6ba979df44c5b1b4632876b6aa99b1a51057c79219b2fd8" |

#### Relação entre modalidade de fraude e atividade relacionada

O `registro.modalidade_fraude` tem uma relação de dependência com `registro.atividade_relacionada`. As relações na tabela abaixo são permitidas; qualquer relação fora da tabela é inválida. Além disso, `registro.modalidade_fraude` é **bloqueado** quando `registro.classificacao` é igual a: 3.

| **atividade\_relacionada** | **modalidade\_fraude**                    |
| -------------------------- | ----------------------------------------- |
| **1**                      | 1, 2, 3, 4, 6, 9, 11, 12, 98, 99          |
| **2**                      | 1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 98, 99 |
| **3**                      | 1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 98, 99 |
| **4**                      | 1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 98, 99 |
| **5**                      | 1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 98, 99 |
| **6**                      | 1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 98, 99 |
| **7**                      | 1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 98, 99 |
| **8**                      | 1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 98, 99 |
| **9**                      | Tudo                                      |
| **10**                     | 1, 2, 3, 4, 5, 6, 9, 11, 12, 98, 99       |
| **11**                     | 1, 2, 3, 4, 5, 6, 7, 8, 12, 98, 99        |

Outra relação presente no esquema foi introduzida por [GMUD Operadores de Apostas Não Autorizados | BCB 569](https://docs.caf.io/caf-api/caf-api-pt-br/conectar/available-resources/joint-resolution-6/changelog/2026/2026-12-01-gmud-unauthorized-betting-operators-bcb-569.md), limitando os valores disponíveis de `registro.atividade_relacionada` quando `registro.classificacao_irregularidade` é igual a: 1. Os valores disponíveis são: 4, 5, 6, 7, 8, 9 e 10.

### Objeto de documento

Este objeto representa um documento de identificação, que pode ser de uma pessoa física ou jurídica. Essa representação do objeto é usada pelo [Objeto de informações do reclamante](#claimer-information-object-informacao_reclamante), [Objeto de informações do fraudador](#fraudster-information-object-informacao_executor), e pelo [Objeto de conta bancária de destino](#destination-bank-account-object-informacoes_bancarias_destino).

| Campo  | Descrição                                                                                                                                                                | Obrigatoriedade do campo | Tipo de dado | Opções                     | Exemplos      |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------ | ------------ | -------------------------- | ------------- |
| tipo   | Indica se é uma pessoa física ou jurídica.                                                                                                                               | Obrigatório              | inteiro      | <p>1 - CPF<br>2 - CNPJ</p> | 1             |
| número | Se o tipo de documento for "1", este atributo deve conter o CPF. Se for uma pessoa jurídica ("2"), deve conter o CNPJ completo. Atributo numérico, sem zeros à esquerda. | Obrigatório              | string       | -                          | "81321273070" |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.caf.io/caf-api/caf-api-pt-br/conectar/available-resources/joint-resolution-6/suspected-fraud-creation.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
