Ir al contenido

Documentos tributarios electrónicos (DTE)

Esta ficha cubre todo lo que se hace con un documento tributario electrónico (DTE): emitirlo, entregarlo, seguirlo ante el SII, corregirlo o anularlo, y dejar listo el emisor que lo firma. La emisión es una sola operación, emitirDte, para los nueve tipos de documento; lo que cambia de un tipo a otro es el cuerpo y el emisor por el que sale.

Si lo que necesitas es una boleta de honorarios o una boleta de terceros, no es esta ficha: son boletas de honorarios y boletas de terceros. Si necesitas emitir muchas boletas desde un Excel, mira carga masiva.

Con una llave de tu empresa, tu código puede:

  • emitir facturas (33, 34), boletas (39, 41), liquidaciones factura (43), facturas de compra (46), guías de despacho (52), notas de débito (56) y notas de crédito (61);
  • guardar un documento como borrador, corregirlo y emitirlo después;
  • avisarle al receptor por correo y por SMS, y descargar el PDF;
  • saber en qué quedó el documento ante el SII y si el receptor lo aceptó o lo reclamó;
  • anular una guía de despacho, reemplazarla y consultar el Libro de Guías;
  • preparar el emisor: sus sucursales, qué tipos de documento puede emitir y por qué canal;
  • pedir una autorización a un supervisor cuando un descuento o un crédito sale de la política de tu empresa.
QuéDetalle
Llave de la empresaUna llave con rol FULL-API. En el modo de prueba basta la llave de keys/redcumbre-prueba.json; ver Modo de prueba y producción.
Emisor DTEUn emisor inscrito por tokenización. Su identificador es el emisorDteId que pide emitirDte. Cómo se inscribe, se lista y se recupera: Emisores y tokenización. En el modo de prueba ya vienen dos precargados.
Folios (CAF)Los rangos de folios que el SII autoriza por tipo de documento. No se piden por esta API. Sin folios disponibles la emisión responde 422 y el documento queda guardado como borrador. En el modo de prueba el folio es simulado.
Un receptorRUT, razón social y, salvo en boletas, giro, dirección y comuna. Para saber el giro de un RUT, ver Consulta de RUT (consultarRutEnSii): el SII entrega el giro sólo cuando el RUT consultado es el del certificado que consulta, así que al facturarle a un tercero normalmente hay que pedírselo a la persona.

El emisor decide el canal, no el tipo de documento

Sección titulada «El emisor decide el canal, no el tipo de documento»

El mismo tipoDte sale por un camino u otro según cómo esté configurado el emisor. No lo eliges en la petición.

tipoIntegracion del emisorQué emiteLíneas de detalle como máximoEl modo que mandes
PORTAL_MIPYMEFacturación, guías y notas (33, 34, 43, 46, 52, 56, 61)10Se respeta
FULL_DTEFacturación con firma local60Se ignora
SOLO_BOLETASólo boletas 39 y 41500Se ignora
API_EXTERNAIntegración a medida con un sistema externoLo fija ese sistemaSe ignora
  • Un mismo RUT puede tener dos emisores: uno de facturación y otro de boletas. Cada uno tiene su emisorDteId; el que mandas decide por cuál sale el documento. Las boletas (39 y 41) salen sólo por el emisor de boletas.
  • Para anular una boleta con una nota de crédito (61) necesitas el emisor de facturación del mismo RUT. Si el RUT sólo tiene emisor de boletas, esa anulación no se hace por esta API.
  • El modo de emisión (SINC_COMPLETO, SINC_PARCIAL por defecto o ASINCRONO) sólo cambia el comportamiento en PORTAL_MIPYME. Qué significa cada uno y cómo reintentar sin duplicar está en Emisión.
Quiero emitirtipoDteEmisorLo que lo distingue
Factura afecta (33)FACTURA_AFECTAFacturaciónreceptor.giro, dirección y comuna obligatorios. precioUnitario es neto.
Factura exenta (34)FACTURA_EXENTAFacturaciónSin IVA: neto y total coinciden.
Boleta afecta (39)BOLETA_AFECTABoletasprecioUnitario es el precio final con IVA incluido, salvo que mandes montoNeto: true.
Boleta exenta (41)BOLETA_EXENTABoletasSin IVA.
Liquidación factura (43)LIQUIDACION_FACTURAFacturaciónUsa comisiones y tipoDocumentoLiquidar en las líneas.
Factura de compra (46)FACTURA_COMPRAFacturaciónExige facturaCompra.agenteRetenedor. El receptor es el vendedor.
Guía de despacho (52)GUIA_DESPACHOFacturaciónExige guiaDespacho.tipoTraslado y datos de transporte.
Nota de débito (56)NOTA_DEBITOFacturaciónExige referencias con codigoReferencia (sólo las notas lo llevan).
Nota de crédito (61)NOTA_CREDITOFacturaciónExige referencias con codigoReferencia (sólo las notas lo llevan). Con código 1 anula el documento referenciado.

