webFactura

Documentación de integración

Emitir documentos tributarios electrónicos

La API de webFactura ofrece dos formas de emitir DTE desde tu sistema (POS, ERP, e-commerce, etc.). Ambas usan la misma estructura JSON por documento; cambian la cantidad de documentos por llamada y la forma de recibir el resultado.

Emisión por DTE

POST /api/v3/pos/dte/sendDTEJson.json

Un documento por llamada. Respuesta inmediata con folio y enlace al PDF.

Emisión por Sobre

POST /api/v3/pos/dte/sendSobreDTEJson

Hasta 2000 documentos por llamada. Procesamiento asíncrono: se consulta el resultado con el sobreId.
Emisión por DTE Emisión por Sobre
Documentos por llamada 1 1 a 2000
Resultado En la misma respuesta Se consulta después con el sobreId
Folios Se asignan al emitir Se reservan al recibir el sobre
Uso recomendado Ventas en línea, POS, documentos individuales Facturación masiva, cierres de período, alto volumen
← Documentación general de la API Solicitar credenciales →

01 Autenticación y ambientes

Común a ambas modalidades. OAuth 2.0, grant type client_credentials. Toda solicitud va por HTTPS e incluye el token en el header: 

Authorization: Bearer {access_token}
Content-Type: application/json
Ambiente Host
Sandbox / pruebas https://api-qa.webfactura.cl
Producción https://api.webfactura.cl

Obtención del token

POST {host} /oauth/v2/token
Parámetro Valor
grant_type client_credentials
client_id Entregado por webFactura al habilitar la integración
client_secret Entregado por webFactura al habilitar la integración

Respuesta

{
  "access_token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "expires_in": 86400,
  "token_type": "bearer",
  "scope": "user"
}
Nota: el token dura 24 horas (expires_in en segundos). Las credenciales identifican a la empresa emisora: no se envía ningún identificador de empresa en las llamadas.

Emisión por DTE

Un documento por llamada, respuesta inmediata.

02 Endpoint

Recibe el JSON de un documento, lo valida contra el esquema del SII y lo emite en webFactura. El envío al SII ocurre después, de forma automática.

POST {host} /api/v3/pos/dte/sendDTEJson.json

Tipos de documento aceptados

TipoDTE Documento
33 Factura electrónica
34 Factura no afecta o exenta electrónica
39 Boleta electrónica
41 Boleta exenta electrónica
52 Guía de despacho electrónica
56 Nota de débito electrónica
61 Nota de crédito electrónica
110 Factura de exportación electrónica (productos y servicios)
111 Nota de débito de exportación electrónica
112 Nota de crédito de exportación electrónica

03 Estructura del JSON

El body es un objeto DteSend con un arreglo Dte. En esta modalidad el arreglo lleva un solo documento. Los nombres de los campos siguen el formato del SII. 

{
  "DteSend": {
    "Dte": [
      {
        "Encabezado": {
          "IdDoc":       { ... },   // tipo, folio, fechas, forma de pago
          "Emisor":      { ... },   // tu empresa
          "Receptor":    { ... },   // cliente
          "Transporte":  { ... },   // solo guías y exportación
          "Totales":     { ... },
          "OtraMoneda":  { ... },   // solo exportación
          "Observacion": "..."
        },
        "Detalles":     [ { ... } ],  // líneas del documento
        "DscRcgGlobal": { ... },      // opcional: descuento global
        "Referencias":  [ { ... } ],  // opcional (obligatorio en NC/ND)
        "Adicionales":  { ... }       // opcional: datos libres A1…A7
      }
    ]
  }
}
Importante — el orden de los campos importa. El JSON se convierte a XML y se valida contra el esquema oficial del SII, que exige un orden fijo de elementos. Respeta el mismo orden de los ejemplos (sección 06); un campo correcto en una posición distinta produce un error 422.

04 Campos

Los valores numéricos pueden enviarse como número o como texto. Los campos de guía de despacho, descuentos y exportación se detallan en sus secciones.

Asignación del folio

El campo Folio admite dos formas de trabajo. Elige la que corresponda a tu integración:

webFactura asigna el folio

"Folio": "0"

webFactura toma el siguiente folio disponible de los CAF cargados en tu cuenta y lo informa en la respuesta. Es la opción recomendada: tu sistema no necesita llevar la numeración.

Tu sistema asigna el folio

"Folio": "1250"

Envías el número de folio que lleva tu sistema y el documento se emite con ese número. El folio debe estar dentro de un CAF cargado en webFactura para ese tipo de documento y no haber sido usado antes.

Encabezado.IdDoc — identificación del documento

Campo Requerido Descripción
TipoDTE Sí Código SII del documento (ver tipos aceptados).
Folio Sí Número de folio del documento. Enviar "0" para que webFactura lo asigne automáticamente, o enviar el número de folio que asigna tu sistema. Ver "Asignación del folio" más arriba.
FchEmis Sí Fecha de emisión, formato AAAA-MM-DD. No puede tener más de 10 días de antigüedad.
FmaPago No Forma de pago SII: 1 = Contado, 2 = Crédito, 3 = Sin costo.
TermPagoGlosa No Glosa del término de pago (ej. "Crédito 30 días").
FchVenc No Fecha de vencimiento, formato AAAA-MM-DD.
TipoDespacho Guía (52) Obligatorio en guías de despacho. Ver códigos en "Guía de despacho (52)", más abajo.
IndTraslado Guía (52) Obligatorio en guías de despacho. Ver códigos en "Guía de despacho (52)", más abajo.
IndServicio Exportación En documentos de exportación, "6" indica exportación de servicios; si se omite se trata como exportación de productos.

Encabezado.Emisor

Campo Requerido Descripción
RUTEmisor Sí RUT de la empresa emisora, con guion y dígito verificador. Debe corresponder a la empresa de las credenciales.
RznSoc Sí Razón social del emisor.
GiroEmis Sí Giro del emisor.
Acteco Sí Código de actividad económica SII.
DirOrigen Sí Dirección de origen.
CmnaOrigen Sí Comuna de origen.
CiudadOrigen No Ciudad de origen.
CdgVendedor No Código del vendedor (campo SII, hasta 60 caracteres). Con formato "codigo-nombre" webFactura registra ambos datos; con solo el código, busca el nombre en su maestro de vendedores.

Encabezado.Receptor

Campo Requerido Descripción
RUTRecep Sí RUT del receptor. En exportación, usar 55555555-5.
RznSocRecep Sí Razón social o nombre del receptor.
GiroRecep No Giro del receptor. Si se omite, se informa "SIN INFORMACION".
Contacto No Nombre de contacto.
CorreoRecep No Correo del receptor.
DirRecep No Dirección. Si se omite, se informa "SIN INFORMACION".
CmnaRecep No Comuna. Si se omite, se informa "SIN INFORMACION".
CiudadRecep No Ciudad. Si se omite, se informa "SIN INFORMACION".
CdgIntRecep No Código interno del receptor en tu sistema.
Extranjero Exportación Objeto con Nacionalidad (código de país SII) y opcionalmente NumId.

Encabezado.Totales

Campo Requerido Descripción
MntNeto Afectos Monto neto.
MntExe Sí Monto exento (0 si no aplica).
TasaIVA Afectos Tasa de IVA (19).
IVA Afectos Monto del IVA.
MntTotal Sí Monto total del documento.
ImptoReten No Arreglo de impuestos adicionales: [{ TipoImp, MontoImp }].
TpoMoneda Exportación Moneda del documento (ej. "DOLAR USA").

Detalles[] — líneas del documento

