{"id":11909,"date":"2025-04-01T12:39:46","date_gmt":"2025-04-01T15:39:46","guid":{"rendered":"https:\/\/www.tcees.tc.br\/ajuda\/?p=11909"},"modified":"2025-09-18T12:31:10","modified_gmt":"2025-09-18T15:31:10","slug":"o-que-e-um-arquivo-xsd","status":"publish","type":"post","link":"https:\/\/www.tcees.tc.br\/ajuda\/o-que-e-um-arquivo-xsd\/","title":{"rendered":"O que \u00e9 um arquivo XSD?"},"content":{"rendered":"

[vc_row][vc_column][vc_raw_html css=””]JTVCY2F0ZWdvcmlhUG9zdEFqdWRhJTVE[\/vc_raw_html][\/vc_column][\/vc_row][vc_row][vc_column width=”3\/4″][vc_column_text css=””]O que \u00e9 um arquivo XSD? <\/span><\/strong>[\/vc_column_text][vc_column_text css=””]Arquivos XSD (XML Schema Definition) s\u00e3o utilizados para definir o formato e as regras que um arquivo XML deve seguir. Eles especificam quais elementos podem estar presentes, quais informa\u00e7\u00f5es esses elementos devem conter e quais atributos podem ter. Isso garante que os arquivos XML sigam um padr\u00e3o pr\u00e9-definido, facilitando sua valida\u00e7\u00e3o e interpreta\u00e7\u00e3o por sistemas, como o CidadES.<\/p>\n

Em resumo, um XSD define toda a estrutura do XML ao qual \u00e9 aplicado, podendo ser utilizado como base de valida\u00e7\u00e3o para assegurar que o arquivo tenha o formato correto para as informa\u00e7\u00f5es. Essa verifica\u00e7\u00e3o pode ser feita, por exemplo, antes de processar a remessa no sistema ou para resolver as impeditivas informadas pelo CidadES.[\/vc_column_text][vc_tta_accordion style=”modern” spacing=”3″ gap=”3″ c_icon=”chevron” active_section=”0″ no_fill=”true” collapsible_all=”true”][vc_tta_section title=”Onde encontrar os XSD utilizados nas remessas do CidadES?” tab_id=”onde-encontrar-os-xsd-utilizados-nas-remessas-do-cidades”][vc_column_text css=””]Todos os arquivos XSD das remessas ficam dispon\u00edveis na p\u00e1gina de orienta\u00e7\u00f5es do CidadES, neste link<\/a>.<\/p>\n

Para baixar o arquivo que deseja, em Orienta\u00e7\u00f5es e normativos<\/strong>, escolha o m\u00f3dulo<\/strong> que deseja e o ano<\/strong> e clique em Filtrar<\/strong>.<\/p>\n

\"\"<\/p>\n

Figura 01 \u2013 Arquivos em destaque<\/p>\n

Tamb\u00e9m \u00e9 poss\u00edvel rolar a p\u00e1gina at\u00e9 Todos os arquivos<\/strong>. Utilize o filtro para selecionar especificamente o que deseja:<\/p>\n

\"\"
\nFigura 02 \u2013 Localiza\u00e7\u00e3o dos XSD’s<\/p>\n

[\/vc_column_text][\/vc_tta_section][vc_tta_section title=”Como posso utiliz\u00e1-lo?” tab_id=”como-posso-utilizar”][vc_column_text css=””]Como o XML \u00e9 uma \u201creceita\u201d, \u00e9 poss\u00edvel seguir suas regras para conferir uma estrutura constru\u00edda.<\/span>\u00a0<\/span><\/p>\n

Como exemplo, utilizaremos a estrutura <\/span>ROLRESP.XML<\/span><\/b> presente nas remessas de <\/span>Presta\u00e7\u00e3o de Contas Mensais<\/span><\/b>.<\/span>\u00a0<\/span><\/p>\n

Ap\u00f3s <\/span>baixar<\/span><\/b> o XSD da PCA de 2025 no site de orienta\u00e7\u00f5es, \u00e9 poss\u00edvel utilizar um validador online para conferir se ele est\u00e1 constru\u00eddo da maneira correta.<\/span>\u00a0<\/span><\/p>\n

1.\u00a0 Extraia<\/strong> o arquivo XSD baixado;<\/span><\/p>\n

\"\"
\nFigura 01 \u2013 Localiza\u00e7\u00e3o para extrair o arquivo<\/span>\u00a0<\/span><\/p>\n

2.\u00a0 Acesse uma ferramenta online de valida\u00e7\u00e3o de XML, como o freeformatter.com<\/a><\/span>\u00a0por exemplo, e caso necess\u00e1rio, selecione a op\u00e7\u00e3o <\/span>Traduzir<\/span><\/b>;<\/span><\/p>\n

\u00a0\"\"
\nFigura 02 \u2013 Localiza\u00e7\u00e3o de \u201cTraduzir\u201d<\/span>\u00a0<\/span><\/p>\n

3.\u00a0 Em <\/span>Op\u00e7\u00e3o 2: Ou carregue seu arquivo XML <\/span><\/b>selecione <\/span>Escolher arquivo <\/span><\/b>e procure o arquivo <\/span>XML<\/span><\/b> no computador;<\/span><\/p>\n

\u00a0\"\"
\nFigura 03 \u2013 Localiza\u00e7\u00e3o de Escolher arquivo<\/span>\u00a0<\/span><\/p>\n

4.\u00a0 Em <\/span>Op\u00e7\u00e3o 2: Copie e cole seu XSD aqui <\/span><\/b>selecione <\/span>Escolher arquivo <\/span><\/b>e vamos procurar o arquivo .<\/strong><\/span>xsd<\/span><\/b> no computador;<\/span><\/p>\n

\u00a0\"\"
\nFigura 04 – Localiza\u00e7\u00e3o de Escolher arquivo<\/span>\u00a0<\/span><\/p>\n

5.\u00a0 Ap\u00f3s isso, clique em <\/span>Validar XML<\/span><\/b>;<\/span><\/p>\n

6.\u00a0 No canto superior da p\u00e1gina, ser\u00e1 gerado um relat\u00f3rio das linhas que necessitam de altera\u00e7\u00e3o. Neste exemplo, o seguinte relat\u00f3rio foi gerado:<\/span><\/p>\n

\u00a0\"\"
\nFigura 05 \u2013 Relat\u00f3rio de erro gerado<\/span>\u00a0<\/span><\/p>\n

7.\u00a0 O erro est\u00e1 sendo indicado na linha 15, no campo <\/span>DataFim<\/span><\/b>. Ao abrir o XML pode-se verificar que o campo <\/span>DataFim<\/span><\/b> est\u00e1 na linha 16, pois \u00e9 desconsiderada a primeira linha.<\/span><\/p>\n

\u00a0\"\"
\nFigura 06 \u2013 Campo de DataFim<\/span>\u00a0<\/span><\/p>\n

O formato especificado para a data fim n\u00e3o est\u00e1 de acordo com as regras definidas pelo XSD e isso pode ser confirmado verificando a <\/span>Anexo IV da IN 68\/2020<\/span><\/a>:<\/span>\u00a0<\/span><\/p>\n

\u00a0\"\"
\nFigura 07 \u2013 Campo DataFim especificado na IN<\/span>\u00a0<\/span><\/p>\n

O formato correto deve ser <\/span>AAAA-MM-DD<\/span><\/b>, ap\u00f3s acertar essa informa\u00e7\u00e3o no XML, o problema ser\u00e1 resolvido. Para isso:<\/span>\u00a0<\/span><\/p>\n

8.\u00a0 Acesse o arquivo e modifique o campo com formata\u00e7\u00e3o correta;<\/span><\/p>\n

\"\"
\nFigura 08 \u2013 Campo \u201cDataFim\u201d corrigido<\/span>\u00a0<\/span><\/p>\n

9.\u00a0 Refazendo uma valida\u00e7\u00e3o, os problemas foram resolvidos e o XML passou a ser v\u00e1lido.<\/span><\/p>\n

\u00a0\"\"
\nFigura 09 \u2013 XML v\u00e1lido<\/span>\u00a0<\/span><\/p>\n

O mesmo procedimento pode ser feito para diferentes arquivos XML das remessas (O arquivo de valida\u00e7\u00e3o deve ser respectivo a estrutura da remessa que deseja verificar) e caso algum campo esteja fora do padr\u00e3o, o validador ir\u00e1 informar onde deve ser alterado.<\/span>\u00a0<\/span><\/p>\n

Todas as estruturas, obrigatoriedades e formata\u00e7\u00f5es dos campos s\u00e3o encontrados nas <\/span>Instru\u00e7\u00f5es Normativas<\/span><\/b>, presente no <\/span>site de orienta\u00e7\u00f5es<\/span><\/a>.<\/span>\u00a0<\/span><\/p>\n

O TCE-ES n\u00e3o disponibiliza ou presta suporte \u00e0s ferramentas de valida\u00e7\u00e3o citadas nessa documenta\u00e7\u00e3o. Outras ferramentas podem ser utilizadas para valida\u00e7\u00e3o dos arquivos. <\/div><\/span>\u00a0<\/span>[\/vc_column_text][\/vc_tta_section][\/vc_tta_accordion][vc_raw_html css=””]JTNDZGl2JTIwc3R5bGUlM0QlMjJkaXNwbGF5JTNBJTIwbm9uZSUzQiUyMiUzRSUwQSUyMCUyMCUyMCUyMCUzQ2g0JTNFUGFyYSUyMGZhY2lsaXRhciUyMGElMjBwZXNxdWlzYSUzQyUyRmg0JTNFJTBBJTIwJTIwJTIwJTIwJTNDcCUzRUNvbW8lMjBwb3NzbyUyMHZlcmlmaWNhciUyMHNlJTIwZXN0JUMzJUExJTIwY29ycmV0byUyMG8lMjBhcnF1aXZvJTIweG1sJTIwZGElMjByZW1lc3NhJTNDJTJGcCUzRSUwQSUzQyUyRmRpdiUzRQ==[\/vc_raw_html][vc_raw_html]JTVCYXZhbGlhY2FvX2RvY19iYXNlJTVE[\/vc_raw_html][\/vc_column][vc_column width=”1\/4″][vc_column_text css=”.vc_custom_1621544531384{margin-top: -3% !important;}”]Artigos Relacionados<\/strong><\/span>[\/vc_column_text][vc_column_text css=”.vc_custom_1709672870861{margin-top: -8% !important;}”]