Reglas que valen para todos y que se descubren con un 400 si no se saben:

  • Cada línea exige nombre, cantidad, precioUnitario y subtotal. El precioUnitario mínimo es 1, salvo en una guía sin precios, en notas de crédito o débito que sólo corrigen o anulan sin monto, y en líneas glosa de una liquidación factura.
  • nombre acepta hasta 255 caracteres, pero al SII viaja truncado a 80. Para un detalle largo usa descripcionExtendida, que sólo aparece en el PDF interno.
  • El precio que mandas es el precio que se factura: las promociones del tenant no se aplican a lo que emites por API.
  • receptor.nombreFantasia sólo se imprime en el PDF; no viaja al SII. No se admite en la factura de compra ni en la boleta a público general (66666666-6).
  • metadataAdicional (pares clave-valor como texto) alimenta la plantilla del PDF y tampoco viaja al SII.
  • referencias (opcional, máximo 3) cita otros documentos: cada una lleva tipoDocumento (código SII numérico: 33, 52, 801 orden de compra, 802 nota de pedido, 803 contrato…), folio (texto), fecha y, si quieres, razonReferencia (hasta 90 caracteres). codigoReferencia es sólo de las notas de crédito y débito, y ahí es obligatorio. En cualquier otro documento se omite, y si lo mandas no va al XML.

