Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
CIP – R2C3
rtm.net.br
Relações com cliente: (21/11) 2102-7828 • NOC: 0800 704-1021
SÃO PAULO: Rua Libero Badaró, 377 • 11º e 22° andares • Centro • CEP 01009-000 • Tel.: (11) 2102-7860 • Fax.: (11) 2102-7878
RIO DE JANEIRO: Av. República do Chile, 230 • 7º andar • Centro • CEP 20031-170 • Tel.: (21) 2102-7860 • Fax.: (21) 2102-7840
Índice
Índice ............................................................................................................................................. 2
Versionamento .............................................................................................................................. 5
1. Objetivo ................................................................................................................................. 6
2. Autenticação ......................................................................................................................... 6
3. Paginação .............................................................................................................................. 6
4. Integrações ............................................................................................................................ 7
4.1 Agenda .......................................................................................................................... 7
4.1.1 Agenda - Consulta de retorno ....................................................................................... 7
4.1.2 Agenda - Consulta de unidades recebíveis.................................................................... 7
4.2 Baixa de recebíveis ........................................................................................................ 8
4.2.1 Baixa de recebíveis – Consulta de retorno .................................................................... 8
4.3 Opt-In ............................................................................................................................ 8
4.3.1 Notificação de Opt-In .................................................................................................... 9
4.4 Opt-Out ......................................................................................................................... 9
4.4.1 Notificação de Opt-Out ................................................................................................. 9
4.5 Contestação................................................................................................................. 10
4.5.1 Atualização de contestação......................................................................................... 10
4.6 Resumo de operações ................................................................................................. 10
4.7 Janela de negociações ................................................................................................. 11
4.8 Participantes................................................................................................................ 11
4.9 Operações ................................................................................................................... 12
4.10 Cancelamento de operações ....................................................................................... 12
4.11 Registro de operações para Credenciadora ................................................................ 12
4.11.1 Registro de operações para financiadora ................................................................... 13
4.11.2 Consulta de unidades recebíveis para financiadora ................................................... 13
4.11.3 Atualizar operação unidades recebíveis para financiadora ........................................ 13
4.11.4 Registro de operações - Resultado.............................................................................. 14
4.11.5 Registro de operações – Id de conjunto para UR para credenciadoras. ..................... 14
4.11.6 Registro de operações – Incluir lote de UR para credenciadoras ............................... 14
4.11.7 Registro de operações – Id de conjunto para UR para financiadoras ......................... 15
4.11.8 Registro de operações – Incluir lote de UR para financiadoras .................................. 15
4.12 Consulta de operações ................................................................................................ 15
4.12.1 Consulta recebíveis de operações ............................................................................... 16
4.12.2 Consulta recebíveis a constituir de operações............................................................ 16
2
4.13 Cadastro de credenciados ........................................................................................... 16
4.13.1 Consulta de credenciados ........................................................................................... 17
4.14 Requisição de cancelamento de operações da credenciadora ................................... 17
4.14.1 Consulta de resultado de cancelamento de operações .............................................. 17
4.15 Requisição de cancelamento de operações da financiadora ...................................... 18
4.16 Agendas consolidadas de financiadoras ..................................................................... 18
4.17 Consulta de operações da Financiadora ..................................................................... 18
4.17.1 Consulta recebíveis de operações da Financiadora .................................................... 19
4.17.2 Consulta recebíveis a constituir de operações da Financiadora ................................. 19
5. Webhooks e automação de resposta.................................................................................. 20
5.1 Estrutura para implementação de Webhooks ............................................................ 20
5.2 Retornos e política de retry......................................................................................... 20
5.3 Autenticação ............................................................................................................... 20
5.4 Integrações de Webhook de chamadas assíncronas. ................................................. 20
5.4.1 Notificação de Opt-In .................................................................................................. 20
5.4.2 Notificação de Opt-Out ............................................................................................... 21
5.4.3 Informe de janela de negociações .............................................................................. 21
5.4.4 Notificação de operações novas ................................................................................. 21
5.4.5 Notificação de operações atualizadas ......................................................................... 21
5.4.6 Notificação de cancelamento de operações ............................................................... 22
5.4.7 Notificação de resultado de operações ...................................................................... 22
5.4.8 Resposta do cancelamento de operações .................................................................. 22
5.5 Integrações de Webhook de arquivo recebido. .......................................................... 23
5.5.1 Unidades Recebíveis.................................................................................................... 23
5.5.2 Sumário de Operações ................................................................................................ 23
5.5.3 Participantes................................................................................................................ 23
5.5.4 Credenciados ............................................................................................................... 24
6. Modelos de dados ............................................................................................................... 25
7. Tabelas de apoio ................................................................................................................. 55
7.1 AccountType................................................................................................................ 55
7.2 ConstitutionType ......................................................................................................... 55
7.3 PaymentScheme.......................................................................................................... 55
7.4. NegociationTypeIndicator ........................................................................................... 56
8. Parâmetros de consulta – Métodos GET ............................................................................. 58
9. Códigos HTTP....................................................................................................................... 66
10. Material Confidencial ...................................................................................................... 67
3
4
Versionamento
Versão Descrição Área Responsável Data
5
1. Objetivo
O Manual de Leiautes de Integração com o serviço R2C3 da registradora CIP tem como
objetivo descrever os leiautes das requisições utilizadas por Credenciadores ou
Subcredenciadores, descrever as validações realizadas nos campos e nos respectivos domínios.
Os leiautes aqui apresentados são referentes às integrações via API REST e os dados
fornecidos serão utilizados para a integração com registradora CIP para compartilhamento de
informações da agenda de recebíveis com a finalidade de atender a Resolução 4.734/19 e a
Circular 3.952/19.
2. Autenticação
A autenticação nos sistemas RTM acontece por meio de uma autorização OAUTH2, que
delega a autenticação de usuário ao serviço que hospeda a conta do usuário, autorizando
aplicações de terceiros a acessar a conta do usuário.
Para maiores informações consultar o Manual de API – Integração R2C3.
3. Paginação
Todas as consultas com método GET possuem por padrão uma paginação, portanto os
responses deverão estar aptos a receber o modelo do tipo dados de cada requisição
complementar à seguinte estrutura:
Estrutura – Paginação
pageNumber – Número da página consultada, iniciando em 0.
pageSize – Tamanho de registros disponíveis por página, default 10 e máximo 100.
totalElements – Número total de elementos
totalPages – Número total de páginas
content – Lista do tipo de dado da API consultada.
6
4. Integrações
4.1 Agenda
O envio da agenda deverá ser efetuado diariamente, sendo essas agendas reportadas à
CIP. Para efetuar a baixa desses recebíveis, deverão ser notificados os dados relativos ao
pagamento.
Emissor: Credenciadora/Subcredenciadora
Método: POST
Endpoint: {urlBase}/trade-repository/receivable-units
Referência: ARRC001
Emissor: Credenciadora/Subcredenciadora
Método: GET
Paginação: Sim
Endpoint: {urlBase}/trade-repository/receivable-unit-responses/search
Referência: ARRC001RET
Emissor: Credenciadora/Subcredenciadora.
Método: GET
Paginação: Sim
Endpoint: {urlBase}/trade-repository/receivable-units/consult-cip
Referência: RRC0010
7
4.2 Baixa de recebíveis
A baixa de recebíveis deverá ser efetuada para o credenciador informar a registradora CIP
a baixa total de unidades de recebíveis registradas por motivos de chargeback, cancelamento,
registro indevido ou fraude comprovada.
Emissor: Credenciadora/Subcredenciadora
Método: POST
Endpoint: {urlBase}/trade-repository/receivable-units-deactivate
Referência: ARRC002
Emissor: Credenciadora/Subcredenciadora
Método: GET
Paginação: Sim
Endpoint: {urlBase}/trade-repository/receivable-units-deactivate-response
Referência: ARRC002RET
4.3 Opt-In
Permitir que o Titular ou Usuário Final Recebedor, por meio de um Participante,
comunique que disponibiliza suas Agendas para Financiadores ou Não Financeiras.
Emissor: Credenciadora/Subcredenciadora
Método: POST
Endpoint: {urlBase}/trade-repository/opt-ins
Referência: RRC0011
8
4.3.1 Notificação de Opt-In
Destinado a registradora CIP informar o processamento da inclusão da autorização de
envio de agenda de recebíveis.
Emissor: CIP
Método: GET
Paginação: Sim
Endpoint: {urlBase}/trade-repository/opt-ins/notification/search
Referência: RRC0028
4.4 Opt-Out
Permitir que o acesso a informações de Agendas seja cancelado, por decisão do
Financiador ou da Não Financeira solicitante anteriormente autorizado ou por solicitação do
Titular ou Usuário Final Recebedor das Agendas ao Participante que tenha realizado o informe
de Opt-in.
Emissor: Credenciadora/Subcredenciadora
Método: POST
Endpoint: {urlBase}/trade-repository/opt-outs
Referência: RRC0013
Emissor: CIP
Método: GET
Paginação: Sim
Endpoint: {urlBase}/trade-repository/opt-outs/notification/search
Referência: RRC0029
9
4.5 Contestação
Permitir que o participante conteste um opt-in.
Emissor: Credenciadora/Subcredenciadora
Método: POST
Endpoint: {urlBase}/trade-repository/pleas
Referência: RRC0027
Emissor: Credenciadora/Subcredenciadora
Método: PUT
Endpoint: {urlBase}/trade-repository/pleas/{pleaProtocol}
Referência: RRC0027
Emissor: CIP
Método: GET
Paginação: Sim
Endpoint: {urlBase}/trade-repository/operation-summaries/search
Referência: ARRC007
10
4.7 Janela de negociações
Permitir a registradora CIP informar ao credenciador e às instituições financeiras / não
financeiras a abertura e fechamento da janela de negociações.
Emissor: CIP
Método: GET
Paginação: Sim
Endpoint: {urlBase}/trade-repository/timetables/search
4.8 Participantes
Destinado a registradora CIP informar às Credenciadoras, Instituições Financeiras e Não
Financeiras a lista de Participantes ativos no sistema.
Emissor: CIP
Método: GET
Paginação: Sim
Endpoint: {urlBase}/trade-repository/participants/search
Referência: ARRC017
11
4.9 Operações
Destinado a registradora CIP informar ao Credenciador a inclusão ou a alteração de
negociação sobre unidades de recebíveis constituídas e a constituir.
Emissor: CIP
Método: GET
Paginação: Sim
Endpoint: {urlBase}/trade-repository/operations/search
Emissor: CIP
Método: GET
Paginação: Sim
Endpoint: {urlBase}/trade-repository/operations/cancel/search
Referência: RRC0004
Emissor: Credenciadora/Subcredenciadora
Método: POST
Paginação: Sim
Endpoint: {urlBase}/trade-repository/operations/register
Referência: RRC0005
12
4.11.1 Registro de operações para financiadora
Destinado ao financiador informar a registradora CIP a inclusão de negociação sobre
unidades de recebíveis.
Emissor: Financiadora
Método: POST
Paginação: Sim
Endpoint: {urlBase}/trade-repository/operations/financier/register
Referência: RRC0019
Emissor: Financiadora
Método: GET
Paginação: Sim
Endpoint: {urlBase}/trade-repository/operations/financier/receivable-units-available
Referência: RRC0019
Emissor: Financiadora
Método: PUT
Paginação: Sim
Endpoint: {urlBase}/trade-repository/operations/financier/{operationId}
Referência: RRC0019
13
4.11.4 Registro de operações - Resultado
Resultado de processamento de inclusão e alteração de operação.
Emissor: Credenciadora/Subcredenciadora/Financiadora.
Método: GET
Paginação: Sim
Endpoint: {urlBase}/trade-repository/operations/response/search
Emissor: Credenciadora/Subcredenciadora.
Método: GET
Paginação: Não
Endpoint: {urlBase}/trade-repository/operations/set-id
Referência: RRC0005
Emissor: Credenciadora/Subcredenciadora.
Método: POST
Endpoint: {urlBase}/trade-repository/operations/{receivableUnitsSetId}/receivable-units-lot
Referência: RRC0005
14
4.11.7 Registro de operações – Id de conjunto para UR para financiadoras
Gera um identificador de um conjunto de unidade de recebíveis para financiadoras.
Emissor: Financiadora.
Método: GET
Paginação: Não
Endpoint: {urlBase}/trade-repository/operations/financier/set-id
Referência: RRC0019
Emissor: Financiadora.
Método: POST
Endpoint: {urlBase}/trade-repository/operations/financier/{receivableUnitsSetId}/receivable-
units-lot
Referência: RRC0019
Emissor: Credenciadora/Subcredenciadora.
Método: GET
Paginação: Não
Endpoint: {urlBase}/trade-repository/operations/search/{operationId}
Referência: RRC0008
15
4.12.1 Consulta recebíveis de operações
Destinado ao credenciador realizar a consulta dos recebíveis em uma negociação por
operação e/ou por usuário final recebedor.
Emissor: Credenciadora/Subcredenciadora.
Método: GET
Paginação: Não
Endpoint: {urlBase}/trade-repository/operations/search/{operationId}/receivable-units
Referência: RRC0008
Emissor: Credenciadora/Subcredenciadora.
Método: GET
Paginação: Não
Endpoint: {urlBase}/trade-repository/operations/search/{operationId}/receivable-units-to-
constitute
Referência: RRC0008
Emissor: Credenciadora/Subcredenciadora.
Método: POST
Endpoint: {urlBase}/trade-repository/merchants
Referência: ARRC030
16
4.13.1 Consulta de credenciados
Destinado a registradora CIP retornar o processamento da lista de credenciados ativos.
Emissor: CIP.
Método: GET
Paginação: Sim
Endpoint: {urlBase}/trade-repository/merchant-responses/search
Referência: ARRC030RET
Emissor: Credenciadora/Subcredenciadora.
Método: POST
Endpoint: {urlBase}/trade-repository/cancel-operations/{operationId}
Referência: RRC0006
Emissor: CIP.
Método: GET
Paginação: Sim
Endpoint: {urlBase}/trade-repository/cancel-operations/response/search
17
4.15 Requisição de cancelamento de operações da financiadora
Destinado a financiadora requisitar o cancelamento de uma ou mais operações ativas à
CIP.
Emissor: Financiadora
Método: POST
Endpoint: {urlBase}/trade-repository/cancel-operations/financier/{operationId}
Referência: RRC0020
Emissor: CIP.
Método: GET
Paginação: Sim
Endpoint: {urlBase}/trade-repository/receivable-schedules/search
Referência: ARRC018
Emissor: Financiadora
Método: GET
Paginação: Não
Endpoint: {urlBase}/trade-repository/operations/financier/search/{operationId}
Referência: RRC0021
18
4.17.1 Consulta recebíveis de operações da Financiadora
Destinado a financiadora realizar a consulta dos recebíveis em uma negociação por
operação e/ou por usuário final recebedor.
Emissor: Financiadora
Método: GET
Paginação: Não
Endpoint: {urlBase}/trade-repository/operations/financier/search/{operationId}/receivable-
units
Referência: RRC0021
Emissor: Financiadora
Método: GET
Paginação: Não
Endpoint: {urlBase}/trade-repository/operations/financier/search/{operationId}/receivable-
units-to-constitute
Referência: RRC0021
19
5. Webhooks e automação de resposta
5.1 Estrutura para implementação de Webhooks
Na seção anterior, foram listadas as consultas ativas através das integrações disponíveis na
RTM, além disso, também providenciamos estruturas para o cadastro de um endpoint
customizado para o envio e recebimento passivo de dados, em uma estrutura de webhook. Estes
itens são disponibilizados no endpoint logo após a recebimento da resposta de processamento
pela CIP.
A implementação deste passo é aditiva à anterior, e opcional. Para esta feature, espera-se
que o cliente exponha os caminhos listados abaixo em seu ambiente conforme indicado.
Além disso, é necessário cadastrar dados de configuração para o webhook, incluindo itens
como a URL Base que receberá as chamadas, e o token fixo que será usado para autenticação.
Considerando downtime como uma das possíveis causas de falha, nossa política inclui
distancias de tempo crescentes, com uma distância total de 1 hora e 45 minutos entre a primeira
e a última tentativa de envio de cada dado.
5.3 Autenticação
Para autenticação é necessário informar um token fixo que será enviado no header das
requisições como “Bearer <token>”
Método: POST
Endpoint: {urlBaseAPI}/webhook-notifications/opt-in-notification
20
Referência: RRC0028
Método: POST
Endpoint: {urlBaseAPI}/webhook-notifications/opt-out-notification
Referência: RRC0029
Método: POST
Endpoint: {urlBaseAPI}/webhook-notifications/time-table
Método: POST
Endpoint: {urlBaseAPI}/webhook-notifications/operation-notification
Método: POST
21
Endpoint: {urlBaseAPI}/webhook-notifications/operation-notification/update
Método: POST
Endpoint: {urlBaseAPI}/webhook-notifications/operation-cancel-notification
Referência: RRC0004
Método: POST
Endpoint: {urlBaseAPI}/webhook-notifications/operation-response
Método: POST
Endpoint: {urlBaseAPI}/webhook-notifications/cancel-operation-response
22
Tipo de dado: CancelOperationResponseDto
Método: POST
Endpoint: {urlBaseAPI}/webhook-notifications/files/receivable-unit-response
Referência: ARRC0001
Método: POST
Endpoint: {urlBaseAPI}/webhook-notifications/files/operation-summary
Referência: ARRC0007
5.5.3 Participantes
Enviado quando a registradora CIP enviar um arquivo com um lote de participantes
atualizados.
Método: POST
Endpoint: {urlBaseAPI}/webhook-notifications/files/updated-participant-list
Referência: ARRC0017
23
5.5.4 Credenciados
Enviado quando a registradora CIP devolver um arquivo com o resultado do
processamento de um lote de credenciados enviado.
Método: POST
Endpoint: {urlBaseAPI}/webhook-notifications/files/merchant-response
Referência: ARRC0030
24
6. Modelos de dados
Os dados podem ser do tipo alfanumérico, numérico ou booleano, em encoding UTF-8,
seguindo as seguintes definições:
Alfanumérico – Campo do tipo texto. Tamanho máximo default 255 ou de acordo com
documentação fornecida pela CIP.
Numérico – Números reais com casas decimais separados por ponto. Tamanho máximo
default 19 sendo 13 casas para o número inteiro e 6 casas para os decimais ou de acordo com
documentação fornecida pela CIP.
ReceivableUnitDto
Campo Obrigatório Tipo Preenchimento
Documento do
Estabelecimento Comercial.
customerDocument Sim Alfanumérico
Tamanho máximo 11 ou 14.
<CNPJ_CPFUsuFinalRecbdr>
Código de identificação do
customerId Sim Alfanumérico
Estabelecimento Comercial
Identificador da Unidade de
Id Não Alfanumérico Recebível – Gerado pela
aplicação
Tipo da operação
operationType Sim Alfanumérico
{CREATION|UPDATE}
CNPJ da Instituição
Sub/Credenciadora
participantDocumentId Sim Alfanumérico
Participante.
Tamanho máximo 11 ou 14
Domínio de identificação do
Arranjo de Pagamento
paymentScheme Sim Alfanumérico
conforme item 8.3
Tamanho máximo 03
Informações de pagamento da
payments Sim List<PaymentsDto>
Unidade de Recebível
25
O valor total, líquido, em reais,
preContractedAmount Sim Numérico pré-contratado
<VlrPreContrd>
Data prevista de liquidação
settlementDate Sim Alfanumérico
<DtPrevtLiquid>
O valor total, em reais, que
compõe a Unidade de
totalAmount Sim Numérico
Recebível
<VlrTot>
PaymentsDto
Campo Obrigatório Tipo Preenchimento
Informações do domicílio de
paymentsInformation Sim PaymentInformationDto
pagamento
Identificador da Operação de
Negociação
operationId Não Alfanumérico
Tamanho máximo 19.
<IdentdOp>
O valor total, líquido, em reais,
settledAmount Não Numérico liquidado
<VlrEftLiquid>
O valor total, líquido, em reais,
settlementAmount Sim Numérico a ser liquidado
<VlrPrevtLiquid>
Data efetiva de liquidação
settlementDate Não Alfanumérico
<DtEftLiquid>
PaymentInformationDto
26
Campo Obrigatório Tipo Preenchimento
Número da conta
Tamanho máximo 20 para
accountNumber Sim Alfanumérico accountType = PG e 13 nos
demais tipos.
<Ct> ou <CtPgto>
Tipo da conta conforme item
accountType Sim Alfanumérico 8.1
<TpCt>
Agência
Tamanho máximo 04.
bankBranch Sim Alfanumérico Não deverá ser preenchido
caso accountType = PG.
<Ag>
codeCompe Sim Alfanumérico Código COMPE
Código ISPB
codeIspb Sim Alfanumérico Tamanho máximo 08.
<ISPBBcoRecbdr>
Documento do Titular da conta
customerDocument Sim Alfanumérico Tamanho máximo 11 ou 14
<CNPJ_CPFTitlarCt>
DeactivationDto
Campo Obrigatório Tipo Preenchimento
Identificador Participante
mainParticipantId Sim Alfanumérico
Principal
Identificador Participante
managedParticipantId Sim Alfanumérico
Administrado
List
receivableUnitsToDeactivate Sim <ReceivableUnit Grupo Recebíveis para Baixa
DeactivateDto>
27
ReceivableUnitsDeactivateDto
Campo Obrigatório Tipo Preenchimento
Documento do titular da
receivableOwnerDocument Sim Alfanumérico
Unidade de Recebível
Domínio de identificação do
paymentScheme Sim Alfanumérico Arranjo de Pagamento
conforme item 8.3
settlementDate Sim Alfanumérico Data Prevista Liquidação
deactivationReason Sim Alfanumérico Indicador Motivo Baixa
DeactivationResponseDto
Campo Obrigatório Tipo Preenchimento
mainParticipantId Sim Alfanumérico Identificador Participante Principal
Identificador Participante
managedParticipantId Sim Alfanumérico
Administrado
responseSituation Sim Alfanumérico Situação de Retorno da Requisição
List<ReceivableUnitDeacti Grupo de Recebíveis aprovados
receivableUnitsDeactivated Sim
vateDto> para baixa
List<ReceivableUnitDeacti
receivableUnitsRefused Sim Grupo de Recebíveis Recusados
vateDto>
ReceivableUnitResponseDto
Campo Obrigatório Tipo Preenchimento
Identificador Participante
mainParticipantId Sim Alfanumérico
Principal
Identificador Participante
managedParticipantId Sim Alfanumérico
Administrado
Situação de Retorno da
responseSituation Sim Alfanumérico
Requisição
List
receivableUnitsApproved Sim Grupo de Recebíveis Aprovados
<ReceivableUnitDto>
List
receivableUnitsRefused Sim Grupo de Recebíveis Recusados
<ReceivableUnitDto>
errorCode Não Alfanumérico Código de erro do arquivo
fileDate Não Alfanumérico Data de geração do arquivo
fileName Não Alfanumérico Nome do arquivo
issuerControlNumber Não Alfanumérico Número de controle do emissor
issuerIspb Não Alfanumérico ISPB do emissor
Número de controle do
recipientControlNumber Não Alfanumérico
destinatário
recipientIspb Não Alfanumérico ISPB do destinatário
referenceDate Não Alfanumérico Data de referência
28
ErrorDto
Campo Obrigatório Tipo Preenchimento
code Sim Alfanumérico Código de identificação de erro
field Sim Alfanumérico Campo com valor incorreto
value Sim Alfanumérico Valor enviado
OptInDto
Campo Obrigatório Tipo Preenchimento
Identificador Controle
requestProtocol Sim Alfanumérico
Requisição Solicitante
CNPJ ou CPF do Usuário Final
recipientDocument Sim Alfanumérico Recebedor ou do titular do
recebível
CNPJ
participantDocumentId Sim Alfanumérico
Credenciadora/Subcredenciador
financierDocument Sim Alfanumérico CNPJ ou CPF Financiador
Domínio de identificação do
paymentScheme Sim Alfanumérico Arranjo de Pagamento
conforme item 8.3
optInSignatureDate Sim Alfanumérico Data Assinatura Opt-In
optInStartingDate Sim Alfanumérico Data Início Opt-In
optInEndingDate Sim Alfanumérico Data Fim Opt-In
domicileIndicator Sim Alfanumérico Indicador de Domicilio
Identificador Participante
managedParticipantId Não Alfanumérico
Administrado
OptInResponseDto
Campo Obrigatório Tipo Preenchimento
Identificador Controle
requestProtocol Não Alfanumérico
Requisição Solicitante
optInProtocol Não Alfanumérico Identificador Controle Opt-In
tradeRepositoryDocument Não Alfanumérico CNPJ Entidade Registradora
Mensagem de retorno da CIP
cipMessage Não List<CipMessageDto>
em casos de erro
processingDate Não Alfanumérico Data de processamento
CipMessageDto
Campo Obrigatório Tipo Preenchimento
code Sim Alfanumérico Código da Mensagem
Conteudo do campo que está
content Sim Alfanumérico
com erro
field Sim Alfanumérico Campo que está com erro
message Sim Alfanumérico Descrição da mensagem
29
OptOutDto
Campo Obrigatório Tipo Preenchimento
Identificador Controle
requestProtocol Sim Alfanumérico
Requisição Solicitante
optInProtocol Sim Alfanumérico Identificador Controle Opt-In
Identificador Participante
managedParticipantId Não Alfanumérico
Administrado
OptOutResponseDto
Campo Obrigatório Tipo Preenchimento
Identificador Controle
requestProtocol Não Alfanumérico
Requisição Solicitante
optInProtocol Não Alfanumérico Identificador Controle Opt-In
optOutProtocol Não Alfanumérico Identificador Controle Opt-Out
Mensagem de retorno da CIP
cipMessage Não List<CipMessageDto>
em casos de erro
processingDate Não Alfanumérico Data de processamento
PleaDto
Campo Obrigatório Tipo Preenchimento
Documento da instituição
pleadingParticipantDocument Sim Alfanumérico
originadora da contestação
Documento da instituição
pleadedParticipantDocument Sim Alfanumérico
contestada
Identificador Controle
requestProtocol Sim Alfanumérico
Requisição Solicitante
Identificador do motivo da
pleaIndicatorReason Sim Alfanumérico
contestação
pleaDescription Sim Alfanumérico Descrição da contestação
optInProtocol Sim Alfanumérico Identificador Controle Opt-In
operationId Sim Alfanumérico Identificador da operação
Identificador Participante
managedParticipantId Não Alfanumérico
Administrado
PleaResponseDto
Campo Obrigatório Tipo Preenchimento
Identificador da Operação de
pleaProtocol Sim Alfanumérico
Contestação
Identificador Controle
requestProtocol Sim Alfanumérico
Requisição Solicitante
Mensagem de retorno da CIP
cipMessage Não List<CipMessageDto>
em casos de erro
processingDate Não Alfanumérico Data de processamento
30
OperationSummaryDto
Campo Obrigatório Tipo Preenchimento
Identificador Participante
mainParticipantId Sim Alfanumérico
Principal
Identificador Participante
managedParticipantId Sim Alfanumérico
Administrado
Data de recepção do arquivo
cipFileDate Sim Alfanumérico
enviado pela CIP
Nome do arquivo enviado pela
cipFileName Sim Alfanumérico
CIP
List<OperationSummar Grupo de controle do resumo de
operationSummaryControl Não
yControlDto> Operações
ReceivableUnitSetIdDto
Campo Obrigatório Tipo Preenchimento
Identificador do conjunto de
receivableUnitSetId Não Alfanumérico
Unidades Recebíveis
Identificador Participante
managedParticipantId Não Alfanumérico
Administrado
TimetableDto
Campo Obrigatório Tipo Preenchimento
Data de referência, no modelo
date Sim Alfanumérico
'yyyy-MM-dd'
Data de abertura da janela, no
openingDate Não Alfanumérico modelo 'yyyy-MM-
dd'T'HH:mm:ss.SSSz'
Data de fechamento da janela,
closingDate Não Alfanumérico no modelo 'yyyy-MM-
dd'T'HH:mm:ss.SSSz'
Data de abertura da janela -
tradeRepositoryOpeningDate Não Alfanumérico Registradora, no modelo 'yyyy-
MM-dd'T'HH:mm:ss.SSSz'
Data de fechamento da janela -
tradeRepositoryClosingDate Não Alfanumérico Registradora, no modelo 'yyyy-
MM-dd'T'HH:mm:ss.SSSz'
31
ParticipantDto
Campo Obrigatório Tipo Preenchimento
document Sim Alfanumérico CNPJ ou CPF do Participante
documentType Sim Alfanumérico Indicador Tipo de Pessoa
domicileIndicator Não Alfanumérico Indicador de Domicílio
email Não Alfanumérico E-mail Participante
homologationEntryDate Não Alfanumérico Data Adesão Homologação
IsActive Não Boolean True / False
Não Nome ou Razão Social do
name Alfanumérico
Participante
participanteType Não Alfanumérico Indica o tipo do Participante
productionEntryDate Não Alfanumérico Data de Entrada em Produção
telephone Não Alfanumérico Número Telefone Participante
updatedAt Não Alfanumérico Data de Atualização do Registro
Identificador Participante
managedParticipantId Não Alfanumérico
Administrado
OperationNotificationDto
Campo Obrigatório Tipo Preenchimento
operationId Não Alfanumérico Identificador da Operação de Negociação
operationHref Não Alfanumérico Localização da operação nos serviços da CIP
Data de recebimento da notificação, no modelo
createdDate Não Alfanumérico
'yyyy-MM-dd'T'HH:mm:ss.SSSz'
Data de atualização da notificação, no modelo
updateDate Não Alfanumérico
'yyyy-MM-dd'T'HH:mm:ss.SSSz'
managedParticipantId Não Alfanumérico Identificador Participante Administrado
32
OperationCancelNotificationDto
Campo Obrigatório Tipo Preenchimento
tradeRepositoryDocument Não Alfanumérico CNPJ Entidade Registradora
CPF ou CNPJ do Participante
negociatingParticipantDocument Não Alfanumérico Negociador
Identificador Negociação
receivableNegociationId Não Alfanumérico
Recebível
Identificador da Operação de
operationId Não Alfanumérico
Negociação
Documento do titular da
receivableOwnerDocument Não Alfanumérico
Unidade de Recebível
Indicador cancelamento de
totalValueCancelOperationIndicator Não Alfanumérico
valor total
Identificador da Operação de
operationCancelId Não Alfanumérico
Cancelamento
Indicador cancelamento de
lienToConstituteCancelIndicator Não Alfanumérico
cessão a constituir
List<ReceivableUnitCa Unidades de recebiveis da
receivableUnits Não
ncelDto> operação de cancelamento
Data de recebimento da
createdDate Não Alfanumérico notificação, no modelo 'yyyy-
MM-dd'T'HH:mm:ss.SSSz'
Data de atualização da
updateDate Não Alfanumérico notificação, no modelo 'yyyy-
MM-dd'T'HH:mm:ss.SSSz'
ReceivableUnitCancelDto
Campo Obrigatório Tipo Preenchimento
CNPJ
subOrAcquirerDocument Não Alfanumérico Credenciadora/Subcredenciad
ora
CNPJ ou CPF do Usuário Final
recipientDocument Não Alfanumérico
Recebedor
Domínio de identificação do
paymentScheme Não Alfanumérico Arranjo de Pagamento
conforme item 8.3
settlementDate Não Alfanumérico Data prevista de liquidação
CNPJ ou CPF Titular Vendedor
traderDocument Não Alfanumérico
ou Negociador do Recebível
negociatedValueCanceled Não Alfanumérico Valor negociado cancelado
Valor ou Percentual negociado
valueOrPercentToConstituteCanceled Não Alfanumérico
a Constituir cancelado
33
OperationDto
Obriga
Campo Tipo Preenchimento
tório
Tipo de objeto, titular ou usuario
objectType Não Alfanumérico final recebedor {“P” – Participante |
“E” – ER}
receivableNegociationId Não Alfanumérico Identificador Negociação Recebível
Indicador Tipo Negociação conforme
negociationTypeIndicator Não Alfanumérico
item 8.4
Data Vencimento Operação, no
operationDueDate Não Alfanumérico
modelo 'yyyy-MM-dd'
totalValueLimitOrDebitBalance Não Alfanumérico Valor Total Limite ou Saldo Devedor
tradeRepositoryManagementInd Indicador Gestão Entidade
Não Alfanumérico
icator Registradora {“S” – Sim | ”N” – Não}
Indicador Regra Divisão {“P” –
divisionRuleIndicator Não Alfanumérico
Porcentual | “V” – Valor}
unconditionalAcceptedOperation Indicador Aceite Incondicional
Não Alfanumérico
Indicator Operação {“S” – Sim | ”N” – Não}
Identificador do conjunto de
receivableUnitSetId Não Alfanumérico Unidades Recebíveis – Coleta no item
4.11.5
Mensagem de retorno da CIP em
cipMessage Não List<CipMessageDto>
casos de erro
operationOwners Não List<OperationOwnerDto> Titulares
OperationResponseDto
Campo Obrigatório Tipo Preenchimento
receivableNegociationId Não Alfanumérico Identificador Negociação Recebível
operationId Não Alfanumérico Identificador da Operação de Negociação
Situação de Retorno da Requisição
responseSituation Sim Alfanumérico
(Aceito/recusado/Erro)
operationHref Não Alfanumérico Localização da operação nos serviços da CIP
Data de recebimento da notificação, no modelo
createdDate Não Alfanumérico
'yyyy-MM-dd'T'HH:mm:ss.SSSz'
Data de atualização da notificação, no modelo 'yyyy-
updateDate Não Alfanumérico
MM-dd'T'HH:mm:ss.SSSz'
managedParticipantId Não Alfanumérico Identificador Participante Administrado
34
OptInNotificationDto
Campo Obrigatório Tipo Preenchimento
optInProtocol Não Alfanumérico Identificador Controle Opt-In
CNPJ ou CPF do Usuário Final Recebedor ou do titular
recipientDocument Não Alfanumérico
do recebível
participantDocumentId Não Alfanumérico CNPJ Credenciadora/Subcredenciadora
financierDocument Não Alfanumérico CNPJ ou CPF Financiador
Domínio de identificação do Arranjo de Pagamento
paymentScheme Não Alfanumérico
conforme item 8.3
optInSignatureDate Não Alfanumérico Data Assinatura Opt-In
optInStartingDate Não Alfanumérico Data Início Opt-In
optInEndingDate Não Alfanumérico Data Fim Opt-In
domicileIndicator Não Alfanumérico Indicador de Domicilio
tradeRepositoryDocume
Não Alfanumérico CNPJ Entidade Registradora
nt
optInReceiverDocument Não Alfanumérico CPF ou CNPJ Recebedor Opt-In
Data de recebimento da notificação, no modelo
createdDate Não Alfanumérico
'yyyy-MM-dd'T'HH:mm:ss.SSSz'
Data de atualização da notificação, no modelo 'yyyy-
updateDate Não Alfanumérico
MM-dd'T'HH:mm:ss.SSSz'
managedParticipantId Não Alfanumérico Identificador Participante Administrado
OperationReceivableUnitDto
Campo Campo Campo Campo
CNPJ (Completo ou Base) ou CPF
receivableOwnerDocument Sim Alfanumérico
do Titular
Documento do titular do
bankAccountOwnerDocument Sim Alfanumérico
domicílio bancário
codeIspb Sim Alfanumérico Código ISPB do Banco Recebedor
accountType Sim Alfanumérico Tipo da conta conforme item 8.1
bankBranch Não Alfanumérico Agência
accountNumber Não Alfanumérico Número da conta
paymentAccountNumber Não Alfanumérico Número da conta pagamento
receivableUnitPriority Sim Alfanumérico Prioridade Negociação Recebível
CNPJ ou CPF do Usuário Final
recipientDocument Sim Alfanumérico
Recebedor
holderDocument Não Alfanumérico CNPJ ou CPF Titular
35
Domínio de identificação do
paymentScheme Sim Alfanumérico Arranjo de Pagamento conforme
item 8.3
settlementDate Sim Alfanumérico Data prevista de liquidação
negociatedValue Sim Alfanumérico Valor ou percentual negociado
Tipo de constituição da unidade
constitutionType Não Alfanumérico
de recebível conforme item 8.2
OperationReturnDto
Campo Obrigatório Tipo Preenchimento
tradeRepositoryDocument Não Alfanumérico CNPJ Entidade Registradora
CPF ou CNPJ do Participante
participantTraderDocument Não Alfanumérico
Negociador
receivableNegociationId Não Alfanumérico Identificador Negociação Recebível
Identificador da Operação de
operationId Não Alfanumérico
Negociação
negociationTypeIndicator Não Alfanumérico Indicador Tipo Negociação
operationDueDate Não Alfanumérico Data Vencimento Operação
totalValueLimitOrDebitBalanc
Não Alfanumérico Valor Total Limite ou Saldo Devedor
e
guaranteeValue Não Numérico Valor Garantia
tradeRepositoryManagementI Indicador Gestão Entidade
Não Alfanumérico
ndicator Registradora
divisionRuleIndicator Não Alfanumérico Indicador Regra Divisão
unconditionalAcceptedOperat Indicador Aceite Incondicional
Não Alfanumérico
ionIndicator Operação
reservedReceivableUnitAccep Indicador Aceite Unidade de
Não Alfanumérico
tedIndicator Recebível Reservada
inclusionDate Não Alfanumérico Data e Hora Inclusão
operationSituationIndicator Não Alfanumérico Indicador de Situação da operação
lienAutorizationIndicator Não Alfanumérico Indicador Autorização Cessão
operationTypeOriginIndicator Não Alfanumérico Indicador Tipo Operação Origem
Localização das unidades de
receivableUnitsHref Não Alfanumérico
recebíveis nos serviços da CIP
Localização das unidades de
toConstituteReceivableUnitsH
Não Alfanumérico recebíveis a constituir nos serviços da
ref
CIP
operationsOrigin Não List<Alfanumérico> Indicador Tipo Operação Origem
36
MerchantDto
Campo Obrigatório Tipo Preenchimento
MerchantResponseDto
Campo Obrigatório Tipo Preenchimento
37
issuerIspb Não Alfanumérico ISPB do emissor
OptOutNotificationDto
Campo Obrigatório Tipo Preenchimento
optInProtocol Não Alfanumérico Identificador Controle Opt-In
optOutProtocol Não Alfanumérico Identificador Controle Opt-Out
optInEndingDate Não Alfanumérico Data Fim Opt-In
optOutReceiverDocument Não Alfanumérico CPF ou CNPJ Recebedor Opt-Out
Data de recebimento da notificação,
createdDate Não Alfanumérico no modelo 'yyyy-MM-
dd'T'HH:mm:ss.SSSz'
Data de atualização da notificação,
updateDate Não Alfanumérico no modelo 'yyyy-MM-
dd'T'HH:mm:ss.SSSz'
Identificador Participante
managedParticipantId Não Alfanumérico
Administrado
OperationOwnerDto
Campo Obrigatório Tipo Preenchimento
accountNumber Não Alfanumérico Número da conta
accountType Não Alfanumérico Tipo da conta conforme item 8.1
Documento do titular do domicílio
bankAccountOwnerDocument Sim Alfanumérico
bancário
bankBranch Não Alfanumérico Agência
ReceivableUnitSetIdDto
Campo Obrigatório Tipo Preenchimento
38
Identificador do conjunto de
receivableUnitSetId Sim Alfanumérico Unidades Recebíveis
Identificador Participante
managedParticipantId Não Alfanumérico Administrado
39
FinancierOperationDto
Campo Obrigatório Tipo Preenchimento
Tipo de objeto (“P” - Participante – “E”
objectType Sim Alfanumérico
- ER)
receivableNegociationId Sim Alfanumérico Identificador da Negociação Recebível
Indicador do Tipo de Negociação
negociationTypeIndicator Sim Alfanumérico
conforme item 8.4
operationDueDate Sim Alfanumérico Data de Vencimento da Operação
40
FinancierOperationOwnerDto
Campo Obrigatório Tipo Preenchimento
CNPJ (Completo ou Base) ou CPF do
receivableOwnerDocument Não Alfanumérico
Titular
valueOrReceivableUnitTotalPe Valor ou Percentual Total da
Não Alfanumérico
rcent Operação na Unidade de Recebível
operationStartingDate Sim Alfanumérico Data de Início da Operação
operationEndingDate Sim Alfanumérico Data de Fim da Operação
41
ReceivableUnitLotItemDto
Campo Obrigatório Tipo Preenchimento
accountNumber Não Alfanumérico Número da conta
42
FinancierReceivableUnitLotItemDto
Campo Obrigatório Tipo Preenchimento
accountNumber Não Alfanumérico Número da conta
CNPJ da Credenciadora ou
accreditorDocument Sim Alfanumérico Subcredenciadora
Identificador Participante
managedParticipantId Não Alfanumérico Administrado
43
OperationSummaryControlDto
Campo Obrigatório Tipo Preenchimento
Data/Hora recepção/envio do
fileDate Sim Alfanumérico arquivo
Identificador da Operação
tradeRepositoryDeconstructio Desconsituição da Negociação de
Não Alfanumérico
nProtocol Recebível enviado pela registradora
Identificador da Operação
tradeRepositoryNegociationCa Cancelamento da Negociação de
Não Alfanumérico
ncellProtocol Recebível enviado pela registradora
44
CancelOperationRequestDto
Campo Obrigatório Tipo Preenchimento
operationType Sim Alfanumérico O Tipo da operação: “Cancelamento“
CancelOperationResponseDto
Campo Obrigatório Tipo Preenchimento
requestResult Sim Alfanumérico O Resultado: “Aceito“ ou “Erro”
Identificador Participante
managedParticipantId Não Alfanumérico Administrado
45
CancelFinancierOperationRequestDto
Campo Obrigatório Tipo Preenchimento
operationType Sim Alfanumérico O Tipo da operação: “Cancelamento“
46
ReceivableUnitFinalUserDto
Campo Obrigatório Tipo Preenchimento
O tipo de objeto: Titular é ‘T’, Usuario
objectType Sim Alfanumérico Final Recebedor é ‘U’
CNPJ da
participantDocumentId Sim Alfanumérico Credenciadora/Subcredenciadora
List<
holders Sim ReceivableUnitFinalUser Titulares da unidade recebível.
HolderDto>
Identificador Participante
managedParticipantId Não Alfanumérico Administrado
47
ReceivableUnitFinalUserHolderDto
Campo Obrigatório Tipo Preenchimento
bankAccountOwnerDocument Sim Alfanumérico CNPJ ou CPF do Titular
List<
otherInstitutionOperations Não ReceivableUnitOtherInst Operações de outras instituições
itutionsDto>
ReceivableUnitOtherInstitutionsDto
Campo Obrigatório Tipo Preenchimento
Indicador de Regra de Divisão (V ou
divisionRuleIndicator Sim Alfanumérico F)
Prioridade da Negociação do
receivableUnitPriority Sim Numérico Recebível
48
ReceivableUnitDomicileDto
Campo Obrigatório Tipo Preenchimento
bankAccountOwnerDocument Sim Alfanumérico CNPJ ou CPF do Titular
List<
operations Sim ReceivableUnitDomicile Lista de operações
OperationDto>
ReceivableUnitDomicileOperationDto
Campo Obrigatório Tipo Preenchimento
operationId Sim Alfanumérico Identificador da operação.
Prioridade da Negociação do
receivableUnitPriority Sim Numérico Recebível
49
ReceivableScheduleDto
Campo Obrigatório Tipo Preenchimento
Nome do arquivo cuja CIP informou a
sourceFileName Sim Alfanumérico agenda.
Lista<
receiverFinalUsers Sim ReceivableScheduleRece Lista de usuários finais recebedores
ivingFinalUserDto>
Lista<
receivableScheduleHolders Sim ReceivableScheduleHold Lista de Titulares
erDto>
Identificador Participante
managedParticipantId Não Alfanumérico Administrado
ReceivableScheduleReceivingFinalUserDto
Campo Obrigatório Tipo Preenchimento
CNPJ ou CPF do Usuário Final
finalUserDocument Sim Alfanumérico Recebedor
ReceivingFinalUserReceivableUnitDto
Campo Obrigatório Tipo Preenchimento
Data prevista de liquidação, em
expectedSettlementDate Sim Alfanumérico formato ISO8601
Lista<
holders Sim ReceivableUnitFinalUser Lista de Titulares
HolderDto>
50
ReceivableScheduleHolderDto
Campo Obrigatório Tipo Preenchimento
holderDocument Sim Alfanumérico CNPJ Completo ou CPF do Titular
HolderReceivableUnitDto
Campo Obrigatório Tipo Preenchimento
expectedSettlementDate Sim Alfanumérico Data prevista de liquidação
List<
otherInstitutionOperations Não ReceivableUnitOtherInst Operações de outras instituições
itutionsDto>
51
FinancierReceivableUnitDto
Campo Obrigatório Tipo Preenchimento
Tipo de objeto (F – Financiadora, C –
paymentAccountNumber Sim Alfanumérico Credenciadora)
52
FinancierConsultOperationDto
Campo Obrigatório Tipo Preenchimento
tradeRepositoryDocument Não Alfanumérico CNPJ Entidade Registradora
authorizedAssigneesDocuments Não List<Alfanumérico> Cessionários Autorizados
receivableNegociationId Não Alfanumérico Identificador Negociação Recebível
Identificador da Operação de
operationId Não Alfanumérico
Negociação
negociationTypeIndicator Não Alfanumérico Indicador Tipo Negociação
operationDueDate Não Alfanumérico Data Vencimento Operação
totalValueLimitOrDebitBalance Não Alfanumérico Valor Total Limite ou Saldo Devedor
guaranteeValue Não Numérico Valor Garantia
tradeRepositoryManagementInd Indicador Gestão Entidade
Não Alfanumérico
icator Registradora
divisionRuleIndicator Não Alfanumérico Indicador Regra Divisão
unconditionalAcceptedOperation Indicador Aceite Incondicional
Não Alfanumérico
Indicator Operação
debitRenegociation Não List<Alfanumérico> Renegociações de Dividas
inclusionDate Não Alfanumérico Data e Hora Inclusão
operationSituationIndicator Não Alfanumérico Indicador de Situação da operação
contractReachIndicator Não Alfanumérico Indicador de Alcance de Contrato
Indicador Aceite Unidade de
reserveAcceptedIndicator Não Alfanumérico Recebível
Reservada
Localização das unidades de
receivableUnitsHref Não Alfanumérico
recebíveis nos serviços da CIP
Localização das unidades de
toConstituteReceivableUnitsHref Não Alfanumérico recebíveis a constituir nos serviços da
CIP
cancelAuthorizationIndicator Não Alfanumérico Indicador de Autorização de Cessão
Identificador CIP da Operação
cipOriginDebtRenegotiation Não Alfanumérico
Original Renegociação Dívida
Identificador Participante
managedParticipantId Não Alfanumérico
Administrado
53
FinancierConsultReceivableUnitOperatioDto
Campo Obrigatório Tipo Preenchimento
receivableOwnerDocument Sim Alfanumérico CNPJ (Completo ou Base) ou CPF do Titular
bankAccountOwnerDocument Sim Alfanumérico Documento do titular do domicílio bancário
codeIspb Sim Alfanumérico Código ISPB do Banco Recebedor
accountType Sim Alfanumérico Tipo da conta conforme item 8.1
bankBranch Não Alfanumérico Agência
accountNumber Não Alfanumérico Número da conta
paymentAccountNumber Não Alfanumérico Número da conta pagamento
receivableUnitPriority Sim Alfanumérico Prioridade Negociação Recebível
recipientDocument Sim Alfanumérico CNPJ ou CPF do Usuário Final Recebedor
accreditorDocument Sim Alfanumérico CNPJ do Credenciador
Domínio de identificação do Arranjo de
paymentScheme Sim Alfanumérico
Pagamento conforme item 8.3
forecastSettlementDate Sim Alfanumérico Data prevista de liquidação
negociatedValue Sim Numérico Valor ou percentual negociado
FinancierOperationReceivableUnitToBeConstitutedDto
Campo Obrigatório Tipo Preenchimento
receivableOwnerDocument Sim Alfanumérico CNPJ (Completo ou Base) ou CPF do Titular
bankAccountOwnerDocument Sim Alfanumérico Documento do titular do domicílio bancário
codeIspb Sim Alfanumérico Código ISPB do Banco Recebedor
accountType Sim Alfanumérico Tipo da conta conforme item 8.1
bankBranch Não Alfanumérico Agência
accountNumber Não Alfanumérico Número da conta
paymentAccountNumber Não Alfanumérico Número da conta pagamento
receivableUnitPriority Sim Alfanumérico Prioridade Negociação Recebível
recipientDocument Sim Alfanumérico CNPJ ou CPF do Usuário Final Recebedor
accreditorDocument Sim Alfanumérico CNPJ do Credenciador
Domínio de identificação do Arranjo de
paymentScheme Sim Alfanumérico
Pagamento conforme item 8.3
settlementDate Sim Alfanumérico Data prevista de liquidação
negociatedConstituteValue Sim Numérico Valor ou percentual negociado
managedParticipantId Não Alfanumérico Identificador Participante Administrado
54
7. Tabelas de apoio
7.1 AccountType
Valor Descrição
CC Conta Corrente
CD Conta de Depósito
PG Conta Pagamento
PP Conta Poupança
7.2 ConstitutionType
Valor Descrição
CONSTITUTED Constituída
TO_BE_CONSTITUTED A Constituir
7.3 PaymentScheme
Valor Descrição
55
047 Ourocard Cartão de Débito
060 Agiplan
061 Aura
062 Avista
065 Banrisul
066 Calcard
067 Credi-Shop
069 Dacasa
070 Discover
071 Fortbrasil
072 Maxifrota
073 Redesplan
074 Senff
7.4. NegociationTypeIndicator
Valor Descrição
TC Troca de Titularidade
OG Ônus - Gravame
56
OP Ônus – Penhora
AN Antecipação
57
8. Parâmetros de consulta – Métodos GET
/trade-repository/receivable-unit-responses/search
Parâmetro Tipo Descrição
errorCodes array[string] Código de erro
fileNames array[string] Nome dos arquivos
ids array[string] Identificação
issuerControlNumbers array[string] Número de controle do emissor
issuerIspbs array[string] ISPB do emissor
mainParticipantIds array[string] Identificador Participante Principal
managedParticipantIds array[string] Identificador Participante Administrado
maximumFileDate string($date) Data máxima de geração do arquivo
maximumReferenceDate string($date) Data máxima de referência
minimumFileDate string($date) Data mínima de geração do arquivo
minimumReferenceDate string($date) Data mínima de referência
pageNumber integer($int32) Número da página consultada, default em 0.
Tamanho de registros disponíveis por página,
pageSize integer($int32)
default 10.
recipientControlNumbers array[string] Número de controle do destinatário
recipientIspbs array[string] ISPB do destinatário
responseSituations array[string] Situação de Retorno da Requisição
sortDirection string Ordenação, default ASC.
sortParameter string Parâmetro de ordenação, default Id.
/trade-repository/opt-ins/notification/search
Parâmetro Tipo Descrição
domicileIndicators array[string] Indicador de domicílios
financierDocuments array[string] Documento do Financiador
maximumCreatedDate string($date) Data máxima de recebimento da notificação
58
minimumOptInStartingDate string($date) Data mínima de início Opt-In
/trade-repository/opt-outs/notification/search
Parâmetro Tipo Descrição
maximumCreatedDate string($date) Data máxima de recebimento da notificação
59
Tamanho de registros disponíveis por página,
pageSize integer($int32)
default 10.
sortDirection string Ordenação, default ASC.
sortParameter string Parâmetro de ordenação, default Id.
managedParticipantId string Identificador Participante Administrado
/trade-repository/operation-summaries/search
Parâmetro Tipo Descrição
cipFileNames array[string] Nome dos arquivos
mainParticipantIds array[string] Identificador Participante Principal
managedParticipantIds array[string] Identificador Participante Administrado
maximumCipFileDate string($date) Data máxima de geração do arquivo
minimumCipFileDate string($date) Data mínima de geração do arquivo
pageNumber integer($int32) Número da página consultada, default em 0.
Tamanho de registros disponíveis por página,
pageSize integer($int32)
default 10.
sortDirection string Ordenação, default ASC.
sortParameter string Parâmetro de ordenação, default Id.
/trade-repository/timetables/search
Parâmetro Tipo Descrição
maximumClosingDate string($date) Data máxima de fechamento da janela
maximumDate string($date) Data máxima de referência
maximumOpeningDate string($date) Data máxima de abertura da janela
maximumTradeRepositoryClosingD Data máxima de fechamento da janela -
string($date)
ate Registradora
maximumTradeRepositoryOpening Data máxima de abertura da janela -
string($date)
Date Registradora
minimumClosingDate string($date) Data mínima de fechamento da janela
minimumDate string($date) Data máxima de referência
minimumOpeningDate string($date) Data máxima de abertura da janela
minimumTradeRepositoryClosingDa Data máxima de fechamento da janela -
string($date)
te Registradora
60
minimumTradeRepositoryOpeningD Data máxima de abertura da janela -
string($date)
ate Registradora
pageNumber integer($int32) Número da página consultada, default em 0.
Tamanho de registros disponíveis por página,
pageSize integer($int32)
default 10.
sortDirection string Ordenação, default ASC.
sortParameter string Parâmetro de ordenação, default Id.
managedParticipantId string Identificador Participante Administrado
/trade-repository/participants/search
Parâmetro Tipo Descrição
documents array[string] CNPJ ou CPF dos Participantes
domicileIndicators array[string] Indicadores de Domicílio
emails array[string] e-mails
isActive boolean Indicador de participante ativo
61
minimumProductionEntryDate string($date) Data mínima de adesão em produção
/trade-repository/operations/search
Parâmetro Tipo Descrição
maximumCreatedDate string($date) Data máxima de recebimento da notificação
maximumUpdateDate string($date) Data máxima de atualização da notificação
minimumCreatedDate string($date) Data mínima de recebimento da notificação
minimumUpdateDate string($date) Data mínima de atualização da notificação
operationHrefs array[string] Localização da operação nos serviços da CIP
operationIds array[string] Identificadores da Operação de Negociação
pageNumber integer($int32) Número da página consultada, default em 0.
Tamanho de registros disponíveis por página,
pageSize integer($int32)
default 10.
sortDirection string Ordenação, default ASC.
sortParameter string Parâmetro de ordenação, default Id.
managedParticipantId string Identificador Participante Administrado
/trade-repository/operations/cancel/search
Parâmetro Tipo Descrição
62
pageNumber integer($int32) Número da página consultada, default em 0.
Tamanho de registros disponíveis por página,
pageSize integer($int32)
default 10.
receivableNegociationIds array[string] Identificadores Negociação Recebível
Documentos dos titulares das Unidades de
receivableOwnerDocuments array[string]
Recebíveis
sortDirection string Ordenação, default ASC.
sortParameter string Parâmetro de ordenação, default Id.
totalValueCancelOperationIndicator
array[string] Indicador cancelamento de valor total
s
/trade-repository/operations/response/search
Parâmetro Tipo Descrição
operationIds array[string] Identificadores das Operações de Negociação
pageNumber integer($int32) Número da página consultada, default em 0.
Tamanho de registros disponíveis por página,
pageSize integer($int32)
default 10.
receivableNegociationIds array[string] Identificadores Negociação Recebível
sortDirection string Ordenação, default ASC.
sortParameter string Parâmetro de ordenação, default Id.
statuses array[string] Status da operação
managedParticipantId string Identificador Participante Administrado
/trade-repository/merchants/search
Parâmetro Tipo Descrição
errorCodes array[string] Código de erro do arquivo
fileNames array[string] Nome dos arquivos
issuerControlNumbers array[string] Número de controle do emissor
issuerIspbs array[string] ISPB do emissor
mainParticipantIds array[string] Identificador Participante Principal
managedParticipantIds array[string] Identificador Participante Administrado
maximumFileDate string($date) Data máxima de geração do arquivo
maximumReferenceDate string($date) Data máxima de referência
minimumFileDate string($date) Data mínima de geração do arquivo
63
minimumReferenceDate string($date) Data mínima de referência
pageNumber integer($int32) Número da página consultada, default em 0.
Tamanho de registros disponíveis por página,
pageSize integer($int32)
default 10.
recipientControlNumbers array[string] Número de controle do destinatário
recipientIspbs array[string] ISPB do destinatário
responseSituations array[string] Situação de Retorno da Requisição
sortDirection string Ordenação, default ASC.
sortParameter string Parâmetro de ordenação, default Id.
/trade-repository/cancel-operations/response/search
Parâmetro Tipo Descrição
requestResults string Código de erro do arquivo
receivableUnitIdentifiers string Nome dos arquivos
operationIdentifiers string Identificadores da Operação de Negociação
pageNumber integer($int32) Número da página consultada, default em 0.
Tamanho de registros disponíveis por página,
pageSize integer($int32)
default 10.
sortDirection string Ordenação, default ASC.
sortParameter string Parâmetro de ordenação, default Id.
managedParticipantId string Identificador Participante Administrado
64
/trade-repository/receivable-units/consult-cip
Parâmetro Tipo Descrição
CNPJ (Completo ou Base) ou CPF Usuário Final
recipientDocument string
Recebedor,
paymentScheme string Código Instituidor Arranjo Pagamento
participantDocumentId string CNPJ da Credenciadora/Subcredenciadora.
availableAmount double Valor Livre.
startSettlementDate string($date) Data Inicial Prevista da Liquidação.
endSettlementDate string($date) Data Final Prevista da Liquidação.
negotiationTypeIndicator string Indicador do Tipo Negociação.
receivableOwnerDocument string CNPJ (Completo ou Base) ou CPF do Titular.
pageNumber integer($int32) Número da página consultada, default em 0.
Tamanho de registros disponíveis por página,
pageSize integer($int32)
default 10.
/trade-repository/operations/financier/receivable-units-available
Parâmetro Tipo Descrição
Identificador do Conjunto de Unidades de
receivableUnitId string
Recebível
pageNumber integer($int32) Número da página consultada, default em 0.
Tamanho de registros disponíveis por página,
pageSize integer($int32)
default 10.
/trade-repository/receivable-schedules/search
Parâmetro Tipo Descrição
fileNames string Nome do arquivo Recebido
minimumCreatedAt string($date) Data mínima de recebimento dos arquivos
maximumCreatedAt string($date) Data máxima de recebimento dos arquivos
paymentSchemes array[string] Código Instituidor Arranjo de Pagamento
finalUsers array[string] CPF ou CNPJ do usuário final recebedor
minimumSettlementDate string($date) Data mínima de Liquidação do Recebível
maximumSettlementDate string($date) Data máxima de Liquidação do Recebível
pageNumber integer($int32) Número da página consultada, default em 0.
Tamanho de registros disponíveis por página,
pageSize integer($int32)
default 10.
managedParticipantId string Identificador Participante Administrado
65
9. Códigos HTTP
O integrador deve estar preparado para receber os seguintes códigos do protocolo
HTTP:
Código Descrição
200 Requisição efetuada com sucesso.
201 Recurso criado com sucesso.
204 No Content - Consulta sem resultado.
400 Não foi possível receber as informações.
401 Acesso negado. O usuário não tem permissão para realizar a ação solicitada.
404 Recurso não encontrado.
406 Informações não são válidas.
408 Timeout.
409 Conflito de informações.
417 Erro no processamento das informações.
424 Erro nas dependências da aplicação.
500 Erro interno.
502 Erro do servidor.
503 Serviço fora do ar.
66
10. Material Confidencial
Todas as informações contidas neste documento são consideradas privilegiadas e
pertencentes à RTM.
Sendo assim, nenhuma parte deste documento poderá ser reproduzida, divulgada ou
franqueada a terceiros, por quaisquer meios, sem a permissão da RTM.
67