Enviar XML al SII

Enviar XML firmado al SII con deteccion automatica de modo.

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

Enviar XML firmado al SII con deteccion automatica de modo.

Soporta 3 modos de operacion detectados automaticamente segun el contenido del body:

  • Sobre: xml es un <EnvioDTE> o <EnvioBOLETA> ya firmado -> reenvio directo.
  • DTE individual: xml es un <DTE> firmado -> construye sobre, firma y envia.
  • Masivo: xml es una lista de DTEs firmados -> construye un sobre con todos.

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

  • certificado digital del emisor en auth.cert.

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


Parametros de consulta

ParametroTipoDefaultDescripcion
ambientestring00 produccion, 1 certificacion
gzipstring00 sin comprimir, 1 comprimido
retrystring1Intentos de envio (max 3)

Body (JSON)

CampoTipoRequeridoDescripcion
auth.cert.*stringSiCertificado PFX o PEM (cert + pkey)
emisorstringSiRUT del emisor
xmlstring o arraySiXML(s) firmado(s) en base64
resolucion.fechastringCondicionalAAAA-MM-DD (si xml es DTE individual/masivo)
resolucion.numerointCondicionalNumero resolucion SII

Respuesta exitosa (200)

{
    "certificacion": 1,
    "track_id": 123456,
    "estado": "EPR",
    "descripcion": "Envio recibido"
}

Errores especificos

Codigoerror_codeCausaResolucion
400VALIDATION_ERRORXML, emisor o resolucion faltantesRevisar body
400AUTH_ERRORCertificado invalido o passphrase incorrectaRenovar certificado
401HTTP_401API token ausente o invalidoEnviar X-API-Token valido
403INSUFFICIENT_SCOPEToken sin scope vendemas:writeGenerar token con scope
429SII_RATE_LIMIT / QUOTA_EXCEEDEDRate limitRespetar Retry-After
502SII_UPLOAD_ERRORSII rechazo el envioReintentar con mismo XML
503SII_UNAVAILABLESII en mantenimientoReintentar en 5 min

Parámetros

Header / Body
Tipo
Descripción
Requerido
ambiente
string · query
`0` ambiente de produccion. `1` ambiente de certificacion
No
gzip
string · query
`0` enviar sin comprimir. `1` enviar comprimido
No
retry
string · query
Cantidad de intentos de envio que se deben realizar
No

Respuestas

200XML enviado al SII (`track_id` + `estado` + `descripcion`)
400Datos de certificado/XML/emisor invalidos
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.

{}

On this page