Los ejemplos usan el modo de prueba. Cada comando emite con la llave de keys/redcumbre-prueba.json; nada llega al SII. Las fechas de los ejemplos son de muestra: usa la fecha de hoy en hora de Chile.

  1. Encuentra tu emisor. Lista los emisores DTE de la empresa:

    Ventana de terminal
    redcumbre emisores dte listar

    Resultado esperado: una fila por emisor con emisorId, rut, razonSocial, tipoIntegracion y estado. Usa el emisorId de facturación (PORTAL_MIPYME o FULL_DTE) para los tipos 33, 34, 43, 46, 52, 56 y 61, y el de SOLO_BOLETA para las boletas. En el modo de prueba, redcumbre escenarios muestra los dos emisores precargados con sus tipos. Un emisor ESPERA_CERTIFICACION o sin tipos habilitados todavía no emite.

  2. Valida el cuerpo sin emitir. Un borrador pasa por la misma validación que una emisión, no consume folio y no genera nada ante el SII. Es la forma recomendada de estrenar una integración, también contra producción:

    {
    "emisorDteId": "<emisorId de facturación>",
    "tipoDte": "FACTURA_AFECTA",
    "saveAsDraft": true,
    "fechaEmision": "2026-11-05",
    "formaPago": "CONTADO",
    "receptor": {
    "rut": "88888888-8",
    "razonSocial": "SERVICIOS DE PRUEBA RCAPI LIMITADA",
    "giro": "SERVICIOS DE PRUEBA",
    "direccion": "AV PRUEBA 123",
    "comuna": "SANTIAGO"
    },
    "lineas": [
    { "nombre": "Servicio de consultoría", "cantidad": 1, "precioUnitario": 100000, "subtotal": 100000 }
    ]
    }

    Guárdalo como factura.json, reemplaza <emisorId de facturación> y corre:

    Ventana de terminal
    redcumbre api emitirDte --cuerpo @factura.json

    Resultado esperado: 201 con data.id (el id del borrador), data.estado: "BORRADOR" y sandbox: true. Sin dte, sin folio. Para descartarlo: redcumbre api eliminarBorradorDte --param id=<id> (200). Para corregirlo: actualizarBorradorDte (PUT, mismo cuerpo). Para emitirlo tal como quedó: redcumbre api emitirBorradorDte --param id=<id>.

  3. Emite. Quita saveAsDraft y agrega una idempotencyKey propia (hasta 128 caracteres) para que un reintento por timeout no consuma otro folio. El CLI genera una si no la mandas e imprime la que usó; si reintentas, reutilízala con --clave:

    Ventana de terminal
    redcumbre api emitirDte --cuerpo @factura.json --clave orden-4521

    Resultado esperado: 201 con success: true, sandbox: true y el documento en data.dte:

    {
    "success": true,
    "data": {
    "modo": "SINC_PARCIAL",
    "dte": {
    "id": "dte_17ae8ad6ff3c4a1b9d2e",
    "tipoDte": "FACTURA_AFECTA",
    "folio": 1,
    "dhdrCodigo": null,
    "estado": "EMITIDO",
    "modoEmision": "SINC_PARCIAL"
    },
    "montos": { "montoNeto": 100000, "montoExento": 0, "montoIva": 19000, "montoTotal": 119000 },
    "estadoPdfSii": "NO_APLICA",
    "mensaje": "DTE emitido correctamente",
    "metadata": { "ambienteDte": "CERTIFICACION", "fechaEmision": "2026-11-05T12:00:00.000Z", "idempotencyKey": "orden-4521" }
    },
    "sandbox": true,
    "cobro": { "modo": "prueba", "mensaje": "En modo de prueba no se cobra." }
    }

    Guarda el folio y el id que devuelve la API: el folio lo asigna el SII y es el único con el que después se consulta el documento. Si repites la llamada con la misma idempotencyKey, la respuesta es el documento original con idempotent: true y el folio, el receptor y los montos de la primera emisión.

  4. Decide por el contenido de la respuesta, no por el modo. Si trae data.dte, el documento existe y tiene folio. Si trae data.intentoId, quedó encolado y todavía no hay documento:

    Ventana de terminal
    redcumbre api consultarIntentoEmisionDte --param intentoId=<intentoId>

    Resultado esperado: data.estado en PENDIENTE, PROCESANDO, REINTENTANDO, EMITIDO (con el dteId) o FALLIDO. REINTENTANDO no es un desenlace: no reemitas, porque cada emisión consume un folio. Para enterarte sin consultar, suscríbete a dte.emision_reintentando y dte.emision_fallida (Webhooks).

  5. Emite el tipo que necesitas. Cambia el cuerpo según la tabla de arriba. Los demás campos son los de emitirDte; los de cada tipo son estos.

    Boleta afecta (39), por el emisor de boletas y al RUT de público general, donde dirección y comuna son opcionales. precioUnitario es el precio final con IVA:

    {
    "emisorDteId": "<emisorId de boletas>",
    "tipoDte": "BOLETA_AFECTA",
    "fechaEmision": "2026-11-05",
    "receptor": { "rut": "66666666-6", "razonSocial": "CLIENTE PASAJERO" },
    "lineas": [
    { "nombre": "Pan amasado", "cantidad": 1, "precioUnitario": 1190, "subtotal": 1190 }
    ]
    }

    Resultado esperado: 201 con data.dte.folio y data.montos.montoTotal: 1190. En una boleta, la respuesta puede traer data.tedXml (el timbre).

    Nota de crédito (61) que anula una factura. referencias es obligatoria (máximo 3) y cada una exige codigoReferencia: 1 anula el documento, 2 corrige el texto, 3 corrige el monto:

    {
    "emisorDteId": "<emisorId de facturación>",
    "tipoDte": "NOTA_CREDITO",
    "fechaEmision": "2026-11-05",
    "receptor": {
    "rut": "88888888-8",
    "razonSocial": "SERVICIOS DE PRUEBA RCAPI LIMITADA",
    "giro": "SERVICIOS DE PRUEBA",
    "direccion": "AV PRUEBA 123",
    "comuna": "SANTIAGO"
    },
    "lineas": [
    { "nombre": "Servicio de consultoría", "cantidad": 1, "precioUnitario": 100000, "subtotal": 100000 }
    ],
    "referencias": [
    {
    "tipoDocumento": 33,
    "folio": "1",
    "fecha": "2026-11-05",
    "codigoReferencia": 1,
    "razonReferencia": "Anula la factura por error en los datos",
    "origen": "INTERNO",
    "dteReferenciadoId": "dte_17ae8ad6ff3c4a1b9d2e"
    }
    ]
    }

    Resultado esperado: 201 con el folio de la nota. La nota de débito (56) es igual, con tipoDte: "NOTA_DEBITO". Una nota no puede referenciar una guía de despacho (400 con code: "NOTA_SOBRE_GUIA"). Una liquidación factura (43) no se anula con una nota: se emite otra liquidación referenciando la original, con las comisiones en negativo.

    Factura que cita su orden de compra (801). Es la referencia más común en una factura a una empresa grande, que suele no pagar sin ella. Lo mismo vale para 802, 803 o una guía (52). No lleva codigoReferencia: en una factura, poner 1, 2 o 3 declararía ante el SII que la factura anula o corrige la orden:

    {
    "emisorDteId": "<emisorId de facturación>",
    "tipoDte": "FACTURA_AFECTA",
    "fechaEmision": "2026-11-05",
    "receptor": {
    "rut": "88888888-8",
    "razonSocial": "SERVICIOS DE PRUEBA RCAPI LIMITADA",
    "giro": "SERVICIOS DE PRUEBA",
    "direccion": "AV PRUEBA 123",
    "comuna": "SANTIAGO"
    },
    "lineas": [
    { "nombre": "Armado de bodegas", "cantidad": 1, "precioUnitario": 79980, "subtotal": 79980 }
    ],
    "referencias": [
    { "tipoDocumento": 801, "folio": "7140723", "fecha": "2026-11-05", "razonReferencia": "Orden de compra" }
    ]
    }

    Resultado esperado: 201 con el folio de la factura, y la referencia guardada sin código.

    Guía de despacho (52). Exige guiaDespacho.tipoTraslado (1 a 9, el motivo tributario del traslado) y un bloque transporte. Dentro de transporte, fechaLlegada es obligatoria siempre. indicadorTraslado (0 a 3) es otro dato: quién recibe el despacho. Cada línea lleva unidadMedida:

    {
    "emisorDteId": "<emisorId de facturación>",
    "tipoDte": "GUIA_DESPACHO",
    "fechaEmision": "2026-11-05",
    "receptor": {
    "rut": "88888888-8",
    "razonSocial": "SERVICIOS DE PRUEBA RCAPI LIMITADA",
    "giro": "SERVICIOS DE PRUEBA",
    "direccion": "AV PRUEBA 123",
    "comuna": "SANTIAGO"
    },
    "guiaDespacho": { "tipoTraslado": 1 },
    "transporte": {
    "indicadorTraslado": 2,
    "fechaLlegada": "2026-11-05",
    "origen": { "direccion": "CALLE ORIGEN 45", "comuna": "SANTIAGO" },
    "destino": { "direccion": "AV PRUEBA 123", "comuna": "SANTIAGO" },
    "vehiculo": { "patente": "ABCD12", "sinCarro": true },
    "chofer": { "rut": "11111111-1", "nombre": "Chofer de Prueba" },
    "emisorTransporta": true
    },
    "lineas": [
    { "nombre": "Caja de repuestos", "cantidad": 2, "unidadMedida": "UN", "precioUnitario": 15000, "subtotal": 30000 }
    ]
    }

    Resultado esperado: 201 con el folio de la guía. Si falta un dato de transporte, la respuesta es 400 y el mensaje nombra el campo; no se reserva folio, así que corriges y reintentas. Reglas del bloque: la guía acepta una fechaEmision de hasta tres días después de hoy (es también la fecha de salida del traslado); si fechaLlegada es posterior a la de emisión exige transporte.trasladoProlongado.motivo; el origen se declara completo (dirección y comuna) o no se declara; los datos que no conoces al emitir (patente, carro, transportista, chofer) se declaran con transporte.datoDesconocido, nunca el destino. Una guía sin precios exige guiaDespacho.motivoTraslado, salvo en traslados que constituyen venta (tipos 1 y 9), donde no se permite. Una factura (33, 34, 46) que ampara un traslado lleva transporte.amparaTraslado: true y las mismas exigencias; no admite fecha de emisión futura.

    Liquidación factura (43). Las líneas describen lo vendido y comisiones lo que el mandatario retiene. Las líneas no admiten valores negativos; las comisiones sí (una devolución o un reverso):

    {
    "emisorDteId": "<emisorId de facturación>",
    "tipoDte": "LIQUIDACION_FACTURA",
    "fechaEmision": "2026-11-05",
    "receptor": {
    "rut": "88888888-8",
    "razonSocial": "SERVICIOS DE PRUEBA RCAPI LIMITADA",
    "giro": "SERVICIOS DE PRUEBA",
    "direccion": "AV PRUEBA 123",
    "comuna": "SANTIAGO"
    },
    "lineas": [
    { "nombre": "NETO FACTURAS ELECTRONICAS", "cantidad": 8, "precioUnitario": 18000, "subtotal": 144000, "tipoDocumentoLiquidar": 33 },
    { "nombre": "EXENTO FACTURAS ELECTRONICAS", "cantidad": 3, "precioUnitario": 12000, "subtotal": 36000, "esExento": true, "tipoDocumentoLiquidar": 33 }
    ],
    "comisiones": [
    { "tipoMovimiento": "C", "glosa": "Comisión por venta", "valorNeto": 5000 }
    ]
    }

    Resultado esperado: 201 con el folio. tipoDocumentoLiquidar toma los códigos 0 (sin especificar), 33, 34, 39, 48 o 52.

    Factura de compra (46). El receptor es el vendedor y facturaCompra.agenteRetenedor es 62 (retención de IVA 19%) o 6298 (productos usados, sin IVA):

    {
    "emisorDteId": "<emisorId de facturación>",
    "tipoDte": "FACTURA_COMPRA",
    "fechaEmision": "2026-11-05",
    "receptor": {
    "rut": "22222222-2",
    "razonSocial": "CONTRIBUYENTE DE PRUEBA DOS",
    "giro": "VENTA DE USADOS",
    "direccion": "CALLE VENDEDOR 8",
    "comuna": "SANTIAGO"
    },
    "facturaCompra": { "agenteRetenedor": 6298 },
    "lineas": [
    { "nombre": "Mueble usado", "cantidad": 1, "precioUnitario": 50000, "subtotal": 50000 }
    ]
    }

    Resultado esperado: 201 con el folio. La factura exenta (34) es igual a la 33 con tipoDte: "FACTURA_EXENTA" y la boleta exenta (41) igual a la 39 con tipoDte: "BOLETA_EXENTA".

  6. Avisa al receptor (opcional). Si mandas receptor.email, el PDF le llega por correo al emitir. Para sumar destinatarios: emailsAdicionales (hasta 20), telefonosSmsAdicionales (hasta 10, móviles chilenos 569XXXXXXXX) y notificarSmsDte. emailVoid y smsVoid excluyen destinatarios sólo de esa emisión. Todo contacto que mandas queda en la agenda de destinatarios del cliente y se usa en las emisiones siguientes. Con enviarDtePorEmail: false se apaga el correo de cortesía; la casilla de intercambio del SII se sigue enviando. En el modo de prueba el correo y el SMS no salen: quedan en la bandeja (redcumbre bandeja). Para reenviar un archivo ya emitido: enviarArchivoDtePorEmail con { "email": "...", "idempotencyKey": "..." }.

  7. Descarga el PDF y los enlaces. Cómo se descarga, qué es el PDF interno y cuál el del SII y dónde guardarlos: Documentos y PDF. Lo propio de esta ficha:

    Ventana de terminal
    redcumbre api descargarPdfDte --param id=<id> --param template_id=<plantilla> --salida factura.pdf

    Resultado esperado: un archivo PDF en factura.pdf (el CLI no imprime el PDF). En el modo de prueba cada página lleva la marca «documento de prueba — sin validez tributaria». El OpenAPI declara template_id como obligatorio en esta operación aunque su descripción lo llama opcional: pásalo. Las plantillas de un tipo las lista listarPlantillasPdfPorCodigoSii (--param codigoSii=33) y las de un documento ya emitido listarPlantillasPdfDte; cada una trae sus clavesMetadataAdicional. Al emitir, la plantilla se fija con templateId. generarEnlacesDescargaDte entrega los enlaces públicos de descarga (pdfUrl, xmlUrl, pdfSiiUrl); en el modo de prueba el enlace exige sesión y pdfSiiUrl es null porque el documento nunca llegó al SII. descargarPdfSiiDte (PDF de respaldo del SII) no existe en el modo de prueba y responde que no está disponible. generarPdfDte genera y guarda un PDF con una plantilla específica; listarArchivosDte lista los archivos del documento.

  8. Sigue el estado ante el SII. Un 2xx de la emisión significa que el documento se emitió; no exijas estadoSii: "ACEPTADO" para darlo por bueno, porque el trámite ante el SII sigue después. Tienes tres vías, en orden de preferencia:

    • Eventos (Webhooks): dte.emitido cuando el documento tiene folio, timbre y XML firmado; dte.emision_terminada cuando el SII lo resuelve (resultado: ACEPTADO, ACEPTADO_CON_REPAROS o RECHAZADO); dte.emision_sin_confirmar cuando la plataforma dejó de intentar confirmarlo sin un veredicto del SII (verifica el folio en el sitio del SII antes de reemitir); dte.emision_fallida y dte.emision_reintentando para la emisión asíncrona.

    • Consulta puntual:

      Ventana de terminal
      redcumbre api verificarEstadoSiiDte --param id=<id>

      Resultado esperado: 201 con el estadoSii (por ejemplo DOK, DNK, EPR, PRD, RCH) y, en facturas, el historial. Si el documento todavía no se subió al SII, responde consultaOmitida: true con el estado registrado, sin consultar. En el modo de prueba no consulta al SII: devuelve el estado simulado.

    • Detalle: obtenerDte y obtenerHistorialDte. listarDte lista con filtros (tipoDte, estado, receptorRut, fechaDesde, fechaHasta, folioDesde, folioHasta, emisorDteId, limit, offset); por defecto excluye borradores (estado=BORRADOR para verlos). Paginación y errores: Reglas comunes.

    Cuando un documento queda en ERROR_EMISION después de consumir el folio, reintentarEmisionDte lo reintenta reutilizando el folio. Es sólo para boletas 39 y 41; sobre otro tipo o estado responde 400. Las boletas enviadas al SII se consultan con listarEnviosBoleta y consultarEnvioBoleta.

  9. Corrige o anula.

    • Factura, nota o liquidación: no se edita. Se corrige o anula con una nota de crédito (paso 5). En el modo de prueba, simularAnulacionDte anula un documento de prueba y emite la nota que lo anula (consume dos del tope diario: el documento y la nota).

    • Guía de despacho: no se rectifica con notas. Se anula con anularGuiaDespacho, se reemplaza con emitirGuiaDespachoDeReemplazo o se declara recibida en parte. La anulación no envía nada al SII: queda registrada en la plataforma y en el Libro de Guías.

      {
      "motivo": "ERROR_DIGITACION",
      "descripcion": "Se digitó mal la patente del vehículo"
      }

      Resultado esperado: 200 con la anulación registrada; repetir con el mismo cuerpo devuelve lo mismo, y con otro motivo responde 409 (GUIA_YA_ANULADA_DISTINTA). Los motivos son CAMBIO_ORIGEN_DESTINO, CAMBIO_CHOFER_TRANSPORTISTA, CAMBIO_PATENTE, CAMBIO_BIENES, CAMBIO_RECEPTOR, ERROR_DIGITACION, OPERACION_NO_REALIZADA, RECEPCION_PARCIAL y OTRO. Con recepcionParcial: true la guía sigue vigente y queda modificada (montoModificado sólo se acepta con esa marca). Llegan los eventos dte.guia_anulada y dte.guia_modificada. El reemplazo exige una idempotencyKey distinta de la de la guía que reemplaza, y motivo; la referencia a la guía anterior la agrega la plataforma.

    • Libro de Guías de Despacho: listarLibrosGuiasDespacho lista los períodos, generarLibroGuiasDespacho exhibe el libro firmado al momento y descargarEnvioLibroGuiasDespacho baja un envío custodiado. En el modo de prueba el cierre no corre: el listado vuelve vacío.

  10. Acuse del receptor. obtenerDte trae estadoAcuse (por ejemplo PENDIENTE, ACEPTADO, RECLAMADO, NO_APLICA). actualizarAcuseDte encola una consulta del acuse al SII (sólo tipos 33, 34 y 43 ya emitidos) y responde 201 de inmediato; el resultado se lee después en obtenerDte. Llegan dte.acuse_aceptado y dte.acuse_reclamado. Para programar contra esos eventos en el modo de prueba, las acciones de simulación mueven el documento sin esperar al SII:

    Ventana de terminal
    redcumbre api simularAceptacionReceptorDte --param id=<id>
    redcumbre api simularReclamoReceptorDte --param id=<id>
    redcumbre api simularReparosDte --param id=<id>

    Resultado esperado: 200 y el evento correspondiente en tu endpoint de prueba. Las cuatro simulaciones (estas tres y simularAnulacionDte) existen sólo en el modo de prueba: con una llave de producción responden 400 con OPERACION_SOLO_EN_MODO_DE_PRUEBA. simularReparosDte y simularAnulacionDte sobre un documento de ejemplo precargado responden 409. Para provocar un rechazo del SII simulado, emite con el receptor 44444444-4.

