# Tipos de campos

O Cange foi desenvolvido para permitir que você crie fluxos personalizados, automatize tarefas e armazene informações com alto nível de granularidade. Para garantir essa flexibilidade, nossa plataforma utiliza campos dinâmicos — atualmente são mais de 25 tipos diferentes — permitindo que cada informação seja registrada no formato mais adequado ao seu uso.

Ao interagir com a API para inserir ou editar dados, é fundamental que você envie os valores no formato correto de cada campo. Cada tipo possui uma estrutura específica esperada pela API — por exemplo, campos de texto curto, data, número, múltipla escolha, relacionamentos entre cartões e muito mais.

Para facilitar esse processo, criamos uma tabela de referência completa que mostra:

* O nome e a descrição de cada tipo de campo;
* O formato esperado pela API no momento da inserção ou atualização;
* Exemplos práticos de payloads que funcionam.

Essa tabela é um recurso essencial para desenvolvedores que desejam realizar integrações robustas com o Cange, seja para criar novos cartões, editar respostas existentes ou conectar dados com outros sistemas.

Recomendamos que você consulte atentamente essa tabela antes de iniciar suas requisições. Ela está sempre atualizada com os novos tipos de campos à medida que a plataforma evolui.

Vamos juntos construir integrações mais inteligentes. Se tiver dúvidas, nossa equipe está pronta para ajudar!

## Campos

<table><thead><tr><th width="162.67578125">Título do campo</th><th width="242.6640625">Tipo</th><th width="104.58984375">Formato</th><th>Exemplo</th></tr></thead><tbody><tr><td>Texto curto</td><td><sub><code>TEXT_SHORT_FIELD</code></sub></td><td>string</td><td>"Texto Curto"</td></tr><tr><td>Texto longo</td><td><code>TEXT_LONG_FIELD</code></td><td>string</td><td>"Texto Longo"</td></tr><tr><td><a href="#caixa-de-selecao">Caixa de seleção</a></td><td><code>COMBO_BOX_FIELD</code></td><td>string</td><td>"1"</td></tr><tr><td>Data</td><td><code>DATE_PICKER_FIELD</code></td><td>string</td><td>"2025-07-25T12:30:00.000Z"</td></tr><tr><td><a href="#selecao-unica">Seleção única</a></td><td><code>RADIO_BOX_FIELD</code></td><td>string</td><td>"1"</td></tr><tr><td><a href="#selecao-multipla">Seleção múltipla</a></td><td><code>CHECK_BOX_FIELD</code></td><td>string[]</td><td>["1","2","3"]</td></tr><tr><td><a href="#responsavel">Responsável</a></td><td><code>COMBO_BOX_USER_FIELD</code></td><td>number | string</td><td>6052 ou "seuemail@dominio.com"</td></tr><tr><td>Meus Cadastros</td><td><code>COMBO_BOX_REGISTER_FIELD</code></td><td>number[]</td><td>[21412,23423, 129122]</td></tr><tr><td>Meus Fluxos</td><td><code>COMBO_BOX_FLOW_FIELD</code></td><td>number[]</td><td>[21412,23423, 129122]</td></tr><tr><td>Moeda</td><td><code>CURRENCY_FIELD</code></td><td>number</td><td>837.49</td></tr><tr><td>Vencimento</td><td><code>DUE_DATE_FIELD</code></td><td>string</td><td>"2025-07-25T12:30:00.000Z"</td></tr><tr><td>E-mail</td><td><code>MAIL_FIELD</code></td><td>string</td><td>"seuemail@dominio.com"</td></tr><tr><td>Telefone</td><td><code>PHONE_FIELD</code></td><td>string</td><td>"(11) 99124-9992"</td></tr><tr><td>Interruptor</td><td><code>SWITCH_FIELD</code></td><td>boolean</td><td>true</td></tr><tr><td>Lista de itens</td><td><code>INPUT_LIST_FIELD</code></td><td>object</td><td>[{value: "1", label: "12312", order: "0"}, {value: "2", label: "1231", order: "2"}]</td></tr><tr><td>Numérico</td><td><code>NUMBER_FIELD</code></td><td>number</td><td>123.33</td></tr><tr><td>Documentos</td><td><code>DOC_FIELD</code></td><td>string</td><td>"045.582.912-44" ou "01.090.094/0001-42</td></tr><tr><td>Texto Formatado</td><td><code>INPUT_RICH_TEXT_FIELD</code></td><td>string</td><td>"&#x3C;p>Your text in HTML here&#x3C;/p>"</td></tr><tr><td>Link</td><td><code>LINK_FIELD</code></td><td>string</td><td>"https://www.cange.me"</td></tr></tbody></table>

## Informações adicionais

### Caixa de seleção

Para que você saiba exatamente qual é o ID de cada opção, você deve entrar na tela de edição do campo e pegar esta informação passando o mouse (hover) por cima de cada uma das opções. Ao passar o mouse por cima das opções haverá um ID com # como prefixo. Conforme print abaixo: \
![](https://3455492266-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRwVy0iUEFA554Gv29SpL%2Fuploads%2FrOaERTPfkJOEDKFMEWWV%2Fimage.png?alt=media\&token=91850d54-5477-43cd-933c-97c653a6ac94)

### Seleção única

Para que você saiba exatamente qual é o ID de cada opção, você deve entrar na tela de edição do campo e pegar esta informação passando o mouse (hover) por cima de cada uma das opções. Ao passar o mouse por cima das opções haverá um ID com # como prefixo. Conforme print abaixo: \
![](https://3455492266-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRwVy0iUEFA554Gv29SpL%2Fuploads%2FrOaERTPfkJOEDKFMEWWV%2Fimage.png?alt=media\&token=91850d54-5477-43cd-933c-97c653a6ac94)

### Seleção múltipla

Para que você saiba exatamente qual é o ID de cada opção, você deve entrar na tela de edição do campo e pegar esta informação passando o mouse (hover) por cima de cada uma das opções. Ao passar o mouse por cima das opções haverá um ID com # como prefixo. Conforme print abaixo: \
![](https://3455492266-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRwVy0iUEFA554Gv29SpL%2Fuploads%2FrOaERTPfkJOEDKFMEWWV%2Fimage.png?alt=media\&token=91850d54-5477-43cd-933c-97c653a6ac94)

### Responsável

O campo Responsável permite que você possa enviar tanto o ID do usuário, como também o e-mail do usuário, facilitando na integração entra sistemas. Caso você não saiba qual é o ID dos seus usuários, você pode acessar: Seu avatar (Canto inferior esquerdo) -> Painel do Administrador -> Membros. Abaixo você verá uma tabela com as informações de cada usuário do sistema, incluindo o Identificador (ID).

<figure><img src="https://3455492266-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRwVy0iUEFA554Gv29SpL%2Fuploads%2FsdVRrWvcraujTiBsWtfL%2Fimage.png?alt=media&#x26;token=8234063d-8feb-4f0e-a860-2c2db9fb1c6d" alt=""><figcaption></figcaption></figure>