API de documentos tributarios electrónicos

Emite facturas y boletas electrónicas desde tu propio sistema

Tu sistema de ventas, tu tienda en línea o tu ERP le envía los datos de la venta a la API. La API crea el documento, lo envía al SII y te dice qué respondió.

Todo lo que pruebes en esta página es simulado: no llega al SII, no tiene validez tributaria y no se guarda.

  1. Prueba aquíEmite un documento de prueba y mira qué responde. Sin registrarte.
  2. Pide tu keyTu clave para conectarte desde tu sistema. Llega por correo y vale 7 días.
  3. Conecta tu sistemaCon tu equipo, tu proveedor o una IA: te damos el contexto listo.

Paso 1: Prueba cómo responde

Elige un documento y el resultado que quieres ver. Usamos datos de ejemplo y la respuesta llega al instante.

¿Qué documento quieres emitir?

Factura: la que le emites a otra empresa.

¿Qué resultado quieres ver?
Más casos (8)

El SII rechaza el envío completo

No llega al SII

Errores en tus datos

Cambiar los datos del ejemplo

Productos o servicios

Escribe los montos sin puntos: 10000. La API suma el IVA.

Respuesta de la API

Simulada

Al abrir la página enviamos una factura de prueba para que veas cómo responde. Elige otro documento o resultado.

Enviando…

Paso 2: Pide tu key de pruebas

La key es la clave con que tu sistema se identifica ante la API. Te la enviamos por correo: nunca se muestra en esta página.

Guardamos el nombre de la empresa, el correo y el RUT solo para enviarte la key y contactarte por ella. La key nunca se muestra en esta página.

Qué recibes

  • Una key de pruebas que vale 7 días.
  • Las mismas respuestas que ves arriba, ahora desde tu sistema: simuladas y sin llegar al SII.
  • Hasta 60 llamadas por minuto.
  • Antes de que venza, entra con el RUT de tu empresa en «Iniciar sesión» y crea tu contraseña: la key pasa a tu cuenta.

Paso 3: Conecta tu sistema

Con tu key, tu sistema hace las mismas llamadas que probaste arriba. Si programas con una IA, dale el contexto y ella escribe la conexión.

Datos de conexión

URL base
Autenticación, en cada llamada
Authorization: Bearer TU_API_KEY
Formato
JSON, en lo que envías y en lo que recibes. Los PDF y XML llegan como archivo.

Ejemplo: emitir una factura de prueba

Cambia TU_API_KEY por la key que te llegó al correo. En Windows, pégalo en Git Bash.

curl -X POST "/api/v1/dte/emitir" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"documento":{"codDocume":33,"rutCliente":"39000100-2","razonSocial":"Cliente de Prueba SpA","ubicacionReceptor":{"id":1,"direccion":"Av. Siempre Viva 123","comuna":"Santiago","ciudad":"Santiago"},"lineas":[{"nomItem":"Servicio de ejemplo","cantidad":1,"precioUnit":10000}]}}'

El recorrido de una venta

  1. POST/api/v1/dte/emitir

    Tu sistema envía la venta. La API le asigna folio, lo envía al SII y responde con el número de seguimiento.

  2. GET/api/v1/dte/{tipo}/{folio}/estado

    Consulta qué respondió el SII. Con la API real puede tardar unos minutos: vuelve a consultar mientras diga EN_PROCESO.

  3. GET/api/v1/dte/{tipo}/{folio}/pdf

    Descarga el PDF para tu cliente. El XML está en …/xml.

  4. ¿Hay que corregir? Un documento aceptado no se borra: se corrige con una nota de crédito (tipo 61) que lo menciona.

¿Programas con una IA?

Descarga un archivo con todo lo que la IA necesita para programar la conexión: las rutas, los datos que pide cada una, las respuestas, los errores y el flujo completo. Sirve para Claude, Codex, Gemini y otras.

Todas las rutas (29)

Emitir y seguir un documento

  • POST/api/v1/dte/emitirCrea el documento, le asigna folio y lo envía al SII en una sola llamada.
  • GET/api/v1/dte/{codDocume}/{numDocume}/estadoQué respondió el SII.
  • GET/api/v1/dte/{codDocume}/{numDocume}/pdfEl PDF para entregar a tu cliente, en tamaño carta o ticket.
  • GET/api/v1/dte/{codDocume}/{numDocume}/xmlEl XML del documento.
  • GET/api/v1/dte/{codDocume}/{numDocume}/timbre.pngLa imagen del timbre electrónico.
  • GET/api/v1/dte/{codDocume}/{numDocume}Todos los datos del documento.

Registrar ahora y enviar después

  • POST/api/v1/dteRegistra un documento sin enviarlo al SII.
  • POST/api/v1/dte/{codDocume}/{numDocume}/enviarEnvía al SII un documento registrado, o reintenta uno que no llegó.
  • PUT/api/v1/dte/{codDocume}/{numDocume}Modifica un documento que todavía no se envía.
  • DELETE/api/v1/dte/{codDocume}/{numDocume}Elimina un documento que no se envió y libera su folio.
  • POST/api/v1/dte/{codDocume}/{numDocume}/anularAnula un documento.

