Obtener un documento emitido
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.
API key de la organización, en 'Authorization: Bearer connect_sk_…'. Es la credencial para tu backend y tus agentes propios; se crea en el dashboard con permisos explícitos y su valor completo se muestra una sola vez. Autentica como agente: la bitácora atribuye la acción a la clave, nunca a la persona que la creó.
In: header
Header Parameters
Cuál conexión (conn_…) ejecuta esta llamada. Obligatoria en todo sistema conectable y sin resolución implícita, ni siquiera cuando la organización tiene una sola conexión activa: la conexión ES la empresa, y elegir por ti una que hoy acierta mañana acierta distinto sin que nadie cambie nada. Los ids salen de la tool 'conexiones.estado.consultar'. Si falta, la respuesta es 'validation_error' y no se contacta al sistema externo.
^conn_Request Body
application/json
La entrada de la tool, envuelta en 'input'. Manda '{"input": {}}' cuando la tool no toma argumentos: el sobre es obligatorio aunque esté vacío.
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/tools/notta.dte.obtener/execute" \ -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \ -H "Content-Type: application/json" \ -d '{ "input": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08" } }'{ "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "folio": "string", "tipo_dte": 33, "rut_emisor": "string", "rut_receptor": "string", "razon_social_receptor": "string", "giro_receptor": "string", "direccion_receptor": "string", "comuna_receptor": "string", "monto_neto": -9007199254740991, "monto_exento": -9007199254740991, "iva": -9007199254740991, "monto_total": -9007199254740991, "moneda_documento": "string", "monto_moneda": 0, "tipo_cambio": 0, "tipo_cambio_fuente": "string", "sii_env": "cert", "sii_status": "queued", "estado": { "code": "string", "label": "string", "descripcion": "string", "terminal": true, "poll_activo": true, "categoria": "en_proceso", "accion": "esperar" }, "sii_glosa": "string", "track_id": "string", "sii_last_polled": "string", "fecha_emision": "string", "created_at": "string", "receptor_estado": "reclamado", "receptor_reclamado_at": "string", "receptor_acuse_at": "string", "fecha_recepcion_sii": "string", "plazo_reclamo_cierra": "string", "items": [ { "position": -9007199254740991, "nombre": "string", "descripcion": "string", "cantidad": 0, "unidad": "string", "descuento_pct": 0, "codigos": [ { "tipo": "string", "valor": "string" } ], "precio_unitario": 0, "monto_item": -9007199254740991, "exento": true } ], "status_history": [ { "status": "queued", "at": "string", "source": "local" } ], "references": [ { "line_num": 1, "tipo_doc_ref": 0, "folio_ref": 0, "fecha_ref": "string", "cod_ref": -9007199254740991, "razon_ref": "string" } ], "correo_receptor": [ "string" ], "envio_estado": "pendiente", "envio_message_id": "string", "enviado_at": "string", "envio_destinatarios": [ "string" ], "envio_casilla_intercambio": "string", "anulado_estado": 1, "anulado_at": "string", "anulado_motivo": "string", "links": { "self": "string", "pdf": "string", "xml": "string", "events": "string" } }, "meta": { "request_id": "string", "tool_id": "string", "plane": "action", "latency_ms": 0, "audit_status": "recorded", "idempotency": "replayed" }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}Listar los documentos emitidos POST
Lista los documentos que esta empresa emitió a través de Notta, con filtros por tipo de documento, folio, RUT del receptor, rango de fechas de emisión, estado en el SII y estado del receptor, y paginación por cursor. Cada fila trae folio, montos, el estado en el SII y los enlaces del documento. Para el detalle completo de uno, con sus items y su historial, usa notta.dte.obtener. También sirve como red antes de reintentar una emisión que falló por transporte o timeout: si el documento ya aparece, no lo vuelvas a emitir.
Reenviar un documento por correo POST
Reenvía el PDF y el XML de un documento ya emitido a la dirección que el receptor tiene registrada en Notta. No emite ni modifica el documento, y NO admite indicar otra dirección: si el receptor no tiene ninguna registrada, la llamada falla y hay que registrarla en app.notta.cl. Es el camino conversacional para entregar un documento, frente a los enlaces de notta.dte.enlace_pdf y notta.dte.enlace_xml.