Emitir borrador MIPYME como DTE oficial

import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/sii/mipyme/borradores/emitir/76192083-9/1234567",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Emitir un borrador MIPYME existente como DTE oficial.

Emite un borrador existente del portal MIPYME como DTE oficial (con folio y timbre del SII). Operacion irreversible. Por defecto se emite tal cual esta almacenado; opcionalmente el cliente puede enviar overrides para modificar el borrador antes de emitir.

Autenticacion requerida: API token en header X-API-Token con scope sii:write

• certificado digital (no password) anidado bajo auth.cert.* en el body. Dos modos disponibles:

• PFX/P12: auth.cert.pfx-data (base64) + auth.cert.passphrase
• PEM: auth.cert.cert-data (base64) + auth.cert.pkey-data (base64) + auth.cert.passphrase (opcional)

El passphrase del certificado se usa tanto para la sesion como para la firma del DTE.

Quota: Consume 1 consulta | Peso: 5x (operacion critica de escritura)

Parametros de ruta

Ejemplo SIN overrides (emitir tal cual)

{
    "auth": {
        "cert": {
            "pfx-data": "<base64 archivo .pfx/.p12>",
            "passphrase": "clave_del_certificado"
        }
    }
}

Ejemplo CON overrides (modificar antes de emitir)

Todos los campos de overrides son opcionales. Solo incluir los que se desean modificar.

{
    "auth": {"cert": {"pfx-data": "<base64>", "passphrase": "clave"}},
    "overrides": {
        "detalle": [
            {"NmbItem": "Servicio consultoria", "QtyItem": 2, "PrcItem": 50000}
        ],
        "descuento_global_pct": 5,
        "forma_pago": 1,
        "referencias": [
            {"TpoDocRef": 801, "FolioRef": 123, "FchRef": "2026-04-01", "RazonRef": "OC"}
        ],
        "transporte": {"RUTTrans": "11.111.111-1", "Patente": "ABCD12"}
    }
}

Campos de overrides

detalle (lista, max 10 items): reemplaza TODOS los items del borrador. Campos: NmbItem, QtyItem, PrcItem (requeridos), UnmdItem, DscItem, DescuentoPct, TpoCodigo, VlrCodigo, OtroImp.

descuento_global_pct / descuento_global_monto: descuento global (mutuamente excluyentes).

forma_pago (int): 1 contado, 2 credito (default SII), 3 sin costo.

referencias (lista, max 3): TpoDocRef, FolioRef, FchRef (requeridos), CodRef, RazonRef.

transporte (objeto): RUTTrans, Patente, RUTChofer, NombreChofer.

Errores especificos

Notas importantes

• Irreversible: una vez emitido, el DTE tiene folio y timbre del SII.
• Datos del emisor/receptor: se usan los defaults del SII (no sobreescribibles).
• Max 10 items, max 3 referencias.
• Descuento por item: solo porcentaje. Global: porcentaje O monto (no ambos).
• Factura afecta (33): solo items afectos. Para exentos usar factura exenta (34) con IndExe: 1.

Parámetros

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

{
  "auth": {
    "cert": {
      "cert-data": "LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0t...",
      "passphrase": "mi_passphrase_segura",
      "pkey-data": "LS0tLS1CRUdJTiBSU0EgUFJJVkFURSBLRVkt..."
    }
  },
  "overrides": {
    "descuento_global_monto": 0,
    "descuento_global_pct": 0,
    "detalle": [
      {}
    ],
    "forma_pago": 0,
    "referencias": [
      {}
    ],
    "transporte": {}
  }
}

Respuestas

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{
  "data": {
    "razon_social": "Empresa S.A.",
    "rut": "12.345.678-9"
  },
  "message": "Operación completada exitosamente",
  "success": true,
  "timestamp": "2025-12-01T12:00:00Z"
}