DTE Emisión

Emite una Factura Electrónica (DTE tipo 33, afecta a IVA) directamente en el portal del SII.

---

Campos obligatorios

Campo	Descripción
rut	RUT del usuario que se autentica en el SII
password	Contraseña del SII
clave_certificado	Clave del certificado digital para firmar
rut_empresa	RUT de la empresa emisora
receptor.rut	RUT del receptor (único campo obligatorio del receptor)
items	Al menos 1 item con nombre (max 25 chars), cantidad y precio (neto, sin IVA)

Campos opcionales

Campo	Default	Descripción
receptor.*	autocompletado	El SII autocompleta razón social, giro, dirección, comuna y ciudad a partir del RUT. Enviar estos campos sobreescribe el autocompletado
receptor.contacto	—	Email de contacto del receptor
forma_pago	CREDITO	CONTADO, CREDITO o SIN_COSTO
descuento_global	—	Porcentaje de descuento sobre el total (0-100)
fecha_emision	hoy	Fecha de emisión en formato YYYY-MM-DD
referencias	—	Array de hasta 3 referencias a documentos relacionados
pagos	—	Calendario de pagos a crédito (hasta 3 cuotas). Solo aplica cuando forma_pago=CREDITO. Ver sección "Pagos programados" abajo
transporte	—	Datos de transporte. Si se envía, todos sus 6 sub-campos son obligatorios (rut_transporte, dv_transporte, patente, rut_chofer, dv_chofer, nombre_chofer)
descargar_pdf	false	Si true, retorna el PDF del documento en base64 (+2-3s de tiempo extra)
items[].unidad	—	Unidad de medida: UN, KG, MT, LT, etc. (max 4 chars)
items[].descuento	—	Porcentaje de descuento por línea (0-100)
items[].descripcion_extendida	—	Texto adicional del item (max 1000 chars)

Pagos programados (cuotas a crédito)

Cuando forma_pago es CREDITO, puedes definir un calendario de pagos con el campo pagos. Si no se envía, la factura queda a crédito sin calendario definido (a criterio de las partes).

Cada pago tiene:

Campo	Obligatorio	Descripción
fecha	Sí	Fecha de vencimiento de la cuota (YYYY-MM-DD)
monto	Sí	Monto de la cuota en pesos (mínimo 1)
glosa	No	Descripción del pago (max 40 chars)

Límites: Máximo 3 cuotas. La suma de los montos no necesita coincidir exactamente con el total de la factura (el SII no lo valida).

Ejemplo — Factura a 30 días:

{
  "forma_pago": "CREDITO",
  "pagos": [
    { "fecha": "2025-02-15", "monto": 119000, "glosa": "Pago único a 30 días" }
  ]
}

Ejemplo — 3 cuotas mensuales:

{
  "forma_pago": "CREDITO",
  "pagos": [
    { "fecha": "2025-02-15", "monto": 40000, "glosa": "Cuota 1 de 3" },
    { "fecha": "2025-03-15", "monto": 40000, "glosa": "Cuota 2 de 3" },
    { "fecha": "2025-04-15", "monto": 39000, "glosa": "Cuota 3 de 3 (saldo)" }
  ]
}

Request mínimo

{
  "rut": "12345678-5",
  "password": "miClaveSII",
  "clave_certificado": "claveCert123",
  "rut_empresa": "76543210-3",
  "receptor": { "rut": "11111111-1" },
  "items": [{ "nombre": "Servicio consultoría", "cantidad": 1, "precio": 100000 }]
}

Request completo

{
  "rut": "12345678-5",
  "password": "miClaveSII",
  "clave_certificado": "claveCert123",
  "rut_empresa": "76543210-3",
  "receptor": {
    "rut": "11111111-1",
    "razon_social": "EMPRESA EJEMPLO SPA",
    "giro": "SERVICIOS DE INFORMATICA",
    "direccion": "AV. PRINCIPAL 123",
    "comuna": "SANTIAGO",
    "ciudad": "SANTIAGO",
    "contacto": "contacto@empresa.cl"
  },
  "items": [
    { "nombre": "Servicio consultoría", "cantidad": 1, "precio": 100000, "unidad": "UN" },
    { "nombre": "Hosting anual", "cantidad": 12, "precio": 15000, "unidad": "MES", "descuento": 10 }
  ],
  "forma_pago": "CREDITO",
  "descuento_global": 5,
  "pagos": [
    { "fecha": "2025-02-15", "monto": 150000, "glosa": "Primer pago - 50%" },
    { "fecha": "2025-03-15", "monto": 150000, "glosa": "Segundo pago - saldo" }
  ],
  "descargar_pdf": true
}

