# Sistema Facturación Perú: portal para desarrolladores y artículos del blog

> Sistema Facturación Perú es un sistema de facturación electrónica SUNAT, punto de venta, inventario y contabilidad para negocios del Perú. Este archivo resume el sitio y lista los artículos del blog para asistentes de IA.

---

# Portal para desarrolladores

URL: https://www.sistemafacturacionperu.com/desarrolladores/

---

# Inicio rápido: tu primera boleta de prueba en 5 minutos

URL: https://www.sistemafacturacionperu.com/desarrolladores/inicio-rapido/

Crea una clave de pruebas, prueba la conexión, emite tu primera boleta electrónica contra la beta de SUNAT y descarga su PDF con cURL, PHP, Node.js o Python.

En cinco minutos vas a emitir una boleta electrónica de prueba con la API v1 y descargar su PDF. Todo pasa en el
**modo pruebas**: una empresa aparte, conectada a la beta de SUNAT, que no toca tus comprobantes, tu stock ni tus
correlativos. Los ejemplos están en cURL, PHP, Node.js y Python: elige tu lenguaje en las pestañas y se queda elegido en
toda la página.

> **Qué necesitas:** una cuenta de Sistema Facturación Perú en el Plan PRO o Empresa (la API viene desde PRO) y un
> usuario administrador o con el permiso «Gestionar tokens de API». Si todavía no tienes cuenta,
> [revisa los planes](https://www.sistemafacturacionperu.com/precios/).

## 1. Crea tu clave de pruebas

1. Entra a tu sistema y abre **Configuración › Sistema › Integraciones › API**.
2. En **Modo pruebas**, pulsa **Crear clave de pruebas**.
3. Copia la clave `sfp_test_…`. Se muestra **una sola vez**: guárdala en una variable de entorno, nunca en el código ni
   en el navegador.

```bash
export SFP_API_KEY="sfp_test_TU_CLAVE"
```

Todas las llamadas de esta guía van a `https://pruebas.sistemafacturacionperu.com/api/v1` con la cabecera
`Authorization: Bearer <tu clave>`. La clave nunca va en la URL: si la pones ahí, la API responde 401 `clave_en_url`.

## 2. Prueba la conexión

`GET /yo` te dice con qué clave, usuario, local y permisos estás llamando. Es la mejor forma de saber que todo está
bien conectado.

```bash
curl https://pruebas.sistemafacturacionperu.com/api/v1/yo \
  -H "Authorization: Bearer $SFP_API_KEY"
```

```php
<?php
$ch = curl_init('https://pruebas.sistemafacturacionperu.com/api/v1/yo');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('SFP_API_KEY'), 'Accept: application/json'],
]);
$yo = json_decode(curl_exec($ch), true);
echo $yo['data']['empresa']['razon_social'], ' · modo ', $yo['data']['modo'], PHP_EOL;
```

```js
// Node.js 18 o más (fetch viene incluido). Guárdalo como yo.mjs y corre: node yo.mjs
const res = await fetch('https://pruebas.sistemafacturacionperu.com/api/v1/yo', {
  headers: { Authorization: `Bearer ${process.env.SFP_API_KEY}`, Accept: 'application/json' },
});
const { data } = await res.json();
console.log(data.empresa.razon_social, '· modo', data.modo);
```

```python
# pip install requests
import os, requests

r = requests.get(
    "https://pruebas.sistemafacturacionperu.com/api/v1/yo",
    headers={"Authorization": f"Bearer {os.environ['SFP_API_KEY']}"},
    timeout=30,
)
data = r.json()["data"]
print(data["empresa"]["razon_social"], "· modo", data["modo"])
```

Si todo va bien, la respuesta dice `"modo": "pruebas"` y `"sunat": "beta"`:

```json
{
  "success": true,
  "data": {
    "empresa": { "ruc": "20000000001", "razon_social": "EMPRESA DE PRUEBAS API S.A.C.", "nombre_comercial": null },
    "modo": "pruebas",
    "sunat": "beta",
    "clave": { "id": 7, "nombre": "Mi tienda · pruebas", "prefijo": "sfp_test_Xy12Ab34", "vence": null },
    "legacy": false,
    "alcances": ["comprobantes.emitir", "comprobantes.leer", "consultas"],
    "usuario": { "id": 1, "nombre": "Ana Torres", "tipo": "admin" },
    "establecimiento": { "id": 1, "codigo": "0000", "nombre": "Tienda principal" }
  }
}
```

¿Te respondió 401 o 403? Mira el `code` de la respuesta en el [catálogo de errores](https://www.sistemafacturacionperu.com/desarrolladores/errores/).

## 3. Emite tu primera boleta

Una boleta de S/ 60 (dos polos de S/ 30 con IGV) a una persona con DNI, pagada en efectivo. Fíjate en tres cosas:

- `"numero_documento": "#"` pide el siguiente correlativo de la serie `B001`.
- La fecha va en la hora de Lima (`AAAA-MM-DD`). Los ejemplos la calculan solos.
- La cabecera `Idempotency-Key` hace que, si la red falla y repites la llamada con la misma clave, la boleta **no se
  emita dos veces**. Usa un UUID nuevo por cada comprobante.

```bash
curl -X POST https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes \
  -H "Authorization: Bearer $SFP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "serie_documento": "B001",
    "numero_documento": "#",
    "fecha_de_emision": "'"$(TZ=America/Lima date +%F)"'",
    "hora_de_emision": "'"$(TZ=America/Lima date +%T)"'",
    "codigo_tipo_operacion": "0101",
    "codigo_tipo_documento": "03",
    "codigo_tipo_moneda": "PEN",
    "datos_del_cliente_o_receptor": {
      "codigo_tipo_documento_identidad": "1",
      "numero_documento": "70123456",
      "apellidos_y_nombres_o_razon_social": "Ana Pérez",
      "codigo_pais": "PE"
    },
    "totales": {
      "total_operaciones_gravadas": 50.85,
      "total_igv": 9.15,
      "total_impuestos": 9.15,
      "total_valor": 50.85,
      "total_venta": 60
    },
    "items": [{
      "codigo_interno": "POLO-01",
      "descripcion": "Polo azul",
      "unidad_de_medida": "NIU",
      "cantidad": 2,
      "valor_unitario": 25.42,
      "codigo_tipo_precio": "01",
      "precio_unitario": 30,
      "codigo_tipo_afectacion_igv": "10",
      "total_base_igv": 50.85,
      "porcentaje_igv": 18,
      "total_igv": 9.15,
      "total_impuestos": 9.15,
      "total_valor_item": 50.85,
      "total_item": 60
    }],
    "pagos": [{ "codigo_metodo_pago": "01", "codigo_destino_pago": "cash", "monto": 60 }]
  }'
```

```php
<?php
$lima = new DateTime('now', new DateTimeZone('America/Lima'));
$boleta = [
    'serie_documento' => 'B001',
    'numero_documento' => '#',
    'fecha_de_emision' => $lima->format('Y-m-d'),
    'hora_de_emision' => $lima->format('H:i:s'),
    'codigo_tipo_operacion' => '0101',
    'codigo_tipo_documento' => '03',
    'codigo_tipo_moneda' => 'PEN',
    'datos_del_cliente_o_receptor' => [
        'codigo_tipo_documento_identidad' => '1',
        'numero_documento' => '70123456',
        'apellidos_y_nombres_o_razon_social' => 'Ana Pérez',
        'codigo_pais' => 'PE',
    ],
    'totales' => [
        'total_operaciones_gravadas' => 50.85, 'total_igv' => 9.15, 'total_impuestos' => 9.15,
        'total_valor' => 50.85, 'total_venta' => 60,
    ],
    'items' => [[
        'codigo_interno' => 'POLO-01', 'descripcion' => 'Polo azul', 'unidad_de_medida' => 'NIU', 'cantidad' => 2,
        'valor_unitario' => 25.42, 'codigo_tipo_precio' => '01', 'precio_unitario' => 30,
        'codigo_tipo_afectacion_igv' => '10', 'total_base_igv' => 50.85, 'porcentaje_igv' => 18,
        'total_igv' => 9.15, 'total_impuestos' => 9.15, 'total_valor_item' => 50.85, 'total_item' => 60,
    ]],
    'pagos' => [['codigo_metodo_pago' => '01', 'codigo_destino_pago' => 'cash', 'monto' => 60]],
];

$idempotencia = bin2hex(random_bytes(16));   // guárdala junto a tu venta para reintentar con la misma
$ch = curl_init('https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_TIMEOUT => 90,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('SFP_API_KEY'),
        'Content-Type: application/json',
        'Accept: application/json',
        'Idempotency-Key: ' . $idempotencia,
    ],
    CURLOPT_POSTFIELDS => json_encode($boleta),
]);
$respuesta = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);

if ($estado !== 201) {
    throw new RuntimeException($respuesta['code'] . ': ' . $respuesta['message']);
}
echo 'Emitida ', $respuesta['data']['numero_completo'], ' (id ', $respuesta['data']['id'], ')', PHP_EOL;
```

```js
import { randomUUID } from 'node:crypto';

const lima = new Date().toLocaleString('sv-SE', { timeZone: 'America/Lima' }); // "2026-11-04 10:15:00"
const [fecha, hora] = lima.split(' ');

const boleta = {
  serie_documento: 'B001',
  numero_documento: '#',
  fecha_de_emision: fecha,
  hora_de_emision: hora,
  codigo_tipo_operacion: '0101',
  codigo_tipo_documento: '03',
  codigo_tipo_moneda: 'PEN',
  datos_del_cliente_o_receptor: {
    codigo_tipo_documento_identidad: '1',
    numero_documento: '70123456',
    apellidos_y_nombres_o_razon_social: 'Ana Pérez',
    codigo_pais: 'PE',
  },
  totales: { total_operaciones_gravadas: 50.85, total_igv: 9.15, total_impuestos: 9.15, total_valor: 50.85, total_venta: 60 },
  items: [{
    codigo_interno: 'POLO-01', descripcion: 'Polo azul', unidad_de_medida: 'NIU', cantidad: 2,
    valor_unitario: 25.42, codigo_tipo_precio: '01', precio_unitario: 30, codigo_tipo_afectacion_igv: '10',
    total_base_igv: 50.85, porcentaje_igv: 18, total_igv: 9.15, total_impuestos: 9.15,
    total_valor_item: 50.85, total_item: 60,
  }],
  pagos: [{ codigo_metodo_pago: '01', codigo_destino_pago: 'cash', monto: 60 }],
};

const res = await fetch('https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SFP_API_KEY}`,
    'Content-Type': 'application/json',
    Accept: 'application/json',
    'Idempotency-Key': randomUUID(), // guárdala junto a tu venta para reintentar con la misma
  },
  body: JSON.stringify(boleta),
});
const json = await res.json();
if (res.status !== 201) throw new Error(`${json.code}: ${json.message}`);
console.log('Emitida', json.data.numero_completo, `(id ${json.data.id})`);
```

```python
import os, uuid, requests
from datetime import datetime
from zoneinfo import ZoneInfo

lima = datetime.now(ZoneInfo("America/Lima"))
boleta = {
    "serie_documento": "B001",
    "numero_documento": "#",
    "fecha_de_emision": lima.strftime("%Y-%m-%d"),
    "hora_de_emision": lima.strftime("%H:%M:%S"),
    "codigo_tipo_operacion": "0101",
    "codigo_tipo_documento": "03",
    "codigo_tipo_moneda": "PEN",
    "datos_del_cliente_o_receptor": {
        "codigo_tipo_documento_identidad": "1",
        "numero_documento": "70123456",
        "apellidos_y_nombres_o_razon_social": "Ana Pérez",
        "codigo_pais": "PE",
    },
    "totales": {"total_operaciones_gravadas": 50.85, "total_igv": 9.15, "total_impuestos": 9.15,
                "total_valor": 50.85, "total_venta": 60},
    "items": [{
        "codigo_interno": "POLO-01", "descripcion": "Polo azul", "unidad_de_medida": "NIU", "cantidad": 2,
        "valor_unitario": 25.42, "codigo_tipo_precio": "01", "precio_unitario": 30,
        "codigo_tipo_afectacion_igv": "10", "total_base_igv": 50.85, "porcentaje_igv": 18,
        "total_igv": 9.15, "total_impuestos": 9.15, "total_valor_item": 50.85, "total_item": 60,
    }],
    "pagos": [{"codigo_metodo_pago": "01", "codigo_destino_pago": "cash", "monto": 60}],
}

r = requests.post(
    "https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes",
    json=boleta,
    headers={
        "Authorization": f"Bearer {os.environ['SFP_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),  # guárdala junto a tu venta para reintentar con la misma
    },
    timeout=90,
)
respuesta = r.json()
if r.status_code != 201:
    raise RuntimeError(f"{respuesta['code']}: {respuesta['message']}")
print("Emitida", respuesta["data"]["numero_completo"], f"(id {respuesta['data']['id']})")
```

La API responde **201** con el comprobante:

```json
{
  "success": true,
  "data": {
    "id": 1520,
    "external_id": "6f1c7d0e-8f7e-4a1c-9d5b-2a2f8e1c9b10",
    "tipo": "03",
    "serie": "B001",
    "numero": 845,
    "numero_completo": "B001-845",
    "fecha_emision": "2026-11-04",
    "moneda": "PEN",
    "total": 60,
    "estado": { "codigo": "01", "clave": "registrado", "descripcion": "Registrado" },
    "sunat": null,
    "enlaces": {
      "pdf": "https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes/1520/pdf",
      "pdf_ticket": "https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes/1520/pdf?formato=ticket",
      "xml": "https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes/1520/xml",
      "cdr": null
    }
  }
}
```

El estado es `registrado` porque las boletas no viajan solas a SUNAT: van en el **resumen diario**, que el sistema
arma y envía por ti. Cuando SUNAT lo acepte, la boleta pasa a `aceptado` y, si tienes un
[webhook](https://www.sistemafacturacionperu.com/desarrolladores/webhooks/), te avisamos con `comprobante.aceptado`.

## 4. Descarga el PDF

Con el `id` (o el `external_id`) descarga el PDF en A4, A5 o en formato ticket (`?formato=ticket`, `ticket_58` o
`ticket_50`).

```bash
curl https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes/1520/pdf \
  -H "Authorization: Bearer $SFP_API_KEY" \
  -o B001-845.pdf
```

```php
<?php
$ch = curl_init('https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes/1520/pdf?formato=ticket');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('SFP_API_KEY')],
]);
file_put_contents('B001-845.pdf', curl_exec($ch));
```

```js
import { writeFile } from 'node:fs/promises';

const res = await fetch('https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes/1520/pdf?formato=ticket', {
  headers: { Authorization: `Bearer ${process.env.SFP_API_KEY}` },
});
await writeFile('B001-845.pdf', Buffer.from(await res.arrayBuffer()));
```

```python
r = requests.get(
    "https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes/1520/pdf",
    params={"formato": "ticket"},
    headers={"Authorization": f"Bearer {os.environ['SFP_API_KEY']}"},
    timeout=60,
)
open("B001-845.pdf", "wb").write(r.content)
```

El XML firmado sale de `/comprobantes/{id}/xml` y la constancia de SUNAT (CDR) de `/comprobantes/{id}/cdr` cuando ya
existe. Para tu cliente, la respuesta trae también `enlaces_publicos`: direcciones de descarga que no piden clave.

## 5. ¿Y ahora qué?

- Entiende el [camino de un comprobante](https://www.sistemafacturacionperu.com/desarrolladores/conceptos/): series, locales, pruebas y producción.
- Emite una [factura](https://www.sistemafacturacionperu.com/desarrolladores/guias/factura/) o una
  [guía de remisión](https://www.sistemafacturacionperu.com/desarrolladores/guias/guias-de-remision/).
- Recibe los cambios de estado con [webhooks](https://www.sistemafacturacionperu.com/desarrolladores/webhooks/) en vez de preguntar.
- Prueba cada endpoint desde la [referencia interactiva](https://www.sistemafacturacionperu.com/desarrolladores/referencia/) o importa la colección de
  Postman.
- Cuando todo funcione, sigue la lista de [pase a producción](https://www.sistemafacturacionperu.com/desarrolladores/pase-a-produccion/): creas una clave
  `sfp_live_` y cambias la dirección a `https://<tu-subdominio>.sistemafacturacionperu.com/api/v1`.

> **Lo emitido en pruebas se borra a los 7 días.** Cada clave de pruebas ve solo lo que ella emitió. Los clientes y
> productos de la empresa de pruebas son compartidos: no pongas datos reales.

---

# Conceptos de la API

URL: https://www.sistemafacturacionperu.com/desarrolladores/conceptos/

Empresa y subdominio, locales y series, modo pruebas y producción, el camino de un comprobante ante SUNAT y la diferencia entre resumen diario y envío directo.

Antes de integrar, conviene tener claras seis ideas. Con ellas entiendes por qué una boleta queda «registrada» y una
factura «aceptada» al instante, o por qué tu clave emite en un local y no en otro.

## Empresa y dirección de la API

Cada empresa de Sistema Facturación Perú tiene su propio subdominio y su propia API:

| Entorno | Dirección | Clave |
|---|---|---|
| Producción | `https://<tu-subdominio>.sistemafacturacionperu.com/api/v1` | `sfp_live_…` |
| Pruebas | `https://pruebas.sistemafacturacionperu.com/api/v1` | `sfp_test_…` |

Todo lo que emites por la API pasa por **las mismas reglas que la web**: series, régimen tributario, Ficha RUC,
detracción, anticipos, deuda vencida del cliente, control de stock y límite del plan. Lo que la web no deja hacer, la
API tampoco.

Las respuestas siempre tienen la misma forma:

```json
{ "success": true, "data": { "…": "…" }, "meta": { "page": 1, "per_page": 20, "total": 87, "last_page": 5 } }
```

```json
{ "success": false, "code": "serie_invalida", "message": "La serie ingresada es incorrecta…", "errors": { "serie_documento": ["…"] } }
```

Decide por el `code` (es estable) y muestra el `message` (está en español). La lista completa está en el
[catálogo de errores](https://www.sistemafacturacionperu.com/desarrolladores/errores/).

## Locales (sedes) y series

Una clave actúa como el **usuario** que elegiste al crearla: sus permisos, su local y sus series. Para emitir en otro
local, manda el código SUNAT del local en `establecimiento`:

```json
{ "establecimiento": "0001", "serie_documento": "F002", "…": "…" }
```

`GET /establecimientos` te da cada local con sus series y almacenes:

```json
{
  "success": true,
  "data": [{
    "id": 1, "codigo": "0000", "nombre": "Tienda principal", "direccion": "Av. Lima 123", "ubigeo": "150101",
    "series": [{ "tipo": "01", "serie": "F001" }, { "tipo": "03", "serie": "B001" }, { "tipo": "09", "serie": "T001" }],
    "almacenes": [{ "id": 1, "nombre": "Almacén Lima", "principal": true }]
  }]
}
```

- Una clave creada **con local fijo** solo emite en ese local (403 `establecimiento_no_permitido` en otro).
- Una serie que no es del local o del tipo de comprobante responde 422 `serie_invalida`.
- `"numero_documento": "#"` toma el siguiente correlativo de la serie. Es lo recomendado.

## Modo pruebas y producción

| | Pruebas | Producción |
|---|---|---|
| Empresa | Una empresa de pruebas aparte, compartida | La tuya |
| SUNAT | Beta de SUNAT: nada tiene validez tributaria | Producción: comprobantes válidos |
| Lo que ves | Solo lo que emitió tu clave | Todo lo de tu empresa que tu usuario puede ver |
| Clientes y productos | Compartidos entre todas las claves de pruebas: no pongas datos reales | Los tuyos |
| Duración | Se borra a los 7 días | Se guarda los años que pide SUNAT |
| Plan | Las claves de pruebas se crean desde el Plan PRO | Desde el Plan PRO |

El modo pruebas **no cambia nada de tu empresa**: no consume tus correlativos ni tu stock y no cuenta para el límite de
tu plan. Una clave `sfp_test_` contra la dirección de producción responde 401 `clave_de_pruebas`.

## El camino de un comprobante

Cada comprobante tiene un `estado` con un código SUNAT, una clave legible y una descripción:

```json
{ "estado": { "codigo": "05", "clave": "aceptado", "descripcion": "Aceptado" } }
```

| `clave` | `codigo` | Qué significa |
|---|---|---|
| `registrado` | 01 | Creado y firmado. Aún no está en SUNAT (o va en el resumen diario). |
| `enviado` | 03 | Enviado; SUNAT todavía no responde (pasa con resúmenes y bajas, que van por ticket). |
| `aceptado` | 05 | SUNAT lo aceptó. Ya tiene CDR. |
| `observado` | 07 | Aceptado con observaciones: es válido, pero revisa la nota de SUNAT. |
| `rechazado` | 09 | SUNAT lo rechazó: no tiene validez. Corrige y emite uno nuevo. |
| `por_anular` | 13 | Pediste la anulación y SUNAT todavía no responde. |
| `anulado` | 11 | Anulado con una comunicación de baja o un resumen de anulación. |

El camino normal es `registrado` → `enviado` → `aceptado` / `observado` / `rechazado`, y después, si lo anulas,
`por_anular` → `anulado`. La respuesta de SUNAT queda en `sunat`:

```json
{ "sunat": { "codigo": "0", "descripcion": "La Factura numero F001-120, ha sido aceptada", "notas": [] } }
```

No hace falta preguntar el estado cada minuto: registra un [webhook](https://www.sistemafacturacionperu.com/desarrolladores/webhooks/) y te avisamos con
`comprobante.aceptado`, `comprobante.observado`, `comprobante.rechazado` o `comprobante.anulado`.

## Resumen diario frente a envío directo

SUNAT recibe los comprobantes de dos formas, y el sistema elige la correcta por ti:

| | Facturas y sus notas | Boletas y sus notas |
|---|---|---|
| Cómo llegan a SUNAT | **Envío directo**: uno por uno, al emitir (según la configuración de la empresa) | Dentro del **resumen diario** |
| Estado al emitir | Normalmente `aceptado` u `observado` en la misma respuesta | `registrado` |
| Quién arma el envío | La API, en la misma llamada | El sistema, solo: dos veces al día envía las boletas de los días anteriores y consulta los resúmenes enviados |
| Para anular | Comunicación de baja | Resumen de anulación |

Por eso `POST /comprobantes/{id}/reenviar-sunat` solo sirve para facturas y sus notas: una boleta responde 422
`va_en_resumen`. Lo explicamos en detalle en la guía del [resumen diario](https://www.sistemafacturacionperu.com/desarrolladores/guias/resumen-diario/).

## Orígenes: facturar lo que ya existe

Para facturar una cotización, un pedido, una nota de venta o una guía, manda `origen`. Queda enlazado como en la web y
la mercadería no sale dos veces del stock:

```json
{ "origen": { "tipo": "cotizacion", "id": 15 }, "serie_documento": "F001", "…": "…" }
```

`tipo` puede ser `cotizacion`, `pedido`, `nota_venta` o `guia`. Si el origen no existe o no se puede facturar responde
422 `origen_no_existe`, `origen_no_permitido` o `nota_venta_no_facturable`.

## Productos, lotes, series y almacenes

Las líneas usan tu `codigo_interno`. Si la empresa tiene **control de stock**, un código que no existe responde 422
`producto_no_existe`: créalo antes con `POST /productos` (nace sin stock). Lotes, números de serie y almacén van en
cada línea:

```json
{
  "codigo_interno": "CEL-A15",
  "almacen_id": 2,
  "series": ["356938035643809", "356938035643817"],
  "lotes": [{ "codigo": "L-01", "cantidad": 2 }]
}
```

El stock por almacén, lote y serie lo consultas con `GET /stock` (alcance `stock.leer`).

## Cobros

Un comprobante al contado lleva sus `pagos` al emitirse. Para los cobros posteriores (una factura a crédito, por
ejemplo) usa `POST /comprobantes/{id}/cobros` con la cuenta de cobro y el número de operación si no es efectivo, y
`GET /comprobantes/{id}/cobros` para saber cuánto falta cobrar. Es el mismo registro que **Por cobrar › Registrar
cobro** de la web.

## Sigue con

- [Autenticación](https://www.sistemafacturacionperu.com/desarrolladores/autenticacion/): claves de empresa, de socio y la conexión con un botón.
- [Guías por comprobante](https://www.sistemafacturacionperu.com/desarrolladores/guias/): el JSON mínimo de cada uno.
- [Límites, idempotencia, paginación y versiones](https://www.sistemafacturacionperu.com/desarrolladores/limites-y-versiones/).

---

# Autenticación

URL: https://www.sistemafacturacionperu.com/desarrolladores/autenticacion/

Las tres formas de llamar a la API: claves de empresa con alcances, token de socio con client_credentials y la conexión con un botón (OAuth 2.0 con PKCE).

Hay tres formas de autenticarte. Elige según **de quién es la cuenta** que vas a usar:

| Si eres… | Usa | Token |
|---|---|---|
| La empresa (o su programador) y emites con tu propia cuenta | **Clave de empresa** | `sfp_live_…` / `sfp_test_…` |
| Un socio que da de alta a sus clientes como empresas | **Clave de socio** (OAuth 2 *client_credentials*) | `sfp_pat_…` (1 hora) |
| Un sistema cuyos clientes **ya tienen** cuenta en Sistema Facturación Perú | **Conectar con Sistema Facturación Perú** (OAuth 2 + PKCE) | `sfp_oat_…` (1 hora) |

En los tres casos el token va **solo** en la cabecera `Authorization: Bearer <token>`. En la URL o en el cuerpo responde
401 (`clave_en_url` en la API v1, `token_en_url` en la de socios), porque quedaría guardado en los registros de los
servidores.

## Claves de empresa

Se crean en **Configuración › Sistema › Integraciones › API** (desde el Plan PRO). Cada empresa puede tener varias,
cada una con:

- un **nombre** (por ejemplo, «Tienda en línea»), para reconocerla en el registro de llamadas;
- un **usuario**: la clave actúa como él, con sus funciones, su local y sus series;
- **alcances**: lo que la clave puede hacer, aunque el usuario pueda más;
- un **local** fijo, si quieres que solo emita en uno;
- una fecha de **vencimiento**, si quieres.

Formato: `sfp_live_` + 40 caracteres en producción y `sfp_test_` + 40 en pruebas. Guardamos solo su huella: la ves
**una sola vez** al crearla. Si la pierdes, revócala y crea otra. La pantalla muestra cuándo se usó por última vez.

### Alcances

| Alcance | Permite |
|---|---|
| `comprobantes.emitir` | Emitir comprobantes, notas de venta, cotizaciones, retenciones, percepciones y liquidaciones; reenviar a SUNAT |
| `comprobantes.leer` | Ver comprobantes, descargar PDF, XML y CDR, enviarlos por correo o WhatsApp |
| `comprobantes.anular` | Anular (baja o resumen) |
| `guias.emitir` / `guias.leer` | Emitir y ver guías de remisión |
| `cobros.registrar` | Registrar cobros |
| `catalogo.leer` / `catalogo.escribir` | Ver y cambiar clientes, productos y locales |
| `stock.leer` | Ver stock por almacén, lote y serie |
| `consultas` | RUC, DNI y tipo de cambio |
| `webhooks.gestionar` | Crear y borrar webhooks |

Cada llamada revisa dos cosas: que la **clave** tenga el alcance y que su **usuario** tenga la función en el sistema.

- Falta el alcance → 403 `scope_faltante`, con la cabecera `X-SFP-Scope-Required` que dice cuál.
- Falta la función del usuario → 403 `sin_permiso`.
- El plan no incluye la API → 403 `plan_sin_api`.
- Pago vencido o cuenta suspendida → 423 `cuenta_bloqueada`.

> **Da a cada clave solo lo que necesita.** Una tienda en línea que emite boletas no necesita `comprobantes.anular` ni
> `catalogo.escribir`. Si la clave se filtra, el daño queda acotado.

### El token antiguo

El token del usuario que usa la app móvil también vale en la v1, con todos los alcances; en el registro de llamadas sale
como «legacy». Funciona, pero te recomendamos pasar a una clave v1: tiene alcances, vencimiento y se revoca sin tocar
al usuario.

```bash
curl https://miempresa.sistemafacturacionperu.com/api/v1/yo \
  -H "Authorization: Bearer $SFP_API_KEY"
```

```php
<?php
$headers = ['Authorization: Bearer ' . getenv('SFP_API_KEY'), 'Accept: application/json'];
```

```js
const headers = { Authorization: `Bearer ${process.env.SFP_API_KEY}`, Accept: 'application/json' };
```

```python
headers = {"Authorization": f"Bearer {os.environ['SFP_API_KEY']}", "Accept": "application/json"}
```

## Claves de socio

Si tienes muchos clientes propios y quieres darlos de alta tú mismo, eres **socio**. Te entregamos una credencial
(`client_id` `sfp_partner_…` y `client_secret` `sfp_secret_…`) y con ella pides un token de 1 hora. Es OAuth 2
*client_credentials*: cualquier librería de OAuth sirve.

```bash
curl -s https://api.sistemafacturacionperu.com/socios/v1/token \
  -u "$SFP_CLIENT_ID:$SFP_CLIENT_SECRET" \
  -d grant_type=client_credentials
```

```php
<?php
$ch = curl_init('https://api.sistemafacturacionperu.com/socios/v1/token');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERPWD => getenv('SFP_CLIENT_ID') . ':' . getenv('SFP_CLIENT_SECRET'),
    CURLOPT_POSTFIELDS => http_build_query(['grant_type' => 'client_credentials']),
]);
$token = json_decode(curl_exec($ch), true)['access_token'];   // sfp_pat_…, vale 1 hora
```

```js
const basic = Buffer.from(`${process.env.SFP_CLIENT_ID}:${process.env.SFP_CLIENT_SECRET}`).toString('base64');
const res = await fetch('https://api.sistemafacturacionperu.com/socios/v1/token', {
  method: 'POST',
  headers: { Authorization: `Basic ${basic}`, 'Content-Type': 'application/x-www-form-urlencoded' },
  body: new URLSearchParams({ grant_type: 'client_credentials' }),
});
const { access_token } = await res.json(); // sfp_pat_…, vale 1 hora
```

```python
r = requests.post(
    "https://api.sistemafacturacionperu.com/socios/v1/token",
    auth=(os.environ["SFP_CLIENT_ID"], os.environ["SFP_CLIENT_SECRET"]),
    data={"grant_type": "client_credentials"},
    timeout=30,
)
token = r.json()["access_token"]  # sfp_pat_…, vale 1 hora
```

Con ese token das de alta empresas y creas, para cada una, una **clave de empresa** `sfp_live_` con la que emites en su
API v1. Todo el detalle, los precios y las bolsas están en la [API de socios](https://www.sistemafacturacionperu.com/desarrolladores/socios/).

## Conectar con Sistema Facturación Perú

Si tu sistema tiene clientes que **ya usan** Sistema Facturación Perú, no les pidas que copien una clave: ponles un
botón «Conectar con Sistema Facturación Perú». Es OAuth 2.0 con *authorization code* y **PKCE S256 obligatorio**, como
Google, Mercado Pago o Stripe.

1. **Tu botón** abre una ventana emergente en `https://api.sistemafacturacionperu.com/conectar` con tu `client_id`, tu `redirect_uri`, un `state` y el `code_challenge` de PKCE.

2. **El usuario escribe su RUC** y entra con su usuario y contraseña de siempre, en el subdominio de su empresa. Su contraseña nunca pasa por tu sistema.

3. **Pulsa «Permitir»** en la pantalla que le muestra tu aplicación y los permisos que pides.

4. **Vuelve a tu `redirect_uri`** con un `code` de un solo uso (5 minutos) y tu `state`.

5. **Tu servidor canjea el código** en `POST /oauth/token` con tu secreto y el `code_verifier`, y recibe un token de 1 hora, uno de renovación y la dirección de la API de esa empresa.

6. **Emites** en `empresa.api_url` con `Authorization: Bearer sfp_oat_…`.

Así se genera el par PKCE:

```js
import { randomBytes, createHash } from 'node:crypto';

const b64url = (buf) => buf.toString('base64').replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
const codeVerifier = b64url(randomBytes(48)); // 64 caracteres: guárdalo en la sesión
const codeChallenge = b64url(createHash('sha256').update(codeVerifier).digest());
const state = b64url(randomBytes(24));
```

```php
<?php
$b64url = fn (string $bin) => rtrim(strtr(base64_encode($bin), '+/', '-_'), '=');
$codeVerifier = $b64url(random_bytes(48));
$codeChallenge = $b64url(hash('sha256', $codeVerifier, true));
$state = $b64url(random_bytes(24));
$_SESSION['sfp'] = ['verifier' => $codeVerifier, 'state' => $state];
```

```python
import base64, hashlib, secrets

b64url = lambda b: base64.urlsafe_b64encode(b).rstrip(b"=").decode()
code_verifier = b64url(secrets.token_bytes(48))
code_challenge = b64url(hashlib.sha256(code_verifier.encode()).digest())
state = b64url(secrets.token_bytes(24))
```

En el Plan Básico la conexión sirve **solo para emitir**; en PRO y Empresa, para todo. El botón completo, el canje,
la renovación y la desconexión están en [Conectar con Sistema Facturación Perú](https://www.sistemafacturacionperu.com/desarrolladores/conectar/).

## Buenas prácticas

- Guarda claves, secretos y tokens en variables de entorno o en un gestor de secretos. Nunca en el repositorio, en una
  app móvil ni en el navegador.
- Una clave por sistema o integración: si un sistema se da de baja, revocas su clave y los demás siguen.
- Pon fecha de vencimiento a las claves de integraciones temporales.
- Revisa el **Registro de llamadas** (Configuración › Sistema › Integraciones › API › Registro): guarda 30 días de
  llamadas con fecha, clave, ruta, resultado, tiempo e IP.

---

# Guías por comprobante

URL: https://www.sistemafacturacionperu.com/desarrolladores/guias/

Qué endpoint usar para cada comprobante electrónico (factura, boleta, notas, guías, retención, percepción, liquidación) y cómo llega cada uno a SUNAT.

Cada guía trae el **JSON mínimo** que funciona, los campos que más se equivocan y lo que pasa con SUNAT después.
Los ejemplos van contra el modo pruebas; en producción solo cambia la dirección y la clave.

| Comprobante | Código SUNAT | Endpoint | Llega a SUNAT | Guía |
|---|---|---|---|---|
| Factura | 01 | `POST /comprobantes` | Envío directo | [Factura](https://www.sistemafacturacionperu.com/desarrolladores/guias/factura/) |
| Boleta de venta | 03 | `POST /comprobantes` | Resumen diario | [Boleta](https://www.sistemafacturacionperu.com/desarrolladores/guias/boleta/) |
| Nota de crédito | 07 | `POST /comprobantes` | Como su comprobante | [Notas de crédito y débito](https://www.sistemafacturacionperu.com/desarrolladores/guias/notas-de-credito-y-debito/) |
| Nota de débito | 08 | `POST /comprobantes` | Como su comprobante | [Notas de crédito y débito](https://www.sistemafacturacionperu.com/desarrolladores/guias/notas-de-credito-y-debito/) |
| Comunicación de baja / resumen de anulación | RA / RC | `POST /comprobantes/{id}/anular` | Por ticket | [Anular](https://www.sistemafacturacionperu.com/desarrolladores/guias/anulaciones/) |
| Resumen diario | RC | Automático | Por ticket | [Resumen diario](https://www.sistemafacturacionperu.com/desarrolladores/guias/resumen-diario/) |
| Guía de remisión remitente | 09 | `POST /guias` | API de guías de SUNAT, por ticket | [Guías de remisión](https://www.sistemafacturacionperu.com/desarrolladores/guias/guias-de-remision/) |
| Guía de remisión transportista | 31 | `POST /guias` | API de guías de SUNAT, por ticket | [Guías de remisión](https://www.sistemafacturacionperu.com/desarrolladores/guias/guias-de-remision/) |
| Comprobante de retención | 20 | `POST /retenciones` | Envío directo | [Retención](https://www.sistemafacturacionperu.com/desarrolladores/guias/retenciones/) |
| Comprobante de percepción | 40 | `POST /percepciones` | Envío directo | [Percepción](https://www.sistemafacturacionperu.com/desarrolladores/guias/percepciones/) |
| Liquidación de compra | 04 | `POST /liquidaciones-compra` | Envío directo | [Liquidación de compra](https://www.sistemafacturacionperu.com/desarrolladores/guias/liquidaciones-de-compra/) |

Detracción, anticipos, exportación, operaciones gratuitas, impuesto a las bolsas (ICBPER) y ventas a crédito están en
[Casos especiales](https://www.sistemafacturacionperu.com/desarrolladores/guias/casos-especiales/).

## Antes de emitir

- **Plan.** Retenciones, percepciones y liquidaciones de compra vienen desde el Plan PRO, igual que en la web.
- **Régimen y Ficha RUC.** SUNAT no permite facturas a un contribuyente del Nuevo RUS (422 `regimen_no_permite`) y una
  empresa nueva no emite hasta verificar su Ficha RUC (422 `ficha_ruc_pendiente`).
- **Series.** Usa las de tu local (`GET /establecimientos`). Las series de factura empiezan con F, las de boleta con B y
  las de guía de remitente con T.
- **Totales.** Tú mandas los importes de cada línea y los totales: calcula con dos decimales y redondea al final de cada
  línea. Si no cuadran, SUNAT observa o rechaza el comprobante (por ejemplo, la observación 4287 por un precio
  unitario que no coincide con el cálculo).
- **Idempotency-Key.** Mándala en cada emisión: si reintentas con la misma, no se emite dos veces
  ([cómo funciona](https://www.sistemafacturacionperu.com/desarrolladores/limites-y-versiones/)).

## Notas de venta y cotizaciones

No son comprobantes electrónicos (no van a SUNAT), pero se registran con el mismo JSON:

- `POST /notas-venta`: el JSON de los comprobantes sin `codigo_tipo_documento`, con una serie de notas de venta (NV01…)
  y, si quieres, `origen` de una cotización o un pedido. Para facturarla después: `POST /comprobantes` con
  `"origen": {"tipo": "nota_venta", "id": 88}`.
- `POST /cotizaciones`: el JSON de los comprobantes sin serie, con `fecha_de_vencimiento`, `fecha_de_entrega` y
  `observaciones` opcionales.

Las dos vienen desde el Plan PRO.

---

# Factura electrónica por API

URL: https://www.sistemafacturacionperu.com/desarrolladores/guias/factura/

JSON mínimo para emitir una factura electrónica SUNAT por API, al contado o a crédito, desde una cotización, y cómo enviarla por correo o WhatsApp.

La factura (tipo `01`) es para vender a empresas y negocios con RUC. Se envía a SUNAT **en la misma llamada** (según la
configuración de la empresa), así que la respuesta ya suele traer `aceptado` u `observado` y la respuesta de SUNAT.

- Endpoint: `POST /comprobantes` · alcance `comprobantes.emitir`.
- Serie: una de factura de tu local (`F001`…). `"numero_documento": "#"` toma el siguiente correlativo.

## JSON mínimo

Una factura de S/ 1.180 (40 bolsas de cemento a S/ 29,50 con IGV) pagada en efectivo:

```json
{
  "serie_documento": "F001",
  "numero_documento": "#",
  "fecha_de_emision": "2026-11-04",
  "hora_de_emision": "10:15:00",
  "codigo_tipo_operacion": "0101",
  "codigo_tipo_documento": "01",
  "codigo_tipo_moneda": "PEN",
  "datos_del_cliente_o_receptor": {
    "codigo_tipo_documento_identidad": "6",
    "numero_documento": "20601234567",
    "apellidos_y_nombres_o_razon_social": "CONSTRUCTORA ANDINA S.A.C.",
    "codigo_pais": "PE",
    "ubigeo": "150101",
    "direccion": "Av. Lima 123",
    "correo_electronico": "compras@andina.pe"
  },
  "totales": {
    "total_operaciones_gravadas": 1000,
    "total_igv": 180,
    "total_impuestos": 180,
    "total_valor": 1000,
    "total_venta": 1180
  },
  "items": [{
    "codigo_interno": "CEM-42",
    "descripcion": "Cemento 42.5 kg",
    "unidad_de_medida": "NIU",
    "cantidad": 40,
    "valor_unitario": 25,
    "codigo_tipo_precio": "01",
    "precio_unitario": 29.5,
    "codigo_tipo_afectacion_igv": "10",
    "total_base_igv": 1000,
    "porcentaje_igv": 18,
    "total_igv": 180,
    "total_impuestos": 180,
    "total_valor_item": 1000,
    "total_item": 1180
  }],
  "pagos": [{ "codigo_metodo_pago": "01", "codigo_destino_pago": "cash", "monto": 1180 }]
}
```

Guárdalo como `factura.json` y envíalo:

```bash
curl -X POST https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes \
  -H "Authorization: Bearer $SFP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: factura-$(uuidgen)" \
  -d @factura.json
```

```php
<?php
$ch = curl_init('https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_TIMEOUT => 90,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('SFP_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: ' . bin2hex(random_bytes(16)),
    ],
    CURLOPT_POSTFIELDS => file_get_contents('factura.json'),
]);
$factura = json_decode(curl_exec($ch), true);
```

```js
import { readFile } from 'node:fs/promises';
import { randomUUID } from 'node:crypto';

const res = await fetch('https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SFP_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': randomUUID(),
  },
  body: await readFile('factura.json', 'utf8'),
});
const factura = await res.json();
```

```python
import json, os, uuid, requests

r = requests.post(
    "https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes",
    json=json.load(open("factura.json", encoding="utf-8")),
    headers={"Authorization": f"Bearer {os.environ['SFP_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
    timeout=90,
)
factura = r.json()
```

Respuesta (201):

```json
{
  "success": true,
  "data": {
    "id": 1521,
    "external_id": "9a0b1c2d-3e4f-4a5b-8c6d-7e8f9a0b1c2d",
    "tipo": "01",
    "numero_completo": "F001-120",
    "total": 1180,
    "estado": { "codigo": "05", "clave": "aceptado", "descripcion": "Aceptado" },
    "sunat": { "codigo": "0", "descripcion": "La Factura numero F001-120, ha sido aceptada", "notas": [] },
    "enlaces": { "pdf": "…/comprobantes/1521/pdf", "xml": "…/comprobantes/1521/xml", "cdr": "…/comprobantes/1521/cdr" }
  }
}
```

## Los campos que más se equivocan

| Campo | Qué poner |
|---|---|
| `datos_del_cliente_o_receptor.codigo_tipo_documento_identidad` | `6` (RUC). Una factura a un DNI la rechaza SUNAT (2017: el receptor debe tener RUC). |
| `codigo_tipo_operacion` | `0101` venta interna; `1001` si está sujeta a detracción; `0200` exportación. |
| `codigo_tipo_afectacion_igv` | `10` gravado, `20` exonerado, `30` inafecto, `40` exportación. |
| `valor_unitario` / `precio_unitario` | Sin IGV / con IGV. Con `codigo_tipo_precio: "01"` (precio unitario). |
| `unidad_de_medida` | Catálogo SUNAT: `NIU` (unidad, bienes), `ZZ` (servicios), `KGM`, `MTR`, `LTR`… |
| `pagos[].codigo_metodo_pago` | `01` efectivo; los demás son los medios de pago de tu empresa. |
| `pagos[].codigo_destino_pago` | `cash` (caja) o el id de una cuenta de cobro. |

## Factura a crédito

Con `"codigo_condicion_de_pago": "02"` y las `cuotas`. SUNAT pide al menos una cuota en una venta a crédito (3249):

```json
{
  "codigo_condicion_de_pago": "02",
  "cuotas": [
    { "fecha": "2026-12-04", "codigo_tipo_moneda": "PEN", "monto": 590 },
    { "fecha": "2027-01-04", "codigo_tipo_moneda": "PEN", "monto": 590 }
  ]
}
```

Sin `pagos`, la factura queda en **Por cobrar**. Registra cada pago después con `POST /comprobantes/{id}/cobros`:

```json
{ "fecha": "2026-12-04", "monto": 590, "medio": "005", "cuenta_cobro_id": 2, "referencia": "OP-778812" }
```

`medio` es el código del medio de pago de tu empresa; si no es efectivo, va con la cuenta de cobro (`cuenta_cobro_id`,
un banco o billetera de ese tipo) y el número de operación. Sin cuenta, el cobro entra a la caja. Un cobro mayor que el
saldo responde 422 `cobro_excede_saldo`. `GET /comprobantes/{id}/cobros` dice cuánto falta.

## Facturar una cotización, un pedido o una nota de venta

Agrega `origen` y el comprobante queda enlazado, como en la web:

```json
{ "origen": { "tipo": "cotizacion", "id": 15 } }
```

## Enviarla a tu cliente

`POST /comprobantes/{id}/enviar` la manda por correo o por el **WhatsApp de tu empresa** (la línea que conectaste en
Canales › WhatsApp; nunca por una línea de la plataforma):

```json
{ "canal": "whatsapp", "destino": "987654321" }
```

```json
{ "canal": "correo", "destino": "compras@andina.pe, contabilidad@andina.pe" }
```

Si el proveedor de correo o de WhatsApp falla, responde 502 `envio_fallido`.

## Si SUNAT no responde

Si al emitir SUNAT no contestó, la factura queda `registrado`. Reenvíala con
`POST /comprobantes/{id}/reenviar-sunat` (con su propia `Idempotency-Key`). Una que ya está aceptada responde 409
`no_reenviable`.

## Errores frecuentes

| `code` | Qué pasó |
|---|---|
| `serie_invalida` | La serie no es de factura o no es de tu local. |
| `regimen_no_permite` | Tu régimen (Nuevo RUS) no emite facturas. |
| `deuda_vencida` | El cliente tiene deuda vencida y tu empresa restringe la venta en ese caso. |
| `producto_no_existe` | Con control de stock, el `codigo_interno` no existe: créalo con `POST /productos`. |
| `detraccion_minimo` | La detracción no aplica a ese monto ([casos especiales](https://www.sistemafacturacionperu.com/desarrolladores/guias/casos-especiales/)). |
| `limite_plan` | Tu plan ya no permite emitir más este ciclo. |

El resto está en el [catálogo de errores](https://www.sistemafacturacionperu.com/desarrolladores/errores/).

---

# Boleta de venta electrónica por API

URL: https://www.sistemafacturacionperu.com/desarrolladores/guias/boleta/

JSON mínimo para emitir una boleta de venta electrónica por API, cuándo pedir el DNI del comprador y cómo la informa el resumen diario a SUNAT.

La boleta (tipo `03`) es para vender al consumidor final. A diferencia de la factura, **no viaja sola a SUNAT**: el
sistema la informa en el [resumen diario](https://www.sistemafacturacionperu.com/desarrolladores/guias/resumen-diario/). Por eso la respuesta trae
`registrado` y el estado cambia a `aceptado` cuando SUNAT procesa el resumen.

- Endpoint: `POST /comprobantes` · alcance `comprobantes.emitir`.
- Serie: una de boleta de tu local (`B001`…).

## JSON mínimo

```json
{
  "serie_documento": "B001",
  "numero_documento": "#",
  "fecha_de_emision": "2026-11-04",
  "hora_de_emision": "10:15:00",
  "codigo_tipo_operacion": "0101",
  "codigo_tipo_documento": "03",
  "codigo_tipo_moneda": "PEN",
  "datos_del_cliente_o_receptor": {
    "codigo_tipo_documento_identidad": "1",
    "numero_documento": "70123456",
    "apellidos_y_nombres_o_razon_social": "Ana Pérez",
    "codigo_pais": "PE"
  },
  "totales": {
    "total_operaciones_gravadas": 50.85,
    "total_igv": 9.15,
    "total_impuestos": 9.15,
    "total_valor": 50.85,
    "total_venta": 60
  },
  "items": [{
    "codigo_interno": "POLO-01",
    "descripcion": "Polo azul talla M",
    "unidad_de_medida": "NIU",
    "cantidad": 2,
    "valor_unitario": 25.42,
    "codigo_tipo_precio": "01",
    "precio_unitario": 30,
    "codigo_tipo_afectacion_igv": "10",
    "total_base_igv": 50.85,
    "porcentaje_igv": 18,
    "total_igv": 9.15,
    "total_impuestos": 9.15,
    "total_valor_item": 50.85,
    "total_item": 60
  }],
  "pagos": [{ "codigo_metodo_pago": "01", "codigo_destino_pago": "cash", "monto": 60 }]
}
```

El paso a paso con cURL, PHP, Node.js y Python está en el [inicio rápido](https://www.sistemafacturacionperu.com/desarrolladores/inicio-rapido/).

## El comprador

| Documento | `codigo_tipo_documento_identidad` |
|---|---|
| DNI | `1` |
| Carné de extranjería | `4` |
| RUC | `6` |
| Pasaporte | `7` |
| Otros (sin documento) | `0` |

- Si el total pasa de **S/ 700**, SUNAT exige identificar al comprador con su documento.
- Para una venta menor sin datos del comprador, usa el tipo `0` y el mismo cliente genérico que usa tu empresa en la
  web.
- Un DNI que no tiene 8 dígitos lo rechaza SUNAT (2801). Puedes validarlo antes con
  [`GET /consultas/dni/{numero}`](https://www.sistemafacturacionperu.com/desarrolladores/consultas/).

## Ticket o A4

El PDF sale en el formato que pidas: `GET /comprobantes/{id}/pdf?formato=ticket`, `ticket_58`, `ticket_50`, `a5` o
`a4` (el de siempre). La respuesta de la emisión ya trae `enlaces.pdf_ticket`.

## Cuándo queda aceptada

1. Emites: `registrado`.
2. El sistema envía el resumen diario con las boletas de los días anteriores y consulta su ticket: el resumen queda
   `enviado`.
3. SUNAT lo procesa: cada boleta pasa a `aceptado` (o `rechazado`) y te llegan los webhooks `resumen.procesado` y
   `comprobante.aceptado`.

No necesitas llamar a nada para que esto pase. Si consultas una boleta con `GET /comprobantes/{id}` verás su estado al
momento.

## Anular una boleta

`POST /comprobantes/{id}/anular` con un `motivo`: el sistema arma el **resumen de anulación** (no la comunicación de
baja, que es para facturas). Solo se anulan boletas aceptadas u observadas. Detalle en
[Anular](https://www.sistemafacturacionperu.com/desarrolladores/guias/anulaciones/).

---

# Notas de crédito y de débito por API

URL: https://www.sistemafacturacionperu.com/desarrolladores/guias/notas-de-credito-y-debito/

Cómo emitir notas de crédito y de débito electrónicas por API: el comprobante que modifican, el tipo de nota, el tope de la nota de crédito y su envío a SUNAT.

Una nota de crédito (tipo `07`) baja el importe de un comprobante ya emitido: una devolución, un descuento o la anulación
de la operación. Una nota de débito (tipo `08`) lo sube: intereses por mora o un aumento en el valor. Las dos van con el
mismo endpoint que la factura y la boleta.

- Endpoint: `POST /comprobantes` · alcance `comprobantes.emitir`.
- Serie: una de notas del tipo que corresponde (las de una factura empiezan con F y las de una boleta con B). Revisa
  las de tu local en `GET /establecimientos`.
- Llegan a SUNAT como su comprobante: la nota de una factura se envía directo y la de una boleta va en el resumen
  diario.

## Nota de crédito: anulación de la operación

```json
{
  "serie_documento": "FC01",
  "numero_documento": "#",
  "fecha_de_emision": "2026-11-04",
  "hora_de_emision": "16:40:00",
  "codigo_tipo_documento": "07",
  "codigo_tipo_moneda": "PEN",
  "codigo_tipo_nota": "01",
  "motivo_o_sustento_de_nota": "Anulación de la operación",
  "documento_afectado": { "external_id": "9a0b1c2d-3e4f-4a5b-8c6d-7e8f9a0b1c2d" },
  "datos_del_cliente_o_receptor": {
    "codigo_tipo_documento_identidad": "6",
    "numero_documento": "20601234567",
    "apellidos_y_nombres_o_razon_social": "CONSTRUCTORA ANDINA S.A.C.",
    "codigo_pais": "PE"
  },
  "totales": {
    "total_operaciones_gravadas": 1000,
    "total_igv": 180,
    "total_impuestos": 180,
    "total_valor": 1000,
    "total_venta": 1180
  },
  "items": [{
    "codigo_interno": "CEM-42",
    "descripcion": "Cemento 42.5 kg",
    "unidad_de_medida": "NIU",
    "cantidad": 40,
    "valor_unitario": 25,
    "codigo_tipo_precio": "01",
    "precio_unitario": 29.5,
    "codigo_tipo_afectacion_igv": "10",
    "total_base_igv": 1000,
    "porcentaje_igv": 18,
    "total_igv": 180,
    "total_impuestos": 180,
    "total_valor_item": 1000,
    "total_item": 1180
  }]
}
```

- `documento_afectado` acepta el `external_id` del comprobante **o** su serie, número y tipo:
  `{"serie_documento": "F001", "numero_documento": "120", "codigo_tipo_documento": "01"}`. Si no existe, responde 422
  `documento_afectado_no_existe`.
- La nota no lleva `codigo_tipo_operacion` ni `pagos`.
- Para una devolución parcial, manda solo las líneas y cantidades que devuelves, con sus totales.

## Tipos de nota más usados

| Nota | `codigo_tipo_nota` | Para qué |
|---|---|---|
| Crédito | `01` | Anulación de la operación |
| Crédito | `06` | Devolución total |
| Crédito | `07` | Devolución por ítem |
| Crédito | `13` | Ajustes de montos o fechas de pago (cuotas de una venta a crédito) |
| Débito | `01` | Intereses por mora |
| Débito | `02` | Aumento en el valor |

Son los catálogos 09 (crédito) y 10 (débito) de SUNAT.

## El tope de la nota de crédito

La suma de las notas de crédito de un comprobante no puede pasar de lo que queda de él. Si pasa, responde 422
`nota_credito_excede` con lo que aún se puede acreditar. Es la misma regla de la web.

## Nota de crédito o anulación

Si el comprobante está aceptado y quieres dejarlo sin efecto, tienes dos caminos:

- **Anularlo** con `POST /comprobantes/{id}/anular`: comunicación de baja (factura) o resumen de anulación (boleta).
  SUNAT pone plazos para la baja; si ya pasaron, usa la nota de crédito. Ver [Anular](https://www.sistemafacturacionperu.com/desarrolladores/guias/anulaciones/).
- **Emitir una nota de crédito** de tipo `01`: el comprobante sigue aceptado y la nota lo compensa.

Si dudas, la nota de crédito es el camino que siempre está disponible.

---

# Anular comprobantes: comunicación de baja y resumen de anulación

URL: https://www.sistemafacturacionperu.com/desarrolladores/guias/anulaciones/

Anula facturas, boletas y sus notas por API con una sola llamada: el sistema elige la comunicación de baja o el resumen de anulación y te da el ticket de SUNAT.

Con una sola llamada anulas cualquier comprobante aceptado. **El sistema elige el camino** que pide SUNAT:

| Comprobante | Cómo se anula ante SUNAT |
|---|---|
| Factura y sus notas | Comunicación de baja |
| Boleta y sus notas | Resumen diario de anulación |

- Endpoint: `POST /comprobantes/{id}/anular` · alcance `comprobantes.anular`.
- Solo comprobantes `aceptado` u `observado`. Uno que aún no está en SUNAT, que ya está anulado o que no se puede anular
  responde 409 `ya_anulado` o 422 `no_anulable`.

## Pide la anulación

```bash
curl -X POST https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes/1521/anular \
  -H "Authorization: Bearer $SFP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: anular-1521" \
  -d '{"motivo": "Error en el precio"}'
```

```php
<?php
$ch = curl_init('https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes/1521/anular');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('SFP_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: anular-1521',
    ],
    CURLOPT_POSTFIELDS => json_encode(['motivo' => 'Error en el precio']),
]);
$anulacion = json_decode(curl_exec($ch), true)['data'];   // ['tipo' => 'baja', 'ticket' => '…', …]
```

```js
const res = await fetch('https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes/1521/anular', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SFP_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'anular-1521',
  },
  body: JSON.stringify({ motivo: 'Error en el precio' }),
});
const { data: anulacion } = await res.json(); // { tipo: 'baja', ticket: '…', … }
```

```python
r = requests.post(
    "https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes/1521/anular",
    json={"motivo": "Error en el precio"},
    headers={"Authorization": f"Bearer {os.environ['SFP_API_KEY']}", "Idempotency-Key": "anular-1521"},
    timeout=90,
)
anulacion = r.json()["data"]
```

El `motivo` va de 3 a 100 caracteres. La respuesta es **202**: la anulación se envió y SUNAT la procesa por ticket.

```json
{
  "success": true,
  "data": {
    "tipo": "baja",
    "ticket": "1730646000123",
    "external_id": "a1b2c3d4-…",
    "estado": { "codigo": "03", "clave": "enviado", "descripcion": "Enviado" },
    "consultar": "https://pruebas.sistemafacturacionperu.com/api/v1/anulaciones/1730646000123"
  }
}
```

Usar como `Idempotency-Key` algo como `anular-<id>` es buena idea: si repites la llamada por un corte de red, no se pide
dos veces.

## Consulta el resultado

`GET /anulaciones/{ticket}` consulta el ticket en SUNAT en ese momento y devuelve el estado de la baja o del resumen:

```json
{
  "success": true,
  "data": {
    "tipo": "baja",
    "ticket": "1730646000123",
    "estado": { "codigo": "05", "clave": "aceptado", "descripcion": "Aceptado" },
    "sunat": { "codigo": "0", "descripcion": "La Comunicacion de baja RA-20261104-1, ha sido aceptada", "notas": [] }
  }
}
```

Después, `GET /comprobantes/{id}` muestra el comprobante `anulado`.

Mejor todavía: con un [webhook](https://www.sistemafacturacionperu.com/desarrolladores/webhooks/) te llegan `resumen.procesado` (SUNAT procesó la baja o el
resumen) y `comprobante.anulado` (el comprobante quedó anulado), sin preguntar. El sistema también consulta solo las
bajas que quedaron sin respuesta.

## Mientras tanto

El comprobante queda `por_anular` hasta que SUNAT responde. Si SUNAT rechaza la baja (por ejemplo, porque pasó su
plazo), el comprobante no queda anulado: en ese caso emite una
[nota de crédito](https://www.sistemafacturacionperu.com/desarrolladores/guias/notas-de-credito-y-debito/).

---

# Resumen diario de boletas

URL: https://www.sistemafacturacionperu.com/desarrolladores/guias/resumen-diario/

Cómo informa el sistema tus boletas a SUNAT con el resumen diario automático, cuándo quedan aceptadas y qué avisos te llegan, sin una sola llamada extra.

Las boletas y sus notas no se envían una por una: SUNAT las recibe agrupadas en el **resumen diario**. Con la API v1
**no tienes que armarlo ni enviarlo**: el sistema lo hace por ti, igual que para las boletas que emites desde la web.

## Cómo funciona

1. Emites boletas con `POST /comprobantes` durante el día. Quedan `registrado`.
2. Dos veces al día, el sistema arma el resumen con las boletas **de los días anteriores** (nunca las del día en curso,
   que todavía puede tener ventas) y lo envía a SUNAT. Las boletas pasan a `enviado`.
3. SUNAT responde por ticket. El sistema consulta los resúmenes enviados y, cuando SUNAT los procesa, cada boleta pasa
   a `aceptado` o `rechazado`.

Viene encendido en todas las empresas y no depende de que tengas la web abierta. Las boletas que no se pudieron
enviar siguen `registrado` y entran en la siguiente corrida.

## Qué te avisa

Con un [webhook](https://www.sistemafacturacionperu.com/desarrolladores/webhooks/) suscrito recibes:

| Evento | Cuándo |
|---|---|
| `resumen.procesado` | SUNAT procesó un resumen diario (o una comunicación de baja) |
| `comprobante.aceptado` | Cada boleta (o nota) del resumen quedó aceptada |
| `comprobante.rechazado` | Una boleta del resumen fue rechazada |

Si no usas webhooks, consulta el estado con `GET /comprobantes/{id}` o lista las aceptadas del día con
`GET /comprobantes?tipo=03&desde=2026-11-03&hasta=2026-11-03&estado=aceptado`.

## Lo que no hace falta

- **No** existe un endpoint de la v1 para crear resúmenes: el sistema los crea solo.
- **No** reenvíes boletas con `POST /comprobantes/{id}/reenviar-sunat`: responde 422 `va_en_resumen`.
- Para **anular** una boleta sí hay una llamada: `POST /comprobantes/{id}/anular` arma el resumen de anulación
  ([Anular](https://www.sistemafacturacionperu.com/desarrolladores/guias/anulaciones/)).

## En la web

La empresa ve cada resumen en **Ventas › Comprobantes › Estado SUNAT › Resúmenes diarios**, con su ticket y la
respuesta de SUNAT.

> **Para socios:** cada resumen diario que sale por nuestro PSE descuenta 1 de tu bolsa, y se envía aunque tu saldo
> esté en cero (dejar boletas sin informar sería peor). Ver [API de socios](https://www.sistemafacturacionperu.com/desarrolladores/socios/).

---

# Guías de remisión electrónicas por API

URL: https://www.sistemafacturacionperu.com/desarrolladores/guias/guias-de-remision/

Emite guías de remisión remitente (09) y transportista (31) con la API nueva de SUNAT en una sola llamada: crear, enviar y consultar el ticket.

La guía de remisión respalda el traslado de mercadería. La API v1 la emite **en una sola llamada**: la crea, la envía a
la API de guías de SUNAT y consulta el ticket una vez. Si SUNAT todavía no responde, queda `pendiente` y la vuelves a
consultar con `GET /guias/{id}`.

| Guía | `codigo_tipo_documento` | Quién la emite |
|---|---|---|
| Remitente | `09` | El dueño de la mercadería que la traslada (venta, traslado entre locales, compra…) |
| Transportista | `31` | La empresa de transporte que lleva carga ajena y cobra el flete |

- Endpoint: `POST /guias` · alcance `guias.emitir`.
- Series: las de guía de tu local (`GET /establecimientos`); por norma de SUNAT las de remitente empiezan con T y las de
  transportista con V.
- En producción la empresa necesita sus **credenciales de guías** (usuario secundario SOL, Client ID y Client secret) o
  enviar por un PSE. Ver [pase a producción](https://www.sistemafacturacionperu.com/desarrolladores/pase-a-produccion/).

## Guía de remitente: JSON mínimo

Traslado de 40 bolsas de cemento por venta, en transporte privado (con chofer y vehículo propios):

```json
{
  "serie_documento": "T001",
  "numero_documento": "#",
  "fecha_de_emision": "2026-11-04",
  "hora_de_emision": "09:00:00",
  "codigo_tipo_documento": "09",
  "datos_del_cliente_o_receptor": {
    "codigo_tipo_documento_identidad": "6",
    "numero_documento": "20601234567",
    "apellidos_y_nombres_o_razon_social": "CONSTRUCTORA ANDINA S.A.C."
  },
  "codigo_modo_transporte": "02",
  "codigo_motivo_traslado": "01",
  "fecha_de_traslado": "2026-11-04",
  "peso_total": 1000,
  "unidad_peso_total": "KGM",
  "direccion_partida": { "ubigeo": "150101", "direccion": "Av. Lima 123", "codigo_del_domicilio_fiscal": "0000" },
  "direccion_llegada": { "ubigeo": "150132", "direccion": "Jr. Las Obras 456", "codigo_del_domicilio_fiscal": "0000" },
  "chofer": {
    "codigo_tipo_documento_identidad": "1",
    "numero_documento": "40123456",
    "nombres": "Luis Quispe",
    "numero_licencia": "Q40123456"
  },
  "vehiculo": { "numero_de_placa": "ABC123" },
  "items": [
    { "codigo_interno": "CEM-42", "descripcion": "Cemento 42.5 kg", "unidad_de_medida": "NIU", "cantidad": 40 }
  ]
}
```

```bash
curl -X POST https://pruebas.sistemafacturacionperu.com/api/v1/guias \
  -H "Authorization: Bearer $SFP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: guia-$(uuidgen)" \
  -d @guia.json
```

```php
<?php
$ch = curl_init('https://pruebas.sistemafacturacionperu.com/api/v1/guias');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_TIMEOUT => 90,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('SFP_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: ' . bin2hex(random_bytes(16)),
    ],
    CURLOPT_POSTFIELDS => file_get_contents('guia.json'),
]);
$guia = json_decode(curl_exec($ch), true)['data'];
```

```js
import { readFile } from 'node:fs/promises';
import { randomUUID } from 'node:crypto';

const res = await fetch('https://pruebas.sistemafacturacionperu.com/api/v1/guias', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SFP_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': randomUUID(),
  },
  body: await readFile('guia.json', 'utf8'),
});
const { data: guia } = await res.json();
```

```python
r = requests.post(
    "https://pruebas.sistemafacturacionperu.com/api/v1/guias",
    json=json.load(open("guia.json", encoding="utf-8")),
    headers={"Authorization": f"Bearer {os.environ['SFP_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
    timeout=90,
)
guia = r.json()["data"]
```

Respuesta (201), aceptada o pendiente:

```json
{
  "success": true,
  "data": {
    "id": 310,
    "external_id": "4c5d6e7f-…",
    "tipo": "09",
    "numero_completo": "T001-58",
    "fecha_emision": "2026-11-04",
    "fecha_traslado": "2026-11-04",
    "estado": { "codigo": "05", "clave": "aceptado", "descripcion": "Aceptado" },
    "ticket": "a9b8c7d6-…",
    "sunat": { "codigo": "0", "descripcion": "…", "notas": [] },
    "enlaces": { "pdf": "…/guias/310/pdf", "xml": "…/guias/310/xml", "cdr": "…/guias/310/cdr" },
    "avisos": []
  }
}
```

Si el envío falló, la guía queda creada y `avisos` dice qué pasó y cómo reintentar: `POST /guias/{id}/enviar`.

## Campos clave

| Campo | Qué poner |
|---|---|
| `codigo_modo_transporte` | `01` transporte público (lo lleva una empresa de transporte) · `02` transporte privado (tu chofer y tu vehículo) |
| `codigo_motivo_traslado` | `01` venta · `02` compra · `04` traslado entre locales de la misma empresa · `13` otros (con `descripcion_motivo_traslado`) |
| `peso_total` / `unidad_peso_total` | Peso bruto total; `KGM` (kilos) o `TNE` (toneladas) |
| `direccion_partida` / `direccion_llegada` | Ubigeo de 6 dígitos y dirección de hasta 100 caracteres; `codigo_del_domicilio_fiscal` es el código SUNAT del local |
| `transportista` | Solo con transporte público: `codigo_tipo_documento_identidad`, `numero_documento` (RUC), `apellidos_y_nombres_o_razon_social` y `numero_mtc` |
| `chofer` / `vehiculo` | Con transporte privado: documento, nombres y licencia del chofer; placa del vehículo |
| `items[].codigo_interno` | Obligatorio en cada línea (con `descripcion` y `cantidad` mayor que 0) |

Con **transporte público**, cambia `chofer` y `vehiculo` por la empresa de transporte:

```json
{
  "codigo_modo_transporte": "01",
  "transportista": {
    "codigo_tipo_documento_identidad": "6",
    "numero_documento": "20512345678",
    "apellidos_y_nombres_o_razon_social": "TRANSPORTES RAPIDOS S.A.C.",
    "numero_mtc": "1234567CNG"
  }
}
```

## La guía de una venta (y al revés)

- Para emitir la guía de una cotización o un pedido, manda `"origen": {"tipo": "pedido", "id": 33}`.
- Para facturar lo que ya salió con una guía, emite la factura con `"origen": {"tipo": "guia", "id": 310}`: queda
  amarrada y la mercadería no se descuenta dos veces. Si el amarre no se puede hacer, la factura igual se emite y
  `avisos` lo dice.

## Guía de transportista (31)

La emite la empresa de transporte. En vez del cliente lleva al **remitente** y al **destinatario** de la carga:

```json
{
  "codigo_tipo_documento": "31",
  "datos_remitente": {
    "codigo_tipo_documento_identidad": "6",
    "descripcion_tipo_documento_identidad": "RUC",
    "numero_documento": "20601234567",
    "apellidos_y_nombres_o_razon_social": "FERRETERIA LIMA S.A.C."
  },
  "datos_destinatario": {
    "codigo_tipo_documento_identidad": "6",
    "descripcion_tipo_documento_identidad": "RUC",
    "numero_documento": "20601234568",
    "apellidos_y_nombres_o_razon_social": "CONSTRUCTORA ANDINA S.A.C."
  }
}
```

Lo demás (fechas, peso, partida, llegada, chofer, vehículo e ítems) va como en la de remitente. Te recomendamos probar
tu primera guía de transportista en el modo pruebas antes de pasar a producción.

## Estados y avisos

- `aceptado` o `rechazado`: SUNAT respondió el ticket en la misma llamada.
- `pendiente`: SUNAT aún no responde. `GET /guias/{id}` vuelve a consultar el ticket.
- Webhooks: `guia.aceptada` y `guia.rechazada`.
- Archivos: `GET /guias/{id}/pdf`, `/xml` y `/cdr`.

> Si tu plan ya llegó a su límite de comprobantes del ciclo, la guía responde 422 `limite_plan` antes de crear nada,
> como en la web.

---

# Comprobante de retención electrónico por API

URL: https://www.sistemafacturacionperu.com/desarrolladores/guias/retenciones/

JSON mínimo para emitir el comprobante de retención (20) por API cuando eres agente de retención del IGV: proveedor, facturas pagadas e importes retenidos.

El comprobante de retención (tipo `20`) lo emite el **agente de retención** designado por SUNAT cuando paga facturas a
sus proveedores y retiene un porcentaje del IGV. Casi ninguna MYPE lo es: si SUNAT no te lo comunicó, no lo necesitas.

- Endpoint: `POST /retenciones` · alcance `comprobantes.emitir` · desde el Plan PRO.
- En la empresa: **Configuración › Empresa › Datos y facturación SUNAT › «Soy agente de retención»**.
- Usa el mismo JSON de la API antigua (`/api/retentions`); el local va en `establecimiento` (código SUNAT) o sale de tu
  clave.

## JSON mínimo

Pagas una factura de S/ 1.000 a un proveedor y retienes el 3 % (S/ 30):

```json
{
  "serie_documento": "R001",
  "numero_documento": "#",
  "fecha_de_emision": "2026-11-04",
  "hora_de_emision": "11:00:00",
  "codigo_tipo_documento": "20",
  "datos_del_proveedor": {
    "codigo_tipo_documento_identidad": "6",
    "numero_documento": "20512345678",
    "apellidos_y_nombres_o_razon_social": "DISTRIBUIDORA NORTE S.A.C.",
    "codigo_pais": "PE",
    "ubigeo": "150101",
    "direccion": "Av. Industrial 450"
  },
  "codigo_tipo_retencion": "01",
  "observaciones": "Retención del pago de la factura F001-120",
  "totales": {
    "total_retenido": 30,
    "total_pagado": 970
  },
  "documentos": [{
    "codigo_tipo_documento": "01",
    "serie_documento": "F001",
    "numero_documento": "120",
    "fecha_de_emision": "2026-11-01",
    "codigo_tipo_moneda": "PEN",
    "total_documento": 1000,
    "pagos": [{ "fecha_de_pago": "2026-11-04", "total_pago": 1000, "codigo_tipo_moneda": "PEN" }],
    "fecha_de_retencion": "2026-11-04",
    "total_retenido": 30,
    "total_a_pagar": 970,
    "total_pagado": 970
  }]
}
```

```bash
curl -X POST https://pruebas.sistemafacturacionperu.com/api/v1/retenciones \
  -H "Authorization: Bearer $SFP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: retencion-$(uuidgen)" \
  -d @retencion.json
```

```php
<?php
$ch = curl_init('https://pruebas.sistemafacturacionperu.com/api/v1/retenciones');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_TIMEOUT => 90,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('SFP_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: ' . bin2hex(random_bytes(16)),
    ],
    CURLOPT_POSTFIELDS => file_get_contents('retencion.json'),
]);
$retencion = json_decode(curl_exec($ch), true)['data'];
```

```js
const res = await fetch('https://pruebas.sistemafacturacionperu.com/api/v1/retenciones', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SFP_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': randomUUID(),
  },
  body: await readFile('retencion.json', 'utf8'),
});
const { data: retencion } = await res.json();
```

```python
r = requests.post(
    "https://pruebas.sistemafacturacionperu.com/api/v1/retenciones",
    json=json.load(open("retencion.json", encoding="utf-8")),
    headers={"Authorization": f"Bearer {os.environ['SFP_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
    timeout=90,
)
retencion = r.json()["data"]
```

Respuesta (201):

```json
{
  "success": true,
  "data": {
    "id": 33,
    "tipo": "20",
    "numero_completo": "R001-33",
    "fecha_emision": "2026-11-04",
    "estado": { "codigo": "05", "clave": "aceptado", "descripcion": "Aceptado" },
    "sunat": { "codigo": "0", "descripcion": "El Comprobante numero R001-33, ha sido aceptado", "notas": [] },
    "enlaces_publicos": { "pdf": "…", "xml": "…", "cdr": "…" }
  }
}
```

## Notas

- `codigo_tipo_retencion` `01` es la tasa de 3 % del régimen de retenciones del IGV.
- El proveedor (`datos_del_proveedor`) se crea o actualiza en tus proveedores con esos datos.
- Cada línea de `documentos` es un comprobante del proveedor que estás pagando. Puedes poner varios.
- Si pagas en dólares, agrega en el documento `tipo_de_cambio`: `{"codigo_tipo_moneda_referencia": "USD",
  "codigo_tipo_moneda_objetivo": "PEN", "factor": 3.741, "fecha_tipo_de_cambio": "2026-11-04"}`. El tipo de cambio de
  SUNAT del día sale de [`GET /consultas/tipo-cambio`](https://www.sistemafacturacionperu.com/desarrolladores/consultas/).
- No lo confundas con el campo `retencion` de una factura de venta (cuando tu cliente es agente de retención y te
  retiene a ti): ese va dentro de `POST /comprobantes` y no se combina con una detracción (422
  `detraccion_con_retencion`, ver [casos especiales](https://www.sistemafacturacionperu.com/desarrolladores/guias/casos-especiales/)).

---

# Comprobante de percepción electrónico por API

URL: https://www.sistemafacturacionperu.com/desarrolladores/guias/percepciones/

JSON mínimo para emitir el comprobante de percepción (40) por API cuando eres agente de percepción: cliente, comprobantes cobrados e importes percibidos.

El comprobante de percepción (tipo `40`) lo emite el **agente de percepción** designado por SUNAT cuando cobra a sus
clientes un porcentaje adicional al venderles ciertos bienes (por ejemplo, combustible o harina). Si SUNAT no te lo
comunicó, no lo necesitas.

- Endpoint: `POST /percepciones` · alcance `comprobantes.emitir` · desde el Plan PRO.
- En la empresa: **Configuración › Empresa › Datos y facturación SUNAT › «Soy agente de percepción»**.
- Usa el mismo JSON de la API antigua (`/api/perceptions`); el local sale de tu clave o de `establecimiento`.

## JSON mínimo

Cobras una factura de S/ 1.000 y percibes el 2 % (S/ 20):

```json
{
  "serie_documento": "P001",
  "numero_documento": "#",
  "fecha_de_emision": "2026-11-04",
  "hora_de_emision": "11:30:00",
  "codigo_tipo_documento": "40",
  "datos_del_cliente_o_receptor": {
    "codigo_tipo_documento_identidad": "6",
    "numero_documento": "20601234567",
    "apellidos_y_nombres_o_razon_social": "BODEGA LIMA S.A.C.",
    "codigo_pais": "PE",
    "ubigeo": "150101",
    "direccion": "Av. Lima 1"
  },
  "codigo_tipo_percepcion": "01",
  "observaciones": "Percepción de la factura F001-121",
  "totales": {
    "total_percibido": 20,
    "total_pagado": 1020
  },
  "documentos": [{
    "codigo_tipo_documento": "01",
    "serie_documento": "F001",
    "numero_documento": "121",
    "fecha_de_emision": "2026-11-02",
    "codigo_tipo_moneda": "PEN",
    "total_documento": 1000,
    "pagos": [{ "fecha_de_pago": "2026-11-04", "total_pago": 1000, "codigo_tipo_moneda": "PEN" }],
    "fecha_de_percepcion": "2026-11-04",
    "total_percibido": 20,
    "total_a_pagar": 1020,
    "total_pagado": 1020
  }]
}
```

Se envía igual que la [retención](https://www.sistemafacturacionperu.com/desarrolladores/guias/retenciones/), a `POST /percepciones`:

```bash
curl -X POST https://pruebas.sistemafacturacionperu.com/api/v1/percepciones \
  -H "Authorization: Bearer $SFP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: percepcion-$(uuidgen)" \
  -d @percepcion.json
```

```php
<?php
$ch = curl_init('https://pruebas.sistemafacturacionperu.com/api/v1/percepciones');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_TIMEOUT => 90,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('SFP_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: ' . bin2hex(random_bytes(16)),
    ],
    CURLOPT_POSTFIELDS => file_get_contents('percepcion.json'),
]);
$percepcion = json_decode(curl_exec($ch), true)['data'];
```

```js
const res = await fetch('https://pruebas.sistemafacturacionperu.com/api/v1/percepciones', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SFP_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': randomUUID(),
  },
  body: await readFile('percepcion.json', 'utf8'),
});
const { data: percepcion } = await res.json();
```

```python
r = requests.post(
    "https://pruebas.sistemafacturacionperu.com/api/v1/percepciones",
    json=json.load(open("percepcion.json", encoding="utf-8")),
    headers={"Authorization": f"Bearer {os.environ['SFP_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
    timeout=90,
)
percepcion = r.json()["data"]
```

## Tipos de percepción

| `codigo_tipo_percepcion` | Tasa | Para qué |
|---|---|---|
| `01` | 2 % | Percepción venta interna |
| `02` | 1 % | Adquisición de combustible |
| `03` | 0,5 % | Agente de percepción con tasa especial |

Son el catálogo 22 de SUNAT. La percepción siempre es en soles: si el comprobante cobrado es en dólares, agrega su
`tipo_de_cambio` como en la retención.

---

# Liquidación de compra electrónica por API

URL: https://www.sistemafacturacionperu.com/desarrolladores/guias/liquidaciones-de-compra/

JSON mínimo para emitir la liquidación de compra electrónica (04) por API cuando compras a una persona sin RUC: vendedor, lugar de la operación, ítems y totales.

La liquidación de compra (tipo `04`) la emites **tú, el comprador**, cuando le compras a una persona natural que no
tiene RUC ni puede darte un comprobante (por ejemplo, un productor agrícola o un recolector). Sustenta tu compra y el
crédito fiscal.

- Endpoint: `POST /liquidaciones-compra` · alcance `comprobantes.emitir` · desde el Plan PRO.
- Usa el mismo JSON de la API antigua (`/api/purchase-settlements`); el local sale de tu clave o de `establecimiento`.
- Serie: la de liquidaciones de compra de tu local (`GET /establecimientos`, tipo `04`). En el ejemplo, `L001`.

## JSON mínimo

Compras 500 kg de papa a S/ 1,18 el kilo con IGV:

```json
{
  "serie_documento": "L001",
  "numero_documento": "#",
  "fecha_de_emision": "2026-11-04",
  "hora_de_emision": "08:30:00",
  "codigo_tipo_operacion": "0101",
  "codigo_tipo_documento": "04",
  "codigo_tipo_moneda": "PEN",
  "datos_del_proveedor_o_receptor": {
    "codigo_tipo_documento_identidad": "1",
    "numero_documento": "41234567",
    "apellidos_y_nombres_o_razon_social": "Juan Mamani Quispe",
    "codigo_pais": "PE",
    "ubigeo": "080101",
    "direccion": "Comunidad San Jerónimo s/n"
  },
  "datos_de_la_operacion": {
    "codigo_pais": "PE",
    "ubigeo": "080101",
    "direccion": "Comunidad San Jerónimo s/n"
  },
  "totales": {
    "total_operaciones_gravadas": 500,
    "total_igv": 90,
    "total_impuestos": 90,
    "total_valor": 500,
    "subtotal_compra": 590,
    "total_compra": 590
  },
  "items": [{
    "codigo_interno": "PAPA-01",
    "descripcion": "Papa blanca",
    "unidad_de_medida": "KGM",
    "cantidad": 500,
    "valor_unitario": 1,
    "codigo_tipo_precio": "01",
    "precio_unitario": 1.18,
    "codigo_tipo_afectacion_igv": "10",
    "total_base_igv": 500,
    "porcentaje_igv": 18,
    "total_igv": 90,
    "total_impuestos": 90,
    "total_valor_item": 500,
    "total_item": 590
  }]
}
```

```bash
curl -X POST https://pruebas.sistemafacturacionperu.com/api/v1/liquidaciones-compra \
  -H "Authorization: Bearer $SFP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: liquidacion-$(uuidgen)" \
  -d @liquidacion.json
```

```php
<?php
$ch = curl_init('https://pruebas.sistemafacturacionperu.com/api/v1/liquidaciones-compra');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_TIMEOUT => 90,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('SFP_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: ' . bin2hex(random_bytes(16)),
    ],
    CURLOPT_POSTFIELDS => file_get_contents('liquidacion.json'),
]);
$liquidacion = json_decode(curl_exec($ch), true)['data'];
```

```js
const res = await fetch('https://pruebas.sistemafacturacionperu.com/api/v1/liquidaciones-compra', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SFP_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': randomUUID(),
  },
  body: await readFile('liquidacion.json', 'utf8'),
});
const { data: liquidacion } = await res.json();
```

```python
r = requests.post(
    "https://pruebas.sistemafacturacionperu.com/api/v1/liquidaciones-compra",
    json=json.load(open("liquidacion.json", encoding="utf-8")),
    headers={"Authorization": f"Bearer {os.environ['SFP_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
    timeout=90,
)
liquidacion = r.json()["data"]
```

## Campos clave

| Campo | Qué poner |
|---|---|
| `datos_del_proveedor_o_receptor` | La persona que te vende: normalmente con DNI (`1`) |
| `datos_de_la_operacion` | Dónde se hizo la compra: país, ubigeo y dirección |
| `totales.subtotal_compra` / `total_compra` | El total de la compra (en las ventas se llaman `subtotal_venta` y `total_venta`) |
| `items[].codigo_interno` | Obligatorio en cada línea |

Si corresponde retener el impuesto a la renta, cada línea acepta `codigo_tipo_afectacion_igv_impuesto_renta`,
`porcentaje_retencion_renta` y `monto_retencion_renta`.

La respuesta tiene la misma forma que la de la [retención](https://www.sistemafacturacionperu.com/desarrolladores/guias/retenciones/): número, estado,
respuesta de SUNAT y enlaces públicos al PDF, XML y CDR.

---

# Casos especiales: detracción, anticipos, exportación, gratuitas e ICBPER

URL: https://www.sistemafacturacionperu.com/desarrolladores/guias/casos-especiales/

Los campos que cambian en una factura con detracción, anticipos, exportación, moneda extranjera, operaciones gratuitas o impuesto a las bolsas plásticas (ICBPER).

Todos estos casos van en `POST /comprobantes` con el JSON de la [factura](https://www.sistemafacturacionperu.com/desarrolladores/guias/factura/). Aquí solo
están **los campos que cambian**. El servidor aplica las mismas reglas que la pantalla de la web, así que la API no
deja emitir lo que la web tampoco deja.

> **Prueba cada caso en el modo pruebas** antes de pasarlo a producción: la beta de SUNAT valida los importes igual que
> producción y te dice qué corregir.

## Detracción

Para una venta sujeta al sistema de detracciones (SPOT):

```json
{
  "codigo_tipo_operacion": "1001",
  "detraccion": {
    "codigo_tipo_detraccion": "037",
    "porcentaje": 12,
    "monto": 141.6,
    "codigo_metodo_pago": "001",
    "cuenta_bancaria": "00-000-123456"
  }
}
```

- `codigo_tipo_operacion` va con `1001` (o `1004` si es transporte de carga). Con otra operación responde 422
  `detraccion_operacion`.
- `codigo_tipo_detraccion` es el código del bien o servicio (catálogo 54 de SUNAT) y tiene que estar activo en tu empresa
  (**Ventas › Configuración › Detracciones**); si no, 422 `detraccion_codigo`.
- **Mínimo por código.** Cada código aplica desde un monto: el `037` (demás servicios gravados con el IGV), por ejemplo,
  a ventas mayores a S/ 700. Por debajo responde 422 `detraccion_minimo`, salvo que tu empresa tenga encendida
  «Detracción para montos menores» en Ventas › Configuración. En moneda extranjera, el mínimo se compara en soles con
  `factor_tipo_de_cambio`.
- **Sin retención junto.** SUNAT no aplica detracción y retención del IGV a la misma venta: si mandas las dos, 422
  `detraccion_con_retencion`.
- `cuenta_bancaria` es tu cuenta de detracciones del Banco de la Nación y `codigo_metodo_pago` el medio de pago del
  catálogo 59 (`001` depósito en cuenta).

**Transporte de carga (`1004`).** La detracción acepta además `ubigeo_origen`, `direccion_origen`, `ubigeo_destino`,
`direccion_destino`, `detalle_viaje`, `valor_referencial_servicio_transporte`, `valor_referencial_carga_util` y
`valor_referencia_carga_efectiva`. El mínimo se compara con el mayor entre el total y el valor referencial del
servicio.

## Anticipos

Un anticipo es un pago antes de entregar el bien o el servicio. Se hace en dos pasos:

1. **Emite el comprobante del anticipo** como una factura normal, con `"pago_anticipado": true`.
2. **En la factura final, descuéntalo.** Lista el anticipo en `anticipos` y su descuento global, y pon el importe en
   `totales.total_anticipos`:

```json
{
  "anticipos": [
    { "numero": "F001-25", "codigo_tipo_documento": "02", "monto": 500, "total": 590 }
  ],
  "descuentos": [
    { "codigo": "04", "descripcion": "Descuento global por anticipos gravados", "factor": 0.25, "monto": 500, "base": 2000 }
  ],
  "totales": {
    "total_anticipos": 590,
    "total_descuentos": 500,
    "total_operaciones_gravadas": 1500,
    "total_igv": 270,
    "total_impuestos": 270,
    "total_valor": 1500,
    "total_venta": 1770
  }
}
```

- `numero` es la serie y el número del anticipo (`F001-25`); `codigo_tipo_documento` es el tipo del catálogo 12
  (`02` factura de anticipo, `03` boleta de anticipo).
- El descuento global usa el código `04` si el anticipo está gravado (`05` exonerado, `06` inafecto).
- El servidor revisa cada anticipo: que exista, que sea de anticipo, que no esté anulado y que tenga saldo para lo que
  descuentas. Si no, 422 `anticipo_no_existe` o `anticipo_sin_saldo` (con el saldo que le queda).

## Exportación

```json
{
  "codigo_tipo_operacion": "0200",
  "codigo_tipo_moneda": "USD",
  "factor_tipo_de_cambio": 3.741,
  "datos_del_cliente_o_receptor": {
    "codigo_tipo_documento_identidad": "0",
    "numero_documento": "98-7654321",
    "apellidos_y_nombres_o_razon_social": "ANDES IMPORTS LLC",
    "codigo_pais": "US",
    "direccion": "1200 Brickell Ave, Miami FL"
  },
  "totales": {
    "total_exportacion": 1000,
    "total_igv": 0,
    "total_impuestos": 0,
    "total_valor": 1000,
    "total_venta": 1000
  },
  "items": [{
    "codigo_interno": "CAF-EXP",
    "descripcion": "Café en grano tostado, saco de 25 kg",
    "unidad_de_medida": "NIU",
    "cantidad": 10,
    "valor_unitario": 100,
    "codigo_tipo_precio": "01",
    "precio_unitario": 100,
    "codigo_tipo_afectacion_igv": "40",
    "total_base_igv": 1000,
    "porcentaje_igv": 18,
    "total_igv": 0,
    "total_impuestos": 0,
    "total_valor_item": 1000,
    "total_item": 1000
  }]
}
```

- `0200` es exportación de bienes (catálogo 51). Las líneas van con afectación `40` y sin IGV.
- El cliente del exterior va con el tipo `0` (no domiciliado, sin RUC), su número de identificación y su país.

## Moneda extranjera

Cualquier comprobante puede ir en dólares: `"codigo_tipo_moneda": "USD"` y `"factor_tipo_de_cambio": 3.741`. Las
`cuotas` van en la misma moneda. El tipo de cambio de SUNAT del día sale de
[`GET /consultas/tipo-cambio`](https://www.sistemafacturacionperu.com/desarrolladores/consultas/).

## Operaciones gratuitas

Un bien que entregas sin cobrar (un premio, una muestra, una bonificación) va en el comprobante con su valor
referencial, pero **no suma** al total que paga el cliente. En la línea gratuita:

| Campo | Qué poner |
|---|---|
| `codigo_tipo_afectacion_igv` | El de transferencia gratuita: `11` a `16` si está gravada (por ejemplo, `15` bonificación), `21` exonerada, `31` a `37` inafecta |
| `codigo_tipo_precio` | `02` (valor referencial en operaciones no onerosas) |
| `valor_unitario` | `0` |
| `precio_unitario` | El valor referencial unitario |

En los totales, el valor de lo gratuito va en `total_operaciones_gratuitas` (y su IGV, si está gravada, en
`total_igv_operaciones_gratuitas`), fuera de `total_venta`. Si SUNAT responde **2640** («Operación gratuita, solo debe
consignar un monto referencial»), revisa que la línea no tenga precio cobrado.

## Impuesto a las bolsas plásticas (ICBPER)

Si entregas bolsas de plástico, cada bolsa paga el ICBPER. En la línea de la bolsa:

```json
{
  "codigo_interno": "BOLSA-01",
  "descripcion": "Bolsa plástica",
  "unidad_de_medida": "NIU",
  "cantidad": 2,
  "valor_unitario": 0.08,
  "codigo_tipo_precio": "01",
  "precio_unitario": 0.1,
  "codigo_tipo_afectacion_igv": "10",
  "total_base_igv": 0.17,
  "porcentaje_igv": 18,
  "total_igv": 0.03,
  "total_impuestos_bolsa_plastica": 1,
  "total_impuestos": 1.03,
  "total_valor_item": 0.17,
  "total_item": 1.2
}
```

- `total_impuestos_bolsa_plastica` de la línea es la cantidad de bolsas por el monto por bolsa (S/ 0,50 desde 2023).
  El monto por bolsa sale de la configuración de tu empresa.
- En `totales`, suma ese impuesto en `total_impuestos_bolsa_plastica`, en `total_impuestos` y en `total_venta`.

## Cargos y descuentos

Los descuentos y cargos por línea o globales van en `descuentos` y `cargos` con `codigo` (catálogo 53), `descripcion`,
`factor`, `monto` y `base`, y sus sumas en `totales.total_descuentos` y `totales.total_cargos`.

---

# Webhooks

URL: https://www.sistemafacturacionperu.com/desarrolladores/webhooks/

Recibe un aviso firmado cuando SUNAT acepta, observa o rechaza un comprobante. Eventos, verificación de la firma en PHP, Node.js y Python, reintentos y reenvíos.

En vez de preguntar cada minuto «¿ya lo aceptó SUNAT?», registra una dirección de tu sistema y te avisamos cuando cambia
el estado. Funciona para lo que emites por la API **y** para lo que la empresa emite desde la web.

## Eventos

| Evento | Cuándo |
|---|---|
| `comprobante.aceptado` | SUNAT aceptó un comprobante (también cada boleta cuando se procesa su resumen diario) |
| `comprobante.observado` | SUNAT lo aceptó con observaciones |
| `comprobante.rechazado` | SUNAT lo rechazó |
| `comprobante.anulado` | Quedó anulado (baja o resumen de anulación) |
| `guia.aceptada` / `guia.rechazada` | Respuesta de SUNAT a una guía de remisión |
| `resumen.procesado` | SUNAT procesó un resumen diario o una comunicación de baja |

La API de socios tiene sus propios eventos (`empresa.lista`, `saldo.bajo`, `cuota.vencida`…, ver
[API de socios](https://www.sistemafacturacionperu.com/desarrolladores/socios/)) y «Conectar con Sistema Facturación Perú» avisa `conexion.revocada`
([ver](https://www.sistemafacturacionperu.com/desarrolladores/conectar/)). Todos se firman igual.

## Registra tu webhook

En **Configuración › Sistema › Integraciones › API › Webhooks**, o por la API con el alcance `webhooks.gestionar`:

```bash
curl -X POST https://pruebas.sistemafacturacionperu.com/api/v1/webhooks \
  -H "Authorization: Bearer $SFP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: webhook-mi-sistema" \
  -d '{"url": "https://mi-sistema.pe/avisos-sfp", "eventos": ["comprobante.aceptado", "comprobante.rechazado"]}'
```

```php
<?php
$ch = curl_init('https://pruebas.sistemafacturacionperu.com/api/v1/webhooks');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('SFP_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: webhook-mi-sistema',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'url' => 'https://mi-sistema.pe/avisos-sfp',
        'eventos' => ['comprobante.aceptado', 'comprobante.rechazado'],
    ]),
]);
$webhook = json_decode(curl_exec($ch), true)['data'];
// Guarda $webhook['secreto'] (whsec_…) en tu servidor: no se vuelve a mostrar.
```

```js
const res = await fetch('https://pruebas.sistemafacturacionperu.com/api/v1/webhooks', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SFP_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'webhook-mi-sistema',
  },
  body: JSON.stringify({ url: 'https://mi-sistema.pe/avisos-sfp', eventos: ['comprobante.aceptado', 'comprobante.rechazado'] }),
});
const { data: webhook } = await res.json();
// Guarda webhook.secreto (whsec_…) en tu servidor: no se vuelve a mostrar.
```

```python
r = requests.post(
    "https://pruebas.sistemafacturacionperu.com/api/v1/webhooks",
    json={"url": "https://mi-sistema.pe/avisos-sfp", "eventos": ["comprobante.aceptado", "comprobante.rechazado"]},
    headers={"Authorization": f"Bearer {os.environ['SFP_API_KEY']}", "Idempotency-Key": "webhook-mi-sistema"},
    timeout=30,
)
webhook = r.json()["data"]  # guarda webhook["secreto"] (whsec_…): no se vuelve a mostrar
```

- La dirección tiene que ser **https** y de un dominio público.
- La respuesta trae el **secreto `whsec_…` una sola vez**. Con él verificas cada aviso.
- Hasta 10 webhooks por empresa (422 `limite_webhooks` si te pasas). `GET /webhooks` los lista junto con los eventos
  disponibles; `DELETE /webhooks/{id}` borra uno.
- Con una clave de pruebas, sus webhooks avisan solo de lo que emitió esa clave.

## Qué te llega

Un `POST` con un JSON y tres cabeceras:

```http
POST /avisos-sfp HTTP/1.1
Content-Type: application/json
X-SFP-Event: comprobante.aceptado
X-SFP-Delivery: 0b8f3c1e-2d4a-4f7e-9a61-6c5d2e1f0a9b
X-SFP-Signature: t=1762269309,v1=5f2c0b7e9d…
```

```json
{
  "id": "0b8f3c1e-2d4a-4f7e-9a61-6c5d2e1f0a9b",
  "evento": "comprobante.aceptado",
  "creado": "2026-11-04T10:15:09-05:00",
  "data": {
    "tipo_documento": "comprobante",
    "id": 1520,
    "external_id": "6f1c7d0e-8f7e-4a1c-9d5b-2a2f8e1c9b10",
    "tipo": "01",
    "numero_completo": "F001-120",
    "fecha_emision": "2026-11-04",
    "total": 1180,
    "moneda": "PEN",
    "estado": { "codigo": "05", "clave": "aceptado", "descripcion": "Aceptado" }
  }
}
```

`id` es igual a `X-SFP-Delivery`: guárdalo y **no proceses dos veces** el mismo aviso (un reintento trae el mismo id).

## Verifica la firma

`X-SFP-Signature` tiene la hora del envío (`t`, segundos Unix) y la firma (`v1`): un HMAC-SHA256, en hexadecimal, con tu
secreto `whsec_…` sobre `"<t>.<cuerpo crudo>"`. Calcula la firma sobre el **cuerpo tal como llegó** (no sobre el JSON
ya decodificado), compárala en tiempo constante y rechaza los avisos con más de 5 minutos.

```php
<?php
// PHP puro (o dentro de tu controlador de Laravel/Symfony con el cuerpo crudo).
$cuerpo = file_get_contents('php://input');
$cabecera = $_SERVER['HTTP_X_SFP_SIGNATURE'] ?? '';
parse_str(str_replace(',', '&', $cabecera), $partes);   // ['t' => '…', 'v1' => '…']

$esperada = hash_hmac('sha256', ($partes['t'] ?? '') . '.' . $cuerpo, getenv('SFP_WEBHOOK_SECRET'));
if (!hash_equals($esperada, $partes['v1'] ?? '') || abs(time() - (int) ($partes['t'] ?? 0)) > 300) {
    http_response_code(400);
    exit;
}

$aviso = json_decode($cuerpo, true);
// Encola el trabajo y responde rápido: $aviso['id'], $aviso['evento'], $aviso['data']['external_id']…
http_response_code(200);
```

```js
// Node.js con Express: lee el cuerpo crudo solo en esta ruta.
import crypto from 'node:crypto';
import express from 'express';

const app = express();
app.post('/avisos-sfp', express.raw({ type: 'application/json' }), (req, res) => {
  const partes = Object.fromEntries(String(req.get('X-SFP-Signature') || '').split(',').map((p) => p.split('=')));
  const esperada = crypto
    .createHmac('sha256', process.env.SFP_WEBHOOK_SECRET)
    .update(`${partes.t}.`)
    .update(req.body)
    .digest('hex');
  const ok =
    typeof partes.v1 === 'string' &&
    partes.v1.length === esperada.length &&
    crypto.timingSafeEqual(Buffer.from(esperada), Buffer.from(partes.v1)) &&
    Math.abs(Date.now() / 1000 - Number(partes.t)) <= 300;
  if (!ok) return res.sendStatus(400);

  const aviso = JSON.parse(req.body.toString('utf8'));
  // Encola el trabajo y responde rápido: aviso.id, aviso.evento, aviso.data.external_id…
  res.sendStatus(200);
});
```

```python
# Python con Flask
import hashlib, hmac, json, os, time
from flask import Flask, request, abort

app = Flask(__name__)

@app.post("/avisos-sfp")
def avisos_sfp():
    cuerpo = request.get_data()  # bytes, tal como llegaron
    partes = dict(p.split("=", 1) for p in request.headers.get("X-SFP-Signature", "").split(",") if "=" in p)
    esperada = hmac.new(os.environ["SFP_WEBHOOK_SECRET"].encode(),
                        partes.get("t", "").encode() + b"." + cuerpo, hashlib.sha256).hexdigest()
    if not hmac.compare_digest(esperada, partes.get("v1", "")) or abs(time.time() - int(partes.get("t", 0))) > 300:
        abort(400)

    aviso = json.loads(cuerpo)
    # Encola el trabajo y responde rápido: aviso["id"], aviso["evento"], aviso["data"]["external_id"]…
    return "", 200
```

## Responde rápido y reintentamos

- Responde **2xx en menos de 10 segundos**. Si tienes trabajo pesado, encólalo y responde primero.
- No seguimos redirecciones: un 301 o 302 cuenta como fallo.
- Si no responde 2xx, reintentamos a **1 min, 5 min, 30 min, 2 h, 6 h y 24 h**. Después la entrega queda `fallida`.
- Las entregas se guardan 30 días. `GET /webhooks/{id}/entregas?estado=fallido` las lista (con el código de respuesta y
  el error) y `POST /webhooks/entregas/{id}/reenviar` vuelve a mandar una ya mismo. También puedes reenviar desde la
  pantalla.

## Prueba en tu equipo

Para recibir avisos mientras desarrollas, expón tu servidor local con un túnel https (por ejemplo `ngrok` o
`cloudflared`) y registra esa dirección en un webhook de tu **clave de pruebas**. Emite una factura en el modo pruebas
y mira llegar `comprobante.aceptado`.

---

# Catálogo de errores

URL: https://www.sistemafacturacionperu.com/desarrolladores/errores/

Todos los códigos de error de la API v1, la API de socios y Conectar, con su causa y qué hacer, y los rechazos y observaciones de SUNAT más comunes explicados.

Cuando algo sale mal, la respuesta trae siempre un `code` **estable** y un `message` en español:

```json
{
  "success": false,
  "code": "validacion",
  "message": "Revisa los datos enviados.",
  "errors": { "totales.total_venta": ["El campo totales.total venta es obligatorio."] }
}
```

- **Decide por el `code`**, nunca por el texto del mensaje: el texto puede mejorar, el código no cambia.
- **Muestra el `message`** a tu usuario si te sirve: está pensado para leerse.
- `errors` aparece en las validaciones, con los campos que fallaron.
- En los 5xx no hay detalles internos. Reintenta con la misma `Idempotency-Key`.

## API v1

### Autenticación y permisos

| HTTP | `code` | Causa | Qué hacer |
|---|---|---|---|
| 401 | `clave_invalida` | Falta la clave o no existe | Envíala en `Authorization: Bearer <clave>` |
| 401 | `clave_revocada` | La revocaron | Crea otra en Configuración › Sistema › Integraciones › API |
| 401 | `clave_vencida` | Pasó su fecha de vencimiento | Crea otra o usa una sin vencimiento |
| 401 | `clave_en_url` | La mandaste en la URL o en el cuerpo | Solo en la cabecera `Authorization` |
| 401 | `clave_de_pruebas` | Una clave `sfp_test_` fuera del modo pruebas | Usa `pruebas.sistemafacturacionperu.com` o una clave `sfp_live_` |
| 401 | `token_invalido`, `token_vencido` | Conectar: el token no sirve o venció | Renuévalo con tu token de renovación |
| 401 | `conexion_revocada` | Conectar: la empresa desconectó tu aplicación | Pídele que vuelva a conectar |
| 401 | `aplicacion_suspendida` | Conectar: suspendimos tu aplicación | Escríbenos |
| 403 | `scope_faltante` | La clave no tiene el alcance (cabecera `X-SFP-Scope-Required`) | Crea una clave con ese alcance |
| 403 | `sin_permiso` | El usuario de la clave no tiene esa función | Dale la función al usuario o usa otra clave |
| 403 | `plan_sin_api` | El plan no incluye la API | La API viene desde el Plan PRO |
| 403 | `plan_insuficiente` | Conectar en Básico: esa función viene desde PRO (`errors.plan`, cabecera `X-SFP-Plan-Required`) | La empresa sube de plan; no hace falta reconectar |
| 403 | `establecimiento_no_permitido` | La clave tiene un local fijo y pediste otro | Usa una clave sin local fijo o la de ese local |
| 423 | `cuenta_bloqueada` | Pago vencido o cuenta suspendida | La empresa regulariza su pago |

### Petición

| HTTP | `code` | Causa | Qué hacer |
|---|---|---|---|
| 400 | `json_invalido` | El cuerpo no es JSON | Revisa el JSON y `Content-Type: application/json` |
| 400 | `idempotencia_invalida` | La `Idempotency-Key` está mal formada | Hasta 255 caracteres visibles; usa un UUID |
| 400 | `peticion_invalida` | La petición está mal armada | Revisa método, cabeceras y cuerpo |
| 404 | `no_encontrado` | No existe o tu clave no lo puede ver | Revisa el id; en pruebas, cada clave ve solo lo suyo |
| 404 | `cdr_no_disponible` | El comprobante aún no tiene constancia de SUNAT | Espera a que esté aceptado |
| 404 | `archivo_no_disponible` | El PDF o XML no está disponible | Reintenta en unos segundos |
| 405 | `metodo_no_permitido` | Método equivocado para esa dirección | Revisa la [referencia](https://www.sistemafacturacionperu.com/desarrolladores/referencia/) |
| 409 | `idempotencia_distinta` | Misma `Idempotency-Key` con otro cuerpo | Usa una clave nueva para cada operación distinta |
| 409 | `idempotencia_en_proceso` | La primera petición con esa clave aún corre | Reintenta en unos segundos con la misma clave |
| 409 | `duplicado` | Ya existe (un comprobante con esa serie y número, un cliente con ese documento…) | Consulta el que existe |
| 409 | `ya_anulado` | Ya está anulado o en proceso de anulación | Nada: consulta su estado |
| 409 | `no_reenviable` | No se puede reenviar a SUNAT (ya está aceptado, por ejemplo) | Consulta su estado |
| 413 | `cuerpo_muy_grande` | El cuerpo es demasiado grande | Envía menos datos por llamada |
| 422 | `validacion` | Faltan datos o tienen otro formato (detalle en `errors`) | Corrige los campos de `errors` |
| 429 | `demasiadas_solicitudes` | Más de 120 llamadas por minuto con la clave | Espera los segundos de `Retry-After` |
| 429 | `demasiadas_emisiones` | Más de 30 emisiones por minuto | Espera `Retry-After`; reparte las emisiones |

### Reglas del negocio (422)

| `code` | Causa | Qué hacer |
|---|---|---|
| `limite_plan` | El plan ya no permite emitir más este ciclo | La empresa sube de plan o espera el siguiente ciclo |
| `serie_invalida` | La serie no corresponde al tipo de comprobante o al local | Usa una de `GET /establecimientos` |
| `establecimiento_no_existe` | No hay un local con ese código | Revisa `GET /establecimientos` |
| `almacen_invalido` | El almacén no es del local | Usa uno de los almacenes del local |
| `producto_no_existe` | Con control de stock, el `codigo_interno` no existe | Créalo con `POST /productos` |
| `stock_insuficiente` | No alcanza el stock | Revisa `GET /stock` |
| `lote_no_disponible`, `lote_sin_stock` | El lote no existe o no tiene stock | Usa otro lote |
| `serie_no_disponible`, `series_cantidad` | Un número de serie no está disponible o no son tantos como la cantidad | Manda una serie por unidad |
| `regla_de_inventario` | Otra regla del inventario (el mensaje dice cuál) | Sigue el mensaje |
| `detraccion_minimo` | La detracción no aplica a ese monto | Quítala o activa «Detracción para montos menores» |
| `detraccion_con_retencion` | Detracción y retención del IGV juntas | Quita la retención |
| `detraccion_operacion` | Detracción con una operación que no es 1001-1004 | Usa `1001` (o `1004`) |
| `detraccion_codigo` | El código de detracción no existe o está desactivado | Actívalo en Ventas › Configuración › Detracciones |
| `anticipo_no_existe`, `anticipo_sin_saldo` | El anticipo no existe, no es de anticipo, está anulado o no tiene saldo | Revisa la serie-número y el saldo |
| `regimen_no_permite` | SUNAT no permite ese comprobante a tu régimen (por ejemplo, facturas en el Nuevo RUS) | Emite el comprobante que te corresponde |
| `ficha_ruc_pendiente` | Falta verificar la Ficha RUC de la empresa | Súbela en Configuración › Empresa › Régimen tributario |
| `deuda_vencida` | El cliente tiene deuda vencida y la empresa restringe la venta | Cobra la deuda o cambia la regla en la empresa |
| `nota_credito_excede` | La nota de crédito pasa lo que queda del comprobante | Baja el importe |
| `documento_afectado_no_existe` | El comprobante que la nota modifica no existe | Revisa `documento_afectado` |
| `origen_no_existe`, `origen_no_permitido`, `nota_venta_no_facturable` | El origen (cotización, pedido, nota de venta o guía) no existe o no se puede facturar | Revisa `origen` |
| `no_anulable`, `va_en_resumen` | No se puede anular o reenviar (las boletas van en el resumen diario) | Ver [Anular](https://www.sistemafacturacionperu.com/desarrolladores/guias/anulaciones/) |
| `no_cobrable`, `cobro_excede_saldo`, `cobro_invalido` | El cobro no corresponde o pasa el saldo | Revisa `GET /comprobantes/{id}/cobros` |
| `limite_webhooks` | Ya tienes 10 webhooks | Borra uno para crear otro |
| `certificado_faltante` | Falta el certificado digital | Súbelo en Configuración › Empresa › Certificado |
| `ubigeo_invalido` | El ubigeo no existe | Usa el código INEI de 6 dígitos |
| `sunat_rechazo` | SUNAT rechazó el comprobante (el mensaje trae su código) | Ver [errores de SUNAT](#errores-de-sunat) |
| `regla_de_negocio` | Otra regla (el mensaje dice qué hacer) | Sigue el mensaje |

### Servicios externos

| HTTP | `code` | Causa | Qué hacer |
|---|---|---|---|
| 500 | `error_interno` | Falla nuestra | Reintenta con la misma `Idempotency-Key`; si se repite, escríbenos con la hora |
| 502 | `envio_fallido` | El correo o el WhatsApp no salió | Revisa el destino o la línea de WhatsApp de la empresa |
| 502 | `sunat_no_responde` | SUNAT no respondió | Reintenta más tarde |
| 502 / 503 | `consulta_no_disponible`, `no_disponible` | El servicio de consultas (RUC, DNI, tipo de cambio) no respondió | Reintenta más tarde |

### Empresas de un socio

Además, la API v1 de una empresa dada de alta por un socio puede responder:

| HTTP | `code` | Causa |
|---|---|---|
| 402 | `saldo_agotado` | El saldo del socio es 0 y la empresa envía por nuestro PSE: no se creó nada |
| 402 | `cuota_pendiente` | El socio tiene una cuota mensual vencida |
| 423 | `suspendida_por_socio` | El socio pausó la emisión por API de esa empresa |
| 423 | `socio_suspendido` | La cuenta del socio está suspendida |

## API de socios

| HTTP | `code` | Causa |
|---|---|---|
| 400 | `json_invalido`, `idempotencia_invalida` | La petición está mal armada |
| 400 | `grant_no_soportado` | `POST /token` solo acepta `client_credentials` |
| 400 | `secreto_en_url` | Mandaste el secreto en la URL |
| 401 | `credenciales_invalidas` | El `client_id` o el `client_secret` no sirven (o la credencial se revocó) |
| 401 | `token_invalido`, `token_vencido`, `token_en_url` | El token no sirve, venció (dura 1 hora) o fue en la URL |
| 403 | `socio_suspendido` | Tu cuenta de socio está suspendida |
| 403 | `ip_no_permitida` | La credencial está limitada a otras IP |
| 404 | `no_encontrado` | No existe o no es tuya (nunca decimos si existe) |
| 409 | `ruc_ya_registrado` | Ese RUC ya tiene cuenta en el sistema (no decimos de quién) |
| 409 | `empresa_creandose` | El alta todavía corre (con `Retry-After`) |
| 409 | `empresa_con_error` | El alta falló: escríbenos con el `id` |
| 409 | `idempotencia_distinta`, `idempotencia_en_proceso` | Conflicto con la `Idempotency-Key` |
| 422 | `validacion` | Datos que corregir (detalle en `errors`) |
| 422 | `certificado_invalido` | El `.pfx` no abre con su clave |
| 422 | `regla_de_negocio` | Otra regla (el mensaje dice cuál) |
| 429 | `demasiadas_solicitudes`, `demasiados_intentos` | Espera `Retry-After` segundos |
| 500 | `error_interno` | Falla nuestra: reintenta |

La API antigua de reseller (`api/reseller/*`) responde 410 `api_retirada`: usa la API de socios.

## Conectar (OAuth 2.0)

`POST /oauth/token` y `POST /oauth/revoke` responden con el formato estándar de OAuth (RFC 6749 §5.2):
`{"error": "…", "error_description": "…"}`.

| HTTP | `error` | Causa |
|---|---|---|
| 400 | `invalid_request` | Falta un parámetro o mandaste las credenciales de dos formas |
| 400 | `invalid_grant` | El código o el token de renovación no sirve: vencido, ya usado, de otra aplicación, otra `redirect_uri` o PKCE que no corresponde |
| 400 | `invalid_scope` | Pediste al renovar un permiso que la empresa no concedió |
| 400 | `unsupported_grant_type` | Solo `authorization_code` y `refresh_token` |
| 401 | `invalid_client` | `client_id` o `client_secret` equivocados, o tu aplicación está suspendida |
| 429 | `temporarily_unavailable` | Demasiadas llamadas: espera `Retry-After` |

En la ventana de conexión, los errores vuelven a tu `redirect_uri` como `?error=invalid_request|invalid_scope|access_denied…`
(salvo si el `client_id` o la `redirect_uri` no están registrados: entonces se muestran en la pantalla y no redirigimos).

## Errores de SUNAT

Cuando SUNAT responde, su código queda en `sunat.codigo` del comprobante (y en el mensaje de `sunat_rechazo`). SUNAT
agrupa sus códigos así:

| Rango | Qué significa |
|---|---|
| `0` | Aceptado |
| `0100` a `1999` | Excepciones: SUNAT no procesó el envío (credenciales, archivo, servicio caído). Corrige y vuelve a enviar el **mismo** comprobante. |
| `2000` a `3999` | Rechazo: el comprobante no es válido. Corrige y emite **otro** (con otro número). |
| `4000` en adelante | Observaciones: el comprobante es válido (`observado`), pero corrige el dato para los siguientes. |

Los que más aparecen, en palabras simples:

| Código | SUNAT dice | Qué significa y qué hacer |
|---|---|---|
| `0102`, `0103`, `0104` | Usuario o contraseña incorrectos / el usuario no existe / la clave es incorrecta | El usuario secundario SOL o su clave están mal. Revísalos en Configuración › Empresa › Datos y facturación SUNAT. |
| `0105` | El usuario no está activo | Activa el usuario secundario en SUNAT Operaciones en Línea. |
| `0111` | No tiene el perfil para enviar comprobantes electrónicos | Al usuario secundario le falta el perfil de emisión electrónica: dáselo en SUNAT Operaciones en Línea. |
| `0112` | El usuario debe ser secundario | Usa un usuario secundario, no el principal. |
| `0109`, `0130` | El sistema no puede responder su solicitud | SUNAT está caído o lento. Reintenta más tarde (`POST /comprobantes/{id}/reenviar-sunat` en facturas). |
| `0127` | El ticket no existe | El ticket de una guía, baja o resumen no está en SUNAT. Consulta otra vez en unos minutos. |
| `1032` | El comprobante ya está informado y se encuentra anulado o rechazado | Ese número ya no sirve: emite uno nuevo. |
| `1033` | El comprobante fue registrado previamente con otros datos | Ese número ya está en SUNAT con otros datos: consulta su CDR o emite con el siguiente número. |
| `2010`, `2011` | El contribuyente no está activo / no está habido | El RUC del emisor tiene problemas en SUNAT. Revisa la Ficha RUC. |
| `2017` | El número de documento de identidad del receptor debe ser RUC | Una factura va a un cliente con RUC. Para un DNI, emite una boleta. |
| `2108` | Presentación fuera de fecha | Se envió fuera del plazo de SUNAT. |
| `2329` | La fecha de emisión se encuentra fuera del límite permitido | La fecha es muy antigua o futura: emite con la fecha de hoy. |
| `2335` | El documento electrónico ingresado ha sido alterado | La firma no coincide (el certificado o el XML cambió). Vuelve a emitir. |
| `2640` | Operación gratuita, solo debe consignar un monto referencial | La línea gratuita tiene precio cobrado: ver [gratuitas](https://www.sistemafacturacionperu.com/desarrolladores/guias/casos-especiales/). |
| `2800`, `2801`, `2802` | El tipo o el número de documento del receptor no es válido | Revisa `codigo_tipo_documento_identidad` y el número (un DNI tiene 8 dígitos). |
| `3249` | Si la venta es al crédito, debe existir al menos una cuota | Agrega las `cuotas` en una venta a crédito. |
| `4001` | El número de RUC del receptor no existe | Observación: el comprobante vale, pero revisa el RUC del cliente con `GET /consultas/ruc/{ruc}`. |
| `4287` | El precio unitario difiere de los cálculos | Observación: revisa `valor_unitario`, `precio_unitario` y el IGV de la línea. |
| `4332` | El código de producto SUNAT no es válido | Observación: revisa `codigo_producto_sunat` del producto. |

Un comprobante `observado` es **válido**: no lo anules por una observación.

---

# Consultas de RUC, DNI y tipo de cambio

URL: https://www.sistemafacturacionperu.com/desarrolladores/consultas/

Consulta por API los datos de un RUC en SUNAT, un DNI en RENIEC y el tipo de cambio de SUNAT del día, con el mismo servicio que usan las pantallas del sistema.

Tres consultas para completar formularios y validar antes de emitir, con el mismo servicio que usan las pantallas del
sistema. Todas piden el alcance `consultas` y vienen también con Conectar en el Plan Básico.

| Consulta | Endpoint |
|---|---|
| RUC (SUNAT) | `GET /consultas/ruc/{ruc}` |
| DNI (RENIEC) | `GET /consultas/dni/{dni}` |
| Tipo de cambio (SUNAT) | `GET /consultas/tipo-cambio?fecha=AAAA-MM-DD` |

## RUC

El RUC tiene 11 dígitos y empieza con 10, 15, 16, 17 o 20.

```bash
curl https://pruebas.sistemafacturacionperu.com/api/v1/consultas/ruc/20601234567 \
  -H "Authorization: Bearer $SFP_API_KEY"
```

```php
<?php
$ch = curl_init('https://pruebas.sistemafacturacionperu.com/api/v1/consultas/ruc/20601234567');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('SFP_API_KEY')],
]);
$ruc = json_decode(curl_exec($ch), true)['data'];
```

```js
const res = await fetch('https://pruebas.sistemafacturacionperu.com/api/v1/consultas/ruc/20601234567', {
  headers: { Authorization: `Bearer ${process.env.SFP_API_KEY}` },
});
const { data: ruc } = await res.json();
```

```python
r = requests.get(
    "https://pruebas.sistemafacturacionperu.com/api/v1/consultas/ruc/20601234567",
    headers={"Authorization": f"Bearer {os.environ['SFP_API_KEY']}"},
    timeout=30,
)
ruc = r.json()["data"]
```

```json
{
  "success": true,
  "data": {
    "ruc": "20601234567",
    "razon_social": "BODEGA LIMA S.A.C.",
    "nombre_comercial": null,
    "direccion": "AV. LIMA 1",
    "ubigeo": "150101",
    "estado": "ACTIVO",
    "condicion": "HABIDO",
    "agente_de_retencion": false
  }
}
```

Úsalo para:

- completar la razón social y la dirección de la factura sin que tu usuario las escriba;
- avisar si el cliente **no está activo o no está habido** antes de facturarle;
- saber si el cliente es **agente de retención** (te retendrá parte del IGV al pagarte).

## DNI

```bash
curl https://pruebas.sistemafacturacionperu.com/api/v1/consultas/dni/70123456 \
  -H "Authorization: Bearer $SFP_API_KEY"
```

```php
<?php
$ch = curl_init('https://pruebas.sistemafacturacionperu.com/api/v1/consultas/dni/70123456');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('SFP_API_KEY')],
]);
$dni = json_decode(curl_exec($ch), true)['data'];
```

```js
const res = await fetch('https://pruebas.sistemafacturacionperu.com/api/v1/consultas/dni/70123456', {
  headers: { Authorization: `Bearer ${process.env.SFP_API_KEY}` },
});
const { data: dni } = await res.json();
```

```python
r = requests.get(
    "https://pruebas.sistemafacturacionperu.com/api/v1/consultas/dni/70123456",
    headers={"Authorization": f"Bearer {os.environ['SFP_API_KEY']}"},
    timeout=30,
)
dni = r.json()["data"]
```

```json
{
  "success": true,
  "data": {
    "dni": "70123456",
    "nombre": "PEREZ GOMEZ ANA",
    "nombres": "ANA",
    "apellido_paterno": "PEREZ",
    "apellido_materno": "GOMEZ",
    "direccion": null,
    "ubigeo": null
  }
}
```

## Tipo de cambio

Sin `fecha`, el de hoy. Úsalo para el `factor_tipo_de_cambio` de un comprobante en dólares.

```bash
curl "https://pruebas.sistemafacturacionperu.com/api/v1/consultas/tipo-cambio?fecha=2026-11-04" \
  -H "Authorization: Bearer $SFP_API_KEY"
```

```php
<?php
$ch = curl_init('https://pruebas.sistemafacturacionperu.com/api/v1/consultas/tipo-cambio?fecha=2026-11-04');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('SFP_API_KEY')],
]);
$cambio = json_decode(curl_exec($ch), true)['data'];   // ['fecha' => …, 'compra' => …, 'venta' => …]
```

```js
const res = await fetch('https://pruebas.sistemafacturacionperu.com/api/v1/consultas/tipo-cambio?fecha=2026-11-04', {
  headers: { Authorization: `Bearer ${process.env.SFP_API_KEY}` },
});
const { data: cambio } = await res.json(); // { fecha, compra, venta }
```

```python
r = requests.get(
    "https://pruebas.sistemafacturacionperu.com/api/v1/consultas/tipo-cambio",
    params={"fecha": "2026-11-04"},
    headers={"Authorization": f"Bearer {os.environ['SFP_API_KEY']}"},
    timeout=30,
)
cambio = r.json()["data"]
```

```json
{ "success": true, "data": { "fecha": "2026-11-04", "compra": 3.712, "venta": 3.741 } }
```

## Errores

| HTTP | `code` | Qué pasó |
|---|---|---|
| 404 | `no_encontrado` | El RUC o el DNI no existe |
| 422 | `validacion` | El número no tiene el formato (11 dígitos el RUC, 8 el DNI) |
| 502 / 503 | `consulta_no_disponible`, `no_disponible` | El servicio de consultas no respondió: reintenta más tarde |

Las consultas cuentan para el límite de 120 llamadas por minuto de tu clave. Si consultas mucho el mismo RUC, guarda
el resultado unas horas en tu sistema.

---

# Límites, idempotencia, paginación y versiones

URL: https://www.sistemafacturacionperu.com/desarrolladores/limites-y-versiones/

Cuántas llamadas por minuto acepta la API, cómo reintentar sin emitir dos veces con Idempotency-Key, cómo paginar los listados y cómo cuidamos la compatibilidad.

## Límites de uso

| API | Límite |
|---|---|
| API v1 | 120 llamadas por minuto por clave y 30 emisiones por minuto (los `POST` que crean documentos) |
| API de socios | 120 llamadas por minuto por token; 10 pedidos de token por minuto por IP y por `client_id` |
| Conectar (`/oauth/token`, `/oauth/revoke`) | 30 llamadas por minuto por IP y 120 por `client_id` |

Cada respuesta trae `X-RateLimit-Limit` y `X-RateLimit-Remaining`. Al pasarte responde **429** con `Retry-After` (en
segundos): `demasiadas_solicitudes` o `demasiadas_emisiones` en la v1.

- Si emites en lote (por ejemplo, el cierre del día), reparte las emisiones: 30 por minuto es una cada dos segundos.
- Respeta `Retry-After` y reintenta con la **misma** `Idempotency-Key`.
- Las consultas (RUC, DNI) también cuentan: guarda sus resultados un rato en tu sistema.

## No emitir dos veces: Idempotency-Key

La red falla. Si tu sistema manda una factura, se corta la conexión y no sabes si llegó, reintentar a ciegas puede
emitirla dos veces. Para eso está la cabecera `Idempotency-Key`: manda en **cada `POST` y `PUT`** (y `PATCH` en la API
de socios) un valor único por operación, por ejemplo un UUID.

```http
POST /api/v1/comprobantes HTTP/1.1
Authorization: Bearer sfp_live_…
Content-Type: application/json
Idempotency-Key: 3f1c2a1e-0b7d-4c55-9f3e-8a0c6d2b9e11
```

| Si reintentas… | Respuesta |
|---|---|
| Con la misma clave y el **mismo cuerpo** | La misma respuesta de la primera vez, con la cabecera `Idempotent-Replayed: true`. **No se emite dos veces.** |
| Con la misma clave y **otro cuerpo** | 409 `idempotencia_distinta` |
| Mientras la primera todavía corre | 409 `idempotencia_en_proceso`: reintenta en unos segundos |
| Después de un error nuestro (5xx) | La clave queda libre: puedes reintentar con la misma |

- La clave se recuerda **24 horas**.
- Hasta 255 caracteres visibles. Un UUID nuevo por comprobante es lo más simple; también sirve algo tuyo y único, como
  `venta-<id de tu venta>`.
- **Guárdala junto a tu venta** antes de llamar: así, si tu sistema se cae en medio, al volver reintenta con la misma.

```php
<?php
// Reintento seguro: la misma Idempotency-Key en cada intento.
function emitir(array $comprobante, string $idempotencia): array
{
    for ($intento = 1; $intento <= 4; $intento++) {
        $ch = curl_init('https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes');
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_POST => true,
            CURLOPT_TIMEOUT => 90,
            CURLOPT_HTTPHEADER => [
                'Authorization: Bearer ' . getenv('SFP_API_KEY'),
                'Content-Type: application/json',
                'Idempotency-Key: ' . $idempotencia,
            ],
            CURLOPT_POSTFIELDS => json_encode($comprobante),
        ]);
        $cuerpo = curl_exec($ch);
        $estado = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
        $json = $cuerpo !== false ? json_decode($cuerpo, true) : null;
        $enProceso = $estado === 409 && ($json['code'] ?? '') === 'idempotencia_en_proceso';
        if ($json !== null && $estado < 500 && $estado !== 429 && !$enProceso) {
            return $json;                        // 201, o un error que hay que corregir (4xx)
        }
        sleep(min(2 ** $intento, 30));          // red caída, 5xx, 429 o «en proceso»: espera y reintenta
    }
    throw new RuntimeException('No se pudo emitir: reintenta más tarde con la misma Idempotency-Key.');
}
```

```js
// Reintento seguro: la misma Idempotency-Key en cada intento.
async function emitir(comprobante, idempotencia) {
  for (let intento = 1; intento <= 4; intento++) {
    try {
      const res = await fetch('https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes', {
        method: 'POST',
        headers: {
          Authorization: `Bearer ${process.env.SFP_API_KEY}`,
          'Content-Type': 'application/json',
          'Idempotency-Key': idempotencia,
        },
        body: JSON.stringify(comprobante),
        signal: AbortSignal.timeout(90_000),
      });
      const json = await res.json().catch(() => null);
      const enProceso = res.status === 409 && json?.code === 'idempotencia_en_proceso';
      if (json && res.status < 500 && res.status !== 429 && !enProceso) return json; // 201, o un 4xx que hay que corregir
      const espera = Number(res.headers.get('Retry-After')) || 2 ** intento;
      await new Promise((r) => setTimeout(r, Math.min(espera, 30) * 1000));
    } catch {
      await new Promise((r) => setTimeout(r, Math.min(2 ** intento, 30) * 1000)); // red caída
    }
  }
  throw new Error('No se pudo emitir: reintenta más tarde con la misma Idempotency-Key.');
}
```

```python
import os, time, requests

def emitir(comprobante: dict, idempotencia: str) -> dict:
    """Reintento seguro: la misma Idempotency-Key en cada intento."""
    for intento in range(1, 5):
        try:
            r = requests.post(
                "https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes",
                json=comprobante,
                headers={"Authorization": f"Bearer {os.environ['SFP_API_KEY']}", "Idempotency-Key": idempotencia},
                timeout=90,
            )
            en_proceso = r.status_code == 409 and r.json().get("code") == "idempotencia_en_proceso"
            if r.status_code < 500 and r.status_code != 429 and not en_proceso:
                return r.json()  # 201, o un 4xx que hay que corregir
            espera = int(r.headers.get("Retry-After", 2 ** intento))
        except requests.RequestException:
            espera = 2 ** intento  # red caída
        time.sleep(min(espera, 30))
    raise RuntimeError("No se pudo emitir: reintenta más tarde con la misma Idempotency-Key.")
```

> Un 409 `idempotencia_distinta` no se arregla reintentando: significa que usaste la misma clave para dos comprobantes
> distintos. Usa una nueva.

## Paginación

Los listados (`GET /comprobantes`, `/guias`, `/clientes`, `/productos`, `/stock`, `/webhooks/{id}/entregas` y los de
socios) aceptan `page` y `per_page` (20 por defecto, hasta 100) y devuelven `meta`:

```json
{
  "success": true,
  "data": [{ "id": 1520, "numero_completo": "B001-845" }],
  "meta": { "page": 1, "per_page": 100, "total": 347, "last_page": 4 }
}
```

Recorre las páginas hasta `last_page`. Para sincronizar, filtra por fechas (`desde`, `hasta`) en vez de bajar todo.

```bash
curl "https://pruebas.sistemafacturacionperu.com/api/v1/comprobantes?desde=2026-11-01&hasta=2026-11-04&estado=aceptado&per_page=100&page=2" \
  -H "Authorization: Bearer $SFP_API_KEY"
```

Un usuario que no ve toda la empresa (por ejemplo, un vendedor) ve solo sus comprobantes, como en la web.

## Versiones y compatibilidad

- La versión va en la ruta: `/api/v1`. Dentro de la v1 **solo agregamos**: campos nuevos en las respuestas, endpoints
  nuevos, eventos nuevos y códigos de error nuevos. Tu integración debe ignorar los campos que no conoce.
- Un cambio que rompa lo existente iría en una versión nueva (`/api/v2`), con aviso y tiempo para migrar.
- Los `code` de error son estables: no cambian de significado.
- Cada cambio queda en las [novedades](https://www.sistemafacturacionperu.com/desarrolladores/novedades/).

### La API antigua

`/api/documents`, `/api/dispatches` y las demás rutas de antes siguen funcionando igual para quien ya las usa. No las
documentamos ni les agregamos funciones: todo lo nuevo está en la v1. Dentro de unos meses avisaremos de su retiro a
quien siga usándolas (lo sabemos por el registro de llamadas).

---

# API de socios

URL: https://www.sistemafacturacionperu.com/desarrolladores/socios/

Para programadores y empresas de software con muchos clientes: da de alta empresas, emite con su API v1 y paga con bolsas prepago de comprobantes desde S/ 0,048.

Si tienes un sistema con muchos clientes propios (un ERP, un POS, una app de reservas), la API de socios te deja
**darlos de alta como empresas** de Sistema Facturación Perú y emitir sus comprobantes con la API v1 de cada una. Tus
clientes no tienen que contratar nada: tú pagas por lo que emiten, con bolsas prepago.

1. Das de alta a tu cliente con `POST /empresas` (RUC, razón social, administrador y, si quieres, certificado y
   usuario SOL).
2. Creas una clave v1 para esa empresa con `POST /empresas/{id}/claves`.
3. Emites con esa clave en `https://<subdominio>.sistemafacturacionperu.com/api/v1`, igual que en la
   [API v1](https://www.sistemafacturacionperu.com/desarrolladores/inicio-rapido/).

- Base: `https://api.sistemafacturacionperu.com/socios/v1` (siempre este host, nunca el subdominio de una empresa).
- Formato: el mismo de la API v1 (`{"success": true, "data": …}` o `{"success": false, "code": …, "message": …}`).

## Precios

Pagas por adelantado con **bolsas de comprobantes**, para todas tus empresas juntas. Precios con IGV incluido:

| Bolsa | Precio | Por comprobante | Validez |
|---|---|---|---|
| 3.300 comprobantes | **S/ 180** | S/ 0,055 | 6 meses |
| 5.500 comprobantes | **S/ 285** | S/ 0,052 | 6 meses |
| 10.000 comprobantes | **S/ 480** | S/ 0,048 | 6 meses |

Más una **cuota de S/ 9 al mes con IGV por cada empresa activa**: la que emitió al menos un comprobante en el mes, por
cualquier vía. Cubre lo que no es el envío a SUNAT: la base de datos de cada empresa, guardar sus XML, PDF y constancias
los años que pide SUNAT, el servidor y el soporte.

- Cada bolsa vale **6 meses** desde la compra. Si emites más, compras varias: no hay bolsas más grandes.
- Se consume primero la bolsa que **vence antes**.
- **La compra de bolsas se coordina con nosotros** (transferencia o Yape) y la registramos en el momento. Por ahora no
  hay pago en línea de bolsas.

### Qué descuenta de la bolsa

Descuenta **1** todo lo que sale por **nuestro PSE**:

- cada factura, boleta, nota de crédito, nota de débito, retención, percepción y liquidación de compra;
- cada resumen diario de boletas;
- cada baja (comunicación de baja o resumen de anulación);
- cada guía de remisión.

Se descuenta **una sola vez por documento**, aunque se reintente el envío. En el entorno de pruebas de SUNAT no se
descuenta nada.

**Si la empresa envía directo a SUNAT con su propio usuario SOL** (mandaste `certificado` y `sol` en el alta), **no
descuenta nada de tu bolsa**: esa empresa solo paga la cuota de S/ 9 los meses en que emite.

### Sin saldo

- Antes de crear un comprobante o una guía de una empresa que envía por nuestro PSE, si tu saldo es 0, su API v1
  responde **402 `saldo_agotado`** y no se crea nada (tampoco desde la web de esa empresa). Lo ya emitido no se toca.
- Los **resúmenes y las bajas** de lo ya emitido **sí se envían** sin saldo (dejar boletas sin informar sería peor):
  se descuentan igual y el negativo sale de tu siguiente recarga.
- Te avisamos al usar el **80 %** y el **95 %** de tus bolsas vigentes (`saldo.bajo`) y al llegar a 0
  (`saldo.agotado`), por webhook y por correo.
- La cuota mensual se calcula el día 1 y vence a los 10 días. Vencida e impaga, tus empresas no emiten por API
  (**402 `cuota_pendiente`**); su web sigue funcionando. Al pagarla, vuelven al instante.

`GET /saldo` te da el saldo, tus bolsas, el próximo vencimiento, las cuotas pendientes y los precios; `GET /movimientos`
los consumos y las recargas, filtrables por `tipo`, `empresa_id`, `desde` y `hasta`.

## 1. Pide un token

Te damos una credencial: `client_id` (`sfp_partner_…`) y `client_secret` (`sfp_secret_…`, se muestra una vez). El token
dura 1 hora: pide otro cuando venza (401 `token_vencido`).

```bash
curl -s https://api.sistemafacturacionperu.com/socios/v1/token \
  -u "$SFP_CLIENT_ID:$SFP_CLIENT_SECRET" \
  -d grant_type=client_credentials
```

```php
<?php
$ch = curl_init('https://api.sistemafacturacionperu.com/socios/v1/token');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERPWD => getenv('SFP_CLIENT_ID') . ':' . getenv('SFP_CLIENT_SECRET'),
    CURLOPT_POSTFIELDS => http_build_query(['grant_type' => 'client_credentials']),
]);
$token = json_decode(curl_exec($ch), true)['access_token'];
```

```js
const basic = Buffer.from(`${process.env.SFP_CLIENT_ID}:${process.env.SFP_CLIENT_SECRET}`).toString('base64');
const res = await fetch('https://api.sistemafacturacionperu.com/socios/v1/token', {
  method: 'POST',
  headers: { Authorization: `Basic ${basic}`, 'Content-Type': 'application/x-www-form-urlencoded' },
  body: new URLSearchParams({ grant_type: 'client_credentials' }),
});
const { access_token: token } = await res.json();
```

```python
r = requests.post(
    "https://api.sistemafacturacionperu.com/socios/v1/token",
    auth=(os.environ["SFP_CLIENT_ID"], os.environ["SFP_CLIENT_SECRET"]),
    data={"grant_type": "client_credentials"},
    timeout=30,
)
token = r.json()["access_token"]
```

```json
{ "success": true, "access_token": "sfp_pat_Q1w2…", "token_type": "Bearer", "expires_in": 3600, "expires_at": "2026-11-04T15:04:05-05:00" }
```

## 2. Da de alta a tu cliente

```bash
curl -s https://api.sistemafacturacionperu.com/socios/v1/empresas \
  -H "Authorization: Bearer $SFP_PARTNER_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: alta-20601030013" \
  -d '{
    "ruc": "20601030013",
    "razon_social": "FERRETERIA EL TORNILLO S.A.C.",
    "nombre_comercial": "El Tornillo",
    "direccion": { "direccion": "Av. Grau 123, Lima", "ubigeo": "150101" },
    "administrador": { "nombre": "Ana Quispe", "correo": "ana@tornillo.pe", "celular": "987654321" },
    "certificado": { "pfx_base64": "MIIK…", "clave": "clave-del-pfx" },
    "sol": { "usuario": "FACTURAS1", "clave": "clave-sol" }
  }'
```

Responde **201 al instante** con `"estado": "creando"`; la empresa queda lista en 1 a 3 minutos (es la misma alta de la
compra en la web). Consulta `GET /empresas/{id}` o espera el webhook `empresa.lista`.

- Sin `administrador.contrasena`, el administrador recibe el correo de bienvenida para crear la suya.
- Sin `subdominio`, lo armamos del nombre (`el-tornillo`).
- Con `certificado` y `sol`, la empresa envía directo a SUNAT con su SOL (no descuenta de tu bolsa). Sin ellos, o con
  `"envio": "pse"`, envía por nuestro PSE, que activamos nosotros.
- Usa una `Idempotency-Key` como `alta-<ruc>`: si la red falla, el reintento no crea la empresa dos veces.
- Si el RUC ya tiene cuenta, responde 409 `ruc_ya_registrado` (sin decir de quién). Si es tu cliente, pídele que nos
  escriba para pasarla a tu cuenta de socio.

### El estado de la empresa

| `estado` | Qué significa |
|---|---|
| `creando` | El alta corre (1 a 3 minutos) |
| `por_verificar` | Ya existe, pero aún no emite: mira `pendientes` |
| `lista` | Ya emite. Te avisamos con `empresa.lista` |
| `suspendida` | La pausaste tú (`suspension.por = socio`) o la bloqueó la plataforma (`agencia`) |
| `error` | El alta falló: escríbenos con el `id` |

`pendientes` dice qué falta: `ficha_ruc` (como toda empresa nueva, emite cuando su Ficha RUC queda verificada: el
administrador la sube en Configuración › Empresa › Régimen tributario), `produccion`, `certificado`, `usuario_sol` o
`credenciales_pse` (lo activamos nosotros).

## 3. Crea su clave v1 y emite

```bash
curl -s https://api.sistemafacturacionperu.com/socios/v1/empresas/15/claves \
  -H "Authorization: Bearer $SFP_PARTNER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"nombre": "Mi sistema · producción", "establecimiento": "0000"}'
```

```json
{
  "success": true,
  "data": {
    "id": 3,
    "nombre": "Mi sistema · producción",
    "permisos": ["comprobantes.emitir", "comprobantes.leer", "comprobantes.anular", "guias.emitir", "guias.leer", "catalogo.leer", "catalogo.escribir", "consultas", "webhooks.gestionar"],
    "clave": "sfp_live_Ab12…",
    "api_v1": "https://el-tornillo.sistemafacturacionperu.com/api/v1",
    "aviso": "Guarda la clave ahora…"
  }
}
```

La clave se muestra **una vez**. Sin `permisos`, trae los de emitir y consultar. Con ella emites en `api_v1` todo lo de
la [API v1](https://www.sistemafacturacionperu.com/desarrolladores/guias/): comprobantes, guías, notas, anulaciones, consultas y webhooks de esa empresa.

## Más operaciones

| Operación | Endpoint |
|---|---|
| Listar tus empresas (filtra por `estado` y `ruc`) | `GET /empresas` |
| Ver una empresa (vuelve a leer su estado) | `GET /empresas/{id}` |
| Cambiar contacto, nombre comercial, dirección, certificado, usuario SOL o forma de envío | `PATCH /empresas/{id}` |
| Comprobantes del mes por tipo y lo que descontó de tu bolsa | `GET /empresas/{id}/uso?mes=2026-11` |
| Pausar la emisión por API (por ejemplo, tu cliente no te pagó) | `POST /empresas/{id}/suspender` |
| Volver a permitirla | `POST /empresas/{id}/reactivar` |
| Listar y revocar claves | `GET /empresas/{id}/claves`, `DELETE /empresas/{id}/claves/{keyId}` |
| Saldo y movimientos | `GET /saldo`, `GET /movimientos` |
| Webhooks del socio | `GET`/`POST /webhooks`, `DELETE /webhooks/{id}`, `GET /webhooks/{id}/entregas` |

Mientras una empresa está pausada, su API v1 responde 423 `suspendida_por_socio` al emitir; consultar sigue
funcionando y su web no cambia.

**Lo que un socio no puede:** ver empresas que no son suyas (responden 404), bloquearlas por cobranza, cambiar su plan,
entrar como su administrador ni usar el acceso de soporte. Eso es solo de la plataforma.

La empresa de un socio tiene **emitir y consultar**, no el ERP completo. Si tu cliente quiere el sistema completo (POS,
inventario, compras, tienda), se pasa a un plan normal.

## Webhooks del socio

```bash
curl -s https://api.sistemafacturacionperu.com/socios/v1/webhooks \
  -H "Authorization: Bearer $SFP_PARTNER_TOKEN" -H "Content-Type: application/json" \
  -d '{"url": "https://tusistema.pe/webhooks/sfp", "eventos": ["empresa.lista", "saldo.bajo", "saldo.agotado", "cuota.vencida"]}'
```

| Evento | Cuándo |
|---|---|
| `empresa.lista` | Una empresa ya puede emitir |
| `empresa.suspendida` / `empresa.reactivada` | La pausaste (o la bloqueamos) / volvió |
| `empresa.error` | El alta falló |
| `saldo.bajo` | Usaste el 80 % o el 95 % de lo vigente (`data.umbral`) |
| `saldo.agotado` | El saldo llegó a 0 |
| `cuota.pendiente`, `cuota.por_vencer`, `cuota.vencida` | El cargo mensual |

Se firman y se reintentan igual que los [webhooks de la API v1](https://www.sistemafacturacionperu.com/desarrolladores/webhooks/), y el cuerpo trae además
`socio_id`.

## Seguridad y límites

- El secreto y los tokens se guardan solo como hash. Para rotar sin corte te damos una segunda credencial, la cambias y
  revocamos la vieja. Una credencial puede limitarse a tus IP (403 `ip_no_permitida` desde otra).
- 120 llamadas por minuto por token y 10 intentos de token por minuto por IP y por `client_id`.
- `Idempotency-Key` en todo `POST` y `PATCH`; se recuerda 24 horas.

¿Tus clientes **ya tienen** cuenta en Sistema Facturación Perú? Entonces no los des de alta: conéctalos con un botón,
con [Conectar con Sistema Facturación Perú](https://www.sistemafacturacionperu.com/desarrolladores/conectar/). Seguramente necesites las dos.

---

# Conectar con Sistema Facturación Perú

URL: https://www.sistemafacturacionperu.com/desarrolladores/conectar/

Pon un botón en tu sistema para que tus clientes conecten su cuenta de Sistema Facturación Perú sin copiar claves: OAuth 2.0 con PKCE, ventana emergente y tokens.

Si tu sistema (ERP, tienda, app) tiene clientes que **ya usan** Sistema Facturación Perú, ponles un botón «Conectar con
Sistema Facturación Perú». El cliente escribe su RUC, entra con su usuario de siempre y pulsa «Permitir»: tú recibes
un token para emitir con su cuenta, sin pedirle claves de API y sin que su contraseña pase por tu sistema.

- Solo **conecta una cuenta que ya existe**: nunca crea empresas ni usuarios. Para dar de alta empresas está la
  [API de socios](https://www.sistemafacturacionperu.com/desarrolladores/socios/).
- Es gratis para tu sistema. La empresa paga su plan de siempre.
- Es OAuth 2.0 con *authorization code* y **PKCE S256 obligatorio** (RFC 6749, 7636, 7009 y 9207).

1. **Tu servidor** genera `state` y `code_verifier`, los guarda en la sesión del usuario y arma la URL de `/conectar`.

2. **Tu botón** abre esa URL en una ventana emergente, con nuestra dirección visible.

3. **El usuario** escribe el RUC de su empresa, entra con su correo y contraseña en el subdominio de su empresa (con su segundo factor, si lo tiene) y pulsa «Permitir».

4. **Volvemos** a tu `redirect_uri` con `code`, `state` e `iss`.

5. **Tu servidor** comprueba el `state` y canjea el código en `POST /oauth/token`.

6. **Emites** en la API v1 de esa empresa con el token de acceso, y lo renuevas cada hora.

## 1. Registra tu aplicación

Escríbenos con el nombre y el logo de tu sistema, tu web, un correo de soporte, tus **direcciones de retorno**
(`redirect_uri` exactas: solo `https://`, o `http://localhost` y `http://127.0.0.1` para desarrollar) y los permisos que
vas a pedir. Te damos:

- `client_id` (`sfp_app_…`), que es público;
- `client_secret` (`sfp_secret_…`), que se muestra **una sola vez**: guárdalo en tu servidor, nunca en el navegador;
- si nos das una URL de webhook, su secreto `whsec_…` para verificar el aviso `conexion.revocada`.

Sin ese registro no hay botón: así nadie se hace pasar por tu aplicación.

## 2. El botón y la ventana emergente

No metas nuestro inicio de sesión dentro de un `<iframe>`: el navegador bloquea las cookies, tu usuario no puede ver que
escribe su contraseña en nuestro sitio y nuestras pantallas responden `X-Frame-Options: DENY`. Abre una **ventana
emergente** (o redirige la página).

```html
<button id="sfp-conectar" type="button">Conectar con Sistema Facturación Perú</button>
<script>
// 1. Tu servidor genera state y code_verifier, los guarda en la sesión y devuelve la URL:
//    GET /sfp/conectar-url → { "url": "https://api.sistemafacturacionperu.com/conectar?..." }
document.getElementById('sfp-conectar').addEventListener('click', async () => {
  const { url } = await (await fetch('/sfp/conectar-url', { credentials: 'same-origin' })).json();
  const w = 520, h = 680;
  const popup = window.open(url, 'sfp-conectar',
    `width=${w},height=${h},left=${(screen.width - w) / 2},top=${(screen.height - h) / 2}`);
  if (!popup) { window.location.href = url; return; }   // Si bloquean la ventana, redirige.

  // 3. Tu página de vuelta (redirect_uri) termina el canje en tu servidor y avisa con postMessage.
  window.addEventListener('message', (e) => {
    if (e.origin !== window.location.origin || e.data?.tipo !== 'sfp-conectado') return;
    popup.close();
    location.reload();   // Ya está conectado: muestra «Conectado · RUC …».
  });
});
</script>

<!-- En tu redirect_uri (https://tusistema.com/sfp/vuelta), después de canjear el código en el servidor: -->
<script>
  if (window.opener) { window.opener.postMessage({ tipo: 'sfp-conectado' }, window.location.origin); window.close(); }
  else { window.location.href = '/configuracion/facturacion'; }
</script>
```

La URL de la ventana:

```text
https://api.sistemafacturacionperu.com/conectar
  ?response_type=code
  &client_id=sfp_app_…
  &redirect_uri=https%3A%2F%2Ftusistema.com%2Fsfp%2Fvuelta
  &state=<al azar, guardado en la sesión>
  &code_challenge=<BASE64URL(SHA256(code_verifier))>
  &code_challenge_method=S256
  &scope=comprobantes.emitir%20comprobantes.leer%20consultas
```

Así generas el `code_verifier`, el `code_challenge` y el `state`:

```js
import { randomBytes, createHash } from 'node:crypto';

const b64url = (buf) => buf.toString('base64').replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
const codeVerifier = b64url(randomBytes(48)); // 64 caracteres
const codeChallenge = b64url(createHash('sha256').update(codeVerifier).digest());
const state = b64url(randomBytes(24));
// Guarda codeVerifier y state en la sesión del usuario.
```

```php
<?php
$b64url = fn (string $bin) => rtrim(strtr(base64_encode($bin), '+/', '-_'), '=');
$codeVerifier = $b64url(random_bytes(48));
$codeChallenge = $b64url(hash('sha256', $codeVerifier, true));
$state = $b64url(random_bytes(24));
$_SESSION['sfp'] = ['verifier' => $codeVerifier, 'state' => $state];

$url = 'https://api.sistemafacturacionperu.com/conectar?' . http_build_query([
    'response_type' => 'code',
    'client_id' => getenv('SFP_APP_CLIENT_ID'),
    'redirect_uri' => 'https://tusistema.com/sfp/vuelta',
    'state' => $state,
    'code_challenge' => $codeChallenge,
    'code_challenge_method' => 'S256',
    'scope' => 'comprobantes.emitir comprobantes.leer consultas',
], '', '&', PHP_QUERY_RFC3986);
```

```python
import base64, hashlib, secrets
from urllib.parse import urlencode

b64url = lambda b: base64.urlsafe_b64encode(b).rstrip(b"=").decode()
code_verifier = b64url(secrets.token_bytes(48))
code_challenge = b64url(hashlib.sha256(code_verifier.encode()).digest())
state = b64url(secrets.token_bytes(24))
# Guarda code_verifier y state en la sesión del usuario.

url = "https://api.sistemafacturacionperu.com/conectar?" + urlencode({
    "response_type": "code",
    "client_id": os.environ["SFP_APP_CLIENT_ID"],
    "redirect_uri": "https://tusistema.com/sfp/vuelta",
    "state": state,
    "code_challenge": code_challenge,
    "code_challenge_method": "S256",
    "scope": "comprobantes.emitir comprobantes.leer consultas",
})
```

- Si el `client_id` o la `redirect_uri` no están registrados, mostramos el error en la pantalla y **nunca** redirigimos.
- Con la dirección ya válida, los errores vuelven a tu `redirect_uri`: `?error=invalid_request|invalid_scope|access_denied…&error_description=…&state=…&iss=https://api.sistemafacturacionperu.com`.
- Si todo va bien: `?code=sfp_oac_…&state=…&iss=https://api.sistemafacturacionperu.com`. **Comprueba que `state` es
  el tuyo** antes de canjear.

## 3. Canjea el código (desde tu servidor)

El código vale **5 minutos y un solo uso**: si se canjea dos veces, revocamos todo lo emitido con él.

```bash
curl -s https://api.sistemafacturacionperu.com/oauth/token \
  -u "$SFP_APP_CLIENT_ID:$SFP_APP_CLIENT_SECRET" \
  -d grant_type=authorization_code \
  -d code=sfp_oac_… \
  -d redirect_uri=https://tusistema.com/sfp/vuelta \
  -d code_verifier=EL_QUE_GUARDASTE
```

```php
<?php
if (!hash_equals($_SESSION['sfp']['state'] ?? '', $_GET['state'] ?? '')) {
    http_response_code(400);
    exit('state no coincide');
}
$ch = curl_init('https://api.sistemafacturacionperu.com/oauth/token');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERPWD => getenv('SFP_APP_CLIENT_ID') . ':' . getenv('SFP_APP_CLIENT_SECRET'),
    CURLOPT_POSTFIELDS => http_build_query([
        'grant_type' => 'authorization_code',
        'code' => $_GET['code'],
        'redirect_uri' => 'https://tusistema.com/sfp/vuelta',
        'code_verifier' => $_SESSION['sfp']['verifier'],
    ]),
]);
$tokens = json_decode(curl_exec($ch), true);
// Guarda $tokens['refresh_token'], $tokens['empresa']['api_url'] y $tokens['conexion_id'] para esa empresa.
```

```js
const basic = Buffer.from(`${process.env.SFP_APP_CLIENT_ID}:${process.env.SFP_APP_CLIENT_SECRET}`).toString('base64');
const res = await fetch('https://api.sistemafacturacionperu.com/oauth/token', {
  method: 'POST',
  headers: { Authorization: `Basic ${basic}`, 'Content-Type': 'application/x-www-form-urlencoded' },
  body: new URLSearchParams({
    grant_type: 'authorization_code',
    code: req.query.code,
    redirect_uri: 'https://tusistema.com/sfp/vuelta',
    code_verifier: req.session.sfp.verifier,
  }),
});
const tokens = await res.json();
// Guarda tokens.refresh_token, tokens.empresa.api_url y tokens.conexion_id para esa empresa.
```

```python
r = requests.post(
    "https://api.sistemafacturacionperu.com/oauth/token",
    auth=(os.environ["SFP_APP_CLIENT_ID"], os.environ["SFP_APP_CLIENT_SECRET"]),
    data={
        "grant_type": "authorization_code",
        "code": request.args["code"],
        "redirect_uri": "https://tusistema.com/sfp/vuelta",
        "code_verifier": session["sfp"]["verifier"],
    },
    timeout=30,
)
tokens = r.json()
```

```json
{
  "access_token": "sfp_oat_…",
  "token_type": "Bearer",
  "expires_in": 3600,
  "refresh_token": "sfp_ort_…",
  "scope": "comprobantes.emitir comprobantes.leer consultas",
  "conexion_id": 42,
  "empresa": {
    "ruc": "20601030013",
    "razon_social": "EMPRESA CONECTADA S.A.C.",
    "api_url": "https://miempresa.sistemafacturacionperu.com/api/v1"
  }
}
```

Las credenciales van por `Authorization: Basic` **o** como `client_id` y `client_secret` en el cuerpo (no las dos).
Guarda `empresa.api_url`: **el token solo vale en la API de esa empresa**.

```bash
curl -s https://miempresa.sistemafacturacionperu.com/api/v1/yo -H "Authorization: Bearer sfp_oat_…"
```

## 4. Renueva y revoca

El token de acceso dura **1 hora**. Renuévalo con el de renovación: **cada uso te da uno nuevo y el anterior deja de
valer**. Si alguien reusa uno ya usado, revocamos toda la cadena y la empresa tiene que volver a pulsar «Permitir»:
guarda siempre el último.

```bash
curl -s https://api.sistemafacturacionperu.com/oauth/token -u "$SFP_APP_CLIENT_ID:$SFP_APP_CLIENT_SECRET" \
  -d grant_type=refresh_token -d refresh_token=sfp_ort_…
```

- `POST /oauth/revoke` (RFC 7009) con `token=` (y `token_type_hint` si quieres): un token de acceso deja de servir; un
  token de renovación **desconecta la empresa** (úsalo cuando el usuario quite la conexión en tu sistema). Siempre
  responde 200.
- Límites: 30 llamadas por minuto por IP y 120 por `client_id` (429 `temporarily_unavailable` con `Retry-After`).

## 5. Cuando la empresa desconecta

En **Configuración › Sistema › Integraciones › Aplicaciones conectadas** la empresa ve tu aplicación, quién la
autorizó, cuándo, sus permisos, su local y el último uso, y puede **Desconectar**. Al instante tus tokens responden 401
`conexion_revocada` y, si registraste un webhook, te llega `conexion.revocada` firmado como los
[webhooks](https://www.sistemafacturacionperu.com/desarrolladores/webhooks/):

```json
{
  "id": "7b0e3c8a-5d1f-4f0e-9a51-2a8c7c9e1f30",
  "evento": "conexion.revocada",
  "creado": "2026-12-26T10:15:00-05:00",
  "data": {
    "conexion_id": 42,
    "empresa": { "ruc": "20601030013", "razon_social": "EMPRESA CONECTADA S.A.C." },
    "motivo": "empresa",
    "revocada": "2026-12-26T10:15:00-05:00"
  }
}
```

La conexión es de la **empresa**: si quien autorizó cambia su contraseña o deja la empresa, sigue funcionando.

## Quién puede dar permiso

El administrador (titular) de la empresa y quien tenga la función «Gestionar tokens de API». Un vendedor o un cajero sin
esa función ve «Tu usuario no puede conectar sistemas». Ni nuestro soporte ni el portal del contador pueden autorizar en
nombre de la empresa. Con la cuenta suspendida o el pago vencido, la empresa no puede conectar y la API responde 423
`cuenta_bloqueada`.

## Plan Básico frente a PRO

| | Básico | PRO y Empresa |
|---|---|---|
| Conectar | Sí, solo para emitir | Sí, con todos los permisos |
| Qué puede hacer tu sistema | Emitir facturas, boletas, notas y guías (`comprobantes.emitir`, `guias.emitir`); ver su estado y bajar PDF, XML y CDR (`comprobantes.leer`, `guias.leer`); anular (`comprobantes.anular`); consultar RUC y DNI (`consultas`) | Además: clientes, productos, stock, cotizaciones, notas de venta, retenciones, percepciones, liquidaciones, cobros y webhooks |
| Comprobantes al mes | Los 300 del Básico, contados como en la web (422 `limite_plan` al pasarte) | Sin límite |
| Claves de API propias y modo pruebas | No (403 `plan_sin_api`) | Sí |

- Puedes pedir todos los permisos: en la pantalla «Permitir», un Básico ve tachados los que su plan no cubre, con
  «Incluido desde PRO», y el `scope` de la respuesta trae solo los que sirven hoy.
- Se revisa **en cada llamada** con el plan de ese momento: si la empresa baja a Básico, lo que no es de emitir responde
  403 `plan_insuficiente` (`errors.plan: ["PRO"]`); si sube a PRO, funciona sin volver a conectar. Para pedir permisos
  nuevos, el usuario vuelve a pasar por «Permitir» (se actualiza la misma conexión).

> **Para desarrollar,** registra también una `redirect_uri` de `http://localhost`. Recuerda que la conexión es siempre
> con una cuenta real: lo que emitas con ese token sigue la configuración de esa empresa (si está en el entorno
> «Demo», va a la beta de SUNAT; si está en «Producción», es válido ante SUNAT).

Los errores del servidor de autorización están en el [catálogo de errores](https://www.sistemafacturacionperu.com/desarrolladores/errores/).

---

# Pase a producción

URL: https://www.sistemafacturacionperu.com/desarrolladores/pase-a-produccion/

Lista de verificación para pasar tu integración de pruebas a producción: certificado digital, usuario secundario SOL, credenciales de guías, Ficha RUC y clave real.

Tu integración ya emite bien en el modo pruebas. Para que tus comprobantes valgan ante SUNAT, la **empresa** tiene que
estar en producción y tu sistema tiene que usar su **clave real**. Todo se configura en el sistema, en
**Configuración › Empresa › Datos y facturación SUNAT**, y cada credencial tiene su botón **Probar conexión**.

## 1. La empresa en SUNAT

En **Entorno y envío a SUNAT** elige el entorno **Producción** y por dónde salen tus comprobantes:

| Envío | Qué necesitas |
|---|---|
| **Directo a SUNAT** (lo más común) | Certificado digital y usuario secundario SOL |
| **OSE** | Certificado digital, usuario secundario SOL / OSE y la URL del OSE |
| **PSE** | Un proveedor (PSE) firma y envía por ti: no necesitas certificado ni usuario SOL |

### Certificado digital

- Un archivo `.pfx` con su clave privada y su contraseña, emitido a nombre de tu RUC.
- Súbelo en **Configuración › Empresa › Certificado**. Sin él, la API responde 422 `certificado_faltante` al emitir.
- Anota su fecha de vencimiento: un certificado vencido detiene la emisión.

### Usuario secundario SOL

- Créalo en **SUNAT Operaciones en Línea** con tu Clave SOL, con el perfil para emitir comprobantes electrónicos.
- En el sistema escribes ese usuario y su clave, en **Usuario secundario SOL**.
- Usa un usuario **secundario**, no el principal (SUNAT responde `0112`). Si le falta el perfil de emisión, `0111`; si
  la clave está mal, `0102` a `0104`. Ver los [errores de SUNAT](https://www.sistemafacturacionperu.com/desarrolladores/errores/#errores-de-sunat).

### Credenciales de guías de remisión (GRE)

Solo si emites guías. La API de guías de SUNAT pide dos cosas:

- un **usuario secundario SOL** con su clave (aquí va como RUC + usuario, por ejemplo `20123456789MIUSUARIO`);
- un **Client ID** y su **Client secret**, que creas en SUNAT Operaciones en Línea › Empresas › Credenciales de API
  SUNAT.

Se guardan en **Guías de remisión electrónicas (GRE)**, en la misma pantalla. Si usas un PSE, él también puede enviar
tus guías.

### Ficha RUC y régimen

Toda empresa nueva emite recién cuando su **Ficha RUC** queda verificada (Configuración › Empresa › Régimen tributario):
así nadie emite lo que SUNAT no le permite a su régimen. Mientras tanto la API responde 422 `ficha_ruc_pendiente`. Un
contribuyente del Nuevo RUS no emite facturas (`regimen_no_permite`).

## 2. Tu sistema

1. Crea la **clave real** en **Configuración › Sistema › Integraciones › API**: `sfp_live_…`, con solo los alcances
   que usas y, si quieres, un local fijo.
2. Cambia la dirección de `https://pruebas.sistemafacturacionperu.com/api/v1` a
   `https://<tu-subdominio>.sistemafacturacionperu.com/api/v1`.
3. Revisa las **series** de producción con `GET /establecimientos`: pueden no ser las mismas que en pruebas.
4. Si usas webhooks, **crea el webhook de producción** con la clave real (los de pruebas solo avisan de lo de pruebas) y
   guarda su secreto `whsec_…`.
5. Llama a `GET /yo` y comprueba `"modo": "produccion"` y `"sunat": "produccion"`.

## Lista de verificación

- [ ] La empresa está en el Plan PRO o Empresa (o conecta con el botón en el Básico, solo para emitir).

- [ ] Entorno **Producción** y envío elegido (Directo a SUNAT, OSE o PSE).

- [ ] Certificado digital subido y vigente (si no usas PSE).

- [ ] Usuario secundario SOL con perfil de emisión y su clave, probados con **Probar conexión**.

- [ ] Credenciales de guías (usuario SOL, Client ID y Client secret), si emites guías.

- [ ] Ficha RUC verificada.

- [ ] Clave `sfp_live_` con los alcances justos, guardada en una variable de entorno.

- [ ] Dirección de producción y series de producción en tu sistema.

- [ ] `Idempotency-Key` en cada emisión, guardada junto a tu venta.

- [ ] Webhook de producción creado y firma verificada (o consulta periódica del estado).

- [ ] Manejo de errores por `code`, reintentos con espera para 429 y 5xx.

- [ ] Primera factura real emitida y revisada: estado `aceptado`, PDF y CDR descargados.

## Después del pase

- Mira el **Registro de llamadas** los primeros días (Configuración › Sistema › Integraciones › API › Registro): ahí
  ves cada llamada con su resultado y, en los errores, lo que enviaste (sin contraseñas ni claves).
- Revoca las claves de pruebas que ya no uses.
- Si cambias de certificado o de usuario SOL, vuelve a usar **Probar conexión**.

---

URL: https://www.sistemafacturacionperu.com/desarrolladores/novedades/

# Novedades de la API

Lo que cambia en la API v1 de las empresas, la API de socios y la conexión con un botón, con lo más nuevo primero.

Las versiones y las reglas de compatibilidad están en
[Límites, idempotencia, paginación y versiones](https://sistemafacturacionperu.com/desarrolladores/limites-y-versiones/).

## 2026-11-04 · Conectar con Sistema Facturación Perú

Tu sistema puede conectar la cuenta que tu cliente **ya tiene** en Sistema Facturación Perú con un botón, sin pedirle
claves ni ver su contraseña.

- OAuth 2.0 con *authorization code* y PKCE S256 obligatorio: `GET https://api.sistemafacturacionperu.com/conectar`,
  `POST /oauth/token` y `POST /oauth/revoke` (RFC 6749, 7636, 7009 y 9207).
- El token de acceso (`sfp_oat_`) dura 1 hora y solo vale en la API v1 de esa empresa (`empresa.api_url`); el de
  renovación (`sfp_ort_`) cambia en cada uso.
- En el Plan Básico la conexión sirve para emitir (facturas, boletas, notas y guías, su estado y archivos, anular y
  consultar RUC y DNI) dentro de sus 300 comprobantes; lo demás responde 403 `plan_insuficiente`. En PRO y Empresa, todo.
- Aviso firmado `conexion.revocada` cuando la empresa pulsa «Desconectar».

## 2026-11-04 · API de socios v1

Para programadores y empresas de software con muchos clientes propios: das de alta a tus clientes como empresas de
Sistema Facturación Perú y emites con la API v1 de cada una.

- Base `https://api.sistemafacturacionperu.com/socios/v1`, con token OAuth 2 *client_credentials* (`sfp_pat_`, 1 hora).
- Alta de empresas (`POST /empresas`), su estado, uso del mes, pausa y reactivación, y claves v1 por empresa.
- Bolsas prepago con IGV y 6 meses de validez: 3.300 = S/ 180, 5.500 = S/ 285 y 10.000 = S/ 480. Cuota de S/ 9 al
  mes con IGV por empresa que emitió. Lo que la empresa envía con su propio usuario SOL no descuenta de la bolsa.
- Sin saldo, la API v1 de la empresa responde 402 `saldo_agotado`; con una cuota vencida, 402 `cuota_pendiente`.
- Webhooks del socio: `empresa.lista`, `saldo.bajo`, `saldo.agotado`, `cuota.vencida` y más.
- La API antigua de reseller (`api/reseller/*`) se retiró: responde 410 `api_retirada`.

## 2026-11-04 · API v1 de las empresas

Una API nueva, en español y con el mismo formato en todo: `https://<tu-subdominio>.sistemafacturacionperu.com/api/v1`.
La API antigua (`/api/documents`, `/api/dispatches`…) sigue funcionando igual.

- Comprobantes (factura, boleta, notas de crédito y de débito): emitir, listar, buscar por serie y número, descargar
  PDF, XML y CDR, anular (el sistema elige baja o resumen), reenviar a SUNAT, enviar por correo o por el WhatsApp de la
  empresa y registrar cobros.
- Guías de remisión remitente (09) y transportista (31) en una sola llamada; retenciones, percepciones, liquidaciones
  de compra, notas de venta y cotizaciones.
- Clientes, productos, stock por almacén, lote y serie, y locales con sus series.
- Consultas de RUC, DNI y tipo de cambio.
- Claves `sfp_live_` y `sfp_test_` con alcances, vencimiento y registro de llamadas de 30 días.
- Modo pruebas en `https://pruebas.sistemafacturacionperu.com/api/v1`, contra la beta de SUNAT, sin tocar tus
  comprobantes ni tus correlativos.
- `Idempotency-Key` en todo `POST` y `PUT`: un reintento no emite dos veces.
- Errores con `code` estable y mensaje en español; webhooks firmados (`X-SFP-Signature: t=…,v1=…`) cuando SUNAT acepta,
  observa o rechaza.
- Límites: 120 llamadas por minuto por clave y 30 emisiones por minuto.

## 2026-11-03 · API antigua: límites con 429

- Pasarse del límite de llamadas responde 429 con `Retry-After` (antes podía responder 500), contado por clave de API
  o por la IP real.
- Los errores ya no muestran rutas ni líneas del servidor.

---

# Sistema Facturación Perú: artículos del blog

---

# Afiliarte a la facturación electrónica SUNAT con tu sistema

URL: https://www.sistemafacturacionperu.com/blog/como-afiliarse-facturacion-electronica-sunat/
Publicado: 2026-10-02 · Categoría: Facturación electrónica

Guía para volverte emisor electrónico ante SUNAT: requisitos, modalidad, certificado, series y pruebas hasta tu primer comprobante. Empieza hoy sin enredos.

“Quiero facturar electrónicamente, pero no sé por dónde empezar.” Es lo que nos dicen a diario dueños de bodegas, talleres y distribuidoras de todo el país. La buena noticia es que el trámite ante SUNAT es corto. Lo que realmente toma tiempo es **elegir el sistema con el que vas a emitir** y tener tus datos en orden.

Aquí tienes una ruta completa en seis etapas, con un checklist previo, una tabla para elegir modalidad y los errores que más vemos en negocios que recién empiezan.

## Checklist previo: revisa esto antes de entrar al portal

Si algo de esta lista falla, el trámite se traba. Mejor resolverlo antes.

| Requisito | Por qué importa | Cómo verificarlo |
| --- | --- | --- |

| RUC activo y con domicilio **habido** | Con RUC de baja o no habido no podrás avanzar | Consulta RUC en la web de SUNAT |

| Clave SOL vigente | Es tu llave para SUNAT Operaciones en Línea | Si la olvidaste, recupérala en línea o en un centro de servicios |

| Rentas de tercera categoría | La emisión electrónica de facturas y boletas es para actividad empresarial | Revisa tu ficha RUC; los recibos por honorarios van por otro sistema |

| Actividad económica actualizada | Debe coincidir con lo que vendes | Actualiza tu ficha RUC si cambiaste de giro |

| Correo que revises a diario | Ahí llegan avisos y rechazos | Úsalo también para tu Buzón SOL |

| Establecimientos anexos declarados | Tus series se ordenan por local | Ficha RUC, sección de establecimientos |

Ten a la mano también tu nombre comercial, tu logo y la dirección fiscal tal como figura en SUNAT. Te los pedirá cualquier sistema.

## ¿Estás obligado o lo haces por decisión propia?

### Si SUNAT ya te designó

SUNAT ha ido incorporando emisores electrónicos por etapas, mediante resoluciones con fechas definidas. Si estás en una de esas listas, te llegó la notificación al **Buzón SOL** y, desde la fecha indicada, debes emitir comprobantes electrónicos; los físicos solo quedan para casos excepcionales como la contingencia.

Aquí la decisión no es “si”, sino **con qué herramienta** vas a emitir.

### Si quieres adelantarte

También puedes convertirte en emisor electrónico **de forma voluntaria**. Para muchos negocios conviene: no vuelves a mandar a imprimir talonarios, tus clientes empresa reciben su factura al instante por correo o WhatsApp y todo queda respaldado si algún día te fiscalizan.

Para entender el marco general antes de dar el paso, revisa nuestra página de [facturación electrónica SUNAT](https://www.sistemafacturacionperu.com/sistema-facturacion-electronica/).

## Etapa 1: decide con qué sistema vas a emitir

Esta elección condiciona el resto del proceso. Estas son las opciones más comunes:

| Opción | ¿Cuesta? | Cómo funciona | Ideal para |
| --- | --- | --- | --- |

| **SEE-SOL** (portal de SUNAT) | No | Ingresas con Clave SOL y completas cada comprobante manualmente | Negocios con muy pocas ventas al mes |

| **SEE-Facturador SUNAT (SFS)** | No | Programa que instalas en tu computadora; toma archivos, los firma y los envía | Empresas con un software propio que genera archivos |

| **Sistema del contribuyente con OSE o PSE** | Sí, mensualidad | Emites desde tu sistema de ventas y el OSE o PSE valida y envía | Negocios con ventas diarias que necesitan caja, stock y reportes |

Las dos primeras son gratuitas, pero quedan desconectadas de tu operación. La tercera tiene un costo mensual y, a cambio, une la venta, el inventario, la caja y el comprobante en un solo paso. OSE y PSE no son lo mismo: te contamos [qué separa a un OSE de un PSE](https://www.sistemafacturacionperu.com/blog/diferencia-ose-pse-sunat/).

**Una regla práctica:** cuenta tus comprobantes. Si emites unos 15 al mes, el portal de SUNAT te sirve. Si son 15 por día, como en un minimarket de Huancayo, llenarlos a mano te costará más horas de las que ahorras en la mensualidad.

## Etapa 2: resuelve la firma digital

Todo comprobante electrónico se **firma digitalmente**. Sin firma válida, SUNAT no lo acepta. Tienes tres caminos:

- **Usar el portal SOL:** SUNAT firma por ti y no necesitas certificado.

- **Certificado Digital Tributario (CDT):** SUNAT lo otorga gratis a contribuyentes de tercera categoría que cumplen ciertos requisitos (RUC activo, domicilio habido y no estar inscrito como OSE ni PSE, entre otros). Se solicita en SUNAT Operaciones en Línea, en el menú de comprobantes de pago, y se descarga del Buzón SOL al crear tu clave privada.

- **Certificado comprado** a una entidad de certificación acreditada, útil si también lo vas a usar para otros fines.

Si trabajas con un PSE, normalmente él firma por ti. Lo detallamos en nuestro artículo sobre el [certificado digital para facturar](https://www.sistemafacturacionperu.com/blog/certificado-digital-sunat/).

## Etapa 3: obtén la calidad de emisor electrónico

Con el RUC en orden y la firma resuelta, ingresas con tu Clave SOL a **SUNAT Operaciones en Línea** y eliges la opción para ser emisor electrónico en la modalidad que escogiste. SUNAT verifica automáticamente que tu RUC esté activo y que tengas rentas de tercera categoría.

En ese mismo proceso registras:

- **Tu certificado digital vigente.** Si ya lo habías registrado para otra modalidad del sistema de emisión electrónica, ese paso se da por cumplido.

- **Tu correo electrónico** para notificaciones y rechazos.

Si vas a emitir mediante un **PSE**, lo designas desde el mismo portal; de lo técnico se ocupa él.

## Etapa 4: organiza tus series por local y por caja

A diferencia de los talonarios, en la emisión electrónica **no pides autorización de series ni de rangos de numeración**. Tú decides cuántas series usar.

Sí debes respetar el formato. En comprobantes emitidos desde un sistema del contribuyente, la serie tiene **cuatro caracteres alfanuméricos** y la primera letra indica el tipo:

| Comprobante | Ejemplo de serie |
| --- | --- |

| Factura | F001, F002 |

| Boleta de venta | B001, B002 |

| Nota de crédito o débito de una factura | Serie que empieza con F |

| Nota de crédito o débito de una boleta | Serie que empieza con B |

En el portal SOL, la serie y el número los asigna SUNAT automáticamente.

Nuestro consejo: **una serie por cada local y por cada caja**. Si tienes una tienda en el Centro de Chiclayo y otra en La Victoria, cada una con su serie. El cierre mensual será más ordenado y, ante una fiscalización, podrás rastrear cada venta sin esfuerzo.

La numeración es **correlativa y sin saltos**. Si un comprobante sale con error, no se elimina: se corrige con una nota de crédito o se comunica su baja, según corresponda. Lo explicamos en [cómo anular una factura electrónica](https://www.sistemafacturacionperu.com/blog/como-anular-factura-electronica-sunat/).

## Etapa 5: haz una prueba completa

No estrenes tu facturación con el cliente más importante. Haz primero este recorrido:

- Emite **una factura y una boleta** con productos reales de tu catálogo.

- Verifica que llegue la **CDR** (constancia de recepción) aceptada. El PDF puede verse impecable, pero sin CDR aceptada no hay comprobante válido.

- Comprueba que el **XML** quede guardado. Debes conservarlo; el PDF solo es una representación impresa.

- Emite una **nota de crédito** sobre la factura de prueba para saber cómo corregir cuando haga falta.

- Busca el comprobante en la **consulta de validez** de SUNAT y confirma que aparezca aceptado.

- Imprime una versión en **ticket** y otra en **A4**; confirma que aparezcan el **código QR**, tu RUC, tu dirección y el detalle de la venta.

## Etapa 6: emite tu primer comprobante real

Si la prueba salió bien, la primera venta real es sencilla: identificas al cliente (con RUC si va factura; si va boleta, con DNI o sin documento cuando el monto lo permite), agregas los productos, cobras y el sistema emite.

Hay un plazo que debes tener muy presente: la factura electrónica se envía a SUNAT o al OSE el mismo día de su emisión o, como máximo, en los **tres días calendario** que siguen a esa fecha. Si se envía después, el documento **pierde la calidad de factura electrónica**, aunque el cliente ya lo tenga. Un sistema en la nube hace el envío solo; si trabajas sin conexión, no acumules envíos.

## Errores típicos en las primeras semanas

- Enterarse de que figuras como **no habido** cuando ya estás en pleno trámite.

- Pensar que el **PDF** es el comprobante. Lo que vale como respaldo es el XML junto con su CDR.

- Dar **boleta a quien necesitaba factura**. Cuando el comprador tiene RUC y usará el comprobante en su empresa, va factura. Lo detallamos en [cuándo emitir factura y cuándo boleta](https://www.sistemafacturacionperu.com/blog/diferencia-entre-factura-y-boleta-electronica/).

- Dejar sin declarar los **establecimientos anexos** y luego no poder ordenar las series por local.

- Olvidar la **fecha de vencimiento del certificado digital**. Ese día dejas de emitir. Ponle una alarma un mes antes.

- Enviar tarde el **resumen diario de boletas**, o no enviarlo.

- Guardar solo los PDF. En una fiscalización te pedirán los **XML**.

## ¿Cuánto tiempo toma en la realidad?

Si tu RUC está en regla y tienes tu Clave SOL, **el trámite ante SUNAT toma minutos**. Lo que demora es todo lo demás:

| Tarea | Tiempo aproximado |
| --- | --- |

| Regularizar la condición de no habido (si aplica) | Varios días |

| Obtener y registrar el certificado digital | De uno a pocos días |

| Cargar productos, clientes y stock inicial | Lo que más demora; depende de tu catálogo |

| Capacitar a quienes van a emitir | Una o dos sesiones |

Una bodega con todo listo puede emitir el mismo día. Una distribuidora con 2,000 productos y tres sucursales debería calcular entre una y dos semanas, sobre todo por la carga de datos. Por eso, al comparar proveedores, averigua **quién se encarga de subir tu catálogo** y si la capacitación viene incluida.

## Empieza a emitir con Sistema Facturación Perú

Afiliarte es solo el primer paso. Lo importante es que emitir comprobantes no te quite tiempo todos los días. Con Sistema Facturación Perú emites facturas, boletas, notas y guías desde el mismo lugar donde vendes y controlas tu stock, con envío directo a SUNAT, por OSE o por PSE.

Revisa qué incluye cada plan en la página de [precios](https://www.sistemafacturacionperu.com/precios/), o [escríbenos](https://www.sistemafacturacionperu.com/contacto/) y te acompañamos desde el certificado hasta tu primer comprobante, con los datos reales de tu negocio.

---

# Sistemas de facturación electrónica en Perú comparados (2026)

URL: https://www.sistemafacturacionperu.com/blog/mejores-sistemas-facturacion-electronica-peru/
Publicado: 2026-09-24 · Actualizado: 2026-10-27 · Categoría: Comparativas

Comparamos los sistemas de facturación electrónica más usados en Perú: precios publicados, límites de cada plan y qué negocio encaja con cada uno. Elige bien.

Si buscas un **sistema de facturación electrónica en Perú**, ya habrás notado que todas las páginas prometen lo mismo: nube, rapidez y conexión con SUNAT. Lo que casi nunca aparece claro es lo que de verdad decide la compra: cuánto pagas al final del mes, cuántos comprobantes entran en el plan y si el sistema también te sirve para vender o solo para emitir.

En esta comparativa vamos al revés de lo habitual. Arrancamos por **la pregunta que te ahorra la mayor parte del dinero**, seguimos con una lista de verificación que puedes llevar a cualquier demo y recién después revisamos uno por uno los sistemas más conocidos del país. Los precios los tomamos de la web pública de cada proveedor el **18 de setiembre de 2026**. Cuando una empresa no publica su tarifa, lo indicamos tal cual, sin estimar.

## La primera pregunta: ¿necesitas un facturador o un sistema de gestión?

El mercado peruano se reparte, a grandes rasgos, en dos familias de productos:

| Familia | Qué resuelve | Cuándo encaja |
| --- | --- | --- |

| **Facturador** | Genera el comprobante electrónico, lo envía y guarda la respuesta de SUNAT | Consultorios, servicios, negocios que venden poco o que ya llevan stock en otro programa |

| **Sistema de gestión** | Comprobantes + caja + punto de venta + inventario + compras | Bodegas, minimarkets, ferreterías, restaurantes, distribuidoras: cualquiera que despacha productos todos los días |

Equivocarte aquí cuesta caro. Imagina una ferretería en Trujillo que contrata un facturador de S/ 49 porque «era lo más barato». A los dos meses necesita saber cuántos rollos de cable le quedan, cuánto ganó con el cemento y qué cobró cada cajero. Termina pagando otro programa de inventario, exportando ventas de uno a otro y cuadrando a mano los fines de semana. El ahorro inicial se esfuma.

La regla corta: **si tienes mostrador y stock, mira primero sistemas de gestión**. Si solo emites comprobantes por servicios, un facturador puede bastarte.

## Lista de verificación para cualquier demo

Lleva estas preguntas a cada proveedor. Las respuestas te van a ordenar la decisión mejor que cualquier ranking.

### Sobre la conexión con SUNAT

- ¿Emite **directo a SUNAT**, mediante un **OSE** o por un **PSE**? Si no lo tienes claro, revisa [en qué se diferencian un OSE y un PSE](https://www.sistemafacturacionperu.com/blog/diferencia-ose-pse-sunat/).

- ¿Dónde quedan guardados el XML firmado y la **constancia de recepción (CDR)**? ¿Puedes descargarlos cuando quieras?

- ¿Qué hace el sistema cuando el servicio de SUNAT no responde? ¿Reintenta solo o te toca reenviar a mano?

### Sobre los topes del plan

- ¿Cuántos **comprobantes por mes** incluye?

- ¿Cuántos **usuarios** puedes crear y cuántos **locales o sucursales** admite?

- ¿Qué pasa si te pasas del tope: te cobran extra, te bloquean o te obligan a subir de plan?

Un ejemplo con números: si el plan de entrada incluye 20 comprobantes y una bodega en Arequipa emite 35 boletas en una semana buena, el precio que viste en la portada deja de ser el que pagas.

### Sobre el precio real

- ¿El precio publicado **ya incluye IGV** o va «+ IGV»? A los segundos súmales 18 % para comparar en igualdad.

- ¿Cobran en **soles o en dólares**? Si es en dólares, conviértelo al tipo de cambio del día de pago.

- ¿Hay un **pago de implementación** que no aparece en la web? En los ERP es común.

### Sobre el día a día

- ¿El **soporte** atiende en horario peruano y por qué canal: WhatsApp, teléfono, correo?

- ¿Te ayudan a **cargar tus productos, clientes y stock inicial**, o lo haces tú desde cero?

- ¿**Exporta al programa de tu contador** (CONCAR, SISCONT, CONTASIS u otro)? Si no, alguien va a volver a digitar tus ventas cada mes y esa hora de trabajo terminas pagándola tú.

## Opciones gratuitas de SUNAT

### SEE-SOL y SEE-Facturador SUNAT (SFS)

SUNAT pone a tu disposición dos caminos sin costo:

- **SEE-SOL**: emites desde la web de SUNAT, entrando con tu clave SOL, comprobante por comprobante.

- **SEE-Facturador SUNAT (SFS)**: un programa que se instala en una computadora y que arma, firma y envía el XML de forma automática a partir de los datos que le entregas.

A favor tienen dos cosas difíciles de igualar: no pagas nada y trabajas con la fuente oficial. En contra, ninguno de los dos te da catálogo de productos, caja ni stock. El SFS, además, está pensado para quien ya cuenta con un programa propio y solo necesita el canal de envío. Si quieres ver qué cambia frente a un sistema de pago, revisa nuestra página de [alternativa al facturador SUNAT](https://www.sistemafacturacionperu.com/alternativa-al-facturador-sunat/).

## Facturadores de pago

### Mifact

Es un **PSE autorizado por SUNAT** y cuenta con certificación **ISO 27001**. Su escalera de planes es de las más bajas para empezar:

- **Plan Básico, S/ 45 al mes**: 2 usuarios, 1 local, 2 puntos de venta, 3 series y un tope de 500 comprobantes.

- **Plan Plus, S/ 70 al mes**: suma control de inventario.

- **Premium+, S/ 99 al mes**.

Ofrece descuentos si pagas 3, 6 o 12 meses por adelantado. Lo más interesante es que puedes crecer de escalón sin migrar de proveedor.

### Alegra

Plataforma latinoamericana con operación en varios países y una interfaz muy cuidada, con fuerte enfoque contable. En Perú publica estos planes de facturación electrónica, **con IGV y certificado digital incluidos**:

| Plan | Tope mensual de comprobantes | Precio al mes |
| --- | --- | --- |

| Emprendedor | 20 (con 2 usuarios) | S/ 49 |

| PYME | 60 | S/ 59 |

| PRO | 150 | S/ 99 |

| PLUS | 350 | S/ 199 |

Aquí el dato que manda es el **tope de comprobantes**: define en qué plan terminas, más que las funciones.

### NubeFacT

Es de los nombres más reconocidos del país y está acreditado como **OSE y como PSE**. Su plan **NubeFacT Online vale S/ 70 mensuales, IGV incluido**, con hasta 500 documentos al mes, usuarios y establecimientos sin límite y certificado digital. Tiene además un plan de integración por **TXT-JSON** al mismo precio, para quien quiere conectarlo con su propio programa. Destaca por su solidez como operador y por una API directa. Si estás pensando en cambiarte, encontrarás el contraste en [alternativa a NubeFacT](https://www.sistemafacturacionperu.com/alternativa-a-nubefact/).

### Tefacturo

Empresa peruana con trayectoria en el rubro. Sus planes publicados son:

- **Emprendedor, S/ 79 al mes**, hasta 300 comprobantes.

- **Negocios, S/ 159**.

- **PYMES, S/ 179**, que ya trae punto de venta, inventario y manejo de varias tiendas y almacenes.

- **Integración, S/ 79**, para conectar por API un ERP de terceros.

Su página no aclara si esos montos incluyen IGV, así que pregúntalo antes de contratar. Su punto fuerte es la integración con sistemas que ya están funcionando.

## Sistemas de gestión

### Sistema Facturación Perú

Es nuestra plataforma, así que la presentamos con sus límites incluidos. Arranca en **S/ 37 mensuales en tarifa anual** (S/ 49 en la tarifa mensual), más IGV, y ese primer plan ya emite **facturas y boletas electrónicas** e incluye **caja, punto de venta e inventario**, cuando en buena parte del mercado esas funciones aparecen recién en planes medios o altos.

Lo que debes saber antes de elegir:

- El **Plan Básico (S/ 49 + IGV)** emite comprobantes electrónicos directo a SUNAT o mediante OSE o PSE, para 3 usuarios y un local, con un máximo de 300 comprobantes mensuales, y trae guías de remisión, compras, inventario, cobranza y tienda virtual en subdominio.

- El **Plan PRO (S/ 149 + IGV)** amplía a 10 usuarios y 3 locales, quita el tope de comprobantes y agrega varios almacenes, kardex valorizado, CRM, SIRE, exportación contable, portal del contador, app Android y dominio propio para la tienda virtual.

- El **Plan Empresa (S/ 299 + IGV)** quita el límite de usuarios y locales y agrega Mercado Libre, WooCommerce, email marketing incluido, un buzón con el dominio de tu empresa, capacitación en vivo y soporte prioritario.

Ningún plan tiene contrato forzoso y se pagan con tarifa mensual, semestral (rebaja de 15 %) o anual (rebaja de 25 %); al renovar, el precio no sube. El detalle de cada uno está en [planes y precios](https://www.sistemafacturacionperu.com/precios/).

### Bsale

Muy extendido en el retail. Sus tres planes mensuales se publican **con IGV incluido**: el **Básico** cuesta S/ 189; el **Estándar**, S/ 233; y el **Full**, S/ 363. En los tres tienes usuarios sin límite, 1,000 comprobantes, una sucursal con varias cajas, inventario para 5,000 SKU, punto de venta con cierre de caja, integración con SIRE y tienda online. Su ventaja está en el punto de venta para tiendas y en su app móvil. El contraste completo lo tienes en [alternativa a Bsale](https://www.sistemafacturacionperu.com/alternativa-a-bsale/).

### Defontana

Lleva más de veinte años operando en la región como ERP y su terreno fuerte es la contabilidad y las finanzas de la empresa mediana. En Perú publica:

- **Plan Pro: US$ 70 + IGV mensuales**, para un máximo de 2 usuarios, con ventas, inventario y facturación electrónica.

- **Plan Full: US$ 180 + IGV mensuales**, que admite hasta 6 usuarios e incluye BI contable y comercial.

Además cobra la **implementación como pago único**, y ese monto no aparece publicado. Pide la cotización por escrito antes de firmar.

### Siigo

Software contable y administrativo presente en varios países. En Perú factura **por año, en dólares y sin IGV**, según aclara su propia web:

| Línea | Plan | Precio anual |
| --- | --- | --- |

| ERP | Facturador | US$ 200 |

| ERP | Emprendedor | US$ 420 |

| ERP | Contador | US$ 500 |

| ERP | Premium | US$ 1,200 |

| POS | Esencial | US$ 250 |

| POS | Inicio | US$ 400 |

| POS | Avanzado | US$ 600 |

Su diferencial es el plan para estudios contables que administran varias empresas.

## Cuadro resumen

| Sistema | Precio de entrada | Punto de venta | Inventario | Le conviene a |
| --- | --- | --- | --- | --- |

| SEE-SOL / Facturador SUNAT | Gratis | No | No | Quien emite pocos comprobantes y está empezando |

| Sistema Facturación Perú | S/ 37 mensuales en tarifa anual o S/ 49 en la mensual, más IGV; ya emite comprobantes electrónicos | Incluido en todos | Incluido en todos | Bodegas, minimarkets, ferreterías y restaurantes |

| Mifact | S/ 45 mensuales | Sí, según puntos de venta | Desde Plus (S/ 70) | Negocios pequeños que quieren subir por etapas |

| Alegra | S/ 49 mensuales | No en el plan de inicio | Según el plan | Servicios y consultoras con pocos comprobantes |

| NubeFacT | S/ 70 mensuales | No | No | Empresas con sistema propio que solo necesitan emitir |

| Tefacturo | S/ 79 mensuales | Desde PYMES (S/ 179) | Desde PYMES | Negocios que integrarán por API |

| Bsale | S/ 189 mensuales | Sí | Sí | Retail con caja y venta online |

| Defontana | US$ 70 + IGV al mes | Según módulos | Sí | Empresas medianas con exigencia contable |

| Siigo | US$ 200 al año (ERP) | En la línea POS | Sí | Estudios contables y grupos con varias razones sociales |

Antes de sacar conclusiones, ten presentes dos cosas:

- **No todos publican igual.** Bsale, NubeFacT, Alegra y Mifact muestran precios con IGV; Sistema Facturación Perú, Defontana y Siigo, sin IGV. Para comparar en igualdad, agrégales 18 % a los segundos.

- **Los precios cambian.** Son los publicados al 18 de setiembre de 2026; confírmalos en la web de cada proveedor antes de decidir.

## Tres perfiles, tres respuestas

### Consultora en Lima que emite 10 facturas al mes

No necesitas caja ni stock. Empieza con SEE-SOL, que es gratuito. Cuando digitar cada factura te quite más tiempo del que vale, pasa a un facturador de entre S/ 45 y S/ 70 al mes.

### Bodega o minimarket en Arequipa con ventas todo el día

Aquí un facturador se queda corto. Te hace falta **cobrar con lector de código de barras, imprimir en ticketera y que el stock baje solo** en la misma venta. Compara sistemas de gestión por lo que reemplazan, no por el precio de portada: uno de S/ 189 puede salir más a cuenta que uno de S/ 49 más un programa de inventario aparte. Para saber qué exigirle, mira lo que debe traer un buen [software de inventario](https://www.sistemafacturacionperu.com/sistema-de-inventario/).

### Distribuidora en Chiclayo con dos almacenes y venta al crédito

Cambian las prioridades. Pesa más tener **varias sucursales con series propias**, traslados entre almacenes con guía de remisión, kardex valorizado, cuentas por cobrar con plazo y exportación al programa del contador. Fíjate en los planes que cobran por sucursal: con tres locales, el precio de lista ya no dice la verdad.

## Prueba el sistema con tu propio catálogo

No existe un sistema ideal para todos los negocios. El adecuado para el tuyo es el que acompaña tu manera de vender y no te cobra por funciones que nunca vas a abrir.

Si quieres ver cómo se vería **Sistema Facturación Perú** con tus productos, tus precios y tu volumen de ventas, [escríbenos](https://www.sistemafacturacionperu.com/contacto/) y te preparamos una demostración sin compromiso. También puedes revisar directamente los [planes y precios](https://www.sistemafacturacionperu.com/precios/).

---

# Kardex valorizado en tu sistema: cómo funciona y cuándo lo pide SUNAT

URL: https://www.sistemafacturacionperu.com/blog/kardex-valorizado-sunat/
Publicado: 2026-09-24 · Actualizado: 2026-10-27 · Categoría: Inventario

Columnas, métodos de valuación y un ejemplo con números del kardex valorizado. Además, cuándo SUNAT exige el inventario permanente valorizado a tu empresa.

Pregúntale a la dueña de una librería en el Cusco cuántos cuadernos tiene y te lo dirá en segundos. Pregúntale cuánto dinero tiene invertido en esos cuadernos, al costo, y la respuesta se complica: compró en febrero, volvió a comprar más caro antes de la campaña escolar y ya vendió una buena parte. Ese segundo dato es el que entrega un **kardex valorizado**.

Y no solo le sirve a ella. Cuando una empresa supera ciertos niveles de ingresos, SUNAT le exige llevar un **registro de inventario permanente valorizado**, que se apoya justamente en ese kardex. No tenerlo cuando corresponde abre la puerta a reparos y multas. Veamos cómo funciona, cómo se calcula y cuándo es obligatorio.

## El kardex valorizado, columna por columna

Un kardex es la ficha de movimientos de un producto. La versión valorizada agrega a cada fila el costo de lo que entra y sale, y el valor de lo que queda. Estas son sus columnas habituales:

| Columna | Qué guarda | Ejemplo |
| --- | --- | --- |

| Fecha | Cuándo ocurrió el movimiento | 20/02 |

| Documento | El comprobante o documento que lo respalda | Factura de compra F001-1452 |

| Tipo de operación | Compra, venta, devolución, traslado, ajuste, merma | Compra |

| Entradas: cantidad, costo unitario y costo total | Lo que ingresó y a qué costo | 200 × S/ 4.50 = S/ 900 |

| Salidas: cantidad, costo unitario y costo total | Lo que salió y con qué costo se valorizó | 350 × S/ 4.20 = S/ 1,470 |

| Saldo: cantidad, costo unitario y costo total | Lo que queda y cuánto vale | 150 × S/ 4.20 = S/ 630 |

La última columna es la que cambia la conversación: te dice cuánto vale tu stock **al costo**, en cualquier fecha. No al precio de venta ni a ojo, sino según lo que realmente pagaste.

Un detalle importante: el costo de una compra no es solo el precio del proveedor. Según la Ley del Impuesto a la Renta, el costo de adquisición incluye también gastos como fletes, seguros y otros necesarios para poner el bien en tu almacén. Y el IGV que usas como crédito fiscal no forma parte del costo.

## ¿Y el kardex en unidades?

El kardex en unidades registra solo cantidades. Te sirve para saber qué hay en cada almacén y cuándo reponer, pero no te dice cuánto cuesta lo que vendes ni cuánto vale lo que guardas. Si estás evaluando cuál de los dos necesitas, lo comparamos con un ejemplo práctico en [inventario valorizado vs. inventario simple](https://www.sistemafacturacionperu.com/blog/inventario-valorizado-vs-simple/).

## Qué métodos de valuación acepta la ley peruana

Cuando compras el mismo producto a distintos precios, aparece la pregunta de fondo: **¿con qué costo sale cada unidad vendida?** La respuesta depende del método de valuación.

El artículo 62 de la Ley del Impuesto a la Renta enumera los métodos permitidos para valuar existencias. Entre ellos están:

- **Primeras entradas, primeras salidas (PEPS).**

- **Promedio diario, mensual o anual** (el promedio ponderado que usan casi todos los sistemas).

- **Identificación específica**, útil cuando cada unidad es distinta, como un vehículo o una joya.

- Otros métodos especiales previstos en la norma, como el de inventario al detalle o por menor y el de existencias básicas.

Un error que se arrastra de libros de texto extranjeros: el método **UEPS** (últimas entradas, primeras salidas) **no figura entre los métodos permitidos** en la legislación peruana del Impuesto a la Renta.

## Caso práctico: cuadernos en una librería del Cusco

Los montos están sin IGV.

**Compras:**

- **5 de febrero:** 300 cuadernos a **S/ 4.00** = S/ 1,200

- **20 de febrero:** 200 cuadernos a **S/ 4.50** = S/ 900

Saldo: **500 cuadernos** con un costo total de **S/ 2,100**.

**Venta:** el **1 de marzo**, en plena campaña escolar, vende **350 cuadernos a S/ 7.00** cada uno. Ingreso: **S/ 2,450**.

### Con promedio ponderado

Costo promedio: S/ 2,100 ÷ 500 = **S/ 4.20 por cuaderno**.

- Costo de lo vendido: 350 × S/ 4.20 = **S/ 1,470**

- Saldo: 150 cuadernos × S/ 4.20 = **S/ 630**

### Con PEPS

Salen primero los 300 cuadernos más antiguos y luego 50 de la segunda compra.

- Costo de lo vendido: (300 × S/ 4.00) + (50 × S/ 4.50) = S/ 1,200 + S/ 225 = **S/ 1,425**

- Saldo: 150 cuadernos de la segunda compra × S/ 4.50 = **S/ 675**

### Los dos resultados lado a lado

| Concepto | Promedio ponderado | PEPS |
| --- | --- | --- |

| Ingreso por la venta | S/ 2,450 | S/ 2,450 |

| Costo de lo vendido | S/ 1,470 | S/ 1,425 |

| **Utilidad bruta** | **S/ 980** | **S/ 1,025** |

| Valor del saldo (150 cuadernos) | S/ 630 | S/ 675 |

La misma venta deja S/ 45 más de utilidad con PEPS. En un solo producto parece poco, pero en una librería con miles de artículos y precios que suben cada campaña, el método elegido cambia tanto la renta que declaras como las existencias que muestra tu balance.

### ¿Qué método le conviene a tu negocio?

- **Promedio ponderado:** el más práctico para negocios con muchos productos y compras frecuentes, como bodegas, ferreterías o distribuidoras. Suaviza los cambios de precio y es fácil de mantener.

- **PEPS:** deja en el saldo el costo de las compras más recientes, más cercano al valor de reposición. Encaja bien en rubros con fecha de vencimiento, como farmacias o alimentos, donde de todos modos se vende primero lo más antiguo.

- **Identificación específica:** para bienes únicos o de alto valor que se pueden distinguir uno por uno.

### Una vez elegido, no se cambia a voluntad

La normativa del Impuesto a la Renta no permite variar el método de valuación de un ejercicio a otro sin **autorización de SUNAT**. Por eso esta decisión se toma con tu contador **antes** de configurar el sistema, no al cierre del año cuando ves qué método te conviene más.

## La parte tributaria: el registro de inventario permanente valorizado

### Qué respalda

Este registro forma parte de los libros que la normativa tributaria exige a ciertas empresas. Su función es demostrar que el **costo de ventas** que restas en tu declaración del Impuesto a la Renta proviene de movimientos reales de mercadería, documento por documento. Sin ese respaldo, SUNAT puede desconocer parte del costo en una fiscalización.

### Quiénes deben llevarlo

La regla aparece en el **art. 35 del Reglamento de la LIR** (Ley del Impuesto a la Renta) y se determina según los **ingresos brutos del ejercicio anterior**, expresados en UIT. En términos generales:

| Nivel de ingresos del ejercicio anterior | Qué se debe llevar |
| --- | --- |

| El tramo más bajo | Inventarios físicos al cierre del ejercicio |

| El tramo intermedio | Registro de inventario permanente en unidades físicas |

| El tramo más alto | Registro de inventario permanente valorizado y registro de costos |

Preferimos no fijar aquí los montos exactos en UIT: el valor de la UIT cambia cada año y la redacción de los tramos ha tenido modificaciones. Antes de decidir, revisa con tu contador, o en el portal de [SUNAT](https://www.sunat.gob.pe/), en qué nivel quedas según lo que facturaste el año pasado.

### Lo que sí debes tener claro

- **Se mide con el ejercicio anterior.** Lo que vendas este año define tu obligación del próximo.

- **El régimen no decide solo.** Estar en el Régimen General o en el MYPE Tributario no te obliga ni te exime por sí mismo; manda el nivel de ingresos.

- **Hay un plazo máximo de atraso.** SUNAT fija por resolución cuántos meses puede estar atrasado este registro. No se arma la víspera de una fiscalización: debe llevarse al día.

- **Tiene un formato.** SUNAT establece el contenido mínimo del registro (el conocido formato 13.1), que tu sistema debería poder generar.

## Cuatro razones para llevarlo aunque no estés obligado

- **Conoces tu margen real.** Calcular la utilidad con el último precio de compra da un número equivocado cuando compraste a varios precios. Con el kardex valorizado, cada venta lleva asociado su costo verdadero.

- **La merma se mide en soles.** Cuando el conteo físico no cuadra, ya no hablas de «unas cuantas unidades», sino de S/ 520 que faltan este mes. Ese número sí motiva a revisar procesos.

- **Ves el capital dormido.** Puedes vender bien y estar sin efectivo porque tienes miles de soles en mercadería parada. Revisando el saldo en soles de cada artículo, lo detectas enseguida.

- **Te prepara para crecer.** Si pides un préstamo o superas el tramo de ingresos, ya tendrás el historial ordenado y unos estados financieros con el inventario bien sustentado.

## Excel o sistema: cuándo dar el salto

| Situación | Excel | Sistema con kardex automático |
| --- | --- | --- |

| Pocos productos y pocas compras al mes | Funciona | También funciona |

| Cientos de productos y compras semanales | Fórmulas que se rompen | Se calcula con cada movimiento |

| Varias personas registrando | Versiones distintas del archivo | Un solo registro con usuario y fecha |

| Ventas desde el punto de venta | Hay que copiarlas a mano | Las salidas se generan solas |

| Pedido del contador | Días de preparación | Reporte listo para exportar |

En un sistema, el kardex se arma a partir de lo que ya haces: **cada compra** que registras crea la entrada con su costo, **cada venta** genera la salida valorizada con el método configurado, y **los traslados, ajustes y devoluciones** quedan anotados con su documento y el usuario que los hizo.

## Hábitos que mantienen el kardex confiable

- **Registra cada compra el día que llega**, con su factura y los gastos que forman parte del costo.

- **Anota mermas y productos dañados** con su motivo, en lugar de ajustar todo de golpe al final del año.

- **Haz conteos físicos** al menos al cierre del ejercicio, y con más frecuencia en los productos de mayor valor.

- **Revisa los ajustes grandes** antes de aprobarlos: suelen esconder errores de registro.

Un kardex valorizado alimentado tarde o a medias es casi tan inútil como no tenerlo.

## Tu kardex se arma solo con Sistema Facturación Perú

En Sistema Facturación Perú, el [sistema de inventario](https://www.sistemafacturacionperu.com/sistema-de-inventario/) registra cada compra, venta, traslado y ajuste, y desde el Plan PRO tienes el **kardex valorizado**, también en el formato SUNAT 13.1, para que veas el costo y el saldo en soles de cada producto. ¿Tu contador usa CONCAR, SISCONT, CONTASIS u otro programa compatible? Con ese mismo plan le pasas la información en su formato; mira cómo funciona en nuestro [software contable](https://www.sistemafacturacionperu.com/sistema-contable/).

¿No sabes si estás obligado? Revísalo con tu contador y los ingresos del año pasado. Y si quieres ver tu kardex armado con tus propios productos, [conversemos](https://www.sistemafacturacionperu.com/contacto/) o compara los planes en la [página de precios](https://www.sistemafacturacionperu.com/precios/).

---

# Anular una factura electrónica en SUNAT: baja o nota de crédito

URL: https://www.sistemafacturacionperu.com/blog/como-anular-factura-electronica-sunat/
Publicado: 2026-09-22 · Categoría: Facturación electrónica

¿Emitiste mal una factura o boleta? Aprende cuándo usar comunicación de baja o nota de crédito, los plazos de SUNAT y cómo hacerlo desde tu sistema.

Son las 6 de la tarde en una distribuidora de abarrotes en Arequipa. La asistente revisa las ventas del día y se da cuenta de que una factura de S/ 1,850 salió con el RUC de otro cliente. Lo primero que hace es buscar la opción “eliminar”. No la encuentra.

No es un descuido del sistema. Cuando SUNAT acepta un comprobante electrónico, **ya no se puede borrar**. Lo que sí puedes hacer es dejarlo sin efecto con una **comunicación de baja** o corregirlo con una **nota de crédito**. Cada vía tiene sus reglas y sus plazos, y usar la equivocada te deja con el problema sin resolver. Vamos por partes.

## Antes de anular, mira la respuesta de SUNAT

Cada factura que envías regresa con una **CDR** (constancia de recepción). Su estado define lo que debes hacer:

| Estado de la CDR | Qué significa | Qué haces |
| --- | --- | --- |

| Aceptada | El comprobante tiene plena validez tributaria | Baja o nota de crédito, según el caso |

| Aceptada con observaciones | Es válido, pero tiene datos que podrían cuestionarse | Evalúa si corresponde corregir con nota |

| Rechazada | Para SUNAT, ese comprobante no existe | Nada que anular: corriges y emites de nuevo |

Muchos negocios pierden tiempo “anulando” facturas rechazadas. Si SUNAT la rechazó, no hay nada que dar de baja.

## Comunicación de baja: cuando la operación nunca debió existir

### En qué casos se usa

La comunicación de baja le dice a SUNAT que un comprobante **queda sin efecto**. Es la vía cuando la venta no se concretó o el documento salió por error. Por ejemplo:

- El cajero emitió la misma factura dos veces.

- Se generó una factura para un pedido que el cliente canceló antes de entregarse.

- El comprobante nunca llegó a manos del cliente.

### El plazo que no puedes pasar

Para facturas, tienes **siete días calendario** para enviar la baja, contados **desde el día siguiente a la recepción de la CDR aceptada**, no desde la fecha de emisión. Pasado ese plazo, SUNAT ya no admite la baja.

En una sola comunicación puedes incluir varios comprobantes, siempre que todos tengan la misma fecha de emisión.

### Paso a paso

- **Revisa la CDR.** Si el comprobante no está aceptado, no hay baja que hacer.

- **Calcula el plazo.** Toma la fecha de la CDR aceptada y cuenta siete días calendario desde el día siguiente.

- **Genera la comunicación de baja** en tu sistema, con el tipo de comprobante, la serie, el número y el motivo.

- **Envíala y espera su propia CDR.** El comprobante queda anulado recién cuando SUNAT acepta la baja.

- **Avísale al cliente,** sobre todo si ya registró la factura en sus compras. Si no lo sabe, tendrá una diferencia en su contabilidad.

- **Genera el documento correcto**, que llevará otro número. El anulado queda fuera de uso para siempre.

## Nota de crédito: cuando la venta existió y hay que corregirla

### En qué casos se usa

La **nota de crédito electrónica** (tipo 07) es un comprobante propio que se emite **al mismo cliente** del documento original y lo referencia. Sirve para revertir total o parcialmente una operación que sí ocurrió: una venta que se canceló, una devolución, un descuento acordado después o un dato mal consignado.

### Plazos

La nota de crédito **no tiene la ventana de siete días** de la baja: se emite cuando ocurre el hecho que la justifica, aunque sea semanas después. Lo que sí tiene plazo es el **envío**: si está vinculada a una factura, debe llegar a SUNAT o al OSE el mismo día de su emisión o, como máximo, en los **tres días calendario** siguientes. Si se envía después, pierde su calidad de nota electrónica.

### Paso a paso

- **Identifica el comprobante original:** tipo, serie y número.

- **Escoge el motivo** del catálogo de SUNAT que corresponde a lo que realmente pasó (tabla más abajo).

- **Emite la nota al mismo adquirente,** por el total o solo por la parte que debes revertir.

- **Envíala a tiempo** y guarda su CDR junto con el XML.

- **¿Hay que volver a vender?** Genera otra factura o boleta, esta vez con la información bien puesta.

### Motivos más usados del catálogo de SUNAT

SUNAT publica una tabla de códigos para el tipo de nota de crédito. Estos son los que más se usan en pequeños y medianos negocios:

| Código | Motivo | Ejemplo |
| --- | --- | --- |

| 01 | Anulación de la operación | El cliente desistió de la compra después de facturada |

| 02 | Anulación por error en el RUC | La factura salió a nombre de otra empresa |

| 03 | Corrección por error en la descripción | Se escribió “tubo 1/2” en lugar de “tubo 3/4” |

| 04 | Descuento global | Rebaja del 5 % sobre toda la factura, acordada luego |

| 05 | Descuento por ítem | Rebaja en un solo producto de la factura |

| 06 | Devolución total | El cliente devolvió todo el pedido |

| 07 | Devolución por ítem | El cliente devolvió solo algunos productos |

| 08 | Bonificación | Entregas mercadería adicional sin costo |

| 09 | Disminución en el valor | Ajuste a la baja del valor de la operación |

| 10 | Otros conceptos | Casos que no encajan en ningún otro motivo |

El catálogo tiene otros códigos para ajustes de exportación, operaciones con IVAP y correcciones del monto pendiente o de las fechas de pago. Consulta la última versión publicada por SUNAT antes de cargar los motivos en tu sistema: la tabla cambia cuando cambian las normas.

Un consejo: evita usar el código 10 como comodín. Es el que más observaciones genera en una revisión.

## Guía rápida: ¿qué vía me corresponde?

| Lo que pasó | Qué hacer |
| --- | --- |

| SUNAT rechazó la factura | Corregir y volver a emitir |

| Factura duplicada o por error, dentro de los 7 días desde la CDR | Comunicación de baja |

| Venta anulada, pero ya pasaron los 7 días | Nota de crédito con motivo 01 |

| RUC del cliente equivocado | Nota de crédito con motivo 02 y nueva factura |

| Descripción del producto o servicio errada | Nota de crédito con motivo 03 |

| Devolución de mercadería | Nota de crédito con motivo 06 o 07 |

| Descuento posterior a la venta | Nota de crédito con motivo 04 o 05 |

| Boleta emitida con error | Informarla como anulada en el resumen o emitir nota de crédito |

## El caso de las boletas de venta

Las boletas funcionan distinto porque no se envían una por una: se informan agrupadas en un **resumen diario**. Para anularlas:

- **Si la boleta aún no fue informada,** la anulación se comunica dentro de los **siete días calendario** que siguen a su emisión.

- **Si ya se informó en un resumen aceptado,** el plazo de **siete días calendario** se cuenta desde el día siguiente a la fecha de esa CDR.

En la práctica, la boleta se reporta en el resumen marcada como anulada. La pantalla y el nombre del documento varían según el sistema, pero los plazos son los mismos. ¿Vendes con boleta todo el día? Te explicamos cómo se arma ese resumen en la guía sobre la [boleta electrónica en Perú](https://www.sistemafacturacionperu.com/boleta-electronica/).

## Fallas comunes al anular

- **Contar los siete días desde la emisión.** Para la baja de facturas, el plazo corre desde el día siguiente a la CDR aceptada.

- **Dar de baja y olvidarse de emitir el comprobante correcto.** Si hubo venta, debe haber comprobante que la respalde.

- **Emitir la nota de crédito a otra persona o empresa.** Va siempre al mismo adquirente del comprobante original.

- **Reusar el número del comprobante anulado.** La numeración no se recicla.

- **Elegir mal el motivo.** Un error de RUC no se corrige como un error de descripción, y el tratamiento contable cambia.

- **Emitir la nota a tiempo, pero enviarla tarde.** Fuera de plazo, pierde su validez como nota electrónica.

- **Olvidar el impacto contable.** La nota se anota en tu registro de ventas y modifica el IGV del mes que corresponda. Coordínalo con tu contador antes del cierre.

## ¿Ya venció el plazo? Esto puedes hacer

Si pasaron los siete días para la comunicación de baja, esa opción ya no está disponible. Pero **la nota de crédito sí**, y es la vía habitual cuando el error aparece semanas después, por ejemplo al conciliar el mes con el contador.

Si el periodo ya fue declarado, la corrección puede requerir una **declaración rectificatoria**. En esos casos, consúltalo con tu contador y, si tienes dudas sobre un caso específico, confirma el procedimiento vigente con SUNAT.

La lección es sencilla: **siempre es más fácil emitir bien que anular después**. Validar el RUC antes de emitir, revisar el monto junto al cliente y trabajar con un sistema que valide la información antes del envío evita la mayoría de anulaciones.

## Corrige comprobantes sin complicarte con Sistema Facturación Perú

En nuestro [sistema de facturación electrónica](https://www.sistemafacturacionperu.com/sistema-facturacion-electronica/), las bajas, los resúmenes diarios y las notas de crédito o débito salen del mismo panel donde emitiste el comprobante. Seleccionas el documento original, marcas el motivo y la plataforma prepara el XML, lo firma, lo envía y guarda la CDR en la nube. Para evitar errores desde la primera emisión, repasa todo lo que lleva una [factura electrónica en Perú](https://www.sistemafacturacionperu.com/factura-electronica/).

¿Arrastras comprobantes mal emitidos y no sabes por cuál empezar? [Escríbenos con tu caso](https://www.sistemafacturacionperu.com/contacto/) y revisamos contigo, dentro del sistema, qué corresponde hacer con cada uno. También puedes comparar los planes en la página de [precios](https://www.sistemafacturacionperu.com/precios/).

---

# OSE, PSE o envío directo a SUNAT: qué ruta usar en tu sistema de facturación

URL: https://www.sistemafacturacionperu.com/blog/diferencia-ose-pse-sunat/
Publicado: 2026-09-16 · Categoría: Facturación electrónica

Quién valida, quién firma y de quién dependes en cada modalidad de emisión electrónica. Aprende cuándo necesitas certificado y qué ruta conviene a tu negocio.

Don Julio tiene una ferretería en Trujillo. Hace unas semanas cambió de sistema de facturación electrónica y, en la llamada de configuración, le preguntaron: «¿Va a emitir directo, con OSE o con PSE?». Se quedó en silencio. Nadie le había explicado que su comprobante puede llegar a SUNAT por **tres caminos distintos**, y que elegir uno u otro cambia cosas muy prácticas.

Esas cosas son tres: **qué tan rápido recibes la constancia de SUNAT**, **qué haces si el servicio no responde** y **si debes tramitar un certificado digital**. En esta guía las vemos una por una, con ejemplos de negocios peruanos, para que la próxima vez respondas sin dudar.

## Antes de comparar: el viaje de un comprobante electrónico

Toda factura o boleta electrónica sigue el mismo recorrido, sin importar la ruta:

- **Se genera un archivo XML** con el formato que exige SUNAT (UBL 2.1). Ese archivo es el comprobante; el PDF es solo su representación impresa.

- **Se firma digitalmente**, para que nadie pueda alterarlo después.

- **Alguien lo valida**: revisa que el RUC exista, que los montos cuadren, que la serie sea correcta y que se respeten las reglas de emisión.

- **Se devuelve una CDR** (constancia de recepción). Con ella el comprobante queda aceptado y tiene validez tributaria.

Lo que cambia entre una modalidad y otra es **quién firma** (paso 2) y **quién valida** (paso 3). Con eso en mente, todo lo demás se entiende solo.

## Ruta 1: tu comprobante va directo a SUNAT

Aquí no hay intermediarios en la validación. El comprobante sale de tu lado, SUNAT lo revisa y te contesta con la CDR.

### Dos formas muy diferentes de hacerlo

- **Emitir en el portal de SUNAT con tu Clave SOL.** Entras a la web, llenas el formulario y listo. No pagas nada y no necesitas certificado propio, porque SUNAT se encarga de la firma. El inconveniente es el día a día: cada comprobante se digita a mano, no descuenta tu stock, no cuadra tu caja y no te arma reportes. Para una consultora con cinco facturas al mes puede bastar; para una tienda con cola en el mostrador, no.

- **Emitir desde un sistema que se conecta a SUNAT.** Tu software arma el XML, le aplica la firma de **tu certificado digital** y lo manda automáticamente. Aquí el certificado es obligatorio.

### Lo que ganas y lo que arriesgas

| A favor | En contra |
| --- | --- |

| No pagas a un tercero por cada validación | En días de alta carga (cierre de mes, campañas) la respuesta de SUNAT puede demorar |

| Relación directa con la administración tributaria | Tus comprobantes pueden quedar «pendientes» hasta que el servicio responda |

| Ruta sencilla de entender | La integración técnica recae en ti o en tu proveedor de software |

## Ruta 2: un OSE valida por encargo de SUNAT

**OSE** significa **Operador de Servicios Electrónicos**. Es una empresa que SUNAT autoriza e inscribe en su registro para que haga la comprobación informática de los comprobantes en su lugar.

¿Cómo funciona en la práctica? Tu sistema sigue armando y firmando el XML con tu certificado, igual que en la ruta directa. La diferencia es el destinatario: el comprobante va al operador, este revisa que cumpla las condiciones de emisión y, si todo está bien, te entrega la CDR. Recién después el OSE informa a SUNAT lo que comprobó, y para eso la norma le da **como máximo una hora** desde la comprobación.

En otras palabras: **tú sigues siendo el que firma; el OSE es el que revisa**.

**Por qué muchos negocios lo eligen:** la validación suele ser más rápida y constante, también en horas punta. Varios operadores añaden consultas, alertas y respaldo de tus XML.

**Lo que debes considerar:** es un servicio contratado, normalmente con costo por volumen o por plan, y su disponibilidad pasa a ser parte de tu operación. Para trabajar con un OSE tienes que **designarlo desde SUNAT Operaciones en Línea** con tu Clave SOL.

## Ruta 3: un PSE emite en tu nombre

**PSE** es el **Proveedor de Servicios Electrónicos**. También figura en un registro de SUNAT, pero su papel es otro: te presta el servicio de hacer, **por encargo tuyo**, una parte o todas las tareas de emisión. Puede generar el XML, firmarlo y enviarlo por ti.

La pregunta clave con un PSE es **con qué certificado firma**. Muchos firman con el suyo propio, lo que te ahorra tramitar uno; otros trabajan con el tuyo. Pregúntalo por escrito antes de firmar contrato.

**Por qué conviene:** es la opción más cómoda si no quieres saber nada de certificados, renovaciones ni configuraciones técnicas.

**Lo que no se delega:** el contenido del comprobante. Si el PSE emite una factura con un monto equivocado porque tú lo digitaste así, **la responsabilidad tributaria sigue siendo tuya**. El PSE ejecuta; tú respondes por lo que se factura. Igual que con el OSE, la autorización se hace con tu Clave SOL en el portal de SUNAT.

## ¿OSE y PSE se excluyen? No

Es una confusión muy común. El PSE se ocupa de **emitir**; el OSE, de **validar**. Por eso pueden convivir: un PSE puede emitir tus comprobantes en tu nombre y enviarlos a un OSE para su comprobación, o enviarlos directamente a SUNAT. Son piezas de una misma cadena, no alternativas que compiten entre sí.

## Las tres rutas, una al lado de la otra

| Pregunta | Directo a SUNAT | Con OSE | Con PSE |
| --- | --- | --- | --- |

| ¿Quién firma el XML? | Tú (o SUNAT, si usas el portal SOL) | Tú | El PSE, por encargo tuyo |

| ¿Quién entrega la CDR? | SUNAT | El OSE | SUNAT o el OSE, según cómo trabaje el proveedor |

| ¿Necesitas certificado propio? | Sí, salvo en el portal SOL | Sí | Depende del proveedor; muchas veces no |

| ¿Hay un costo extra? | No por la validación | Sí, por volumen o plan | Suele estar incluido en el servicio |

| ¿Qué tan rápida es la respuesta? | Varía con la carga de SUNAT | Por lo general rápida y estable | Según la infraestructura del proveedor |

| ¿Quién responde por el contenido? | Tú | Tú | Tú |

| ¿Dónde se autoriza? | No requiere designación | Designación en SUNAT Operaciones en Línea | Autorización en SUNAT Operaciones en Línea |

## El certificado digital, sin vueltas

Regla práctica: **si el comprobante sale firmado por ti, necesitas certificado**. Eso pasa cuando emites desde tu propio sistema directo a SUNAT, cuando usas el Facturador SUNAT instalado en tu computadora y cuando trabajas con un OSE.

**No lo necesitas** cuando emites en el portal SOL o cuando tu PSE firma con su propio certificado.

Si te toca tenerlo, hay dos caminos:

- **Comprarlo a una entidad certificadora** acreditada. Tiene costo y una vigencia que eliges al contratarlo (uno, dos o tres años, por ejemplo).

- **Solicitar el Certificado Digital Tributario (CDT) de SUNAT**, que es gratuito, se pide con RUC y Clave SOL y sirve solo para firmar comprobantes y documentos electrónicos. Está pensado para cierto grupo de contribuyentes y tiene vigencia limitada, así que revisa en el portal de SUNAT si calificas y cuáles son las condiciones actuales antes de tramitarlo.

En cualquiera de los dos casos, **anota la fecha de vencimiento en tu calendario**. Cuando un certificado caduca, todos los comprobantes que firmes desde ese momento serán rechazados, y te enteras recién cuando un cliente reclama.

## Tres negocios, tres decisiones

**Una bodega en Arequipa que emite unas 30 boletas al día.** El volumen es manejable y el margen es ajustado. Le conviene ir **directo a SUNAT** desde un sistema que envíe solo los comprobantes, o usar un **PSE** si prefiere no gestionar el certificado. Lo importante es que la emisión no frene la venta en el mostrador.

**Una pollería en Piura con tres cajas y delivery.** Los viernes y sábados por la noche emite cientos de comprobantes en pocas horas. Aquí un **OSE** empieza a pagar su costo: respuestas rápidas en los picos y menos comprobantes acumulados en espera.

**Una distribuidora en Lima que factura a bodegas y minimarkets todo el día.** Si un día sin facturar significa camiones parados, no basta con una sola ruta. Necesita un sistema que permita **cambiar de modalidad sin migrar**, con el historial y las series intactas, para no depender de un único servicio.

## Lo que no cambia, elijas la ruta que elijas

- **Los plazos de envío son los mismos.** La factura electrónica debe enviarse en la fecha de emisión y, como máximo, dentro de los tres días calendario contados desde el día siguiente. Las boletas también tienen un plazo corto, ya sea con envío individual o mediante el resumen diario. Pasarte del plazo trae el mismo problema por cualquier camino.

- **La responsabilidad es tuya.** Ni el OSE ni el PSE asumen lo que declaras en tus comprobantes.

- **Debes poder mostrar tus comprobantes.** Guarda el XML y la CDR de cada documento, o asegúrate de que tu sistema los conserve por ti, porque SUNAT o un cliente pueden pedírtelos tiempo después.

## Cómo saber qué ruta usas hoy

Si ya emites y no tienes claro por dónde viajan tus comprobantes, haz esta revisión en diez minutos:

- **Busca si alguna vez subiste un archivo .pfx o .p12** al configurar tu sistema. Si lo hiciste, firmas tú: estás en la ruta directa o con OSE.

- **Entra a SUNAT Operaciones en Línea** y revisa si designaste un OSE o autorizaste un PSE. Esas altas quedan registradas ahí.

- **Compara con los registros públicos** de OSE y PSE que publica SUNAT. Si tu proveedor dice ser uno de ellos y no figura, pide una explicación.

- **Pregunta a tu proveedor de software** y pide la respuesta por escrito, junto con la fecha de vencimiento de tu certificado si aplica.

## Elige la ruta y cámbiala cuando quieras con Sistema Facturación Perú

En [Sistema Facturación Perú](https://www.sistemafacturacionperu.com/sistema-facturacion-electronica/) no tienes que quedarte amarrado a una sola modalidad. El sistema envía tus comprobantes **directo a SUNAT, por un OSE o mediante un PSE**, y guarda en la nube el XML firmado y la CDR de cada documento, listos para consultar o reenviar.

Si un día tu operador cambia sus tarifas o tu proveedor deja de responder, ajustas la configuración y sigues facturando con las mismas series, los mismos clientes y todo tu historial. Además de facturas y boletas, emites notas de crédito y débito, guías de remisión y comunicaciones de baja desde el mismo panel.

Desde el Plan Básico (S/ 49 + IGV mensuales) ya tienes la facturación electrónica, y ningún plan te amarra con contratos forzosos. Revisa lo que trae cada plan en la [página de precios](https://www.sistemafacturacionperu.com/precios/) o resuelve tus dudas en las [preguntas frecuentes](https://www.sistemafacturacionperu.com/preguntas-frecuentes/).

¿Todavía no sabes qué ruta te conviene? [Cuéntanos cómo vendes](https://www.sistemafacturacionperu.com/contacto/) y, según tu volumen de comprobantes, te recomendamos la modalidad y te ayudamos a dejarla configurada.

---

# Sistema POS en Perú: qué es, cómo funciona y cómo elegirlo

URL: https://www.sistemafacturacionperu.com/blog/que-es-un-sistema-pos/
Publicado: 2026-09-15 · Actualizado: 2026-10-27 · Categoría: Punto de venta

Qué es un sistema POS, qué hace en cada venta y qué funciones necesita tu bodega, restaurante o ferretería en Perú para cobrar rápido y emitir a SUNAT.

**POS** viene de *Point of Sale*, que en español es simplemente **punto de venta**: el lugar y el momento en que tu cliente paga. Un **sistema POS** es el programa con el que registras esa venta, recibes el pago y emites el comprobante. Hasta ahí, nada nuevo. La diferencia de un POS actual está en lo que pasa después del cobro: el stock baja solo, la caja queda cuadrada, la boleta llega al cliente por WhatsApp y tú puedes ver desde el celular cómo va el día.

En esta guía verás de qué se compone un sistema POS, cómo trabaja en una venta real, qué funciones necesita cada tipo de negocio en el Perú y qué revisar antes de contratar uno.

## Caja registradora vs. sistema POS

La caja registradora suma, imprime y guarda dinero. Un sistema POS conecta la venta con el resto del negocio.

|  | Caja registradora | Sistema POS en la nube |
| --- | --- | --- |

| Registra el importe | Sí | Sí, con detalle de cada producto |

| Descuenta stock | No | Sí, en el mismo cobro |

| Emite boleta o factura electrónica | No | Sí, con envío a SUNAT |

| Controla turnos y cajeros | Limitado | Apertura, cierre y arqueo por usuario |

| Guarda datos del cliente | No | Historial de compras y créditos |

| Reportes | Total del día | Ventas por hora, producto, vendedor y utilidad |

| Consulta remota | No | Desde el celular o cualquier navegador |

Resumido: con la caja registradora sabes **cuánto** entró. Con un POS sabes además **qué** salió, **quién** lo compró, **cuánto margen** dejó y **cuánto stock** te queda.

## Las partes de un sistema POS

### El software

Es el corazón: la pantalla de venta, el catálogo de productos, la caja, los clientes, los reportes y la conexión con SUNAT. Si está en la nube, no lo instalas en una sola computadora; entras desde una PC, una tablet o un celular con internet.

### El hardware

Lo que acompaña al software en el mostrador:

- **Ticketera** térmica de 80 o 58 mm para imprimir boletas y tickets.

- **Lector de código de barras**, para no buscar productos a mano.

- **Gaveta de dinero**, que se abre al registrar un cobro en efectivo.

- **Balanza**, en negocios que venden por peso, como fruterías o carnicerías.

No todos los negocios necesitan todo. Una peluquería puede trabajar solo con una tablet; un minimarket con alto movimiento querrá lector y ticketera desde el primer día.

## Una venta paso a paso

Imagina una pollería en Los Olivos a la hora del almuerzo:

- **Se registra el pedido.** El cajero elige «1/4 de pollo con papas» y una gaseosa de 500 ml. El sistema calcula el total con IGV.

- **Se cobra.** El cliente paga una parte en efectivo y el resto con tarjeta; el POS registra el pago mixto en una sola operación.

- **Sale el comprobante.** Se genera la boleta electrónica, se firma y se envía a SUNAT, directamente o por medio de un OSE o PSE, y el sistema guarda la constancia de recepción (CDR).

- **Se entrega.** Ticket impreso, mensaje de WhatsApp, correo o un código QR para descargarla.

- **Se actualiza todo lo demás.** El stock de gaseosas baja en uno, la caja del turno suma el ingreso y el reporte del día se mueve. Nadie tuvo que anotar nada aparte.

Como la información vive en la nube, la dueña puede revisar las ventas del almuerzo desde su casa sin llamar al local.

## Funciones que un POS debe traer en el Perú

### Cumplimiento con SUNAT

- **Facturación electrónica integrada**: boletas, facturas, notas de crédito y resúmenes diarios generados de forma automática.

- **Consulta de RUC y DNI** para completar los datos del cliente sin digitarlos.

- Recuerda que una boleta por más de **S/ 700** debe identificar al comprador; un buen POS te lo pide antes de emitir.

### Control de la mercadería

- **Inventario y kardex** con stock mínimo y alertas de reposición. Si quieres profundizar, revisa cómo [controlar el inventario en tiempo real](https://www.sistemafacturacionperu.com/blog/como-controlar-inventario-en-tiempo-real/).

- Ingreso de compras para que el stock suba con cada factura de proveedor.

### Caja y cobros

- **Varios medios de pago** y pagos mixtos en una misma venta.

- Apertura y **cierre de caja con arqueo**, por turno y por cajero.

- Registro de egresos de caja chica (el pasaje del repartidor, el gas del día).

### Equipo y crecimiento

- **Multiusuario** con roles y permisos: el cajero cobra, pero no cambia precios.

- **Multisucursal**, para ver todos los locales en un solo panel.

- Funcionamiento desde cualquier dispositivo, sin instalaciones complicadas.

## Qué necesita cada rubro

| Rubro | Funciones que marcan la diferencia |
| --- | --- |

| Restaurante o pollería | Mesas, comandas a cocina, división de cuentas. Más ideas en [inventario para restaurantes](https://www.sistemafacturacionperu.com/blog/inventario-para-restaurantes/) |

| Bodega o minimarket | Lector de código de barras, venta rápida, alertas de stock mínimo |

| Farmacia o botica | Control de lotes y fechas de vencimiento |

| Ferretería | Presentaciones y unidades (por unidad, caja, metro o kilo) |

| Boutique o zapatería | Variantes de talla y color |

| Distribuidora | Precios por volumen, ventas al crédito y guías de remisión |

Al pedir una demostración, pide que te muestren justamente las funciones de tu rubro, no la presentación general.

## Lo que ganas al usar un POS

- **Atención más rápida.** Con lector y catálogo, una venta de diez productos se resuelve en segundos y la cola avanza.

- **Menos faltantes y menos sobrantes.** Sabes qué rota, qué está parado y cuándo reponer.

- **Cumplimiento sin trabajo extra.** El comprobante electrónico sale en el mismo cobro.

- **Decisiones con datos.** Ves qué productos te dejan más margen, en qué horario vendes más y qué vendedor rinde mejor. Profundizamos en los [beneficios de un POS para negocios](https://www.sistemafacturacionperu.com/blog/beneficios-de-un-pos-para-negocios/).

- **Menos pérdidas.** Cada descuento, anulación o movimiento de caja queda registrado con el usuario que lo hizo.

## ¿Cuánto cuesta?

Depende de las funciones y del volumen de tu negocio. En **Sistema Facturación Perú**, el [sistema POS](https://www.sistemafacturacionperu.com/sistema-pos/), la caja y el inventario vienen en **todos los planes**, desde **S/ 37 mensuales en tarifa anual (más IGV)**, con soporte incluido y sin contratos forzosos.

Un detalle importante: ese primer plan, el **Plan Básico**, ya manda a SUNAT tus boletas y facturas electrónicas desde el POS, para 3 usuarios en un local y con 300 comprobantes mensuales como tope. Si necesitas más cajeros o locales, el **Plan PRO (S/ 149 + IGV al mes)** trae 10 usuarios y 3 locales sin tope de comprobantes, y el **Plan Empresa** no tiene límite. Compara todo en [planes y precios](https://www.sistemafacturacionperu.com/precios/).

## Cómo elegir tu sistema POS en cinco pasos

- **Describe cómo vendes.** ¿Atiendes en mesa? ¿Vendes por kilo o por metro? ¿Manejas vencimientos? ¿Das crédito a clientes?

- **Comprueba la conexión con SUNAT.** Pregunta cómo se envían los comprobantes, dónde se guardan el XML y el CDR y qué pasa si SUNAT no responde.

- **Pide una demostración con tus productos.** Lleva diez artículos reales de tu negocio y simula una venta completa.

- **Aclara el soporte.** Horarios, canales y si la capacitación tiene costo.

- **Piensa en el próximo año.** Que puedas sumar usuarios, cajas y sucursales sin cambiar de sistema.

### Errores frecuentes al elegir

- Elegir solo por precio y descubrir después que el inventario se cobra aparte.

- Comprar hardware antes de confirmar que el sistema lo reconoce.

- No probar el cierre de caja, que es donde más tiempo se pierde cada noche.

## Pon tu punto de venta en marcha

Un buen sistema POS convierte cada cobro en información útil: stock al día, caja cuadrada y comprobantes en regla, sin trabajo adicional.

Si quieres ver cómo funcionaría con tu catálogo y tu forma de vender, [solicita una demostración gratuita](https://www.sistemafacturacionperu.com/contacto/) y te mostramos el sistema POS de Sistema Facturación Perú funcionando con los productos de tu negocio.

---

# Certificado digital SUNAT: ¿tu sistema de facturación lo pide?

URL: https://www.sistemafacturacionperu.com/blog/certificado-digital-sunat/
Publicado: 2026-09-10 · Categoría: Facturación electrónica

Descubre si tu sistema de facturación necesita certificado digital, cómo pedir gratis el CDT de SUNAT, cuánto cuesta uno pagado y qué hacer antes de que venza.

Rosa tiene una librería en Cusco y decidió dejar los talonarios. Llamó a dos proveedores y los dos le dijeron lo mismo: “Primero compra tu certificado digital”. Uno le cotizó S/ 250 y otro casi S/ 300. Antes de pagar, se hizo la pregunta correcta: ¿de verdad lo necesito?

La respuesta depende de **qué sistema usas para emitir y quién pone la firma en tus comprobantes**. No depende de tu tamaño ni de cuánto facturas. En esta guía verás en qué casos te piden certificado, en cuáles no, cómo obtener sin costo el que entrega SUNAT y qué revisar si al final decides comprar uno.

## El certificado digital, explicado sin tecnicismos

Imagina un sello notarial, pero en forma de archivo. El certificado digital es un **archivo electrónico** (generalmente con extensión .pfx o .p12) protegido por una contraseña, que sirve para **firmar tus comprobantes** y demostrar que salieron de tu RUC.

Conviene separar tres cosas que se suelen mezclar:

| Elemento | Para qué sirve | ¿Reemplaza al certificado? |
| --- | --- | --- |

| Clave SOL | Ingresar a los servicios en línea de SUNAT | No |

| Calidad de emisor electrónico | Estar habilitado ante SUNAT para emitir | No |

| Certificado digital | Firmar cada XML que generas | Es el propio certificado |

En otras palabras: la Clave SOL abre la puerta del portal, la afiliación te habilita y el certificado pone la firma. Son piezas distintas.

Los certificados válidos los emiten **entidades de certificación** inscritas en el registro de prestadores que administra INDECOPI. SUNAT remite a esa misma lista.

## Qué hace la firma dentro de tu comprobante

Toda factura o boleta electrónica es, en el fondo, un **XML** con la estructura que define SUNAT. Antes de enviarlo, el sistema le aplica la firma digital con tu certificado. Esa firma garantiza tres cosas:

- **Origen:** prueba que el comprobante lo generó tu empresa.

- **Integridad:** si alguien altera un monto o una fecha después de firmar, la validación falla.

- **Responsabilidad:** no puedes desconocer luego un comprobante que firmaste.

Un solo certificado alcanza para todo: con él firmas tus facturas y boletas, las notas de crédito o débito, las guías de remisión y también los resúmenes diarios y las bajas.

## ¿Te toca tener certificado propio? Depende de cómo emites

Esta es la pregunta clave. Revisa en qué fila estás:

| Forma de emisión | ¿Certificado propio? | ¿Quién firma? |
| --- | --- | --- |

| Portal SOL (SEE-SOL) | No | SUNAT, sobre lo que generas en el portal |

| Facturador SUNAT (SFS) | Sí | Tu empresa, con el certificado instalado en tu PC |

| Sistema del contribuyente, envío directo | Sí | Tu empresa, desde el sistema |

| Sistema con envío por OSE | Sí | Tu empresa; el OSE valida pero no firma |

| Sistema con PSE | Por lo general no | El PSE, en tu nombre |

Dos casos merecen una explicación aparte.

### Portal SOL: sin certificado, pero con límites

Emitir desde el portal de SUNAT no cuesta nada y no requiere certificado, porque SUNAT firma lo que se genera ahí. El problema aparece en el día a día: cada comprobante se llena a mano y no se conecta con tu caja, tu stock ni tus reportes. Para una botica en Piura que emite decenas de boletas diarias, eso se vuelve inviable muy rápido.

### PSE: el proveedor firma por ti

El **Proveedor de Servicios Electrónicos (PSE)** puede encargarse de la emisión en tu nombre y, en la mayoría de casos, firma con su propio certificado. Por eso muchos pequeños negocios nunca compran uno. Pero no todos los PSE trabajan igual: **pregúntalo por escrito antes de contratar**. Si te confunden las siglas, tenemos una guía sobre la [diferencia entre OSE, PSE y SUNAT](https://www.sistemafacturacionperu.com/blog/diferencia-ose-pse-sunat/).

## La opción gratuita: el Certificado Digital Tributario (CDT)

Mucha gente no sabe que SUNAT entrega un certificado **sin costo**, llamado **Certificado Digital Tributario (CDT)**. Antes de pagar por uno, revisa si calificas.

### Para qué sirve

Solo para una cosa: **firmar digitalmente comprobantes de pago electrónicos** y documentos relacionados del sistema de emisión electrónica. No lo puedes usar para firmar contratos, cartas ni otros documentos.

### Quién lo puede solicitar

Está pensado para contribuyentes que generan **rentas de tercera categoría**, sea en el Régimen Especial (RER), el Régimen MYPE Tributario, el Régimen General o el Régimen Agrario. Al tramitarlo, SUNAT revisa, entre otros puntos, que:

- Si eres persona natural, tengas plena capacidad de ejercicio; si eres empresa, que exista y esté vigente.

- Tu RUC no esté dado de baja ni con suspensión temporal de actividades.

- Tu domicilio fiscal no figure como **no habido**.

### Cómo se tramita

- Ingresa a **SUNAT Operaciones en Línea** con tu RUC y tu Clave SOL.

- Busca la opción del certificado dentro del menú de comprobantes de pago.

- Envía la solicitud y espera la aprobación.

- Descarga el certificado desde tu **Buzón SOL** y define allí la contraseña de la clave privada.

### Vigencia y disponibilidad

SUNAT señala una **vigencia de tres años** para el CDT. Además, según la normativa vigente, SUNAT puede facilitar su obtención **hasta el 31 de diciembre de 2027**. Como estas fechas se han prorrogado antes, confirma la información actualizada en el portal de SUNAT al momento de pedirlo.

### Antes de solicitarlo, ten en cuenta

- Los requisitos se han ajustado varias veces. Léelos en la sección de comprobantes electrónicos de SUNAT el mismo día que hagas el trámite.

- Anota la contraseña en un lugar seguro. Un certificado sin su clave no sirve para nada.

- Haz una copia del archivo fuera de la computadora donde lo instalaste.

## Si vas a comprar un certificado, revisa esto

Puede que no califiques para el CDT o que quieras un certificado sin restricciones de uso. En ese caso, compara con esta lista:

- **¿Qué entidad lo emite?** Muchos vendedores son revendedores. Pregunta cuál es la entidad de certificación real y verifica que esté acreditada ante INDECOPI. Ese nombre aparece dentro del certificado.

- **¿Es el tipo correcto?** Un certificado de persona natural vinculado a tu DNI no es lo mismo que uno para **facturación electrónica vinculado a tu RUC**. Comprar el equivocado es plata perdida.

- **¿Cuántos años cubre?** Se venden por uno, dos o tres años. A mayor plazo, menor costo anual, y te evitas repetir cada año la validación de identidad.

- **¿Qué soporte incluye?** Pregunta cuánto tarda la validación, si el vendedor lo configura contigo en tu software y qué ocurre si pierdes el archivo o la contraseña.

## Precios de referencia en Perú

Estos montos son **precios publicados en las webs de cada proveedor, revisados en setiembre de 2026**. Cambian seguido y suele haber ofertas, así que confírmalos antes de pagar.

| Vigencia | Llama.pe, certificado para facturación (con IGV) | Acepta Perú | Factura Perú, archivo .pfx (con IGV) | Factura Perú, archivo .pem (con IGV) |
| --- | --- | --- | --- | --- |

| Un año | S/ 295 | S/ 236 | S/ 250 | S/ 118 |

| Dos años | S/ 501.50 | S/ 490 | S/ 500 | S/ 224.20 |

| Tres años | S/ 708 | S/ 490 | S/ 708 | S/ 318.60 |

De dónde salen los datos: webs de Llama.pe, Acepta (acepta.com/pe) y Factura Perú (facturaperu.com.pe), revisadas en setiembre de 2026. En el caso de Acepta, su web no indica si el precio incluye IGV. La tabla no recomienda a ningún proveedor; solo te da una base para saber si una cotización está en rango.

Ponlo en perspectiva: con lo que cuesta un certificado pagado podrías cubrir varios meses de suscripción a un sistema de facturación. Antes de gastar, descarta las dos alternativas sin costo extra: el CDT de SUNAT y un PSE que se encargue de la firma.

## El día que el certificado vence

Es un problema que no avisa. Todo funciona bien hasta que, de pronto, ningún comprobante pasa.

- **SUNAT rechaza cualquier XML firmado con un certificado vencido.** No hay días de tolerancia.

- **El bloqueo es total:** no falla un comprobante aislado, fallan todos hasta que instales el nuevo.

- **Lo emitido antes sigue vigente.** Los comprobantes aceptados mientras el certificado estaba activo no pierden validez.

- **La renovación no es inmediata,** porque vuelve a pedirse la validación de identidad.

Un hábito sencillo evita el susto: agenda la fecha de vencimiento en tu celular con una alarma **30 días antes**. Así renuevas con calma y no un viernes de quincena con la caja llena de clientes.

## ¿Certificado propio, CDT o PSE? Cómo decidir

| Tu situación | Opción que suele convenir |
| --- | --- |

| Emites desde un sistema propio o por OSE y quieres control total | Certificado propio (comprado o CDT) |

| Necesitas firmar también contratos u otros documentos | Certificado comprado; el CDT no sirve para eso |

| No quieres lidiar con archivos, claves ni renovaciones | PSE que firme por ti |

| Recién empiezas y calificas | CDT gratuito de SUNAT |

Para la mayoría de bodegas, restaurantes, talleres y ferreterías, un PSE que firme por ti es la ruta más sencilla. Y si calificas, empezar con el CDT y decidir después es una alternativa perfectamente razonable.

## Cómo lo resuelve Sistema Facturación Perú

En nuestro [sistema de facturación electrónica](https://www.sistemafacturacionperu.com/sistema-facturacion-electronica/) eliges la modalidad que te acomode: **envío directo a SUNAT con tu certificado, por OSE o por PSE autorizado** (entre ellos SendFact, QPSE, ContaWeb A&M, Validapse y Gior Technology). Si más adelante quieres cambiar, lo configuras en el mismo sistema, sin perder series ni historial.

Cada comprobante guarda su XML firmado y su CDR en la nube, y el panel te indica en qué estado quedó: aceptado, observado, rechazado o pendiente. La emisión electrónica viene desde el **Plan Básico, de S/ 49 al mes más IGV**; revisa todos los detalles en la página de [precios](https://www.sistemafacturacionperu.com/precios/).

¿No sabes si te conviene comprar un certificado? [Escríbenos](https://www.sistemafacturacionperu.com/contacto/) y revisamos tu caso: te diremos si te basta con el CDT, si conviene un PSE o si realmente necesitas comprar uno.

---

# Sistema de inventario para restaurantes: recetas, mermas y costo real por plato

URL: https://www.sistemafacturacionperu.com/blog/inventario-para-restaurantes/
Publicado: 2026-09-03 · Actualizado: 2026-10-27 · Categoría: Inventario

Arma la receta de cada plato, mide mermas y rendimientos y calcula tu food cost con un ejemplo en soles. Así sabrás cuánto te deja de verdad cada venta.

Martín abrió una cevichería en Chiclayo hace dos años. Los fines de semana no hay mesa libre, la caja cierra con buenos números y, aun así, a fin de mes la cuenta del banco no refleja ese movimiento. No le roban la caja. Lo que pasa es más silencioso: la plata se le va **entre la balanza del mercado y el plato que sale a la mesa**.

Si tienes un restaurante, una pollería, una cevichería o un menú, esta guía es para ti. Vamos a ver dónde se escapa el dinero en una cocina, cómo armar la ficha de cada plato, cómo calcular el costo real con un ejemplo en soles y qué rutinas de compra, merma y conteo te devuelven el control.

## Por dónde se escapa la plata en una cocina

Antes de hablar de sistemas, ubica las fugas. En casi todos los restaurantes aparecen las mismas cinco:

- **El rendimiento que nadie mide.** Compras pescado entero y vendes filete. Lo que queda en cabeza, espinas y piel también lo pagaste.

- **Las porciones «a ojo».** Un cocinero sirve 200 g de pescado y otro 260 g. El precio de carta es el mismo.

- **Los insumos que se vencen.** Mariscos, lácteos y verduras tienen días contados. Lo que se bota es margen que desaparece.

- **El consumo que no pasa por caja.** Almuerzo del personal, cortesías, pruebas de un plato nuevo, platos devueltos.

- **Los precios que suben y la carta que no se entera.** El limón puede duplicar su precio en pocas semanas y tu carta sigue igual.

Ninguna de estas fugas aparece en el reporte de ventas. Por eso necesitas un inventario que piense como cocina, no como tienda.

## Tienda y cocina no se controlan igual

|  | Tienda o bodega | Restaurante |
| --- | --- | --- |

| Qué compras | El mismo producto que vendes | Insumos que se transforman |

| Qué vendes | Unidades (una gaseosa, un paquete de arroz) | Platos hechos con varios insumos |

| Cómo baja el stock | Una unidad por venta | Gramos y mililitros de cada insumo de la receta |

| Merma | Ocasional (robo, rotura) | Parte del proceso (limpieza, cocción, porcionado) |

| Vencimiento | Importante en algunos rubros | Crítico casi siempre |

| Frecuencia de compra | Semanal o quincenal | Diaria o interdiaria |

La conclusión: si tu sistema descuenta «1 ceviche» del inventario, no te sirve. Necesita saber qué insumos y cuántos gramos lleva cada ceviche.

## La ficha técnica de cada plato

La ficha técnica (en costos se le llama **escandallo** o receta estándar) es el documento que une tu carta con tu almacén. Para cada plato registra:

| Columna | Para qué sirve |
| --- | --- |

| Insumo | Qué ingrediente lleva el plato |

| Unidad | Gramos, mililitros o unidades, según cómo lo uses |

| Cantidad neta | Lo que efectivamente llega al plato |

| Rendimiento | Qué porcentaje del insumo comprado es aprovechable |

| Cantidad bruta | Lo que tienes que comprar para obtener la cantidad neta |

| Costo | Lo que te cuesta esa cantidad, según tu última compra |

Cuando la ficha está cargada en el sistema, cada venta descuenta del almacén los gramos exactos de cada insumo. El stock baja al ritmo real de la cocina y puedes comparar lo que **debió** consumirse con lo que **realmente** falta.

### Preparaciones base o subrecetas

La leche de tigre, el ají amarillo licuado, la salsa criolla o la chicha morada se preparan en cantidad y luego se reparten en muchos platos. Trátalas como subrecetas: una ficha que consume insumos al prepararse y que, a su vez, se usa como insumo en otros platos. Así no pierdes de vista cuánto limón se fue en la olla de leche de tigre del sábado.

## Ejemplo con números: un ceviche en Chiclayo

Martín vende su ceviche clásico a **S/ 35 con IGV incluido**. Arma la ficha con los precios del mercado de esta semana y, en un primer intento, usa el precio del pescado entero tal como lo compra:

| Insumo | Cantidad neta | Precio de compra | Costo en el plato |
| --- | --- | --- | --- |

| Pescado (comprado entero) | 220 g | S/ 18.00 / kg | S/ 3.96 |

| Limón | 250 g | S/ 6.00 / kg | S/ 1.50 |

| Cebolla roja | 70 g | S/ 3.20 / kg | S/ 0.22 |

| Camote | 120 g | S/ 3.00 / kg | S/ 0.36 |

| Choclo | 100 g | S/ 4.00 / kg | S/ 0.40 |

| Cancha | 30 g | S/ 10.00 / kg | S/ 0.30 |

| Ají limo, culantro, ajo y sal | — | — | S/ 0.45 |

| Lechuga y guarnición | — | — | S/ 0.25 |

| **Total de insumos** |  |  | **S/ 7.44** |

Para calcular el margen, primero separa el impuesto, porque el precio de carta lo incluye:

- **Precio de carta:** S/ 35.00

- **Venta sin IGV** (35 ÷ 1.18): **S/ 29.66**

- **Costo de insumos:** S/ 7.44

- **Margen bruto:** S/ 22.22

- **Food cost** (costo ÷ venta sin IGV): **25 %**

Un 25 % se ve excelente. El problema es que ese número es falso.

### El rendimiento del pescado lo cambia todo

Martín compra el pescado entero a S/ 18 el kilo, pero después de filetearlo solo le queda alrededor del **55 %** aprovechable. Entonces, cada kilo de filete le cuesta en realidad 18 ÷ 0.55 = **S/ 32.73**.

Con ese costo, los 220 g de pescado del plato pasan de S/ 3.96 a **S/ 7.20**. El total de insumos sube a **S/ 10.68** y el food cost real queda en **36 %**.

Son S/ 3.24 por plato que no veía. Si vende 50 ceviches al día y abre 26 días al mes, la diferencia llega a unos **S/ 4,200 mensuales**, solo en un plato. Con ese dato, Martín puede ajustar la porción, negociar con otro proveedor, comprar filete en lugar de pescado entero o revisar el precio de carta, pero ahora decide con números reales.

Como referencia de gestión, muchas cocinas buscan un food cost de entre 28 % y 35 %. No es una regla: depende del tipo de restaurante, del ticket promedio y de tus gastos fijos. Lo importante es conocerlo plato por plato.

### Cuando sube el limón

Si el kilo de limón pasa de S/ 6 a S/ 12, los 250 g del plato pasan de S/ 1.50 a S/ 3.00. Con el rendimiento ya corregido, el food cost subiría de 36 % a cerca de 41 %. Un sistema que actualiza el costo de cada insumo con cada compra te muestra ese salto el mismo día, y no cuando revisas las cuentas del mes.

### Un apunte sobre el IGV de los restaurantes

El ejemplo usa la tasa general de 18 %. Algunas MYPE del rubro de restaurantes y alojamiento pueden acogerse a una **tasa reducida temporal** de IGV establecida por ley, siempre que cumplan los requisitos de ingresos y de actividad. Si es tu caso, el porcentaje que separas del precio de carta es distinto; confirma con tu contador qué tasa te corresponde este año antes de calcular tus márgenes.

## Mermas: registrarlas con motivo

Una merma que no se registra se convierte en un faltante sin explicación. Clasifícalas para saber qué corregir:

| Tipo de merma | Ejemplo | Cómo se controla |
| --- | --- | --- |

| De limpieza o preparación | Cabezas, espinas, cáscaras, recortes | Con el rendimiento en la ficha técnica |

| Por vencimiento | Mariscos que no se usaron a tiempo | Con lotes, fechas de vencimiento y rotación |

| Por error en cocina | Un arroz con mariscos que se quemó | Registrándolo como salida con motivo |

| Consumo interno | Almuerzo del equipo, cortesías | Salida interna, nunca como venta |

| Devoluciones y anulaciones | Plato devuelto por el cliente | Registrando el insumo que ya salió |

Dos prácticas que hacen la diferencia:

- **Pesa las porciones.** Una balanza en la línea de cocina convierte la ficha técnica en una realidad, y se paga sola en pocos días.

- **Mide la merma en soles y como porcentaje de la venta.** Si un mes salta, busca la causa en almacenamiento, en manipulación o en quién tiene acceso a la cámara.

## Compras con método

El costo del plato se define en el momento de la compra. Para no improvisar en el mercado:

- **Define un stock mínimo por insumo** según tu consumo semanal y el tiempo que tarda cada proveedor en entregar.

- **Usa órdenes de compra**, aunque sea con tu proveedor de siempre. Evitan pedidos duplicados y dejan claro el precio acordado.

- **Cotiza los insumos que más pesan en tu costo**: pescado y mariscos, pollo, aceite, arroz y limón.

- **Recibe con balanza.** Lo que no reclamas en la puerta lo terminas pagando tú.

- **Registra las devoluciones a proveedores** y lleva las cuentas por pagar en el mismo sistema donde controlas el stock.

- **Deja que el costo se actualice solo.** Con un kardex valorizado, el costo promedio de cada insumo se recalcula con cada compra y tus fichas técnicas siempre usan precios vigentes.

## Conteos físicos: un calendario que funciona

Lo que figura en pantalla es el stock teórico; lo que encuentras en la cámara es el real. Entre ambos está tu pérdida.

| Frecuencia | Qué contar | Recomendación |
| --- | --- | --- |

| Diario | Pescados, mariscos, carnes y los insumos más caros | Al cierre, con la cocina apagada; toma unos 15 minutos |

| Semanal | Verduras, abarrotes, bebidas y descartables | El mismo día y a la misma hora cada semana |

| Mensual | Todo el almacén, la cámara y la barra | Con movimientos detenidos y dos personas contando |

Cuenta por zonas, registra las diferencias como **ajustes** con su motivo y deja que el sistema empiece el día siguiente con el stock correcto.

## Lo que tu sistema debe hacer por ti

Para que todo esto no dependa de una libreta, la sala, la cocina y el almacén tienen que estar en el mismo sistema. Con el [software para restaurantes](https://www.sistemafacturacionperu.com/sistema-para-restaurantes/) de Sistema Facturación Perú gestionas mesas, comandas que llegan a cada área de preparación, modificadores de platos, meseros, propinas, delivery y carta en línea, con la boleta o factura electrónica integrada.

En el depósito, el [control de inventario](https://www.sistemafacturacionperu.com/sistema-de-inventario/) suma kardex por insumo, almacenes separados (cocina, barra, depósito), lotes con su vencimiento, movimientos de un almacén a otro, avisos cuando un insumo llega a su mínimo, conteos físicos con ajustes y devoluciones a proveedores. Los almacenes separados, los traslados entre ellos y el kardex valorizado llegan con el Plan PRO. Y en la caja, el [punto de venta](https://www.sistemafacturacionperu.com/sistema-pos/) cobra en efectivo, con tarjeta, transferencia o billetera digital, emite el comprobante en el mismo paso y cierra el turno con arqueo.

## Seis indicadores para revisar cada lunes

- **Food cost total** del local y de los cinco platos que más salen.

- **Merma de la semana** en soles, con su motivo principal.

- **Diferencia entre el conteo y el sistema** en pescados, mariscos y carnes.

- **Utilidad por plato**, que no siempre coincide con el plato más vendido.

- **Precio de compra de tus diez insumos principales**, para detectar subidas a tiempo.

- **Consumo interno y cortesías** en soles, para que no crezcan sin que nadie lo note.

Con estos seis números cada semana, dejas de manejar el restaurante por intuición y empiezas a tomar decisiones con datos.

## Pon tu cocina en orden con Sistema Facturación Perú

Cargar tus fichas técnicas, conectar la comanda con el almacén y ver tu food cost real es más rápido de lo que parece. [Pide una demo gratuita](https://www.sistemafacturacionperu.com/contacto/) y te mostramos tu propia carta funcionando en el sistema, desde el pedido en la mesa hasta el kardex. Si ya quieres comparar opciones, revisa los planes en la [página de precios](https://www.sistemafacturacionperu.com/precios/).

---

# Guía de remisión electrónica: qué es y cómo emitirla en 2026

URL: https://www.sistemafacturacionperu.com/blog/que-es-la-guia-de-remision-electronica/
Publicado: 2026-09-02 · Categoría: Facturación electrónica

Todo sobre la guía de remisión electrónica: cuándo es obligatoria, GRE remitente o transportista, datos que pide SUNAT y cómo evitar el comiso de tu carga.

Cada vez que una mercadería se mueve de un lugar a otro en el Perú, alguien tiene que poder explicar ese movimiento. Para eso existe la **guía de remisión electrónica (GRE)**: un documento que acredita **qué bienes viajan, desde dónde, hacia dónde y por qué razón**. No cobra nada ni prueba que alguien sea dueño de la carga; su trabajo es sustentar el traslado ante SUNAT y ante cualquier control en el camino.

Desde que el proceso se digitalizó, la guía funciona igual que una factura electrónica: es un **XML** firmado que se envía a SUNAT y que recibe su propia constancia de respuesta. En esta nota verás cuándo te toca emitirla, cuál de las dos guías corresponde a cada caso, qué datos lleva y cómo emitirla desde tu **sistema de facturación** sin escribir dos veces la misma información.

## La GRE en pocas líneas

| Pregunta | Respuesta corta |
| --- | --- |

| ¿Qué es? | El documento electrónico que sustenta el traslado de bienes |

| ¿Es un comprobante de venta? | No. Puede acompañar a una venta, pero no la reemplaza ni es reemplazada por la factura |

| ¿Cuándo se emite? | Antes de que la mercadería salga, siempre que haya traslado, con o sin venta |

| ¿Cuántos tipos hay? | Dos: **remitente (09)** y **transportista (31)** |

| ¿Qué pasa si falta? | SUNAT puede aplicar el comiso de los bienes, entre otras sanciones |

## Para qué te sirve la guía

Aunque parezca un trámite más, la guía trabaja a tu favor en tres frentes:

- **Te respalda en ruta.** Si SUNAT o la Policía detienen el vehículo, la guía demuestra que la carga viaja con sustento.

- **Conecta la operación con la contabilidad.** SUNAT puede comparar lo que trasladaste con lo que luego facturaste; si todo cuadra, no hay preguntas.

- **Documenta lo que salió.** Si la entrega llega incompleta o se pierde en el camino, la guía registra qué se despachó, cuánto pesaba y en qué vehículo.

Recuerda que **la factura y la guía son documentos diferentes**. La primera prueba la venta; la segunda, el movimiento físico. En una entrega a domicilio suelen ir juntas, pero ninguna sustituye a la otra.

## Situaciones típicas en una MYPE

Algunos ejemplos que se repiten en negocios peruanos:

- **Panadería con dos locales en Arequipa** que cada madrugada lleva pan y pasteles del obrador a la tienda de Cayma. No hay venta, pero sí traslado entre establecimientos.

- **Ferretería en Trujillo** que vende 40 bolsas de cemento y las lleva en su camioneta a la obra del cliente.

- **Tienda de repuestos en Lima** que despacha un pedido a Pucallpa por una empresa de transporte de carga.

- **Bodega mayorista** que recoge mercadería en el almacén de su proveedor con su propio vehículo, cuando le corresponde sustentar ese traslado.

- **Distribuidora** que devuelve productos vencidos al fabricante o envía equipos a reparación.

- **Comercio** que traslada stock al almacén de un operador logístico o deja productos en consignación.

Existen supuestos en los que la norma no exige guía. Si tu caso es poco común (muestras, exhibiciones, ferias o traslados urgentes), revísalo con tu contador antes de cargar el vehículo.

## Remitente o transportista: quién emite cada guía

Esta es la parte que más confunde. Son **dos guías distintas, emitidas por personas distintas**.

### GRE remitente (09)

La emite **quien envía la mercadería**: el propietario, el vendedor o quien despacha desde su almacén. Si tu negocio saca productos hacia otro lugar, esta guía siempre es tuya.

### GRE transportista (31)

La emite **la empresa de transporte contratada** para mover la carga, con los datos de su vehículo, su conductor y su ruta. Solo aparece cuando el traslado lo hace un tercero que presta el servicio de transporte.

### Cómo se combinan

| Caso | Guías que se emiten |
| --- | --- |

| La ferretería de Trujillo lleva el cemento en su camioneta, manejada por su trabajador | Solo **GRE remitente (09)** de la ferretería |

| La tienda de repuestos envía el pedido a Pucallpa con una agencia de carga | **GRE remitente (09)** de la tienda + **GRE transportista (31)** de la agencia |

| Eres transportista y te contratan para llevar mercadería ajena | Tú emites la **GRE transportista (31)**; tu cliente, la **GRE remitente (09)** |

## Modalidad de transporte: privado o público

Dentro de la guía se indica la modalidad, y de ella depende cuántas guías acompañan la carga.

- **Privado:** quien mueve la carga es el mismo remitente, o el destinatario, usando unidades propias o en arrendamiento financiero y choferes de su planilla. Basta la GRE remitente, que incluye la placa, el conductor y su licencia.

- **Público:** lo hace un transportista contratado. Viajan las dos guías: la del remitente y la del transportista. Antes de entregar la carga, verifica que la empresa de transporte emita su guía electrónica; si no lo hace y hay un control, el problema también te alcanza.

## Los datos que debe llevar

Agrupados por bloque, estos son los campos que no pueden faltar:

| Bloque | Datos |
| --- | --- |

| Remitente | RUC, razón social y domicilio |

| Destinatario | Nombre y RUC o documento de identidad (si es traslado entre tus locales, eres tú mismo) |

| Bienes | Descripción, cantidad, unidad de medida y **peso bruto total** |

| Motivo | Por ejemplo: venta, compra, devolución, consignación, traslado entre locales de una misma empresa o traslado de emisor itinerante. Cada motivo lleva un código |

| Ruta | Dirección de partida y de llegada, con su ubigeo |

| Fechas | Fecha de inicio del traslado |

| Transporte | Modalidad (pública o privada); placa del vehículo y, si corresponde, del remolque |

| Conductor | Nombres, tipo y número de documento, y **licencia de conducir** |

| Relación | Comprobante vinculado, si la mercadería viaja por una venta que ya facturaste |

Un consejo práctico: nunca completes la placa o la licencia «con lo que haya». En un control son los primeros datos que se revisan, y una guía que no corresponde al vehículo detenido equivale a no llevar guía.

## Si algo cambia durante el viaje

Puede pasar que la camioneta se malogre a mitad de ruta o que haya que reemplazar al conductor. En esos casos la guía original se mantiene y el cambio se documenta con una **GRE por evento**.

SUNAT ha seguido afinando estas reglas. En 2026 se publicó la Resolución de Superintendencia N.º 000108-2026/SUNAT, aplicable desde junio, que revisó quiénes están obligados a emitir la GRE remitente, sumó un nuevo documento relacionado con mercancías extranjeras en tránsito y agregó situaciones que justifican una guía por evento; una de ellas es reemplazar al chofer por motivos que no dependen ni de quien envía ni de quien transporta. Si trabajas con carga importada o con operadores de comercio exterior, repasa con tu contador cómo te afecta el texto vigente.

## Qué te puede costar una guía mal hecha

Trasladar mercadería sin guía, o con una que no corresponde, es de las infracciones con efecto más inmediato: SUNAT puede aplicar el **comiso de los bienes** y, según la infracción, otras medidas como el internamiento temporal del vehículo.

Para recuperar la carga tendrás que **acreditar que eres el propietario**, **pagar la multa** y cubrir los **costos de traslado y almacenamiento** mientras estuvo retenida. Mientras tanto, el vehículo no trabaja, el cliente no recibe su pedido y, si llevabas alimentos o productos perecibles, puedes perderlo todo.

### Errores que vemos con frecuencia

- Motivo de traslado que no coincide con la operación (por ejemplo, «venta» en un traslado entre locales).

- Peso bruto calculado a ojo o en blanco.

- Dirección de llegada sin ubigeo o con el distrito equivocado.

- Guía emitida en papel cuando ya correspondía hacerlo de forma electrónica.

- Datos del conductor o del vehículo que no son los del viaje real.

Ninguno de ellos ahorra más de un par de minutos, y cualquiera puede terminar en la retención de tu mercadería.

## Emitir la guía desde el mismo sistema donde vendes

Cuando la factura sale de un programa y la guía de otro, terminas copiando el cliente, los productos y las cantidades dos veces, y basta un error para que los documentos no coincidan.

En **Sistema Facturación Perú** la guía nace del mismo lugar donde ya están tu catálogo, tus clientes y tus ventas:

- Abres la venta o el comprobante que vas a despachar.

- El sistema trae el destinatario, los productos y las cantidades.

- Agregas los datos del viaje: por qué se traslada, de dónde a dónde, en qué vehículo y quién maneja.

- Emites. Se genera el XML, se firma y viaja a SUNAT (o al OSE/PSE); la constancia de respuesta queda archivada con tus demás comprobantes, igual que en la [facturación electrónica SUNAT](https://www.sistemafacturacionperu.com/sistema-facturacion-electronica/).

Como el sistema emite tanto la guía de **remitente (09)** como la de **transportista (31)**, te sirve si despachas tu propia mercadería y también si te dedicas a transportar la de otros. Para negocios que salen a reparto todos los días, como mayoristas o distribuidoras que abastecen bodegas, la guía se complementa con el kardex y el manejo de varios almacenes; lo explicamos en el [software para distribuidoras](https://www.sistemafacturacionperu.com/sistema-para-distribuidoras/).

## Que tu carga viaje con respaldo

La guía de remisión parece un detalle hasta que te detienen la carga en la carretera. Emitirla bien, con los datos correctos y desde el mismo sistema en el que facturas, cuesta mucho menos que una sola multa o un día de reparto perdido.

Revisa cómo funciona la [guía de remisión electrónica en Sistema Facturación Perú](https://www.sistemafacturacionperu.com/guia-de-remision-electronica/) o [escríbenos para una demostración gratuita](https://www.sistemafacturacionperu.com/contacto/): te ayudamos a registrar tus vehículos, tus almacenes y las series de guías, para que el primer despacho salga sin errores. La guía de remisión está incluida en todos los planes, desde el Plan Básico; consulta el detalle en [planes y precios](https://www.sistemafacturacionperu.com/precios/).

---

# Factura o boleta electrónica: cuál emite tu sistema en cada venta

URL: https://www.sistemafacturacionperu.com/blog/diferencia-entre-factura-y-boleta-electronica/
Publicado: 2026-08-28 · Categoría: Facturación electrónica

¿Factura o boleta? Conoce a quién se emite cada una, qué datos pide SUNAT, sus plazos de envío y cómo corregir si te equivocaste. Emite sin errores desde caja.

Un contratista entra a una ferretería en Trujillo, compra S/ 480 en tubos y pegamento y, cuando ya le entregaron una boleta, dice: “Ah, era con factura, es para la obra de mi empresa”. El cajero tiene que anular, volver a emitir y explicar el cambio. Cinco minutos perdidos y una fila que se alarga.

Elegir entre **factura y boleta** parece un detalle, pero un error obliga a corregir con notas de crédito o anulaciones, y puede dejar a tu cliente sin poder usar el IGV de su compra. La pregunta que lo resuelve casi siempre es una sola: **¿quién se lleva el comprobante y qué hará con él?**

## La pregunta clave en caja: ¿es para la empresa?

### Cuándo corresponde factura

El Reglamento de Comprobantes de Pago indica que la factura se emite cuando el comprador es un contribuyente del IGV con **derecho a crédito fiscal**, o cuando la solicita para **sustentar costo o gasto** ante SUNAT.

En la práctica: cuando el comprador es una empresa, o alguien con RUC que llevará esa compra a su contabilidad, toca factura. La factura electrónica requiere que el comprador tenga **RUC**; la excepción más conocida son las exportaciones a clientes del extranjero.

La diferencia es concreta. Con factura, tu cliente usa el IGV pagado como crédito fiscal y deduce el gasto. Con boleta, no puede hacerlo.

### Cuándo corresponde boleta

La boleta de venta es para **consumidores finales**: personas que compran para su propio uso. Salvo excepciones puntuales previstas en la norma, no da derecho a crédito fiscal ni sirve para sustentar costo o gasto.

En una bodega de Arequipa, una pollería en Chiclayo o una panadería de barrio, casi todas las ventas son con boleta, y está bien que sea así.

### El cliente tiene RUC, pero compra para su casa

Tener RUC no obliga a nadie a pedir factura. Si una persona con negocio compra algo para uso personal, actúa como consumidor final y puede recibir boleta. Por eso, más que preguntar “¿tiene RUC?”, conviene preguntar: **“¿el comprobante es para su empresa?”**. Si la respuesta es sí, factura con el RUC correcto.

## Comparación lado a lado

| Aspecto | Factura electrónica (código 01) | Boleta de venta electrónica (código 03) |
| --- | --- | --- |

| Para quién | Comprador con RUC que la usa en su negocio | Consumidor o usuario final |

| Datos del comprador | RUC y razón social, en todos los casos | Obligatorios cuando el total pasa de S/ 700 |

| Crédito fiscal | Sí | No, salvo excepciones legales |

| Sustenta costo o gasto | Sí | No, salvo excepciones |

| Inicio de la serie | Letra F (por ejemplo, F001) | Letra B (por ejemplo, B001) |

| Forma de envío a SUNAT | Individual, comprobante por comprobante | En bloque, mediante resumen diario |

| Corrección de errores | Comunicación de baja o nota de crédito | Anulación en el resumen o nota de crédito |

## Los datos que lleva cada una

### Factura electrónica

Tu RUC, tu razón social y la dirección del local emisor van siempre. A eso se suman:

- **RUC y razón social del cliente,** sin errores.

- **Detalle de lo vendido:** qué es, cuántas unidades, en qué unidad de medida y a qué precio cada una.

- **Montos:** el valor de venta, el **IGV (18 %) separado** y el total a pagar.

- **Moneda y forma de pago:** al contado o al crédito; en este último caso, con cuotas y fechas de vencimiento.

- **Afectación al IGV de cada línea:** si es gravada, exonerada, inafecta o gratuita.

- **Elementos de seguridad** que añade el sistema de emisión: la firma digital, el código hash y el QR.

Cuando la operación está sujeta al sistema de **detracciones**, ese dato también tiene que figurar en la factura. Omitirla es una de las razones más frecuentes por las que un cliente empresa devuelve el comprobante.

Cada campo está explicado con ejemplos en nuestra guía de la [factura electrónica](https://www.sistemafacturacionperu.com/factura-electronica/).

### Boleta electrónica: menos datos

Lleva tus datos como emisor, qué vendiste, en qué cantidad y cuánto suma la venta. Como el comprador no usará ese IGV, la norma no pide más.

### La regla de los S/ 700

Es la que más se olvida en caja. **Si el total de la boleta supera los S/ 700, debes registrar los datos del comprador:** nombres y apellidos, y el tipo y número de documento (DNI, carné de extranjería o pasaporte).

Si la venta es de S/ 700 o menos, identificarlo es opcional, salvo que el cliente lo pida. Un buen hábito es pedir el DNI en toda compra grande: el comprobante sale bien a la primera y no tienes que corregirlo después.

Hay más casos prácticos en nuestra página sobre la [boleta electrónica en Perú](https://www.sistemafacturacionperu.com/boleta-electronica/).

## Cómo y cuándo llega cada comprobante a SUNAT

### La factura viaja sola y con plazo corto

Cada factura se envía de forma individual a SUNAT o al OSE. El plazo es el día de emisión o, como máximo, los **tres días calendario siguientes**. Esta regla rige desde enero de 2023 y también se aplica a las notas de crédito y débito vinculadas.

Si la factura se envía fuera de plazo, **pierde su calidad de comprobante electrónico**, aunque el cliente ya la tenga en su correo. Es decir, no le sirve para crédito fiscal ni para sustentar gasto. Por eso el envío debe ser automático y no depender de que alguien lo recuerde.

### Las boletas viajan juntas

Las boletas de un mismo día, con sus notas vinculadas, se informan en un **resumen diario**. Según las reglas vigentes, puedes enviarlo el mismo día de emisión o, como máximo, hasta el **sétimo día calendario** siguiente. Si tienes dudas sobre tu caso, verifica la norma actualizada en el portal de SUNAT.

En ambos casos recibes una **CDR** (constancia de recepción) con estado aceptado, aceptado con observaciones o rechazado. Guárdala junto con el XML: es tu respaldo ante cualquier revisión.

## Ejemplos por tipo de negocio

La misma tienda puede emitir boleta o factura según quién compre. Estos casos se repiten en todo el país:

| Negocio | Venta | Comprobante |
| --- | --- | --- |

| Restaurante en Chiclayo | Una familia almuerza un domingo | Boleta |

| Restaurante en Chiclayo | Una empresa paga el almuerzo de su equipo de ventas | Factura |

| Ferretería en Trujillo | Un vecino compra un foco y cinta aislante | Boleta |

| Ferretería en Trujillo | Una constructora compra fierro para una obra | Factura |

| Taller mecánico en Huancayo | Mantenimiento del auto particular de un profesor | Boleta |

| Taller mecánico en Huancayo | Mantenimiento de la camioneta de una empresa de transportes | Factura |

| Bodega en Arequipa | Abarrotes por S/ 25 | Boleta sin identificar al cliente |

| Bodega en Arequipa | Bebidas y piqueos por S/ 850 para un cumpleaños | Boleta con nombre y DNI, porque supera S/ 700 |

Fíjate en que el rubro no decide el comprobante. Lo decide el uso que el cliente le dará: consumo propio o gasto de su negocio. Si tu equipo de caja entiende esa idea, la mayoría de errores desaparecen antes de que ocurran.

## Si emitiste el comprobante equivocado

Ocurre en cualquier negocio. Lo importante es corregir pronto y por la vía correcta. Lo explicamos a fondo en [cómo anular una factura electrónica](https://www.sistemafacturacionperu.com/blog/como-anular-factura-electronica-sunat/), pero aquí tienes el resumen:

| Error | Cómo se corrige |
| --- | --- |

| Diste boleta y era factura | Anula la boleta (en el resumen correspondiente) y emite la factura con los datos del cliente |

| Diste factura y era boleta | Nota de crédito con motivo «anulación de la operación» y, después, la boleta |

| Pusiste mal el RUC del cliente | Nota de crédito con motivo “anulación por error en el RUC” y nueva factura |

| Escribiste mal la descripción | Nota de crédito con motivo “corrección por error en la descripción” |

Dos detalles importantes: una boleta **no se convierte** en factura, y la nota de crédito siempre se emite **al mismo cliente** del comprobante original. Si la boleta ya fue aceptada en un resumen, su anulación tiene plazo, así que resuélvelo esa misma semana.

## Tres hábitos para no equivocarte

La mayoría de errores no vienen de la norma, sino del proceso en caja. Estos hábitos ayudan mucho:

- **Consultar RUC y DNI automáticamente.** Escribes el número y el sistema completa razón social, dirección y condición del contribuyente. Se acaban los nombres mal escritos y las facturas a RUC no habidos.

- **Dejar que el sistema sugiera el comprobante.** Si ingresas un RUC, propone factura; si ingresas un DNI, boleta.

- **Tener series propias por sucursal y por caja.** Así la numeración nunca se mezcla entre locales.

## Puntos clave

- Factura: cuando el cliente tiene RUC y usará el comprobante para crédito fiscal, costo o gasto.

- Boleta: para consumidores finales; identifica al comprador cuando el total pasa de S/ 700.

- La factura se envía de forma individual en un plazo máximo de tres días; las boletas, en el resumen diario.

- Si te equivocas, corrige con nota de crédito o anulación, y vuelve a emitir el comprobante correcto.

## Emite el comprobante correcto con Sistema Facturación Perú

En nuestro [sistema de facturación electrónica](https://www.sistemafacturacionperu.com/sistema-facturacion-electronica/) emites facturas y boletas, notas de crédito y de débito, guías de remisión (remitente y transportista), comprobantes de retención y de percepción y liquidaciones de compra. Los resúmenes diarios y las comunicaciones de baja también salen del mismo panel. El XML firmado y la CDR quedan guardados en la nube.

Revisa qué incluye cada plan en la página de [precios](https://www.sistemafacturacionperu.com/precios/). Y si tienes una duda puntual sobre tu rubro, [escríbenos](https://www.sistemafacturacionperu.com/contacto/): te mostramos cómo quedaría configurado tu punto de venta antes de que emitas tu primer comprobante.

---

# Software contable en Perú: para qué sirve y cuándo usarlo

URL: https://www.sistemafacturacionperu.com/blog/que-es-software-contable/
Publicado: 2026-08-26 · Actualizado: 2026-10-27 · Categoría: Contabilidad

Qué hace un software contable, en qué se diferencia de Excel y de un ERP y cómo exporta a CONCAR, SISCONT o CONTASIS para que tu contador cierre el mes antes.

Piensa en todo lo que pasa por tu negocio en un mes: boletas en caja, facturas a empresas, compras a proveedores, una nota de crédito por una devolución, el pago de la luz. Un **software contable** es el sistema que toma cada uno de esos movimientos, lo ubica donde corresponde y te entrega los registros y reportes que SUNAT exige y que tu contador necesita para declarar.

La idea central es simple: **cada operación se anota una sola vez y queda disponible para todos los reportes**. Ya no hay una caja de zapatos con comprobantes por un lado y una hoja de cálculo por el otro. El software no reemplaza el criterio de tu contador, pero le ahorra el trabajo mecánico; y a ti te permite conocer tus números a mitad de mes, no cuando ya es tarde para corregir el rumbo.

## Quién hace qué: el sistema, tu contador y SUNAT

Ayuda separar las responsabilidades:

| Tarea | El software contable | Tu contador | SUNAT |
| --- | --- | --- | --- |

| Registrar ventas, compras y gastos | Sí, a partir de tus comprobantes | Revisa y corrige criterios | Recibe tus comprobantes electrónicos |

| Clasificar por cuenta, afectación al IGV, cliente o proveedor | Sí | Define el plan de cuentas y los criterios | — |

| Generar registros de ventas y compras y Libro Mayor | Sí | Los valida | — |

| Comparar con las propuestas del SIRE | Te deja la información lista para cruzar | Concilia diferencias | Genera las propuestas de RVIE y RCE |

| Presentar declaraciones | No | Sí | Las recibe |

| Responder una fiscalización | No | Sí, contigo | La realiza |

En un sistema integrado como **Sistema Facturación Perú**, la primera columna se llena sola: la boleta que salió por caja y la compra que registraste ya están en los reportes, sin que nadie las vuelva a digitar.

## Lo que un software contable no hace

Conviene saberlo antes de comprar, para no esperar milagros:

- **No sustituye al contador.** No interpreta normas, no decide cómo tratar una operación dudosa ni te representa ante SUNAT.

- **No declara por ti.** Te deja la información ordenada; la declaración se presenta en SUNAT.

- **No corrige lo que entró mal.** Si una venta se emitió como exonerada cuando era gravada, el reporte arrastrará ese error.

- **No gestiona la operación diaria.** Eso es trabajo de un ERP, que controla compras, stock y ventas mientras suceden; el software contable se enfoca en registrar y ordenar lo que ya pasó. Lo desarrollamos en el artículo [ERP o software contable: diferencias](https://www.sistemafacturacionperu.com/blog/erp-vs-software-contable/).

## Del cuaderno al Excel y del Excel al sistema

Toma el caso de un minimarket en Piura. El primer año, la dueña anota las ventas en un cuaderno. Al segundo, su sobrino le arma un Excel con fórmulas. Durante un tiempo funciona; luego empiezan los problemas.

### Lo que Excel resuelve bien

- Cuentas rápidas y proyecciones sencillas.

- El control de una caja chica.

- Un presupuesto de compras para la campaña de diciembre.

### Donde empieza a fallar

| Problema | Cómo se nota en el minimarket |
| --- | --- |

| Se digita dos veces | La boleta sale del sistema de caja y alguien la vuelve a escribir en el Excel por la noche |

| Nadie valida | Un RUC con un dígito cambiado o un IGV calculado sobre el total pasan sin alerta |

| Llega tarde | El archivo se actualiza los domingos; las compras del lunes se deciden sin datos |

| Vive en una sola laptop | Hay tres versiones del archivo y nadie sabe cuál es la buena |

| No conversa con SUNAT | La propuesta del SIRE muestra compras que el Excel no tiene, y explicar la diferencia le toca a la dueña |

Una prueba rápida: si cada mes le entregas a tu contador una carpeta con comprobantes y él los transcribe uno por uno, estás pagando dos veces por la misma información.

## Cinco reportes que tu sistema te debe entregar

| Reporte | Qué muestra | Para qué te sirve |
| --- | --- | --- |

| **Registro de ventas** | Todos los comprobantes que emitiste: fecha, serie y número, cliente, base, IGV e importe total, distinguiendo lo gravado, lo exonerado y lo inafecto | Es la base de la declaración mensual del IGV |

| **Registro de compras** | Las facturas de tus proveedores con su IGV | Sustenta tu **crédito fiscal**; si falta una factura, pagas IGV de más |

| **Libro Mayor** | Entradas, salidas y saldo de cada cuenta contable | Es la herramienta con la que tu contador prepara el cierre |

| **Utilidad por venta y por producto** | Lo que te deja cada venta y cada artículo después del costo | Descubres que el producto que más rota no siempre es el más rentable |

| **Conciliación con el SIRE** | Diferencias entre tus registros y las propuestas de RVIE y RCE | Detectas comprobantes faltantes antes de declarar |

Exige que todos se puedan descargar en **Excel y PDF**. Un reporte que solo se ve en pantalla no le sirve a tu contador. En Sistema Facturación Perú la utilidad se calcula por venta y por producto, y los reportes se descargan en ambos formatos.

## La exportación al programa de tu contador

Tu contador no lleva tu contabilidad dentro de tu sistema: la lleva en el suyo, junto con la de todos sus clientes. En el Perú, los programas más extendidos son **CONCAR, SISCONT y CONTASIS**, aunque hay otros.

Si tu software no produce un archivo que ese programa pueda importar, el camino es la digitación manual, con sus horas cobradas, sus errores de tipeo y su cierre atrasado.

Sistema Facturación Perú exporta tus registros de ventas y compras a:

- CONCAR y CONCAR Simple

- SISCONT y SISCONT Excel

- CONTASIS

- FOXCONT

- ADSOFT

- SUMERIUS

Además se integra con el **SIRE**, para que compares tus registros con las propuestas de **RVIE** (ventas) y **RCE** (compras) que genera SUNAT. Un consejo antes de elegir cualquier sistema: pregúntale a tu contador en qué programa trabaja tu empresa. Esa respuesta es tu primer requisito.

## Un acceso propio para tu contador

En lugar de enviarle archivos por WhatsApp cada fin de mes, puedes darle a tu contador un **usuario de solo lectura**: entra cuando lo necesita, descarga lo que requiere y no puede cambiar ni eliminar ninguna venta, compra o movimiento de stock.

- Desaparecen los mensajes de «pásame lo de octubre».

- Tus datos quedan protegidos: consulta, pero no edita.

- El cierre se acelera porque tu contador trabaja con información al día.

La exportación a programas contables, el SIRE y un portal de consulta para tus contadores (hasta cinco) llegan con el **Plan PRO (S/ 149 + IGV al mes)**; el **Plan Básico (S/ 49 + IGV al mes)** cubre la facturación, las compras y los reportes del día a día. Los dos se contratan en línea. Encuentra el detalle en la [página de planes](https://www.sistemafacturacionperu.com/precios/). Si diriges un estudio contable o manejas varios RUC, mira también cómo funciona [Sistema Facturación Perú para contadores](https://www.sistemafacturacionperu.com/sistema-para-contadores/).

## Test rápido: ¿ya necesitas un software contable?

Marca mentalmente las frases que te describen:

- Alguien del estudio contable copia tus comprobantes uno por uno.

- Sabes cuánto vendiste este mes, pero no cuánto ganaste.

- Te enteras de facturas de compra cuando el periodo ya cerró y ese crédito fiscal se pierde.

- La propuesta del SIRE no coincide con lo que tienes registrado.

- Emites desde varios puntos (dos cajas, una sucursal, un vendedor con celular) y nadie consolida.

- Los números de un mes llegan a mitad del siguiente.

- Toda la información depende de una sola persona y nadie más sabe dónde está.

**Si marcaste tres o más**, el Excel ya no te alcanza. Ninguna de estas situaciones te trae una multa mañana, pero todas te restan dinero de forma silenciosa: crédito fiscal que no usas, compras decididas a ciegas y horas de digitación que pagas dos veces.

## Pon orden en tus números desde hoy

Un buen software contable no es solo una obligación cumplida: es conocer en cualquier fecha tus ventas, tus costos y tu ganancia real, y lograr que tu contador reciba la información completa sin tener que perseguirte.

Conoce el [software contable de Sistema Facturación Perú](https://www.sistemafacturacionperu.com/sistema-contable/), revisa cómo trabajan los estudios contables con la [edición para contadores](https://www.sistemafacturacionperu.com/sistema-para-contadores/) o [pide una demostración gratuita](https://www.sistemafacturacionperu.com/contacto/): vemos tu caso y te recomendamos solo lo que realmente vas a usar.

---

# Sistema de inventario simple o valorizado: cómo saber cuál necesitas

URL: https://www.sistemafacturacionperu.com/blog/inventario-valorizado-vs-simple/
Publicado: 2026-08-26 · Actualizado: 2026-10-27 · Categoría: Inventario

El inventario simple cuenta unidades; el valorizado también te dice cuánto valen y cuánto ganas por venta. Compara ambos con un ejemplo y elige el tuyo.

En una ferretería de Trujillo, el dueño puede decirte de memoria que tiene 50 bolsas de cemento en el depósito. Pero si le preguntas cuánto dinero representan esas bolsas o cuánto ganó en la última venta, duda. Compró en dos fechas, a dos precios distintos, y la cuenta ya no le sale.

Esa duda resume la diferencia entre los dos tipos de control. El **inventario simple** responde «¿cuánto tengo?». El **inventario valorizado** responde, además, «¿cuánto vale?» y «¿cuánto gano?». Aquí te explicamos cómo funciona cada uno y cómo elegir el que necesita tu negocio.

## La diferencia en una línea

- **Inventario simple:** cantidades. Entra, sale, queda.

- **Inventario valorizado:** cantidades y soles. Entra a cierto costo, sale a cierto costo, queda con cierto valor.

Todo lo demás se deriva de ahí.

## Cómo trabaja un inventario simple

Cada producto tiene un saldo en unidades. Las compras lo suben; las ventas, mermas y ajustes lo bajan. El historial de esos movimientos es el **kardex en unidades**.

Te permite:

- Saber cuántas unidades tienes de cada producto, en cada almacén.

- Recibir alertas cuando un producto baja de su stock mínimo.

- Detectar diferencias entre lo que dice el sistema y lo que cuentas en el anaquel.

- Empezar rápido, sin preocuparte por costos ni métodos contables.

Es una buena forma de ordenarte si hasta hoy llevabas el stock en un cuaderno. Una bodega en Arequipa con pocos proveedores y precios estables puede trabajar bien así durante mucho tiempo.

**Su límite:** no sabe nada de dinero. Te dice que quedan 50 bolsas de cemento, pero no cuánto te costaron, cuánto capital tienes ahí ni si la última venta te dejó utilidad.

## Cómo trabaja un inventario valorizado

Además de la cantidad, cada movimiento guarda su **costo**:

- Cada compra entra con su costo de adquisición, sin el IGV que usas como crédito fiscal.

- Cada salida se valoriza con un método de valuación; el más usado en pymes peruanas es el **costo promedio ponderado**.

- El saldo de cada producto se expresa en unidades **y** en soles.

El registro de todos esos movimientos es el **kardex valorizado**, y con él puedes saber, a cualquier fecha, el valor de tu inventario y el costo de cada venta. Si quieres profundizar en sus columnas, métodos y obligaciones, lo explicamos en nuestra guía del [kardex valorizado y SUNAT](https://www.sistemafacturacionperu.com/blog/kardex-valorizado-sunat/).

## Ejemplo: el cemento de una ferretería en Trujillo

Veamos el mismo producto con los dos controles. Los montos están sin IGV.

**Las compras del mes:**

- **Día 4:** 80 bolsas a S/ 25.50 = S/ 2,040

- **Día 18:** 120 bolsas a S/ 27.00 = S/ 3,240

Hay **200 bolsas** en el depósito y **S/ 5,280** invertidos.

**El costo promedio:** S/ 5,280 ÷ 200 = **S/ 26.40 por bolsa**.

**La venta:** el día 25, un maestro de obra se lleva **150 bolsas a S/ 30.00** cada una, sin IGV. Ingreso: **S/ 4,500**.

### Lo que ve cada inventario

| Dato | Inventario simple | Inventario valorizado |
| --- | --- | --- |

| Bolsas vendidas | 150 | 150 |

| Bolsas que quedan | 50 | 50 |

| Costo de lo vendido | No lo sabe | S/ 3,960 (150 × S/ 26.40) |

| Utilidad bruta de la venta | No la sabe | S/ 540 |

| Utilidad por bolsa | No la sabe | S/ 3.60 |

| Valor de lo que queda | No lo sabe | S/ 1,320 (50 × S/ 26.40) |

### El error de calcular «al ojo»

Sin inventario valorizado, el dueño suele tomar un precio de referencia. Si usa el de la primera compra (S/ 25.50), cree que gana S/ 4.50 por bolsa. Si usa el de la última (S/ 27.00), cree que gana S/ 3.00. La utilidad real es **S/ 3.60**. Con un producto la diferencia parece pequeña; con 2,000 productos y compras cada semana, es la diferencia entre fijar bien tus precios o vender a pérdida sin saberlo.

## Comparación rápida

| Pregunta | Inventario simple | Inventario valorizado |
| --- | --- | --- |

| ¿Cuántas unidades tengo? | Sí | Sí |

| ¿Me avisa cuando falta stock? | Sí | Sí |

| ¿Cuánto me costó cada producto en promedio? | No | Sí |

| ¿Cuánto dinero tengo inmovilizado en stock? | No | Sí |

| ¿Cuánto gané en cada venta? | No | Sí |

| ¿Sirve como base para el registro de inventario valorizado? | No | Sí |

| ¿Qué tan fácil es empezar? | Muy fácil | Requiere registrar bien los costos de compra |

| ¿Para quién es? | Negocios que recién se ordenan | Negocios que compran a precios variables o quieren crecer |

## Cinco preguntas para decidir

Responde con sinceridad:

- **¿Compras el mismo producto a precios distintos** a lo largo del mes?

- **¿Tienes más de un almacén o sucursal**, o trasladas mercadería entre locales?

- **¿Fijas tus precios de venta** sin conocer tu costo real?

- **¿Tu contador te pide el costo de ventas** o el valor del inventario al cierre?

- **¿Has tenido meses con buenas ventas y poca plata** sin entender por qué?

Si respondiste «sí» a dos o más, el inventario valorizado ya te está haciendo falta. Si todas fueron «no», el simple es un buen punto de partida.

## Fallos que arruinan cualquier inventario

Sea simple o valorizado, estos descuidos lo vuelven inútil:

- **No registrar las mermas ni los productos dañados.** El sistema sigue creyendo que tienes algo que ya no está.

- **Ingresar las compras días después.** Mientras tanto, el stock y los costos están desfasados.

- **No definir stock mínimo.** Te enteras del faltante cuando el cliente ya se fue a la ferretería de al lado.

- **Llevar cada almacén en un archivo distinto.** Nadie sabe el total y los traslados se pierden.

- **No contar nunca el stock físico.** Sin conteos, no hay forma de saber si el sistema dice la verdad.

## Empieza simple y crece sin cambiar de sistema

No tienes que decidir hoy para siempre. En Sistema Facturación Perú puedes empezar con el Plan Básico controlando cantidades, con kardex, lotes y alertas de stock mínimo, y pasar al Plan PRO cuando tu negocio lo necesite: ahí sumas varios almacenes y el **kardex valorizado**, con los mismos productos y el mismo historial.

Conoce todo lo que incluye nuestro [sistema de inventario](https://www.sistemafacturacionperu.com/sistema-de-inventario/), compara qué trae cada plan en la [página de precios](https://www.sistemafacturacionperu.com/precios/) o [pide una demo](https://www.sistemafacturacionperu.com/contacto/) y te mostramos tus propios productos con su costo real.

---

# Errores al facturar en SUNAT en 2026 y cómo tu sistema los previene

URL: https://www.sistemafacturacionperu.com/blog/errores-comunes-facturacion-sunat/
Publicado: 2026-08-19 · Categoría: Facturación electrónica

RUC mal digitado, IGV mal calculado, envíos fuera de plazo o series repetidas: conoce los errores más comunes al facturar y cómo evitar rechazos y multas.

Un viernes por la tarde, la dueña de una tienda de repuestos en Arequipa recibe la llamada de un cliente: la factura de S/ 4,800 que le emitió no aparece en SUNAT. Revisa su sistema y la encuentra en rojo, **rechazada**, desde el martes. El RUC tenía un dígito cambiado. Ahora tiene que emitir otra, explicarle la demora al cliente y rogar que su área contable no le devuelva el pago.

Casos así pasan todos los días, y casi ninguno se debe a mala fe: son descuidos que un buen sistema de facturación detecta antes de enviar. En este artículo repasamos los errores más frecuentes, agrupados por su origen, y te decimos qué hacer cuando ya ocurrieron.

## Primero, entiende lo que te responde SUNAT

Antes de hablar de errores, conviene leer bien los estados que verás en tu panel:

| Estado | Qué significa | ¿El comprobante vale? |
| --- | --- | --- |

| **Aceptado** | Pasó todas las validaciones | Sí |

| **Aceptado con observaciones** | Tiene una inconsistencia menor que no impide su validez | Sí, pero corrige la causa en los siguientes |

| **Rechazado** | No cumplió una regla obligatoria | No; para SUNAT no existe |

| **Pendiente** | Aún no se envía o no hay respuesta | Todavía no sabes; revísalo cuanto antes |

El estado que más daño hace es el que nadie mira: el **pendiente** que se queda así varios días hasta vencer el plazo.

## Errores con los datos del cliente

### Un número de RUC o DNI mal escrito

Basta un dígito para que el comprobante salga a nombre de otra empresa o de un RUC que no existe. Si el documento no es válido, SUNAT rechaza la factura; si existe pero es de otro contribuyente, el problema es peor, porque se acepta y tu cliente real no la puede usar.

**Cómo lo previene el sistema:** al escribir el RUC o el DNI, Sistema Facturación Perú consulta el padrón y completa solo el nombre o la razón social y la dirección. Si lo que aparece no coincide con tu cliente, lo notas antes de emitir.

### Un cliente con RUC en estado o condición irregular

Un RUC dado de baja, suspendido o con condición de «no habido» puede generarte rechazos u observaciones, y complicarle a tu cliente el uso del crédito fiscal o la deducción del gasto. Ver el estado del contribuyente al momento de facturar te evita sorpresas.

### Boleta donde iba factura, o al revés

Si tu cliente tiene RUC y necesita sustentar su gasto o usar el crédito fiscal del IGV, le corresponde **factura** (serie que empieza con F). Si es consumidor final y se identifica con DNI, le corresponde **boleta** (serie que empieza con B). Equivocarse obliga a anular y volver a emitir.

Un detalle que muchos olvidan: en las boletas por montos mayores a **S/ 700** debes consignar el nombre y el documento de identidad del comprador.

**Cómo lo previene el sistema:** al elegir un cliente con RUC, el sistema propone factura; con DNI, propone boleta.

## Errores de cálculo

### IGV mal calculado y redondeos

Calcular el IGV sobre el precio que ya lo incluye, sumar por un lado y redondear por otro, o escribir los totales a mano. SUNAT verifica que la base, el impuesto y el total de cada línea y del comprobante cuadren entre sí; una diferencia de céntimos puede bastar para un rechazo.

### Operaciones gravadas, exoneradas e inafectas mezcladas

Una bodega en la selva que vende productos con beneficios tributarios, o una librería con libros exonerados junto a útiles gravados, necesita que cada producto tenga bien configurado su **tipo de afectación al IGV**. Si todo se marca como gravado, el comprobante sale con un impuesto que no corresponde.

### Descuentos aplicados en el lugar equivocado

No es lo mismo un descuento por línea que uno global, ni uno antes del IGV que uno después. Aplicarlo mal cambia la base imponible y el total.

### Detracciones olvidadas

Si vendes bienes o prestas servicios sujetos al sistema de detracciones y la operación supera el monto mínimo, la factura debe indicarlo: la leyenda correspondiente, el porcentaje y tu número de cuenta de detracciones en el Banco de la Nación. Olvidarlo complica tanto al cliente como a ti.

**Cómo lo previene el sistema:** no calcules a mano. Sistema Facturación Perú arma el XML en formato UBL 2.1, calcula base, IGV, descuentos y cargos según la afectación de cada producto, y agrega los datos de detracción cuando la operación los requiere.

## Errores de plazo

### Facturas que se envían tarde

La factura electrónica debe enviarse a SUNAT (o al OSE) en su fecha de emisión y, como máximo, dentro de los **tres días calendario contados desde el día siguiente**. Pasado ese plazo, el comprobante puede ser rechazado y además te expones a una infracción.

### Boletas que nadie informa

Las boletas se envían de forma individual o agrupadas en un **resumen diario**, y también tienen un plazo corto, de días calendario. El error típico: el cajero cierra la caja, nadie genera el resumen y las boletas de toda una semana quedan sin informar.

**Cómo lo previene el sistema:** el envío es automático al emitir, los resúmenes diarios se generan sin intervención y el panel te muestra cuáles siguen pendientes antes de que venza el plazo.

## Errores de configuración

### Series y correlativos repetidos

Dos cajas o dos locales emitiendo con la misma serie terminan generando números duplicados, y SUNAT rechaza el segundo.

**Cómo evitarlo:** asigna una serie distinta a cada sucursal y a cada punto de venta (por ejemplo, F001 para el local principal y F002 para la sucursal de Cayma) y deja que el sistema lleve la numeración.

### Catálogo de productos incompleto

Productos sin unidad de medida correcta, sin código o con un tipo de afectación equivocado se convierten en errores en cada comprobante donde aparecen. Un error en el catálogo se multiplica por cada venta.

**Cómo evitarlo:** dedica una tarde a revisar tu catálogo: unidad de medida según el catálogo de SUNAT, afectación al IGV y descripción clara. Es el trabajo que más errores elimina de una sola vez.

### Certificado digital vencido

Si firmas tus comprobantes con tu propio certificado y este caduca, todo lo que emitas desde ese día será rechazado.

**Cómo evitarlo:** anota la fecha de vencimiento y renuévalo con anticipación, o trabaja con un **PSE** que firme por ti. Si tienes dudas sobre las modalidades, lee nuestra guía sobre [OSE, PSE y envío directo a SUNAT](https://www.sistemafacturacionperu.com/blog/diferencia-ose-pse-sunat/).

## Errores al corregir un error

Corregir también tiene sus trampas:

- **Notas de crédito sin referencia.** La nota debe indicar el comprobante que modifica y el motivo. Sin esa referencia, no cumple su función.

- **Volver a usar un número rechazado** en lugar de emitir con el siguiente correlativo.

- **Editar el PDF** en lugar de emitir un documento nuevo. El comprobante es el XML validado; cambiar el PDF no corrige nada.

## Qué hacer según lo que te pasó

| Situación | Qué hacer |
| --- | --- |

| Comprobante **rechazado** | Corrige la causa y emite un comprobante nuevo con el siguiente correlativo |

| Comprobante **aceptado con observaciones** | Es válido; revisa la observación y ajusta tu configuración para los siguientes |

| Comprobante **aceptado pero con un error** (monto, cliente, producto) | Emite una nota de crédito que lo anule o corrija y, si corresponde, el comprobante correcto |

| Comprobante aceptado que **no debió emitirse** y aún no se entregó | Evalúa con tu contador si procede una comunicación de baja dentro del plazo que fija SUNAT |

| Comprobante **pendiente** por varios días | Reenvíalo de inmediato y revisa por qué no salió |

## Rutina de cinco minutos para no llevarte sorpresas

- **Cada día, al cierre:** revisa en el panel que no queden comprobantes pendientes ni rechazados.

- **Cada semana:** mira las observaciones repetidas; suelen apuntar a un producto mal configurado.

- **Cada mes:** compara tus ventas del sistema con lo que SUNAT tiene registrado antes de cerrar con tu contador.

- **Cada vez que agregues un producto:** confirma su unidad de medida y su afectación al IGV.

- **Dos meses antes del vencimiento del certificado:** inicia la renovación.

## Factura bien a la primera con Sistema Facturación Perú

Con Sistema Facturación Perú, cada comprobante se valida antes de salir, se envía solo y aparece en un panel donde ves de un vistazo qué está aceptado, observado, rechazado o pendiente. Consulta de RUC y DNI, cálculo automático del IGV, series por sucursal y resúmenes diarios vienen integrados.

Conoce cómo funciona nuestra [facturación electrónica SUNAT](https://www.sistemafacturacionperu.com/sistema-facturacion-electronica/), compara los planes en la [página de precios](https://www.sistemafacturacionperu.com/precios/) o [pide una demo gratuita](https://www.sistemafacturacionperu.com/contacto/) y revisamos juntos los errores que hoy te están quitando tiempo.

---

# Sistema de inventario en tiempo real: guía para tu negocio

URL: https://www.sistemafacturacionperu.com/blog/como-controlar-inventario-en-tiempo-real/
Publicado: 2026-08-19 · Actualizado: 2026-10-27 · Categoría: Inventario

Deja el cuaderno y el Excel: aprende a montar un control de inventario en tiempo real con kardex, stock mínimo y conteos para evitar quiebres y mermas.

Don Julio tiene una ferretería en Trujillo. Un cliente le pide 40 bolsas de cemento, él revisa su cuaderno, ve que tiene 55 y cierra el trato. Cuando su ayudante va al almacén, hay 18. Las otras 37 se vendieron durante la semana y nadie las anotó. Resultado: un cliente molesto, una venta perdida y la sensación de que el negocio se maneja a ciegas.

Tener el inventario **en tiempo real** es justo lo contrario: cada venta, compra, traslado o ajuste actualiza el stock **al instante**, sin que nadie tenga que acordarse de anotarlo. Lo que dice la pantalla es lo que hay en el almacén, a cualquier hora del día.

En esta guía verás qué significa realmente controlar el stock en tiempo real, por qué los métodos manuales fallan, cómo implementarlo en cinco pasos y cómo usar el kardex para encontrar dónde se pierde la mercadería.

## Qué significa tener el stock al día

El principio es sencillo: **todo movimiento de mercadería nace de un documento**. El sistema no espera a que alguien actualice una hoja; se mueve con los comprobantes que ya generas.

| Movimiento | Documento que lo origina | Efecto en el stock |
| --- | --- | --- |

| Venta | Boleta, factura o nota de venta | Sale del almacén al emitirse |

| Compra | Orden de compra o registro de compra | Entra cuando recibes la mercadería |

| Traslado | Documento de transferencia entre almacenes | Sale de un local y entra en otro |

| Merma o rotura | Ajuste de inventario con motivo | Baja con el nombre de quien lo registró |

| Devolución de cliente | Nota de crédito | Regresa al almacén |

Si se respeta la regla de que nada se mueve sin documento, lo que marca la pantalla y lo que hay en el anaquel coinciden.

## Los límites del cuaderno y del Excel cuando creces

Mientras el negocio lo maneja una sola persona, un Excel bien llevado puede funcionar. Los problemas empiezan cuando creces.

### Más de un vendedor

Dos personas que actualizan el mismo archivo terminan sobrescribiendo los datos del otro. Aparecen copias como “stock_final_ahora_si.xlsx” y nadie sabe cuál vale.

Además, el registro siempre llega **tarde**: el vendedor anota la salida cuando se acuerda. En ese intervalo, el stock que ves no es real. Es lo que le pasó a don Julio con el cemento.

### Más de un local

Cada tienda lleva su propio archivo y nadie ve el total. Puede faltarte un producto en tu local de Miraflores mientras en el de San Juan de Lurigancho tienes de sobra. Sin saberlo, vuelves a comprar algo que ya tienes.

### Cuando quieres saber cuánto ganas

Una hoja de cálculo te dice cuántas unidades tienes, pero rara vez cuánto te costó cada una. Sin costo real no conoces tu margen, y sin margen pones precios a ciegas. Profundizamos en eso en [inventario valorizado vs. simple](https://www.sistemafacturacionperu.com/blog/inventario-valorizado-vs-simple/).

Y lo más básico: el cuaderno se moja o se pierde, el archivo se daña, y ninguno de los dos te avisa cuando se está acabando tu producto más vendido.

## Implementa tu control en tiempo real en cinco pasos

### Paso 1: ordena tu catálogo

Todo parte de aquí. Cada producto debe tener un **código único**: el código de barras del fabricante o uno interno que imprimas en una etiqueta. Además, define:

- **Unidades y presentaciones.** Vendes por unidad, por caja de 24 o por saco de 50 kg; el sistema debe convertir entre ellas.

- **Variantes.** Un zapato talla 38 no es el mismo producto que uno talla 40; un polo rojo no es igual a uno negro.

- **Categoría y marca,** para que tus reportes tengan sentido.

- **Lote y vencimiento,** si vendes medicamentos, alimentos o cualquier producto perecible.

Un catálogo desordenado contamina todo lo que viene después. Vale la pena hacerlo bien una sola vez.

### Paso 2: haz un conteo físico inicial

Antes de empezar, cuenta lo que realmente tienes. Esa toma de **inventario físico** será el punto de partida para que el sistema arranque con saldos reales.

Para que no se convierta en un caos:

- Escoge un día de cierre o un horario de poca venta.

- Detén los movimientos mientras cuentas: no entra ni sale nada.

- Cuenta por zonas del almacén (estante por estante) y no por lista alfabética.

- Los productos más caros que los cuenten dos personas distintas.

- Carga el conteo y registra el **ajuste** de las diferencias.

### Paso 3: configura el stock mínimo

El **stock mínimo** es el nivel en el que debes reponer. Para fijarlo necesitas tu ritmo de venta y el tiempo que demora en llegar cada pedido.

**Ejemplo:** una botica en Piura vende 15 cajas de paracetamol por semana y su distribuidor entrega en una semana. Si quiere un margen de seguridad de unos días, su mínimo debería estar alrededor de 20 cajas. Al configurarlo, el sistema le **avisa** antes de quedarse sin producto.

### Paso 4: registra todas las entradas y salidas

Esta disciplina sostiene todo el sistema:

- **Entradas:** compras, devoluciones de clientes, traslados recibidos y ajustes por sobrantes.

- **Salidas:** ventas, devoluciones a proveedores, traslados enviados, consumo interno, mermas y roturas.

Lo más difícil es registrar las mermas y el consumo interno, porque a nadie le gusta anotar una pérdida. Pero ahí suele estar el dinero que “desaparece”.

La forma más práctica es que las ventas descuenten el stock automáticamente desde el [sistema POS](https://www.sistemafacturacionperu.com/sistema-pos/). Así el vendedor no tiene que anotar nada.

### Paso 5: revisa el kardex con frecuencia

El kardex te dice si el sistema refleja la realidad. Revísalo cada vez que un saldo no cuadre y, como rutina, una vez a la semana en tus productos principales.

## El kardex: el historial de cada producto

El **kardex** es el registro de todos los movimientos de un producto: cuándo ocurrió, qué tipo de movimiento fue, con qué documento, cuántas unidades ingresaron o salieron y con qué saldo quedó. Es como un estado de cuenta, pero de tu mercadería.

Cuando falta stock, el kardex te muestra **en qué punto se rompió la cadena**: una venta que no se registró, una compra mal ingresada o un traslado que salió de un local y nunca llegó al otro.

| Tipo de kardex | Qué controla | Ejemplo |
| --- | --- | --- |

| Kardex de unidades | Solo cantidades | Te quedan 90 galones de pintura |

| Kardex valorizado | Cantidades y costos (por ejemplo, costo promedio ponderado) | Esos 90 galones te costaron en promedio S/ 42.50 cada uno |

Si siempre compras al mismo precio, un kardex de unidades puede bastarte. Cuando el precio de tu proveedor sube o baja de un pedido a otro, el **valorizado** es el que te muestra el margen verdadero.

## Cómo evitar quedarte sin stock

Un **quiebre de stock** es una venta que ya estaba hecha y se perdió. Para prevenirlo:

- **Revisa las alertas de stock mínimo** cada lunes, no cuando el anaquel ya está vacío.

- **Fíjate en la rotación.** Un producto que vende 60 unidades por semana necesita más reserva que uno que vende tres.

- **Prepárate para las temporadas.** Campaña escolar, Día de la Madre, Fiestas Patrias y Navidad cambian la demanda; compara con el mismo mes del año anterior.

- **Usa órdenes de compra.** Así sabes qué está en camino y no repites pedidos.

- **Revisa el stock de todos tus locales antes de comprar.** A veces basta con un traslado.

## Cómo controlar mermas y pérdidas

Todo negocio tiene mermas: productos que se rompen, vencen o se deterioran. El problema es cuando nadie las ve.

- **Registra cada merma con su motivo:** rotura, vencimiento, deterioro, consumo interno o faltante en el conteo.

- **Controla lotes y vencimientos** para vender primero lo que vence antes.

- **Compara la merma con tus ventas** cada mes. Si sube de golpe, revisa cómo se manipula, almacena o controla la mercadería.

- **Asigna usuarios y permisos.** Así cada ajuste lleva la firma de quien lo hizo y la hora exacta; es orden, no sospecha.

- **Gestiona devoluciones a proveedores** para no asumir tú el costo de la mercadería fallada.

## Varios almacenes, un solo control

Con la función de **varios almacenes**, el sistema lleva un saldo aparte para cada tienda, depósito o trastienda, y suma el total por ti. Así puedes:

- Ver el stock de cada local y el de toda la empresa en una misma pantalla.

- Hacer **traslados con documento** en lugar de mover cajas sin registro.

- Detectar qué productos sobran en un local y faltan en otro.

- Dar a cada encargado acceso solo a su almacén.

## Tu rutina semanal en 30 minutos

- Revisa las **alertas de stock mínimo** y prepara la orden de compra.

- Identifica los **productos sin movimiento** en los últimos 60 días: es dinero detenido.

- Cuenta a mano un grupo pequeño de productos (cambia de grupo cada semana) y registra el ajuste.

- Lee el **reporte de mermas** y fíjate en los motivos.

- Contrasta tus precios de venta con la **ganancia que deja cada producto**.

Media hora a la semana te evita sorpresas al cierre del mes.

## Controla tu inventario con Sistema Facturación Perú

En Sistema Facturación Perú, el inventario y el kardex funcionan dentro del mismo sistema que tus ventas y tus comprobantes electrónicos: cada boleta o factura descuenta el stock al momento. Los **varios almacenes** y el **kardex valorizado** llegan con el Plan PRO. Mira todas las funciones del [sistema de inventario](https://www.sistemafacturacionperu.com/sistema-de-inventario/) y compara los planes en la página de [precios](https://www.sistemafacturacionperu.com/precios/).

¿Te gustaría ver tus productos moviéndose en tiempo real? [Agenda una demo gratuita](https://www.sistemafacturacionperu.com/contacto/) y te enseñamos cómo cargar tus productos, cómo baja el stock con cada venta y cómo leer el kardex.

---

# Nuevo RUS, RER, RMT o General: qué régimen elegir en 2026

URL: https://www.sistemafacturacionperu.com/blog/nrus-rer-rmt-regimen-tributario/
Publicado: 2026-08-12 · Actualizado: 2026-10-27 · Categoría: Tributación

Compara los cuatro regímenes tributarios del Perú: topes, tasas, libros y comprobantes que permite cada uno, con ejemplos en soles para decidir mejor.

El régimen tributario se elige en un minuto, casi siempre el día que sacas el RUC, y luego se queda ahí por años. Es una decisión que pocos revisan hasta que algo falla: una empresa te pide factura y no puedes dársela, o tu contador te cuenta que estás pagando impuesto sobre todo lo que vendes aunque tu margen sea mínimo.

Esta guía te ayuda a revisar esa elección con calma. Primero verás qué cambia de un régimen a otro, luego el detalle de cada uno y, al final, dos ejemplos con números para comparar el RER con el RMT, que es donde más dudas aparecen.

## Lo que cambia de un régimen a otro

Cada régimen responde de forma distinta a cinco preguntas prácticas:

- **¿Quién puede entrar?** Algunos aceptan solo personas naturales; otros también empresas.

- **¿Hasta cuánto puedes vender?** Cada uno tiene su techo de ingresos (salvo el General).

- **¿Qué comprobantes puedes entregar?** Este punto define si puedes venderle a otras empresas.

- **¿Qué libros debes llevar?** Desde ninguno hasta contabilidad completa.

- **¿Cómo y cuánto pagas?** Cuota fija, porcentaje sobre ventas o tasa sobre la utilidad.

### Un dato previo: la UIT de 2026

Muchos límites se expresan en **Unidades Impositivas Tributarias (UIT)**. Para el ejercicio 2026, la UIT se fijó en **S/ 5,500** mediante el Decreto Supremo 301-2025-EF. Se actualiza cada año, así que cuando leas esto en otro ejercicio, confirma el valor vigente.

## Nuevo RUS (NRUS)

### Para quién es

Para el comercio y los oficios de barrio que le venden al público final: una bodega en Villa El Salvador, un puesto en el mercado de Huancayo, una peluquería, un taller de calzado o una zapatería pequeña. Solo pueden acogerse **personas naturales y sucesiones indivisas**; una EIRL, SRL o SAC queda fuera.

### Límites que no puedes cruzar

- Ingresos brutos o compras de hasta **S/ 8,000 mensuales** y **S/ 96,000 al año**.

- Activos fijos de la actividad hasta **S/ 70,000**, sin contar predios ni vehículos.

- Una **única unidad de explotación** (un solo local o puesto).

También hay giros que no pueden estar en el NRUS, entre ellos agencias de viaje, publicidad, notarías, martilleros, comisionistas, agentes de aduana, intermediarios de seguros y casinos o tragamonedas.

### Qué comprobantes entrega

Este es el límite que más negocios descubren tarde: **en el NRUS no se emiten facturas**. Solo puedes entregar **boletas de venta** y **tickets de máquina registradora**, que no dan derecho a crédito fiscal ni sirven para sustentar costo o gasto de tu cliente.

Piénsalo así: si un restaurante quiere comprarte S/ 3,500 en insumos cada mes y necesita factura para su contabilidad, tendrá que comprarle a otro. Es el motivo más común por el que un negocio decide salir del NRUS.

### Cómo paga

No hay declaración mensual de IGV y renta ni declaración anual. Pagas una **cuota fija cada mes**, que sustituye al IGV, al Impuesto de Promoción Municipal y al impuesto a la renta. Tampoco debes llevar libros contables.

| Categoría | Ingresos brutos o compras del mes | Cuota |
| --- | --- | --- |

| 1 | De S/ 0 a S/ 5,000 | S/ 20 |

| 2 | Desde S/ 5,000.01 hasta S/ 8,000 | S/ 50 |

| Especial | Ingresos y compras de hasta S/ 60,000 al año | S/ 0 |

La **categoría especial** es estrecha: solo cubre a quienes venden frutas, hortalizas, legumbres, tubérculos, raíces o semillas en mercados de abastos, y a quienes cultivan y venden su producción sin transformarla. Hay que pedirla a SUNAT con el Formulario 2010.

## Régimen Especial de Renta (RER)

### Para quién es

Para negocios pequeños, de persona natural o de empresa, que venden lo que compran o fabrican, o que prestan servicios no excluidos. Es el paso lógico cuando necesitas facturar pero todavía no quieres llevar una contabilidad más exigente.

### Límites

- Ingresos netos o compras de hasta **S/ 525,000 en el año**.

- Activos fijos de hasta **S/ 126,000**, sin predios ni vehículos.

- No más de **10 trabajadores por turno**.

### Giros excluidos

La lista es más larga de lo que se suele pensar. Quedan fuera, entre otros: construcción; transporte de carga en vehículos de 2 toneladas o más y transporte de pasajeros; espectáculos públicos; casinos y tragamonedas; notarías, agencias de viaje y publicidad; y servicios profesionales como medicina, odontología, veterinaria, abogacía, contabilidad, auditoría, arquitectura, ingeniería, informática y asesoría empresarial.

### Comprobantes y libros

Puedes emitir **todos los comprobantes**: facturas, boletas, notas de crédito y débito y guías de remisión. Solo llevas **Registro de Ventas** y **Registro de Compras**.

### Cómo paga

Declaras cada mes mediante el **Formulario Virtual 621** y pagas el **1.5 % de tus ingresos netos** como impuesto a la renta, más el **18 %** por IGV e IPM (16 % de IGV y 2 % de Impuesto de Promoción Municipal) sobre tus ventas gravadas, descontando el crédito fiscal de tus compras. No presentas declaración anual de renta.

Ten en cuenta que ese 1.5 % se aplica sobre lo que **vendes**, no sobre lo que **ganas**. Por eso un negocio de reventa con margen pequeño puede terminar pagando bastante.

## Régimen MYPE Tributario (RMT)

### Para quién es

Es el régimen de la mayoría de pequeñas y medianas empresas. Pueden acogerse personas naturales y jurídicas cuyos ingresos netos anuales no pasen de **1,700 UIT**, es decir, **S/ 9,350,000** con la UIT de 2026. No limita trabajadores ni activos.

### Comprobantes

Todos, sin restricción.

### Libros según tus ingresos anuales

| Ingresos netos del año | Libros obligatorios |
| --- | --- |

| Hasta 300 UIT | Libro Diario de Formato Simplificado, Registro de Compras y Registro de Ventas |

| Sobre 300 UIT y hasta 500 UIT | Libro Mayor, Libro Diario, Registro de Compras y Registro de Ventas |

| Sobre 500 UIT y hasta 1,700 UIT | Los cuatro anteriores y, además, el Libro de Inventarios y Balances |

### Cómo paga

- **Cada mes:** IGV (18 %) y un **pago a cuenta del 1 %** de los ingresos netos, mientras tus ingresos del ejercicio no pasen de 300 UIT. Por encima de ese tramo, el pago a cuenta se calcula con el coeficiente o con el 1.5 %, el mayor de los dos.

- **Cada año:** declaración jurada anual, con tasa escalonada: **10 %** sobre la renta neta de hasta **15 UIT** (S/ 82,500 en 2026) y **29.5 %** sobre lo que exceda.

Lo clave del RMT es que el impuesto anual se calcula sobre la **utilidad**, después de restar costos y gastos sustentados. Los pagos a cuenta del mes se descuentan de ese impuesto anual.

## Régimen General

### Para quién es

Para empresas de cualquier tamaño, sin techo de ingresos, y para actividades que los demás regímenes no aceptan, como la construcción o el transporte de carga pesada.

### Comprobantes y libros

Emite todos los comprobantes. Los libros siguen los mismos tramos del RMT y, desde las **1,700 UIT** de ingresos, toca **contabilidad completa**: Registro de Compras, Registro de Ventas, Libro Diario, Libro Mayor, Libro Caja y Bancos y Libro de Inventarios y Balances.

### Cómo paga

Cada mes haces un pago a cuenta: se compara lo que resulta del coeficiente con el **1.5 %** de lo que ingresó en el periodo y se paga el mayor. Al cierre, presentas la declaración anual con una tasa única de **29.5 %** sobre la renta neta, sin tramo reducido.

## Cuadro comparativo

|  | Nuevo RUS | RER | RMT | Régimen General |
| --- | --- | --- | --- | --- |

| Pueden acogerse | Personas naturales y sucesiones indivisas | Personas naturales y jurídicas | Personas naturales y jurídicas | Personas naturales y jurídicas |

| Techo de ingresos | S/ 96,000 anuales (S/ 8,000 por mes) | S/ 525,000 anuales | 1,700 UIT anuales | Ninguno |

| Factura | **No** | Sí | Sí | Sí |

| Comprobantes | Boleta y ticket | Todos | Todos | Todos |

| IGV | Dentro de la cuota | 18 % | 18 % | 18 % |

| Renta | Cuota fija (S/ 20 o S/ 50) | 1.5 % de lo ingresado cada mes | Pago a cuenta de 1 %; anual de 10 % / 29.5 % | Coeficiente o 1.5 % a cuenta; 29.5 % anual |

| Libros | Ninguno | Ventas y Compras | Según tramo de ingresos | Según tramo, hasta contabilidad completa |

| Declaración anual | No | No | Sí | Sí |

## RER o RMT: dos ejemplos con números

Los siguientes cálculos son simplificados (no consideran gastos adicionales, pérdidas ni otras deducciones) y sirven para ver la lógica, no para reemplazar el análisis de tu contador.

### Abarrotes al por mayor en Huancayo: margen bajo

- Ventas netas: **S/ 40,000 al mes** (S/ 480,000 al año, dentro del tope del RER).

- Utilidad después de costos y gastos: **4 %**, es decir, S/ 19,200 al año.

|  | RER | RMT |
| --- | --- | --- |

| Renta del año | 1.5 % × S/ 480,000 = **S/ 7,200** | 10 % × S/ 19,200 = **S/ 1,920** |

En el RMT, los pagos a cuenta del 1 % suman S/ 4,800 en el año; como el impuesto anual es S/ 1,920, la diferencia queda como saldo a favor. Con un margen así de delgado, el RMT sale claramente más barato.

### Taller de confecciones en Gamarra: margen alto

- Ventas netas: **S/ 20,000 al mes** (S/ 240,000 al año).

- Utilidad: **40 %**, o sea, S/ 96,000 al año.

|  | RER | RMT |
| --- | --- | --- |

| Renta del año | 1.5 % × S/ 240,000 = **S/ 3,600** | 10 % × S/ 82,500 + 29.5 % × S/ 13,500 = **S/ 12,232.50** |

Aquí el resultado se invierte: con buen margen, tributar sobre ventas en el RER puede convenir más, siempre que el giro no esté excluido y no superes sus topes.

## Cuándo puedes cambiarte

El cambio tiene fechas, y equivocarte de mes significa esperar un año.

| Quieres pasar a… | Si vienes de… | Cuándo |
| --- | --- | --- |

| Nuevo RUS | Cualquier régimen | Solo con la declaración y el pago del periodo de enero |

| RER | Nuevo RUS | En cualquier mes del año |

| RER | RMT o Régimen General | Con la declaración del periodo de enero |

| RMT | Nuevo RUS o RER | En cualquier mes del año |

| RMT | Régimen General | Desde enero del ejercicio siguiente |

| Régimen General | Cualquier régimen | En cualquier mes del año |

Además, hay cambios que no se eligen: **si superas los límites de tu régimen, el traslado se vuelve obligatorio** desde el periodo que señala la norma. Como cada caso tiene sus particularidades, valida el tuyo con tu contador o en la orientación de SUNAT antes de presentar el trámite.

## Señales de que tu régimen ya no te queda

- **Rechazas ventas por no poder facturar.** Si estás en el NRUS y pierdes clientes con RUC, es hora de cambiar. Antes, compara la [factura electrónica](https://www.sistemafacturacionperu.com/factura-electronica/) con la [boleta electrónica](https://www.sistemafacturacionperu.com/boleta-electronica/) para saber qué vas a emitir.

- **Ves venir el tope.** Si ya estás cerca de los S/ 8,000 mensuales en el NRUS o de los S/ 525,000 anuales en el RER, planifica el salto con tiempo en lugar de hacerlo a la fuerza a mitad de ejercicio.

- **Tu margen es pequeño y estás en el RER.** Como viste en el ejemplo de Huancayo, el RMT puede ahorrarte buena parte del impuesto.

- **Vas a contratar.** Con más de 10 personas por turno, el RER deja de ser opción.

- **Cambias de giro.** Si empiezas a hacer obras, a transportar carga pesada o a prestar servicios profesionales, sales del RER.

- **Compras equipos.** Una cámara de frío, una camioneta de reparto o maquinaria pueden hacerte superar los topes de activos (NRUS: S/ 70,000; RER: S/ 126,000) sin que lo notes.

## Un detalle aparte: hay tasas especiales temporales

Algunos rubros, como restaurantes y alojamientos que califican como MYPE, han tenido tasas reducidas de IGV de forma temporal en los últimos años. Si es tu caso, revisa con tu contador la tasa vigente para el periodo que vas a declarar y asegúrate de que tu sistema de facturación la tenga configurada.

## Tu régimen cambia; la facturación electrónica se queda

Revisar tu régimen una vez al año con tus números a la mano cuesta mucho menos que corregir un cambio mal hecho: multas, comprobantes que no correspondían y clientes que no pudieron usar su crédito fiscal.

Lo que no cambia, estés donde estés, es la obligación de emitir comprobantes electrónicos. Con [Sistema Facturación Perú](https://www.sistemafacturacionperu.com/sistema-facturacion-electronica/) emites los comprobantes electrónicos de SUNAT desde un mismo panel, el sistema valida los datos antes de enviarlos, arma los resúmenes diarios y deja tus registros de ventas y compras listos para exportar a CONCAR, SISCONT, CONTASIS y otros programas contables.

Sobre los planes:

- El **Plan Básico (S/ 49 + IGV al mes)** ya emite **boletas y facturas electrónicas** ante SUNAT, pensado para 3 usuarios en un solo local y con 300 comprobantes mensuales como máximo.

- Si tu negocio tiene más locales o necesita SIRE, exportación contable y un portal para tu contador, el indicado es el **Plan PRO (S/ 149 + IGV al mes)**, que da cabida a 10 usuarios y 3 locales y no limita tus comprobantes.

Encuentra el detalle en [planes y precios](https://www.sistemafacturacionperu.com/precios/). Y si no tienes claro en qué régimen estás o a cuál te conviene pasar, [escríbenos](https://www.sistemafacturacionperu.com/contacto/): revisamos contigo qué tipo de comprobantes necesitas y dejamos el sistema configurado para que emitas sin sobresaltos.

---

# Sistema ERP o software contable: qué le hace falta a tu empresa

URL: https://www.sistemafacturacionperu.com/blog/erp-vs-software-contable/
Publicado: 2026-08-07 · Categoría: Gestión

Un software contable ordena tus libros; un sistema ERP ordena toda la operación. Compara funciones, usuarios y costos, y elige lo que tu negocio necesita hoy.

Rosa maneja una distribuidora de abarrotes en Huancayo. El año pasado su contador le recomendó un software contable y lo compró. Los libros salen a tiempo y las declaraciones también. Pero cada lunes sigue sin saber cuántos sacos de azúcar le quedan, qué bodeguero le debe desde hace dos meses ni qué producto le deja más utilidad. El software funciona bien; solo que **resuelve un problema distinto al que ella tiene**.

Esa confusión es frecuente: «software contable» y «sistema ERP» se usan como si fueran lo mismo. No lo son. Aquí te explicamos qué hace cada uno, quién lo usa y cómo decidir sin pagar por algo que no vas a aprovechar.

## Dos preguntas que se responden con herramientas distintas

Piensa en tu negocio con dos preguntas:

- **«¿Cómo dejo todo en regla ante SUNAT?»** Esa es la pregunta del software contable.

- **«¿Cómo vendo, compro y controlo mi stock cada día?»** Esa es la pregunta del sistema ERP.

La primera mira hacia atrás: toma lo que ya ocurrió y lo convierte en libros, estados y declaraciones. La segunda mira el presente: registra cada venta, compra y movimiento en el momento en que sucede.

## El software contable, en la práctica

Es la herramienta de trabajo del **contador** o del área contable. Recibe información de operaciones ya realizadas y la ordena según el Plan Contable General Empresarial y las reglas tributarias.

Normalmente te permite:

- Llevar el plan de cuentas y los asientos contables.

- Preparar el libro diario, el libro mayor y los registros de ventas y de compras.

- Generar balances, estado de resultados y otros estados financieros.

- Ordenar la información que se usa en las declaraciones mensuales y en la anual.

Lo que **no** suele hacer: cobrar en el mostrador, descontar stock al vender, armar una cotización para un cliente o avisarte que te estás quedando sin mercadería. Esas tareas ocurren antes de que la información llegue al contador.

## El sistema ERP, en la práctica

ERP viene del inglés *Enterprise Resource Planning*, algo así como planificación de los recursos de la empresa. La idea es sencilla: **un solo sistema para toda la operación**, en lugar de un programa para vender, un Excel para el stock y un cuaderno para las cuentas por cobrar.

Un ERP pensado para empresas peruanas, como [Sistema Facturación Perú](https://www.sistemafacturacionperu.com/), reúne en un mismo lugar:

- **Ventas:** facturas, boletas, notas de crédito y débito y guías de remisión electrónicas, más cotizaciones, pedidos y notas de venta.

- **Punto de venta en la nube** con caja chica, para cobrar en el local.

- **Inventario y kardex**, con varios almacenes y sucursales.

- **Compras** y registro de proveedores.

- **Clientes**, con su historial de compras y lo que tienen pendiente.

- **Reportes** de ventas, productos, caja y utilidad.

- **Exportación contable** a CONCAR, SISCONT, CONTASIS, FOXCONT, ADSOFT y SUMERIUS.

Lo usan el **dueño, los vendedores, el cajero, el almacenero y la administración**, cada uno con su usuario y sus permisos. La contabilidad no desaparece: pasa a ser una consecuencia ordenada de lo que el sistema ya registró.

## Cara a cara: software contable y sistema ERP

| Aspecto | Software contable | Sistema ERP |
| --- | --- | --- |

| Pregunta que responde | ¿Cómo cumplo y declaro? | ¿Cómo opero y controlo? |

| Quién lo usa | El contador | Todo el equipo del negocio |

| Cuándo se registra la información | Después de que ocurre la operación | En el momento en que ocurre |

| Emisión de comprobantes electrónicos | Rara vez | Integrada a la venta |

| Stock por almacén y kardex | No | Sí |

| Punto de venta y caja | No | Sí |

| Cotizaciones, pedidos y compras | No | Sí |

| Tipo de reportes | Estados financieros y tributarios | De gestión, y además alimenta los contables |

| Para qué te sirve | Cumplir con SUNAT | Decidir mejor cada semana |

## Señales de que ya necesitas un ERP

Si te reconoces en dos o más de estas situaciones, el software contable ya no te alcanza por sí solo:

- **Digitas la misma venta dos veces:** una para facturar y otra en el Excel de stock.

- **Descubres los quiebres de stock cuando el cliente ya está en el mostrador.**

- **Tienes más de un local** y no sabes qué hay en cada uno sin llamar por teléfono.

- **Tu contador te pide cada mes un paquete de archivos** que tardas días en juntar.

- **No sabes qué productos te dejan margen** y cuáles solo mueven volumen.

- **Las cuentas por cobrar viven en la memoria** del vendedor o en un cuaderno.

## Cuándo un software contable es suficiente

No todo negocio necesita un ERP desde el primer día. Puede bastarte con el software de tu contador si:

- Ofreces servicios sin inventario, por ejemplo una consultoría o un estudio de arquitectura en Miraflores.

- Emites pocos comprobantes al mes y ya tienes una forma cómoda de hacerlo.

- No tienes personal de ventas ni de almacén que necesite registrar operaciones.

Incluso en esos casos, conviene que tus comprobantes electrónicos salgan de un sistema que luego le entregue la información al contador sin reescribirla.

## Lo ideal: que los dos conversen

No es una elección de «uno u otro». El esquema que mejor funciona en una pyme peruana es este: **el ERP registra la operación y el software contable recibe la información ya lista**.

### Un mes típico con ambos conectados

- Durante el mes, tu equipo vende, compra y mueve stock en el ERP. Cada comprobante sale validado por SUNAT.

- Al cierre, el sistema arma tus registros de ventas y compras con lo que ya está registrado.

- Exportas el archivo en el formato del software de tu contador (CONCAR, SISCONT, CONTASIS u otro de la lista).

- Tu contador importa, revisa y contabiliza, sin volver a digitar cientos de comprobantes.

- Con el **SIRE** de SUNAT (RVIE para ventas y RCE para compras), la información del sistema te ayuda a contrastar la propuesta que te presenta SUNAT antes de aceptarla.

El resultado: menos errores de digitación, cierres más rápidos y un contador que dedica su tiempo a asesorarte en lugar de transcribir.

## Lo que gana una pyme cuando centraliza su operación

- **Una sola versión de los números.** Ventas, stock y caja salen de la misma base, y no de tres archivos que nunca cuadran.

- **Horas recuperadas.** Lo que se registra una vez no se vuelve a escribir.

- **Precios con fundamento.** Al conocer el costo real de cada producto, sabes dónde subir, dónde mantener y dónde dejar de vender.

- **Acceso desde cualquier lugar.** Al estar en la nube, revisas la caja de tu local de Huancayo desde Lima o desde el celular.

- **Crecimiento ordenado.** Abrir una sucursal o sumar un vendedor es crear un usuario, no rehacer todo el sistema.

## Da el siguiente paso con Sistema Facturación Perú

Sistema Facturación Perú une la facturación electrónica, el punto de venta, el inventario, las compras y los reportes en una sola plataforma, y le entrega a tu contador la información en el formato que ya usa. Si quieres ver cómo se conecta con la parte contable, revisa nuestro [software contable](https://www.sistemafacturacionperu.com/sistema-contable/).

Los planes parten de S/ 37 mensuales en tarifa anual (S/ 49 en la mensual), más IGV, y no tienen contratos forzosos; compáralos en la [página de precios](https://www.sistemafacturacionperu.com/precios/). Y si prefieres verlo funcionando con tus propios productos, [agenda una demo gratuita](https://www.sistemafacturacionperu.com/contacto/) y te mostramos cómo quedaría tu negocio ordenado de punta a punta.

---

# Sistema POS en Perú: ventajas reales para tu caja y tu stock

URL: https://www.sistemafacturacionperu.com/blog/beneficios-de-un-pos-para-negocios/
Publicado: 2026-08-06 · Actualizado: 2026-10-27 · Categoría: Punto de venta

Un sistema POS acelera el cobro, cuadra la caja y descuenta el stock en cada venta. Mira qué gana tu negocio, cómo medirlo y cuánto cuesta empezar.

Piensa en una ferretería de Trujillo un sábado a mediodía. Hay cinco personas esperando, el vendedor busca el precio de un codo de PVC en una lista plastificada, la calculadora se queda sin pila y alguien pregunta si aceptan Yape. Al cierre, la caja tiene S/ 35 menos de lo que debería y nadie sabe por qué.

Un **sistema POS** (punto de venta) existe para que ese sábado sea distinto. No se trata de “modernizarse” por moda: se trata de cobrar más rápido, saber qué tienes en el almacén y dejar de perder dinero en detalles que nadie ve.

En este artículo repasamos las ventajas que un POS le da a un negocio peruano, agrupadas por área, y para cada una te dejamos un indicador sencillo para comprobar si de verdad está funcionando. Al final verás las señales de que ya lo necesitas, cuánto cuesta y cómo arrancar sin frenar la atención.

## En el mostrador: cobros rápidos y sin errores

### La venta se arma escaneando

Con un lector de código de barras, el cajero pasa el producto y el sistema pone el precio, suma el IGV y muestra el total. Nadie consulta listas ni hace cuentas a mano, así que la fila avanza.

Si tu negocio vende a granel —una bodega en Arequipa que despacha arroz o azúcar por kilo, una verdulería en un mercado de Lima—, la **balanza** conectada pasa el peso directo a la venta. Y cuando el cliente quiere pagar una parte en efectivo y otra con Yape o tarjeta, el POS registra ese **pago mixto** como una sola operación.

**Indicador para medir:** cuánto tarda una venta típica, desde el primer producto hasta el ticket, y cuántas personas abandonan la fila en tus horas de más movimiento.

### Precios y promociones iguales para todos

El precio no depende de la memoria del cajero ni de quién esté de turno. Las **promociones y descuentos** se configuran una vez y se aplican igual a las 8 de la mañana que a las 9 de la noche, estés tú en el local o no.

Cada acción queda además en el **log de actividad** con el nombre del usuario. Si alguien anula una venta o aplica un descuento fuera de lo normal, sabes quién fue y cuándo.

**Indicador para medir:** la brecha, por turno, entre lo que el sistema dice que se debió cobrar y lo que realmente entró.

### Clientes con nombre y no solo tickets

Al escribir el RUC o el DNI, el sistema **consulta y completa los datos** del cliente. Con eso se va armando un historial: qué compra, cada cuánto, si tiene **días de crédito**, cuánto te debe, su estado de cuenta y sus **puntos de fidelidad**.

El comprobante puede salir también por **WhatsApp o correo**, así que tu cliente lo conserva aunque bote el papel.

**Indicador para medir:** qué porcentaje de tus ventas tiene un cliente identificado y cuánto gasta en promedio quien vuelve a comprar.

## En el almacén: stock que se mueve solo

### Cada venta descuenta su producto

Apenas emites el ticket, la boleta o la factura, el producto sale del inventario. No hay que pasar nada a un cuaderno al final del día ni actualizar una hoja de cálculo que siempre queda a medias.

### Alertas antes de quedarte sin nada

Si configuras un **stock mínimo** para tus productos de más salida, el sistema te avisa a tiempo para reponer. Así evitas el peor escenario de cualquier tienda: el cliente que llega con la plata en la mano y se va porque no tenías lo que buscaba.

**Indicador para medir:** cuántas veces al mes el sistema mostraba stock de un producto que en realidad ya no estaba en el anaquel.

Si tu catálogo es amplio, vale la pena que el POS trabaje junto a un [sistema de inventario con kardex](https://www.sistemafacturacionperu.com/sistema-de-inventario/) y no solo con un contador de unidades.

## En la caja: cierres que cuadran

El POS maneja la **apertura y el cierre de caja con arqueo**, y puedes tener varias cajas en un mismo local. Al terminar el turno, el cajero cuenta lo que tiene en la gaveta y el sistema lo compara con lo registrado. Si falta algo, lo ves ese mismo día y sabes en qué turno pasó, en vez de descubrirlo al cerrar el mes.

**Indicador para medir:** soles de diferencia por cierre y por cajero. Si hoy no tienes ese número, probablemente ya estás perdiendo dinero sin notarlo.

## En la oficina: decisiones con datos

### Reportes que responden preguntas concretas

Un POS te muestra las **ventas por producto, por vendedor, por hora del día y por sucursal**, junto con la **utilidad de cada venta y de cada producto**. Con eso respondes preguntas que antes eran intuición: ¿a qué hora conviene reforzar la caja?, ¿qué vendedor cierra más?, ¿qué producto ocupa espacio sin dejar ganancia?

Suele haber sorpresas. El artículo que más vende rara vez es el que más margen deja. Con esa información ajustas precios, decides qué comprar y qué merece el mejor lugar del exhibidor. Los reportes se descargan en **Excel o PDF** para revisarlos con tu contador.

**Indicador para medir:** compara tu top 10 de productos por ventas con tu top 10 por utilidad. Casi nunca coinciden.

### Crecer a otro local sin empezar de cero

El día que abres una segunda tienda, el mismo sistema administra **varias sucursales con sus propias series**, suma cajas, crea usuarios con **roles y permisos** distintos y separa el stock de cada almacén. El historial no se pierde y no tienes que migrar nada.

Como el POS funciona en la web, revisas cómo va el día desde el celular aunque estés de viaje en Cusco o en una reunión con proveedores.

**Indicador para medir:** cuántos días te tomó poner a vender la segunda sucursal comparado con la primera.

## Frente a SUNAT: el comprobante sale con la venta

### Vender y facturar es un solo paso

En un POS integrado, la **boleta o factura electrónica** se genera en el mismo momento del cobro. El sistema la firma y la envía a SUNAT, ya sea de forma directa o mediante un OSE o PSE autorizado. Tanto el XML como la constancia de recepción (CDR) se archivan en la nube. Desde esa misma plataforma preparas también los **resúmenes diarios** de boletas y las **comunicaciones de baja**.

Cuando vender y emitir comprobantes van por caminos separados, aparecen los errores: montos que no coinciden, comprobantes olvidados, envíos fuera de plazo. Juntar ambos procesos elimina buena parte de esos problemas. Si quieres entender todo el proceso, revisa nuestra guía de [facturación electrónica SUNAT](https://www.sistemafacturacionperu.com/sistema-facturacion-electronica/).

**Indicador para medir:** horas al mes que pasabas emitiendo comprobantes aparte y cuántos te rechazó SUNAT.

### La venta sigue aunque SUNAT falle

Los servicios de SUNAT a veces se ponen lentos o se caen. Un POS pensado para el Perú lo tiene previsto: **servidor alterno** y **comprobantes de contingencia** para seguir cobrando. Atiendes con normalidad y regularizas los envíos cuando el servicio vuelve.

**Indicador para medir:** cuántas ventas se te escaparon cuando SUNAT tuvo intermitencias.

## Resumen de ventajas e indicadores

| Ventaja | Qué mejora | Cómo lo mides |
| --- | --- | --- |

| Cobro con escáner y balanza | Velocidad en caja | Segundos por venta y clientes que se van |

| Precios centralizados y log | Errores y fugas | Diferencia entre lo esperado y lo cobrado |

| Stock automático y alertas | Quiebres de stock | Productos “fantasma” al mes |

| Arqueo de caja | Faltantes | Soles de descuadre por turno |

| Reportes de utilidad | Decisiones de compra y precio | Top 10 por ventas frente a top 10 por margen |

| Comprobante en el mismo cobro | Cumplimiento con SUNAT | Horas dedicadas y rechazos |

| Contingencia y modo offline | Continuidad | Ventas perdidas por caídas |

| Multisucursal | Crecimiento | Días para abrir un nuevo local |

| Clientes identificados | Recompra | Ticket promedio de clientes frecuentes |

## Señales de que tu negocio ya necesita un POS

El tamaño importa menos de lo que crees. Fíjate en estas situaciones; si tres o más te suenan conocidas, el desorden ya te está costando:

- En las horas fuertes se forma cola porque cobrar toma demasiado.

- El cierre de caja casi nunca cuadra y el faltante queda sin explicación.

- Calculas “a ojo” qué se vende más y qué te deja ganancia.

- Te falta lo que más sale y te sobra lo que nadie compra.

- Cuando cuentas el almacén, los números no coinciden con tus apuntes.

- Emites los comprobantes al final del día, apurado y con la lista en papel.

- Tienes dos o más locales y ninguno sabe lo que pasa en el otro.

- No puedes ausentarte un día sin perder el control de lo que se vendió.

## ¿Cuánto cuesta un sistema POS en Perú?

En el mercado peruano, muchos sistemas de gestión para pequeños negocios cobran alrededor de **S/ 60 a S/ 99 mensuales**, y es común que los planes básicos limiten la cantidad de comprobantes.

En **Sistema Facturación Perú**, la caja, el control de stock y el POS vienen en todos los planes, desde el **Plan Básico, a S/ 49 al mes más IGV**, que además emite boletas y facturas electrónicas válidas ante SUNAT. Su capacidad: 3 usuarios, un local y un máximo de 300 comprobantes mensuales. Cuando tu negocio crezca, el **Plan PRO (S/ 149 + IGV)** lleva tu equipo a 10 usuarios y tus locales a 3, sin tope de emisión, y agrega varios almacenes y kardex valorizado. Y no hay contratos forzosos.

Haz la cuenta al revés: si cada semana se te van S/ 40 entre descuadres y ventas perdidas, al mes son unos S/ 160. El sistema se paga con lo que dejas de perder.

## Cómo arrancar sin frenar la atención

- **Prepara el catálogo antes del primer día:** códigos de barras, precios y unidades de medida.

- **Cuenta tu stock real** para que el sistema empiece con saldos correctos.

- **Crea los usuarios y sus permisos:** decide quién puede anular ventas y quién puede hacer descuentos.

- **Instala y prueba la ticketera** (80, 58 o 50 mm) con una venta completa, de principio a fin.

- **Trabaja una semana en paralelo** con tu método actual y compara los cierres de caja de ambos.

## Prueba el sistema POS con tus propios productos

Si quieres ver cómo quedaría tu caja funcionando con tu catálogo, revisa el [sistema POS de Sistema Facturación Perú](https://www.sistemafacturacionperu.com/sistema-pos/) y compara los planes en la página de [precios](https://www.sistemafacturacionperu.com/precios/). ¿Prefieres verlo en vivo? [Agenda una demo gratuita](https://www.sistemafacturacionperu.com/contacto/): verás una venta de punta a punta, desde el escaneo hasta el comprobante aceptado por SUNAT.

---

# Cómo funciona el sistema de facturación electrónica en Perú

URL: https://www.sistemafacturacionperu.com/blog/que-es-facturacion-electronica-peru/
Publicado: 2026-08-04 · Categoría: Facturación electrónica

Entiende la facturación electrónica en Perú: qué es el XML, la firma y el CDR, plazos de envío a SUNAT y qué necesitas para emitir desde tu negocio hoy.

Facturar electrónicamente en el Perú significa que **tus comprobantes de pago existen como archivos digitales** que SUNAT recibe, valida y registra, en lugar de hojas de un talonario. Cada venta se convierte en un archivo **XML** firmado; ese archivo llega a SUNAT (directamente o a través de un operador autorizado) y SUNAT responde con una **constancia de recepción, el CDR**. Lo que tiene valor tributario es ese XML aceptado, no la hoja o el ticket que entregas.

Para quien vende, todo esto pasa en segundos y sin ver nada técnico: eliges los productos, cobras, aprietas «emitir» y tu cliente recibe el comprobante en su correo o por WhatsApp. El **sistema de facturación electrónica** se encarga del resto. A continuación te contamos qué ocurre por dentro, qué plazos debes respetar y qué te hace falta para empezar.

## Quiénes están obligados y por qué

La obligación de emitir electrónicamente se fue extendiendo por etapas, según el nivel de ingresos de cada contribuyente. Con la última designación, vigente desde el **1 de junio de 2022**, prácticamente todo negocio con RUC pasó a ser **emisor electrónico**. Hoy el talonario físico solo queda para casos de excepción, como la contingencia.

¿Qué gana SUNAT? Ver tus ventas y compras casi en el momento en que suceden. Con esa información arma las propuestas del **SIRE** (el **RVIE** para ventas y el **RCE** para compras), cruza datos entre proveedores y clientes y detecta inconsistencias sin necesidad de visitarte.

¿Qué ganas tú? Menos papel, ningún comprobante extraviado, clientes que reciben su documento al instante y un contador que deja de transcribir lo que ya está registrado.

## Las piezas del sistema, explicadas sin tecnicismos

Antes de seguir, conviene tener claro el vocabulario. Estas son las palabras que vas a escuchar:

| Término | Qué es, en simple |
| --- | --- |

| **XML (UBL 2.1)** | El archivo que contiene la venta con el formato que exige SUNAT. Es el comprobante en sí |

| **Firma digital** | El sello que prueba que el XML salió de tu RUC y que nadie lo alteró después |

| **Certificado digital** | La credencial con la que se aplica esa firma. Tiene fecha de vencimiento |

| **OSE** | Operador de Servicios Electrónicos: empresa autorizada que valida tus comprobantes en nombre de SUNAT |

| **PSE** | Proveedor de Servicios Electrónicos: empresa que puede emitir y firmar por encargo tuyo |

| **CDR** | La respuesta oficial: indica si tu comprobante fue aceptado, aceptado con observaciones o rechazado |

| **Representación impresa** | El PDF o ticket que le entregas al cliente. Es una copia legible, no el documento con valor legal |

| **Resumen diario** | El envío agrupado con el que se informan las boletas del día |

| **Comunicación de baja** | El aviso con el que anulas un comprobante ya enviado |

Si quieres profundizar en los dos intermediarios, tenemos una guía sobre la [diferencia entre OSE y PSE](https://www.sistemafacturacionperu.com/blog/diferencia-ose-pse-sunat/).

## Una venta real, de principio a fin

Tomemos una librería en el centro de Cusco que le vende 30 cuadernos, 10 cajas de lapiceros y un paquete de papel bond a un colegio privado, que pide factura.

### Paso 1: el cajero arma la venta

Busca al cliente por su RUC (el sistema trae razón social y dirección), agrega los productos y elige la forma de pago. En ese momento el sistema construye el XML: datos de la librería y del colegio, serie y correlativo, cada línea indicando cantidad, unidad y si está gravada, exonerada o inafecta, subtotales, IGV y total. Si ese armado se hiciera a mano, cualquier campo mal puesto terminaría en rechazo; por eso es tarea del software.

### Paso 2: la firma

El XML se firma con un certificado digital. Quién aporta ese certificado depende del esquema: si emites directo a SUNAT, normalmente usas uno propio y debes renovarlo a tiempo; si trabajas con un PSE, este puede firmar por ti. Pregúntale a tu proveedor quién se encarga, para que el vencimiento no te tome por sorpresa. Más detalle en nuestra nota sobre el [certificado digital SUNAT](https://www.sistemafacturacionperu.com/blog/certificado-digital-sunat/).

### Paso 3: el envío

El archivo firmado sale hacia SUNAT o hacia el OSE. Con **Sistema Facturación Perú** puedes enviar directo a SUNAT o trabajar con OSE y PSE autorizados, como QPSE, SendFact o Validapse, según te convenga.

### Paso 4: la respuesta

Llega el CDR. Si dice **aceptado**, la factura vale. Si dice **aceptado con observaciones**, vale, pero conviene revisar qué se observó. Si dice **rechazado**, ese comprobante no existe para SUNAT y hay que emitir uno nuevo con los datos corregidos. Guarda siempre el CDR: en una fiscalización es tu prueba de que cumpliste.

### Paso 5: la entrega

Solo entonces el colegio recibe su factura: en PDF por correo, por WhatsApp, impresa en A4 o en ticket, o con un código QR para descargarla. La entrega va al final del recorrido.

## Plazos que no debes pasar por alto

| Comprobante | Cómo llega a SUNAT | Plazo |
| --- | --- | --- |

| Factura y sus notas | Envío individual | Máximo 3 días calendario, que se cuentan a partir del día posterior a su emisión |

| Boleta y sus notas | Resumen diario o envío individual | Dentro del plazo que fija SUNAT; lo más seguro es informarlas el mismo día |

Una factura enviada fuera de plazo **no tiene validez**, aunque el cliente ya tenga el PDF en la mano. En el caso de las boletas, SUNAT ha modificado los plazos más de una vez; en vez de apostar al último día, deja que tu sistema genere y envíe el resumen de forma automática al cierre de cada jornada.

## XML, PDF y CDR: cuál vale ante SUNAT

Es la confusión más frecuente al empezar, así que vale la pena repetirlo con otras palabras:

- El **XML** es el comprobante. Con él tu cliente sustenta su crédito fiscal y su gasto.

- El **PDF o ticket** es solo la versión para leer. Útil para el cliente, pero sin valor propio ante SUNAT.

- El **CDR** es el acuse de SUNAT sobre ese XML.

Cuando evalúes un sistema, pregunta si el XML y el CDR quedan almacenados y en qué momento puedes bajarlos. En Sistema Facturación Perú ambos se guardan en la nube y no dependen de la computadora desde la que emitiste.

## Tipos de comprobantes electrónicos

| Código | Comprobante | Para qué sirve |
| --- | --- | --- |

| 01 | Factura | Ventas a clientes con RUC; da derecho a crédito fiscal y sustenta costo o gasto. Lo detallamos en [todo sobre la factura electrónica](https://www.sistemafacturacionperu.com/factura-electronica/) |

| 03 | Boleta de venta | Ventas a consumidores finales. Si el importe pasa de **S/ 700**, debe llevar el tipo y número de documento del comprador. Amplía en [cómo funciona la boleta electrónica](https://www.sistemafacturacionperu.com/boleta-electronica/) |

| 07 | Nota de crédito | Reduce o anula un comprobante emitido: devoluciones, descuentos, correcciones |

| 08 | Nota de débito | Aumenta el importe de un comprobante: intereses, penalidades, cargos adicionales |

| 09 | Guía de remisión remitente | Sustenta el traslado de bienes por parte de quien los envía |

| 31 | Guía de remisión transportista | Sustenta el traslado cuando lo hace una empresa de transporte contratada |

| 20 | Comprobante de retención | Lo emiten los agentes de retención designados por SUNAT |

| 40 | Comprobante de percepción | Lo emiten los agentes de percepción designados por SUNAT |

Además existen los **resúmenes diarios**, las **comunicaciones de baja** y los **comprobantes de contingencia**, que se usan cuando, por causas ajenas, no es posible emitir electrónicamente y luego deben informarse a SUNAT.

## Lo que necesitas antes de tu primera factura

- **RUC activo y en condición de habido.** Si figuras como «no habido», regulariza: tus clientes no podrán usar el crédito fiscal de tus facturas.

- **Clave SOL**: con ella das de alta series, autorizas al sistema y lees tu buzón electrónico.

- **Condición de emisor electrónico**, que hoy es la regla y puedes confirmar en SUNAT Operaciones en Línea.

- **Un sistema de emisión**, que es la decisión con más impacto en tu día a día.

- **Certificado digital**, según el esquema de emisión que elijas (ver el paso 2).

## Tres maneras de emitir, comparadas

|  | Portal SOL (SEE-SOL) | Facturador SUNAT (SFS) | Sistema en la nube |
| --- | --- | --- | --- |

| Costo | Gratis | Gratis | Suscripción mensual |

| Certificado propio | No | Sí | Depende del esquema |

| Catálogo de productos | No | No | Sí |

| Caja e inventario | No | No | Según el sistema |

| Dónde funciona | Navegador, comprobante por comprobante | Una PC específica, con archivos que tú generas | Cualquier dispositivo con internet |

| Le sirve a | Quien emite pocos comprobantes al mes | Quien ya tiene un programa que genera los datos | Negocios con ventas diarias |

El **portal SOL** es cómodo para emitir pocas facturas, pero te obliga a digitar todo cada vez. El **Facturador SUNAT** pide conocimientos técnicos y te deja atado a esa computadora: si se malogra, dejas de emitir. Un **sistema en la nube** concentra venta, comprobante, stock, caja y reportes en un solo lugar; en el mercado peruano suele costar entre S/ 60 y S/ 99 al mes. En Sistema Facturación Perú, la emisión electrónica está desde el Plan Básico, a **S/ 49 + IGV** en tarifa mensual o S/ 37 mensuales en la anual; puedes compararlo en [nuestros planes](https://www.sistemafacturacionperu.com/precios/).

## Cuando SUNAT no responde

Las caídas del servicio ocurren, a veces en plena hora punta. Lo importante es que **no tienes que dejar de vender**: el comprobante se genera y firma en tu sistema, y el envío se repite cuando el servicio vuelve, siempre que estés dentro del plazo.

La diferencia está en cómo reacciona el software. Sistema Facturación Perú recurre al **servidor alterno de SUNAT** si el principal falla y cuenta con **modo offline**, de modo que la caja sigue atendiendo y los comprobantes pendientes se envían solos en cuanto hay respuesta. Lo que debes evitar es un sistema que se congela con una fila de clientes esperando en el mostrador.

## Emite tu primer comprobante con nosotros

La facturación electrónica deja de ser una carga cuando el sistema hace la parte difícil: revisar los datos antes del envío, cuidar series y correlativos, guardar el XML y el CDR, enviar los resúmenes diarios y mostrarte en un solo panel qué comprobantes están aceptados, observados, rechazados o pendientes.

Conoce cómo funciona la [facturación electrónica SUNAT en Sistema Facturación Perú](https://www.sistemafacturacionperu.com/sistema-facturacion-electronica/), revisa los [planes y precios](https://www.sistemafacturacionperu.com/precios/) o [escríbenos para una demostración gratuita](https://www.sistemafacturacionperu.com/contacto/): te ayudamos a dejar listos tu RUC y tus series, y emitimos juntos tu primer comprobante.