MANUAL TÉCNICO DE MENSAGEM - Integração das Clearings da
Contents
1. k y 4 1 1 3 3 Regras de Neg cios naan aan 4 1 1 3 4 Estrutura da 4 2 INFORMACOES GERAIS io 4 815 VALDACAO DA MENSAGEM MR 4 2 1 1 Estrutura das Mensagens ISO 20022 4 2 1 2 Schema de Customiza o 2 0000 00001000 6 2 1 3 Supplementary DEUS EE EET TT 7 2 1 4 Formato de Campos Omm 9 2 1 5 Grupos de Caracteres XML a pef 10 2 1 6 Validacao do SCO aan 10 2 1 7 Valida o de Erro T CNICO m ET 11 2 1 8 Valida o de Neg cio ii aan nanna aa 12 2 2 INFRAESTRUTURA DE COMUNICA O EET Ra ecommerce 12 2 2 1 Cabe alho da 12 2 2 1 1 Preenchimentos dos Campos do Cabe alho da 14 2 2 2 Cabe alho do Arquivo rrenan a aak aan naan 18 2 2 2 1 Preenchimentos dos Campos do Cabe alho do Arquivo 18 2 3 CEN RIO DE MENSAGENS E 5 rennen nnn 22 2 3 1 Cen rio de Mensagem de Erro nnne nnne nnns 22 2 3 2 Cen rio de Solicita o de 5 23 2 3 3 Cen rio de Envio de Arquivo pelo2. 23 2 4 PADR O DE NOME DE nannaa maan aan aan aan aan aan aan annan 24 2 9 LIMITE DE LAMANAIODEMENSAGEME Sean ae da on x UIS PO vac ae nie 24 3 FORMA DE IDENTIFICA O DO PARTICIPANTE eret tna am aan aan 25 3 1 FORMA DE PREENCHIMENTO DA IDENTIFICA O DO rne re 25 4 DEFINI O DE MENSAGENS 8 aa an ana aa aan naamaan tassa tea sa sna ssa tassa na 25 4 1 MENSAGEM DE ERRO T CNICO ERRORREPORTVOS 5 7 016 001 03 25 4 2 CABE ALHO APLICA O BUSINESS APPLICATION HEADER 001 001 01 26 4 3 CABE ALHO DO ARQUIVO BUSINESS GROUP HEADER 052 01 28 4 4 MENSAGEM DE REJEI O ADMI 002 001 01 MESSAGEREJECT esses 30 18 2 2013 amp A Nova Bolsa MANUAL TECNICO DE MENSAGEM 1 Cat logo de Mensagem 1 1 Introduc o 1 1 1 Prop sito e escopo do Cat logo de Mensagem O Cat logo de Mensagem descreve de forma detalhada todo o conjunto de mensagens baseadas na ISO customizadas para atender s necessidades da BM amp FBOVESPA dispon veis aos participantes O objetivo do
3. A Nova Bolsa MANUAL TECNICO DE MENSAGEM sd Cenario 3 Envio de Arquivo Farticipante BM amp FBOVESPA Arquivo Envia Arquivo Ex Cadastrar Conta em Lote Mensagem Arquivo Erro T cnico ErrorReportV03 tsmt 016 001 03 Cen rio 2 Sucesso Participante envia um arquivo para a BM amp FBOVESPA para cadastramento de conta em lote exemplo Em caso de nenhum erro t cnico encontrado enviado o arquivo solicitado sd Cenario 4 Envio de Arquivo Farticipante BM amp FBOVESPA Arquivo Envia Arquivo Ex Cadastrar Conta em Lote Arquivo Resposta do Envio do Arquivo Detalhe do Cadastramento da Conta 2 4 Padr o de Nome de Arquivo O padr o para nome de arquivos a ser postado para a BM amp FBOVESPA e Nome do Tipo do Arquivo underline Identifica o do Participante Sequencial de 4 posi es BVBG 001 01 001234560001 BVBG 001 01 001234560002 BVBG 001 01 001234560003 Observa o O sequencial de 4 posi es dever ser zerado todo dia ser incremental e deve iniciar o dia com 0001 2 5 Limite de Tamanho de Mensagem O limite m ximo para o tr fego de informa es nas mensagens da BM amp FBOVESPA de 2MB Mensagens acima deste limite podem n o ser processadas 24 BM amp FBOVESPA 18 2 2013 A Nova Bolsa MANUAL TECNICO DE MENSAGEM 3 Forma de Identificac o do Participante A identificac o dos participantes nas mensagens baseadas na ISO da BM amp FBOVESPA se
4. BM amp FBOVESPA 18 2 2013 A Nova Bolsa MANUAL TECNICO DE MENSAGEM MANUAL TECNICO DE MENSAGEM A implantac o da integrac o das clearings da BM amp FBOVESPA e do novo sistema de risco CORE Closeout Risk Evaluation depende de pr via autoriza o dos rg os reguladores BM amp FBOVESPA A Nova Bolsa MANUAL TECNICO DE MENSAGEM 18 2 2013 Historico de Versoes Data Vers o Descri o Respons vel 0811 2012 10 PE 28 12 2012 1 1 Inclus o do texto Em casos de mensagens publicas o campo To ter como conte do o valor PUBLIC no item 2 2 1 1 Preenchimentos dos campos do Cabecalho da Mensagem Alterac o do campo BusinessGroup BizGrp de 1 para 0 no item 4 8 Cabecalho do Arquivo Business Group Header bvmf 052 01 31 01 2013 1 2 Altera o do texto da p gina 24 Cen rio 2 Sucesso Altera o na estrutura do arquivo XSD da mensagem bvmf 052 01 item BusinessGroup BM amp FBOVESPA MANUAL TECNICO DE MENSAGEM 18 2 2013 A Nova Bolsa SUM RIO 1 CATALOGO DE MENS AGEN serere sl ida 4 INTRODU O ads 4 1 1 1 Prop sito e escopo do Cat logo de 4 1 1 2 Estrutura do Cat logo de Mensagem ss 4 1 1 3 Quebra das descri es de mensagens ss 4 1 1 3 1 da Mensagem TS 4 1 1 3 2 0
5. lt AcctSvcr gt Id lt Prtry gt Id ld1 Id lt gt lt d gt InvstmtAcct AcctPties lt AcctPties gt lt PrvsRef gt lt PrvsRef gt lt SplmtryDt gt lt SplmtryDt gt lt AcctOpnglnstrV02 gt lt Document gt 2 2 1 1 Preenchimentos dos campos do Cabecalho da Mensagem EX 18 2 2013 1 Cenario 1 Participante envia uma mensagem para a BM amp FBOVESPA para cadastrar uma conta Atributos BAH Conteudo From 3 123456 To BVMF BusinessMessageldentifier 00123456201112280000007890 MessageDefinitionldentifier bvmf 001 01 CreationDate 2011 12 28109 30 4 77 BM amp FBOVESPA 18 2 2013 A Nova Bolsa MANUAL TECNICO DE MENSAGEM Onde From Identifica o de quem envia a mensagem No exemplo acima 3 significa a categoria que o participante exerce por exemplo Participante de Negociac o e os n meros 123456 o n mero de identificac o do participante na BM amp FBOVESPA To Identifica o de quem receber a mensagem No exemplo acima BVMF Em casos de mensagens p blicas o campo To ter como conte do o valor PUBLIC BusinessMessageldentifier Identificador nico da mensagem Este identificador composto por e As 8 primeiras posi es o c digo do participante seguida do ano m s e dia e mais um incremental de 10 posi es MessageDefinitionldentifier Identifica o tipo da mensagem CreationDate Data de envio da mensagem 2 Cen rio 2 BM a
6. 1 BusinessApplicati Bloco com informac es do header da der onHeaderVO1 mensagem BusinessMess BizMsgldr 1 1 Max35Text Identificador nico da mensagem Este ageldentifier identificador composto por As 8 primeiras posic es 6 o c digo do participante seguida do ano m s e dia mais um incremental de 10 posic es 5 hh ase kk ionldentifier bvmf 001 01 teTime Neg cios header foi criada quem envia a mensagem Ho uM 1 1 Identifica o da organiza o que est entification enviado a mensagem Identification 0 1 BUD OChoice Identifica o nica e inequ voca do que est enviando a KAAN KIN KAL E ESS entification fication7 enviando a mensagem Other Othr 0 GenericOrganisati Unico de identifica o de uma onldentification1 organizac o como atribu do por uma institui o utilizando um schema de identifica o institui o kasi 0 Max35Text Entidade gue emitiu a identificac o Ex BM amp FBOVESPA Este campo deve assumir o valor default 40 ficationSchemeNa me1Choice Proprietary Prtry 1 1 Max35Text C digo do tipo de documento Ex CODIGO PARTICIPANTE BVMF Este campo deve ser preenchido com o valor default 39 To 1 1 Party9Choice Este bloco cont m a identificac o de quem receber a mensagem a j rm 5 entification 42 recebendo a mensagem Identification 0 1 Party10Choice Identifica o nica e inequ v
7. Aplica o melhora o roteamento da mensagem quando de sua chegada interface do endere ado Exemplo AppHdr xsi schemalocation urn iso std iso 20022 tech xsd head 001 001 01 head 001 001 01 xsd xminsz urn iso std iso 20022 tech xsd head 001 001 01 xmlns xsi http www w3 org 2001 XMLSchema instance gt BizMsgldr 00000199201112287122455 lt BizMsgldr gt lt MsgDefldr gt bvmf 001 01 lt MsgDefldr gt CreDt 2001 12 17T09 30 47 0Z CreDt Fr lt Orgld gt Id lt Orgld gt lt Othr gt Id 3 199 lt 1 gt lt SchmeNm gt lt Prtry gt 39 lt Prtry gt lt SchmeNm gt lt Issr gt 40 lt Issr gt lt Othr gt lt Orgld gt lt d gt lt Orgld gt lt Fr gt lt To gt lt Orgld gt Id lt Orgld gt lt Othr gt Id BVMF lt Id gt lt SchmeNm gt lt Prtry gt 39 lt Prtry gt lt SchmeNm gt 13 BM amp FBOVESPA A Nova Bolsa MANUAL TECNICO DE MENSAGEM lt Issr gt 40 lt Issr gt lt Othr gt lt Orgld gt lt d gt lt Orgld gt lt To gt lt AppHdr gt Document xmlns urn bvmf 001 01 AccountOpeninglnstructionV02 xsd gt lt AcctOpnglnstrV02 gt InstrDtls lt AcctApplld gt AcctApplld1 lt AcctApplld gt lt OpngTp gt NEWA lt OpngTp gt InstrDtls InvstmtAcct lt XtndedOwnrshTp gt X lt XtndedOwnrshTp gt lt AcctSvcr gt lt Prtryld gt lt Id gt 3 199 lt Id gt lt SchmeNm gt 39 lt SchmeNm gt lt Issr gt 40 lt Issr gt lt Prtryld gt
8. Manual T cnico habilitar o leitor a encontrar as informac es necess rias relacionadas mensageria para estabelecer o funcionamento dos sistemas dos participantes que se comunicam com os sistemas BM amp FBOVESPA 1 1 2 Estrutura do Cat logo de Mensagem O in cio do Cat logo de Mensagens 6 dividido em algumas sec es S o elas e Escopo Fornece o escopo geral do documento e Lista de Mensagens Cont m a lista das mensagens baseadas na ISO necess rias para suportar os processos entre a BM amp FBOVESPA e os participantes Essa sec o contempla informac es do emissor e receptor da mensagem al m da ac o da mensagem e Fluxo da Mensagem Descreve o uso da mensagem em uma forma de sequenciamento de cen rios Esta sec o dividida em cen rio de sucesso e cen rio de erro Nestes cen rios poss vel identificar qual a mensagem de resposta correspondente mensagem que iniciou o fluxo 1 1 3 Quebra das descric es de mensagens 1 1 3 1 Escopo da mensagem Esta sec o prov informac es gerais sobre o escopo da mensagem dentro do contexto da BM amp FBOVESPA Al m de ilustrar o prop sito da mesma a BM amp FBOVESPA tamb m informa sobre o emissor receptor da mensagem 1 1 3 2 Uso da Mensagem Esta sec o cont m informac es complementares da mensagem que pode ser se existir que tipo de resposta quem envia a mensagem deve receber 1 1 3 3 Regras de Neg cios Esta sec o descrever as regras de neg cio associadas me
9. cios header foi criado quem envia a mensagem D entification enviado a mensagem Identification 0 1 PUES Identifica o nica e inequ voca do mensagem entification fication7 enviando a mensagem Other Othr 0 GenericOrganisati Unico de identificac o de uma onldentification 1 organizac o como atribuido por uma institui o utilizando um schema de identifica o institui o lun NN 0 Max35Text Entidade que emitiu a identifica o Ex BM amp FBOVESPA Este campo deve assumir o valor default 40 ficationSchemeNa me1Choice Proprietary Prtry 1 1 Max35Text C digo do tipo de documento Ex CODIGO PARTICIPANTE BVMF Este campo deve ser preenchido com o valor default 39 quem receber a mensagem 1 entification 42 recebendo a mensagem Identification 0 1 Party10Choice Identifica o nica e inequ voca do mensagem a mensagem o entification fication7 recebendo a mensagem Other Othr 0 GenericOrganisati Unico de identifica o de uma onldentification organizac o como atribuido por uma institui o utilizando um schema de identifica o institui o MESE Hem 0 Max35Text Entidade gue emitiu a identificac o Ex BM amp FBOVESPA Este campo deve assumir o valor default 40 SchemeName SchmeNm 0 1 Organisationldenti C digo do tipo de documento ficationSchemeNa me
10. d atrav s de tr s campos Identification Issuer e SchemeName Em algumas mensagens somente os campos Identification e Issuer s o utilizados 3 1 Forma de Preenchimento da Identifica o do Participante Os campos de identificac o do participante devem ser preenchidos da seguinte forma Identification Este campo composto pela identifica o da categoria papel que o participante exerce na mensagem que est enviando seguido do n mero de identificac o conhecido pelo pr prio participante A identifica o da categoria encontra se no item ExternalRole no arquivo externo chamado ExternalCodeList dispon vel no site da BM amp FBOVESPA Ex 3 123456 Onde 3 a categoria Participante de Negociac o que o participante exerce 123456 o numero de identificac o conhecido pelo participante Issuer Neste campo deve ser informada a entidade que emitiu a identifica o do participante Este campo deve ser preenchido com o valor default 40 Este conte do significa que a BM amp FBOVESPA que emitiu essa identificac o SchemeName Neste campo deve ser informado do tipo de documento de identifica o do participante Este campo deve ser preenchido com o valor default 39 Este conteudo significa que o tipo de documento CODIGO PARTICIPANTE BVMF conforme descrito no item Externalldentification T ypeCode no arquivo externo ExternalCodeList 4 Definic o de Mensagens T cnicas 4 1 Mensagem de Erro T cnico ErrorR
11. final da mensagem MessageDefinition Isso significa que permitida a extens o de qualquer parte da mensagem LOITIDOTIETIL i Message Element 1 Message Element 2 Message Element 3 Message Element 4 m Extension Message Extension Component 1 Place and Name New message element 1 New message element 2 Message Element 5 Message Element 6 Message Element 7 e LUIFTIDOTICFIL xtension Component Place and Name New message element 3 Message Element amp 2 Message xtension Component 3 Place and Name New message element 4 Message Element x Message Elen A estrutura da mensagem estendida faz uso de outro schema XML o schema MessageDefinition Extens o para especificar a extens o BM amp FBOVESPA MANUAL TECNICO DE MENSAGEM 18 2 2013 A Nova Bolsa Contem a localizac o do elemento da mensagem est sendo estendido Este D qe a ua campo opcional een ss m Ww K teses E mg Cont m as informa es que est o sendo estendidas Figura do componente de SupplementaryData lt Document gt lt CorpActnNtfctn gt lt CorpActnOptnDtls gt lt CshMvmntDtls gt Information that is extended lt CshMvmntDtis gt lt CorpActnOptnDtls gt lt CorpActnNtfctn gt lt SplmtryData gt lt PlcAndNm gt Document CorpActnNtfctn CorpActnOptnDtls CshMvmntDtls lt PlcAndNm g
12. schemaLocationz urn bvmf 001 01 AccountOpeninglnstructionV02 xsd bvmf 001 01 xsd gt lt p AcctOpnglnstrV02 gt lt p lnstrDtls gt lt p OpngTp gt NEWA lt p OpngTp gt lt p lnstrDtls gt lt p lnvstmtAcct gt lt p XtndedOwnrshTp gt X lt p XtndedOwnrshTp gt lt p AcctSvcr gt lt p Prtryld gt lt p ld gt p ld lt p ld gt lt p Prtryld gt lt p AcctSvcr gt lt p ld gt lt p Prtry gt lt p ld gt p ld lt p ld gt lt p Prtry gt lt p ld gt lt p lnvstmtAcct gt lt p AcctOpnglnstrV02 gt lt p Document gt Quando uma mensagem ISO 20022 enviada o documento XML faz refer ncia a um arquivo de defini o de mensagens Este arquivo cont m o schema que valida estrutura da mensagem dentro dele existem as regras e defini es a serem utilizadas As defini es de mensagens s o compostas de message components choice components e message elements Message Componenis s o itens usados para a cria o de uma mensagem e cont m um conjunto de Message Elements Na ISO 20022 estes Message Components s o geralmente ligados a um componente de neg cio particular Uma vis o abrangente de os componentes padronizados de mensagens ISO 20022 est dispon vel no Dicion rio de Dados da ISO 20022 Message Elements comp em os Message Components e s o identificados exclusivamente em cada Message Component Na ISO 20022 estes elementos da mensagem s o geralmente relacionados a um elemento de neg
13. 1Choice Proprietary Prtry 1 1 Max35Text C digo do tipo de documento Ex C DIGO PARTICIPANTE BVMF Este campo deve ser preenchido com o valor default 39 27 MANUAL T CNICO DE MENSAGEM BM amp FBOVESPA 18 2 2013 A Nova Bolsa MANUAL TECNICO DE MENSAGEM 4 3 Cabecalho do Arguivo Business Group Header bvmf 052 01 Exchange Xchg 1 1 BusinessFileHea Cabecalho do arguivo de lote de derV01 mensagens trocadas entre a BM amp FBOVESPA e os participantes e vice e versa BusinessGrou BizGrpDesc 1 1 BusinessGroupD Este bloco contem informac es o pDescription escription cabecalho do arguivo de lote de mensagens TE 1 1 Party9Choice Este bloco contem a R de Orgld 1 1 Partyldentificatio Identifica o da organiza o que est means OM O go Identification 0 1 Party10Choice Identifica o nica e inequ voca do participante que est enviando a mensagem KAALIN IF entification tification7 enviando a mensagem Other Othr 0 GenericOrganisa Unico de identifica o de uma tionldentification organizac o como atribu do por uma 1 institui o utilizando um schema de identifica o Identification 1 1 Max35Text Identifica o atribu da para uma institui o Issuer Issr 0 1 Max35Text Entidade que emitiu a identifica o Ex assumir o valor default 40 tificationScheme Name1 Choic
14. 5 Child Acc 504 Custodian ID 5000 Finality 12345 22 18 2 2013 BM amp FBOVESPA A Nova Bolsa MANUAL TECNICO DE MENSAGEM 2 3 2 Cen rio de Solicitac o de Arguivos Os cen rios abaixo ilustram o comportamento de arquivos nos casos de sucesso e erro Cen rio 1 Erro O participante solicita um arquivo para a BM amp FBOVESPA e baseado nos par metros filtros utilizados na mensagem enviada n o 6 poss vel gerar o arquivo solicitado Neste caso 6 enviada a mensagem arquivo Message Reject admi 002 001 01 ao participante informando o motivo da rejei o da solicita o sd Cenario1 Erro Farticipante BM amp FBOVESPA Solicita Arguivof Mensagem admi 002 001 01 Message Reject Cen rio 2 Sucesso Participante solicita um arquivo De acordo com par metros utilizados na solicitac o 6 poss vel gerar o arquivo com sucesso Neste caso o arquivo disponibilizado para download sd Cenario 2 Sucesso Farticipante BM amp FBOVESPA Arquivo Disponivelf 2 3 3 Cenario de Envio de Arguivo pelo Participante Cenario 1 Erro Participante envia um arguivo para a BM amp FBOVESPA para cadastramento de conta em lote exemplo A BM amp FBOVESPA n o consegue identificar o tipo ou arquivo ou at mesmo n o poss vel abrir o mesmo Neste caso enviada a mensagem ErrorReportV03 tsmt 016 001 03 ou arquivo contendo a mensagem ErrorReportV03 tsmt 016 001 03 23 BM amp FBOVESPA 18 2 2013
15. Namespace urn bvmf 001 01 AccountOpeninglnstructionV02 xsd xmlns urn bvmf 001 01 AccountOpeninglnstructionV02 xsd xmlns xs http www w3 org 2001 XMLSchema gt lt xs element name Document type Document gt xs complexType name Document gt lt xs seguence gt lt xs element name AcctOpnglnstrV02 type AccountOpeninglnstructionV02 gt lt xs seguence gt lt xs complexType gt lt xs complexType name Accountidentification1 gt lt xs seguence gt lt xs element name Prtry minOccurs 1 maxOccurs 1 typez SimpleldentificationInformation gt lt xs seguence gt lt xs complexType gt xs complexType name AccountParties5 gt lt xs seguence gt lt xs element namez PmryOwnr minOccurs 1 maxOccurs 1 type InvestmentAccountOwnershiplnformation5 gt lt xs seguence gt lt xs complexType gt xs simpleType name CountryCode gt lt xs restriction base xs string gt lt xs pattern valuez A Z 2 2 lt xs restriction gt lt xs simpleType gt 2 1 7 Validac o de Erro Tecnico Com base no schema BM amp FBOVESPA a interface BM amp FBOVESPA realiza as seguintes validac es tecnicas para cada inst ncia mensagem arquivo recebido e Estrutura XML a partir do elemento de raiz e Sequenciamento elemento ou seja sua ordem prescrita e Indexerelac es entre os diversos elementos e Cardinalidade dos elementos de mensagens por exemplo se todos os elementos obrigat rios est o presentes ou se
16. cio particular Message Elements s o compostos de tipos de dados simples e complexos Todos os Message Elements possuem estes tipos de dados para especificar o formato dos valores poss veis Tipos de dados simples servem para definir o formato do preenchimento do campo O tipo simples abaixo demonstra como o c digo da moeda deve ser preenchido lt xs simple Type name ActiveCurrencyCode gt lt xs restriction base xs string gt lt xs pattern value A Z 3 3 gt lt xs restriction gt BM amp FBOVESPA 18 2 2013 A Nova Bolsa MANUAL TECNICO DE MENSAGEM lt xs simpleType gt Os tipos de dados Complexos permitem a utiliza o das op es de Choice e Sequence as quais descrevem os caminhos que podem ser percorridos pela estrutura da mensagem No exemplo abaixo o Choice fornece a op o de como obter a identifica o de um Participante de Negocia o lt xs complexType name Partyldentification23Choice gt lt xs sequence gt lt xs choice gt lt xs element name BICOrBEI type AnyBICldentifier gt lt xs element name PtyID type Genericldentification1 gt lt xs choice gt lt xs sequence gt lt xs complexType gt Os grupos de tipos dados ISO 20022 est o padronizados atrav s de representa o de classes Estas classes fornecem um conjunto de dados poss veis que podem ser inseridos no Message Element Por exemplo o message element Bank Identifier pode ser atribu
17. conformidade com a mensagem original ISO 20022 Por exemplo os itens opcionais podem ser removidos ou transformados em obrigat rios as escolhas choices podem ser removidas para manter nenhuma ou menos opc es as listas de c digo interno podem ser reduzidas para o subconjunto de c digos que ser o efetivamente utilizados o tamanho dos campos de texto pode ser reduzido etc A vers o refere se evoluc o das necessidades das mensagens e correc o de poss veis problemas e erros de uma mensagem Ap s a publicac o de uma nova vers o de mensagem a forma de utilizar esta mensagem muda para a nova maneira Cada variante possui uma vers o atual que geralmente a mais recente A nova vers o e a vers o antiga coexistir o por um determinado tempo a fim de facilitar a migrac o dos sistemas Exemplo Dentro da mensagem Error Report tsmt 016 001 03 o n mero 001 reflete a variac o da mensagem em uso enquanto o n mero 03 reflete a vers o atual da varia o da mensagem utilizada O conte do do arquivo de schema portanto um subelemento do elemento raiz Semelhante a todos os outros elementos dentro do arquivo de schema o elemento raiz tamb m tem uma tag de fim no final do arquivo de schema O exemplo a seguir ilustra uma estrutura de mensagem ISO 20022 lt xml version 1 0 encoding UTF 8 gt p Document xmlns p urn bvmf 001 01 AccountOpeninglnstructionV02 xsd xmlns xsi http www w3 org 2001 XMLSchema instance xsi
18. dicador Boleano Tipo de campo que indica Sim ou N o para um elemento informado no padr o ISO 20022 formato YesNolndicator Preenchimento gt True Simou gt False N o Exemplo lt Wrnglnd gt true lt Wrnglnd gt Formato Data Os campos Data s o informados no padr o ISO 20022 no formato ISODate YYYY MM DD Exemplo lt Date gt 2012 07 18 lt Date gt Formato Data e Hora Os campos Data e Hora s o informados no padr o ISO 20022 no formato ISODateTime YYYY MM DDThh mm ss Exemplo lt Date 2012 07 18113 40 23 lt Date gt Formato Num rico separador decimal dos campos num ricos deve ser ponto deve ser usado separador de milhar nos campos num ricos Para valores negativos os campos num ricos devem ser preenchidos com o sinal negativo valores entre par nteses n o com Formato Texto texto n o deve ser preenchido com caracteres especiais Sempre deve ser preenchido com letra mai scula Indicador de Sinal Tipo de campo que indica Positivo ou Negativo para um valor informado no padr o ISO 20022 formato PlusOrMinuslndicator Preenchimento gt True Positivo ou gt False Negativo Exemplo lt Sign gt true lt Sign gt Formato N mero de Telefone informado no padr o ISO 2002 formato PhoneNumber Campo alfanum rico 30 posi es Inicia com um caractere seguido do c digo do pa s 1 a caracte
19. do classe Bl Cldentifie ou message element Text pode ser atribu do representa o de classe Max35Text Choice components permitem ao usu rio a escolha entre v rias possibilidades O usu rio pode escolher apenas uma op o poss vel na inst ncia Outro termo que especifica um particionamento dentro de uma inst ncia da mensagem o Message Item Tal item pode ser tanto um bloco de constru o de mensagem como um Message Element Os Message ltems que ocorrem como tags XML dentro da defini o da mensagem podem aparecer em qualquer n vel de alinhamento Um bloco de constru o da mensagem um Message Item espec fico para a mensagem em quest o ou seja O usu rio n o pode encontr lo no Dicion rio de Dados ISO 20022 Dentro do esquema correspondente da mensagem o bloco de constru o deve ser definido no primeiro n vel da mensagem Isto n o para ser confundido com agrupamentos reutiliz veis de um ou mais elementos de mensagem conhecidos como Message Components ou seja os quais o usu rio pode encontrar no dicion rio de dados ISO 20022 2 1 2 Schema de Customiza o BM amp FBOVESPA Baseado no schema 15020022 o schema BM amp FBOVESPA foi desenhado para atender s necessidades locais de neg cio A personaliza o dos arquivos de schema usados na BM amp FBOVESPA segue uma abordagem particular que combina as necessidades dos participantes terem uma l gica coerente em todas as mensagens e a n
20. do pDetails etails arquivo Ex emissor receptor identificac o do lote quantidade de mensagens contidas no lote etc BusinessGrou BizGrpldr 1 1 Max35Text Identificador nico do lote de arquivo pldentifier Este identificador composto por As 8 primeiras posic es o c digo do participante seguida de um incremental de 4 posi es TU FI fMessage arquivo BusinessGrou BizGrpTp 1 1 Max35Text Tipo do arquivo Este campo determina pType quais s o os tipos de mensagens permitidas dentro do lote de arquivo Ex BVBG 002 01 CreationDateA CreDtAndTm 1 1 ISODateTime Data e hora do arguivo no formato 2001 12 17T09 30 47 0Z MessageType MsgTpDef 1 MessageTypeDe Este bloco cont m os tipos de Definition finition mensagens contidas e a quantidade por tipo de mensagem dentro do arquivo E LL NR tionldentifier bvmf 001 01 NumberOfMes NbOfMsg 1 1 de mensagens por tipo sage BusinessGrou BizGrp 0 BusinessGroup Cont m os dados da s mensagem ns p contidas no arquivo 4 4 Mensagem de Rejeic o admi 002 001 01 MessageReject RelatedReference RitdRef 1 1 MessageReference Refere se identifica o da mensagem previamente recebida e para a qual a rejei o notificada Reference 1 1 Max35Text Identificac o emitida pelo participante emissor da mensagem previamente recebida pela BM amp FBOVESPA Esta refer ncia deve ser nica
21. e Proprietary Prtry 1 1 Max35Text C digo do tipo de documento Ex CODIGO PARTICIPANTE BVMF Este campo deve ser preenchido com o valor default 39 To 1 1 Party9Choice Este bloco contem a s de Om TT oo Dr TESE entification n42 recebendo a mensagem Identification 0 1 Party10Choice Identifica o nica e inequ voca do participante que est recebendo a mensagem ft EO SETE entification tification7 recebendo a mensagem Other Othr 0 GenericOrganisa Unico de identifica o de uma tionldentification organizac o como atribu do por uma 1 institui o utilizando um schema de identifica o 1 1 Max35Text Identifica o atribu da para uma institui o inui Issr 0 1 Max35Text Entidade que emitiu a identificac o Ex BM amp FBOVESPA Este campo deve assumir o valor default 40 SchemeName SchmeNm 0 1 Organisationlden C digo do tipo de documento tificationScheme Name1 Choice Proprietary Prtry 1 1 Max35Text C digo do tipo de documento Ex CODIGO PARTICIPANTE BVMF Este campo deve ser preenchido com o valor default 39 BusinessGrou BizGrpDtls 1 1 BusinessGroupD Este bloco cont m detalhes do lote do pDetails etails arquivo Ex emissor receptor identifica o do lote quantidade de mensagens contidas no lote etc 28 18 2 2013 BM amp FBOVESPA A Nova Bolsa BusinessGrou BizGrpldr 1 1 Max35Text Identi
22. e caso a mensagem enviada pela BM amp FBOVESPA ao ator possui como informa o a regra de neg cio que foi violada 2 2 Infraestrutura de Comunica o 2 2 1 Cabe alho da Mensagem A despeito de qualquer discuss o em progresso sobre padroniza o na ISO um Cabe alho de Aplica o de forma geral definido para todas as mensagens que s o utilizadas na BM amp FBOVESPA O cabe alho de aplica o BAH Business Application Header e a mensagem devem estar contidos em um envelope de acordo com o item 1 7 do documento ISO 20022 Business Application Header Message Usage Guide Version 1 4 lt AppHdr gt ISO 20022 Business SUPPLE Appl Header lt Document gt Business ISO 20022 Message Message lt fDocument gt Em termos t cnicos o Cabe alho de Aplica o um documento XML separado do documento XML que representa a pr pria mensagem Ex 12 18 2 2013 BM amp FBOVESPA A Nova Bolsa MANUAL TECNICO DE MENSAGEM lt PayloadBVMF gt lt AppHdr gt lt AppHdr gt lt Document gt lt Document gt lt PayloadBVMF gt O cabecalho de aplicac o facilita o processamento da mensagem j que ele cont m a informac o necess ria para processamento centralizado Sem o Cabe alho de Aplica o esta informa o estaria dentro da mensagem em si ou no Cabe alho de Requisi o da mensagem 15020022 Uma vis o uniforme estrutural das informa es relevantes no Cabe alho de
23. ecessidade da BM amp FBOVESPA ter um schema de defini o til e eficiente seguindo os princ pios e Apesar da personaliza o os arquivos de schema BM amp FBOVESPA s o compat veis com os arquivos de schema 15020022 e Quando pertinente todos os elementos da mensagem 15020022 sem conex o direta com as necessidades dos usu rios ser o retirados da mensagem BM amp FBOVESPA e Quando pertinente a personaliza o BM amp FBOVESPA restringe tipos de elementos para uma utiliza o espec fica e Define o conte do necess rio de campos obrigat rios que n o podem ser retirados a partir dos arquivos de schema ISO e Restringe a lista de valores de c digo poss veis para os c digos nicos permitidos nas transa es BM amp FBOVESPA e Define os tamanhos dos valores permitidos nas transa es BM amp FBOVESPA e Define a quantidade de ocorr ncias dos elementos de mensagem permitidos nas transa es BM amp FBOVESPA e Define elementos que originalmente s o opcionais na ISO como obrigat rios de acordo com a necessidade e Restringe os caracteres permitidos para os utilizados na BM amp FBOVESPA seguindo o padr o e Define os campos num ricos aplic veis a BM amp FBOVESPA ex valores financeiros Com base na abordagem acima foram escolhidos 3 cen rios para exemplificar Cen rio 1 uma parte da mensagem cont m somente elementos suportados pela BM amp FBOVESPA e n o h necessidade de retirada de elementos Ce
24. ensagem de Negocio 2 Estrutura de um Arquivo de Neg cio 2 3 Cen rio de Mensagens e Arquivos 2 3 1 Cen rio de Mensagem de Erro T cnico A mensagem de erro t cnico ErrorReportVO3 tsmt 016 001 03 enviada ao participante quando encontrado algum problema nos itens de valida o listado no t pico 2 1 7 Valida o de Erro T cnico deste documento Exemplo en Trade ID 1 Trade Side Trade Date 02 02 2012 10 30 15 SecuritylD 001 SecuritylDSource H SecurityExchange BVMF Ticker symbol PETRA Allocation ID 1 IndividualAllocID 10 ty 25 Child Acc 501 Custadian ID 5000 Finality 27014 z Hb 1 P Securities Alocation Instruction bwmf 013 011 Trade ID 1 Trade Side Trade Date 02 02 2012 10 30 15 SecuritylD 001 SecuritylDSource H SecurityExchange BVMF Ticker symbol PETRA Allacatian ID 1 Trade 1 Trade Side Trade Date 02 02 2012 10 30 15 Allocation ID 1 IndividualAllocILr 12 IndividualAllocID 11 Qty 25 ty 25 Child Acc 503 Child Acc 502 Custodian ID 5000 Custodian ID 5000 Finality 28010 Finality 21016 ErrorReporvO3 mt 015 001 03 Related Message Transaction ID 1 Number of Errors 1 Sequence Number 1 Rulelndentificalon R21 Rule Description Business Group Header Trade ID 1 Trade Side Trade Date 02 02 2012 SecurityExchange BVMF Allocation ID 1 IndividualAllocID 13 Oty 2
25. entre todas as mensagens de mesmo nome emitidas pelo participante mensagem de rejei o eme BM amp FBOVESPA m joe jassa RETO rejeic o a e hat jojen itee gerada 30
26. eportV03 tsmt 016 001 03 LEN Reportldentificatio Rptld 1 1 Messageldentific Este bloco identifica o relat rio n ation 1 1 Identification dd t 1 Max35Text N mero de identificac o da mensagem KN CreationDateTime CreDtTm 1 1 ISODateTime Data de criac o da mensagem NumberOfErrors NbOfErrs 1 1 Counti Este bloco cont m o n mero total de erros identificados na mensagem rejeitada TTI 1 1 Number Numero total de erros identificados na mensagem rejeitada lm ErrorDescription ValidationResult3 Este bloco descreve o erro gue 6 a causa da rejeic o STE SeguenceNumber SegNb 1 1 N mero sequencial atribu do para o erro Ruleldentification Ruleld 1 1 Max35Text Identificac o do c digo da regra que foi violada pela mensagem rejeitada I RuleDescription 1 1 Max350Text Detalhes da descric o da regra Liu mM DEM 0 Elementldentifica Este bloco cont m os elementos que violaram tion3 a regra 1 1 Max350Text Especifica a partir da raiz da mensagem o caminho completo do elemento que violou uma regra ElementName ElmtNm 1 1 Max35Text Nome do elemento gue violou a regra ElementValue ElmtVal 0 1 Max140Text Conte do do elemento que violou a regra 25 BM amp FBOVESPA 18 2 2013 A Nova Bolsa MANUAL TECNICO DE MENSAGEM 4 2 Cabecalho Aplicac o Business Application Header head 001 001 01 ApplicationHea AppHar 1
27. fMessage Quantidade de mensagens existente no arquivo BusinessGroupType Nome do tipo do arquivo CreationDate Data de envio do arquivo MessageDefinitionldentifier Identifica o tipo da mensagem NumberOfMessage Quantidade de mensagem do tipo MessageDefinitionldentifier 2 Cen rio 2 BM amp FBOVESPA responde ao participante o lote acima enviado Atributos Cabe alho Arquivo From To BusinessGroupldentifier TotalNumberOofMessage BusinessGroupType Creation Date MessageDefinitionidentifier NumberOfMessage MessageDefinitionidentifier NumberOfMessage Related From To BusinessGroupldentifier TotalNumberOfMessage BusinessGrouplype CreationDate MessageDefinitionldentifier NumberOfMessage Conte do BV 3 123456 0001230001 5 BVBG 002 01 2012 01 27110 50 477 bvmf 002 01 tsmt 016 001 03 1 3 123456 BVMF 001234500001 5 BVBG 001 01 2012 01 2 110 30 4 77 bvmf 001 01 5 20 BM amp FBOVESPA A Nova Bolsa MANUAL TECNICO DE MENSAGEM 18 2 2013 21 BM amp FBOVESPA A Nova Bolsa MANUAL TECNICO DE MENSAGEM 18 2 2013 Para se comunicar um usu rio ou uma aplicac o podem enviar mensagens nicas em diferentes intervalos de tempo ou um arquivo contendo m ltiplas mensagens Ambos arquivos e mensagens s o enviados dentro de um envelope que pode ser comparado a uma p gina de rosto j este que cont m informa o sobre o conte do Cabe alho do Lote Mensagem de Negocio 1 M
28. ficador nico do lote de arguivo pldentifier Este identificador composto por As 8 primeiras posic es o c digo do participante seguida de um incremental de 4 posi es TotalNumberO TtINbOfMsg 1 1 Number Numero total de mensagens contidas no fMessage arguivo BusinessGrou BizGrpTp 1 1 Max35Text Tipo do arquivo Este campo determina pType quais s o os tipos de mensagens permitidas dentro do lote de arquivo Ex BVBG 002 01 CreationDateA CreDtAndTm 1 1 ISODateTime Data e hora do arquivo no formato ndTime YYYY MM DDThh mm ss sssZ Ex 2001 12 17T09 30 47 0Z MessageType MsgTpDef 1 MessageTypeDe Este bloco cont m os tipos de Definition finition mensagens contidas e a quantidade por tipo de mensagem dentro do arquivo MessageDefini MsgDefldr 1 1 Max35Text C digo do tipo da mensagem Ex tionldentifier bvmf 001 01 ws Kia vei sage Related Ritd 0 1 BusinessGroupD Especifica o cabe alho do arquivo que escription foi enviado anteriormente Este campo somente ser utilizado quando for uma resposta de arquivo quem envia a mensagem NEM entification n42 enviado mensagem Identification 0 1 Party10Choice Identifica o nica e inequ voca do mensagem EC CETTE entification tification7 enviando a mensagem Other Othr 0 51 GenericOrganisa Unico de identifica o de uma tionldentification organizac o como atribuido por uma 1 insti
29. gs de in cio e fim possuem identifica o correspondente exatamente uma outra e s o case sensitives e mensagem tem um elemento de raiz que cont m todos os outros elementos Em contraste com outras formas de representa o a defini o de documentos XML bastante rigorosa Os processadores XML n o podem produzir resultados razo veis se encontrarem erros de sintaxe Qualquer viola o de sintaxe implica automaticamente na interrup o do processamento de mensagem e no envio de uma notifica o de erro para o remetente Toda mensagem ISO 20022 bem formada que chega interface BM amp FBOVESPA passa por uma verifica o da validade de acordo com as regras contidas nos arquivos de schema BM amp FBOVESPA Esses schemas BM amp FBOVESPA tornam a estrutura da mensagem vis vel para o usu rio e fornecem todas as explica es necess rias sobre as valida es que a mensagem sofre Os arquivos de schema BM amp FBOVESPA definem e Todos os elementos e atributos na mensagem e Quais elementos s o elementos filhos e sobre a sua ordem espec fica e n mero 10 BM amp FBOVESPA 18 2 2013 A Nova Bolsa MANUAL TECNICO DE MENSAGEM e Tipos de dados aplic veis a um elemento espec fico ou atributo Poss veis valores aplic veis a um elemento espec fico ou atributo Exemplo xml versionz 1 0 encoding UTF 8 gt lt Data de Gera o 4 23 2012 4 06 21 PM gt lt xs schema elementFormDefault qualified target
30. mensagens etc Ele difere portanto do Cabecalho de Aplicac o que utilizado apenas para portar informac es adicionais relativas a uma mensagem isto a mensagem que segue 2 2 2 1 Preenchimentos dos campos do Cabecalho do Arquivo 1 1 Participante envia um lote para a BM amp FBOVESPA para cadastrar 5 contas Atributos Cabecalho Arquivo Conte do From 3 123456 To BVMF BusinessGroupldentifier 001234560001 TotalNumberOfMessage 5 BusinessGroupType BVBG 001 01 CreationDate 2012 01 2 110 30 4 7 MessageDefinitiontdentifier bvmf 001 01 NumberOfMessage 5 18 BM amp FBOVESPA A Nova Bolsa MANUAL TECNICO DE MENSAGEM 18 2 2013 19 amp A Nova Bolsa Onde MANUAL TECNICO DE MENSAGEM 18 2 2013 From Identifica o de quem envia o arquivo No exemplo acima 3 significa a categoria que o participante exerce por exemplo Participante de Negociac o e os n meros 123456 o n mero de identificac o do participante na BM amp FBOVESPA To Identifica o de quem receber o arquivo No exemplo acima BVMF Em casos de arquivos p blicos o campo To ter como conte do o valor PUBLIC BusinessGroupldentifier Identificador nico do arquivo Este identificador composto por e As primeiras posi es o c digo do participante seguida de um incremental de 4 posic es Este sequencial dever ser zerado todo dia e deve iniciar o dia com 0001 TotalNumberO
31. mp FBOVESPA responde ao participante a mensagem acima enviada atrav s da mensagem AccountDetailsConfirmation 15 BM amp FBOVESPA MANUAL TECNICO DE MENSAGEM 18 2 2013 A Nova Bolsa Atributos BAH From To BusinessMessageldentifier MessageDefinitionldentifier CreationDate Related From To BusinessMessageldentifier MessageDefinitionldentifier CreationDate Conte do BVMF 3 123456 00000123201112280000007899 bvmf 002 01 2011 12 28T11 00 277 3 123456 BVMF 00123456201112280000007890 bvmf 001 01 2011 12 28T09 30 477 16 BM amp FBOVESPA A Nova Bolsa Onde MANUAL TECNICO DE MENSAGEM 18 2 2013 17 BM amp FBOVESPA MANUAL TECNICO DE MENSAGEM 18 2 2013 A Nova Bolsa Related E um bloco gue referencia a mensagem gue originou essa mensagem de resposta 2 2 2 Cabecalho do Arguivo Al m do envio de mensagens a BM amp FBOVESPA suporta a troca de lotes de mensagens E poss vel portanto que o ator BM amp FBOVESPA envie e receba um arquivo composto por diversas mensagens Os arquivos recebidos pela BM amp FBOVESPA somente devem conter mensagens de um mesmo tipo por m os arquivos emitidos pela BM amp FBOVESPA podem conter mais de um tipo de mensagem A BM amp FBOVESPA utiliza um Cabecalho de Arquivo para assegurar o adequado processamento da mensagem de lote cabecalho de arquivo cont m informac es relativas ao identificador do lote a data de criac o do arquivo guantidade total de mensagens tipo de
32. n rio 2 Tanto BM amp FBOVESPA quanto os participantes n o precisam de certo elemento portanto ele ser removido amp 18 2 2013 A Nova Bolsa MANUAL TECNICO DE MENSAGEM Cen rio 3 Tanto BM amp FBOVESPA quanto os participantes n o precisam de certo elemento mas o mesmo obrigat rio no schema 15020022 portanto o elemento poder ser preenchido com um valor default Para os cen rios 1 2 e 3 a BM amp FBOVESPA somente permite elementos de mensagem de acordo com o schema BM amp FBOVESPA customizado rejeitando qualquer mensagem contendo elementos que n o fazem parte do schema Elementos de mensagem dentro do contexto do cen rio 3 dever o ser preenchidos tanto com um valor real quanto com um valor fict cio mas estes n o ser o processados A BM amp FBOVESPA rejeita mensagens durante a valida o de schema nos casos em que os atores e Usam elementos na mensagem que n o est o presentes no arquivo de schema BM amp FBOVESPA e Utilizam elementos permitidos mas n o respeitam os limites de valores definidos 2 1 3 Supplementary Data O componente SupplementaryData uma solu o t cnica que permite adicionar informa es a uma mensagem Message Definition de maneira controlada Este composto de 2 partes e Uma parte opcional que refere se ao MessageElement que est sendo estendido e Uma parte que cont m os dados estendidos Podemos encontrar o componente SupplementaryData no
33. nsagem 1 1 3 4 Estrutura da Mensagem O leitor pode encontrar orienta es sobre se o bloco e ou o item opcional ou obrigat rio que tipo de informac o ele contem alem do nome da tag utilizada no arquivo XML Esses arquivos de schema foram customizados para as necessidades da utilizac o espec fica das mensagens na BM amp FBOVESPA e portanto podem conter anota es explicativas e defini es esclarecendo essas especificidades poss veis 2 Informa es Gerais 2 1 Valida o da mensagem 2 1 1 Estrutura das mensagens ISO 20022 Os arquivos de schema XML em conformidade com a estrutura obrigat ria prevista pela ISO 20022 dever o seguir as seguintes regras e arquivo de schema requer uma declara o XML Esta declara o fornece informa es sobre vers o do XML usada e o conjunto de caracteres aplic veis na mensagem e Declara es XML n o possuem uma tag final pois n o fazem parte documento XML em sie portanto n o constituem um elemento XML Abaixo da declara o XML todos os arquivos de schema possuem um elemento raiz Este elemento raiz fornece o nome do arquivo de schema incluindo informa es sobre a varia o e vers o do arquivo de schema Uma 4 18 2 2013 amp A Nova Bolsa MANUAL TECNICO DE MENSAGEM variac o uma vers o restrita de uma mensagem global atenda s necessidades de uma determinada comunidade permanecendo em estrita
34. o n mero total de ocorr ncias permitido e Opc es de escolha entre os elementos da mensagem e Conjunto de caracteres utilizados e Valores da lista de c digo e seu formato e Exist ncia do BAH Business Application Header e Exist ncia do root da mensagem Quanto ao uso de prefixos de namespace as mensagens usadas na BM amp FBOVESPA n o suportam prefixos aos quais n o est o homologados pela institui o A mensagem de erro t cnico uma mensagem padr o 15020022 Tem como principais informa es Identifica o da mensagem Identifica o da mensagem origem Quantidade de erros encontrados Lista com detalhes dos erros encontrados Mensagem de erro t cnico ErrorReport tsmt 016 001 03 Consultar o arquivo XSD no site da BM amp FBOVESPA 11 BM amp FBOVESPA 18 2 2013 A Nova Bolsa MANUAL TECNICO DE MENSAGEM 2 1 8 Valida o de Neg cio Al m de valida es que verificam a sintaxe XML da mensagem baseada na ISO 20022 a BM amp FBOVESPA tamb m realiza valida es que s o baseadas no contexto de neg cio Esta valida o de neg cio da BM amp FBOVESPA ocorre com base em um conjunto regras de pr definidas Em caso de viola es de regras de neg cio a BM amp FBOVESPA informa aos atores diretamente atrav s de uma mensagem de resposta sa da Esta mensagem cont m todas as informa es que o ator precisa para compreender por que raz o uma determinada transa o n o foi completada Nest
35. oca do participante que est recebendo a mensagem 090 entification fication7 recebendo a mensagem Other Othr 0 GenericOrganisati Unico de identifica o de uma onldentification1 organizac o como atribu do por uma institui o utilizando um schema de identifica o institui o NEN 0 1 Max35Text Entidade que emitiu a identificac o Ex BM amp FBOVESPA Este campo deve assumir o valor default 40 SchemeName SchmeNm 0 1 Organisationldenti C digo do tipo de documento ficationSchemeNa me1Choice Proprietary Prtry 1 1 Max35Text C digo do tipo de documento Ex C DIGO PARTICIPANTE BVMF Este campo deve ser preenchido com o valor default 39 26 BM amp FBOVESPA 18 2 2013 A Nova Bolsa Related Ritd 0 1 BusinessApplicati Especifica o cabe alho Aplica o de onHeader1 Neg cios da Mensagem de neg cios para a que esta mensagem de Neg cios se refere Pode ser usado ao responder a uma consulta tamb m pode ser usado quando o cancelamento ou alterac o BusinessMess BizMsgldr 1 1 Max35Text Identificador nico da mensagem Este ageldentifier identificador composto por As 8 primeiras posic es o c digo do participante seguida do ano m s e dia mais um incremental de 10 Posi es EEE Care ionldentifier bvmf 001 01 CreationDate CreDt 1 1 ISONormalisedDa Data e hora em que esta mensagem de teTime Neg
36. res seguido de um car ter e uma combina o de n meros e caracteres seguindo do n mero do telefone seguido de um car ter seguindo do n mero do ramal Exemplo lt PhneNb gt 55 1 1 9999999999 9999 lt PhneNb gt BM amp FBOVESPA 18 2 2013 A Nova Bolsa MANUAL TECNICO DE MENSAGEM Formato Moeda e Valor separador decimal dos campos num ricos deve ser ponto deve ser usado separador de milhar nos campos num ricos valores negativos os campos num ricos devem ser preenchidos com o sinal negativo valores entre par nteses campos no padr o ISO 20022 informado o atributo Ccy moeda que deve ser preenchido conforme TABELA MOEDAS ISO 4217 Exemplo Valor Ccy BRL gt 10000 00 lt Valor gt e n o com 2 1 5 Grupos de caracteres XML UTF 8 6 o padr o de formato de dados para o schema XML utilizado nas mensagens BM amp FBOVESPA O conjunto de caracteres usado em um documento XML definido atrav s do par metro de codifica o na declara o XML Para as mensagens BM amp FBOVESPA a declara o a seguinte lt xml version 1 0 encoding UTF 8 gt UTF 8 uma codifica o de caracteres Unicode de comprimento vari vel Tem a capacidade para representar cada caracter do conjunto de caracteres Unicode e tamb m compat vel com a ASCII em contraste ao UTF 16 ou UTF 32 Em sua grande maioria as repre
37. senta es de caracteres em UTF 8 utilizam apenas um byte de codifica o UTF 8 parte do schema ISO 10646 que foi publicado em 1990 A ideia atribuir um c digo nico para cada caractere ou seja letras n meros s mbolos ideogramas etc cobertos por este padr o A norma prev um montante m ximo de 1 1 milh o de tal c digo e no momento cerca de 100 000 est o atribu dos a caracteres Por m este valor aumenta constantemente dada a inclus o de caracteres n o previstos anteriormente 2 1 6 Valida o do Schema Todas as mensagens baseadas na ISO 20022 que chegam interface BM amp FBOVESPA para posterior processamento est o sujeitas s regras de valida o relacionadas com a sintaxe e estrutura da pr pria mensagem Neste contexto pode se distinguir entre a consist ncia e validade de uma mensagem enviada para BM amp FBOVESPA Uma mensagem ISO 20022 bem formada satisfaz as regras sint ticas gerais previstas para documentos XML conforme descrito na se o acima Os principais aspectos que devem ser respeitados s o e mensagem dever conter somente caracteres Unicode e Os caracteres de sintaxe espec fica por exemplo lt e amp n o s o utilizados na mensagem exceto em sua fun o como elemento de delimita o e As tags de delimita o ou seja de in cio fim e de elementos vazios devem estar corretamente aninhadas e emparelhadas e nenhuma delas dever faltar ou estar sobreposta e As ta
38. t lt Envlp gt lt ext Document xmins ext urn iso std iso iso20022 tech xsd ExtensionMessageV01 xsd gt lt ext MyNewElement gt abc lt ext MyNewElement gt lt ext MyNewElement2 gt def lt ext MyNewElement2 gt lt ext Document gt lt Envlp gt lt SplmtryData gt lt Document gt Observac es e extens o est dentro SplmtryData e Oelemento PlcAndNm aponta para o elemento da mensagem que estendida usando uma convenc o XML padr o chamado XPath e Oschema XML que permite saber como ler as informac es que est o sendo estendidas est o localizados ap s o elemento Document urn iso std iso 15020022 tech xsd ExtensionMessageV01 xsd Exemplo lt SplmtryData gt lt Envlp gt lt Document xmlns ext urn iso std iso iso20022 tech xsd ExtensionMessageV01 xsd gt Localizac o lt ext ExtensionComponent1 gt da primeira lt ext PlcAndNm gt Document MessageElement2 lt PlcA ndNm gt extens o lt ext MyExtensionData gt This extends MessageElement4 lt MyExtensionData gt lt ext ExtensionComponent1 gt lt ext ExtensionComponent1 gt lt ext PlcAndNm gt Document MessageElement6 lt PIcAndNm gt lt ext MyExtensionData gt This extends MessageElement9 lt MyExtensionData gt lt ext ExtensionComponent1 gt lt Envlp gt lt SplmtryData gt Localiza o da segunda extens o BM amp FBOVESPA 18 2 2013 A Nova Bolsa MANUAL TECNICO DE MENSAGEM 2 1 4 Formato de campos In
39. tui o utilizando um schema de identificac o institui o Issuer Issr BN Max35Text Entidade que emitiu a identifica o Ex BM amp FBOVESPA Este campo deve assumir o valor default 40 SchemeName SchmeNm 0 1 Organisationlden C digo do tipo de documento tificationScheme Name Choice Proprietary Prtry 1 1 Max35Text C digo do tipo de documento Ex C DIGO PARTICIPANTE BVMF Este campo deve ser preenchido com o valor default 39 quem receber a mensagem fas NU Scd A entification n42 recebendo a mensagem Identification 0 1 PartytOChoice Identifica o nica e inequ voca do participante que est recebendo a mensagem Dl NN LL FT entification tification7 recebendo a mensagem Other Othr 0 GenericOrganisa Unico de identifica o de uma tionldentification organizac o como atribu do por uma 1 institui o utilizando um schema de identificac o institui o Vanni mm Max35Text Entidade gue emitiu a identificac o Ex assumir valor default 40 pure jot o itie v tificationScheme 29 MANUAL T CNICO DE MENSAGEM BM amp FBOVESPA A Nova Bolsa MANUAL TECNICO DE MENSAGEM 18 2 2013 mee EMEN 1 Max35Text C digo do tipo de documento Ex CODIGO PARTICIPANTE BVMF Este campo deve ser preenchido com o valor default 39 BusinessGrou BizGrpDtls 1 1 BusinessGroupD Este bloco cont m detalhes do lote
Download Pdf Manuals
Related Search