Referencia de la API de Facturación

# 1. Obtener token
curl -X POST https://tu-servidor.cl/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "admin@miempresa.cl",
    "password": "mi_password"
  }'

# Respuesta
{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "token_type": "Bearer"
}

# 2. Usar el token en cualquier endpoint
curl -X GET https://tu-servidor.cl/api/dte/emitidos \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

curl -X POST https://tu-servidor.cl/api/auth/api-key/login \
  -H "Content-Type: application/json" \
  -d '{ "apiKey": "ak_live_xxxxxxxxxxxxxxxx" }'

# Respuesta
{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 86400
}

const API_BASE = 'https://tu-servidor.cl/api';
const API_KEY  = 'ak_live_xxxxxxxxxxxxxxxx';

async function emitirFactura(datos) {
  const res = await fetch(`${API_BASE}/dte/facturas/emitir`, {
    method: 'POST',
    headers: {
      'X-Api-Key': API_KEY,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(datos)
  });

  if (!res.ok) {
    const err = await res.json();
    throw new Error(err.error);
  }

  return res.json();
}

// Uso
const resultado = await emitirFactura({
  idOperacion: 'ORD-2027-001',
  total: 119000,
  cliente: {
    rut: '12345678', digito: '9',
    razonSocial: 'Empresa Cliente SpA',
    giro: 'Comercio al por mayor',
    direccion: 'Av. Principal 123',
    ciudad: 'Santiago', comuna: 'Las Condes',
    email: 'contacto@cliente.cl'
  },
  detalles: [{
    linea: 1, codigo: 'PROD-001',
    descripcion: 'Servicio de consultoría',
    DscItem: 'Descripción larga opcional (máx. 1000 chars)',
    precio: 100000, cantidad: 1,
    precioSubtotal: 100000, esExento: false
  }]
});

console.log(`Factura emitida. Folio: ${resultado.folio}`);
console.log(`PDF: ${resultado.documentos.pdf}`);

import requests

API_BASE = "https://tu-servidor.cl/api"
API_KEY  = "ak_live_xxxxxxxxxxxxxxxx"

headers = {
    "X-Api-Key": API_KEY,
    "Content-Type": "application/json"
}

payload = {
    "idOperacion": "ORD-2027-001",
    "total": 119000,
    "descuentoGlobal": 0,
    "medioPago": "Transferencia",
    "enviarCorreo": True,
    "cliente": {
        "rut": "12345678", "digito": "9",
        "razonSocial": "Empresa Cliente SpA",
        "giro": "Comercio al por mayor",
        "direccion": "Av. Principal 123",
        "ciudad": "Santiago", "comuna": "Las Condes",
        "email": "contacto@cliente.cl"
    },
    "detalles": [{
        "linea": 1, "codigo": "PROD-001",
        "descripcion": "Servicio de consultoría",
        "DscItem": "Descripción larga opcional (máx. 1000 chars)",
        "precio": 100000, "cantidad": 1,
        "precioSubtotal": 100000, "esExento": False
    }]
}

response = requests.post(
    f"{API_BASE}/dte/facturas/emitir",
    json=payload,
    headers=headers
)
response.raise_for_status()

data = response.json()
print(f"Factura emitida. Folio: {data['folio']}")
print(f"PDF disponible en: {data['documentos']['pdf']}")

# Guardar PDF localmente
import base64
pdf_bytes = base64.b64decode(data['pdfBase64'])
with open(f"factura_{data['folio']}.pdf", "wb") as f:
    f.write(pdf_bytes)

using System.Net.Http.Json;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-Api-Key", "ak_live_xxxxxxxxxxxxxxxx");

var payload = new {
    idOperacion = "ORD-2027-001",
    total = 119000,
    descuentoGlobal = 0,
    medioPago = "Transferencia",
    enviarCorreo = true,
    cliente = new {
        rut = "12345678", digito = "9",
        razonSocial = "Empresa Cliente SpA",
        giro = "Comercio al por mayor",
        direccion = "Av. Principal 123",
        ciudad = "Santiago", comuna = "Las Condes",
        email = "contacto@cliente.cl"
    },
    detalles = new[] {
        new {
            linea = 1, codigo = "PROD-001",
            descripcion = "Servicio de consultoría",
            DscItem = "Descripción larga opcional (máx. 1000 chars)",
            precio = 100000m, cantidad = 1m,
            precioSubtotal = 100000m, esExento = false
        }
    }
};

var response = await client.PostAsJsonAsync(
    "https://tu-servidor.cl/api/dte/facturas/emitir",
    payload
);

response.EnsureSuccessStatusCode();

var result = await response.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine($"Folio: {result.GetProperty("folio")}");

<?php

$apiBase = 'https://tu-servidor.cl/api';
$apiKey  = 'ak_live_xxxxxxxxxxxxxxxx';

$payload = [
    'idOperacion'    => 'ORD-2027-001',
    'total'          => 119000,
    'descuentoGlobal'=> 0,
    'medioPago'      => 'Transferencia',
    'enviarCorreo'   => true,
    'cliente' => [
        'rut'        => '12345678',
        'digito'     => '9',
        'razonSocial'=> 'Empresa Cliente SpA',
        'giro'       => 'Comercio al por mayor',
        'direccion'  => 'Av. Principal 123',
        'ciudad'     => 'Santiago',
        'comuna'     => 'Las Condes',
        'email'      => 'contacto@cliente.cl',
    ],
    'detalles' => [[
        'linea'          => 1,
        'codigo'         => 'PROD-001',
        'descripcion'    => 'Servicio de consultoría',
        'DscItem'        => 'Descripción larga opcional (máx. 1000 chars)',
        'precio'         => 100000,
        'cantidad'       => 1,
        'precioSubtotal' => 100000,
        'esExento'       => false,
    ]]
];

$ch = curl_init("$apiBase/dte/facturas/emitir");
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        "X-Api-Key: $apiKey",
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($payload),
]);

