# SICFAC API REST - ESPECIFICACION TECNICA COMPLETA PARA AGENTES DE IA (LLMs)

> Documento estandarizado llms.txt para consumo rapido y automatico por parte de Asistentes de IA (ChatGPT, Claude, Cursor, Windsurf, Antigravity, Copilot, etc.).

## 1. SERVIDORES Y BASE URLS
- **Emision de Comprobantes (Demo)**: `https://apidemo.sicfac.com`
- **Emision de Comprobantes (Produccion)**: `https://api.sicfac.com`
- **Servicios de Consulta (RUC / DNI / Tipo Cambio)**: `https://services.sicfac.com`

---

## 2. AUTENTICACION
Todas las solicitudes requieren la cabecera HTTP de autorizacion tipo **Bearer Token**:
- **Header**: `Authorization: Bearer <TU_KEY_REST>`
- **Content-Type**: `application/json`
*(La clave `KeyRest` se obtiene desde la plataforma en Configuracion > Compania).*

---

## 3. ENDPOINTS DE FACTURACION ELECTRONICA (`https://api.sicfac.com` / `https://apidemo.sicfac.com`)

### 3.1 Emitir Comprobante (Factura / Boleta / Nota Credito / Nota Debito)
- **Metodo**: `POST`
- **Ruta**: `/api/GenerarDocumento`
- **Request Body (JSON)**:
```json
{
  "Emisor": {
    "NroDocumento": "20602142087",
    "TipoDocumento": "6",
    "NombreLegal": "EMPRESA DE PRUEBA S.A.C.",
    "EnvioInmediatoSunat": "1",
    "FormatoPdfTicket": "0"
  },
  "Receptor": {
    "NroDocumento": "20100070970",
    "TipoDocumento": "6",
    "NombreLegal": "CLIENTE PRUEBA S.A.C.",
    "Direccion": "LIMA, PERU"
  },
  "Serie": "F787",
  "Correlativo": "1001",
  "TipoDocumento": "01",
  "FechaEmision": "2026-07-22",
  "Moneda": "PEN",
  "TipoOperacion": "0101",
  "Exoneradas": 0,
  "Inafectas": 0,
  "Gratuitas": 0,
  "Gravadas": 100,
  "TotalIgv": 18,
  "TotalVenta": 118,
  "TipoFormaPago": "1",
  "Items": [
    {
      "CodigoItem": "P001",
      "Cantidad": 1,
      "UnidadMedida": "NIU",
      "Descripcion": "DESCRIPCION DEL PRODUCTO",
      "PrecioUnitario": 118,
      "TipoImpuesto": "10",
      "Impuesto": 18,
      "TotalVenta": 100
    }
  ]
}
```
- **Campos Importantes**:
  - `TipoDocumento`: `"01"` (Factura), `"03"` (Boleta), `"07"` (Nota de Credito), `"08"` (Nota de Debito).
  - `TipoOperacion`: `"0101"` (Venta Interna), `"0200"` (Exportacion).
  - `TipoFormaPago`: `"1"` (Contado), `"2"` (Credito con cuotas en array `FormaPagos`).
  - `TipoImpuesto`: `"10"` (Gravado IGV 18%), `"17"` (Gravado IVAP 10.5%), `"20"` (Exonerado), `"30"` (Inafecto), `"40"` (Exportacion).

- **Response Body (JSON)**:
```json
{
  "Exito": true,
  "MensajeError": null,
  "MensajeRespuestaSunat": "La Factura numero F787-1001, ha sido aceptada",
  "NombreArchivoPdf": "https://api.sicfac.com/Archivos/20602142087-01-F787-1001.pdf",
  "NombreArchivoXml": "https://api.sicfac.com/Archivos/20602142087-01-F787-1001.xml",
  "NombreArchivoCdr": "https://api.sicfac.com/Archivos/R-20602142087-01-F787-1001.xml",
  "CodigoEstadoSicfac": "0"
}
```

---

