--- title: "Totales facturados de un período" method: POST path: "/v1/tools/notta.dte.totales/execute" tags: ["notta"] --- # Totales facturados de un período `POST /v1/tools/notta.dte.totales/execute` ## Request - Base URL: `https://connect.emisso.ai/api` - URL: `https://connect.emisso.ai/api/v1/tools/notta.dte.totales/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 los totales de un mes, agregados por tipo de documento Y estado en el SII: cantidad, neto, exento, IVA y total. Un mismo tipo aparece en VARIAS filas cuando sus documentos están en estados distintos, así que el total de un tipo es la suma de sus filas y jamás una sola de ellas. Sin período usa el mes en curso del calendario chileno. ## Headers - `X-Connect-Connection` string, required ## Request body - object - `input` NottaDteTotalesInput, required - `periodo` string: YYYY-MM. Default: el mes actual (calendario chileno) ## 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` NottaDteTotalesOutput, required - `periodo` string, required: YYYY-MM del período agregado - `data` object[], required: Una fila por combinación de `tipo_dte` y `sii_status` del período. Nunca trae identificadores de contraparte: son conteos y montos. - `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. - `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`. - `cantidad` integer, required: Cuántos documentos cayeron en este bucket. - `monto_neto` number, required: Suma del neto afecto del bucket, EN PESOS CHILENOS. - `monto_exento` number, required: Suma del monto exento del bucket, EN PESOS CHILENOS. - `iva` number, required: Suma del IVA del bucket, EN PESOS CHILENOS. - `monto_total` number, required: Suma de los totales del bucket, EN PESOS CHILENOS. Una exportación entra por su equivalente en pesos, nunca por la cifra en su moneda. - `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)