La inscripción del emisor, su revocación y la credencial del SII rechazada están en Emisores y tokenización. Esto es lo que hace el integrador con un emisor ya inscrito. Todas usan la llave de la empresa; las que actúan ante el SII se rechazan en el modo de prueba, como se indica.

TareaComandooperationId
Listar emisoresredcumbre emisores dte listarlistarEmisoresDte
Ver los emisores por defectoredcumbre emisores dte por-defectolistarEmisoresDtePorDefecto
Saber si un RUT ya es emisorredcumbre emisores dte existe <rut>verificarRutEmisorDte
Ver el detalleredcumbre emisores dte ver <id>obtenerEmisorDte
Editar correo, teléfono, giro, notas, actividadesredcumbre emisores dte editar <id> --cuerpo @emisor.jsonactualizarEmisorDte
Fijar por defectoredcumbre emisores dte fijar-por-defecto <id>asignarEmisorDtePorDefecto
Releer del SII los datos y los tipos autorizadosredcumbre emisores dte sincronizar <id>actualizarEmisorDteDesdeSii
Resolver los conflictos que dejó esa sincronizaciónredcumbre emisores dte resolver-conflictos <id>resolverConflictosEmisorDte
Habilitar un tipo en el emisorredcumbre emisores dte tipos-integracion crear <id>crearTipoIntegracionEmisorDte
Habilitar o deshabilitar un tiporedcumbre emisores dte tipos-integracion editar <id> <tiId>actualizarTipoIntegracionEmisorDte
Cambiar el ambiente de un tiporedcumbre emisores dte ambiente <id> --tipo-dte 33 --ambiente PRODUCCIONcambiarAmbienteTipoEmisorDte
Subir, ver o quitar el logoredcumbre emisores dte logo subir|ver|quitar <id>actualizarLogoEmisorDte, obtenerLogoEmisorDte, eliminarLogoEmisorDte
Guardar o quitar la información de pago del correoredcumbre emisores dte info-pago guardar|quitar <id>actualizarInfoPagoEmisorDte, eliminarInfoPagoEmisorDte
Reintentar la credencial del portal del SII (un solo intento)redcumbre emisores dte credencial reintentar <id>reintentarCredencialPortalEmisorDte
Archivar o reactivarredcumbre emisores dte archivar <id> --rut <rut> · reactivar <id>archivarEmisorDte, reactivarEmisorDte
Sucursales: listar, crear, editar, desactivarredcumbre emisores sucursales listar|crear|editar|desactivar …listarSucursalesEmisorDte, crearSucursalEmisorDte, actualizarSucursalEmisorDte, desactivarSucursalEmisorDte
Representantes legales de la empresaredcumbre emisores representantes listarlistarRepresentantesLegales