$body     = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$data = json_decode($body, true);
echo "Folio emitido: {$data['folio']}\n";

// Guardar PDF localmente
file_put_contents(
    "factura_{$data['folio']}.pdf",
    base64_decode($data['pdfBase64'])
);

import requests

facturas = requests.get(
    "https://tu-servidor.cl/api/dte/emitidos",
    params={"tipo": 33},
    headers={"X-Api-Key": "ak_live_xxx"}
).json()

rechazadas = [f for f in facturas if f.get("estadoSiiEvento") == "RSC"]
aceptadas  = [f for f in facturas if f.get("estadoSiiEvento") == "ACD"]
sin_evento = [f for f in facturas if not f.get("estadoSiiEvento")]

for f in rechazadas:
    print(f"⚠️  Folio {f['folio']} rechazado por {f['razonSocial']} — emitir NC")

using System.Net.Http.Json;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-Api-Key", "ak_live_xxx");

var facturas = await client.GetFromJsonAsync<List<DteEmitidoDto>>(
    "https://tu-servidor.cl/api/dte/emitidos?tipo=33"
);

var rechazadas = facturas!.Where(f => f.EstadoSiiEvento == "RSC").ToList();
var aceptadas  = facturas!.Where(f => f.EstadoSiiEvento == "ACD").ToList();

Console.WriteLine($"Rechazadas: {rechazadas.Count} · Aceptadas: {aceptadas.Count}");

// Emitir NC para cada rechazada
foreach (var f in rechazadas)
{
    Console.WriteLine($"Folio {f.Folio} rechazado por {f.RazonSocial} — pendiente NC");
}

// DTO mínimo
record DteEmitidoDto(
    int    CodigoDte,
    long   Folio,
    string Rut,
    string RazonSocial,
    long   Total,
    string EstadoSiiEvento
);

const res = await fetch('https://tu-servidor.cl/api/dte/boletas/emitir', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'ak_live_xxxxxxxxxxxxxxxx',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    idBoletaOperacion: 'POS-0042',
    total: 5950,
    medioPago: 'Efectivo',
    montoPago: '10000',
    vuelto: '4050',
    cliente: {
      rut: '66666666', digito: '6',
      razonSocial: 'CONSUMIDOR FINAL'
    },
    detalles: [
      { linea: 1, descripcion: 'Café Americano',  precio: 2500, cantidad: 1, precioSubtotal: 2500, esExento: false },
      { linea: 2, descripcion: 'Sándwich de Palta', precio: 3450, cantidad: 1, precioSubtotal: 3450, esExento: false }
    ]
  })
});

const boleta = await res.json();

// El PDF y XML están en base64 directamente
const pdfBlob = new Blob(
  [Uint8Array.from(atob(boleta.pdfBase64), c => c.charCodeAt(0))],
  { type: 'application/pdf' }
);
// Abrir en nueva pestaña
window.open(URL.createObjectURL(pdfBlob));

import requests, base64

r = requests.post(
    "https://tu-servidor.cl/api/dte/boletas/emitir",
    headers={"X-Api-Key": "ak_live_xxx", "Content-Type": "application/json"},
    json={
        "idBoletaOperacion": "POS-0042",
        "total": 5950,
        "medioPago": "Efectivo",
        "cliente": {"rut": "66666666", "digito": "6", "razonSocial": "CONSUMIDOR FINAL"},
        "detalles": [
            {"linea": 1, "descripcion": "Café Americano",  "precio": 2500, "cantidad": 1, "precioSubtotal": 2500, "esExento": False},
            {"linea": 2, "descripcion": "Sándwich de Palta", "precio": 3450, "cantidad": 1, "precioSubtotal": 3450, "esExento": False}
        ]
    }
)
r.raise_for_status()
data = r.json()
print(f"Boleta #{data['folio']} emitida")
open(f"boleta_{data['folio']}.pdf", "wb").write(base64.b64decode(data["pdfBase64"]))