Boleta afecta (39)

En camino, pendiente de certificación ante el SII. Emisión B2C por el pipeline REST, receptor opcional, IVA incluido en el precio y batch de hasta 1.000 documentos.

En camino: la boleta 39 todavía no se emite con Notta

La Boleta Electrónica afecta está pendiente de certificación ante el SII, así que hoy no puedes emitirla con Notta. Esta página documenta el contrato con el que quedará disponible. Lo que sí emites hoy: factura 33, factura exenta 34, nota de débito 56, nota de crédito 61 y guía de despacho 52.

El tipo_dte 39 es la Boleta Electrónica afecta a IVA, el documento B2C para consumidor final. Esta es la página canónica de campos para boletas: la Boleta exenta (41) documenta solo su delta. Las boletas comparten conceptos con las facturas, pero corren por un pipeline propio (REST del SII en vez de SOAP) con endpoint y recurso propios.

Endpoint propio

Las boletas se emitirán con POST /api/v1/boletas, no con POST /api/v1/dtes. El recurso vive bajo /api/v1/boletas/{id} y el response de emisión trae links solo a self y xml.

Campos del request

Campo	Tipo	Requerido	Descripción / constraint
`tipo_dte`	`number`	sí	`39`
`rut_emisor`	`string`	sí	RUT canónico `BODY-DV` sin puntos (`76123456-0`)
`rut_receptor`	`string`	no	Consumidor anónimo por defecto: si no lo mandas, Notta registra el RUT genérico `66666666-6`
`razon_social_receptor`	`string`	no	Mínimo 1 carácter si lo mandas
`fecha_emision`	`string`	sí	Formato `YYYY-MM-DD`
`items`	`array`	sí	Entre 1 y 60 items, mismo shape que facturas (`nombre`, `cantidad`, `precio_unitario`, `exento`, `monto_item`)
`monto_neto`	`int`	no	Derivado del total si no lo mandas
`iva`	`int`	no	Derivado: `monto_total − monto_neto`
`monto_total`	`int`	no	Default: suma de `monto_item`
`certificate_id`	`string` (UUID)	no	Certificado digital específico; por defecto el activo de la organización
`sii_env`	`"cert" \| "prod"`	no	Default `"cert"`

Dos diferencias clave contra las facturas: no hay objeto receptor (los campos del receptor van planos y opcionales) y no hay references. El IVA va incluido en el precio: monto_total es la suma de los items, y Notta deriva monto_neto = round(total / 1.19) e iva = total − neto.

Request

curl -X POST https://app.notta.cl/api/v1/boletas \
  -H "Authorization: Bearer ntt_cert_..." \
  -H "X-Cert-Id: 01957a91-0b50-7000-8000-cccc00000001" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "tipo_dte": 39,
    "rut_emisor": "76123456-0",
    "fecha_emision": "2026-05-13",
    "items": [{
      "nombre": "Producto mostrador",
      "cantidad": 2,
      "precio_unitario": 5950,
      "exento": false,
      "monto_item": 11900
    }]
  }'

El X-Cert-Id es el id de tu certificado (paso 1 del quickstart o dashboard).

Response

202 Accepted, el pipeline REST firma y sube la boleta en background:

{
  "id": "01957a91-0b50-7000-8000-000000000039",
  "tipo_dte": 39,
  "folio": 8801,
  "status": "queued",
  "sii_status": "queued",
  "rut_emisor": "76123456-0",
  "rut_receptor": "66666666-6",
  "monto_neto": 10000,
  "monto_exento": 0,
  "iva": 1900,
  "monto_total": 11900,
  "fecha_emision": "2026-05-13",
  "sii_env": "cert",
  "links": {
    "self": "/api/v1/boletas/01957a91-0b50-7000-8000-000000000039",
    "xml": "/api/v1/boletas/01957a91-0b50-7000-8000-000000000039/xml"
  }
}

Para seguir el estado, consulta links.self con GET: los estados son los mismos de la familia DTE: ver Estados SII. El XML firmado queda disponible en links.xml apenas el pipeline firma el documento.

Emisión masiva (batch)

Para volúmenes de punto de venta hay POST /api/v1/boletas/batch, que aceptará hasta 1.000 boletas por llamada. El avance se consulta con GET /api/v1/boletas/batch/{id}; el detalle completo está en la referencia API de boletas.

Próximos pasos

Referencia API de boletas: todos los endpoints (list, detalle, XML y batch).
Boleta exenta (41): el delta para ventas y servicios exentos a consumidor final.
Errores: el shape uniforme de error y los códigos específicos de boletas.