Idiomas

Integração via Arquivos

A plataforma permite que o participante faça upload de arquivo com negócios e requisições de especificação a partir da interface Web. A integração por meio de arquivos é permitida para as operações definitivas (1052, 4052 e 3052) e compromissadas (1054, 1057) desde que não sejam operações de leilão.

Após o envio do arquivo as informações são processadas e lançadas na plataforma. Somente as requisições válidas são processadas. Os negócios e requisições não processados são sinalizados e neste caso, o participante deverá enviar um novo arquivo com as informações corretas ou utilizar um dos outros canais.

O arquivo deve seguir o layout disponível na plataforma, no menu Arquivo. Para preenchimento do arquivo, veja Layout do arquivo, neste documento.

Para confirmar as especificações em lote e fazer o download dos comandos, o participante poderá utilizar as novas funcionalidades “Confirmar todas as especificações” e “Listar comandos” sem precisar acessar uma a uma.

Upload do arquivo

O transmissor de comandos realiza o upload do arquivo, informando o participante o qual está representando, o departamento onde os negócios deverão ser lançados e um número sequencial para o arquivo que servirá como identificador para consultas posteriores. O número sequencial do arquivo deve ser único para o transmissor de comandos na data de movimento.

O arquivo deve conter somente negócios de um único departamento de um participante que será informado e será a parte enviada nas requisições.

O sistema verifica se o participante tem permissão para enviar o arquivo e registra o arquivo como recebido. O processamento do arquivo é assíncrono e ao final do processamento o seu status poderá ser: processado, processado com erros e inválido. Os detalhes do processamento estão descritos na seção Consultar arquivos deste documento.

Consultar arquivos

Para estar ciente sobre o processamento de um arquivo, é necessário consultar as informações na plataforma.

A consulta de arquivos exibe o status de cada arquivo:

  • Recebido – processamento ainda não iniciado.
  • Inválido – O arquivo é inválido por possuir erros que impedem seu processamento, como erro de layout, por exemplo.
  • Processado com erros – Pelo menos um negócio ou requisição não foi lançada no Pre-matching por conter erros.
  • Processado – Todos os negócios e requisições do arquivo foram lançados na plataforma com sucesso.

Os arquivos processados com erros sinalizam que pelo menos um erro ocorreu. Se o erro ocorrer em um negócio, o status da requisição deste negócio fica com erros e suas requisições não são validadas. Se o erro ocorrer em uma das requisições, o negócio referente a esta requisição, apesar de válido, não é lançado. Neste caso, o negócio ficará com o status não processado.

Detalhar arquivo

Os arquivos com os status processado e processado com erro podem ser detalhados. O detalhe do arquivo exibe a quantidade de negócios processados, não processados e com erros.

Ao selecionar um negócio, a plataforma exibe as informações do negócio, de suas requisições de especificação e os erros caso possuam.

Layout do arquivo

O arquivo possui o formato CSV, onde as informações são separadas por vírgula. A primeira linha do arquivo é um cabeçalho e as linhas seguintes representam um negócio ou uma requisição de especificação. Todas as informações devem estar entre aspas duplas (“SN000001”). O arquivo deve seguir a ordem da tabela abaixo e quando alguma informação não for compatível com o negócio ou a requisição, o campo deve ser enviado com aspas duplas (“”). Para maiores detalhes sobre a obrigatoriedade de cada tipo de negócio e requisição veja manual da plataforma Pre-matching disponível no Portal Selic.

Campo Descrição Formato
sequencialNegocio Número sequencial para identificação do negócio definido pelo participante. SN[0-9]{6}
SN seguido de um número com 6 dígitos.
Exemplo: SN000001
sequencialRequisicao Número sequencial para identificação da requisição definido pelo participante. SR[0-9]{6}
SR seguido de um número com 6 dígitos.
Exemplo: SN000001
codigoOperacao Código da operação 1052, 1054, 1057, 3052, 4052.
numeroComando Número do comando (operação) que será utilizado para registro no Selic. Lembrando que quando não informado o Pre-matching gera automaticamente. [0-9]{6}
6 Dígitos
parte Parte pelo qual o participante está atuando. CEDENTE, CESSIONARIO
iselicCedente ISelic do cedente da operação [0-9]{8}
8 dígitos
contaCedente Número da conta do cedente da operação com dígito verificador. [0-9]{9}
9 dígitos
Exemplo: 054289349
idFiscalCedente Identificação fiscal do cedente. CNPJ ou CPF
Somente números.
iselicCessionario ISelic do cessionário da operação [0-9]{8}
8 dígitos
contaCessionario Número da conta do cessionário da operação com dígito verificador. [0-9]{9}
9 dígitos
Exemplo: 054289349
idFiscalCessionario Identificação fiscal do cessionário. CNPJ ou CPF
Somente números.
codigoTitulo Código do título. [0-9]{6}
6 dígitos.
dataVencimento Data de vencimento do título. YYYY-MM-DD
Ano com 4 dígitos, mês com 2 dígitos e dia com 2 dí
Exemplo: 2022-05-07
(7 de maio de 2022)
codigoISIN Código ISIN do título.
quantidadeTitulos Quantidade de títulos Número inteiro.
precoUnitario Preço unitário do título. Exemplo: 10100.563
valorFinanceiro Valor financeiro do negócio. Exemplo: 10111110.45
Com somente duas casas decimais.
precoUnitarioRetorno Preço unitário de retorno da compromissada (se 1054). Exemplo: 10100.564
*a quantidade de casas decimais depende do tipo de operação, conforme definido no manual.
taxa Taxa do negócio de compromissada. Exemplo: 0.1258
Pode possuir 4 casas decimais.
dataRetorno Data de retorno da compromissada. YYYY-MM-DD
Ano com 4 dígitos, mês com 2 dígitos e dia com 2 dígitos.
Exemplo: 2022-05-07
(7 de maio de 2022)
dataLiquidacao Data de liquidação do termo. YYYY-MM-DD
Ano com 4 dígitos, mês com 2 dígitos e dia com 2 dígitos.
Exemplo: 2022-05-07
(7 de maio de 2022)

O campo sequencial negócio deve ser único para um negócio do participante na data de movimento. O campo sequencial requisição deve ser único para uma requisição do participante na data de movimento. Além disso, a requisição deve sempre fazer referência ao negócio do qual ela faz parte no arquivo. Essa referência deve ser feita utilizando o sequencial negócio mesmo sendo a linha referente a uma requisição.

O arquivo deve conter operações de somente um único departamento de um participante que deverá ser informado no momento do upload juntamente com o número sequencial do arquivo.

Português, Brasil