Campo Requerido Descripción
NroLinDet Sí Número de línea, correlativo desde 1.
CdgItem No Objeto { TpoCodigo, VlrCodigo } con el código del producto.
SKUItem No Código/SKU del producto, alternativa simple a CdgItem.
NmbItem Sí Nombre del producto o servicio.
DscItem No Descripción adicional (hasta 1000 caracteres).
QtyItem Sí Cantidad.
UnmdItem No Unidad de medida (ej. "UN").
PrcItem Sí Precio unitario.
DescuentoPct No Porcentaje de descuento del ítem. Ver sección 07.
DescuentoMonto No Monto de descuento del ítem. Ver sección 07.
CodImpAdic No Código SII del impuesto adicional que afecta al ítem.
MontoItem Sí Monto total de la línea.

Referencias[]

Campo Requerido Descripción
NroLinRef Sí Número de la referencia, correlativo desde 1.
TpoDocRef Sí Tipo del documento referenciado. Ver códigos en sección 08.
FolioRef Sí Folio del documento referenciado (numérico o alfanumérico).
FchRef Sí Fecha del documento referenciado, AAAA-MM-DD.
CodRef NC / ND Obligatorio en 56, 61, 111 y 112: 1, 2 o 3. Ver sección 08.
RazonRef NC / ND Motivo de la referencia. Obligatorio en 56, 61, 111 y 112; libre en los demás.

Guía de despacho (52)

Además de los bloques generales, la guía de despacho debe informar en IdDoc el tipo de despacho y el motivo del traslado, y puede incluir los datos del transporte. Ver el ejemplo 52 en la sección 06.

IdDoc.TipoDespacho — obligatorio

1 Despacho por cuenta del receptor
2 Despacho por cuenta del emisor a instalaciones del cliente
3 Despacho por cuenta del emisor a otras instalaciones

IdDoc.IndTraslado — obligatorio

1 Operación constituye venta
2 Ventas por efectuar
3 Consignaciones
4 Entrega gratuita
5 Traslado interno
6 Otros traslados no venta
7 Guía de devolución
8 Traslado para exportación (no venta)
9 Venta para exportación

Encabezado.Transporte — opcional

Datos del transporte, en el orden que exige el esquema del SII.

Campo Requerido Descripción
Patente No Patente del vehículo que transporta los bienes.
PatenteCarro No Patente del carro o remolque (hasta 8 caracteres).
RUTTrans No RUT de la empresa transportista.
Chofer No Objeto con RUTChofer y NombreChofer.
DirDest No Dirección de destino.
CmnaDest No Comuna de destino.
CiudadDest No Ciudad de destino.
FchSalida No Fecha de salida, formato AAAA-MM-DD.
HraSalida No Hora de salida, formato HH:MM:SS.
FchLlegada No Fecha estimada de llegada, formato AAAA-MM-DD. 
"Transporte": {
  "Patente": "ABCD12",
  "PatenteCarro": "JK1234",
  "RUTTrans": "77777777-7",
  "Chofer": {
    "RUTChofer": "11111111-1",
    "NombreChofer": "Pedro Soto"
  },
  "DirDest": "Av. Destino 789",
  "CmnaDest": "Quilicura",
  "CiudadDest": "Santiago",
  "FchSalida": "2026-10-08",
  "HraSalida": "09:30:00",
  "FchLlegada": "2026-10-08"
}

Exportación (110, 111, 112)

Los documentos de exportación usan los bloques generales con estas diferencias:

  • El receptor extranjero se informa con RUTRecep = 55555555-5 y el bloque Extranjero.
  • Los montos van en la moneda de venta (Totales.TpoMoneda) y se convierten a pesos en OtraMoneda.
  • Para exportación de servicios se envía IndServicio = "6" en IdDoc.
  • 111 y 112 deben llevar exactamente una referencia.

Encabezado.Receptor.Extranjero

Campo Requerido Descripción
NumId No Número de identificación del receptor extranjero.
Nacionalidad Sí Código del país del receptor, según tabla de países de Aduana (ej. 336).

Encabezado.Transporte.Aduana

Campo Requerido Descripción
CodModVenta Sí Modalidad de venta, según tabla de Aduana.
CodClauVenta No Cláusula de compraventa (FOB, CIF, etc.), según tabla de Aduana.
CodViaTransp No Vía de transporte, según tabla de Aduana.
CodPtoEmbarque No Puerto de embarque, según tabla de Aduana.
CodPtoDesemb No Puerto de desembarque, según tabla de Aduana.
TotBultos No Cantidad total de bultos.
MntFlete No Monto del flete, en la moneda del documento.
MntSeguro No Monto del seguro, en la moneda del documento.
CodPaisRecep No País del receptor, según tabla de países de Aduana.
CodPaisDestin No País de destino de la mercadería, según tabla de países de Aduana.

Encabezado.Totales (exportación)

Campo Requerido Descripción
TpoMoneda Sí Moneda del documento: "DOLAR USA", "EURO", "PESO CL", "UF" o "UTM".
MntExe Sí Monto exento, en la moneda del documento (admite decimales).
MntTotal Sí Monto total, en la moneda del documento (admite decimales).

Encabezado.OtraMoneda

Campo Requerido Descripción
TpoMoneda Sí Moneda de conversión, normalmente "PESO CL".
TpoCambio Sí Tipo de cambio utilizado.
MntExeOtrMnda Sí Monto exento convertido.
MntTotOtrMnda Sí Monto total convertido. 
"Encabezado": {
  "IdDoc": { "TipoDTE": "110", "Folio": "0", "FchEmis": "2026-10-08", ... },
  "Emisor": { ... },
  "Receptor": {
    "RUTRecep": "55555555-5",
    "RznSocRecep": "Foreign Client Inc.",
    "Extranjero": {
      "Nacionalidad": "336"
    },
    "DirRecep": "1200 Main Street, Miami"
  },
  "Transporte": {
    "Aduana": {
      "CodModVenta": "1",
      "CodClauVenta": "1",
      "CodViaTransp": "10",
      "CodPtoEmbarque": "938",
      "CodPtoDesemb": "173",
      "TotBultos": "1",
      "MntFlete": "1",
      "MntSeguro": "1",
      "CodPaisRecep": "223",
      "CodPaisDestin": "223"
    }
  },
  "Totales": {
    "TpoMoneda": "DOLAR USA",
    "MntExe": "390.00",
    "MntTotal": "390.00"
  },
  "OtraMoneda": {
    "TpoMoneda": "PESO CL",
    "TpoCambio": "810.37",
    "MntExeOtrMnda": "316044",
    "MntTotOtrMnda": "316044"
  }
}

Los ejemplos completos de 110 (productos y servicios), 111 y 112 están en la sección 06.

05 Campos propios de webFactura

Campos opcionales que no forman parte del formato SII. webFactura los usa para vincular el documento con tu sistema y no los incluye en el XML que se envía al SII.

Campo Ubicación Descripción
IdPedido Encabezado.IdDoc Identificador numérico del pedido u orden en tu sistema (entero, máximo 2147483647). Si ya existe un documento del mismo tipo emitido con ese IdPedido, la API no emite otro: responde con el documento existente (mismo folio y PDF). Permite reintentar sin riesgo de emitir dos veces.
Adicionales Dte (mismo nivel que Detalles) Objeto con datos libres A1 … A7 que se guardan con el documento y pueden mostrarse en el PDF. A solicitud se pueden habilitar más datos adicionales o personalizar cómo se muestran en el documento. 
"IdDoc": {
  "TipoDTE": "39",
  "Folio": "0",
  "FchEmis": "2026-10-07",
  "IdPedido": "100245"
},
...
"Adicionales": {
  "A1": "Canal: tienda web",
  "A2": "Despacho: retiro en tienda"
}