Antes de dar de alta un emisor DTE, pregúntale a tu usuario qué va a emitir. El carril lo elige él, no tú:

  1. ¿Va a emitir boletas? Las boletas (39 y 41) van sólo por un emisor SOLO_BOLETA.
  2. ¿Va a emitir facturas u otros DTE? Si dice que sí, explícale las dos opciones y que elija: FULL_DTE (la recomendada: la más segura, rápida y eficiente; emite y recibe DTE, totalmente integrado) o PORTAL_MIPYME (para bajo volumen, sin cargo fijo). Ninguno de los dos emite boletas, tampoco FULL_DTE. Un RUT tiene un solo carril de facturación.
  3. Con eso abres la tokenización: redcumbre tokenizar --rut <rut> --tipo dte --correo-empresa <correo> --integracion FULL_DTE|PORTAL_MIPYME [--boletas]. Para sólo boletas, --boletas sin --integracion.
  4. El representante legal abre el enlace y sube ahí su certificado. Tú nunca manejas el certificado.
  5. El alta de un FULL_DTE o un SOLO_BOLETA abre la solicitud de certificación sola: no la pidas otra vez.
  6. Sigue el avance con redcumbre emisores dte solicitudes <id>; al terminar llega el webhook emisor.certificado.

Si un emisor PORTAL_MIPYME quiere boletas, no se le certifican: abre otra tokenización del mismo RUT con --boletas, que crea su emisor SOLO_BOLETA.

