Anular o corregir un documento emitido
Anula una factura afecta 33 o exenta 34, o una boleta 39 o 41, con su nota de crédito 61 de anulación, rebaja los montos de una factura 33 con una nota de crédito 61, o corrige los montos de una factura exenta 34 con una nota de débito 56 o de crédito 61, por REST o MCP. Qué hacer con cada documento y error.
Un documento emitido no se edita: se anula o se corrige con otro documento, una nota de crédito o de débito que lo referencia. Busca tu caso:
| Si emitiste… | y quieres… | Qué hacer |
|---|---|---|
| Factura 33 o 34 | anularla completa | Nota de crédito 61 de anulación, con sii.anulacion.* |
| Boleta 39 o 41 emitida por Emisso | anularla | Nota de crédito 61 de anulación, con sii.anulacion.* |
| Factura 34 | subir o bajar sus montos | Nota de débito 56 o de crédito 61, con sii.dte.* |
| Factura 33 | rebajar parte de sus montos | Nota de crédito 61 que corrige montos, con sii.anulacion.* y correccion |
| Factura 33 | subir sus montos | Todavía no se puede por Emisso: hazlo en el portal del SII |
| Factura 33 o 34 | corregir texto (razón social, giro, dirección) | Todavía no se puede por Emisso: hazlo en el portal del SII |
| Guía de despacho 52 | anularla | No lleva nota: se registra como anulada en el Libro de Guías |
En la anulación, solo indicas el documento original y recibes una nota de crédito por su total. En la corrección de montos de una factura 33, indicas la factura, la razón y las líneas a descontar; el receptor y la referencia salen de la factura. En la de una factura 34, envías los datos y las líneas de la nota; sigue el mismo flujo de una factura.
Anular una factura
Anular una factura es emitir su nota de crédito 61 de anulación. La nota conserva las líneas, el neto, el IVA y el total de la factura original, y lleva la referencia que la anula. Tu integración solo indica cuál factura: tipo, folio y fecha de emisión. No envíes líneas ni montos. La nota de una factura exenta 34 va sin IVA, como la factura: mira Anular una factura exenta 34.
Los requisitos son los mismos de la emisión, con el mismo permiso
sii:write, y el flujo también son dos llamadas: sii.anulacion.previsualizar y sii.anulacion.emitir.
Anular no tiene vuelta atrás
En el SII firmar es emitir: la nota se envía en el mismo acto y la factura queda anulada. Revisa la preparación antes de emitir.
También puedes anular una boleta afecta 39 o exenta 41 que Emisso emitió: mira Anular una boleta.
Qué facturas se pueden anular
- Facturas afectas 33 y exentas 34.
- Emitidas con el Facturador Gratuito del SII, desde Emisso o desde sii.cl. Si la factura fue emitida
con otro sistema, la preparación responde
sii_anulacion_documento_no_encontrado. - Completas. La nota anula la factura entera. Para rebajar solo parte de sus montos, mira Corregir montos de una factura 33.
Una guía de despacho 52 no se anula con nota de crédito: mira Si una guía salió mal.
1. Prepara la anulación
curl -X POST https://connect.emisso.ai/api/v1/tools/sii.anulacion.previsualizar/execute \
-H "Authorization: Bearer connect_sk_…" \
-H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
-H "Content-Type: application/json" \
-d '{"input": {"documento": {"tipoDte": "33", "folio": "1042", "fechaEmision": "2026-09-15"}}}'Salida esperada (200, campo data):
{
"anulacion": {
"tipoDte": "61",
"operacion": "anula",
"referencia": { "tipoDte": "33", "folio": "1042", "fechaEmision": "2026-09-15" },
"totales": { "neto": 548000, "iva": 104120, "total": 652120 }
},
"previewRef": "<referencia opaca>",
"expiraEn": "2026-09-15T14:20:00.000Z",
"advertencias": []
}referencia y totales corresponden a la factura original. Comprueba que sea la que quieres anular
antes de emitir. Como en la emisión, el previewRef vence en 15 minutos y lo emite el mismo actor que lo
preparó. Mide cientos de caracteres: guárdalo completo, sin recortar.
Si preparas la anulación en los segundos siguientes a emitir la factura, el portal puede todavía no ofrecerla. Espera alrededor de un minuto y vuelve a preparar.
2. Emite la nota de anulación
curl -X POST https://connect.emisso.ai/api/v1/tools/sii.anulacion.emitir/execute \
-H "Authorization: Bearer connect_sk_…" \
-H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
-H "Idempotency-Key: 8b1e4f7a-2c9d-4e36-a5b0-6d3f9c1e7a24" \
-H "Content-Type: application/json" \
-d '{"input": {"previewRef": "<referencia opaca>"}}'Salida esperada (200, campo data):
{
"resultado": {
"estado": "emitida",
"tipoDte": "61",
"puedeReintentar": false,
"operacionId": "req_p3n8x2c6v1b9m4k7w0q5z",
"folio": "87",
"fechaEmision": "2026-09-15",
"confirmadoEn": "2026-09-15T14:08:41.000Z",
"xmlFirmado": "<DTE version=\"1.0\">…<TED version=\"1.0\">…</TED>…</DTE>"
}
}El folio es el de la nota de crédito, no el de la factura. Los estados de la anulación van en femenino:
emitida: el SII confirmó la emisión de la nota. La factura quedó anulada. TraexmlFirmado, el XML de la nota con su timbre; después lo entregasii.dte_xml.consultarcon el mismooperacionId.rechazada: la nota no llegó a enviarse. La factura sigue vigente y puedes preparar la anulación de nuevo.resultado_desconocido: todavía no hay evidencia para afirmar una cosa ni la otra. No prepares otra anulación: sigue Resultados y errores.
Por MCP
La preparación va por execute:
{
"tool": "sii.anulacion.previsualizar",
"connectionId": "conn_9tKfR2mQx4Vb",
"params": { "documento": { "tipoDte": "33", "folio": "1042", "fechaEmision": "2026-09-15" } }
}La emisión va por execute_write, con la clave de idempotencia fuera de params:
{
"tool": "sii.anulacion.emitir",
"connectionId": "conn_9tKfR2mQx4Vb",
"idempotencyKey": "8b1e4f7a-2c9d-4e36-a5b0-6d3f9c1e7a24",
"params": { "previewRef": "<referencia opaca>" }
}Qué revisa Emisso antes de firmar
La nota debe anular únicamente la factura indicada y coincidir con la vista previa. Si los datos cambian, Emisso se detiene antes de firmar y la factura sigue vigente. Prepara una vista previa nueva y revísala antes de emitir.
La nota puede conservar las referencias informativas de la factura, como una orden de compra, después de la referencia de anulación. Ninguna puede modificar otro documento.
Anular una factura exenta 34
El flujo y las dos llamadas son los mismos; cambia el tipoDte:
{ "documento": { "tipoDte": "34", "folio": "318", "fechaEmision": "2026-09-02" } }La nota va sin IVA: todo el total es exento y la preparación lo devuelve en totales.exento, con neto e IVA en
cero.
{
"anulacion": {
"tipoDte": "61",
"operacion": "anula",
"referencia": { "tipoDte": "34", "folio": "318", "fechaEmision": "2026-09-02" },
"totales": { "neto": 0, "iva": 0, "exento": 250000, "total": 250000 }
},
"previewRef": "<referencia opaca>",
"expiraEn": "2026-09-15T14:20:00.000Z",
"advertencias": []
}Una factura afecta y una exenta pueden tener el mismo folio, porque cada tipo lleva su propia numeración: el
tipoDte decide cuál se anula. Para rebajar solo parte de los montos de una 34, mira
Corregir montos de una factura exenta 34.
Anular una boleta
El flujo y las dos llamadas son los mismos; cambia el tipoDte:
{ "documento": { "tipoDte": "39", "folio": "123", "fechaEmision": "2026-09-21" } }Para una boleta exenta, "tipoDte": "41".
- La nota sale por el Facturador Gratuito, no por E-Boleta. Por eso pide lo mismo que anular una factura:
la empresa inscrita en ese portal, la conexión habilitada para emitir y el permiso
sii:write.sii:boletas:writeno lo sustituye. - Boletas afectas 39 y exentas 41 emitidas por Emisso en la misma conexión. La fecha es el día en que Emisso la
envió al SII, la misma que muestra el libro de boletas. Una boleta emitida desde el portal del SII o con otro
sistema no está en lo que Emisso emitió, y la preparación responde
sii_anulacion_documento_no_encontrado. - La nota usa los datos de la boleta. Lleva una línea por el total, la referencia a la boleta (tipo, folio y fecha) con el código que anula, y su receptor. Si la boleta no tenía receptor, la nota va a la propia empresa: el SII no acepta el consumidor final genérico (66.666.666-6) como receptor de una nota. Los demás datos del receptor (razón social, dirección y giro) los completa el SII desde su registro.
- En una boleta exenta la nota va sin IVA: todo el total es exento y la preparación lo devuelve en
totales.exento, con neto e IVA en cero. Cualquier total se puede anular. - En una boleta afecta, neto e IVA los calcula el portal a partir del neto: IVA = neto × 19 %, redondeado. Emisso propone el
neto que, con ese IVA, suma exactamente el total de la boleta. En alrededor de uno de cada seis totales no
existe ese neto (por ejemplo, $16 o $22). En esos casos la preparación responde
sii_anulacion_no_admitida, porque cualquier nota sumaría un peso más o un peso menos que la boleta.
Antes de firmar, Emisso comprueba además que la vista previa del SII tenga el total de la boleta, su fecha y el receptor elegido.
Corregir montos de una factura 33
Una nota de crédito 61 rebaja parte de los montos de una factura afecta 33: un descuento posterior, un precio
mal cobrado o unidades devueltas. Usa las mismas dos llamadas que la anulación, sii.anulacion.previsualizar y
sii.anulacion.emitir, con el mismo permiso sii:write. En la preparación agregas correccion:
{
"input": {
"documento": { "tipoDte": "33", "folio": "1042", "fechaEmision": "2026-09-15" },
"correccion": {
"razon": "Descuento acordado con el cliente",
"detalles": [
{ "nombre": "Descuento por volumen", "cantidad": 1, "precioUnitario": 50000 }
]
}
}
}| Campo | Qué va |
|---|---|
documento | La factura 33 que corriges: tipo, folio y fecha de emisión, como en la anulación. |
correccion.razon | Motivo de la corrección, obligatorio, hasta 90 caracteres. El SII lo escribe en la referencia de la nota. |
correccion.detalles | De una a diez líneas con lo que descuentas, no la factura corregida: nombre de hasta 25 caracteres, cantidad desde 1 con hasta dos decimales, unidad opcional de hasta 4 caracteres y precioUnitario neto en pesos enteros. |
- La referencia y el receptor salen de la factura. La nota lleva la referencia a la factura (tipo, folio y fecha) con el código que corrige montos, y el mismo receptor. No los envías.
- El SII calcula el IVA. Cada línea suma
round(cantidad × precioUnitario), el IVA es el 19 % del neto, redondeado, y el total es neto más IVA. - El total de la nota no puede superar el de la factura. Si lo supera, la preparación responde
sii_anulacion_no_admitidacon el motivocorreccion_supera_factura. Para dejar la factura sin efecto, anúlala. - Puedes corregir la misma factura más de una vez, con notas distintas. La misma corrección repetida (igual
razón y líneas) es una sola operación: mientras haya una preparada o en curso, otra igual responde
sii_anulacion_en_curso.
La preparación devuelve operacion: "corrige_montos", la razon y los totales de la nota:
{
"anulacion": {
"tipoDte": "61",
"operacion": "corrige_montos",
"razon": "Descuento acordado con el cliente",
"referencia": { "tipoDte": "33", "folio": "1042", "fechaEmision": "2026-09-15" },
"totales": { "neto": 50000, "iva": 9500, "total": 59500 }
},
"previewRef": "<referencia opaca>",
"expiraEn": "2026-09-15T14:20:00.000Z",
"advertencias": []
}La emisión es igual a la de una anulación, con el previewRef y una Idempotency-Key. Cuando el resultado es
emitida, la factura sigue vigente, rebajada en el total de la nota. Antes de firmar, Emisso comprueba que la
vista previa del SII tenga la razón, las líneas y los totales pedidos, y la referencia a la factura con el
código que corrige montos.
Corregir montos de una factura exenta 34
La nota de débito 56 aumenta y la nota de crédito 61 rebaja el monto de una factura exenta 34 ya emitida. Llevan el receptor de la factura, la referencia a ella y entre una y diez líneas con el monto de la corrección:
{
"input": {
"candidato": {
"tipoDte": "61",
"receptor": {
"rut": "77123456-9",
"razonSocial": "Comercial Los Aromos SpA",
"giro": "Venta de artículos de oficina",
"direccion": "Av. Providencia 1234, oficina 501",
"comuna": "Providencia",
"ciudad": "Santiago"
},
"operacion": "corregir_montos",
"referencia": {
"tipoDteReferido": 34,
"folio": "318",
"fecha": "2026-09-02",
"razon": "Descuento acordado con el cliente"
},
"detalles": [
{ "nombre": "Rebaja de precio", "cantidad": 1, "precioUnitario": 120000 }
]
}
}
}| Campo | Qué va |
|---|---|
tipoDte | "56" para la nota de débito o "61" para la nota de crédito. |
operacion | Siempre "corregir_montos". |
referencia.tipoDteReferido | Siempre 34: la nota solo corrige facturas exentas. |
referencia.folio | Folio de la factura 34, en texto y sin ceros a la izquierda. |
referencia.fecha | Fecha de emisión de la factura 34, en AAAA-MM-DD. |
referencia.razon | Motivo de la corrección, obligatorio, hasta 90 caracteres; se conserva literalmente. |
detalles | De una a diez líneas: nombre de hasta 80 caracteres, cantidad desde 0,01 y precioUnitario positivo, ambos con hasta dos decimales y 12 caracteres al expresarlos como decimal. Cada subtotal redondeado debe ser positivo y caber en 10 dígitos. |
La nota es exenta: la vista previa devuelve totales con exento y total, sin IVA. No admite anular ni
corregir texto, referencias globales, referencias adicionales ni notas sobre otro tipo de documento.
Envía los seis datos del receptor completos: estas notas no lo autocompletan. La ciudad admite hasta
20 caracteres y no se acepta contacto del receptor. Revisa la
guía de campos, validación y límites para todos los largos, fechas y errores
por REST o MCP. Estas son restricciones de la variante actual de Emisso, no del formato DTE en general.
Errores frecuentes de la anulación y la corrección de una factura 33
| Código | Cuándo | Qué hacer |
|---|---|---|
sii_anulacion_documento_no_encontrado | La factura no está en la lista de emitidos del Facturador Gratuito, o la boleta no la emitió Emisso en esta conexión: el folio o la fecha no calzan, o se emitió con otro sistema. | Revisa tipo, folio y fecha de emisión. Si acabas de emitir la factura, espera un minuto. |
sii_anulacion_no_admitida | El portal no deja armar la nota tal como está: el total de la boleta no se puede escribir como neto más IVA redondeado, el SII no habilita al receptor o no tiene su razón social, dirección y giro, o la corrección supera el total de la factura (correccion_supera_factura). El motivo viene en details. | En una corrección, revisa las líneas. En los demás casos no se resuelve por esta vía: anula el documento en el portal del SII. |
sii_anulacion_en_curso | Ya hay una anulación (o la misma corrección) preparada y sin resolver para esa factura, o una emisión anterior espera su reconciliación. | Emite esa preparación o espera a que venza (15 minutos) o se reconcilie antes de preparar otra. |
sii_anulacion_ya_emitida | Esa factura ya tiene una nota de anulación emitida por Emisso. | No la anules de nuevo: la nota ya está en el SII. |
sii_preview_token_expired | Pasaron más de 15 minutos desde la preparación. | Prepara la anulación de nuevo. |
sii_preview_token_invalid | La preparación ya se usó, es de otra conexión o la emite otro actor. | Prepara de nuevo con la misma clave de API con la que vas a emitir. |
Los errores comunes a toda emisión están en Resultados y errores. La referencia
completa del contrato está en sii.anulacion.previsualizar
y sii.anulacion.emitir.
Boletas 39 y 41
Emite boletas electrónicas afectas 39 y exentas 41 en E-Boleta del SII por REST o MCP, paso a paso, con el enlace oficial al PDF de cada una.
Guía de despacho 52
Emite ante el SII una guía de despacho 52 con los nueve motivos de traslado disponibles en Emisso, hasta diez líneas, referencias, solicitante, transporte, contacto del receptor y origen del traslado.