# API Reference (msv-kude)

> Todas las rutas están bajo la URL base definida en `PORT` (por defecto `http://localhost:5600`).  
> Los endpoints protegidos requieren un **JWT** en el encabezado `Authorization: Bearer <token>`.

## Autenticación

### `POST /api/login`
Inicia sesión y devuelve un token JWT.

| Body (JSON) | Tipo | Descripción |
|-------------|------|-------------|
| `username`  | `string` | Usuario registrado |
| `password`  | `string` | Contraseña |

Respuesta 200:
```json
{ "token": "<jwt>" }
```

Errores:
* `401` Credenciales inválidas
* `500` Error interno

---

## Empresas

### `GET /api/empresas` *(protegido)*
Devuelve el listado de empresas.

Respuesta 200:
```json
[ { "id": "...", "ruc": "...", "razon_social": "..." } ]
```

---

## Plantillas

### `GET /api/plantillas` *(protegido)*
Filtra plantillas por `empresa_id` y `tipo_documento_id`.

Query params:
| Param | Descripción |
|-------|-------------|
| `empresa_id` | UUID de la empresa |
| `tipo_documento_id` | 1-8 según el tipo de documento |

### `POST /api/plantillas` *(protegido)*
Crea/actualiza una plantilla.

Body ejemplo:
```json
{
  "empresa_id": "uuid",
  "tipo_documento_id": 5,
  "plantilla": { /* JSON de plantilla */ }
}
```

---

## Generar KUDE

### `POST /api/generate-kude`
Genera el KUDE (PDF) a partir del XML firmado.

Body ejemplo:
```json
{
  "xml": "<xml>...</xml>",
  "tipo": "view"
}
```

Respuesta 200: PDF en base64 o `application/pdf`.

---
## DDL Tablas nuevas

```sql

CREATE TABLE public.tipo_documento (
	id bigserial NOT NULL,
	codigo varchar NULL,
	descripcion varchar NULL,
	CONSTRAINT tipo_documento_pk PRIMARY KEY (id)
);

INSERT INTO public.tipo_documento(id, codigo, descripcion) VALUES(1, '1', 'Factura electronica');
INSERT INTO public.tipo_documento (id, codigo, descripcion) VALUES(2, '5', 'Nota de credito');
INSERT INTO public.tipo_documento (id, codigo, descripcion) VALUES(3, '7', 'Nota de remision');
INSERT INTO public.tipo_documento (id, codigo, descripcion) VALUES(4, '6', 'Nota de debito');
INSERT INTO public.tipo_documento (id, codigo, descripcion) VALUES(5, '4', 'Autofactura');
INSERT INTO public.tipo_documento (id, codigo, descripcion) VALUES(6, '8', 'Factura exportacion');

CREATE TABLE public.plantilla_documentos (
	id uuid DEFAULT uuid_generate_v4() NOT NULL,
	empresa_id uuid NULL,
	tipo_documento_id int4 NULL,
	plantilla json NULL,
	activo bool DEFAULT true NULL,
	created_at timestamp DEFAULT CURRENT_TIMESTAMP NULL,
	codigo varchar NULL,
	descripcion varchar NULL,
	CONSTRAINT plantilla_documentos_pk PRIMARY KEY (id),
	CONSTRAINT plantilla_documentos_empresas_fk FOREIGN KEY (empresa_id) REFERENCES public.empresas(id),
	CONSTRAINT plantilla_documentos_tipo_documento_fk FOREIGN KEY (tipo_documento_id) REFERENCES public.tipo_documento(id)
);

```

## Plantillas disponibles
```
En la ruta : /invoice/estandar/ se encuentran las plantillas disponibles.
Factura Electronica: plantilla_factura.json
Nota de Credito: plantilla_nota_credito.json
Nota de Remision: plantilla_remision.json
Nota de Debito: plantilla_nota_debito.json
Autofactura: plantilla_autofactura.json
Factura Exportacion: plantilla_factura_exportacion.json

```

## Instalación y ejecución

1. Clonar el repositorio y entrar al directorio raíz.
2. Copiar `.env.example` a `.env` y ajustar variables (DB, JWT_SECRET, etc.).
3. Instalar dependencias y levantar el servidor:
   ```bash
   pnpm install
   pnpm start:dev
   ```

El servidor correrá en `http://localhost:5600`.
