---
title: De-para de espécies de título
url: https://docs.vehub.com.br/Layouts/%F0%9F%94%81%20De-Para/Especies%20de%20titulo/
---
# De-para de espécies de título

Cada título tem uma espécie (duplicata, nota promissória, CCB etc.). Na leitura, cada layout traduz o código ou o texto do arquivo para a espécie do VeHub (**arquivo → sistema**); na geração, traduz a espécie de volta para o código do parceiro (**sistema → arquivo**). Esta página reúne as duas direções.

## Catálogo de espécies

O **código** identifica a espécie nas APIs; a **sigla** e a **descrição** são os textos aceitos na importação de arquivos de estoque e planilhas.

| **Código** | **Sigla** | **Descrição** |
|---:|:---:|---|
| 2 | DM | Duplicata |
| 3 | UR | UR |
| 4 | NFSE | Nota Fiscal Serviço |
| 5 | ND | Nota de Débito |
| 6 | CCB | CCB Pré Digital |
| 8 | NP | Nota Promissória |
| 9 | NC | Nota Comercial |
| 10 | CT | Contrato |
| 11 | NF | Nota Fiscal |
| 12 | CPR | Cédula de Produto Rural |
| 13 | CTE | CT-e |
| 14 | CD | Confissão de Dívida |
| 15 | AD | Assunção de Dívida |
| 16 | FCC | Fatura de Cartão de Crédito |
| 17 | BAP | Bloqueio Agenda Pagamento Cartão |
| 18 | DS | Duplicata de Serviço |

Os códigos `0`, `1` e `7` não são usados.

## Outros textos aceitos na importação

Além da sigla e da descrição, a importação aceita os textos abaixo, herdados de arquivos antigos. A comparação ignora maiúsculas/minúsculas e acentos.

| **Texto no arquivo** | **Espécie** |
|---|---|
| `Assuncao Divida` | Assunção de Dívida (AD) |
| `Assuncao de Divida` | Assunção de Dívida (AD) |
| `assuncao_divida` | Assunção de Dívida (AD) |
| `Bloqueio Agenda Pgto Cartao` | Bloqueio Agenda Pagamento Cartão (BAP) |
| `Bloqueio Agenda Pgto Cartao Bx Aut` | Bloqueio Agenda Pagamento Cartão (BAP) |
| `bloqueio_agenda_pgto_cartao` | Bloqueio Agenda Pagamento Cartão (BAP) |
| `CCB Digital` | CCB Pré Digital (CCB) |
| `Confissao Divida` | Confissão de Dívida (CD) |
| `Confissao de Divida` | Confissão de Dívida (CD) |
| `confissao_divida` | Confissão de Dívida (CD) |
| `Duplicata` | Duplicata (DM) |
| `duplicata_mercantil` | Duplicata (DM) |
| `FATURA DE CARTAO DE CREDITO` | Fatura de Cartão de Crédito (FCC) |
| `Fatura Cartao de Credito` | Fatura de Cartão de Crédito (FCC) |
| `fatura_cartao_credito` | Fatura de Cartão de Crédito (FCC) |
| `Nota Comercial` | Nota Comercial (NC) |
| `Nota de Debito` | Nota de Débito (ND) |

!!! danger "Código numérico não é aceito como espécie"

    Textos numéricos (`2`, `13`) **não** são aceitos. A coluna de tipo de recebível dos arquivos de estoque também carrega códigos de outras tabelas (Oliveira Trust 01–99, Fromtis 01–72); interpretá-los como código de espécie trocaria a espécie do título sem nenhum aviso.

## De-para de cada layout

A conversão entre o código do arquivo e a espécie do VeHub fica na página de cada layout, na seção **De-para**: nos arquivos lidos, a tabela arquivo → sistema; nos arquivos gerados, a tabela sistema → arquivo.

A conversão também existe em integrações sem arquivo, como o registro de boleto por API:

### BV

**Registro de boleto por API**

Sistema → arquivo:

| **Espécie no sistema** | **Valor no arquivo** |
|---|---|
| Duplicata (DM) | `01` |
| Nota Fiscal Serviço (NFSE) | `04` |
| Nota Promissória (NP) | `08` |

Espécie fora desta tabela não é aceita: o título não é processado.

### Trio

**Registro de boleto**

Sistema → arquivo:

| **Espécie no sistema** | **Valor no arquivo** |
|---|---|
| Duplicata (DM) | `commercial_duplicate` |
| Duplicata de Serviço (DS) | `service_duplicate` |
| Nota Fiscal Serviço (NFSE) | `service_duplicate` |
| Nota Promissória (NP) | `promissory_note` |
| Nota de Débito (ND) | `debit_note` |
| Nota Fiscal (NF) | `invoice_note` |
| Cédula de Produto Rural (CPR) | `rural_product_certificate` |
| Confissão de Dívida (CD) | `debt_document` |
| Fatura de Cartão de Crédito (FCC) | `credit_card` |