06 Ejemplos por tipo de documento

JSON completos listos para probar en sandbox. Reemplaza los datos del emisor por los de tu empresa y usa una fecha de emisión actual.

33 · Factura electrónica Ver JSON + 
{
  "DteSend": {
    "Dte": [
      {
        "Encabezado": {
          "IdDoc": {
            "TipoDTE": "33",
            "Folio": "0",
            "FchEmis": "2026-10-07",
            "FmaPago": "2",
            "TermPagoGlosa": "Credito 30 días",
            "FchVenc": "2026-10-07"
          },
          "Emisor": {
            "RUTEmisor": "76000000-1",
            "RznSoc": "Empresa Emisora SpA",
            "GiroEmis": "Venta de productos y servicios",
            "Acteco": "620200",
            "DirOrigen": "Av. Siempre Viva 123",
            "CmnaOrigen": "Providencia",
            "CiudadOrigen": "Santiago"
          },
          "Receptor": {
            "RUTRecep": "76123456-7",
            "RznSocRecep": "Cliente Ejemplo Ltda",
            "GiroRecep": "Servicios informáticos",
            "Contacto": "Juan Pérez",
            "CorreoRecep": "juan.perez@ejemplo.cl",
            "DirRecep": "Av. Ejemplo 456",
            "CmnaRecep": "Las Condes",
            "CiudadRecep": "Santiago"
          },
          "Totales": {
            "MntNeto": "70000",
            "MntExe": "0",
            "TasaIVA": "19",
            "IVA": "13300",
            "MntTotal": "83300"
          },
          "Observacion": "Observación adicional del documento (hasta 1000 caracteres)"
        },
        "Detalles": [
          {
            "NroLinDet": 1,
            "CdgItem": {
              "TpoCodigo": "INT1",
              "VlrCodigo": "00001"
            },
            "NmbItem": "Servicio Afecto",
            "DscItem": "Descripción adicional del ítem (hasta 1000 caracteres)",
            "QtyItem": "1",
            "UnmdItem": "UN",
            "PrcItem": "30000",
            "MontoItem": "30000"
          },
          {
            "NroLinDet": 2,
            "CdgItem": {
              "TpoCodigo": "INT1",
              "VlrCodigo": "00002"
            },
            "NmbItem": "Servicio Afecto 2",
            "DscItem": "Descripción adicional del ítem (hasta 1000 caracteres)",
            "QtyItem": "1",
            "UnmdItem": "UN",
            "PrcItem": "40000",
            "MontoItem": "40000"
          }
        ],
        "Referencias": [
          {
            "NroLinRef": "1",
            "TpoDocRef": "801",
            "FolioRef": "12346",
            "FchRef": "2026-10-07",
            "RazonRef": "orden de compra"
          }
        ],
        "Adicionales": {
          "A1": "Dato Adicional 1",
          "A2": "Dato Adicional 2",
          "A3": "Dato Adicional 3",
          "A4": "Dato Adicional 4",
          "A5": "Dato Adicional 5",
          "A6": "Dato Adicional 6",
          "A7": "Dato Adicional 7"
        }
      }
    ]
  }
}
34 · Factura exenta electrónica Ver JSON + 
{
  "DteSend": {
    "Dte": [
      {
        "Encabezado": {
          "IdDoc": {
            "TipoDTE": "34",
            "Folio": "0",
            "FchEmis": "2026-10-07",
            "FmaPago": "2",
            "FchVenc": "2026-10-07"
          },
          "Emisor": {
            "RUTEmisor": "76000000-1",
            "RznSoc": "Empresa Emisora SpA",
            "GiroEmis": "Venta de productos y servicios",
            "Acteco": "620200",
            "DirOrigen": "Av. Siempre Viva 123",
            "CmnaOrigen": "Providencia",
            "CiudadOrigen": "Santiago"
          },
          "Receptor": {
            "RUTRecep": "76123456-7",
            "RznSocRecep": "Cliente Ejemplo Ltda",
            "GiroRecep": "Servicios informáticos",
            "Contacto": "Juan Pérez",
            "CorreoRecep": "juan.perez@ejemplo.cl",
            "DirRecep": "Av. Ejemplo 456",
            "CmnaRecep": "Las Condes",
            "CiudadRecep": "Santiago"
          },
          "Totales": {
            "MntExe": "70000",
            "MntTotal": "70000"
          },
          "Observacion": "Observación adicional del documento (hasta 1000 caracteres)"
        },
        "Detalles": [
          {
            "NroLinDet": "1",
            "CdgItem": {
              "TpoCodigo": "INT1",
              "VlrCodigo": "00001"
            },
            "IndExe": "1",
            "NmbItem": "Servicio Exento",
            "DscItem": "Descripción adicional del ítem (hasta 1000 caracteres)",
            "QtyItem": "1",
            "UnmdItem": "UN",
            "PrcItem": "30000",
            "MontoItem": "30000"
          },
          {
            "NroLinDet": "2",
            "CdgItem": {
              "TpoCodigo": "INT1",
              "VlrCodigo": "00001"
            },
            "IndExe": "1",
            "NmbItem": "Servicio Exento 2",
            "DscItem": "Descripción adicional del ítem (hasta 1000 caracteres)",
            "QtyItem": "1",
            "UnmdItem": "UN",
            "PrcItem": "40000",
            "MontoItem": "40000"
          }
        ],
        "Referencias": [
          {
            "NroLinRef": "1",
            "TpoDocRef": "801",
            "FolioRef": "12346",
            "FchRef": "2026-10-07",
            "RazonRef": "orden de compra"
          },
          {
            "NroLinRef": "2",
            "TpoDocRef": "801",
            "FolioRef": "123467",
            "FchRef": "2026-10-07",
            "RazonRef": "orden de compra"
          },
          {
            "NroLinRef": "3",
            "TpoDocRef": "801",
            "FolioRef": "1234678",
            "FchRef": "2026-10-07",
            "RazonRef": "orden de compra"
          }
        ],
        "Adicionales": {
          "A1": "Dato Adicional 1",
          "A2": "Dato Adicional 2",
          "A3": "Dato Adicional 3",
          "A4": "Dato Adicional 4",
          "A5": "Dato Adicional 5",
          "A6": "Dato Adicional 6",
          "A7": "Dato Adicional 7"
        }
      }
    ]
  }
}
39 · Boleta electrónica Ver JSON + 
{
  "DteSend": {
    "Dte": [
      {
        "Encabezado": {
          "IdDoc": {
            "TipoDTE": "39",
            "Folio": "0",
            "FchEmis": "2026-10-07",
            "FmaPago": "1",
            "TermPagoGlosa": "Efectivo"
          },
          "Emisor": {
            "RUTEmisor": "76000000-1",
            "RznSoc": "Empresa Emisora SpA",
            "GiroEmis": "Venta de productos y servicios",
            "Acteco": "620200",
            "DirOrigen": "Av. Siempre Viva 123",
            "CmnaOrigen": "Providencia",
            "CiudadOrigen": "Santiago"
          },
          "Receptor": {
            "RUTRecep": "76123456-7",
            "RznSocRecep": "Cliente Ejemplo Ltda",
            "GiroRecep": "Servicios informáticos",
            "Contacto": "Juan Pérez",
            "CorreoRecep": "juan.perez@ejemplo.cl",
            "DirRecep": "Av. Ejemplo 456",
            "CmnaRecep": "Las Condes",
            "CiudadRecep": "Santiago"
          },
          "Totales": {
            "MntNeto": "70000",
            "MntExe": "0",
            "TasaIVA": "19",
            "IVA": "13300",
            "MntTotal": "83300"
          },
          "Observacion": "Observación adicional del documento (hasta 1000 caracteres)"
        },
        "Detalles": [
          {
            "NroLinDet": "1",
            "NmbItem": "Servicio Afecto",
            "DscItem": "Descripción adicional del ítem (hasta 1000 caracteres)",
            "QtyItem": "1",
            "UnmdItem": "UN",
            "PrcItem": "30000",
            "MontoItem": "30000"
          },
          {
            "NroLinDet": "2",
            "NmbItem": "Servicio Afecto 2",
            "DscItem": "Descripción adicional del ítem (hasta 1000 caracteres)",
            "QtyItem": "1",
            "UnmdItem": "UN",
            "PrcItem": "40000",
            "MontoItem": "40000"
          }
        ],
        "Adicionales": {
          "A1": "Dato Adicional 1",
          "A2": "Dato Adicional 2",
          "A3": "Dato Adicional 3",
          "A4": "Dato Adicional 4",
          "A5": "Dato Adicional 5",
          "A6": "Dato Adicional 6",
          "A7": "Dato Adicional 7"
        }
      }
    ]
  }
}
41 · Boleta exenta electrónica Ver JSON + 
{
  "DteSend": {
    "Dte": [
      {
        "Encabezado": {
          "IdDoc": {
            "TipoDTE": "41",
            "Folio": "0",
            "FchEmis": "2026-10-07",
            "FmaPago": "1",
            "TermPagoGlosa": "Efectivo"
          },
          "Emisor": {
            "RUTEmisor": "76000000-1",
            "RznSoc": "Empresa Emisora SpA",
            "GiroEmis": "Venta de productos y servicios",
            "Acteco": "620200",
            "DirOrigen": "Av. Siempre Viva 123",
            "CmnaOrigen": "Providencia",
            "CiudadOrigen": "Santiago"
          },
          "Receptor": {
            "RUTRecep": "76123456-7",
            "RznSocRecep": "Cliente Ejemplo Ltda",
            "GiroRecep": "Servicios informáticos",
            "Contacto": "Juan Pérez",
            "CorreoRecep": "juan.perez@ejemplo.cl",
            "DirRecep": "Av. Ejemplo 456",
            "CmnaRecep": "Las Condes",
            "CiudadRecep": "Santiago"
          },
          "Totales": {
            "MntExe": "70000",
            "MntTotal": "70000"
          },
          "Observacion": "Observación adicional del documento (hasta 1000 caracteres)"
        },
        "Detalles": [
          {
            "NroLinDet": "1",
            "CdgItem": {
              "TpoCodigo": "INT1",
              "VlrCodigo": "00001"
            },
            "IndExe": "1",
            "NmbItem": "Servicio Exento",
            "DscItem": "Descripción adicional del ítem (hasta 1000 caracteres)",
            "QtyItem": "1",
            "UnmdItem": "UN",
            "PrcItem": "30000",
            "MontoItem": "30000"
          },
          {
            "NroLinDet": "2",
            "CdgItem": {
              "TpoCodigo": "INT1",
              "VlrCodigo": "00001"
            },
            "IndExe": "1",
            "NmbItem": "Servicio Exento 2",
            "DscItem": "Descripción adicional del ítem (hasta 1000 caracteres)",
            "QtyItem": "1",
            "UnmdItem": "UN",
            "PrcItem": "40000",
            "MontoItem": "40000"
          }
        ],
        "Adicionales": {
          "A1": "Dato Adicional 1",
          "A2": "Dato Adicional 2",
          "A3": "Dato Adicional 3",
          "A4": "Dato Adicional 4",
          "A5": "Dato Adicional 5",
          "A6": "Dato Adicional 6",
          "A7": "Dato Adicional 7"
        }
      }
    ]
  }
}
52 · Guía de despacho (con Transporte) Ver JSON + 
{
  "DteSend": {
    "Dte": [
      {
        "Encabezado": {
          "IdDoc": {
            "TipoDTE": "52",
            "Folio": "0",
            "FchEmis": "2026-10-07",
            "TipoDespacho": "3",
            "IndTraslado": "3",
            "FmaPago": "1",
            "TermPagoGlosa": "Efectivo",
            "FchVenc": "2026-10-07"
          },
          "Emisor": {
            "RUTEmisor": "76000000-1",
            "RznSoc": "Empresa Emisora SpA",
            "GiroEmis": "Venta de productos y servicios",
            "Acteco": "620200",
            "DirOrigen": "Av. Siempre Viva 123",
            "CmnaOrigen": "Providencia",
            "CiudadOrigen": "Santiago"
          },
          "Receptor": {
            "RUTRecep": "76123456-7",
            "RznSocRecep": "Cliente Ejemplo Ltda",
            "GiroRecep": "Servicios informáticos",
            "Contacto": "Juan Pérez",
            "CorreoRecep": "juan.perez@ejemplo.cl",
            "DirRecep": "Av. Ejemplo 456",
            "CmnaRecep": "Las Condes",
            "CiudadRecep": "Santiago"
          },
          "Transporte": {
            "Patente": "ABCD12",
            "Chofer": {
              "RUTChofer": "11111111-1",
              "NombreChofer": "Nombre Chofer"
            },
            "DirDest": "Destino",
            "CmnaDest": "comuna",
            "CiudadDest": "ciudad"
          },
          "Totales": {
            "MntNeto": "70000",
            "MntExe": "0",
            "TasaIVA": "19",
            "IVA": "13300",
            "MntTotal": "83300"
          },
          "Observacion": "Observación adicional del documento (hasta 1000 caracteres)"
        },
        "Detalles": [
          {
            "NroLinDet": "1",
            "CdgItem": {
              "TpoCodigo": "INT1",
              "VlrCodigo": "00001"
            },
            "NmbItem": "Servicio Afecto",
            "DscItem": "Descripción adicional del ítem (hasta 1000 caracteres)",
            "QtyItem": "1",
            "UnmdItem": "UN",
            "PrcItem": "30000",
            "MontoItem": "30000"
          },
          {
            "NroLinDet": "2",
            "CdgItem": {
              "TpoCodigo": "INT1",
              "VlrCodigo": "00002"
            },
            "NmbItem": "Servicio Afecto 2",
            "DscItem": "Descripción adicional del ítem (hasta 1000 caracteres)",
            "QtyItem": "1",
            "UnmdItem": "UN",
            "PrcItem": "40000",
            "MontoItem": "40000"
          }
        ],
        "Referencias": [
          {
            "NroLinRef": "1",
            "TpoDocRef": "110",
            "FolioRef": "12346",
            "FchRef": "2026-10-07",
            "RazonRef": "Factura exportacion"
          },
          {
            "NroLinRef": "2",
            "TpoDocRef": "801",
            "FolioRef": "123467",
            "FchRef": "2026-10-07",
            "RazonRef": "Orden de compra"
          }
        ],
        "Adicionales": {
          "A1": "Dato Adicional 1",
          "A2": "Dato Adicional 2",
          "A3": "Dato Adicional 3",
          "A4": "Dato Adicional 4",
          "A5": "Dato Adicional 5",
          "A6": "Dato Adicional 6",
          "A7": "Dato Adicional 7"
        }
      }
    ]
  }
}
56 · Nota de débito Ver JSON + 
{
  "DteSend": {
    "Dte": [
      {
        "Encabezado": {
          "IdDoc": {
            "TipoDTE": "56",
            "Folio": "0",
            "FchEmis": "2026-10-07",
            "FmaPago": "1",
            "TermPagoGlosa": "Efectivo",
            "FchVenc": "2026-10-07"
          },
          "Emisor": {
            "RUTEmisor": "76000000-1",
            "RznSoc": "Empresa Emisora SpA",
            "GiroEmis": "Venta de productos y servicios",
            "Acteco": "620200",
            "DirOrigen": "Av. Siempre Viva 123",
            "CmnaOrigen": "Providencia",
            "CiudadOrigen": "Santiago"
          },
          "Receptor": {
            "RUTRecep": "76123456-7",
            "RznSocRecep": "Cliente Ejemplo Ltda",
            "GiroRecep": "Servicios informáticos",
            "Contacto": "Juan Pérez",
            "CorreoRecep": "juan.perez@ejemplo.cl",
            "DirRecep": "Av. Ejemplo 456",
            "CmnaRecep": "Las Condes",
            "CiudadRecep": "Santiago"
          },
          "Totales": {
            "MntExe": "70000",
            "MntTotal": "70000"
          },
          "Observacion": "Observación adicional del documento (hasta 1000 caracteres)"
        },
        "Detalles": [
          {
            "NroLinDet": "1",
            "CdgItem": {
              "TpoCodigo": "INT1",
              "VlrCodigo": "00001"
            },
            "IndExe": "1",
            "NmbItem": "Servicio Exento",
            "DscItem": "Descripción adicional del ítem (hasta 1000 caracteres)",
            "QtyItem": "1",
            "UnmdItem": "UN",
            "PrcItem": "30000",
            "MontoItem": "30000"
          },
          {
            "NroLinDet": "2",
            "CdgItem": {
              "TpoCodigo": "INT1",
              "VlrCodigo": "00002"
            },
            "IndExe": "1",
            "NmbItem": "Servicio Exento 2",
            "DscItem": "Descripción adicional del ítem (hasta 1000 caracteres)",
            "QtyItem": "1",
            "UnmdItem": "UN",
            "PrcItem": "40000",
            "MontoItem": "40000"
          }
        ],
        "Referencias": [
          {
            "NroLinRef": "1",
            "TpoDocRef": "34",
            "FolioRef": "1467",
            "FchRef": "2026-10-07",
            "CodRef": "1",
            "RazonRef": "Anula Documento Referencia"
          }
        ],
        "Adicionales": {
          "A1": "Dato Adicional 1",
          "A2": "Dato Adicional 2",
          "A3": "Dato Adicional 3",
          "A4": "Dato Adicional 4",
          "A5": "Dato Adicional 5",
          "A6": "Dato Adicional 6",
          "A7": "Dato Adicional 7"
        }
      }
    ]
  }
}
61 · Nota de crédito Ver JSON + 
{
  "DteSend": {
    "Dte": [
      {
        "Encabezado": {
          "IdDoc": {
            "TipoDTE": "61",
            "Folio": "0",
            "FchEmis": "2026-10-07"
          },
          "Emisor": {
            "RUTEmisor": "76000000-1",
            "RznSoc": "Empresa Emisora SpA",
            "GiroEmis": "Venta de productos y servicios",
            "Acteco": "620200",
            "DirOrigen": "Av. Siempre Viva 123",
            "CmnaOrigen": "Providencia",
            "CiudadOrigen": "Santiago"
          },
          "Receptor": {
            "RUTRecep": "76123456-7",
            "RznSocRecep": "Cliente Ejemplo Ltda",
            "GiroRecep": "Servicios informáticos",
            "Contacto": "Juan Pérez",
            "CorreoRecep": "juan.perez@ejemplo.cl",
            "DirRecep": "Av. Ejemplo 456",
            "CmnaRecep": "Las Condes",
            "CiudadRecep": "Santiago"
          },
          "Totales": {
            "MntNeto": "70000",
            "MntExe": "0",
            "TasaIVA": "19",
            "IVA": "13300",
            "MntTotal": "83300"
          },
          "Observacion": "Observación adicional del documento (hasta 1000 caracteres)"
        },
        "Detalles": [
          {
            "NroLinDet": "1",
            "NmbItem": "Servicio Afecto",
            "DscItem": "Descripción adicional del ítem (hasta 1000 caracteres)",
            "QtyItem": "1",
            "UnmdItem": "UN",
            "PrcItem": "30000",
            "MontoItem": "30000"
          },
          {
            "NroLinDet": "2",
            "NmbItem": "Servicio Afecto 2",
            "DscItem": "Descripción adicional del ítem (hasta 1000 caracteres)",
            "QtyItem": "1",
            "UnmdItem": "UN",
            "PrcItem": "40000",
            "MontoItem": "40000"
          }
        ],
        "Referencias": [
          {
            "NroLinRef": "1",
            "TpoDocRef": "33",
            "FolioRef": "12346",
            "FchRef": "2026-10-07",
            "CodRef": "1",
            "RazonRef": "Anula Documento Referencia"
          }
        ],
        "Adicionales": {
          "A1": "Dato Adicional 1",
          "A2": "Dato Adicional 2",
          "A3": "Dato Adicional 3",
          "A4": "Dato Adicional 4",
          "A5": "Dato Adicional 5",
          "A6": "Dato Adicional 6",
          "A7": "Dato Adicional 7"
        }
      }
    ]
  }
}
110 · Factura de exportación — productos Ver JSON + 
{
  "DteSend": {
    "Dte": [
      {
        "Encabezado": {
          "IdDoc": {
            "TipoDTE": "110",
            "Folio": "0",
            "FchEmis": "2026-10-07",
            "FmaPago": "2",
            "TermPagoGlosa": "Credito 40 dias",
            "FchVenc": "2026-10-07"
          },
          "Emisor": {
            "RUTEmisor": "76000000-1",
            "RznSoc": "Empresa Emisora SpA",
            "GiroEmis": "Venta de productos y servicios",
            "Acteco": "620200",
            "DirOrigen": "Av. Siempre Viva 123",
            "CmnaOrigen": "Providencia",
            "CiudadOrigen": "Santiago"
          },
          "Receptor": {
            "RUTRecep": "55555555-5",
            "RznSocRecep": "Cliente Ejemplo Ltda",
            "Extranjero": {
              "Nacionalidad": "336"
            },
            "Contacto": "Juan Pérez",
            "CorreoRecep": "juan.perez@ejemplo.cl",
            "DirRecep": "Av. Ejemplo 456"
          },
          "Transporte": {
            "Aduana": {
              "CodModVenta": "1",
              "CodClauVenta": "1",
              "CodViaTransp": "10",
              "CodPtoEmbarque": "938",
              "CodPtoDesemb": "173",
              "TotBultos": "1",
              "MntFlete": "1",
              "MntSeguro": "1",
              "CodPaisRecep": "223",
              "CodPaisDestin": "223"
            }
          },
          "Totales": {
            "TpoMoneda": "DOLAR USA",
            "MntExe": "390.00",
            "MntTotal": "390.00"
          },
          "OtraMoneda": {
            "TpoMoneda": "PESO CL",
            "TpoCambio": "810.370000",
            "MntExeOtrMnda": "316044",
            "MntTotOtrMnda": "316044"
          }
        },
        "Detalles": [
          {
            "NroLinDet": "1",
            "CdgItem": {
              "TpoCodigo": "INT1",
              "VlrCodigo": "00001"
            },
            "NmbItem": "SERVICIO DE TRANSPORTE",
            "QtyItem": "1",
            "PrcItem": "390.00",
            "MontoItem": "390.00"
          }
        ],
        "Adicionales": {
          "A1": "Dato Adicional 1",
          "A2": "Dato Adicional 2",
          "A3": "Dato Adicional 3",
          "A4": "Dato Adicional 4",
          "A5": "Dato Adicional 5",
          "A6": "Dato Adicional 6",
          "A7": "Dato Adicional 7"
        }
      }
    ]
  }
}
110 · Factura de exportación — servicios Ver JSON + 
{
  "DteSend": {
    "Dte": [
      {
        "Encabezado": {
          "IdDoc": {
            "TipoDTE": "110",
            "Folio": "0",
            "FchEmis": "2026-10-07",
            "IndServicio": "6",
            "FmaPago": "2",
            "TermPagoGlosa": "Credito 40 dias",
            "FchVenc": "2026-10-07"
          },
          "Emisor": {
            "RUTEmisor": "76000000-1",
            "RznSoc": "Empresa Emisora SpA",
            "GiroEmis": "Venta de productos y servicios",
            "Acteco": "620200",
            "DirOrigen": "Av. Siempre Viva 123",
            "CmnaOrigen": "Providencia",
            "CiudadOrigen": "Santiago"
          },
          "Receptor": {
            "RUTRecep": "55555555-5",
            "RznSocRecep": "Cliente Ejemplo Ltda",
            "Extranjero": {
              "NumId": "11111111-1",
              "Nacionalidad": "336"
            },
            "Contacto": "Juan Pérez",
            "CorreoRecep": "juan.perez@ejemplo.cl",
            "DirRecep": "Av. Ejemplo 456"
          },
          "Transporte": {
            "Aduana": {
              "CodModVenta": "1",
              "CodClauVenta": "1"
            }
          },
          "Totales": {
            "TpoMoneda": "DOLAR USA",
            "MntExe": "390.00",
            "MntTotal": "390.00"
          },
          "OtraMoneda": {
            "TpoMoneda": "PESO CL",
            "TpoCambio": "810.370000",
            "MntExeOtrMnda": "316044",
            "MntTotOtrMnda": "316044"
          }
        },
        "Detalles": [
          {
            "NroLinDet": "1",
            "CdgItem": {
              "TpoCodigo": "INT1",
              "VlrCodigo": "00001"
            },
            "NmbItem": "SERVICIO DE TRANSPORTE",
            "QtyItem": "1",
            "PrcItem": "390.00",
            "MontoItem": "390.00"
          }
        ],
        "Adicionales": {
          "A1": "Dato Adicional 1",
          "A2": "Dato Adicional 2",
          "A3": "Dato Adicional 3",
          "A4": "Dato Adicional 4",
          "A5": "Dato Adicional 5",
          "A6": "Dato Adicional 6",
          "A7": "Dato Adicional 7"
        }
      }
    ]
  }
}
111 · Nota de débito de exportación Ver JSON + 
{
  "DteSend": {
    "Dte": [
      {
        "Encabezado": {
          "IdDoc": {
            "TipoDTE": "111",
            "Folio": "0",
            "FchEmis": "2026-10-07",
            "IndServicio": "6",
            "FmaPago": "2",
            "TermPagoGlosa": "Credito 40 dias",
            "FchVenc": "2026-10-07"
          },
          "Emisor": {
            "RUTEmisor": "76000000-1",
            "RznSoc": "Empresa Emisora SpA",
            "GiroEmis": "Venta de productos y servicios",
            "Acteco": "620200",
            "DirOrigen": "Av. Siempre Viva 123",
            "CmnaOrigen": "Providencia",
            "CiudadOrigen": "Santiago"
          },
          "Receptor": {
            "RUTRecep": "55555555-5",
            "RznSocRecep": "Cliente Ejemplo Ltda",
            "Extranjero": {
              "Nacionalidad": "336"
            },
            "Contacto": "Juan Pérez",
            "CorreoRecep": "juan.perez@ejemplo.cl",
            "DirRecep": "Av. Ejemplo 456"
          },
          "Transporte": {
            "Aduana": {
              "CodModVenta": "1",
              "CodClauVenta": "1",
              "CodViaTransp": "10",
              "CodPtoEmbarque": "1",
              "CodPtoDesemb": "1",
              "TotBultos": "1",
              "MntFlete": "1",
              "MntSeguro": "1",
              "CodPaisRecep": "223",
              "CodPaisDestin": "223"
            }
          },
          "Totales": {
            "TpoMoneda": "DOLAR USA",
            "MntExe": "390.00",
            "MntTotal": "390.00"
          },
          "OtraMoneda": {
            "TpoMoneda": "PESO CL",
            "TpoCambio": "810.370000",
            "MntExeOtrMnda": "316044",
            "MntTotOtrMnda": "316044"
          }
        },
        "Detalles": [
          {
            "NroLinDet": "1",
            "CdgItem": {
              "TpoCodigo": "INT1",
              "VlrCodigo": "00001"
            },
            "NmbItem": "SERVICIO DE TRANSPORTE",
            "QtyItem": "1",
            "PrcItem": "390.00",
            "MontoItem": "390.00"
          }
        ],
        "Referencias": [
          {
            "NroLinRef": "1",
            "TpoDocRef": "110",
            "FolioRef": "12346",
            "FchRef": "2026-10-07",
            "CodRef": "1",
            "RazonRef": "Anula Documento Referencia"
          }
        ],
        "Adicionales": {
          "A1": "Dato Adicional 1",
          "A2": "Dato Adicional 2",
          "A3": "Dato Adicional 3",
          "A4": "Dato Adicional 4",
          "A5": "Dato Adicional 5",
          "A6": "Dato Adicional 6",
          "A7": "Dato Adicional 7"
        }
      }
    ]
  }
}
112 · Nota de crédito de exportación Ver JSON + 
{
  "DteSend": {
    "Dte": [
      {
        "Encabezado": {
          "IdDoc": {
            "TipoDTE": "112",
            "Folio": "0",
            "FchEmis": "2026-10-07",
            "IndServicio": "6",
            "FmaPago": "2",
            "TermPagoGlosa": "Credito 40 dias",
            "FchVenc": "2026-10-07"
          },
          "Emisor": {
            "RUTEmisor": "76000000-1",
            "RznSoc": "Empresa Emisora SpA",
            "GiroEmis": "Venta de productos y servicios",
            "Acteco": "620200",
            "DirOrigen": "Av. Siempre Viva 123",
            "CmnaOrigen": "Providencia",
            "CiudadOrigen": "Santiago"
          },
          "Receptor": {
            "RUTRecep": "55555555-5",
            "RznSocRecep": "Cliente Ejemplo Ltda",
            "Extranjero": {
              "Nacionalidad": "336"
            },
            "Contacto": "Juan Pérez",
            "CorreoRecep": "juan.perez@ejemplo.cl",
            "DirRecep": "Av. Ejemplo 456"
          },
          "Transporte": {
            "Aduana": {
              "CodModVenta": "1",
              "CodClauVenta": "1",
              "CodViaTransp": "10",
              "CodPtoEmbarque": "1",
              "CodPtoDesemb": "1",
              "TotBultos": "1",
              "MntFlete": "1",
              "MntSeguro": "1",
              "CodPaisRecep": "223",
              "CodPaisDestin": "223"
            }
          },
          "Totales": {
            "TpoMoneda": "DOLAR USA",
            "MntExe": "390.00",
            "MntTotal": "390.00"
          },
          "OtraMoneda": {
            "TpoMoneda": "PESO CL",
            "TpoCambio": "810.370000",
            "MntExeOtrMnda": "316044",
            "MntTotOtrMnda": "316044"
          }
        },
        "Detalles": [
          {
            "NroLinDet": "1",
            "CdgItem": {
              "TpoCodigo": "INT1",
              "VlrCodigo": "00001"
            },
            "NmbItem": "SERVICIO DE TRANSPORTE",
            "QtyItem": "1",
            "PrcItem": "390.00",
            "MontoItem": "390.00"
          }
        ],
        "Referencias": [
          {
            "NroLinRef": "1",
            "TpoDocRef": "110",
            "FolioRef": "12346",
            "FchRef": "2026-10-07",
            "CodRef": "1",
            "RazonRef": "Anula Documento Referencia"
          }
        ],
        "Adicionales": {
          "A1": "Dato Adicional 1",
          "A2": "Dato Adicional 2",
          "A3": "Dato Adicional 3",
          "A4": "Dato Adicional 4",
          "A5": "Dato Adicional 5",
          "A6": "Dato Adicional 6",
          "A7": "Dato Adicional 7"
        }
      }
    ]
  }
}

