# Emitir la anulación de una factura en el SII
> Firma y envía la nota de crédito de anulación preparada.
{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}
| | |
| ------------------- | ----------------------------------------------------------------- |
| **Tool ID** | `sii.anulacion.emitir` |
| **Nombre MCP** | `sii__anulacion__emitir` |
| **Conector** | `sii` |
| **Plano** | `action` |
| **Scope (permiso)** | `sii:write` |
| **Auth** | `connection_credentials` |
| **Versión** | `1` |
| **Sensible** | sí |
| **Deprecado** | no |
| **Comportamiento** | readOnly=false, destructive=true, idempotent=true, openWorld=true |
> **Requiere conexión.** Indica cuál en cada llamada: header `X-Connect-Connection` en REST, campo `connectionId` en el `execute_write` de MCP y en las opciones del SDK. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de [`conexiones.estado.consultar`](../conexiones/estado-consultar).
## Qué hace [#qué-hace]
EN EL SII FIRMAR ES EMITIR: el portal envía el documento en el mismo acto, así que no hay ensayo previo ni vuelta atrás, y la factura queda anulada. Exige previewRef vigente e Idempotency-Key explícita; cuando la llamada se autentica con la misma clave de API que creó esa preparación, la confirmación ocurre dentro de esta llamada, y cuando la hace una persona, un propietario o administrador tiene que confirmarla antes en Connect. La clave del certificado se resuelve en el servidor desde la conexión y nunca viaja en la llamada ni en el resultado. Un resultado desconocido se reconcilia contra la lista de documentos del portal; nunca autoriza reenviar. Un segundo emitir sobre el mismo previewRef NO duplica: la preparación va de pendiente a confirmada a consumida, así que el reintento falla en vez de emitir otra nota. Lo que decide la Idempotency-Key es si ese reintento recibe la respuesta guardada o un error sobre el mismo desenlace real.
## Entrada [#entrada]
| Campo | Tipo | Requerido | Descripción |
| ------------ | ------ | --------- | --------------------------------------------------------------------------------------------------------------------- |
| `previewRef` | string | sí | Referencia devuelta por sii.anulacion.previsualizar; debe estar vigente, confirmada y pertenecer a la misma conexión. |
JSON Schema de entrada
```json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"previewRef": {
"type": "string",
"minLength": 1,
"description": "Referencia devuelta por sii.anulacion.previsualizar; debe estar vigente, confirmada y pertenecer a la misma conexión."
}
},
"required": [
"previewRef"
],
"additionalProperties": false
}
```
## Salida [#salida]
| Campo | Tipo | Requerido | Descripción |
| ----------- | ----- | --------- | ------------------------------------------------- |
| `resultado` | valor | sí | Desenlace tributario allowlisted de la operación. |
JSON Schema de salida
```json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"resultado": {
"oneOf": [
{
"type": "object",
"properties": {
"tipoDte": {
"type": "string",
"const": "61",
"description": "Nota de crédito electrónica."
},
"puedeReintentar": {
"type": "boolean",
"const": false,
"description": "Siempre false: firmar en el SII envía en el mismo acto, así que nada autoriza repetirlo."
},
"estado": {
"type": "string",
"const": "emitida",
"description": "Emisión y reconciliación concluyentes."
},
"folio": {
"type": "string",
"pattern": "^[1-9][0-9]*$",
"description": "Folio de la nota de crédito, en texto y sólo con identidad concluyente."
}
},
"required": [
"tipoDte",
"puedeReintentar",
"estado",
"folio"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"tipoDte": {
"type": "string",
"const": "61",
"description": "Nota de crédito electrónica."
},
"puedeReintentar": {
"type": "boolean",
"const": false,
"description": "Siempre false: firmar en el SII envía en el mismo acto, así que nada autoriza repetirlo."
},
"estado": {
"type": "string",
"const": "rechazada",
"description": "Rechazo concluyente, sin consumo de folio."
},
"motivo": {
"type": "string",
"enum": [
"rechazo_concluyente_sin_emision"
],
"description": "Motivo seguro del rechazo confirmado."
}
},
"required": [
"tipoDte",
"puedeReintentar",
"estado",
"motivo"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"tipoDte": {
"type": "string",
"const": "61",
"description": "Nota de crédito electrónica."
},
"puedeReintentar": {
"type": "boolean",
"const": false,
"description": "Siempre false: firmar en el SII envía en el mismo acto, así que nada autoriza repetirlo."
},
"estado": {
"type": "string",
"const": "resultado_desconocido",
"description": "Evidencia insuficiente para afirmar emisión o rechazo."
},
"siguientePaso": {
"type": "string",
"const": "reconciliacion_automatica_o_soporte",
"description": "Consultar la evidencia por reconciliación o soporte; nunca reenviar."
}
},
"required": [
"tipoDte",
"puedeReintentar",
"estado",
"siguientePaso"
],
"additionalProperties": false
}
],
"description": "Desenlace tributario allowlisted de la operación."
}
},
"required": [
"resultado"
],
"additionalProperties": false
}
```
## Errores de esta tool [#errores-de-esta-tool]
| Código | HTTP | Reintentable | Qué hacer |
| -------------------------------- | ---- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `connection_disabled` | 403 | no | Reactívala en /connections o usa otra conexión del mismo sistema. |
| `connection_credential_required` | 428 | no | Crea un enlace con conexiones.enlace.crear (modo reconectar si la conexión ya existe) y pide a la persona que entregue la credencial de nuevo. No reintentes con la credencial anterior. |
| `connection_busy` | 409 | sí | Espera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez. |
| `upstream_error` | 502 | sí | Reintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración. |
| `timeout` | 504 | sí | Reintenta. Para sincronizaciones largas usa la vía asíncrona y consulta el estado del trabajo. |
Toda llamada puede devolver además los códigos transversales (`validation_error`, `unauthorized`, `scope_not_granted`, `rate_limited`, entre otros): el detalle vive en el [catálogo de errores](../errores).