Emitir un DTE ante el SII, a bajo nivel, implica construir un XML según un esquema XSD, firmarlo con un certificado digital, agregar el timbre electrónico PDF417 y enviarlo por el sistema del SII. Hacer todo eso a mano, desde tu aplicación, es semanas de trabajo y una fuente constante de errores.
Una API REST te abstrae de esa complejidad: envías JSON, recibes JSON.
La idea: un solo POST
Con la API de YAMT, emitir cualquier documento —factura, boleta, nota de crédito o guía— es un único POST. El tipo de documento se indica con el campo type. La URL se enruta por el RUT del emisor:
POST https://app.yamt.com/api/{rut}/emitir
Authorization: Bearer yamt_TU_API_KEY
Content-Type: application/json
Un ejemplo real
Así se emite una factura electrónica (tipo 33) con dos ítems:
curl -X POST https://app.yamt.com/api/76123456-7/emitir \
-H "Authorization: Bearer yamt_TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": 33,
"receiver": {
"rut": "12345678-9",
"name": "Comercial Ejemplo Ltda",
"email": "pagos@ejemplo.cl"
},
"items": [
{ "name": "Asesoría mensual", "qty": 1, "price": 150000 },
{ "name": "Hosting", "qty": 12, "price": 8000 }
]
}'
No envías montos calculados: la API toma los ítems, calcula neto, IVA y total, consume un folio del CAF, firma y envía al SII. En la respuesta recibes el folio asignado, el track_id y las URLs del PDF y el XML.
Lo que no tienes que hacer tú
- Nada de SOAP ni XML: trabajas con JSON estándar.
- Nada de certificados en tu servidor: tu
.p12queda custodiado en YAMT y la firma ocurre del lado del servicio. - Nada de cálculo de IVA ni redondeos: la API los resuelve según la norma del SII.
- Nada de gestión de folios manual: se consumen y solicitan automáticamente.
Autenticación y ambientes
La API se autentica con una API key con formato yamt_… en el header Authorization: Bearer. Cada key tiene un rol (owner, editor o viewer) y se revoca cuando quieras desde el panel.
Antes de producción, puedes probar todo en sandbox: si el emisor está en ambiente de prueba, la emisión valida y guarda el documento localmente sin enviarlo al SII. El mismo código funciona luego en producción sin cambios.
Anular, consultar y descargar
Además de emitir, la API permite consultar el estado de un DTE en el SII, listar tus emisiones y descargar el PDF o XML. Para dejar sin efecto un documento no hay un "delete": se emite una nota de crédito que lo referencia, tal como exige el SII.
Siguiente paso
La referencia completa —parámetros, respuesta, tipos de documento y códigos de error— está en la documentación de la API de DTE. Genera tu API key desde el dashboard y emite tu primera factura de prueba en minutos.