---
title: "Cartera del contador: todas mis cuentas con semáforo y vencimientos"
method: GET
path: "/asesor/cartera"
tags: ["asesor"]
---

# Cartera del contador: todas mis cuentas con semáforo y vencimientos

`GET /asesor/cartera`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/asesor/cartera`
- Auth: HTTP bearer

Una página de la cartera. `desde` pagina de 30 en 30 y `archivadas=1` devuelve las apartadas. Sin caché: la vista se marca y archiva en vivo.

## Query parameters

- `desde` integer
- `archivadas` '1' | 'true'

## Response `200`

Cartera

- object
  - `cuentas` object[]
    - `tenantId` string, uuid
    - `ruc` string, nullable: RUC del emisor de la empresa; null si aún no lo configuró
    - `nombre` string
    - `plan` string: Plan EFECTIVO propio (uno vencido se lee free). En regimen pool el que emite es el de cupoCompartido, no este.
    - `roles` string[]
    - `comprobantesDelMes` integer, nullable
    - `ventasMes` number, nullable: Venta neta del mes sin IVA (01 + 05 − 04, autorizados, sin bloqueados). Misma convención que /reportes/resumen.
    - `serieMeses` number[]: Seis meses de esa venta neta, el corriente al final (sparkline de la cartera)
    - `semaforo` object, nullable
      - `estado` 'VERDE' | 'AMARILLO' | 'ROJO' | 'NO_APLICA'
    - `proximosVencimientos` object[]
      - `codigo` string
      - `nombre` string
      - `fechaLimite` string, date
      - `diasRestantes` integer
      - `periodo` string: Período declarado: '2026-07' | '2026-S1' | '2026'
      - `hecha` boolean: Anotado como presentado (POST /asesor/declaraciones)
      - `marcadaAt` string, date-time, nullable
    - `nota` string, nullable
    - `archivada` boolean: Apartada de la cartera de ESTE usuario
    - `sinComprobantes` boolean: Nunca emitió: única condición en que se puede borrar la empresa
    - `regimenCupo` 'raiz' | 'pool' | 'independiente' | 'ajena': De que cupo emite, visto desde MI cartera: raiz = cuenta mia que reparte; pool = la patrocino y sigue en free (gasta mi cupo); independiente = la patrocino pero contrato plan propio; ajena = no participa de mi cupo.
  - `generadoEn` string, date
  - `omitidas` integer: Cuentas que quedan por pedir después de esta página
  - `disclaimer` string
  - `total` integer: Cuentas que encajan en el filtro
  - `desde` integer
  - `limite` integer: Tamaño de página (cuentas evaluadas por llamada)
  - `cupoCompartido` object, nullable: Cupo que MI cuenta raiz reparte este mes; null si no patrocino a nadie. Solo Produccion: no suma con comprobantesDelMes de las filas. La raiz sale de mis membresias owner, nunca del tenant activo.
    - `raizTenantId` string, uuid
    - `raizNombre` string
    - `plan` string: Plan que rige el pool (free si la raiz esta suspendida o vencida).
    - `usados` integer
    - `limite` integer, nullable
    - `corteDuro` boolean

---

[API](https://skmtc.dev/contadeo/apis/api-de-contadeo.md) · [All operations](https://skmtc.dev/contadeo/apis/api-de-contadeo/llms.txt) · [OpenAPI document](https://skmtc.dev/contadeo/apis/api-de-contadeo/revisions/461bbb9a74ce?raw)