07 Descuentos

Descuento global — DscRcgGlobal

Se agrega al mismo nivel que Detalles. ValorDR es el monto neto del descuento, y en Totales el MntNeto se informa con el descuento ya aplicado. 

"DscRcgGlobal": {
  "NroLinDR": 1,
  "TpoMov": "D",
  "GlosaDR": "Descto.",
  "TpoValor": "$",
  "ValorDR": 420
}

Cálculo — ejemplo

Boleta con un ítem de $2.000 (con IVA) y descuento de $500 sobre el total:

1. % de descuento (500 × 100) / 2.000 25 %
2. Factor IVA 1 + (19 / 100) 1,19
3. Neto antes del descuento 2.000 / 1,19 ≈ 1.681
4. ValorDR 1.681 × 25 % ≈ 420
5. MntNeto 1.681 − 420 ≈ 1.261
6. IVA 1.500 − 1.261 239 
"Totales": {
  "MntNeto": 1261,
  "MntExe": 0,
  "TasaIVA": 19,
  "IVA": 239,
  "MntTotal": 1500
}

Descuento por ítem — DescuentoPct / DescuentoMonto

Se agregan en la línea de Detalles. DescuentoMonto es el monto neto del descuento y MontoItem es el monto final de la línea con el descuento aplicado. Ejemplo: boleta con 2 unidades de $10.000 (con IVA) y 25 % de descuento en la línea:

