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.
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.
Cambiar los datos del ejemplo
Productos o servicios
Escribe los montos sin puntos: 10000. La API suma el IVA.
Respuesta de la API
SimuladaAl 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.
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
POST/api/v1/dte/emitirTu sistema envía la venta. La API le asigna folio, lo envía al SII y responde con el número de seguimiento.
GET/api/v1/dte/{tipo}/{folio}/estadoConsulta qué respondió el SII. Con la API real puede tardar unos minutos: vuelve a consultar mientras diga EN_PROCESO.
GET/api/v1/dte/{tipo}/{folio}/pdfDescarga el PDF para tu cliente. El XML está en …/xml.
¿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.