Qué hace, exactamente.
La capa tributaria chilena, con dos superficies: una API por donde tu software emite, y un portal donde se configura y se comprueba.
Documentos que emite
| Código | Documento |
|---|---|
33 | Factura electrónica |
52 | Guía de despacho |
56 | Nota de débito |
61 | Nota de crédito |
Fuera del alcance de la v1: boletas electrónicas (39), recepción de DTE de proveedores, cesión electrónica y libros de compra y venta.
La API
El camino de todos los días. Tu sistema hace una llamada y lo demás ocurre por dentro, con cada paso registrado.
Folio
Se toma el siguiente folio del CAF autorizado para ese tipo de documento.
XML
Se construye conforme al esquema oficial del SII y se valida contra él.
Timbre electrónico
Se calcula el TED y se firma con la llave del CAF.
Firma del documento
Firma XMLDSig con el certificado digital del emisor.
Envío
Autenticación ante el SII y despacho del sobre con el documento firmado.
Seguimiento
Acuse, TrackID y consulta del estado hasta que el SII resuelve.
El portal
Lo que se prepara antes de emitir, y lo que se revisa después. Sin escribir código.
Emisor
Alta y consulta del RUT que emite: razón social, giro, dirección y la resolución del SII que lo autoriza.
Certificado
Carga del certificado digital y su estado: titular, autoridad emisora, vigencia y días que le quedan.
CAF y folios
Carga del CAF y disponibilidad por tipo de documento, con el consumo y el margen que el servicio calcula.
Habilitación
El servicio comprueba los requisitos y, si se cumplen, deja el emisor habilitado para emitir.
Documentos
Los documentos emitidos, con sus dos estados y el detalle de cada uno.
Lo que devuelve, en cada momento
La API no resume el ciclo en un único campo: responde por separado a preguntas distintas, porque llevan a decisiones distintas.
| Pregunta | Campo | Valores |
|---|---|---|
| ¿Qué dice el SII del documento? | estadoTributario | EMITIDO · ACEPTADO · ACEPTADO_CON_REPAROS · RECHAZADO · ANULADO_POR_NC |
| ¿En qué punto va la entrega? | estadoEnvio | PENDIENTE · EN_CURSO · ACUSADO · FALLIDO · ABANDONADO |
RECHAZADO y FALLIDO no son lo mismo.El primero significa que el documento llegó al SII y fue resuelto en contra: el problema está en el dato. El segundo, que un intento de entrega falló y se reintentará: no hay que hacer nada.
Qué significa cada combinación, y la pregunta que ninguno de los dos responde
Cuando algo falla
Un fallo de red no cambia el estado tributario del documento. El documento sigue emitido; lo que cambia es lo que sabemos de su entrega.
- Los fallos transitorios se reintentan solos, un número acotado de veces y con espera creciente entre intentos.
- Antes de reenviar algo cuya entrega no se pudo confirmar, se le pregunta al SII si ya lo tenía.
- Si esa consulta no permite descartarlo, el reenvío no sale.
- Agotados los reintentos, el envío queda para decisión de un operador. Nunca se descarta en silencio.
Nunca se reenvía a ciegas. Así es como se duplica una factura.
Ambientes
Certificación y producción están separados de extremo a extremo: cada emisor declara en cuál opera, y los documentos de uno nunca se mezclan con los del otro.
La referencia completa está en la documentación
Endpoints, esquemas de error y ejemplos de cada tipo de documento.