Por tipo de documento

  • GET/api/v1/dte/boletasLista las boletas (39 y 41).
  • POST/api/v1/dte/boletasRegistra una boleta.
  • GET/api/v1/dte/guiasLista las guías de despacho (52).
  • POST/api/v1/dte/guiasRegistra una guía de despacho, con su transporte.
  • GET/api/v1/dte/notasLista las notas de crédito y débito (61 y 56).
  • POST/api/v1/dte/notasRegistra una nota que corrige otro documento.
  • GET/api/v1/dte/notas/referenciablesLos documentos que una nota puede corregir.
  • GET/api/v1/dte/facturas-compraLista las facturas de compra (46).
  • POST/api/v1/dte/facturas-compraRegistra una factura de compra.
  • GET/api/v1/dte/exportacionLista los documentos de exportación (110, 111 y 112).
  • POST/api/v1/dte/exportacionRegistra un documento de exportación.

Buscar documentos

  • GET/api/v1/dteLista y filtra los documentos por fecha, cliente, tipo o respuesta del SII.

Facturación recurrente

  • GET/api/v1/dte/facturacion-automaticaLista las plantillas de cobros que se repiten.
  • POST/api/v1/dte/facturacion-automaticaCrea una plantilla.
  • DELETE/api/v1/dte/facturacion-automatica/{id}Elimina una plantilla.
  • POST/api/v1/dte/facturacion-automatica/{id}/emitirRegistra el documento de una plantilla, listo para enviar.

Documentos emitidos en otro sistema

  • GET/api/v1/dte/externosLista los documentos registrados desde otro sistema.
  • POST/api/v1/dte/externosRegistra, con su XML, documentos que emitiste fuera de esta API.
RUT de prueba para cada resultado

Úsalos como RUT del cliente (rutCliente) con tu key de pruebas: el RUT decide qué responde el SII simulado.

  • 39000100-2 (o cualquier RUT válido)El SII acepta el documento. Es lo que pasa con cualquier otro receptor.
  • 39000010-3Documento rechazado: solo el que lleva este receptor, no el sobre completo.
  • 39000020-0Documento aceptado con reparos (ACEPTADO_CON_REPARO).
  • 39000030-8Sobre rechazado entero: RSC, error en schema.
  • 39000040-5Sobre rechazado entero: RFR, error en firma.
  • 39000050-2Sobre rechazado entero: RCT, error en carátula.
  • 39000060-KLa subida falla con STATUS 5, no está autenticado: no hay Track-ID.
  • 39000070-7La subida falla con STATUS 7, esquema inválido: no hay Track-ID.
  • 39000080-4La subida falla con STATUS 8, firma del documento: no hay Track-ID.
  • 39000090-1La subida falla con HTTP 500: no hay Track-ID.
  • Sin la comuna del cliente: error 422, sin usar folio. Con una cantidad en cero: error 400, con el campo a revisar.
Diferencias entre las pruebas y la API real
  • Aquí el SII responde al instante. Con la API real, el estado parte en EN_PROCESO: tu sistema debe volver a consultar hasta que cambie, sin tratarlo como un rechazo.
  • Las pruebas no guardan nada: anular no cambia lo que responde la consulta siguiente, y el PDF y el XML son de muestra.
  • En pruebas no hay ficha de clientes: manda siempre la comuna del cliente en ubicacionReceptor (id mayor que 0, dirección y comuna).
  • La API real revisa más reglas: por ejemplo, una guía sin tipo de traslado o sin destino, o una nota de crédito sin el documento que corrige, responden 422.
  • Con la API real, un documento registrado sin enviar responde enviado: false, y enviarlo dos veces responde 409.

Preguntas frecuentes

¿Esto emite documentos reales?

No. Todo lo de esta página es simulado: no llega al SII, no tiene validez tributaria y no se guarda. Sirve para ver cómo responde la API antes de conectarte de verdad.

¿Qué es un DTE, el SII y un folio?

Un DTE es un documento tributario electrónico: facturas, boletas, guías de despacho y notas de crédito o débito. El SII es el Servicio de Impuestos Internos, que recibe y revisa cada documento. El folio es el número único de cada documento, autorizado por el SII.

¿Necesito saber programar?

Para conectar tu sistema, alguien tiene que programar la conexión: tu equipo, tu proveedor de software o una IA. El botón «Contexto para IA» le entrega a la IA todo lo que necesita saber de la API.

¿Las respuestas son iguales a las reales?

Tienen la misma forma. La diferencia es que aquí el SII responde al instante; en la realidad puede tardar, y algunas reglas se revisan solo con la API real.

¿Qué datos míos guardan?

Solo los del formulario de la key: nombre de la empresa, correo y RUT. Lo que pruebas en esta página no se guarda. Más detalles en la política de privacidad.

¿Cuánto dura la key de pruebas?

7 días desde que la pides. Antes de que venza, entra con el RUT de tu empresa en «Iniciar sesión» y crea tu contraseña: la key pasa a tu cuenta.

¿Quieres emitir documentos reales?

Crea tu cuenta para conectar tu empresa cuando termines de probar.

Crear cuenta