{
  "info": {
    "name": "LUMINOUS API v1 — Facturación electrónica (SII Chile)",
    "description": "API pública de LUMINOUS para emitir DTE (facturas, boletas, guías, NC/ND) desde tu aplicación.\n\n1. Pide tu key sandbox gratis en https://luminous.cl/desarrolladores\n2. Configura la variable `api_key` de esta colección.\n3. Parte con `Ping` para verificar credenciales.\n\nDocs: https://luminous.cl/desarrolladores/docs",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    { "key": "base_url", "value": "https://pruebas.luminous.cl", "description": "Sandbox (keys lum_test_). Para producción (lum_live_): https://luminous.cl" },
    { "key": "api_key", "value": "lum_test_PEGA_TU_KEY_AQUI" }
  ],
  "auth": {
    "type": "bearer",
    "bearer": [{ "key": "token", "value": "{{api_key}}", "type": "string" }]
  },
  "item": [
    {
      "name": "Ping — verificar credenciales",
      "request": {
        "method": "GET",
        "url": "{{base_url}}/api/public/v1/ping",
        "description": "Devuelve app, ambiente (CERT/PROD), scopes y plan de la key."
      }
    },
    {
      "name": "Emitir factura electrónica (T33)",
      "request": {
        "method": "POST",
        "url": "{{base_url}}/api/public/v1/dte/emitir",
        "header": [
          { "key": "Idempotency-Key", "value": "pedido-{{$randomInt}}", "description": "OBLIGATORIO: único por emisión (usa el ID de tu operación)" },
          { "key": "Content-Type", "value": "application/json" }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"tipo_dte\": 33,\n  \"receptor\": {\n    \"rut\": \"77043599-4\",\n    \"razon_social\": \"Techmell SpA\",\n    \"giro\": \"Venta de bicicletas\",\n    \"direccion\": \"Rio Claro 8300\",\n    \"comuna\": \"Pudahuel\",\n    \"ciudad\": \"Santiago\"\n  },\n  \"items\": [\n    { \"nombre\": \"Bicicleta MTB 29\", \"cantidad\": 1, \"precio_unitario\": 350000 }\n  ],\n  \"forma_pago\": 1,\n  \"enviar\": true\n}"
        }
      }
    },
    {
      "name": "Emitir boleta electrónica (T39)",
      "request": {
        "method": "POST",
        "url": "{{base_url}}/api/public/v1/dte/emitir",
        "header": [
          { "key": "Idempotency-Key", "value": "venta-{{$randomInt}}" },
          { "key": "Content-Type", "value": "application/json" }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"tipo_dte\": 39,\n  \"receptor\": { \"rut\": \"66666666-6\", \"razon_social\": \"Consumidor final\" },\n  \"items\": [\n    { \"nombre\": \"Almuerzo del día\", \"cantidad\": 2, \"precio_unitario\": 7990 }\n  ]\n}"
        },
        "description": "En boletas afectas el precio es BRUTO (IVA incluido)."
      }
    },
    {
      "name": "Emitir guía de despacho (T52)",
      "request": {
        "method": "POST",
        "url": "{{base_url}}/api/public/v1/dte/emitir",
        "header": [
          { "key": "Idempotency-Key", "value": "guia-{{$randomInt}}" },
          { "key": "Content-Type", "value": "application/json" }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"tipo_dte\": 52,\n  \"ind_traslado\": 1,\n  \"tipo_despacho\": 2,\n  \"receptor\": {\n    \"rut\": \"77043599-4\",\n    \"razon_social\": \"Techmell SpA\",\n    \"giro\": \"Venta de bicicletas\",\n    \"direccion\": \"Rio Claro 8300\",\n    \"comuna\": \"Pudahuel\",\n    \"ciudad\": \"Santiago\"\n  },\n  \"items\": [\n    { \"nombre\": \"Bicicleta MTB 29\", \"cantidad\": 3, \"precio_unitario\": 350000 }\n  ]\n}"
        },
        "description": "ind_traslado: 1=venta, 5=traslado interno, 6=otros no venta. tipo_despacho: 1=cliente, 2=emisor al local del cliente."
      }
    },
    {
      "name": "Emitir nota de crédito (T61) con referencia",
      "request": {
        "method": "POST",
        "url": "{{base_url}}/api/public/v1/dte/emitir",
        "header": [
          { "key": "Idempotency-Key", "value": "nc-{{$randomInt}}" },
          { "key": "Content-Type", "value": "application/json" }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"tipo_dte\": 61,\n  \"receptor\": {\n    \"rut\": \"77043599-4\",\n    \"razon_social\": \"Techmell SpA\",\n    \"giro\": \"Venta de bicicletas\",\n    \"direccion\": \"Rio Claro 8300\",\n    \"comuna\": \"Pudahuel\",\n    \"ciudad\": \"Santiago\"\n  },\n  \"items\": [\n    { \"nombre\": \"Bicicleta MTB 29\", \"cantidad\": 1, \"precio_unitario\": 350000 }\n  ],\n  \"referencias\": [\n    { \"tipo_doc_ref\": 33, \"folio_ref\": 128, \"fecha_ref\": \"2026-07-01\", \"cod_ref\": 1, \"razon_ref\": \"ANULA FACTURA\" }\n  ]\n}"
        },
        "description": "cod_ref: 1=anula, 2=corrige texto, 3=modifica monto."
      }
    },
    {
      "name": "Consultar estado de un documento",
      "request": {
        "method": "GET",
        "url": "{{base_url}}/api/public/v1/dte/33/128",
        "description": "Estado SII (EMITIDO_LOCAL → RECIBIDO_SII → ACEPTADO_SII/RECHAZADO_SII), track ID y montos."
      }
    },
    {
      "name": "Descargar PDF (original + cedible)",
      "request": {
        "method": "GET",
        "url": "{{base_url}}/api/public/v1/dte/33/128/pdf?copia=ambas",
        "description": "copia=original | cedible | ambas. La guía (52) lleva 'CEDIBLE CON SU FACTURA'."
      }
    },
    {
      "name": "Descargar XML firmado",
      "request": {
        "method": "GET",
        "url": "{{base_url}}/api/public/v1/dte/33/128/xml"
      }
    }
  ]
}