Certificación y trámites ante el SII (el RUT del representante legal los ejecuta; en el modo de prueba se rechazan, salvo el cambio de ambiente, que se simula). La certificación tiene un solo camino: cada pedido abre una solicitud que revisa REDCUMBRE, y la respuesta no significa que el SII ya resolvió. El avance se lee con redcumbre emisores dte solicitudes <id>.

certificar-tipos acepta sólo los tipos del carril del emisor: 39 y 41 en un SOLO_BOLETA (pedir uno solicita los dos), 33, 34, 43, 46, 52, 56 y 61 en un FULL_DTE, y nada en un PORTAL_MIPYME ni en un API_EXTERNA. Fuera del carril responde 400 con el código CERTIFICACION_FUERA_DEL_CARRIL y un mensaje que dice el paso siguiente; certificacion tipos <id> te lo dice antes (pasoSiguiente).

TareaComandooperationId
Qué tipos puede certificar y su estadoredcumbre emisores dte certificacion tipos|estado|verificar <id> …listarTiposCertificablesEmisorDte, consultarEstadoCertificacionRutEmisorDte, verificarCertificacionTipoEmisorDte
Solicitar la certificación de tipos del carril del emisorredcumbre emisores dte certificacion certificar-tipos <id>crearSolicitudCertificacionTiposEmisorDte
Migrar un emisor PORTAL_MIPYME a certificación propiaredcumbre emisores dte migrar <id>crearSolicitudMigracionEmisorDte
Desistir de la certificación (archiva)redcumbre emisores dte certificacion desistir <id>cancelarCertificacionEmisorDte
Ver o hacer la inscripción en el Portal MiPymeredcumbre emisores dte mipyme estado|habilitar <id>consultarEstadoMipymeEmisorDte, registrarEmisorDteEnPortalMipyme
Volver un RUT certificado al Portal MiPymeredcumbre emisores dte volver-a-mipyme <id> --rut <rut>volverEmisorDteAlPortalMipyme
Listar las solicitudesredcumbre emisores dte solicitudes <id>listarSolicitudesCertificacionEmisorDte

consultarEstadoMipymeEmisorDte consulta al SII de verdad con el certificado del representante: no lo uses para sondear en un ciclo.

