API y el SII: una confusión que nunca termina

El SII no proporciona APIs de facturación electrónica: proporciona especificaciones técnicas.

Una API (Application Programming Interface) es una interfaz que expone operaciones o funciones para que un cliente las consuma. El proveedor de la API implementa la lógica; el consumidor solo la utiliza siguiendo las reglas establecidas.

En cambio, con el SII ocurre algo diferente:

• El SII publica especificaciones técnicas: formatos XML,especificaciones de firma, esquemas XSD, servicios SOAP, autenticación y envio por http.

• El desarrollador debe implementar gran parte de la lógica necesaria para generar los documentos, firmarlos, validarlos y comunicarse con el SII.

• Es decir, el SII no entrega una biblioteca o un SDK que resuelva todo el proceso; entrega la documentación para que tú construyas la integración.

Por eso muchas empresas crean su propia capa de servicios o API. Por ejemplo, una empresa puede exponer un endpoint como:

POST /api/envioFactura

y ese endpoint puede internamente:

1. Genera el XML.
2. Lo firma.
3. Obtiene el token.
4. Lo envía al SII.
5. Consulta el estado.
6. Devuelve el resultado al cliente.

En ese caso, la API es la de la empresa, no la del SII. El SII es el sistema con el que esa API interactúa siguiendo las especificaciones técnicas publicadas.