1. Monto bruto de la línea 2 × 10.000 20.000
2. Neto de la línea 20.000 / 1,19 ≈ 16.807
3. DescuentoMonto 16.807 × 25 % ≈ 4.202
4. Descuento bruto 20.000 × 25 % 5.000
5. MontoItem final 20.000 − 5.000 15.000 
"Detalles": [
  {
    "NroLinDet": 1,
    "CdgItem": { "TpoCodigo": "INT1", "VlrCodigo": "PROD001" },
    "NmbItem": "Producto de ejemplo",
    "QtyItem": 2,
    "UnmdItem": "UN",
    "PrcItem": 10000,
    "DescuentoPct": 25,
    "DescuentoMonto": 4202,
    "MontoItem": 15000
  }
],
...
"Totales": {
  "MntNeto": 12605,
  "MntExe": 0,
  "TasaIVA": 19,
  "IVA": 2395,
  "MntTotal": 15000
}

08 Referencias

Referencias indica a qué otros documentos se refiere el que se emite (orden de compra, factura original, cotización, etc.). Se pueden enviar varias, numeradas desde 1. En documentos generales RazonRef es libre. 

"Referencias": [
  { "NroLinRef": "1", "TpoDocRef": "801", "FolioRef": "12346", "FchRef": "2026-10-01", "RazonRef": "Orden de compra" },
  { "NroLinRef": "2", "TpoDocRef": "COT", "FolioRef": "558",   "FchRef": "2026-09-28", "RazonRef": "Cotización" }
]