Requisitos:

• rut debe ser el RUT del representante legal (persona natural), NO el RUT de la empresa
• rut_empresa es obligatorio e identifica la empresa emisora
• La empresa debe tener habilitado el Servicio de Facturación Electrónica Gratuita del SII (portal MiPyME)

Tiempo estimado: 8-12 segundos (15-18s con descargar_pdf: true)

⚠️ IRREVERSIBLE: El documento queda registrado inmediatamente en el SII. Los folios son correlativos y no se pueden eliminar.

curl -X POST 'https://api.baseapi.cl/api/v1/sii/dte/emitir/factura' \
  -H 'x-api-key: TU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "rut": "12345678-5",
    "password": "miClaveSII",
    "clave_certificado": "claveCertificado123",
    "rut_empresa": "76543210-3",
    "tipo_dte": 33,
    "receptor": "...",
    "items": "[object Object]",
    "forma_pago": "CREDITO",
    "descuento_global": 5,
    "fecha_emision": "2024-12-01",
    "referencias": "[object Object]",
    "pagos": "[object Object]",
    "transporte": "...",
    "descargar_pdf": false
  }'

Emite una Factura No Afecta o Exenta (DTE tipo 34) directamente en el portal del SII. El campo tipo_dte se fuerza automáticamente a 34, no es necesario enviarlo.

---

Diferencias con Factura Afecta (Tipo 33)

• No se calcula ni cobra IVA — el total es igual al monto neto
• Los precios de los items se interpretan como montos finales (sin IVA)
• Usa el mismo formulario del SII pero con código PTDC=34

¿Cuándo usar Factura Exenta?

• Servicios exentos de IVA (educación, salud, seguros)
• Arriendos de inmuebles no amoblados
• Exportaciones de servicios
• Productos de la canasta básica exentos

Campos obligatorios y opcionales

Mismos campos que POST /sii/dte/emitir/factura — ver documentación de ese endpoint para la tabla completa de campos obligatorios y opcionales.

Request mínimo

{
  "rut": "12345678-5",
  "password": "miClaveSII",
  "clave_certificado": "claveCert123",
  "rut_empresa": "76543210-3",
  "receptor": { "rut": "11111111-1" },
  "items": [{ "nombre": "Arriendo oficina", "cantidad": 1, "precio": 500000 }]
}

Requisitos:

• rut debe ser el RUT del representante legal (persona natural), NO el RUT de la empresa
• rut_empresa es obligatorio e identifica la empresa emisora
• La empresa debe tener habilitado el Servicio de Facturación Electrónica Gratuita del SII

Tiempo estimado: 8-12 segundos

⚠️ IRREVERSIBLE: El documento queda registrado inmediatamente en el SII. Use este endpoint solo si su actividad económica permite factura exenta.

curl -X POST 'https://api.baseapi.cl/api/v1/sii/dte/emitir/factura-exenta' \
  -H 'x-api-key: TU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "rut": "12345678-5",
    "password": "miClaveSII",
    "clave_certificado": "claveCertificado123",
    "rut_empresa": "76543210-3",
    "tipo_dte": 33,
    "receptor": "...",
    "items": "[object Object]",
    "forma_pago": "CREDITO",
    "descuento_global": 5,
    "fecha_emision": "2024-12-01",
    "referencias": "[object Object]",
    "pagos": "[object Object]",
    "transporte": "...",
    "descargar_pdf": false
  }'

Emite una Guía de Despacho Electrónica (DTE tipo 52) directamente en el portal del SII.

---

Campos obligatorios

Mismos campos de credenciales que factura (rut, password, clave_certificado, rut_empresa), más:

Campo	Descripción
tipo_traslado	Obligatorio. Código del tipo de traslado (ver tabla abajo)
receptor.rut	RUT del destinatario
items	Al menos 1 item con nombre, cantidad y precio

Tipos de traslado

Código	Descripción	Caso de uso
1	Operación constituye venta	Despacho de venta ya facturada
2	Ventas por efectuar	Despacho previo a facturación
3	Consignaciones	Envío en consignación
4	Entrega gratuita	Muestras, donaciones
5	Traslados internos	Entre bodegas de la misma empresa
6	Otros traslados no venta	Reparaciones, préstamos
7	Guía de devolución	Devolución de mercadería
8	Traslado para exportación (no venta)	Envío a zona franca
9	Venta para exportación	Venta directa al exterior

