Normalizar DTE al formato estandar del SII

POST/api/v1/vendemas/dte/formatos/jsonv1 · ESTABLE

POST /api/v1/vendemas/dte/formatos/json

import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/vendemas/dte/formatos/json",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Normalizar un DTE externo al formato estandar del SII.

Decodifica el DTE desde base64 y lo convierte al formato dict estandar del SII (campos en espanol segun nomenclatura oficial). Operacion puramente local — no requiere llamadas al SII.

Autenticacion requerida: API token en header X-API-Token con scope vendemas:read.

Quota: Consume 1 consulta | Peso: 1x

Body (JSON)

Campo	Tipo	Requerido	Descripcion
`dte`	string	Si	DTE codificado en base64
`formato`	string	No	Formato de entrada (default: `json`)

Formatos soportados

Formato	Descripcion
`json`	JSON estandar del SII
`xml`	XML DTE
`yaml`	YAML
`JSONString`	JSON codificado como string dentro del base64
`Acepta.Normal`	Formato Acepta (facturas)
`Acepta.Boleta`	Formato Acepta (boletas)
`FacturacionCL.XML`	XML de FacturacionCL

Respuesta exitosa (200)

Retorna el DTE normalizado con estructura {Encabezado, Detalle, Referencia}.

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`VALIDATION_ERROR`	`dte` faltante, base64 invalido o formato no soportado	Revisar body
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
422	`VALIDATION_ERROR`	Body con formato invalido	Revisar `errors[]`
429	`SII_RATE_LIMIT` / `QUOTA_EXCEEDED`	Rate limit	Respetar `Retry-After`

El body debe tener la siguiente estructura::

{
    "dte": "base64_del_dte...",
    "formato": "json"  // opcional, default "json"
}

Formatos soportados actualmente:

json: JSON con estructura SII (pasthrough con normalizacion)
JSONString: JSON codificado como string dentro del base64
xml: XML DTE del SII

Args: body: Request body con dte (base64) y formato opcional.

Returns: DTE normalizado con Encabezado, Detalle y Referencias segun esquema SII.

Raises: ValueError: Si el base64 no es valido, el formato no es soportado, o la estructura del DTE es invalida.

Respuestas

200DTE normalizado con estructura SII

400Datos invalidos o formato no soportado

401API token ausente o invalido

403Sin scope `vendemas:read` o cuenta bloqueada

422Body con formato invalido

429Limite de tasa excedido

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{}