API REST · v1

Documentación de la API

Emite documentos tributarios electrónicos contra el SII desde cualquier software. Genera una llave en API para desarrolladores y empieza.

URL base

https://api.mipyme.digital/v1

Todas las respuestas son JSON. Las emisiones son reales y consumen un folio.

Autenticación

Cada petición lleva tu llave en el header Authorization:

Authorization: Bearer emi_live_••••••••

Emitir un documento

POST /v1/dte

POST https://api.mipyme.digital/v1/dte
Authorization: Bearer emi_live_••••••
Content-Type: application/json
 
{
  "tipo": 33,
  "receptor": {
    "rut": "76543210-K",
    "razonSocial": "Comercial Ltda",
    "giro": "Retail", "comuna": "Santiago"
  },
  "items": [
    { "nombre": "Asesoría", "cantidad": 1, "precio": 90000, "descuentoPct": 10 }
  ]
}

Respuesta 201:

{
  "ok": true,
  "id": "cmq…", "tipo": 33, "folio": 1042,
  "trackId": "12177736352", "estado": "ENVIADO",
  "montos": { "neto": 81000, "iva": 15390, "total": 96390 }
}

Campos: tipo (requerido), receptor.rut (requerido), items[] (requerido: nombre, precio; opcional cantidad, descuentoPct). Opcionales: fechaEmision, fechaVencimiento, referencias[], idempotencyKey (evita doble emisión).

Consultar estado

GET /v1/dte/{id}

GET https://api.mipyme.digital/v1/dte/cmq…
Authorization: Bearer emi_live_••••••
 
→ { "ok": true, "folio": 1042, "estado": "ACEPTADO", … }

Listar documentos

GET /v1/dte · filtros opcionales ?periodo=YYYYMM ?tipo= ?estado= ?limit=

GET https://api.mipyme.digital/v1/dte?periodo=202606&tipo=33
Authorization: Bearer emi_live_••••••
 
→ { "ok": true, "total": 12, "documentos": [ … ] }

Descargar PDF

GET /v1/dte/{id}/pdf → devuelve el PDF (application/pdf).

GET https://api.mipyme.digital/v1/dte/cmq…/pdf
Authorization: Bearer emi_live_••••••

Límite de uso

Hasta 120 peticiones por minuto por llave. Al excederlo responde 429 con retryAfter (segundos).

Tipos de documento

tipo	Documento
`33`	Factura electrónica afecta
`34`	Factura electrónica exenta
`39`	Boleta electrónica
`41`	Boleta exenta
`52`	Guía de despacho
`56`	Nota de débito
`61`	Nota de crédito

Errores

Código	Significado
`401`	Llave de API inválida o ausente.
`400`	Falta un campo requerido o el JSON es inválido.
`422`	Validación pre-emisión (ver `detalles`).
`429`	Límite de peticiones excedido (ver `retryAfter`).
`500`	Error al emitir (ver `error`).