---
title: "Conocimientos Previos"
description: "Revisa los conocimientos previos necesarios para emisión de documentos"
type: "academy"
category: "lesson"
tags: []
authors: [Anonymous]
date: "2026-08-27"
last_update: "2026-08-21"
time_minutes: 2
draft: false
unlisted: false
url: "https://www.stage.apigateway.cl/academy/integracion-para-la-emision-de-dte/emision-de-documentos/conocimientos-previos"
---

# Conocimientos Previos

Antes de comenzar con la emisión de documentos, es importante que tengas en cuenta los siguientes conocimientos previos:

---

## Configuración del Certificado Digital

### Formatos de Certificado

API Gateway acepta certificados en los siguientes formatos:

| Formato | Extensión | Descripción |
|---------|-----------|-------------|
| **PFX/P12** | `.pfx`, `.p12` | Formato binario con clave privada incluida |
| **PEM** | `.pem`, `.crt`, `.key` | Formato texto, certificado y clave separados |

### Conversión de Formatos

#### De PFX a PEM (Linux/Mac)

```bash
# Extraer certificado
openssl pkcs12 -in certificado.pfx -clcerts -nokeys -out cert.pem

# Extraer clave privada
openssl pkcs12 -in certificado.pfx -nocerts -nodes -out key.pem

# Verificar certificado
openssl x509 -in cert.pem -text -noout
```

#### De PFX a PEM (Windows - PowerShell)

```powershell
# Usando OpenSSL para Windows
.\openssl.exe pkcs12 -in certificado.pfx -clcerts -nokeys -out cert.pem
.\openssl.exe pkcs12 -in certificado.pfx -nocerts -nodes -out key.pem
```

## Ambientes de Trabajo

API Gateway ofrece dos ambientes principales para la emisión de DTEs:

### 1. Ambiente de Certificación (Pruebas)

| Característica | Detalle |
|----------------|---------|
| **URL Base** | `https://legacy.apigateway.cl` |
| **Parámetro** | `?certificacion=1` |
| **Propósito** | Pruebas y desarrollo |
| **Datos** | Ficticios, sin validez legal |
| **Límites** | Más flexibles |
| **SII** | Ambiente de certificación del SII |

**Ejemplo de uso**:
```
POST https://legacy.apigateway.cl/api/v1/libredte/dte/envios/enviar?certificacion=1
```

### 2. Ambiente de Producción

| Característica | Detalle |
|----------------|---------|
| **URL Base** | `https://legacy.apigateway.cl` |
| **Parámetro** | `?certificacion=0` |
| **Propósito** | Emisión real de DTEs |
| **Datos** | Reales con validez legal |
| **Límites** | Según plan contratado |
| **SII** | Ambiente de producción del SII |

**Ejemplo de uso**:
```
POST https://legacy.apigateway.cl/api/v1/libredte/dte/envios/enviar?certificacion=0
```

---

## Configuración del Entorno de Desarrollo

### Variables de Entorno

Crea un archivo `.env` para gestionar configuraciones:

```env
# API Gateway
API_GATEWAY_URL=https://legacy.apigateway.cl
API_GATEWAY_ENV=0 # 0: Producción, 1: Certificación

# Certificados
CERT_PATH=./certs/cert.pem
KEY_PATH=./certs/key.pem

# Logs
LOG_LEVEL=DEBUG
LOG_PATH=./logs/
```


---
Last updated on 21/08/2026