Registrar aceptacion/reclamo de DTE en el SII

POST/api/v1/vendemas/dte/intercambios/respuesta_siiv1 · ESTABLE

POST /api/v1/vendemas/dte/intercambios/respuesta_sii

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

Registrar aceptacion/reclamo de DTEs recibidos ante el SII.

Registra respuestas de intercambio para multiples DTEs (aceptar, reclamar contenido, otorgar recibo de mercaderias, etc.). Delega al WebService SOAP SiiReclamoDteService.

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

certificado digital en auth.cert (PFX o PEM).

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

Parametros de consulta

Parametro	Tipo	Default	Descripcion
`ambiente`	string	`0`	`0` produccion, `1` certificacion

Body (JSON)

Campo	Tipo	Requerido	Descripcion
`auth.cert.*`	string	Si	Certificado PFX o PEM
`documentos[]`	array	Si	Lista de documentos a registrar

Cada documento: RUTEmisor, TipoDTE, Folio, EstadoRecepDTE.

Acciones validas (`EstadoRecepDTE`)

Codigo	Descripcion
`ACD`	Acepta contenido del documento
`RCD`	Reclamo contenido del documento
`ERM`	Otorga recibo de mercaderias o servicios
`RFP`	Reclamo falta parcial de mercaderia
`RFT`	Reclamo falta total de mercaderia

Respuesta exitosa (200)

Diccionario con resultados por documento indexados por T{TipoDTE}F{Folio}.

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`VALIDATION_ERROR`	`documentos` vacio o accion invalida	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	`VENDEMAS_ERROR`	SII rechazo la operacion	Revisar `details`

Parámetros

Header / Body

Tipo

Descripción

Requerido

ambiente

string · query

`0` ambiente de produccion. `1` ambiente de certificacion

dry_run

string | null · query

Si es `true` (o `1`/`yes`/`on`), el endpoint valida el payload y retorna una respuesta de previsualización (mismo shape que la respuesta real) sin contactar al SII. Útil para validar requests sin consumir folios, cuota ni créditos.

Respuestas

200Respuesta de intercambio registrada

400Datos invalidos o credenciales SII incorrectas

401API token ausente o invalido

403Sin scope `vendemas:write` o cuenta bloqueada

422Body con formato invalido

429Limite de tasa excedido

502Error en servicio SII upstream

503SII en mantenimiento

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{}

Registrar aceptacion/reclamo de DTE en el SII

On this page