Ceder multiples DTEs en lote (max 40)

Generar AECs para multiples DTEs en lote (max 40) y opcionalmente enviarlos al SII.

POST/api/v1/vendemas/dte/cesion/ceder-lotev1 · ESTABLE

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

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-lote",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Generar AECs para multiples DTEs en lote (max 40) y opcionalmente enviarlos al SII.

Cada DTE se procesa de forma independiente — un fallo en un DTE no cancela los demas. El endpoint retorna estadisticas agregadas (total, exitosos, fallidos) y el detalle de cada item procesado.

IMPORTANTE: El certificado va a nivel raiz del body.

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 (escritura, proporcional al lote)

Parametros de consulta

Parametro	Tipo	Default	Descripcion
`enviar_sii`	string	`0`	`0` solo genera; `1` envia cada AEC al SII

Body (JSON)

Campo	Tipo	Requerido	Descripcion
`cert.*`	string	Si	Certificado PFX o PEM (a nivel raiz)
`xmls[]`	array	Si	Lista de EnvioDTE en base64 (max 40)
`cedente.*`	object	Si	Datos del cedente
`cesionario.*`	object	Si	Datos del cesionario

Respuesta exitosa (200)

{
    "total": 10,
    "exitosos": 9,
    "fallidos": 1,
    "resultados": [
        {"index": 0, "success": true, "xml": "PD94bWw...", "track_id": 123},
        {"index": 1, "success": false, "error": "Descripcion del error"}
    ]
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`VALIDATION_ERROR`	Lista vacia, mas de 40 DTEs, o datos faltantes	Ajustar payload
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 (errores individuales en `resultados`)	Reintentar fallidos

Body esperado::

{
    "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
    "xmls": [                # Lista de EnvioDTE en base64 (máx. 40)
        "base64_envio_dte_1...",
        "base64_envio_dte_2...",
        ...
    ],
    "cedente": {
        "email": "cedente@empresa.cl",
        "rut": "76192083-9"
    },
    "cesionario": {
        "rut": "12345678-9",
        "razon_social": "Empresa SA",
        "direccion": "Santiago",
        "email": "cesionario@empresa.cl"
    }
}

Args: body: Cuerpo de la petición con certificado, lista de XMLs EnvioDTE y datos del cedente y cesionario. enviar_sii: "0" solo genera los AECs, "1" también los envía al SII.

Returns: Diccionario con:

total (int): Número total de DTEs procesados.
exitosos (int): Número de DTEs procesados sin error.
fallidos (int): Número de DTEs que fallaron.
resultados (list): Lista de resultados individuales con indice, estado, xml, certificacion y opcionalmente track_id o error.

Raises: ValueError: Si xmls está ausente, vacío, no es lista, o supera 40 elementos; o si cedente o cesionario están ausentes.

Parámetros

Header / Body

Tipo

Descripción

Requerido

enviar_sii

string · query

`0` No enviar al SII. `1` Enviar cada AEC al SII

Respuestas

200Resultado del procesamiento del lote (total, exitosos, fallidos)

400Datos invalidos, faltantes o > 40 DTEs

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.

{}