---
updatedAt: 2026-08-13T14:29:02.000Z
agentTools:
  siteIndex: https://docs.cielo.com.br/llms.txt
  projectIndex: https://docs.cielo.com.br/conecta/llms.txt
---

# Formatos usados neste documento 

Este documento menciona diversos dados em funções e tabelas, sendo que estes dados, por suas características, devem respeitar diferentes regras de codificação.

A representação de um formato segue a seguinte regra: “\[Caractere de Formato]\[..]\[Tamanho]”

* **\[Caractere de Formato]** = Letra maiúscula que define o formato.

\[..] = Opcional, indica que o dado é de tamanho variável, podendo ter de zero a \[Tamanho] bytes.

* **\[Tamanho]** = De um a quatro dígitos numéricos representando a quantidade de bytes utilizada pela informação, ou “var” para indicar tamanho indefinido.

Exemplos:

* O código “H256” indica uma informação de 256 bytes codificada de acordo com o formato “H”;
* O código “N..99” indica uma informação de tamanho variável (de 0 a 99 bytes) codificada de acordo com o formato “N”;
* O código “A..var” indica uma informação de tamanho variável codificada de acordo com o formato “A”.

A tabela seguir detalha os formatos adotados neste documento:

| Formato | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| A       | Alfanumérico codificado segundo tabela ASCII, podendo conter bytes de 20h (espaço) a 7Eh (\~). Quando a informação for menor do que o campo definido, ela deverá ser alinhada à esquerda com espaços (20h) à direita. Exemplo: Se um campo de formato `A6` contém a informação `TEXTO`, ele é codificado como: `54h 45h 58h 54h 4Fh 20h`.                                                                                                                                                                                                      |
| S       | Alfanumérico codificado segundo a tabela de caracteres definida na ISO/IEC 8859-1, podendo conter bytes de 20h (espaço) a FFh. Quando a informação for menor do que o campo definido, ela deverá ser alinhada à esquerda com espaços (20h) à direita. Exemplo: Se um campo de formato `S8` contém a informação `Ação`, ele é codificado como: `41h E7h E3h 6Fh 20h 20h 20h 20h`.                                                                                                                                                               |
| N       | Numérico decimal codificado segundo a tabela ASCII, podendo conter somente bytes de 30h ("0") a 39h ("9"). Quando a informação for menor do que o campo definido, ela deverá ser alinhada à direita com zeros (30h) à esquerda. Exemplo: Se um campo de formato `N8` contém a informação numérica `1234`, ele é codificado como: `30h 30h 30h 30h 31h 32h 33h 34h`.                                                                                                                                                                            |
| H       | Numérico hexadecimal codificado segundo a tabela ASCII, podendo conter somente bytes de 30h ("0") a 39h ("9"), 41h ("A") a 46h ("F") e 61h ("a") a 66h ("f"). Quando a informação for menor do que o campo definido, ela deverá ser alinhada à direita com zeros (30h) à esquerda. Cada dois caracteres em hexadecimal representam um byte (valor de 00h a FFh), por isso o **\[Tamanho]** deve ser sempre um número par. Exemplo: Se um campo de formato `H4` contém a informação numérica `3F6Ch`, ele é codificado como: `33h 46h 36h 43h`. |

<br />