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.
Qué resuelve
Sección titulada «Qué resuelve»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é necesitas antes
Sección titulada «Qué necesitas antes»| Qué | Detalle |
|---|---|
| Llave de la empresa | Una 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 DTE | Un 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 receptor | RUT, 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 emisor | Qué emite | Líneas de detalle como máximo | El modo que mandes |
|---|---|---|---|
PORTAL_MIPYME | Facturación, guías y notas (33, 34, 43, 46, 52, 56, 61) | 10 | Se respeta |
FULL_DTE | Facturación con firma local | 60 | Se ignora |
SOLO_BOLETA | Sólo boletas 39 y 41 | 500 | Se ignora |
API_EXTERNA | Integración a medida con un sistema externo | Lo fija ese sistema | Se 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_PARCIALpor defecto oASINCRONO) sólo cambia el comportamiento enPORTAL_MIPYME. Qué significa cada uno y cómo reintentar sin duplicar está en Emisión.
Elige el documento
Sección titulada «Elige el documento»| Quiero emitir | tipoDte | Emisor | Lo que lo distingue |
|---|---|---|---|
| Factura afecta (33) | FACTURA_AFECTA | Facturación | receptor.giro, dirección y comuna obligatorios. precioUnitario es neto. |
| Factura exenta (34) | FACTURA_EXENTA | Facturación | Sin IVA: neto y total coinciden. |
| Boleta afecta (39) | BOLETA_AFECTA | Boletas | precioUnitario es el precio final con IVA incluido, salvo que mandes montoNeto: true. |
| Boleta exenta (41) | BOLETA_EXENTA | Boletas | Sin IVA. |
| Liquidación factura (43) | LIQUIDACION_FACTURA | Facturación | Usa comisiones y tipoDocumentoLiquidar en las líneas. |
| Factura de compra (46) | FACTURA_COMPRA | Facturación | Exige facturaCompra.agenteRetenedor. El receptor es el vendedor. |
| Guía de despacho (52) | GUIA_DESPACHO | Facturación | Exige guiaDespacho.tipoTraslado y datos de transporte. |
| Nota de débito (56) | NOTA_DEBITO | Facturación | Exige referencias con codigoReferencia (sólo las notas lo llevan). |
| Nota de crédito (61) | NOTA_CREDITO | Facturación | Exige 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,precioUnitarioysubtotal. ElprecioUnitariomí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. nombreacepta hasta 255 caracteres, pero al SII viaja truncado a 80. Para un detalle largo usadescripcionExtendida, 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.nombreFantasiasó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 llevatipoDocumento(código SII numérico: 33, 52, 801 orden de compra, 802 nota de pedido, 803 contrato…),folio(texto),fechay, si quieres,razonReferencia(hasta 90 caracteres).codigoReferenciaes 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.
-
Encuentra tu emisor. Lista los emisores DTE de la empresa:
Ventana de terminal redcumbre emisores dte listarResultado esperado: una fila por emisor con
emisorId,rut,razonSocial,tipoIntegracionyestado. Usa elemisorIdde facturación (PORTAL_MIPYMEoFULL_DTE) para los tipos 33, 34, 43, 46, 52, 56 y 61, y el deSOLO_BOLETApara las boletas. En el modo de prueba,redcumbre escenariosmuestra los dos emisores precargados con sus tipos. Un emisorESPERA_CERTIFICACIONo sin tipos habilitados todavía no emite. -
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.jsonResultado esperado:
201condata.id(el id del borrador),data.estado: "BORRADOR"ysandbox: true. Sindte, 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>. -
Emite. Quita
saveAsDrafty agrega unaidempotencyKeypropia (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-4521Resultado esperado:
201consuccess: true,sandbox: truey el documento endata.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
folioy elidque 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 mismaidempotencyKey, la respuesta es el documento original conidempotent: truey el folio, el receptor y los montos de la primera emisión. -
Decide por el contenido de la respuesta, no por el
modo. Si traedata.dte, el documento existe y tiene folio. Si traedata.intentoId, quedó encolado y todavía no hay documento:Ventana de terminal redcumbre api consultarIntentoEmisionDte --param intentoId=<intentoId>Resultado esperado:
data.estadoenPENDIENTE,PROCESANDO,REINTENTANDO,EMITIDO(con eldteId) oFALLIDO.REINTENTANDOno es un desenlace: no reemitas, porque cada emisión consume un folio. Para enterarte sin consultar, suscríbete adte.emision_reintentandoydte.emision_fallida(Webhooks). -
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.
precioUnitarioes 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:
201condata.dte.folioydata.montos.montoTotal: 1190. En una boleta, la respuesta puede traerdata.tedXml(el timbre).Nota de crédito (61) que anula una factura.
referenciases obligatoria (máximo 3) y cada una exigecodigoReferencia:1anula el documento,2corrige el texto,3corrige 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:
201con el folio de la nota. La nota de débito (56) es igual, contipoDte: "NOTA_DEBITO". Una nota no puede referenciar una guía de despacho (400concode: "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:
201con 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 bloquetransporte. Dentro detransporte,fechaLlegadaes obligatoria siempre.indicadorTraslado(0 a 3) es otro dato: quién recibe el despacho. Cada línea llevaunidadMedida:{"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:
201con el folio de la guía. Si falta un dato de transporte, la respuesta es400y el mensaje nombra el campo; no se reserva folio, así que corriges y reintentas. Reglas del bloque: la guía acepta unafechaEmisionde hasta tres días después de hoy (es también la fecha de salida del traslado); sifechaLlegadaes posterior a la de emisión exigetransporte.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 contransporte.datoDesconocido, nunca el destino. Una guía sin precios exigeguiaDespacho.motivoTraslado, salvo en traslados que constituyen venta (tipos 1 y 9), donde no se permite. Una factura (33, 34, 46) que ampara un traslado llevatransporte.amparaTraslado: truey las mismas exigencias; no admite fecha de emisión futura.Liquidación factura (43). Las líneas describen lo vendido y
comisioneslo 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:
201con el folio.tipoDocumentoLiquidartoma los códigos0(sin especificar),33,34,39,48o52.Factura de compra (46). El receptor es el vendedor y
facturaCompra.agenteRetenedores62(retención de IVA 19%) o6298(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:
201con el folio. La factura exenta (34) es igual a la 33 contipoDte: "FACTURA_EXENTA"y la boleta exenta (41) igual a la 39 contipoDte: "BOLETA_EXENTA". -
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 chilenos569XXXXXXXX) ynotificarSmsDte.emailVoidysmsVoidexcluyen 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. ConenviarDtePorEmail: falsese 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:enviarArchivoDtePorEmailcon{ "email": "...", "idempotencyKey": "..." }. -
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.pdfResultado 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 declaratemplate_idcomo obligatorio en esta operación aunque su descripción lo llama opcional: pásalo. Las plantillas de un tipo las listalistarPlantillasPdfPorCodigoSii(--param codigoSii=33) y las de un documento ya emitidolistarPlantillasPdfDte; cada una trae susclavesMetadataAdicional. Al emitir, la plantilla se fija contemplateId.generarEnlacesDescargaDteentrega los enlaces públicos de descarga (pdfUrl,xmlUrl,pdfSiiUrl); en el modo de prueba el enlace exige sesión ypdfSiiUrlesnullporque 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.generarPdfDtegenera y guarda un PDF con una plantilla específica;listarArchivosDtelista los archivos del documento. -
Sigue el estado ante el SII. Un
2xxde la emisión significa que el documento se emitió; no exijasestadoSii: "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.emitidocuando el documento tiene folio, timbre y XML firmado;dte.emision_terminadacuando el SII lo resuelve (resultado:ACEPTADO,ACEPTADO_CON_REPAROSoRECHAZADO);dte.emision_sin_confirmarcuando la plataforma dejó de intentar confirmarlo sin un veredicto del SII (verifica el folio en el sitio del SII antes de reemitir);dte.emision_fallidaydte.emision_reintentandopara la emisión asíncrona. -
Consulta puntual:
Ventana de terminal redcumbre api verificarEstadoSiiDte --param id=<id>Resultado esperado:
201con elestadoSii(por ejemploDOK,DNK,EPR,PRD,RCH) y, en facturas, el historial. Si el documento todavía no se subió al SII, respondeconsultaOmitida: truecon el estado registrado, sin consultar. En el modo de prueba no consulta al SII: devuelve el estado simulado. -
Detalle:
obtenerDteyobtenerHistorialDte.listarDtelista con filtros (tipoDte,estado,receptorRut,fechaDesde,fechaHasta,folioDesde,folioHasta,emisorDteId,limit,offset); por defecto excluye borradores (estado=BORRADORpara verlos). Paginación y errores: Reglas comunes.
Cuando un documento queda en
ERROR_EMISIONdespués de consumir el folio,reintentarEmisionDtelo reintenta reutilizando el folio. Es sólo para boletas 39 y 41; sobre otro tipo o estado responde400. Las boletas enviadas al SII se consultan conlistarEnviosBoletayconsultarEnvioBoleta. -
-
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,
simularAnulacionDteanula 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 conemitirGuiaDespachoDeReemplazoo 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:
200con la anulación registrada; repetir con el mismo cuerpo devuelve lo mismo, y con otro motivo responde409(GUIA_YA_ANULADA_DISTINTA). Los motivos sonCAMBIO_ORIGEN_DESTINO,CAMBIO_CHOFER_TRANSPORTISTA,CAMBIO_PATENTE,CAMBIO_BIENES,CAMBIO_RECEPTOR,ERROR_DIGITACION,OPERACION_NO_REALIZADA,RECEPCION_PARCIALyOTRO. ConrecepcionParcial: truela guía sigue vigente y queda modificada (montoModificadosólo se acepta con esa marca). Llegan los eventosdte.guia_anuladaydte.guia_modificada. El reemplazo exige unaidempotencyKeydistinta de la de la guía que reemplaza, ymotivo; la referencia a la guía anterior la agrega la plataforma. -
Libro de Guías de Despacho:
listarLibrosGuiasDespacholista los períodos,generarLibroGuiasDespachoexhibe el libro firmado al momento ydescargarEnvioLibroGuiasDespachobaja un envío custodiado. En el modo de prueba el cierre no corre: el listado vuelve vacío.
-
-
Acuse del receptor.
obtenerDtetraeestadoAcuse(por ejemploPENDIENTE,ACEPTADO,RECLAMADO,NO_APLICA).actualizarAcuseDteencola una consulta del acuse al SII (sólo tipos 33, 34 y 43 ya emitidos) y responde201de inmediato; el resultado se lee después enobtenerDte. Llegandte.acuse_aceptadoydte.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:
200y el evento correspondiente en tu endpoint de prueba. Las cuatro simulaciones (estas tres ysimularAnulacionDte) existen sólo en el modo de prueba: con una llave de producción responden400conOPERACION_SOLO_EN_MODO_DE_PRUEBA.simularReparosDteysimularAnulacionDtesobre un documento de ejemplo precargado responden409. Para provocar un rechazo del SII simulado, emite con el receptor44444444-4.
Preparar y mantener el emisor DTE
Sección titulada «Preparar y mantener el emisor DTE»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.
| Tarea | Comando | operationId |
|---|---|---|
| Listar emisores | redcumbre emisores dte listar | listarEmisoresDte |
| Ver los emisores por defecto | redcumbre emisores dte por-defecto | listarEmisoresDtePorDefecto |
| Saber si un RUT ya es emisor | redcumbre emisores dte existe <rut> | verificarRutEmisorDte |
| Ver el detalle | redcumbre emisores dte ver <id> | obtenerEmisorDte |
| Editar correo, teléfono, giro, notas, actividades | redcumbre emisores dte editar <id> --cuerpo @emisor.json | actualizarEmisorDte |
| Fijar por defecto | redcumbre emisores dte fijar-por-defecto <id> | asignarEmisorDtePorDefecto |
| Releer del SII los datos y los tipos autorizados | redcumbre emisores dte sincronizar <id> | actualizarEmisorDteDesdeSii |
| Resolver los conflictos que dejó esa sincronización | redcumbre emisores dte resolver-conflictos <id> | resolverConflictosEmisorDte |
| Habilitar un tipo en el emisor | redcumbre emisores dte tipos-integracion crear <id> | crearTipoIntegracionEmisorDte |
| Habilitar o deshabilitar un tipo | redcumbre emisores dte tipos-integracion editar <id> <tiId> | actualizarTipoIntegracionEmisorDte |
| Cambiar el ambiente de un tipo | redcumbre emisores dte ambiente <id> --tipo-dte 33 --ambiente PRODUCCION | cambiarAmbienteTipoEmisorDte |
| Subir, ver o quitar el logo | redcumbre emisores dte logo subir|ver|quitar <id> | actualizarLogoEmisorDte, obtenerLogoEmisorDte, eliminarLogoEmisorDte |
| Guardar o quitar la información de pago del correo | redcumbre 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 reactivar | redcumbre emisores dte archivar <id> --rut <rut> · reactivar <id> | archivarEmisorDte, reactivarEmisorDte |
| Sucursales: listar, crear, editar, desactivar | redcumbre emisores sucursales listar|crear|editar|desactivar … | listarSucursalesEmisorDte, crearSucursalEmisorDte, actualizarSucursalEmisorDte, desactivarSucursalEmisorDte |
| Representantes legales de la empresa | redcumbre emisores representantes listar | listarRepresentantesLegales |
Antes de dar de alta un emisor DTE, pregúntale a tu usuario qué va a emitir. El carril lo elige él, no tú:
- ¿Va a emitir boletas? Las boletas (39 y 41) van sólo por un emisor
SOLO_BOLETA. - ¿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) oPORTAL_MIPYME(para bajo volumen, sin cargo fijo). Ninguno de los dos emite boletas, tampocoFULL_DTE. Un RUT tiene un solo carril de facturación. - 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,--boletassin--integracion. - El representante legal abre el enlace y sube ahí su certificado. Tú nunca manejas el certificado.
- El alta de un
FULL_DTEo unSOLO_BOLETAabre la solicitud de certificación sola: no la pidas otra vez. - Sigue el avance con
redcumbre emisores dte solicitudes <id>; al terminar llega el webhookemisor.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).
| Tarea | Comando | operationId |
|---|---|---|
| Qué tipos puede certificar y su estado | redcumbre emisores dte certificacion tipos|estado|verificar <id> … | listarTiposCertificablesEmisorDte, consultarEstadoCertificacionRutEmisorDte, verificarCertificacionTipoEmisorDte |
| Solicitar la certificación de tipos del carril del emisor | redcumbre emisores dte certificacion certificar-tipos <id> | crearSolicitudCertificacionTiposEmisorDte |
Migrar un emisor PORTAL_MIPYME a certificación propia | redcumbre 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 MiPyme | redcumbre emisores dte mipyme estado|habilitar <id> | consultarEstadoMipymeEmisorDte, registrarEmisorDteEnPortalMipyme |
| Volver un RUT certificado al Portal MiPyme | redcumbre emisores dte volver-a-mipyme <id> --rut <rut> | volverEmisorDteAlPortalMipyme |
| Listar las solicitudes | redcumbre 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.
Pedir una autorización a un supervisor
Sección titulada «Pedir una autorización a un supervisor»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 lasPENDIENTE; filtra conestado) yobtenerSolicitudAutorizacionleen el estado:PENDIENTE,APROBADA,RECHAZADA,PARCIALoEXPIRADA.aprobarSolicitudAutorizacionyrechazarSolicitudAutorizacion(concomentarioopcional) resuelven la solicitud completa;resolverSolicitudAutorizacionPorElementoresuelve cada ítem con{ itemId, aprobado, comentario }. Una solicitud que ya no estáPENDIENTEo venció responde400. Las tres exigen un rol de supervisor oFULL-API.
Catálogos de referencia
Sección titulada «Catálogos de referencia»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}:
redcumbre api consultarTasaIvaResultado esperado: 200 con la tasa vigente en fracción y en porcentaje.
Cómo saber que funcionó
Sección titulada «Cómo saber que funcionó»- Se emitió: la respuesta es
2xxy traedata.dteconid,folioyestado: "EMITIDO". Si traedata.intentoIden cambio, todavía no: consulta el intento hastaEMITIDO. - Se emitió en el modo de prueba:
sandbox: trueycobro.modo: "prueba".obtenerDtecon eliddevuelve el documento; un documento de producción, en cambio, responde404desde una llave de prueba. - El SII lo resolvió: llegó
dte.emision_terminadaconresultado, overificarEstadoSiiDtedevuelve 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>.
Qué puede fallar
Sección titulada «Qué puede fallar»| Si ves | Significa | Qué haces |
|---|---|---|
400 en la emisión | Payload 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 admite | Lee el mensaje: nombra el campo. Corrige y reintenta |
400 con MODO_PRUEBA_TOPE_DIARIO | Superaste 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_PRUEBA | La operación no tiene simulación, por ejemplo el PDF de respaldo del SII | Haz esa operación sólo en producción |
403 | La llave no alcanza el endpoint o el servicio de DTE no está habilitado en la empresa | Revisa el rol de la llave y los servicios contratados |
404 | El emisorDteId no existe en la empresa, o es de producción y usas una llave de prueba | Lístalo con redcumbre emisores dte listar |
409 en la emisión | El emisor tiene conflictos de sincronización pendientes | resolverConflictosEmisorDte o desde el panel |
409 en anular o reemplazar una guía | GUIA_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_REEMPLAZADA | El código dice la causa; la guía no admite esa acción en su estado actual |
409 con RUT_FACTURA_CON_CERTIFICACION_PROPIA | El RUT ya factura con certificación propia: no puede tener un emisor PORTAL_MIPYME | Usa su emisor FULL_DTE. Sólo si tu usuario lo pide expresamente, volverEmisorDteAlPortalMipyme |
409 con EMISOR_REVOCADO_REQUIERE_TOKENIZACION o EMISOR_SUSPENDIDO_POR_MASTER | El emisor está revocado o suspendido | Una llave no lo deshace: hace falta una nueva tokenización (Emisores y tokenización) |
422 | Sin folios CAF, o límite de crédito del cliente excedido | Con 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_RECHAZADA | El SII rechazó la credencial con que la plataforma entra al portal del emisor PORTAL_MIPYME: la emisión por ese canal está detenida | No 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 |
5xx | Falla de la API o del SII | Reintenta con espera creciente y con la misma idempotencyKey, para no duplicar |
| El documento quedó con rechazo del SII | El SII rechazó el documento o el sobre que lo contenía | No 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 |
Antes de pasar a producción
Sección titulada «Antes de pasar a producció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 ejemploemitirDte). - Cambia la llave. La de producción se agrega con
redcumbre pasar-a-produccion, queda enkeys/redcumbre-produccion.jsony 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
emisorDteIdde 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, enPORTAL_MIPYME, con la credencial del portal vigente. Los emisoresFULL_DTEySOLO_BOLETAnacen inactivos hasta que el SII certifica cada carril (se mide en días): espera el eventoemisor.certificadopor cada carril. - Las
idempotencyKeyno 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,simularReclamoReceptorDteysimularReparosDteresponden400con 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 enxmlUrl, el Libro de Guías con su cierre, el estado ante el SII deverificarEstadoSiiDtey los correos y SMS que sí salen al receptor. - Prueba primero sin emitir. Un borrador (
saveAsDraft: true) seguido deeliminarBorradorDtevalida tu cuerpo contra producción sin consumir folio ni generar un documento ante el SII.