El carril de facturación es del RUT, no de la empresa. Cuando un RUT termina su certificación de facturas, sus emisores PORTAL_MIPYME pasan solos a FULL_DTE en todas las empresas que lo usan y quedan operativos. Ese cambio no avisa: no llega webhook ni correo; lo ves al consultar el emisor (tipoIntegracion: "FULL_DTE"). Desde ahí ese RUT no puede abrir un emisor PORTAL_MIPYME: la tokenización y el alta responden 409 con RUT_FACTURA_CON_CERTIFICACION_PROPIA.

volverEmisorDteAlPortalMipyme es el camino de vuelta, y sólo lo ejecutas si tu usuario lo pide expresamente. Inscribe el RUT en el Portal MiPyme ante el SII y, en todas las empresas que usan ese RUT, sus emisores FULL_DTE de producción pasan a PORTAL_MIPYME, la certificación propia de facturas (33, 34, 43, 46, 52, 56 y 61) se pierde y se anulan sus folios de facturación de producción. Volver a certificarse puede tener un costo: consúltalo con la persona. Las boletas no cambian. Exige el RUT del emisor como confirmación (confirmacionRut), una llave con rol de administración y se rechaza en el modo de prueba. Si el SII rechaza la inscripción, nada cambia.

{
"confirmacionRut": "76123456-7"
}

Resultado esperado: 200 con los emisores de tu empresa que cambiaron de carril (emisoresConvertidos.esteTenant), sólo la cuenta de los de otras empresas, cafsAnulados y tiposDescertificados. Por cada emisor de tu empresa que cambió llega emisor.actualizado con tipoIntegracion en camposModificados. Con una certificación en curso responde 409; con un RUT que no coincide, 400.

La dirección de origen de un documento sale de las sucursales del emisor. Para crear una sucursal tributaria (esTributaria: true) mandas el código del SII y el código SII de la comuna; una no tributaria, como una bodega, exige nombre:

{
"esTributaria": false,
"nombre": "Bodega central",
"direccion": "CALLE BODEGA 100",
"comuna": "13101",
"ciudad": "Santiago",
"actividadEconomica": "620100"
}

Resultado esperado: 201 con la sucursal creada. Para obtener los códigos de comuna usa los catálogos (abajo).

Cambiar el ambiente de un tipo del emisor es lo que lo lleva de certificación a producción para ese tipo de documento:

{
"tipoDte": 33,
"ambiente": "PRODUCCION"
}

Resultado esperado: 200 con el emisor actualizado. En producción pide confirmar con el identificador de la empresa (--produccion --confirmar <slug>). Sobre un emisor precargado del modo de prueba responde 409.

Cuando un descuento, un precio especial o un crédito sale de la política de tu empresa, una persona con rol de supervisor lo aprueba antes de emitir. La integración completa del flujo (el borrador pasa a AUTORIZADO o RECHAZADO) existe hoy sólo para boletas de honorarios (BHE). Para FACTURA, BOLETA, COTIZACION y NOTA_CREDITO la solicitud se crea y se resuelve, pero el estado del documento de origen lo manejas tú.

{
"tipoDocumento": "FACTURA",
"dteId": "dte_17ae8ad6ff3c4a1b9d2e",
"items": [
{
"tipo": "DESCUENTO_LINEA",
"alcance": "LINEA",
"lineaId": "linea-001",
"valorPermitido": 10,
"valorSolicitado": 25,
"unidad": "PORCENTAJE",
"motivo": "Cliente con contrato anual"
}
]
}

Resultado esperado: 201 con la solicitud en estado PENDIENTE y un expiresAt (por defecto una semana). Con el flujo no habilitado en tu empresa responde 400; en el modo de prueba está habilitado para toda empresa. Después:

  • listarSolicitudesAutorizacion (por defecto sólo las PENDIENTE; filtra con estado) y obtenerSolicitudAutorizacion leen el estado: PENDIENTE, APROBADA, RECHAZADA, PARCIAL o EXPIRADA.
  • aprobarSolicitudAutorizacion y rechazarSolicitudAutorizacion (con comentario opcional) resuelven la solicitud completa; resolverSolicitudAutorizacionPorElemento resuelve cada ítem con { itemId, aprobado, comentario }. Una solicitud que ya no está PENDIENTE o venció responde 400. Las tres exigen un rol de supervisor o FULL-API.

Datos públicos, iguales en los dos modos, que sirven para armar el cuerpo: consultarValorUf, consultarDolarObservado, consultarTasaIva, consultarTasaPpm, consultarTasaRetencionBoletaTerceros, listarImpuestosAdicionales (los códigos para codigoImpuestoAdicional de una línea), listarRegiones, listarComunas y listarComunasConRegion (para los códigos SII de comuna de las sucursales). Se llaman sin {tenantSlug}:

Ventana de terminal
redcumbre api consultarTasaIva

Resultado esperado: 200 con la tasa vigente en fracción y en porcentaje.

  • Se emitió: la respuesta es 2xx y trae data.dte con id, folio y estado: "EMITIDO". Si trae data.intentoId en cambio, todavía no: consulta el intento hasta EMITIDO.
  • Se emitió en el modo de prueba: sandbox: true y cobro.modo: "prueba". obtenerDte con el id devuelve el documento; un documento de producción, en cambio, responde 404 desde una llave de prueba.
  • El SII lo resolvió: llegó dte.emision_terminada con resultado, o verificarEstadoSiiDte devuelve un estado final. Hasta entonces el documento existe pero el SII no se ha pronunciado.
  • Le llegó al receptor: en el modo de prueba, el correo o SMS está en redcumbre bandeja. En producción, la casilla de intercambio del SII se envía siempre.
  • Una operación de administración del emisor: la respuesta trae el emisor actualizado; vuelve a leerlo con redcumbre emisores dte ver <id>.
