Generar codigo ESC/POS a partir del XML del DTE

POST/api/v1/vendemas/dte/documentos/escposv1 · ESTABLE

POST /api/v1/vendemas/dte/documentos/escpos

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

Generar bytes ESC/POS de un DTE para impresion termica.

Parsea el XML DTE, extrae los datos del documento y construye una secuencia de comandos binarios ESC/POS compatibles con impresoras termicas Epson/Bixolon. 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: 2x

Body (JSON)

Campo	Tipo	Requerido	Default	Descripcion
`xml`	string	Si	—	XML del DTE codificado en base64
`papelContinuo`	int	No	`80`	Ancho de papel: 80 o 57 (mm)
`cedible`	int	No	`0`	`1` incluir copia cedible
`copias_cedibles`	int	No	`1`	Numero de copias cedibles
`copias_tributarias`	int	No	`1`	Numero de copias tributarias
`cut`	bool	No	`true`	Cortar papel al final
`footer`	bool	No	`true`	Incluir pie de pagina
`logo`	bool	No	`false`	Incluir logo
`caratula`	bool	No	`false`	Incluir caratula
`webVerificacion`	bool	No	`false`	URL verificacion SII

Respuesta exitosa (200)

{"escpos": "base64_de_comandos_escpos"}

Los bytes base64 pueden enviarse directamente a una impresora termica compatible con ESC/POS.

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`VALIDATION_ERROR`	`xml` faltante o mal formado	Enviar XML base64 valido
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 acepta los siguientes campos::

{
    "xml": "base64_del_xml_dte...",   // obligatorio
    "caratula": false,                 // opcional
    "cedible": 0,                      // opcional: 1=cedible, 0=no
    "copias_cedibles": 1,              // opcional
    "copias_tributarias": 1,           // opcional
    "cut": true,                       // opcional: cortar papel al final
    "footer": true,                    // opcional: incluir pie de pagina
    "logo": false,                     // opcional: incluir logo
    "papelContinuo": 80,               // opcional: 57 o 80 (mm)
    "pdf417": "",                      // opcional: modo barcode PDF417
    "profile": "default",              // opcional: perfil de impresora
    "specialchars": false,             // opcional: caracteres especiales
    "webVerificacion": false           // opcional: URL verificacion SII
}

Args: body: Request body con xml (base64) y opciones de impresion.

Returns: Diccionario con los bytes ESCPOS codificados en base64 bajo la clave "escpos".

Raises: ValueError: Si falta el campo xml o el base64 / XML son invalidos.

Respuestas

200Codigo ESCPOS generado (bytes base64 en `escpos`)

400XML invalido o parametros incorrectos

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.

{}