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

# Facturación (Piriod)

> Gestión de suscripciones, cobros y documentos tributarios del estudio

## Sistema de facturación

NSS usa **Piriod** (piriod.com) como plataforma de facturación y gestión de suscripciones.

## Estructura

El estudio opera con dos entidades:

* **NSS Limitada** — Entidad principal
* **NSS SpA** — Entidad secundaria

## Regla absoluta: Solo documentos exentos

> [!WARNING]
>
> NSS Abogados emite **únicamente documentos tributarios EXENTOS**. Jamás emitir facturas afectas ni boletas afectas. Esta regla está implementada a nivel de código.

**Documentos bloqueados:**

* CL33 — Factura Electrónica (afecta) ❌
* CL39 — Boleta Electrónica (afecta) ❌

**Documentos permitidos:**

* CL34 — Factura Exenta Electrónica ✅ (default)
* CL41 — Boleta Exenta ✅
* CL110 — Factura de Exportación ✅
* CL61 — Nota de Crédito Electrónica ✅

## Flujo obligatorio de facturación

Ark sigue este flujo para cualquier operación de facturación:

1. **Buscar cliente existente** — Siempre buscar por nombre o RUT antes de crear uno nuevo
2. **Crear cliente** — Solo si la búsqueda no arroja resultados
3. **Validar datos** — Verificar nombre, RUT y dirección completa antes de emitir
4. **Crear factura/suscripción** — Extraer montos exactos del MSA o contrato
5. **Confirmar con el usuario** — Nunca emitir sin aprobación explícita
6. **Descargar PDF** — Compartir en Slack automáticamente

> [!NOTE]
>
> Ark nunca inventa montos. Todos los valores se extraen del documento fuente (MSA, contrato, cotización). Si un dato no está claro, Ark lo marca como "PENDIENTE DE VERIFICAR".

## Anulación de facturas

En Chile, anular una factura ya emitida ante el SII significa emitir una **Nota de Crédito Electrónica (CL61)**. No existe un "void" o "delete" de facturas emitidas.

**Flujo:**

1. Emitir Nota de Crédito referenciando la factura original
2. La NC anula total o parcialmente la factura ante el SII

## Consultar desde Slack

```
@Ark ¿cuál es el estado de facturación de [cliente]?
@Ark ¿cuántos clientes activos hay en Piriod?
@Ark emitir factura para [cliente] por [monto]
@Ark anular factura N° [número]
@Ark eliminar cliente duplicado [nombre]
```

## Herramientas disponibles en Piriod

Ark puede realizar las siguientes operaciones via API:

* Listar, buscar, crear, editar y eliminar clientes
* Crear suscripciones y facturas (one-time y recurrentes)
* Finalizar y anular facturas (via Nota de Crédito)
* Descargar PDFs de facturas
* Registrar uso (metered billing)
* Listar planes, productos y documentos tributarios


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