Campos opcionales

Campo	Descripción
fecha_emision	Fecha YYYY-MM-DD (default: hoy)
transporte	Datos del transporte. Si se envía, los 6 sub-campos son obligatorios: rut_transporte, dv_transporte, patente, rut_chofer, dv_chofer, nombre_chofer
referencias	Hasta 3 referencias a facturas u otros documentos
descargar_pdf	Si true, retorna PDF en base64
items[].unidad	Unidad de medida (max 4 chars)
items[].descuento	Descuento por línea (0-100%)
items[].descripcion_extendida	Texto adicional (max 1000 chars)

Nota: A diferencia de factura, la guía no tiene forma_pago, descuento_global ni pagos.

Request mínimo

{
  "rut": "12345678-5",
  "password": "miClaveSII",
  "clave_certificado": "claveCert123",
  "rut_empresa": "76543210-3",
  "tipo_traslado": 5,
  "receptor": { "rut": "11111111-1" },
  "items": [{ "nombre": "Producto a trasladar", "cantidad": 10, "precio": 5000 }]
}

Request completo con transporte

{
  "rut": "12345678-5",
  "password": "miClaveSII",
  "clave_certificado": "claveCert123",
  "rut_empresa": "76543210-3",
  "tipo_traslado": 1,
  "receptor": {
    "rut": "11111111-1",
    "razon_social": "DISTRIBUIDORA SPA",
    "direccion": "AV. INDUSTRIAL 456",
    "comuna": "PUDAHUEL",
    "ciudad": "SANTIAGO"
  },
  "items": [
    { "nombre": "Caja producto A", "cantidad": 50, "precio": 5000, "unidad": "UN" },
    { "nombre": "Pallet producto B", "cantidad": 2, "precio": 150000, "unidad": "UN" }
  ],
  "transporte": {
    "rut_transporte": "76123456",
    "dv_transporte": "7",
    "patente": "ABCD12",
    "rut_chofer": "12345678",
    "dv_chofer": "9",
    "nombre_chofer": "JUAN PEREZ GONZALEZ"
  },
  "referencias": [
    { "tipo_documento": "33", "folio": "1234", "fecha": "2025-01-10", "razon": "Despacho de factura" }
  ],
  "descargar_pdf": true
}

Características: La guía SÍ incluye IVA (19%). Las guías de despacho tipo 1 y 2 deben facturarse posteriormente.

Requisitos:

• rut debe ser el RUT del representante legal (persona natural), NO el RUT de la empresa
• rut_empresa es obligatorio e identifica la empresa emisora
• La empresa debe tener habilitado el Servicio de Facturación Electrónica Gratuita del SII

Tiempo estimado: 8-12 segundos (15-18s con descargar_pdf: true)

⚠️ IRREVERSIBLE: El documento queda registrado inmediatamente en el SII.

curl -X POST 'https://api.baseapi.cl/api/v1/sii/dte/emitir/guia-despacho' \
  -H 'x-api-key: TU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "rut": "12345678-5",
    "password": "miClaveSII",
    "clave_certificado": "claveCertificado123",
    "rut_empresa": "76543210-3",
    "tipo_traslado": 1,
    "receptor": "...",
    "items": "[object Object]",
    "fecha_emision": "2024-12-01",
    "transporte": "...",
    "referencias": "[object Object]",
    "descargar_pdf": false
  }'

Emite múltiples facturas electrónicas en una sola sesión autenticada.

---

Ventajas vs emisión individual

• Más eficiente — solo se autentica una vez para todo el lote
• ~4 segundos por factura (vs ~10s individual)
• Cada factura tiene su propio resultado (éxito/error)

Límites

Límite	Valor
Facturas por lote	1 a 50
Items por factura	1 a 10
Tipo de DTE	Todas del mismo tipo (tipo_dte se aplica a todo el lote)

Campos obligatorios

Campo	Descripción
rut	RUT del usuario que se autentica en el SII
password	Contraseña del SII
clave_certificado	Clave del certificado digital
rut_empresa	RUT de la empresa emisora
facturas	Array de facturas, cada una con receptor (obligatorio: rut) e items

Campos opcionales

