VendemasEnvíos al SII
Enviar XML al SII
Enviar XML firmado al SII con deteccion automatica de modo.
POST
/api/v1/vendemas/dte/envios/enviarv1 · ESTABLEPOST /api/v1/vendemas/dte/envios/enviar
Enviar XML firmado al SII con deteccion automatica de modo.
Soporta 3 modos de operacion detectados automaticamente segun el contenido del body:
- Sobre:
xmles un<EnvioDTE>o<EnvioBOLETA>ya firmado -> reenvio directo. - DTE individual:
xmles un<DTE>firmado -> construye sobre, firma y envia. - Masivo:
xmles 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
| Parametro | Tipo | Default | Descripcion |
|---|---|---|---|
ambiente | string | 0 | 0 produccion, 1 certificacion |
gzip | string | 0 | 0 sin comprimir, 1 comprimido |
retry | string | 1 | Intentos de envio (max 3) |
Body (JSON)
| Campo | Tipo | Requerido | Descripcion |
|---|---|---|---|
auth.cert.* | string | Si | Certificado PFX o PEM (cert + pkey) |
emisor | string | Si | RUT del emisor |
xml | string o array | Si | XML(s) firmado(s) en base64 |
resolucion.fecha | string | Condicional | AAAA-MM-DD (si xml es DTE individual/masivo) |
resolucion.numero | int | Condicional | Numero resolucion SII |
Respuesta exitosa (200)
Errores especificos
| Codigo | error_code | Causa | Resolucion |
|---|---|---|---|
| 400 | VALIDATION_ERROR | XML, emisor o resolucion faltantes | Revisar body |
| 400 | AUTH_ERROR | Certificado invalido o passphrase incorrecta | 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 |
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.