Notas de crédito y débito (56, 61, 111, 112)

Deben llevar al menos una referencia (111 y 112: exactamente una) al documento que modifican, con CodRef y RazonRef:

CodRef RazonRef
1 Anula documento de referencia
2 Corrige texto del documento de referencia
3 Corrige montos del documento de referencia 
"Referencias": [
  {
    "NroLinRef": "1",
    "TpoDocRef": "33",
    "FolioRef": "12346",
    "FchRef": "2026-10-01",
    "CodRef": "1",
    "RazonRef": "Anula documento de referencia"
  }
]

TpoDocRef — más usados

33 Factura electrónica
34 Factura exenta electrónica
39 Boleta electrónica
41 Boleta exenta electrónica
52 Guía de despacho electrónica
56 Nota de débito electrónica
61 Nota de crédito electrónica
110 Factura de exportación electrónica
30 Factura manual
32 Factura exenta manual
50 Guía de despacho manual
801 Orden de compra
802 Nota de pedido
803 Contrato
804 Resolución
HES Hoja de entrada de servicio
HAS Hoja de aceptación de servicio
ODS Orden de servicio
COT Cotización
NTV Nota de venta

09 Respuesta

Documento emitido correctamente. "DTE RECIBIDO OK" significa que el documento quedó emitido en webFactura; el envío al SII y su aceptación ocurren después. El estado ante el SII se consulta con getDocumentsFiltered (campo EstadoSII).

