Próximos pasos

Producción, notas de crédito, webhooks y agentes — las rutas típicas después del quickstart.

Ya emitiste tu primera Factura 33 en sandbox. Estas son las rutas comunes desde aquí, ordenadas por valor entregado.

Producción

Tu cuenta arranca en sandbox (maullin.sii.cl) sin tarjeta de crédito. Para emitir contra producción (palena.sii.cl) necesitas:

Postular tu RUT al SII como emisor electrónico (5 min).
Certificar el set de pruebas que define el SII — Notta lo automatiza desde el dashboard.
Esperar la respuesta del SII (2-10 días hábiles). Una vez aprobado, cambia el toggle a "Producción" en el dashboard y los siguientes DTEs van a palena.

El paso a paso completo está en Producción.

Plan Free

Tu plan Free es indefinido en sandbox. El upgrade a Starter es lo que habilita producción + BHE + más DTEs/mes.

Nota de Crédito (NC 61)

Cuando necesitas anular o corregir una factura ya emitida, emites una NC tipo 61 que referencia el documento original:

curl -X POST https://app.notta.cl/api/v1/dtes \
  -H "Authorization: Bearer ntt_cert_..." \
  -H "X-Cert-Id: 01957a91-0b50-7000-8000-cccc00000001" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "tipo_dte": 61,
    "rut_emisor": "76123456-0",
    "receptor": { "rut": "11111111-1", "razon_social": "Cliente Ejemplo SpA" },
    "fecha_emision": "2026-06-09",
    "items": [
      {
        "nombre": "Devolución consultoría",
        "cantidad": 2,
        "precio_unitario": 50000,
        "exento": false,
        "monto_item": 100000
      }
    ],
    "references": [
      {
        "line_num": 1,
        "tipo_doc_ref": 33,
        "folio_ref": 1234,
        "fecha_ref": "2026-05-15",
        "cod_ref": 3,
        "razon_ref": "Devolución parcial 2 unidades"
      }
    ],
    "sii_env": "cert"
  }'

El X-Cert-Id es el id de tu certificado (paso 1 del quickstart o dashboard).

Salida esperada (202 Accepted):

{
  "id": "01957a91-0b50-7000-8000-000000000061",
  "status": "queued",
  "folio": 410,
  "tipo_dte": 61,
  "rut_emisor": "76123456-0",
  "rut_receptor": "11111111-1",
  "monto_neto": 100000,
  "monto_exento": 0,
  "iva": 19000,
  "monto_total": 119000,
  "sii_env": "cert",
  "sii_status": "queued",
  "fecha_emision": "2026-06-09",
  "links": {
    "self": "/api/v1/dtes/01957a91-0b50-7000-8000-000000000061",
    "pdf": "/api/v1/dtes/01957a91-0b50-7000-8000-000000000061/pdf",
    "xml": "/api/v1/dtes/01957a91-0b50-7000-8000-000000000061/xml",
    "events": "/api/v1/dtes/01957a91-0b50-7000-8000-000000000061/events"
  }
}

cod_ref=1 → anula la factura completa.
cod_ref=2 → corrige texto (dirección, razón social, etc).
cod_ref=3 → corrige montos (devolución parcial/total).

La NC solo referencia facturas tipo 33/34 y tiene plazo legal de 6 meses (Ley 21.398). La guía completa está en Nota de Crédito 61.

Factura cedida (Corte Suprema 2025)

Una NC sobre factura cedida a factoring (RPETC con más de 8 días desde la aceptación irrevocable) es inoponible al cesionario. Notta bloquea la emisión; si igual corresponde, manda override_cedida: true y el override queda registrado en audit_log.

Webhooks

El endpoint de suscripción a webhooks todavía no está disponible — mientras tanto, consulta el estado con GET /api/v1/dtes/{id} o fuerza una actualización con POST /api/v1/dtes/{id}/refresh-status. El contrato de eventos y su estado actual están en Webhooks.

MCP para tu agente

El server MCP de Notta expone tools como notta_dte_emit sobre tu API key. Para Claude Desktop, agrega esta entrada a ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "notta": {
      "command": "npx",
      "args": ["@notta/mcp"],
      "env": { "NOTTA_API_KEY": "ntt_cert_..." }
    }
  }
}

Disponibilidad

El package @notta/mcp está en proceso de publicación en npm. Mientras tanto, el dashboard y la API cubren el flujo; el manifiesto del server vive en notta.cl/.well-known/mcp.json.

Pregúntale a tu agente: "Factúrale a Juan Pérez 8 horas a 50.000 por consultoría de marzo". El agente invoca notta_dte_emit con los argumentos correctos. Más patrones en MCP y Agentes.

Dónde seguir

Producción — postulación, certificación SII y cutover a palena: el siguiente paso natural.
Referencia de la API — todos los endpoints con sus shapes.
Agentes — llms.txt, manifiesto MCP y patrones de integración.
Errores — catálogo completo con next_action por código.