Campo	Default	Descripción
tipo_dte	33	Se aplica a todas las facturas del lote
facturas[].receptor.*	autocompletado	Razón social, giro, dirección, etc.
facturas[].forma_pago	—	CONTADO, CREDITO, SIN_COSTO (por factura)
facturas[].descuento_global	—	Porcentaje de descuento global (por factura)
facturas[].referencias	—	Hasta 3 referencias (por factura)
facturas[].items[].unidad	—	Unidad de medida (max 4 chars)
facturas[].items[].descuento	—	Descuento por línea (0-100%)

Request ejemplo

{
  "rut": "12345678-5",
  "password": "miClaveSII",
  "clave_certificado": "claveCert123",
  "rut_empresa": "76543210-3",
  "tipo_dte": 33,
  "facturas": [
    {
      "receptor": { "rut": "11111111-1" },
      "items": [{ "nombre": "Servicio mes enero", "cantidad": 1, "precio": 100000 }]
    },
    {
      "receptor": { "rut": "22222222-2" },
      "items": [
        { "nombre": "Producto A", "cantidad": 5, "precio": 20000 },
        { "nombre": "Producto B", "cantidad": 2, "precio": 35000 }
      ],
      "forma_pago": "CONTADO"
    }
  ]
}

Comportamiento en errores

• Las facturas se emiten secuencialmente — si la factura #3 falla, las #1 y #2 ya están emitidas e irreversibles
• El response incluye un resultado individual por cada factura con su folio o error
• El campo success del response global es true si al menos una factura se emitió

Requisitos:

• rut debe ser el RUT del representante legal (persona natural), NO el RUT de la empresa
• rut_empresa es obligatorio e identifica la empresa emisora
• La empresa debe tener habilitado el Servicio de Facturación Electrónica Gratuita del SII

Tiempo estimado: ~4 segundos x cantidad de facturas + ~8s de autenticación inicial

⚠️ IRREVERSIBLE: Cada factura emitida queda registrada inmediatamente en el SII. No se hace rollback de las exitosas si una posterior falla.

curl -X POST 'https://api.baseapi.cl/api/v1/sii/dte/emitir/lote' \
  -H 'x-api-key: TU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "rut": "12345678-5",
    "password": "miClaveSII",
    "clave_certificado": "claveCertificado123",
    "rut_empresa": "76543210-3",
    "tipo_dte": 33,
    "facturas": "[object Object]"
  }'

Consulta los datos autocompletados de un RUT en el formulario del SII.

Datos retornados:

• Razón social registrada
• Giros económicos disponibles
• Direcciones registradas
• Comuna y ciudad

Útil para:

• Precargar datos antes de emitir factura
• Validar que el receptor existe en el SII
• Obtener giros disponibles para selección

Tiempo estimado: ~5-8 segundos (requiere autenticación SII)

curl -X POST 'https://api.baseapi.cl/api/v1/sii/dte/receptor/77000000-0' \
  -H 'x-api-key: TU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "rut": "12345678-5",
    "password": "miClaveSII",
    "rut_empresa": "76543210-3"
  }'

Obtiene los datos de la empresa emisora desde el formulario del SII.

Datos retornados:

• Razón social
• Giro principal
• Actividad económica
• Dirección, comuna, ciudad
• Email y teléfono registrados
• Código de sucursal (si aplica)

Útil para:

• Verificar datos de la empresa antes de emitir
• Obtener información para mostrar en la factura

Tiempo estimado: ~5-8 segundos

curl -X POST 'https://api.baseapi.cl/api/v1/sii/dte/emisor' \
  -H 'x-api-key: TU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "rut": "12345678-5",
    "password": "miClaveSII",
    "rut_empresa": "76543210-3"
  }'

Retorna los tipos de Documentos Tributarios Electrónicos soportados para emisión.

Tipos de documento:

• 33 - Factura Electrónica: Documento con IVA, el más común
• 34 - Factura No Afecta o Exenta: Sin IVA (exportaciones, exenciones)
• 56 - Nota de Débito: Aumenta el monto de una factura existente
• 61 - Nota de Crédito: Disminuye o anula una factura existente

Formas de pago:

• CONTADO: Pago inmediato
• CREDITO: Permite especificar pagos programados
• SIN_COSTO: Para muestras gratis, bonificaciones, etc.

curl -X GET 'https://api.baseapi.cl/api/v1/sii/dte/tipos' \
  -H 'x-api-key: TU_API_KEY' \
  -H 'Content-Type: application/json'