Éxito 
{
  "code": "200",
  "message": "OK",
  "DocumentoDTE": {
    "TipoDTE": "33",
    "Folio": 1234,
    "EstadoDTE": "0",
    "GlosaEstadoDTE": "DTE RECIBIDO OK",
    "PDFUrl": "https://{host_pdf}/pdf/{token}",
    "PDFUrlTimbre": "https://{host_pdf}/pdf/{token}/2"
  }
}
Folio Folio asignado al documento.
PDFUrl Enlace público al PDF del documento.
PDFUrlTimbre Enlace público a la imagen del timbre electrónico.
Nota: usa las URL tal como llegan en la respuesta, sin reconstruir el dominio. Si envías IdPedido y ese pedido ya tiene un documento del mismo tipo, la respuesta es la misma estructura con los datos del documento existente.

10 Errores

Importante: salvo los errores de autenticación, este endpoint responde siempre con HTTP 200 e informa el resultado en el campo code del body. Considera exitosa la emisión solo si code es "200" y la respuesta trae DocumentoDTE.
code Situación Respuesta
401 Token ausente, inválido o expirado (HTTP real) invalid_token / access_denied (OAuth2)
422 El documento no cumple el esquema XML del SII (campo faltante, valor inválido u orden incorrecto) {"code": 422, "status": "ERR", "message": {"errores": [...]}}
400 Validación por tipo de documento (ej. guía sin TipoDespacho, NC/ND sin referencia, 111/112 con más de una referencia, exportación sin CodModVenta) {"code": 400, "status": "ERR", "message": "Debe Incluir al menos una referencia"}
400 Fecha de emisión con formato inválido o con más de 10 días de antigüedad {"code": 400, "status": "ERR", "message": "La Fecha de Emisión (...) supera los 10 días de antigüedad permitidos."}
400 Datos faltantes o inválidos en Referencias {"code": 400, "status": "ERR", "mesage": {"ref": {"0": {"error": "Debe incluir el dato FchRef."}}}}
489 El RUT emisor no corresponde a la empresa de las credenciales {"code": 489, "status": "ERR", "mesage": "Los datos del emisor no corresponden a su empresa"}
400 El folio enviado por tu sistema ya fue usado en otro documento del mismo tipo {"code": 400, "message": "Error: Folio ya existe"}
400 Otra emisión de la misma empresa está en curso — reintentar en unos segundos {"code": 400, "message": "El proceso para emitir documentos se encuentra actualmente en uso, intente nuevamente en unos segundos"}
500 Error interno al procesar el documento {"code": "500", "message": "..."}

En los errores de referencias y de emisor el mensaje viene en la clave mesage (así, sin la segunda "s"). Lee ambas claves al procesar errores.

Emisión por Sobre

Hasta 2000 documentos por llamada, procesamiento asíncrono.

11 Cómo funciona

