--- title: "Obtener un documento emitido" method: POST path: "/v1/tools/notta.dte.obtener/execute" tags: ["notta"] --- # Obtener un documento emitido `POST /v1/tools/notta.dte.obtener/execute` ## Request - Base URL: `https://connect.emisso.ai/api` - URL: `https://connect.emisso.ai/api/v1/tools/notta.dte.obtener/execute` - Auth: one of: - HTTP bearer - OAuth 2 (authorization code, authorization URL `https://connect.emisso.ai/authorize`, token URL `https://connect.emisso.ai/token`, scopes: `notta:read`) Devuelve el detalle completo de un documento emitido, por su id en Notta: receptor, montos, items, referencias, correo de entrega, el estado en el SII con su glosa y el historial de transiciones. Es el seguimiento del flujo asíncrono que abre notta.dte.emitir. Para cortar una espera usa estado.terminal y nunca la igualdad con un estado concreto: un rechazo también es final. ## Headers - `X-Connect-Connection` string, required ## Request body - object - `input` NottaDteObtenerInput, required - `id` string, uuid, required: UUID del documento en Notta. Es el identificador que piden `GET /dtes/{id}`, `/pdf-url`, `/xml-url`, `/events` y `/refresh-status`. No es el folio ni el TrackID del SII. ## Response `200` La tool corrió bien. 'data' es la salida de la tool tal cual, y 'meta' trae el 'request_id' que identifica esta llamada en la bitácora. - object - `data` NottaDteObtenerOutput, required - `id` string, uuid, required: UUID del documento en Notta. Es el identificador que piden `GET /dtes/{id}`, `/pdf-url`, `/xml-url`, `/events` y `/refresh-status`. No es el folio ni el TrackID del SII. - `folio` string, required: Folio que el SII asignó desde el CAF. La numeración corre por (RUT emisor, tipo de documento, ambiente), así que el folio SOLO no identifica un documento: el mismo número existe en otro tipo y en el otro ambiente. Para ubicarlo por folio, filtra también por `tipo_dte`. - `tipo_dte` 33 | 34 | 39 | 41 | 46 | 52 | 56 | 61 | 110 | 112, required: Código SII del tipo de documento: 33 factura afecta, 34 factura exenta, 46 factura de compra, 52 guía de despacho, 56 nota de débito, 61 nota de crédito, 110/112 exportación. - `rut_emisor` string, required: RUT de la empresa que emitió, en formato `CUERPO-DV` sin puntos (`76123456-0`). - `rut_receptor` string, required: RUT del receptor del documento, en formato `CUERPO-DV` sin puntos (`76123456-0`). - `razon_social_receptor` string, nullable, required: Razón social del receptor, tal como quedó en el documento emitido. null si el documento no la trae. - `giro_receptor` string, nullable, required: Giro del receptor (``). Obligatorio en 33/34 y opcional en 52/56/61: null cuando el documento no lo declaró. - `direccion_receptor` string, nullable, required: Dirección del receptor en el documento (``). null si no se declaró. - `comuna_receptor` string, nullable, required: Comuna del receptor (``). null si no se declaró. - `monto_neto` integer, required: Monto neto afecto EN PESOS CHILENOS, siempre. 0 en un documento exento, y también en una exportación (110/112), donde el total va en `monto_exento`. - `monto_exento` integer, required: Monto exento del documento EN PESOS CHILENOS, siempre. 0 cuando no hay. En una exportación (110/112) NO es lo que declara la factura: el total exportado se registra aquí ya convertido, y el monto en su moneda viaja en `monto_moneda` con la moneda en `moneda_documento`. Vivía sólo en el DETALLE, así que cuadrar una exenta (34), o el exento de una 33 mixta, desde el listado costaba un `GET /dtes/{id}` por fila, que es el motivo por el que `monto_neto` e `iva` ya viajaban aquí. - `iva` integer, required: IVA del documento EN PESOS CHILENOS. 0 cuando no hay monto afecto (documento exento o exportación). - `monto_total` integer, required: Total EN PESOS CHILENOS, siempre. En una exportación es el equivalente al tipo de cambio del día: la cifra que declara la factura está en `monto_moneda`. - `moneda_documento` string: Sólo exportación: glosa del catálogo del SII ("DOLAR USA"). - `monto_moneda` number: Sólo exportación: el total EN esa moneda, hasta 4 decimales. - `tipo_cambio` number, nullable: Sólo exportación: con qué tipo de cambio se obtuvo `monto_total`. Lo resuelve el SERVIDOR el día de la emisión, nunca el `tpo_cambio` que venga en el body. - `tipo_cambio_fuente` string, nullable: Sólo exportación: de dónde salió ese tipo de cambio, para poder auditarlo. - `sii_env` 'cert' | 'prod', required: Ambiente al que pertenece ESTE documento: `cert` (maullin, documento de prueba sin valor tributario) o `prod` (palena). Es del documento y no de la empresa: una organización ya autorizada en producción sigue teniendo documentos de certificación, y cada ambiente lleva su propia secuencia de folios. - `sii_status` 'queued' | 'sending' | 'awaiting_sii' | 'SOK' | 'CRT' | 'FOK' | 'PDR' | 'PRD' | '-11' | 'EPR' | 'RPR' | 'aceptado_con_reparos' | 'RFR' | 'RCT' | 'RSC' | 'RCH' | 'stuck' | 'signed' | 'accepted' | 'sin_permiso_sii', required: Vocabulario de `dtes.sii_status`, generado del catálogo de estados. Cada valor con su glosa, si tiene VEREDICTO del SII (`terminal`) y la acción sugerida. La descripción larga de cada uno viaja en el bloque `estado` de esta misma respuesta: `queued`: en cola · terminal: no · acción: `esperar` `sending`: enviando · terminal: no · acción: `esperar` `signed`: firmado, sin subir al SII · terminal: no · acción: `esperar` `awaiting_sii`: esperando al SII · terminal: no · acción: `esperar` · DEPRECADO `SOK`: schema del envío validado · terminal: no · acción: `esperar` `CRT`: carátula del envío validada · terminal: no · acción: `esperar` `FOK`: firma del envío validada · terminal: no · acción: `esperar` `PDR`: envío en proceso · terminal: no · acción: `esperar` `PRD`: envío en proceso · terminal: no · acción: `esperar` `-11`: procesando en el SII · terminal: no · acción: `esperar` `EPR`: aceptado · terminal: sí · acción: `ninguna` `RPR`: aceptado con reparos · terminal: sí · acción: `ninguna` `aceptado_con_reparos`: aceptado con reparos · terminal: sí · acción: `ninguna` · DEPRECADO `accepted`: aceptado (importado del Respaldo del SII) · terminal: sí · acción: `ninguna` `RFR`: rechazo por firma · terminal: sí · acción: `contactar_soporte` `RCT`: rechazo por carátula · terminal: sí · acción: `contactar_soporte` `RSC`: rechazo por schema · terminal: sí · acción: `contactar_soporte` `RCH`: documento rechazado · terminal: sí · acción: `reemitir` `stuck`: atascado en SII · terminal: no · acción: `reintentar_consulta` `sin_permiso_sii`: sin permiso para consultar en el SII · terminal: no · acción: `accion_en_sii` Corta cualquier bucle de espera por `estado.terminal`, NUNCA por `sii_status === "EPR"`: un rechazo (`RFR`, `RCT`, `RSC` y `RCH`) también es final, y ese bucle no saldría nunca. `stuck` y `sin_permiso_sii` no son terminales (el SII no llegó a juzgar el documento) pero tampoco avanzan solos: los destraba `POST /dtes/{id}/refresh-status`. - `estado` object, required: La clasificación de `sii_status`, publicada. `sii_status` NO cambia y NO se reemplaza: el código crudo sigue siendo el contrato y este bloque lo AGREGA. Sirve para decidir sin adivinar: `terminal` corta los bucles de espera, `accion` dice qué hacer, y un código que el catálogo no conoce igual cae en una casilla accionable. - `code` string, required: El mismo valor que `sii_status`, repetido aquí para que el bloque se explique solo. NO es un enum cerrado a propósito: el SII no publica una lista cerrada de códigos. Su instructivo termina la tabla con «Otros (no enumerados)», y Notta guarda verbatim lo que responde, así que puede traer uno que el catálogo no conozca (en producción ya aparecieron `106` y `107`). Un código desconocido llega clasificado como NO terminal, `en_proceso` y `contactar_soporte`, nunca como éxito. - `label` string, required: Glosa corta en español, para mostrar. AGREGA información al código, no lo reemplaza. - `descripcion` string, required: Qué pasó y qué significa, en prosa. Está para que no haya que inferir la causa: un `-11` es el código con que FALLA la consulta de estado mientras el SII todavía no registra el envío recién subido, no un estado del documento, y es el camino normal. - `terminal` boolean, required: `true` ⇒ el SII ya dio su veredicto y volver a preguntar no puede devolver otra cosa. Es la CONDICIÓN DE CORTE de cualquier bucle de espera: cortar por `sii_status === "EPR"` deja el bucle vivo para siempre ante un rechazo. `stuck` y `sin_permiso_sii` son `false` a propósito (no hay veredicto), pero tampoco avanzan solos: mira `accion`. - `poll_activo` boolean, required: `true` ⇒ Notta tiene un poll durable consultando al SII por este documento ahora mismo; no hay nada que hacer más que volver a leer. `false` junto con `terminal: false` significa que nadie está mirando este documento: ahí `accion` dice qué lo destraba. - `categoria` 'en_proceso' | 'aceptado' | 'rechazado' | 'requiere_accion' | 'archivistico', required: Cómo terminó, o por qué no terminó: `en_proceso`: el SII todavía no dio veredicto; `aceptado`: veredicto favorable: el documento vale; `rechazado`: veredicto desfavorable: el SII no aceptó el documento; `requiere_accion`: no hay veredicto y no lo va a haber sin que alguien haga algo; `archivistico`: el SII ya lo aceptó en su momento; no hay envío que consultar. - `accion` 'esperar' | 'reintentar_consulta' | 'reemitir' | 'contactar_soporte' | 'accion_en_sii' | 'ninguna', required: Qué hacer, en un enum ESTABLE pensado para que un agente ramifique sin leer la prosa, el equivalente de `next_action` en el contrato de errores: `esperar`: el poll converge solo; vuelve a leer más tarde; `reintentar_consulta`: `POST /dtes/{id}/refresh-status` destraba el caso; `reemitir`: el folio quedó quemado; emite uno nuevo corregido (nunca una Nota de Crédito: un documento rechazado no fue aceptado y no hay nada que anular); `contactar_soporte`: el dueño del problema es Notta; el emisor no puede corregirlo solo; `accion_en_sii`: el emisor tiene que hacer algo en el portal del SII; `ninguna`: terminal favorable: no hay nada que hacer. - `sii_glosa` string, nullable, required: Glosa con que el SII explica `sii_status`, en sus palabras. null mientras no haya respuesta del Servicio. Es texto para leer, no un código: lo estable es `sii_status`. - `track_id` string, nullable, required: TrackID que devolvió el SII al recibir el envío. Sirve para rastrear ESE envío en el portal del Servicio; no identifica el documento en esta API (para eso está `id`). null hasta que el DTE se sube. - `sii_last_polled` string, nullable, required: Última ESCRITURA de estado (no sólo consultas al SII: también las transiciones de la emisión). null si nunca se escribió. - `forma_pago` 1 | 2 | 3, nullable, required: Forma de pago que se declaró al emitir (``): 1 contado, 2 crédito, 3 sin costo. Es el campo que necesitas para volver a emitir un documento a partir de otro, porque `POST /dtes` lo exige en 33/34/46. `null` significa que ESTE documento no la declara, y hay dos motivos: el tipo no la lleva (guía 52, notas 56/61, exportación) o el documento se importó del Respaldo del SII, donde lo emitió otro sistema. `null` NO es contado: no lo colapses a un número ni asumas un default. - `fecha_emision` string, required: `FchEmis` del documento: fecha calendario chilena `YYYY-MM-DD`. Es la fecha TRIBUTARIA, la que decide el período del IVA, no el instante en que se creó el registro (ese es `created_at`, y puede caer en otro día). - `created_at` string, required: Instante ISO-8601 en que Notta registró el documento. - `receptor_estado` 'reclamado' | 'aceptado' | 'en_plazo' | 'aceptado_tacito' | 'sin_info', required: Qué hizo TU CLIENTE con el documento. NO es `sii_status`: el SII puede haberlo aceptado (`EPR`) y el receptor reclamarlo igual: son dos máquinas de estado distintas. Se decide en este orden, el mismo que aplica el servidor: (1) `reclamado`: el receptor lo reclamó ante el SII; es un HECHO registrado y es IRREVERSIBLE: no existe forma de deshacerlo por esta API ni por el portal, y la salida comercial es emitir una nota de crédito. (2) `aceptado`: el receptor otorgó recibo, o el SII informó que el plazo se cumplió sin reclamo; también es un hecho registrado. (3) `en_plazo`: todavía corre la ventana, y cierra en el instante que indica `plazo_reclamo_cierra`. (4) `aceptado_tacito`: esa ventana ya cerró sin reclamo (Ley 19.983). (5) `sin_info`: el SII aún no informó `fecha_recepcion_sii`, así que el plazo no empezó a correr y no se sabe nada del receptor; NO significa que no haya respondido. Los tres últimos se DERIVAN contra el instante del request y cambian solos con el reloj: no los caches. - `receptor_reclamado_at` string, nullable, required: `YYYY-MM-DD` del reclamo, tal como lo informa el registro del SII. `null` = no hay reclamo registrado, o el reclamo llegó sólo como código y sin su fecha (mira `receptor_estado`, que es el campo que decide). Un `null` aquí nunca significa por sí solo que el cliente no haya reclamado. - `receptor_acuse_at` string, nullable, required: `YYYY-MM-DD` del acuse de recibo del receptor. `null` = no lo otorgó, o llegó sin fecha. Igual que su hermano, no es el campo con el que se decide: ése es `receptor_estado`. - `fecha_recepcion_sii` string, nullable, required: Instante ISO-8601 (con hora) en que el SII recibió el documento y lo dejó a disposición del receptor. Es el ANCLA del plazo de reclamo: `fecha_emision` NO lo ancla, y contar desde ahí ya fechó un vencimiento cuatro días antes de tiempo. `null` = el SII todavía no lo informó (por eso el plazo no corre y `receptor_estado` vale `sin_info`); se puebla solo cuando el registro del SII lo entrega. - `plazo_reclamo_cierra` string, nullable, required: Instante ISO-8601 EXACTO en que el receptor pierde el derecho a reclamar: `fecha_recepcion_sii` + 192 horas (Ley 19.983, Art. 3). Es una HORA, no un día de calendario: el SII cuenta fecha-hora a fecha-hora y a partir de ese instante rechaza el reclamo, así que tratar el día entero como disponible le regala al receptor horas que ya no tiene. `null` cuando no hay ancla (`fecha_recepcion_sii` en `null`): sin fecha de recepción no hay plazo que calcular, y una fecha derivada de `fecha_emision` sería sencillamente errónea. Este plazo corre contra el RECEPTOR; al emisor no le abre ninguna ventana ni le exige ninguna acción. - `items` object[], required: Líneas del documento, en el orden en que se emitieron. - `position` integer, required: Orden de la línea dentro del documento (``), partiendo en 1. - `nombre` string, required: Nombre del ítem (``), hasta 80 caracteres. - `descripcion` string, nullable, required: Descripción larga del ítem (``). null si el documento no la trae. - `cantidad` number, nullable, required: Cantidad (SII QtyItem). null si el documento NO la declara: el XSD la permite ausente (una NC con CodRef=2, o un documento importado del respaldo del SII). null NO significa cero. - `unidad` string, nullable, required: Unidad de medida (SII UnmdItem); null si no se declaró - `descuento_pct` number, nullable, required: Descuento por línea (SII DescuentoPct, %); null si no aplica - `codigos` object[], nullable, required: Códigos de ítem (SII CdgItem: {tipo→TpoCodigo, valor→VlrCodigo}, hasta 5); null si no aplica - `tipo` string, required: Tipo del código (``), por ejemplo `INT1` o `EAN`. - `valor` string, required: Valor del código (``). - `precio_unitario` number, nullable, required: Precio unitario (SII PrcItem). null si el documento no lo declara; no es cero. - `monto_item` integer, required: Total de la línea EN PESOS CHILENOS, con su descuento ya aplicado. En una exportación es el equivalente en pesos, no la cifra que imprime la factura. - `exento` boolean, required: `true` si la línea va sin IVA. Un documento afecto (33) puede llevar líneas exentas y afectas a la vez. - `status_history` object[], required: Historia cronológica de transiciones de estado del documento. Es el mismo rastro que sirve `GET /dtes/{id}/events`, sin la glosa: úsalo para ver por dónde pasó (p. ej. `-11 → EPR`) sin un request más. - `status` 'queued' | 'sending' | 'awaiting_sii' | 'SOK' | 'CRT' | 'FOK' | 'PDR' | 'PRD' | '-11' | 'EPR' | 'RPR' | 'aceptado_con_reparos' | 'RFR' | 'RCT' | 'RSC' | 'RCH' | 'stuck' | 'signed' | 'accepted' | 'sin_permiso_sii', required: Vocabulario de `dtes.sii_status`, generado del catálogo de estados. Cada valor con su glosa, si tiene VEREDICTO del SII (`terminal`) y la acción sugerida. La descripción larga de cada uno viaja en el bloque `estado` de esta misma respuesta: `queued`: en cola · terminal: no · acción: `esperar` `sending`: enviando · terminal: no · acción: `esperar` `signed`: firmado, sin subir al SII · terminal: no · acción: `esperar` `awaiting_sii`: esperando al SII · terminal: no · acción: `esperar` · DEPRECADO `SOK`: schema del envío validado · terminal: no · acción: `esperar` `CRT`: carátula del envío validada · terminal: no · acción: `esperar` `FOK`: firma del envío validada · terminal: no · acción: `esperar` `PDR`: envío en proceso · terminal: no · acción: `esperar` `PRD`: envío en proceso · terminal: no · acción: `esperar` `-11`: procesando en el SII · terminal: no · acción: `esperar` `EPR`: aceptado · terminal: sí · acción: `ninguna` `RPR`: aceptado con reparos · terminal: sí · acción: `ninguna` `aceptado_con_reparos`: aceptado con reparos · terminal: sí · acción: `ninguna` · DEPRECADO `accepted`: aceptado (importado del Respaldo del SII) · terminal: sí · acción: `ninguna` `RFR`: rechazo por firma · terminal: sí · acción: `contactar_soporte` `RCT`: rechazo por carátula · terminal: sí · acción: `contactar_soporte` `RSC`: rechazo por schema · terminal: sí · acción: `contactar_soporte` `RCH`: documento rechazado · terminal: sí · acción: `reemitir` `stuck`: atascado en SII · terminal: no · acción: `reintentar_consulta` `sin_permiso_sii`: sin permiso para consultar en el SII · terminal: no · acción: `accion_en_sii` Corta cualquier bucle de espera por `estado.terminal`, NUNCA por `sii_status === "EPR"`: un rechazo (`RFR`, `RCT`, `RSC` y `RCH`) también es final, y ese bucle no saldría nunca. `stuck` y `sin_permiso_sii` no son terminales (el SII no llegó a juzgar el documento) pero tampoco avanzan solos: los destraba `POST /dtes/{id}/refresh-status`. - `at` string, required: ISO-8601 del momento observado - `source` 'local' | 'sii', required: Origen: transición local del pipeline o estado reportado por el SII - `references` object[], required: `` del documento: correctivas (NC/ND) y comerciales (orden de compra…). Un documento sin referencias trae `[]`, nunca `null`. - `line_num` integer, required: `` del XML: identidad de la línea dentro del documento. Admite saltos. - `tipo_doc_ref` union, required: Código SII del documento referenciado (correctiva) o el string original (comercial). - number - string - `folio_ref` union, required: Folio del documento referenciado. Número en una referencia correctiva (la NC o ND sobre un DTE) y puede venir como texto en una comercial, donde el identificador es el del documento de origen (una orden de compra, un contrato). - number - string - `fecha_ref` string, required: ``: fecha del documento REFERENCIADO, no la de éste. Desambigua cuando el mismo (tipo, folio) existe en más de un período: el folio se reinicia por emisor y por ambiente. - `cod_ref` integer, nullable, required: 1 anula · 2 corrige texto · 3 corrige montos · null = referencia comercial - `razon_ref` string, nullable, required: ``: texto libre con el motivo de la referencia. null si no se declaró. - `correo_receptor` string[], nullable, required: Direcciones del receptor capturadas en la emisión. null/vacío = no se envía. - `envio_estado` 'pendiente' | 'enviado' | 'sin_correo' | 'fallido' | 'omitido' | 'no_aplica_cert' | 'no_aplica_import', required: Estado del CORREO al receptor. NO es el estado ante el SII (ese es `sii_status`). `no_aplica_import` = el documento entró por el Respaldo del SII: lo emitió y lo entregó el sistema anterior, así que no hay envío nuestro que hacer y `POST /dtes/{id}/resend-delivery` lo rechaza. `no_aplica_cert` = en certificación, la única dirección era la casilla de intercambio del padrón, que no recibe documentos de prueba. Ninguno de los dos es un fallo. - `envio_message_id` string, nullable, required: Identificador que devolvió el proveedor de correo al aceptar el envío. Es evidencia de que el correo salió, no de que llegó. null si nunca hubo envío. - `enviado_at` string, nullable, required: Instante ISO-8601 en que salió el correo al receptor. null si todavía no salió. - `envio_destinatarios` string[], nullable, required: Registro del `to:` efectivo del envío. Sólo lectura: no son direcciones reutilizables. - `envio_casilla_intercambio` string, nullable, required: Cuál de los destinatarios la aportó la casilla de intercambio del padrón del SII. - `anulado_estado` 1 | 2, nullable, required: 1 = anulada antes de enviar al SII · 2 = después · null = guía viva (o no es un 52). - `anulado_at` string, nullable, required: Instante en que la guía quedó marcada como anulada. null si no lo está. - `anulado_motivo` string, nullable, required: Motivo que se registró al anular la guía. null si no está anulada. - `links` object, required: Rutas relativas bajo `/api/v1` para operar sobre este documento. - `self` string, required: Ruta de este documento: `GET /api/v1/dtes/{id}`. - `pdf` string, required: Descarga directa del PDF (`GET /api/v1/dtes/{id}/pdf`): responde el archivo. Si prefieres una URL firmada de vida corta para pasársela a otro sistema, usa `GET /dtes/{id}/pdf-url`. - `xml` string, required: Descarga directa del XML firmado. La alternativa con URL firmada es `GET /dtes/{id}/xml-url`. - `events` string, required: Historial de estados: `GET /api/v1/dtes/{id}/events`. - `meta` ResponseMeta - `request_id` string, required: Identificador que el servidor le da a esta llamada (req_…). Correlaciona con la fila de la bitácora y es lo primero que pide soporte: guárdalo en tus logs. - `operation_request_id` string, uuid: Identidad del intento e-Boleta original. Se conserva al reproducir el resultado del journal; request_id identifica la llamada actual. - `tool_id` string, required: La tool que se ejecutó, con su id punteado. - `plane` 'action' | 'read', required: 'read' = la llamada escribió en el plano persistido (un sync). 'action' = efímera, no persistió nada de negocio: actuar afuera, o leer lo que un sync ya dejó. - `latency_ms` integer, required: Cuánto tardó la ejecución, en milisegundos. - `audit_status` 'recorded' | 'degraded', required: 'recorded' = la bitácora recibió la fila de esta llamada. 'degraded' = la acción se hizo pero el registro cayó a un respaldo duradero. Nunca convierte una acción exitosa en un error, porque reintentar por eso sería pagar o emitir dos veces. - `idempotency` 'replayed': Presente solo cuando una tool destructiva devolvió la respuesta guardada de un intento previo con la misma Idempotency-Key. Significa que en ESTA llamada no ocurrió ningún efecto nuevo. ## Other responses - `400`: validation_error (400) - `401`: unauthorized (401) - `403`: scope_not_granted | connection_scope_not_enabled | alcance_not_enabled - `404`: tool_not_found (404) - `409`: connection_ambiguous | connection_busy - `428`: connection_credential_required (428) - `500`: internal_error (500) --- [API](https://skmtc.dev/emisso/apis/emisso-connect-api.md) · [All operations](https://skmtc.dev/emisso/apis/emisso-connect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emisso/apis/emisso-connect-api/revisions/e766c01ef2a0?raw)