---
title: "Cria uma nova reivindicação."
method: POST
path: "/pix/indireto/dict/reivindicacao"
tags: ["Reivindicacao"]
---

# Cria uma nova reivindicação.

`POST /pix/indireto/dict/reivindicacao`

## Request

- Base URL: `https://example.com`
- URL: `https://example.com/pix/indireto/dict/reivindicacao`
- Auth: none required

Essa operação é feita pelo participante reivindicador a pedido do usuário final. \
O vínculo atual permanece inalterado, até que haja a confirmação pelo PSP doador. \
Nem todo tipo de chave pode ser reivindicado ou portado.

## Headers

- `api-version` string, required
- `Authorization` string, required

## Request body

- Bs2Core2PixIndiretoDictAppApisDictReivindicacaoCriarReivindicacaoCriarReivindicacao: Representa o corpo de uma requisição de criação de reivindicação.
  - `tipo` 'Posse' | 'Portabilidade': Tipo de reivindicação
  - `vinculo` Bs2Core2PixIndiretoDictAppApisCompartilhadosVinculoChavePix: Representa um vínculo entre uma chave de endereçamento do Pix no DICT, uma conta transacional e seu dono.
    - `chavePix` Bs2Core2PixIndiretoDictAppApisCompartilhadosChavePix: Representa uma chave de endereçamento Pix de um participante direto ou indireto no DICT.
      - `tipo` 'CPF' | 'CNPJ' | 'Telefone' | 'Email' | 'Aleatoria': Representa o tipo da chave Pix.
      - `chave` string, nullable: Retorna ou define a chave de endereçamento do participante.
    - `contaTransacional` Bs2Core2PixIndiretoDictAppApisCompartilhadosContaTransacionalPix: Representa uma conta transacional do Pix no DICT.
      - `ispb` string, nullable: Retorna ou define o número do Identificador de Sistema de Pagamentos Brasileiro do participante responsável da requisição.
      - `agencia` string, nullable: Retorna ou define o número da Agência, sem o dígito verificador
      - `numeroConta` string, nullable: Retorna ou define o número da Conta, incluindo o dígito verificador. Se o dígito verificador for uma letra, deve substituir por 0.
      - `tipo` 'Corrente' | 'Salario' | 'Poupanca' | 'Pagamento': Representa o tipo de conta de débito ou crédito do Pix segundo as especificações da ISO 20022.
      - `dataAbertura` string, date-time, nullable: Retorna ou define a data de abertura da conta. Para o horário, caso não seja conhecido, convenciona-se o início do dia em BRT (00:00:00).
    - `proprietario` Bs2Core2PixIndiretoDictAppApisCompartilhadosProprietario: Representa uma pessoa física ou pessoa jurídica, participante de uma conta transacional de Pix no DICT.
      - `tipo` 'PessoaFisica' | 'PessoaJuridica': Representa o tipo do dono da solicitação ou da chave de endereçamento Pix no DICT.
      - `nome` string, nullable: Retorna ou define o nome da pessoa física participante da contra transacional.
      - `documento` string, nullable: Retorna ou define o número do CPF da pessoa física participante do Pix ou o número do CNPJ da pessoa jurídica participante do Pix.
      - `nomeFantasia` string, nullable: Retorna ou define o nome fantasia da pessoa jurídica participante do Pix.

## Response `201`

Sucesso

- Bs2Core2PixIndiretoDictAppApisDictReivindicacaoCriarReivindicacaoReivindicacaoCriada: Representa as informações de uma reivindicação criada.
  - `correlationId` string, nullable: Identificador de correlação para suporte operacional.
  - `reivindicacao` Bs2Core2PixIndiretoDictAppApisCompartilhadosReivindicacao: Representando as informações da reivindicação de posse ou portabilidade da chave de vínculo
    - `tipo` 'Posse' | 'Portabilidade': Tipo de reivindicação
    - `chaveEnderecamento` string, nullable: Chave de endereçamento
    - `tipoChave` 'CPF' | 'CNPJ' | 'Telefone' | 'Email' | 'Aleatoria': Representa o tipo da chave Pix.
    - `contaSolicitante` Bs2Core2PixIndiretoDictAppApisCompartilhadosContaSolicitante: Dados de conta transacional do solicitante.
      - `ispbProvedor` string, nullable: Identificador SPB do provedor da conta
      - `agencia` string, nullable: Agência, sem dígito verificador.
      - `numeroConta` string, nullable: Número de conta, incluindo verificador. Se verificador for letra, substituir por 0.
      - `tipoConta` 'Corrente' | 'Salario' | 'Poupanca' | 'Pagamento': Representa o tipo de conta de débito ou crédito do Pix segundo as especificações da ISO 20022.
      - `dataAbertura` string, date-time: Data de abertura da conta. Para o horário, caso não seja conhecido, convenciona-se o início do dia em BRT
    - `solicitante` Bs2Core2PixIndiretoDictAppApisCompartilhadosSolicitante: Dados de pessoa física ou jurídica
      - `tipoPessoa` string, nullable: Tipo de pessoa
      - `documento` string, nullable: PF: CPF - Cadastro de Pessoa Física PJ: CNPJ - Cadastro Nacional de Pessoa Jurídica
      - `nome` string, nullable: PF: Nome completo PJ: Razão social.
      - `nomeFantasia` string, nullable: Nome fantasia.
    - `ispbDoador` string, nullable: Identificador SPB do participante que doa a chave reinvidicada.
    - `id` string, nullable: Identificador da reivindicação.
    - `status` 'Aberta' | 'AguardandoResolucao' | 'Confirmada' | 'Cancelada' | 'Completa': Status da reivindicação.
    - `fimPeriodoResolucao` string, date-time, nullable: Data-hora quando termina o período de resolução.
    - `fimPeriodoEncerramento` string, date-time, nullable: Data-hora quando termina o período de encerramento. Apenas para reivindicação de posse.
    - `ultimaModificacao` string, date-time, nullable: Data-hora da última modificação do status da reivindicação
    - `motivoSolicitacao` 'SolicitacaoUsuario' | 'FechamentoConta' | 'Fraude' | 'OperacaoPadrao' | 'Reconciliacao'
    - `motivoCancelamento` 'SolicitacaoUsuario' | 'FechamentoConta' | 'Fraude' | 'OperacaoPadrao' | 'Reconciliacao'
    - `canceladoPor` 'Doador' | 'Solicitante'

## Other responses

- `400`: Não foi possível analisar o corpo da solicitação.
- `403`: O participante não tem autorização para acessar este recurso.
- `503`: Serviço encontra-se em manutenção programada.

---

[API](https://skmtc.dev/bs2/apis/api-dict.md) - [All operations](https://skmtc.dev/bs2/apis/api-dict/llms.txt) - [OpenAPI document](https://skmtc.dev/bs2/apis/api-dict/revisions/6f6959388685?raw)