---
title: "Estado de cuenta privado de un distribuidor"
method: POST
path: "/distribuidores-firma/estado"
tags: ["distribuidores-firma"]
---

# Estado de cuenta privado de un distribuidor

`POST /distribuidores-firma/estado`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/distribuidores-firma/estado`
- Auth: none required

Público, sin sesión: lo autentica el token del enlace privado, que viaja en el CUERPO y no en la URL. Se busca por su sha256; regenerarlo desde la consola invalida el anterior.

404 genérico si el token no vale o el distribuidor no está `activo` ni `suspendido`. Nunca devuelve datos de los compradores (solo la referencia del pedido) ni el porcentaje, el margen o el costo. `nombre` es solo el primer nombre y `ventas` cubre los últimos 12 meses.

Rate-limit: 30 consultas por IP cada 10 min (429), en un contador propio (`rl:distribuidor-firma-estado:`).

Detrás de `DISTRIBUIDORES_FIRMA_HABILITADO`: apagado, 404.

## Request body

- object
  - `token` string, required: El fragmento `#` del enlace del estado de cuenta.

## Response `200`

Estado de cuenta

- object
  - `nombre` string
  - `codigo` string
  - `estado` 'activo' | 'suspendido'
  - `enlaces` object
    - `solicitar` string
    - `guia` string
  - `resumen` object
    - `pendienteCentavos` integer
    - `pagadoCentavos` integer
    - `ventasMesActual` integer
    - `minimoPagoCentavos` integer
  - `ventas` object[]
    - `referencia` string
    - `fecha` string, date-time
    - `vigencia` string
    - `estado` 'pendiente' | 'pagada' | 'anulada'
    - `comisionCentavos` integer
  - `pagos` object[]
    - `fecha` string, date-time
    - `montoCentavos` integer
    - `referencia` string
  - `banco` object, nullable
    - `nombre` string
    - `terminacion` string
  - `comisiones` object[]
    - `vigencia` integer: Id del catálogo de vigencias de NewBest.
    - `nombre` string
    - `precioConIvaCentavos` integer: Lo que transfiere el comprador a NewBest.
    - `comisionCentavos` integer: Lo que gana el distribuidor por esa venta, sin IVA.

## Other responses

- `404`: Token no válido o programa apagado
- `429`: Demasiadas consultas desde esa IP

---

[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)