> ## Documentation Index
> Fetch the complete documentation index at: https://tech.sedierp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tipos de certificados financieros

El servicio permite a los usuarios consultar los tipos de certificados financieros (certificados de retención, entre otros) que se pueden generar desde el portal de clientes, en línea en formato JSON.

El código del tipo de certificado se utiliza en el servicio de [generación de certificados financieros](https://tech.sedierp.com/certificaciones-tributarias.md).

El método de solicitud es POST y se requiere un encabezado "Authorization" para la autenticación, que debe contener el **AccessToken** (JWT) obtenido previamente del servicio de [inicio de sesión](https://tech.sedierp.com/inicio-de-sesion.md).

## Prerequisitos

Antes de realizar la consulta de los tipos de certificados financieros, se debe contar con los siguientes datos:

* AccessToken solicitado mediante el servicio de [inicio de sesión](https://tech.sedierp.com/inicio-de-sesion.md)

## Consultar tipos de certificados financieros

**Request URL:** [https://portal.sedierp.com/API\_FAC/api/CertificadosFinancieros/TiposCertificadosFinancierosConsultar](https://portal.sedierp.com/API_FAC/api/CertificadosFinancieros/TiposCertificadosFinancierosConsultar)\
**Tipo:** POST \
**Content Type:** application/json

**Nombre** `string`

Filtro de búsqueda por cualquier parte del nombre del tipo de certificado. Si se omite, se retornan todos los tipos de certificados.

```bash theme={null}
curl --location 'https://portal.sedierp.com/API_FAC/api/CertificadosFinancieros/TiposCertificadosFinancierosConsultar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--data '{
	"Nombre": "retención"
}'
```

### Respuesta

El servicio retorna el listado de tipos de certificados financieros que cumplen con el filtro. Cada registro de `rows` contiene los siguientes campos:

**TipoCertificadoFinancieroID** `int`

Código único del tipo de certificado financiero (ID).

**Nombre** `string`

Nombre del tipo de certificado financiero.

Si el AccessToken no se envía, es inválido o expiró, el servicio responde HTTP 401 (`{"Code": 401, "Message": "El TokenAcceso no es valido"}`).

```json Request theme={null}
{
  "Nombre": "retención"
}
```

```json Exitosa theme={null}
{
    "total": 3,
    "rows": [
        {
            "TipoCertificadoFinancieroID": 1,
            "Nombre": "Certificado de retención en la fuente"
        },
        {
            "TipoCertificadoFinancieroID": 2,
            "Nombre": "Certificado de retención de IVA"
        },
        {
            "TipoCertificadoFinancieroID": 3,
            "Nombre": "Certificado de retención de ICA"
        }
    ],
    "result": 1
}
```

```json Sin resultados theme={null}
{
    "total": 0,
    "rows": [],
    "result": 1
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.