Voy a contrastarlo con documentación pública del SII, porque los endpoints y requisitos de certificación pueden cambiar o variar según ambiente. Luego te dejo un checklist práctico para comparar contra tu API.
Thought for 55s
Sí. La certificación del SII para DTE / factura electrónica no es solo “tener endpoints”, sino demostrar que tu sistema puede generar, firmar, timbrar, enviar, consultar, imprimir, respaldar e intercambiar DTE correctamente.
El proceso oficial de certificación del SII contempla estas etapas: set de pruebas asignado, set de simulación, set de intercambio de información, muestras de impresión, declaración de cumplimiento de requisitos y finalmente registro como emisor electrónico. El SII además exige declarar procedimientos críticos: gestión de CAF, foliación controlada, respaldo, envío al SII, intercambio con otros contribuyentes, cuadratura y contingencias.
Documentación base del SII que deberías revisar
El SII tiene un Instructivo Técnico de Factura Electrónica donde agrupa la documentación principal: manual de operación del ambiente de certificación, construcción del set de prueba, autenticación automática, envío automático de DTE, consulta de estado de envío, consulta de estado de DTE, formato XML, firma electrónica y muestras impresas.
Para tu API, los documentos más relevantes son:
Área Documento / servicio SII Para qué sirve Certificación Proceso de certificación Entender las etapas que debes completar ante el SII. Set de pruebas Construcción del set de prueba Generar DTE con los datos asignados por el SII. Autenticación CrSeed y GetTokenFromSeed Obtener semilla, firmarla con certificado digital y obtener token. Envío DTE Upload automático de DTE Enviar el XML EnvioDTE al SII. Estado envío QueryEstUp Consultar estado del envío usando TrackId. Estado DTE QueryEstDte / QueryEstDteAv Consultar estado de un documento específico. Impresión Manual de muestras impresas Generar representación impresa con timbre PDF417. Intercambio Intercambio entre contribuyentes Recibir DTE, acuse de recibo, aceptación/rechazo comercial. Endpoints SII mínimos para factura electrónica DTE
Para factura electrónica, el SII sigue usando servicios SOAP para los DTE tradicionales. La boleta electrónica tiene una ruta distinta, con servicios REST separados; el propio SII indica que factura electrónica mantiene los Web Services SOAP actuales, mientras que boleta electrónica usa servicios REST y token específico.
- Autenticación automática
Tu API debe implementar el flujo:
Solicitar semilla. Firmar la semilla con certificado digital. Enviar la semilla firmada. Obtener token. Reutilizar token.
El manual del SII señala que la autenticación automática usa los servicios CrSeed y GetTokenFromSeed para obtener la semilla y luego el token.
Certificación: https://maullin.sii.cl/DTEWS/CrSeed.jws?WSDL https://maullin.sii.cl/DTEWS/GetTokenFromSeed.jws?WSDL
Producción: https://palena.sii.cl/DTEWS/CrSeed.jws?WSDL https://palena.sii.cl/DTEWS/GetTokenFromSeed.jws?WSDL
Ojo: el SII recomienda no pedir token en cada conexión. El token tiene TTL de 1 hora y se renueva al usarse; también recomienda no consultar repetidamente los WSDL, sino cachearlos.
- Envío automático de DTE
Debes tener una función que arme el EnvioDTE, lo firme, lo envíe al SII y capture el TrackId.
Certificación: POST https://maullin.sii.cl/cgi_dte/UPL/DTEUpload
Producción: POST https://palena.sii.cl/cgi_dte/UPL/DTEUpload
El envío se hace como multipart/form-data, incluyendo el token en cookie TOKEN. El manual muestra el POST /cgi_dte/UPL/DTEUpload y el uso de Cookie: TOKEN=.... Además, recomienda usar PROG 1.0 en el User-Agent para que la salida sea XML.
- Consulta de estado del envío
Después de enviar, debes consultar el estado usando el TrackId.
Certificación: https://maullin.sii.cl/DTEWS/QueryEstUp.jws?WSDL
Producción: https://palena.sii.cl/DTEWS/QueryEstUp.jws?WSDL
El servicio QueryEstUp recibe, entre otros parámetros, RUT, DV, TrackId y Token, y devuelve estado del envío, glosa, documentos informados, aceptados, rechazados y reparos cuando corresponda.
- Consulta de estado de un DTE específico
Para consultar un documento emitido, debes implementar QueryEstDte.
Certificación: https://maullin.sii.cl/DTEWS/QueryEstDte.jws?WSDL
Producción: https://palena.sii.cl/DTEWS/QueryEstDte.jws?WSDL
Este servicio recibe datos como RUT consultante, RUT emisor, RUT receptor, tipo DTE, folio, fecha de emisión, monto y token.
También existe la consulta avanzada:
Certificación: https://maullin.sii.cl/DTEWS/services/QueryEstDteAv?wsdl
Producción: https://palena.sii.cl/DTEWS/services/QueryEstDteAv?wsdl
El manual de QueryEstDteAv señala expresamente la diferencia entre certificación y producción: certificación usa maullin, producción usa palena.
Endpoints internos que debería tener tu API
Para comenzar bien el proceso de certificación, yo revisaría si tu API ya tiene, al menos, estos módulos:
Endpoint interno sugerido Necesario para certificación Comentario POST /sii/auth/token Sí Obtiene semilla, firma y cachea token. POST /folios/caf/importar Sí Cargar CAF entregado por SII. GET /folios/disponibles Sí Control de folios autorizados y usados. POST /dte/generar Sí Genera XML DTE según tipo documento. POST /dte/firmar Sí Firma XML con certificado digital. POST /dte/timbrar Sí Genera TED/timbre electrónico desde CAF. POST /dte/enviar-sii Sí Hace upload a SII y guarda TrackId. GET /dte/envios/{trackId}/estado Sí Consulta QueryEstUp. GET /dte/{tipo}/{folio}/estado-sii Sí Consulta QueryEstDte o QueryEstDteAv. GET /dte/{id}/pdf Sí Genera representación impresa con PDF417. POST /intercambio/recibir-dte Sí Para etapa de intercambio entre contribuyentes. POST /intercambio/acuse-recibo Sí Acuse de recibo de DTE recibido. POST /intercambio/aceptar-rechazar Sí Aceptación o rechazo comercial. GET /certificacion/set-pruebas Recomendable Manejo interno del set asignado por SII. POST /certificacion/simulacion Recomendable Generación de set de simulación. GET /reportes/cuadratura Sí Aceptados, rechazados, reparos, pendientes. POST /contingencia Sí Manejo de fallas, reintentos y trazabilidad. Mi conclusión práctica
Para comenzar la certificación de factura electrónica, tu API debería estar lista para:
Autenticarse contra SII con certificado digital. Administrar CAF y folios. Generar XML DTE válido según schema SII. Firmar XML correctamente. Timbrar el DTE con TED/PDF417. Enviar EnvioDTE al ambiente de certificación. Consultar estado del envío por TrackId. Consultar estado de DTE individual. Generar muestras impresas. Recibir DTE de terceros y emitir acuse/aceptación/rechazo. Llevar bitácora, respaldo, cuadratura y contingencias.
La brecha más común no está en “llamar endpoints”, sino en firma XML, manejo de CAF/folios, estructura exacta del EnvioDTE, intercambio entre contribuyentes y cuadratura de estados.
Envíame el listado actual de endpoints de tu API y te hago una matriz “cumple / falta / crítico para certificación SII”.