{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"eb076f81-6955-44ab-9fb6-617862562717","name":"Multi API","description":"**IMPORTANTE** los ejemplos con código de esta documentación son generados automáticamente por Postman y no representan ejemplos reales ni funcionales. Cada usuario deberá construir los códigos necesarios según su lenguaje y sistema con la documentación existente. Donde los códigos sugeridos por Postman podrían servir de guía, pero nada más.\n\n**POSTMAN WEB**: Al usar Postman en la web, compartes la IP con otros usuarios de Postman web. Por lo que tu cuenta se bloqueará. Usa la aplicación de escritorio de Postman. Así usarás tu propia IP en las consultas.\n\n# Realizando peticiones\n\nLos servicios que permiten interactuar con el SII en su gran mayoría, requieren autenticación. Se debe considerar que Multi API no realiza persistencia de los datos ni existe una configuración centralizada con RUTs, contraseñas ni firmas electrónicas. Por lo anterior, en cada consulta se debe enviar el RUT y contraseña del SII. Ambos mecanismos se envían mediante `POST`. Este es el motivo principal por el cual la mayoría de las solicitudes a la API serán con el verbo `POST`.\n\nLos parámetros que se puedan pasar a la API tienen 3 posibles ubicaciones:\n\n- **Variable en el** _**PATH**_ **del recurso consumido** parámetros que identifican un elemento en el recurso que se está consumiendo. Pueden existir casos donde cierto parámetro sea opcional, en cuyo caso se indicará en cada recurso.\n    \n- **Variable agregada a la URL** parámetros que permiten modificar el comportamiento de la consulta. Por ejemplo para cambiar el formato de la respuesta. Estos parámetros siempre serán opcionales.\n    \n- **Variable en el cuerpo de la solicitud** **`POST`** agregada como un diccionario de datos en JSON. Este tipo de variables se usará principalmente para:\n    \n    - Autenticación en SII.\n        \n    - Envío de datos para creación o modificación de datos en los recursos.\n        \n\nA menos que se especifique lo contrario, todos los cuerpos de las llamadas a la API deben ser JSON con la cabecera:\n\nPlain Text\n\n```\nContent-Type: application/json\n\n ```\n\nY de forma similar, la aplicación, a menos que se indique o soliciten los datos en un formato diferente, debe aceptar los datos en formato JSON con la cabecera:\n\nPlain Text\n\n```\nAccept: application/json\n\n ```\n\n## Uso de caché para la sesión del SII\n\nLa autenticación en el SII por defecto usa _caché_. Al ser creada la sesión, esta se mantendrá activa por 10 horas. Esto mejora el rendimiento en las consultas, entregando una respuesta más rápida.\n\nAdemás esto evita que el SII bloquee la cuenta por estar haciendo múltiples inicios de sesión en un período breve de tiempo.\n\nEn el futuro se habilitara una opción para forzar el reinicio de la sesión.\n\n# Límite de consultas\n\nMulti API tiene límites de consultas por rango de tiempo para evitar abusos que degradan nuestra capacidad de mantener un rendimiento consistente de la API.\n\nEn las cabeceras de la respuesta siempre se incluirán:\n\n- `X-RateLimit-Limit` el número máximo de solicitudes a la API que se pueden hacer en el período de tiempo.\n    \n- `X-RateLimit-Remaining` la cantidad de solicitudes que quedan disponibles en el período de tiempo vigente.\n    \n\nSi sus peticiones están siendo limitadas, el código de respuesta HTTP será 429 e incluirá el campo `message` con el mensaje _Too Many Attempts_. Además se inclurán las siguientes cabeceras:\n\n- `Retry-After` contiene el tiempo en segundos después de los que se puede volver a realizar una solicitud a la API (enviada cuando se alcanza el límite de consultas).\n    \n- `X-RateLimit-Reset` contiene la fecha y hora, en formato timestamp unix, de cuando se reiniciará el límite de solicitudes para la cuenta (enviada cuando se alcanza el límite de consultas).\n    \n\nLa cantidad de consultas que se pueden realizar por período de tiempo dependen del tipo de cuenta que se esté usando para acceder a la API.\n\n# Bloqueo de la cuenta\n\nMulti API tiene [términos y condiciones](https://www.multiapi.cl/terms) que norman el uso. En estos términos hay 2 condiciones que pueden llevar a un bloqueo de la cuenta:\n\n- Compartir IP.\n    \n- Tener muchas consultas con código de respuesta HTTP 429.\n    \n\nAmbos puntos se explican en los términos y condiciones de Multi API.\n\nCuando la cuenta es bloqueada, se entrega el código de respuesta HTTP 423 y además se incluirán las siguientes cabeceras:\n\n- `Retry-After` contiene el tiempo en segundos después de los que se puede volver a realizar una solicitud a la API.\n    \n- `X-Lock-Reset` contiene la fecha y hora, en formato timestamp unix, de cuando se reestablecerá el acceso a la API.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"3978692","team":8408670,"collectionId":"eb076f81-6955-44ab-9fb6-617862562717","publishedId":"2sB2x9kB9g","public":true,"publicUrl":"https://developers.multiapi.cl","privateUrl":"https://go.postman.co/documentation/3978692-eb076f81-6955-44ab-9fb6-617862562717","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2025-06-19T06:02:53.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[{"name":"Multi API Production","id":"169bf4c5-7eeb-422f-add8-527d40cca565","owner":"3978692","values":[{"key":"api_url","value":"https://api.multiapi.cl","enabled":true,"type":"default"},{"key":"api_key","value":"","enabled":true,"type":"default"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/07c1ec18a281d7344b2d27f4b1db5a77d8bf0d129b379d2661945bc2232dc8b1","favicon":"https://multiapi.cl/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"Multi API Production","value":"3978692-169bf4c5-7eeb-422f-add8-527d40cca565"}],"canonicalUrl":"https://developers.multiapi.cl/view/metadata/2sB2x9kB9g"}