### 3.2 Emitir Guia de Remision Electronica
- **Metodo**: `POST`
- **Ruta**: `/api/GuiaRemision`
- **Request Body (JSON)**:
```json
{
  "Emisor": {
    "NroDocumento": "20602142087",
    "TipoDocumento": "6",
    "NombreLegal": "EMPRESA EMISORA S.A.C."
  },
  "Destinatario": {
    "NroDocumento": "20100070970",
    "TipoDocumento": "6",
    "NombreLegal": "DESTINATARIO PRUEBA S.A.C."
  },
  "Serie": "T001",
  "Correlativo": "1",
  "TipoDocumento": "09",
  "FechaEmision": "2026-07-22",
  "FechaInicioTraslado": "2026-07-22",
  "MotivoTraslado": "01",
  "ModalidadTraslado": "02",
  "PesoTotal": 10.5,
  "UnidadMedidaPeso": "KGM",
  "PuntoPartida": {
    "Ubigeo": "150101",
    "Direccion": "AV. PRINCIPAL 123, LIMA"
  },
  "PuntoLlegada": {
    "Ubigeo": "150122",
    "Direccion": "AV. LA MAR 401, MIRAFLORES"
  },
  "Detalles": [
    {
      "CodigoItem": "ITEM01",
      "Cantidad": 10,
      "UnidadMedida": "NIU",
      "Descripcion": "CAJAS DE PRODUCTO"
    }
  ]
}
```

---

### 3.3 Anular / Comunicar de Baja un Comprobante
- **Metodo**: `POST`
- **Ruta**: `/api/AnularDocumento`
- **Request Body (JSON)**:
```json
{
  "Emisor": {
    "NroDocumento": "20602142087",
    "TipoDocumento": "6"
  },
  "Serie": "F787",
  "Correlativo": "1001",
  "TipoDocumento": "01",
  "MotivoBaja": "ERROR EN RUC DE RECEPTOR"
}
```

---

### 3.4 Consultar Estado de Comprobante
- **Metodo**: `POST`
- **Ruta**: `/api/ConsultaDocumento`
- **Request Body (JSON)**:
```json
{
  "Emisor": {
    "NroDocumento": "20602142087",
    "TipoDocumento": "6"
  },
  "Serie": "F787",
  "Correlativo": "1001",
  "TipoDocumento": "01"
}
```

---

## 4. ENDPOINTS DE CONSULTAS RUC / DNI / TIPO CAMBIO (`https://services.sicfac.com`)

### 4.1 Consulta de DNI por Padron
- **Metodo**: `POST`
- **Ruta**: `/api/ServicePadronDNI`
- **Request Body (JSON)**:
```json
{
  "numDocu": "72483573"
}
```
- **Response Body (JSON)**:
```json
{
  "numeroDocumento": "72483573",
  "tipoDocumento": "1",
  "nombres": "JUAN CARLOS",
  "apellidoPaterno": "PEREZ",
  "apellidoMaterno": "GARCIA",
  "nombresCompleto": "PEREZ GARCIA JUAN CARLOS",
  "exito": true,
  "mensaje": "Se proceso correctamente"
}
```

---

### 4.2 Consulta de RUC por Padron
- **Metodo**: `POST`
- **Ruta**: `/api/ServicePadronRUC`
- **Request Body (JSON)**:
```json
{
  "numDocu": "20602142087"
}
```
- **Response Body (JSON)**:
```json
{
  "numeroDocumento": "20602142087",
  "tipoDocumento": "6",
  "nombre": "EMPRESA DE PRUEBA S.A.C.",
  "estado": "ACTIVO",
  "condicion": "HABIDO",
  "direccion": "AV. LA MAR NRO. 123 INT. 401 URB. SANTA CRUZ LIMA - LIMA - MIRAFLORES",
  "ubigeo": "150122",
  "viaTipo": "AV.",
  "viaNombre": "LA MAR",
  "distrito": "MIRAFLORES",
  "provincia": "LIMA",
  "departamento": "LIMA",
  "retencion": "NO"
}
```

---

### 4.3 Consulta de Tipo de Cambio SUNAT
- **Metodo**: `POST`
- **Ruta**: `/api/GetTipoCambio`
- **Request Body (JSON)**:
```json
{
  "moneda": "USD",
  "fecha": "2026-07-22"
}
```
- **Response Body (JSON)**:
```json
{
  "moneda": "USD",
  "fecha": "2026-07-22",
  "compra": 3.752,
  "venta": 3.758
}
```