> ## 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.

# Consultar resumen de cartera

El servicio permite a los usuarios consultar el resumen de cartera del cliente (saldo total, saldo vencido, saldo por vencer y saldo a favor), en línea en formato JSON.

Los saldos se calculan sobre las facturas contabilizadas del cliente, descontando los pagos aplicados a cada una.

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 la cartera, 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)
* Código único del cliente (TerceroID) obtenido del servicio de [datos del cliente](https://tech.sedierp.com/datos-del-cliente.md)

## Consultar cartera general

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

**TerceroID** `int` *required*

Código único del cliente (ID) que inició sesión. Se obtiene del campo `TerceroID` del servicio de [datos del cliente](https://tech.sedierp.com/datos-del-cliente.md).

```bash theme={null}
curl --location 'https://portal.sedierp.com/API_FAC/api/Cartera/CarteraGeneralTerceroConsultar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--data '{
	"TerceroID": 48213
}'
```

### Respuesta

El servicio retorna un único registro con los saldos del cliente. Si el cliente no tiene facturas pendientes, los saldos se retornan en 0. 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"}`).

**SaldoCartera** `decimal`

Saldo total pendiente por pagar de las facturas del cliente.

**SaldoVencido** `decimal`

Parte del saldo de cartera de las facturas con fecha de vencimiento hasta el día actual (inclusive).

**SaldoPorVencer** `decimal`

Parte del saldo de cartera de las facturas con fecha de vencimiento posterior al día actual.

**SaldoFavor** `decimal`

Saldo a favor del cliente por anticipos recibidos.

> [!NOTE]
>
> La fecha de vencimiento de cada factura es su último vencimiento registrado (tercer, segundo o primer vencimiento, en ese orden). Si la factura no tiene fecha de vencimiento, se toma la fecha de registro del documento contable.

```json Request theme={null}
{
  "TerceroID": 48213
}
```

```json Exitosa theme={null}
{
    "total": 1,
    "rows": [
        {
            "SaldoCartera": 3700000.0,
            "SaldoVencido": 1850000.0,
            "SaldoPorVencer": 1850000.0,
            "SaldoFavor": 0.0
        }
    ],
    "result": 1
}
```

```json Error theme={null}
{
    "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
    "title": "One or more validation errors occurred.",
    "status": 400,
    "errors": {
        "TerceroID": [
            "The TerceroID field is required."
        ]
    },
    "traceId": "00-4b7e1a9c2d3f4e5a8b6c7d8e9f0a1b2c-3c4d5e6f7a8b9c0d-00"
}
```


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