OpenFacturaDTE

Descripción

Emite un Documento Tributario Electrónico (DTE) ante el SII de Chile a través de la plataforma OpenFactura (Haulmer). Soporta los tipos de DTE más usados: facturas, facturas exentas, boletas, boletas exentas, guías de despacho y notas de crédito/débito.

El nodo arma el documento con los datos del receptor y el detalle de ítems, y lo envía a OpenFactura, que se encarga de la comunicación con el SII. La respuesta incluye el ID interno del documento en OpenFactura y, cuando corresponde, el trackId asignado por el SII para hacer seguimiento.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial openfactura
dte_type_id	select	No	Tipo de DTE: 33=Factura, 34=Exenta, 39=Boleta, 41=Boleta Exenta, 52=Guía Despacho, 56=Nota Débito, 61=Nota Crédito (default: 33)
receiver	json	Sí	Datos del receptor (objeto)
details	json	Sí	Ítems / detalles (array)
payment_type	select	No	Tipo de pago: 1=Contado, 2=Crédito (default: 1)
issue_date	text	No	Fecha de emisión (YYYY-MM-DD, default: hoy)
global_discount	number	No	Descuento global (%)
reference	json	No	Referencia a otro DTE (objeto), para notas de crédito/débito

Credenciales

Este módulo requiere una credencial de tipo openfactura con los siguientes campos:

• API Key: llave de API de OpenFactura/Haulmer (se envía en el header apikey)
• Entorno: production (ambiente productivo) o cualquier otro valor para usar el ambiente de pruebas (sandbox)

Salida

{
  "success": true,
  "dte_id": "12345",
  "folio": 1042,
  "track_id": "998877",
  "dte_type_id": 33,
  "dte_type": "Factura Electrónica",
  "pdf_url": "https://api.haulmer.com/v2/dte/document/12345/pdf",
  "status": "sent",
  "raw": { ... }
}

Ejemplo de Uso

{
  "credentials_id": "cred-openfactura-prod",
  "dte_type_id": 33,
  "receiver": {
    "code": "76354771-K",
    "name": "Cliente SpA",
    "address": "Av. Providencia 1234",
    "comune": "Providencia",
    "city": "Santiago"
  },
  "details": [
    { "name": "Servicio de consultoría", "quantity": 1, "price": 100000 }
  ],
  "payment_type": 1
}

Notas

• dte_type_id por defecto es 33 (Factura Electrónica); ver la ayuda del nodo para el resto de los códigos válidos.
• receiver y details son obligatorios: sin datos del receptor o al menos un ítem, el nodo termina en error.
• El campo raw conserva la respuesta completa de OpenFactura para debugging.
• El envío no garantiza aceptación inmediata del SII; conviene consultar el estado con OpenFacturaConsulta cuando el DTE quede en trámite.

Nodos Relacionados

• OpenFacturaConsulta - Consultar el estado de un DTE
• OpenFacturaPDF - Descargar el PDF o XML de un DTE