API de emisión de
documentos tributarios

Emisión de DTE vía API

El endpoint POST /api/{rut}/emitir permite emitir cualquier tipo de documento tributario electrónico. YAMT genera el XML, lo firma con tu certificado, añade el timbre PDF417 y lo envía al SII. También puedes usar POST /api/emitir pasando issuer_rut en el body.

Request

• URL: https://app.yamt.com/api/{rut}/emitir
• Método: POST
• Headers: Authorization: Bearer yamt_..., Content-Type: application/json

Parámetros del body

• type (int, requerido) — Código del DTE: 33, 34, 39, 41, 46, 52, 56, 61
• receiver (object, requerido salvo boletas 39/41) — rut, name, activity, address, city, state, email
• items (array, requerido) — Líneas del documento: name, qty, price, discount (opcional), exempt (opcional, booleano)
• refs (array, requerido para notas de crédito/débito 56 y 61) — type, folio, date, reason
• shipping (object, opcional, para guías de despacho 52) — dispatch_type, address, city, state
• date (string, opcional) — Fecha de emisión (por defecto, hoy)
• payment_method (int, opcional) — Forma de pago
• signer_rut (string, opcional) — RUT del firmante, si el emisor tiene más de un certificado

Response

• env — Ambiente del documento: sandbox o live
• document.id — Identificador único del DTE en YAMT
• document.folio — Folio asignado del CAF
• document.amounts — Montos calculados: net, tax, tax_rate, exempt, total
• sii.status — Estado del envío: enviado, aceptado, rechazado (null en sandbox)
• sii.track_id — Track ID del envío al SII
• pdf_url — URL para descargar el PDF con timbre (incluye token tk)
• xml_url — URL para descargar el XML firmado (incluye token tk)

Otros endpoints

• POST /api/{rut}/emision_estado_dte — Consultar estado de un DTE en el SII (body: type, folio)
• GET /api/{rut}/emisiones — Listar emisiones (filtros: tipo_dte, estado, desde, hasta, q)
• GET /api/{rut}/pdf/{type}/{folio} — Descargar PDF con timbre (?download=1 adjunto, ?base64=1 en JSON)
• GET /api/{rut}/xml/{type}/{folio} — Descargar XML firmado
• GET /api/{rut}/folios — Consultar folios CAF disponibles
• POST /api/{rut}/folios_sii — Solicitar nuevos rangos de folios al SII (body: tipo_dte, cantidad)

No existe un endpoint de anulación: para anular, emite una nota de crédito (type: 61) referenciando el documento original en refs.