Cada documento del sobre usa exactamente la misma estructura y validaciones de la emisión por DTE. La diferencia es que se envían todos juntos y el resultado se consulta después.

  1. 1

    Enviar el sobre

    POST con todos los documentos en DteSend.Dte. La API reserva los folios necesarios y responde de inmediato con un sobreId (HTTP 202).

  2. 2

    Procesamiento

    webFactura emite los documentos en segundo plano, en el mismo orden en que vienen en el arreglo.

  3. 3

    Consultar el resultado

    GET con el sobreId cada cierto tiempo hasta que el estado sea PROCESADO o PROCESADO_CON_ERROR.

  4. 4

    Revisar cada documento

    El resultado trae un elemento por documento con su folio, PDF o mensaje de error.

12 Enviar sobre

POST {host} /api/v3/pos/dte/sendSobreDTEJson
  • Máximo 2000 documentos por sobre.
  • Se pueden mezclar tipos de documento en un mismo sobre.
  • Usa "Folio": "0" en todos los documentos: los folios se reservan al recibir el sobre. Si no hay folios (CAF) suficientes para cubrirlo completo, el sobre se rechaza.
  • Se recomienda enviar IdPedido en cada documento para identificarlo en el resultado.
Request 
{
  "DteSend": {
    "Dte": [
      { "Encabezado": { "IdDoc": { "TipoDTE": "39", "Folio": "0", "FchEmis": "2026-10-07", "IdPedido": "100245" }, ... }, "Detalles": [ ... ] },
      { "Encabezado": { "IdDoc": { "TipoDTE": "39", "Folio": "0", "FchEmis": "2026-10-07", "IdPedido": "100246" }, ... }, "Detalles": [ ... ] },
      { "Encabezado": { "IdDoc": { "TipoDTE": "33", "Folio": "0", "FchEmis": "2026-10-07", "IdPedido": "100247" }, ... }, "Detalles": [ ... ] }
    ]
  }
}
Respuesta — HTTP 202 
{
  "status": "OK",
  "code": 202,
  "message": "Sobre DTE recibido correctamente",
  "sobreId": "20261007_3f9a1c2b7d4e8f60",
  "cantidadDocumentos": 3,
  "archivo": "..."
}
Nota: guarda el sobreId: es la única forma de consultar el resultado. Un 202 indica que el sobre fue recibido, no que los documentos estén emitidos.

13 Consultar resultado

GET {host} /api/v3/pos/dte/sobre/{sobreId}/response

Estados del sobre (estadoSobre)

PENDIENTE El sobre fue recibido y todavía no comienza a procesarse.
PROCESANDO Se están emitiendo los documentos. Incluye contadores de avance.
PROCESADO Terminó y todos los documentos se emitieron correctamente.
PROCESADO_CON_ERROR Terminó, pero uno o más documentos fallaron. Revisar cada elemento de DocumentoDTE.

PENDIENTE

{
  "status": "OK",
  "code": 200,
  "sobreId": "20261007_3f9a1c2b7d4e8f60",
  "estadoSobre": "PENDIENTE",
  "message": "El sobre fue recibido y aun no tiene resultado final."
}

PROCESANDO

{
  "status": "OK",
  "code": 200,
  "sobreId": "20261007_3f9a1c2b7d4e8f60",
  "estadoSobre": "PROCESANDO",
  "documentosTotales": 3,
  "documentosProcesados": 2,
  "documentosExitosos": 2,
  "documentosConError": 0,
  "message": "El sobre se encuentra en procesamiento."
}

PROCESADO / PROCESADO_CON_ERROR

{
  "status": "OK",
  "code": 200,
  "sobreId": "20261007_3f9a1c2b7d4e8f60",
  "estadoSobre": "PROCESADO_CON_ERROR",
  "documentosTotales": 3,
  "documentosExitosos": 2,
  "documentosConError": 1,
  "duracionEnSegundos": "4.2",
  "DocumentoDTE": [
    {
      "Index": 0,
      "TipoDTE": 39,
      "Folio": 50120,
      "IdPedido": "100245",
      "EstadoDTE": 0,
      "GlosaEstadoDTE": "DTE RECIBIDO OK",
      "PDFUrl": "https://{host_pdf}/pdf/{token}",
      "PDFUrlTimbre": "https://{host_pdf}/pdf/{token}/2"
    },
    {
      "Index": 1,
      "TipoDTE": 39,
      "Folio": 50121,
      "IdPedido": "100246",
      "EstadoDTE": 0,
      "GlosaEstadoDTE": "DTE RECIBIDO OK",
      "PDFUrl": "https://{host_pdf}/pdf/{token}",
      "PDFUrlTimbre": "https://{host_pdf}/pdf/{token}/2"
    },
    {
      "Index": 2,
      "TipoDTE": 33,
      "Folio": "",
      "IdPedido": "100247",
      "EstadoDTE": 1,
      "GlosaEstadoDTE": "Debe Incluir al menos una referencia",
      "PDFUrl": "",
      "PDFUrlTimbre": ""
    }
  ]
}
Campo de DocumentoDTE[] Descripción
Index Posición del documento en el arreglo Dte enviado, comenzando en 0.
IdPedido IdPedido enviado en el documento (vacío si no se envió).
EstadoDTE 0 = emitido correctamente · 1 = con error.
GlosaEstadoDTE "DTE RECIBIDO OK" o el mensaje de error del documento.
Folio / PDFUrl / PDFUrlTimbre Datos del documento emitido; vacíos si el documento falló.

Un error en un documento no detiene el resto del sobre. Los documentos con error se pueden corregir y reenviar por la emisión por DTE o en un nuevo sobre.

14 Errores

A diferencia de la emisión por DTE, los endpoints de sobre responden con el código HTTP correspondiente (el mismo valor que code en el body).

HTTP Situación Respuesta
401 Token ausente, inválido o expirado invalid_token / access_denied (OAuth2)
400 Body no es un JSON válido {"status": "ERR", "code": 400, "message": "JSON invalido: ..."}
400 Falta el objeto DteSend {"status": "ERR", "code": 400, "message": "Debe incluir el objeto DteSend"}
400 Dte vacío o no es arreglo {"status": "ERR", "code": 400, "message": "Error: Dte must be an array and cannot be empty"}
400 Más de 2000 documentos en el sobre {"status": "ERR", "code": 400, "message": "El sobre fue rechazado: contiene N documentos y el límite máximo es 2000."}
422 No hay folios (CAF) suficientes para cubrir el sobre {"status": "ERR", "code": 422, "message": "Folios insuficientes para tipoDTE 39: ... Debe cargar un nuevo CAF antes de enviar este sobre."}
404 Consulta de un sobreId inexistente o de otra empresa {"status": "ERR", "code": 404, "message": "No se encontro informacion para el sobre indicado."}
500 Error interno {"status": "ERR", "code": 500, "message": "..."}

15 Recomendaciones para la integración

  • Cachear el access_token (dura 24 horas) y renovarlo antes de que expire, en vez de pedir uno por llamada.
  • Enviar "Folio": "0" y dejar que webFactura asigne los folios.
  • Enviar IdPedido: si una llamada falla por tiempo de espera, se puede reintentar sin riesgo de emitir el documento dos veces.
  • En la emisión por DTE, validar siempre code en el body: el HTTP es 200 incluso con error.
  • Si la respuesta indica que el proceso de emisión está en uso, reintentar tras unos segundos con espera creciente.
  • Para volúmenes altos usar la emisión por sobre y consultar el resultado cada 30 a 60 segundos, no en ciclo continuo.
  • Respetar el orden de campos de los ejemplos: el XML se valida contra el esquema del SII.
Solicitar credenciales de integración Consultar documentos emitidos →
Soporte Agendar demo Hablar con Ventas