--- title: "Consultas usando Postman" description: "" type: "academy" category: "module" tags: [] authors: [Anonymous] date: "2026-08-27" last_update: "2026-08-21" time_minutes: 9 draft: false unlisted: false url: "https://www.stage.apigateway.cl/academy/primeros-pasos/consultas-usando-postman" --- # Consultas usando Postman --- ## ¿Cómo crear una cuenta en Postman? ¿Cómo crear una cuenta en Postman? # ¿Cómo crear una cuenta en Postman? Hay que dirigirse al siguiente [enlace de Postman](https://identity.getpostman.com/login) y enlazar tu cuenta en la plataforma que se estime conveniente. ![Run in](https://www.apigateway.cl/img/content/academy/capacitacion-inicial/apigateway-orientado-a-postman/apigateway-orientado-a-postman-5.jpg){.w-25 .d-block .mx-auto .img-fluid .mb-2 .rounded-3 .shadow} ## ¿Cómo crear una colección de API GATEWAY en Postman? Para poder crear la colección de Postman debes importarla directamente desde el [archivo OpenAPI de API Gateway](https://app.apigateway.cl/schema/api/). ### Paso 1: Importar el schema OpenAPI Puedes importar el schema de dos formas: a. **Desde URL**: Copia la URL del schema (`https://app.apigateway.cl/schema/api/`) y en Postman selecciona **"Import" > "Link"** y pega la URL. Postman detectará automáticamente el archivo OpenAPI. b. **Desde archivo**: Descarga el archivo YAML y luego en Postman selecciona **"Import" > "File"** y elige el archivo descargado. A continuación se muestra un ejemplo de importación desde URL. Postman detectará automáticamente el schema una vez que pegues la URL: ![import url](https://www.apigateway.cl/img/content/academy/primeros-pasos/apigateway-orientado-a-postman/primeros-pasos-apigateway-v2-orientado-a-postman-12.jpg){style="width: 70%; display: block; margin: 0 auto;"} ### Paso 2: Configurar la importación Antes de finalizar la importación, haz clic en **"View Import Settings"**. ![folder organization tags](https://www.apigateway.cl/img/content/academy/primeros-pasos/apigateway-orientado-a-postman/primeros-pasos-apigateway-v2-orientado-a-postman-11.jpg){style="width: 70%; display: block; margin: 0 auto;"} Cambia la opción **"Folder organization"** de "Paths" a **"tags"**. Esto organizará mejor los endpoints en la colección agrupándolos por categorías. Una vez realizado el cambio, la pantalla mostrará la opción seleccionada. Finalmente, haz clic en el botón **"Import"** para completar la importación. ![select tag import](https://www.apigateway.cl/img/content/academy/primeros-pasos/apigateway-orientado-a-postman/primeros-pasos-apigateway-v2-orientado-a-postman-13.jpg){style="width: 70%; display: block; margin: 0 auto;"} > [!NOTE] Nota > >La ejecución de Postman te derivará a la última versión dependiendo tu sistema operativo. ## Configuración después de importar Importar el schema OpenAPI **no deja lista la autenticación**: cada usuario debe configurar en Postman la autorización de la colección y el valor del token **después** de importar. ### Autorización de la colección 1. Abre la **colección** importada (no una petición suelta). 2. Ve a la pestaña **Authorization**. 3. En **Type**, elige **API Key**. 4. Indica que la clave va en **Header**, con **Key** `Authorization` y **Value** `Token {{API_TOKEN}}` (la palabra `Token`, un espacio y la variable; el secreto va solo en **`API_TOKEN`**). 5. En la misma colección, abre la pestaña **Variables** y crea **`API_TOKEN`** con tu token de API Gateway (solo la clave, sin el prefijo `Token `). Si prefieres no guardar el token en variables de colección, puedes definir **`API_TOKEN`** en un **Environment** y seleccionar ese entorno en el selector superior derecho; las referencias `{{API_TOKEN}}` seguirán resolviéndose igual. > [!TIP] Importante > > **Postman:** después de importar la colección, ir a la colección → **Authorization** → **Type:** API Key → **Add to:** Header → **Key:** `Authorization` → **Value:** `Token {{API_TOKEN}}` → crear la variable **`API_TOKEN`** en la pestaña **Variables** (o en un Environment con el mismo nombre). --- ## Consultas al SII Consultas al SII: # Consultas al SII: ## Situación tributaria de contribuyentes Para encontrar la carpeta que tiene el siguiente servicio debes seguir la siguiente ruta: **API GATEWAY →Consultas al SII → Contribuyentes → `GET` Situación tributaria de contribuyentes.** ![my workspace](https://www.apigateway.cl/img/content/academy/primeros-pasos/apigateway-orientado-a-postman/primeros-pasos-apigateway-v2-orientado-a-postman-4.jpg){style="width: 70%; display: block; margin: 0 auto;"} * Situación tributaria de contribuyentes: Se deben configurar los parámetros que indica el campo, en este caso es el RUT el cual deseas consultar, se selecciona “Send”. Se mostrará en BODY los datos solicitados. ![send](https://www.apigateway.cl/img/content/academy/primeros-pasos/apigateway-orientado-a-postman/primeros-pasos-apigateway-v2-orientado-a-postman-5.jpg){style="width: 70%; display: block; margin: 0 auto;"} ## Registro de compras y ventas Para encontrar la carpeta que tiene el siguiente servicio debes seguir la siguiente ruta: **API de LibreDTE →Consultas al SII →Registro de compras y ventas → Registro de compras → `POST` Resumen de compras.** ![API SII](https://www.apigateway.cl/img/content/academy/primeros-pasos/apigateway-orientado-a-postman/primeros-pasos-apigateway-v2-orientado-a-postman-6.jpg){style="width: 70%; display: block; margin: 0 auto;"} Para consumir el servicio registro de compra y venta es necesario tener configuradas en la colección las variables de **EMPRESA_RUT o USUARIO_RUT** > [!NOTE] Nota > > Este servicio lo puede consumir toda persona autorizada para pedir el registro, es decir, puede ser tanto con RUT de empresa como también de una persona natural que esté autorizada. ## Registro de compras * Detalle de compras: Se deben definir los parámetros que se indican: * **Receptor:** RUT del receptor de los documentos. * **Período:** Período del registro. * **DTE:** Tipo de documento. * **Estado:** REGISTRO, PENDIENTE, NO_INCLUIR, RECLAMADO. Una vez definidos al seleccionar **“Send”**, en **“Body”** mostrará los detalles solicitados. ![send](https://www.apigateway.cl/img/content/academy/primeros-pasos/apigateway-orientado-a-postman/primeros-pasos-apigateway-v2-orientado-a-postman-7.jpg){style="width: 70%; display: block; margin: 0 auto;"} --- ## Contribuyentes Contribuyentes # Contribuyentes Para encontrar el servicio sigue la ruta: **API de LibreDTE → Consultas al SII → Documentos tributarios electrónicos → Contribuyentes → `GET` Estado Autorización de un Contribuyente** ![collections](https://www.apigateway.cl/img/content/academy/primeros-pasos/apigateway-orientado-a-postman/primeros-pasos-apigateway-v2-orientado-a-postman-8.jpg){style="width: 70%; display: block; margin: 0 auto;"} Configura los parámetros que indica el campo (en este caso el RUT a consultar) y selecciona **"Send"**. En el BODY se mostrarán los datos solicitados, permitiendo descargar la base de datos de contribuyentes autorizados por el SII a operar con documentos tributarios electrónicos. ![send](https://www.apigateway.cl/img/content/academy/primeros-pasos/apigateway-orientado-a-postman/primeros-pasos-apigateway-v2-orientado-a-postman-10.jpg){style="width: 70%; display: block; margin: 0 auto;"} --- ## Servicios sin autenticación del SII [![Watch video](https://img.youtube.com/vi/rGPDby2d_yA/hqdefault.jpg)](https://www.youtube.com/watch?v=rGPDby2d_yA) --- ## Servicios con RUT y clave tributaria [![Watch video](https://img.youtube.com/vi/9od9KBaCZSY/hqdefault.jpg)](https://www.youtube.com/watch?v=9od9KBaCZSY) --- ## Servicios con firma electrónica [![Watch video](https://img.youtube.com/vi/7iFbR6VXKRs/hqdefault.jpg)](https://www.youtube.com/watch?v=7iFbR6VXKRs) --- Last updated on 21/08/2026