Generar XML de Cesion de DTE (AEC)

POST/api/v1/vendemas/dte/cesion/cederv1 · ESTABLE

POST /api/v1/vendemas/dte/cesion/ceder

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

Generar XML de Cesion (AEC) de un DTE para envio al SII.

Genera el Archivo Electronico de Cesion (AEC) para ceder un DTE a un cesionario. Firma el AEC digitalmente con el certificado del cedente y opcionalmente lo envia al SII.

IMPORTANTE: En este endpoint el certificado va a nivel raiz del body (estructura cert), no dentro de auth.cert.

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

certificado digital del cedente en el body.

Quota: Consume 1 consulta | Peso: 5x (operacion critica si enviar_sii=1)

Parametros de consulta

Parametro	Tipo	Default	Descripcion
`enviar_sii`	string	`0`	`0` solo genera; `1` envia al SII y retorna `track_id`

Body (JSON)

Campo	Tipo	Requerido	Descripcion
`cert.*`	string	Si	Certificado PFX o PEM (cert + pkey) a nivel raiz
`xml`	string	Si	XML del EnvioDTE en base64
`cedente.email`	string	Si	Email del cedente
`cesionario.rut` / `.razon_social` / `.direccion` / `.email`	string	Si	Datos del cesionario

Respuesta exitosa (200)

{
    "xml": "PD94bWwgdmVyc2lvbj0i...",
    "track_id": 123456,
    "estado": "OK"
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`VALIDATION_ERROR`	Datos de cedente/cesionario faltantes	Revisar body
400	`AUTH_ERROR`	Certificado invalido	Renovar certificado
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
403	`INSUFFICIENT_SCOPE`	Token sin scope `vendemas:write`	Generar token con scope
429	`SII_RATE_LIMIT` / `QUOTA_EXCEEDED`	Rate limit	Respetar `Retry-After`
502	`SII_UPLOAD_ERROR`	SII rechazo el envio	Reintentar con mismo XML
503	`SII_UNAVAILABLE`	SII en mantenimiento	Reintentar en 5 min

(Legacy docstring con estructura interna del body - preservado para referencia)

Body esperado::

{
    "cert": {
        "cert-data": "...",   # Certificado X.509 en base64 o PEM
        "pkey-data": "...",   # Llave privada en base64 o PEM
        "pfx-data": "...",    # Alternativa: PKCS#12 en base64
        "passphrase": "..."   # Opcional: contrasena del PFX o llave
    },
    "xml": "base64_envio_dte...",   # EnvioDTE codificado en base64
    "cedente": {
        "email": "cedente@empresa.cl",       # Requerido
        "rut": "76192083-9",                 # Opcional (default: RUT del DTE)
        "razon_social": "Mi Empresa SpA",    # Opcional (default: del DTE)
        "direccion": "Av. Ejemplo 123",      # Opcional (default: del DTE)
        "declaracion_jurada": "..."          # Opcional (se genera si omite)
    },
    "cesionario": {
        "rut": "12345678-9",                 # Requerido
        "razon_social": "Empresa SA",        # Requerido
        "direccion": "Santiago",             # Requerido
        "email": "cesionario@empresa.cl"     # Requerido
    }
}

Args: body: Cuerpo de la peticion con certificado, XML EnvioDTE y datos del cedente y cesionario. enviar_sii: "0" solo genera el AEC, "1" tambien lo envia al SII.

Returns: Diccionario con:

certificacion (int): 0 produccion, 1 certificacion.
xml (str): AEC firmado codificado en base64.
track_id (int|bool): ID de seguimiento del SII si enviar_sii="1", o False si el envio fallo. Ausente si enviar_sii="0".

Raises: ValueError: Si faltan datos del certificado, el XML EnvioDTE es invalido, o los datos del cesionario son incompletos.

Parámetros

Header / Body

Tipo

Descripción

Requerido

enviar_sii

string · query

`0` No se envia el XML generado al SII. `1` Se envia el XML generado al SII

Respuestas

200AEC generado exitosamente (`xml` base64, `track_id` si enviado)

400Datos invalidos o faltantes

401API token ausente o invalido

403Sin scope `vendemas:write` o cuenta bloqueada

422Body con formato invalido

429Limite de tasa excedido

502SII rechazo el envio

503SII en mantenimiento

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{}