Si vesSignificaQué haces
400 en la emisiónPayload inválido: falta el giro del receptor (salvo boletas), un precioUnitario bajo 1, demasiadas líneas para el canal del emisor, un dato de transporte faltante, una referencia o su codigoReferencia que falta en una nota, o un valor que el tipo no admiteLee el mensaje: nombra el campo. Corrige y reintenta
400 con MODO_PRUEBA_TOPE_DIARIOSuperaste el tope diario del modo de prueba (200 documentos al día, contados por servicio)Espera a las 00:00 de Chile. Lo que queda lo muestra redcumbre estado
400 con OPERACION_NO_DISPONIBLE_EN_PRUEBALa operación no tiene simulación, por ejemplo el PDF de respaldo del SIIHaz esa operación sólo en producción
403La llave no alcanza el endpoint o el servicio de DTE no está habilitado en la empresaRevisa el rol de la llave y los servicios contratados
404El emisorDteId no existe en la empresa, o es de producción y usas una llave de pruebaLístalo con redcumbre emisores dte listar
409 en la emisiónEl emisor tiene conflictos de sincronización pendientesresolverConflictosEmisorDte o desde el panel
409 en anular o reemplazar una guíaGUIA_RECHAZADA_SII, GUIA_EN_CURSO, GUIA_SIN_FOLIO, GUIA_FACTURADA, GUIA_YA_ANULADA_DISTINTA, GUIA_CON_REEMPLAZO_EN_CURSO, GUIA_NO_VIGENTE o IDEMPOTENCY_KEY_DE_LA_REEMPLAZADAEl código dice la causa; la guía no admite esa acción en su estado actual
409 con RUT_FACTURA_CON_CERTIFICACION_PROPIAEl RUT ya factura con certificación propia: no puede tener un emisor PORTAL_MIPYMEUsa su emisor FULL_DTE. Sólo si tu usuario lo pide expresamente, volverEmisorDteAlPortalMipyme
409 con EMISOR_REVOCADO_REQUIERE_TOKENIZACION o EMISOR_SUSPENDIDO_POR_MASTEREl emisor está revocado o suspendidoUna llave no lo deshace: hace falta una nueva tokenización (Emisores y tokenización)
422Sin folios CAF, o límite de crédito del cliente excedidoCon falta de folios el documento quedó guardado como borrador: consigue folios y emítelo con emitirBorradorDte; reintentar el mismo envío sólo acumula borradores
CREDENCIAL_PORTAL_RECHAZADAEl SII rechazó la credencial con que la plataforma entra al portal del emisor PORTAL_MIPYME: la emisión por ese canal está detenidaNo reintentes en bucle. El titular la corrige en el portal del SII y luego haces un solo reintentarCredencialPortalEmisorDte. Llega el evento dte.credencial_portal_rechazada, y dte.credencial_portal_restablecida al volver
5xxFalla de la API o del SIIReintenta con espera creciente y con la misma idempotencyKey, para no duplicar
El documento quedó con rechazo del SIIEl SII rechazó el documento o el sobre que lo conteníaNo reintentes el POST: corrige lo que indica el rechazo y emite uno nuevo con otra idempotencyKey (consume un folio nuevo; el del rechazado queda consumido)
Resultado incierto (timeout, corte de red)No sabes si se emitióReintenta con la misma idempotencyKey: devuelve el original si existe. Ver Emisión
  • Lo emitido en producción vale ante el SII. Lo que cuesta cada operación depende de tu plan: redcumbre tarifas <operationId> --produccion (por ejemplo emitirDte).
  • Cambia la llave. La de producción se agrega con redcumbre pasar-a-produccion, queda en keys/redcumbre-produccion.json y no se muestra ni se pega en el chat. Cada comando que escribe en producción lleva --produccion --confirmar <slug>. Ver Modo de prueba y producción.
  • Usa el emisorDteId de producción. Los emisores del modo de prueba no existen para la llave de producción, y al revés.
  • El emisor tiene que estar listo. Inscrito por tokenización, con los tipos habilitados y el ambiente de cada tipo en producción (cambiarAmbienteTipoEmisorDte), con folios (CAF) y, en PORTAL_MIPYME, con la credencial del portal vigente. Los emisores FULL_DTE y SOLO_BOLETA nacen inactivos hasta que el SII certifica cada carril (se mide en días): espera el evento emisor.certificado por cada carril.
  • Las idempotencyKey no se arrastran. Su alcance incluye el ambiente: una clave gastada probando no te devuelve el documento de prueba, emite uno de producción.
  • Las acciones de simulación no existen. simularAnulacionDte, simularAceptacionReceptorDte, simularReclamoReceptorDte y simularReparosDte responden 400 con una llave de producción; el acuse y el estado ante el SII llegan por el SII.
  • Aparecen cosas que el modo de prueba no tenía: el PDF de respaldo del SII (descargarPdfSiiDte), el XML en xmlUrl, el Libro de Guías con su cierre, el estado ante el SII de verificarEstadoSiiDte y los correos y SMS que sí salen al receptor.
  • Prueba primero sin emitir. Un borrador (saveAsDraft: true) seguido de eliminarBorradorDte valida tu cuerpo contra producción sin consumir folio ni generar un documento ante el SII.