# API pública Comges DTE

> API REST para emitir Documentos Tributarios Electrónicos al SII de Chile desde un ERP
> externo. Autenticación por API Key. Cubre facturas, boletas, notas de crédito y débito,
> guías de despacho y documentos de exportación, con descarga del XML firmado y del PDF.

Host único: https://api-publica.dtecomges.cl/api/public/v1
Autenticación: header `X-Api-Key: pk_live_…` (producción) o `pk_test_…` (certificación).
La misma URL sirve a los dos ambientes: el ambiente lo fija el prefijo de la key, no el host.

Documentación sincronizada el 2026-08-26.

## Documentación

- [Referencia completa](https://new.dtecomges.cl/llms-full.txt): la superficie entera en markdown — alta de la
  empresa, prerequisitos, cada endpoint, cada campo, la tabla completa de códigos de error,
  límites, idempotencia y el contrato de webhooks. **Empezá acá.**
- [Referencia en el portal](https://new.dtecomges.cl/docs/referencia-completa): el mismo documento, navegable.
- [Explorador OpenAPI](https://new.dtecomges.cl/docs/reference): contrato de máquina, importable a Postman.
- [Guías](https://new.dtecomges.cl/docs/guides): tutoriales por tema (autenticación, errores, límites de uso,
  modos de emisión, webhooks).

## Lo que hay que saber antes de escribir código

- **El alta de la empresa no es autoservicio.** La ejecuta un administrador de Comges, y el
  cliente tiene que entregar su certificado digital (.pfx) y su clave tributaria del SII. Sin
  certificado cargado la emisión responde 422 y no consume folio.
- **La emisión puede responder 202, no solo 201.** Cuando el SII autoriza folios de a uno —el
  caso normal de un contribuyente nuevo— la respuesta trae un `ticketId` en vez de un `id`, y el
  documento se resuelve después consultando ese ticket. Un cliente que asume siempre 201 guarda
  un documento fantasma sin ningún error visible.
- **Mandá `transactionId` en cada emisión.** Es la clave de idempotencia: reintentar con el mismo
  valor devuelve el mismo documento en vez de quemar otro folio.
- **En boleta afecta (39) el `precioUnitario` va NETO** y el sistema le suma el IVA. Mandar el
  precio con IVA incluido emite la boleta un 19 % arriba.
- **`unidadMedida` acepta 4 caracteres.** `UN`, `KG`, `LT` sirven; `UNIDAD` devuelve 400.
- **Para anular, usá `POST /dte/{id}/anular`** en vez de armar la nota de crédito a mano: el
  servidor resuelve la referencia al documento original, que es donde se equivocan las
  integraciones y se pierde el folio.
- **Programá contra el campo `code` del error, no contra el status HTTP.** Dentro de un mismo 403
  conviven causas que se resuelven distinto.
- Los tipos 43 y 46 **no** se emiten por esta API: responden 501.