# Previsualizar DTE en el SII
> Valida y previsualiza un documento en el Facturador Gratuito del SII sin guardarlo ni emitirlo.
{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}
| | |
| ------------------- | ----------------------------------------------------------------- |
| **Tool ID** | `sii.dte.previsualizar` |
| **Nombre MCP** | `sii__dte__previsualizar` |
| **Conector** | `sii` |
| **Plano** | `action` |
| **Scope (permiso)** | `sii:write` |
| **Auth** | `connection_credentials` |
| **Versión** | `5` |
| **Sensible** | sí |
| **Deprecado** | no |
| **Comportamiento** | readOnly=true, destructive=false, idempotent=true, openWorld=true |
> **Requiere conexión.** Indica cuál en cada llamada: header `X-Connect-Connection` en REST y campo `connectionId` en el `execute` de MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de [`conexiones.estado.consultar`](/docs/referencia/conexiones/estado-consultar).
## Qué hace [#qué-hace]
El schema documenta factura afecta 33 y factura exenta 34 (de una a diez líneas y con hasta tres referencias opcionales, como orden de compra o HES), guía 52 con cualquiera de sus nueve motivos de traslado (motivoTraslado), hasta diez líneas con código, unidad y descripción, referencias, solicitante, transporte y contacto del receptor, dentro de una página impresa, y notas 56/61 de corrección de montos referidas a una factura 34 exenta. Cada variante requiere validación vigente del portal, habilitación para la organización, permiso de la conexión y perfil del emisor. Publicar su schema no habilita su ejecución. El 46 se rechaza antes de red.
## Entrada [#entrada]
| Campo | Tipo | Requerido | Descripción |
| ----------- | ----- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `candidato` | valor | sí | Formulario completo de una variante publicada en el schema. La matriz productiva marca las cinco variantes baseline como elegibles para preview (33, 34, 52, 56 y 61); aun ellas requieren que estén abiertas todas las compuertas de rollout, organización, scope, credencial y perfil. El 46 se rechaza antes de red. Usa exactamente una rama y no combines campos entre documentos. |
JSON Schema de entrada
```json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"candidato": {
"anyOf": [
{
"type": "object",
"properties": {
"tipoDte": {
"type": "string",
"const": "33",
"description": "Factura electrónica afecta a IVA."
},
"receptor": {
"type": "object",
"properties": {
"rut": {
"description": "RUT chileno del receptor, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"razonSocial": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Razón social legal del receptor."
},
"giro": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Giro comercial del receptor."
},
"direccion": {
"type": "string",
"minLength": 1,
"maxLength": 70,
"description": "Dirección tributaria del receptor."
},
"comuna": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "Comuna de la dirección tributaria del receptor."
},
"ciudad": {
"type": "string",
"minLength": 1,
"maxLength": 15,
"description": "Ciudad de la dirección tributaria del receptor."
}
},
"required": [
"rut",
"razonSocial",
"giro",
"direccion",
"comuna",
"ciudad"
],
"additionalProperties": false,
"description": "Datos obligatorios del receptor; esta variante no admite un campo de contacto."
},
"tipoVenta": {
"type": "string",
"const": "del_giro",
"description": "Venta fija del giro; no se habilitan otros selectores."
},
"tipoCompra": {
"type": "string",
"const": "del_giro",
"description": "Compra fija del giro; no se habilitan otros selectores."
},
"condicionPago": {
"type": "object",
"properties": {
"formaPago": {
"type": "string",
"const": "credito",
"description": "Forma de pago fija a crédito."
}
},
"required": [
"formaPago"
],
"additionalProperties": false,
"description": "Condición de pago fija de esta variante."
},
"detalles": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"nombre": {
"type": "string",
"minLength": 1,
"maxLength": 25,
"description": "Nombre del ítem, hasta 25 caracteres."
},
"cantidad": {
"type": "number",
"description": "Cantidad con mínimo 1, hasta dos decimales y wire máximo de 12 caracteres."
},
"precioUnitario": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 999999999999,
"description": "Precio unitario positivo en pesos chilenos, antes de impuestos, con hasta dos decimales y hasta 12 caracteres (por ejemplo 8402.49). El subtotal de la línea, round(cantidad × precioUnitario), debe ser un entero de 1 a 10 dígitos."
}
},
"required": [
"nombre",
"cantidad",
"precioUnitario"
],
"additionalProperties": false,
"description": "Línea de la factura: sin código, unidad, descripción ni descuento."
},
"description": "Entre una y diez líneas, en el orden en que van en la factura; ninguna admite código, unidad, descripción ni descuento."
},
"referencias": {
"description": "Entre una y tres referencias opcionales a los documentos que originan la factura: orden de compra, HES, guía de despacho, contrato u otro documento del selector del portal.",
"minItems": 1,
"maxItems": 3,
"type": "array",
"items": {
"type": "object",
"properties": {
"tipoDocumento": {
"type": "string",
"enum": [
"30",
"32",
"33",
"34",
"35",
"38",
"39",
"40",
"41",
"43",
"45",
"46",
"48",
"50",
"52",
"55",
"56",
"60",
"61",
"103",
"801",
"802",
"803",
"804",
"805",
"806",
"813",
"820",
"821",
"822",
"823",
"HES"
],
"description": "Código del documento referenciado, tal como lo ofrece el Facturador Gratuito: un documento tributario (30, 32, 33, 34, 35, 38, 39, 40, 41, 43, 45, 46, 48, 50, 52, 55, 56, 60, 61 o 103), 801 orden de compra, 802 nota de pedido, 803 contrato, 804 resolución, 805 proceso ChileCompra, 806 ficha ChileCompra, 813 pasaporte, 820 código de registro de Economía, 821 georreferencia, 822 rol de avalúo del predio, 823 plan de manejo Conaf o HES hoja de entrada de servicio."
},
"indicadorGlobal": {
"description": "Indicador de referencia global opcional; si vale 1, la referencia cubre un conjunto de documentos y el folio debe ser exactamente 0.",
"type": "number",
"const": 1
},
"folio": {
"type": "string",
"minLength": 1,
"maxLength": 18,
"description": "Folio o número del documento referenciado, hasta 18 caracteres. Para documentos tributarios (30, 32, 33, 34, 38, 39, 40, 45, 46, 50, 52, 55, 56, 60, 61 y 103) debe ser un entero mayor que 0 sin ceros a la izquierda; usa 0 únicamente junto con indicadorGlobal igual a 1."
},
"fecha": {
"type": "string",
"x-emisso-formato": "AAAA-MM-DD",
"description": "Fecha del documento referenciado, en formato AAAA-MM-DD, entre 2002-08-01 y 2050-12-31."
},
"razon": {
"description": "Razón opcional de la referencia, hasta 90 caracteres.",
"type": "string",
"minLength": 1,
"maxLength": 90
}
},
"required": [
"tipoDocumento",
"folio",
"fecha"
],
"additionalProperties": false,
"description": "Referencia de la factura a otro documento; se permiten entre una y tres."
}
}
},
"required": [
"tipoDte",
"receptor",
"tipoVenta",
"tipoCompra",
"condicionPago",
"detalles"
],
"additionalProperties": false,
"description": "Formulario cerrado de factura afecta 33 baseline: hasta diez líneas y referencias opcionales."
},
{
"type": "object",
"properties": {
"tipoDte": {
"type": "string",
"const": "34",
"description": "Factura electrónica exenta o no afecta a IVA."
},
"receptor": {
"type": "object",
"properties": {
"rut": {
"description": "RUT chileno del receptor, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"razonSocial": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Razón social legal del receptor."
},
"giro": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Giro comercial del receptor."
},
"direccion": {
"type": "string",
"minLength": 1,
"maxLength": 70,
"description": "Dirección tributaria del receptor."
},
"comuna": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "Comuna de la dirección tributaria del receptor."
},
"ciudad": {
"type": "string",
"minLength": 1,
"maxLength": 15,
"description": "Ciudad de la dirección tributaria del receptor."
}
},
"required": [
"rut",
"razonSocial",
"giro",
"direccion",
"comuna",
"ciudad"
],
"additionalProperties": false,
"description": "Datos obligatorios del receptor; esta variante no admite un campo de contacto."
},
"tipoVenta": {
"type": "string",
"const": "del_giro",
"description": "Venta fija del giro; no se habilitan otros selectores."
},
"tipoCompra": {
"type": "string",
"const": "del_giro",
"description": "Compra fija del giro; no se habilitan otros selectores."
},
"condicionPago": {
"type": "object",
"properties": {
"formaPago": {
"type": "string",
"const": "credito",
"description": "Forma de pago fija a crédito."
}
},
"required": [
"formaPago"
],
"additionalProperties": false,
"description": "Condición de pago fija de esta variante."
},
"detalles": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"nombre": {
"type": "string",
"minLength": 1,
"maxLength": 25,
"description": "Nombre del ítem, hasta 25 caracteres."
},
"cantidad": {
"type": "number",
"description": "Cantidad con mínimo 1, hasta dos decimales y wire máximo de 12 caracteres."
},
"precioUnitario": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 999999999999,
"description": "Precio unitario positivo en pesos chilenos, antes de impuestos, con hasta dos decimales y hasta 12 caracteres (por ejemplo 8402.49). El subtotal de la línea, round(cantidad × precioUnitario), debe ser un entero de 1 a 10 dígitos."
}
},
"required": [
"nombre",
"cantidad",
"precioUnitario"
],
"additionalProperties": false,
"description": "Línea de la factura: sin código, unidad, descripción ni descuento."
},
"description": "Entre una y diez líneas exentas, en el orden en que van en la factura; ninguna admite IVA, código, unidad, descripción ni descuento."
},
"referencias": {
"description": "Entre una y tres referencias opcionales a los documentos que originan la factura: orden de compra, HES, guía de despacho, contrato u otro documento del selector del portal.",
"minItems": 1,
"maxItems": 3,
"type": "array",
"items": {
"type": "object",
"properties": {
"tipoDocumento": {
"type": "string",
"enum": [
"30",
"32",
"33",
"34",
"35",
"38",
"39",
"40",
"41",
"43",
"45",
"46",
"48",
"50",
"52",
"55",
"56",
"60",
"61",
"103",
"801",
"802",
"803",
"804",
"805",
"806",
"813",
"820",
"821",
"822",
"823",
"HES"
],
"description": "Código del documento referenciado, tal como lo ofrece el Facturador Gratuito: un documento tributario (30, 32, 33, 34, 35, 38, 39, 40, 41, 43, 45, 46, 48, 50, 52, 55, 56, 60, 61 o 103), 801 orden de compra, 802 nota de pedido, 803 contrato, 804 resolución, 805 proceso ChileCompra, 806 ficha ChileCompra, 813 pasaporte, 820 código de registro de Economía, 821 georreferencia, 822 rol de avalúo del predio, 823 plan de manejo Conaf o HES hoja de entrada de servicio."
},
"indicadorGlobal": {
"description": "Indicador de referencia global opcional; si vale 1, la referencia cubre un conjunto de documentos y el folio debe ser exactamente 0.",
"type": "number",
"const": 1
},
"folio": {
"type": "string",
"minLength": 1,
"maxLength": 18,
"description": "Folio o número del documento referenciado, hasta 18 caracteres. Para documentos tributarios (30, 32, 33, 34, 38, 39, 40, 45, 46, 50, 52, 55, 56, 60, 61 y 103) debe ser un entero mayor que 0 sin ceros a la izquierda; usa 0 únicamente junto con indicadorGlobal igual a 1."
},
"fecha": {
"type": "string",
"x-emisso-formato": "AAAA-MM-DD",
"description": "Fecha del documento referenciado, en formato AAAA-MM-DD, entre 2002-08-01 y 2050-12-31."
},
"razon": {
"description": "Razón opcional de la referencia, hasta 90 caracteres.",
"type": "string",
"minLength": 1,
"maxLength": 90
}
},
"required": [
"tipoDocumento",
"folio",
"fecha"
],
"additionalProperties": false,
"description": "Referencia de la factura a otro documento; se permiten entre una y tres."
}
}
},
"required": [
"tipoDte",
"receptor",
"tipoVenta",
"tipoCompra",
"condicionPago",
"detalles"
],
"additionalProperties": false,
"description": "Formulario cerrado de factura exenta 34 baseline: hasta diez líneas y referencias opcionales."
},
{
"type": "object",
"properties": {
"tipoDte": {
"type": "string",
"const": "52",
"description": "Guía de despacho electrónica."
},
"receptor": {
"type": "object",
"properties": {
"rut": {
"description": "RUT chileno del receptor, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"razonSocial": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Razón social legal del receptor."
},
"giro": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Giro comercial del receptor."
},
"direccion": {
"type": "string",
"minLength": 1,
"maxLength": 70,
"description": "Dirección tributaria del receptor."
},
"comuna": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "Comuna de la dirección tributaria del receptor."
},
"ciudad": {
"type": "string",
"minLength": 1,
"maxLength": 15,
"description": "Ciudad de la dirección tributaria del receptor."
},
"contacto": {
"description": "Contacto opcional dentro de la empresa receptora: nombre, correo o teléfono, hasta 80 caracteres.",
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"required": [
"rut",
"razonSocial",
"giro",
"direccion",
"comuna",
"ciudad"
],
"additionalProperties": false,
"description": "Datos del receptor; el contacto es opcional."
},
"motivoTraslado": {
"type": "string",
"const": "constituye_venta",
"description": "Motivo de traslado: Operación constituye venta (código 1 del SII)."
},
"detalles": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"nombre": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Nombre del ítem, hasta 80 caracteres."
},
"cantidad": {
"type": "number",
"description": "Cantidad con mínimo 1, hasta dos decimales y wire máximo de 12 caracteres."
},
"precioUnitario": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 999999999999,
"description": "Precio unitario positivo en pesos chilenos, antes de impuestos, con hasta dos decimales y hasta 12 caracteres (por ejemplo 8402.49). El subtotal de la línea, round(cantidad × precioUnitario), debe ser un entero de 1 a 10 dígitos."
},
"unidad": {
"description": "Unidad de medida opcional, hasta 4 caracteres (por ejemplo UN, KG).",
"type": "string",
"minLength": 1,
"maxLength": 4
},
"codigo": {
"type": "object",
"properties": {
"tipo": {
"type": "string",
"minLength": 1,
"maxLength": 10,
"description": "Tipo de codificación del ítem, hasta 10 caracteres (por ejemplo INT1, EAN13)."
},
"valor": {
"type": "string",
"minLength": 1,
"maxLength": 35,
"description": "Código del ítem en esa codificación, hasta 35 caracteres."
}
},
"required": [
"tipo",
"valor"
],
"additionalProperties": false,
"description": "Código opcional del ítem. Si una línea lo lleva, el portal dibuja la columna de código en todas."
},
"descripcion": {
"type": "string",
"minLength": 1,
"maxLength": 999,
"description": "Descripción opcional del ítem, hasta 999 caracteres, sin palabras de más de 30; va debajo del nombre y ocupa un renglón impreso cada 45 caracteres."
}
},
"required": [
"nombre",
"cantidad",
"precioUnitario"
],
"additionalProperties": false
},
"description": "Entre una y diez líneas, en el orden en que van en la guía."
},
"referencias": {
"description": "Entre una y tres referencias opcionales: orden de compra, factura, contrato u otro documento del selector del portal.",
"minItems": 1,
"maxItems": 3,
"type": "array",
"items": {
"type": "object",
"properties": {
"tipoDocumento": {
"type": "string",
"enum": [
"30",
"32",
"33",
"34",
"35",
"38",
"39",
"40",
"41",
"43",
"45",
"46",
"48",
"50",
"52",
"55",
"56",
"60",
"61",
"103",
"801",
"802",
"803",
"804",
"805",
"806",
"813",
"820",
"821",
"822",
"823",
"HES"
],
"description": "Código del documento referenciado, tal como lo ofrece el Facturador Gratuito: un documento tributario (30, 32, 33, 34, 35, 38, 39, 40, 41, 43, 45, 46, 48, 50, 52, 55, 56, 60, 61 o 103), 801 orden de compra, 802 nota de pedido, 803 contrato, 804 resolución, 805 proceso ChileCompra, 806 ficha ChileCompra, 813 pasaporte, 820 código de registro de Economía, 821 georreferencia, 822 rol de avalúo del predio, 823 plan de manejo Conaf o HES hoja de entrada de servicio."
},
"indicadorGlobal": {
"description": "Indicador de referencia global opcional; si vale 1, la referencia cubre un conjunto de documentos y el folio debe ser exactamente 0.",
"type": "number",
"const": 1
},
"folio": {
"type": "string",
"minLength": 1,
"maxLength": 18,
"description": "Folio o número del documento referenciado, hasta 18 caracteres. Para documentos tributarios (30, 32, 33, 34, 38, 39, 40, 45, 46, 50, 52, 55, 56, 60, 61 y 103) debe ser un entero mayor que 0 sin ceros a la izquierda; usa 0 únicamente junto con indicadorGlobal igual a 1."
},
"fecha": {
"type": "string",
"x-emisso-formato": "AAAA-MM-DD",
"description": "Fecha del documento referenciado, en formato AAAA-MM-DD, entre 2002-08-01 y 2050-12-31."
},
"razon": {
"description": "Razón opcional de la referencia, hasta 90 caracteres.",
"type": "string",
"minLength": 1,
"maxLength": 90
}
},
"required": [
"tipoDocumento",
"folio",
"fecha"
],
"additionalProperties": false,
"description": "Referencia de la factura a otro documento; se permiten entre una y tres."
}
},
"solicitanteRut": {
"description": "RUT opcional de quien solicita el despacho, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"transporte": {
"type": "object",
"properties": {
"transportistaRut": {
"description": "RUT del transportista, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"patente": {
"type": "string",
"minLength": 1,
"maxLength": 8,
"description": "Patente del vehículo, hasta 8 caracteres."
},
"choferRut": {
"description": "RUT del chofer, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"choferNombre": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "Nombre del chofer, hasta 30 caracteres."
}
},
"required": [
"transportistaRut",
"patente",
"choferRut",
"choferNombre"
],
"additionalProperties": false,
"description": "Datos de transporte opcionales. Si van, van completos: transportista, patente y chofer con RUT y nombre, como exige el formulario del portal."
}
},
"required": [
"tipoDte",
"receptor",
"motivoTraslado",
"detalles"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"tipoDte": {
"type": "string",
"const": "52",
"description": "Guía de despacho electrónica."
},
"receptor": {
"type": "object",
"properties": {
"rut": {
"description": "RUT chileno del receptor, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"razonSocial": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Razón social legal del receptor."
},
"giro": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Giro comercial del receptor."
},
"direccion": {
"type": "string",
"minLength": 1,
"maxLength": 70,
"description": "Dirección tributaria del receptor."
},
"comuna": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "Comuna de la dirección tributaria del receptor."
},
"ciudad": {
"type": "string",
"minLength": 1,
"maxLength": 15,
"description": "Ciudad de la dirección tributaria del receptor."
},
"contacto": {
"description": "Contacto opcional dentro de la empresa receptora: nombre, correo o teléfono, hasta 80 caracteres.",
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"required": [
"rut",
"razonSocial",
"giro",
"direccion",
"comuna",
"ciudad"
],
"additionalProperties": false,
"description": "Datos del receptor; el contacto es opcional."
},
"motivoTraslado": {
"type": "string",
"const": "ventas_por_efectuar",
"description": "Motivo de traslado: Ventas por efectuar (código 2 del SII)."
},
"detalles": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"nombre": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Nombre del ítem, hasta 80 caracteres."
},
"cantidad": {
"type": "number",
"description": "Cantidad con mínimo 1, hasta dos decimales y wire máximo de 12 caracteres."
},
"precioUnitario": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 999999999999,
"description": "Precio unitario positivo en pesos chilenos, antes de impuestos, con hasta dos decimales y hasta 12 caracteres (por ejemplo 8402.49). El subtotal de la línea, round(cantidad × precioUnitario), debe ser un entero de 1 a 10 dígitos."
},
"unidad": {
"description": "Unidad de medida opcional, hasta 4 caracteres (por ejemplo UN, KG).",
"type": "string",
"minLength": 1,
"maxLength": 4
},
"codigo": {
"type": "object",
"properties": {
"tipo": {
"type": "string",
"minLength": 1,
"maxLength": 10,
"description": "Tipo de codificación del ítem, hasta 10 caracteres (por ejemplo INT1, EAN13)."
},
"valor": {
"type": "string",
"minLength": 1,
"maxLength": 35,
"description": "Código del ítem en esa codificación, hasta 35 caracteres."
}
},
"required": [
"tipo",
"valor"
],
"additionalProperties": false,
"description": "Código opcional del ítem. Si una línea lo lleva, el portal dibuja la columna de código en todas."
},
"descripcion": {
"type": "string",
"minLength": 1,
"maxLength": 999,
"description": "Descripción opcional del ítem, hasta 999 caracteres, sin palabras de más de 30; va debajo del nombre y ocupa un renglón impreso cada 45 caracteres."
}
},
"required": [
"nombre",
"cantidad",
"precioUnitario"
],
"additionalProperties": false
},
"description": "Entre una y diez líneas, en el orden en que van en la guía."
},
"referencias": {
"description": "Entre una y tres referencias opcionales: orden de compra, factura, contrato u otro documento del selector del portal.",
"minItems": 1,
"maxItems": 3,
"type": "array",
"items": {
"type": "object",
"properties": {
"tipoDocumento": {
"type": "string",
"enum": [
"30",
"32",
"33",
"34",
"35",
"38",
"39",
"40",
"41",
"43",
"45",
"46",
"48",
"50",
"52",
"55",
"56",
"60",
"61",
"103",
"801",
"802",
"803",
"804",
"805",
"806",
"813",
"820",
"821",
"822",
"823",
"HES"
],
"description": "Código del documento referenciado, tal como lo ofrece el Facturador Gratuito: un documento tributario (30, 32, 33, 34, 35, 38, 39, 40, 41, 43, 45, 46, 48, 50, 52, 55, 56, 60, 61 o 103), 801 orden de compra, 802 nota de pedido, 803 contrato, 804 resolución, 805 proceso ChileCompra, 806 ficha ChileCompra, 813 pasaporte, 820 código de registro de Economía, 821 georreferencia, 822 rol de avalúo del predio, 823 plan de manejo Conaf o HES hoja de entrada de servicio."
},
"indicadorGlobal": {
"description": "Indicador de referencia global opcional; si vale 1, la referencia cubre un conjunto de documentos y el folio debe ser exactamente 0.",
"type": "number",
"const": 1
},
"folio": {
"type": "string",
"minLength": 1,
"maxLength": 18,
"description": "Folio o número del documento referenciado, hasta 18 caracteres. Para documentos tributarios (30, 32, 33, 34, 38, 39, 40, 45, 46, 50, 52, 55, 56, 60, 61 y 103) debe ser un entero mayor que 0 sin ceros a la izquierda; usa 0 únicamente junto con indicadorGlobal igual a 1."
},
"fecha": {
"type": "string",
"x-emisso-formato": "AAAA-MM-DD",
"description": "Fecha del documento referenciado, en formato AAAA-MM-DD, entre 2002-08-01 y 2050-12-31."
},
"razon": {
"description": "Razón opcional de la referencia, hasta 90 caracteres.",
"type": "string",
"minLength": 1,
"maxLength": 90
}
},
"required": [
"tipoDocumento",
"folio",
"fecha"
],
"additionalProperties": false,
"description": "Referencia de la factura a otro documento; se permiten entre una y tres."
}
},
"solicitanteRut": {
"description": "RUT opcional de quien solicita el despacho, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"transporte": {
"type": "object",
"properties": {
"transportistaRut": {
"description": "RUT del transportista, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"patente": {
"type": "string",
"minLength": 1,
"maxLength": 8,
"description": "Patente del vehículo, hasta 8 caracteres."
},
"choferRut": {
"description": "RUT del chofer, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"choferNombre": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "Nombre del chofer, hasta 30 caracteres."
}
},
"required": [
"transportistaRut",
"patente",
"choferRut",
"choferNombre"
],
"additionalProperties": false,
"description": "Datos de transporte opcionales. Si van, van completos: transportista, patente y chofer con RUT y nombre, como exige el formulario del portal."
}
},
"required": [
"tipoDte",
"receptor",
"motivoTraslado",
"detalles"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"tipoDte": {
"type": "string",
"const": "52",
"description": "Guía de despacho electrónica."
},
"receptor": {
"type": "object",
"properties": {
"rut": {
"description": "RUT chileno del receptor, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"razonSocial": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Razón social legal del receptor."
},
"giro": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Giro comercial del receptor."
},
"direccion": {
"type": "string",
"minLength": 1,
"maxLength": 70,
"description": "Dirección tributaria del receptor."
},
"comuna": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "Comuna de la dirección tributaria del receptor."
},
"ciudad": {
"type": "string",
"minLength": 1,
"maxLength": 15,
"description": "Ciudad de la dirección tributaria del receptor."
},
"contacto": {
"description": "Contacto opcional dentro de la empresa receptora: nombre, correo o teléfono, hasta 80 caracteres.",
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"required": [
"rut",
"razonSocial",
"giro",
"direccion",
"comuna",
"ciudad"
],
"additionalProperties": false,
"description": "Datos del receptor; el contacto es opcional."
},
"motivoTraslado": {
"type": "string",
"const": "consignacion",
"description": "Motivo de traslado: Consignaciones (código 3 del SII)."
},
"detalles": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"nombre": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Nombre del ítem, hasta 80 caracteres."
},
"cantidad": {
"type": "number",
"description": "Cantidad con mínimo 1, hasta dos decimales y wire máximo de 12 caracteres."
},
"precioUnitario": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 999999999999,
"description": "Precio unitario positivo en pesos chilenos, antes de impuestos, con hasta dos decimales y hasta 12 caracteres (por ejemplo 8402.49). El subtotal de la línea, round(cantidad × precioUnitario), debe ser un entero de 1 a 10 dígitos."
},
"unidad": {
"description": "Unidad de medida opcional, hasta 4 caracteres (por ejemplo UN, KG).",
"type": "string",
"minLength": 1,
"maxLength": 4
},
"codigo": {
"type": "object",
"properties": {
"tipo": {
"type": "string",
"minLength": 1,
"maxLength": 10,
"description": "Tipo de codificación del ítem, hasta 10 caracteres (por ejemplo INT1, EAN13)."
},
"valor": {
"type": "string",
"minLength": 1,
"maxLength": 35,
"description": "Código del ítem en esa codificación, hasta 35 caracteres."
}
},
"required": [
"tipo",
"valor"
],
"additionalProperties": false,
"description": "Código opcional del ítem. Si una línea lo lleva, el portal dibuja la columna de código en todas."
},
"descripcion": {
"type": "string",
"minLength": 1,
"maxLength": 999,
"description": "Descripción opcional del ítem, hasta 999 caracteres, sin palabras de más de 30; va debajo del nombre y ocupa un renglón impreso cada 45 caracteres."
}
},
"required": [
"nombre",
"cantidad",
"precioUnitario"
],
"additionalProperties": false
},
"description": "Entre una y diez líneas, en el orden en que van en la guía."
},
"referencias": {
"description": "Entre una y tres referencias opcionales: orden de compra, factura, contrato u otro documento del selector del portal.",
"minItems": 1,
"maxItems": 3,
"type": "array",
"items": {
"type": "object",
"properties": {
"tipoDocumento": {
"type": "string",
"enum": [
"30",
"32",
"33",
"34",
"35",
"38",
"39",
"40",
"41",
"43",
"45",
"46",
"48",
"50",
"52",
"55",
"56",
"60",
"61",
"103",
"801",
"802",
"803",
"804",
"805",
"806",
"813",
"820",
"821",
"822",
"823",
"HES"
],
"description": "Código del documento referenciado, tal como lo ofrece el Facturador Gratuito: un documento tributario (30, 32, 33, 34, 35, 38, 39, 40, 41, 43, 45, 46, 48, 50, 52, 55, 56, 60, 61 o 103), 801 orden de compra, 802 nota de pedido, 803 contrato, 804 resolución, 805 proceso ChileCompra, 806 ficha ChileCompra, 813 pasaporte, 820 código de registro de Economía, 821 georreferencia, 822 rol de avalúo del predio, 823 plan de manejo Conaf o HES hoja de entrada de servicio."
},
"indicadorGlobal": {
"description": "Indicador de referencia global opcional; si vale 1, la referencia cubre un conjunto de documentos y el folio debe ser exactamente 0.",
"type": "number",
"const": 1
},
"folio": {
"type": "string",
"minLength": 1,
"maxLength": 18,
"description": "Folio o número del documento referenciado, hasta 18 caracteres. Para documentos tributarios (30, 32, 33, 34, 38, 39, 40, 45, 46, 50, 52, 55, 56, 60, 61 y 103) debe ser un entero mayor que 0 sin ceros a la izquierda; usa 0 únicamente junto con indicadorGlobal igual a 1."
},
"fecha": {
"type": "string",
"x-emisso-formato": "AAAA-MM-DD",
"description": "Fecha del documento referenciado, en formato AAAA-MM-DD, entre 2002-08-01 y 2050-12-31."
},
"razon": {
"description": "Razón opcional de la referencia, hasta 90 caracteres.",
"type": "string",
"minLength": 1,
"maxLength": 90
}
},
"required": [
"tipoDocumento",
"folio",
"fecha"
],
"additionalProperties": false,
"description": "Referencia de la factura a otro documento; se permiten entre una y tres."
}
},
"solicitanteRut": {
"description": "RUT opcional de quien solicita el despacho, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"transporte": {
"type": "object",
"properties": {
"transportistaRut": {
"description": "RUT del transportista, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"patente": {
"type": "string",
"minLength": 1,
"maxLength": 8,
"description": "Patente del vehículo, hasta 8 caracteres."
},
"choferRut": {
"description": "RUT del chofer, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"choferNombre": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "Nombre del chofer, hasta 30 caracteres."
}
},
"required": [
"transportistaRut",
"patente",
"choferRut",
"choferNombre"
],
"additionalProperties": false,
"description": "Datos de transporte opcionales. Si van, van completos: transportista, patente y chofer con RUT y nombre, como exige el formulario del portal."
}
},
"required": [
"tipoDte",
"receptor",
"motivoTraslado",
"detalles"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"tipoDte": {
"type": "string",
"const": "52",
"description": "Guía de despacho electrónica."
},
"receptor": {
"type": "object",
"properties": {
"rut": {
"description": "RUT chileno del receptor, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"razonSocial": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Razón social legal del receptor."
},
"giro": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Giro comercial del receptor."
},
"direccion": {
"type": "string",
"minLength": 1,
"maxLength": 70,
"description": "Dirección tributaria del receptor."
},
"comuna": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "Comuna de la dirección tributaria del receptor."
},
"ciudad": {
"type": "string",
"minLength": 1,
"maxLength": 15,
"description": "Ciudad de la dirección tributaria del receptor."
},
"contacto": {
"description": "Contacto opcional dentro de la empresa receptora: nombre, correo o teléfono, hasta 80 caracteres.",
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"required": [
"rut",
"razonSocial",
"giro",
"direccion",
"comuna",
"ciudad"
],
"additionalProperties": false,
"description": "Datos del receptor; el contacto es opcional."
},
"motivoTraslado": {
"type": "string",
"const": "entrega_gratuita",
"description": "Motivo de traslado: Entrega gratuita (código 4 del SII)."
},
"detalles": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"nombre": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Nombre del ítem, hasta 80 caracteres."
},
"cantidad": {
"type": "number",
"description": "Cantidad con mínimo 1, hasta dos decimales y wire máximo de 12 caracteres."
},
"precioUnitario": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 999999999999,
"description": "Precio unitario positivo en pesos chilenos, antes de impuestos, con hasta dos decimales y hasta 12 caracteres (por ejemplo 8402.49). El subtotal de la línea, round(cantidad × precioUnitario), debe ser un entero de 1 a 10 dígitos."
},
"unidad": {
"description": "Unidad de medida opcional, hasta 4 caracteres (por ejemplo UN, KG).",
"type": "string",
"minLength": 1,
"maxLength": 4
},
"codigo": {
"type": "object",
"properties": {
"tipo": {
"type": "string",
"minLength": 1,
"maxLength": 10,
"description": "Tipo de codificación del ítem, hasta 10 caracteres (por ejemplo INT1, EAN13)."
},
"valor": {
"type": "string",
"minLength": 1,
"maxLength": 35,
"description": "Código del ítem en esa codificación, hasta 35 caracteres."
}
},
"required": [
"tipo",
"valor"
],
"additionalProperties": false,
"description": "Código opcional del ítem. Si una línea lo lleva, el portal dibuja la columna de código en todas."
},
"descripcion": {
"type": "string",
"minLength": 1,
"maxLength": 999,
"description": "Descripción opcional del ítem, hasta 999 caracteres, sin palabras de más de 30; va debajo del nombre y ocupa un renglón impreso cada 45 caracteres."
}
},
"required": [
"nombre",
"cantidad",
"precioUnitario"
],
"additionalProperties": false
},
"description": "Entre una y diez líneas, en el orden en que van en la guía."
},
"referencias": {
"description": "Entre una y tres referencias opcionales: orden de compra, factura, contrato u otro documento del selector del portal.",
"minItems": 1,
"maxItems": 3,
"type": "array",
"items": {
"type": "object",
"properties": {
"tipoDocumento": {
"type": "string",
"enum": [
"30",
"32",
"33",
"34",
"35",
"38",
"39",
"40",
"41",
"43",
"45",
"46",
"48",
"50",
"52",
"55",
"56",
"60",
"61",
"103",
"801",
"802",
"803",
"804",
"805",
"806",
"813",
"820",
"821",
"822",
"823",
"HES"
],
"description": "Código del documento referenciado, tal como lo ofrece el Facturador Gratuito: un documento tributario (30, 32, 33, 34, 35, 38, 39, 40, 41, 43, 45, 46, 48, 50, 52, 55, 56, 60, 61 o 103), 801 orden de compra, 802 nota de pedido, 803 contrato, 804 resolución, 805 proceso ChileCompra, 806 ficha ChileCompra, 813 pasaporte, 820 código de registro de Economía, 821 georreferencia, 822 rol de avalúo del predio, 823 plan de manejo Conaf o HES hoja de entrada de servicio."
},
"indicadorGlobal": {
"description": "Indicador de referencia global opcional; si vale 1, la referencia cubre un conjunto de documentos y el folio debe ser exactamente 0.",
"type": "number",
"const": 1
},
"folio": {
"type": "string",
"minLength": 1,
"maxLength": 18,
"description": "Folio o número del documento referenciado, hasta 18 caracteres. Para documentos tributarios (30, 32, 33, 34, 38, 39, 40, 45, 46, 50, 52, 55, 56, 60, 61 y 103) debe ser un entero mayor que 0 sin ceros a la izquierda; usa 0 únicamente junto con indicadorGlobal igual a 1."
},
"fecha": {
"type": "string",
"x-emisso-formato": "AAAA-MM-DD",
"description": "Fecha del documento referenciado, en formato AAAA-MM-DD, entre 2002-08-01 y 2050-12-31."
},
"razon": {
"description": "Razón opcional de la referencia, hasta 90 caracteres.",
"type": "string",
"minLength": 1,
"maxLength": 90
}
},
"required": [
"tipoDocumento",
"folio",
"fecha"
],
"additionalProperties": false,
"description": "Referencia de la factura a otro documento; se permiten entre una y tres."
}
},
"solicitanteRut": {
"description": "RUT opcional de quien solicita el despacho, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"transporte": {
"type": "object",
"properties": {
"transportistaRut": {
"description": "RUT del transportista, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"patente": {
"type": "string",
"minLength": 1,
"maxLength": 8,
"description": "Patente del vehículo, hasta 8 caracteres."
},
"choferRut": {
"description": "RUT del chofer, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"choferNombre": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "Nombre del chofer, hasta 30 caracteres."
}
},
"required": [
"transportistaRut",
"patente",
"choferRut",
"choferNombre"
],
"additionalProperties": false,
"description": "Datos de transporte opcionales. Si van, van completos: transportista, patente y chofer con RUT y nombre, como exige el formulario del portal."
}
},
"required": [
"tipoDte",
"receptor",
"motivoTraslado",
"detalles"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"tipoDte": {
"type": "string",
"const": "52",
"description": "Guía de despacho electrónica."
},
"receptor": {
"type": "object",
"properties": {
"rut": {
"description": "RUT chileno del receptor, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"razonSocial": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Razón social legal del receptor."
},
"giro": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Giro comercial del receptor."
},
"direccion": {
"type": "string",
"minLength": 1,
"maxLength": 70,
"description": "Dirección tributaria del receptor."
},
"comuna": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "Comuna de la dirección tributaria del receptor."
},
"ciudad": {
"type": "string",
"minLength": 1,
"maxLength": 15,
"description": "Ciudad de la dirección tributaria del receptor."
},
"contacto": {
"description": "Contacto opcional dentro de la empresa receptora: nombre, correo o teléfono, hasta 80 caracteres.",
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"required": [
"rut",
"razonSocial",
"giro",
"direccion",
"comuna",
"ciudad"
],
"additionalProperties": false,
"description": "Datos del receptor; el contacto es opcional."
},
"motivoTraslado": {
"type": "string",
"const": "traslado_interno",
"description": "Motivo de traslado: Traslados internos (código 5 del SII)."
},
"detalles": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"nombre": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Nombre del ítem, hasta 80 caracteres."
},
"cantidad": {
"type": "number",
"description": "Cantidad con mínimo 1, hasta dos decimales y wire máximo de 12 caracteres."
},
"precioUnitario": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 999999999999,
"description": "Precio unitario positivo en pesos chilenos, antes de impuestos, con hasta dos decimales y hasta 12 caracteres (por ejemplo 8402.49). El subtotal de la línea, round(cantidad × precioUnitario), debe ser un entero de 1 a 10 dígitos."
},
"unidad": {
"description": "Unidad de medida opcional, hasta 4 caracteres (por ejemplo UN, KG).",
"type": "string",
"minLength": 1,
"maxLength": 4
},
"codigo": {
"type": "object",
"properties": {
"tipo": {
"type": "string",
"minLength": 1,
"maxLength": 10,
"description": "Tipo de codificación del ítem, hasta 10 caracteres (por ejemplo INT1, EAN13)."
},
"valor": {
"type": "string",
"minLength": 1,
"maxLength": 35,
"description": "Código del ítem en esa codificación, hasta 35 caracteres."
}
},
"required": [
"tipo",
"valor"
],
"additionalProperties": false,
"description": "Código opcional del ítem. Si una línea lo lleva, el portal dibuja la columna de código en todas."
},
"descripcion": {
"type": "string",
"minLength": 1,
"maxLength": 999,
"description": "Descripción opcional del ítem, hasta 999 caracteres, sin palabras de más de 30; va debajo del nombre y ocupa un renglón impreso cada 45 caracteres."
}
},
"required": [
"nombre",
"cantidad",
"precioUnitario"
],
"additionalProperties": false
},
"description": "Entre una y diez líneas, en el orden en que van en la guía."
},
"referencias": {
"description": "Entre una y tres referencias opcionales: orden de compra, factura, contrato u otro documento del selector del portal.",
"minItems": 1,
"maxItems": 3,
"type": "array",
"items": {
"type": "object",
"properties": {
"tipoDocumento": {
"type": "string",
"enum": [
"30",
"32",
"33",
"34",
"35",
"38",
"39",
"40",
"41",
"43",
"45",
"46",
"48",
"50",
"52",
"55",
"56",
"60",
"61",
"103",
"801",
"802",
"803",
"804",
"805",
"806",
"813",
"820",
"821",
"822",
"823",
"HES"
],
"description": "Código del documento referenciado, tal como lo ofrece el Facturador Gratuito: un documento tributario (30, 32, 33, 34, 35, 38, 39, 40, 41, 43, 45, 46, 48, 50, 52, 55, 56, 60, 61 o 103), 801 orden de compra, 802 nota de pedido, 803 contrato, 804 resolución, 805 proceso ChileCompra, 806 ficha ChileCompra, 813 pasaporte, 820 código de registro de Economía, 821 georreferencia, 822 rol de avalúo del predio, 823 plan de manejo Conaf o HES hoja de entrada de servicio."
},
"indicadorGlobal": {
"description": "Indicador de referencia global opcional; si vale 1, la referencia cubre un conjunto de documentos y el folio debe ser exactamente 0.",
"type": "number",
"const": 1
},
"folio": {
"type": "string",
"minLength": 1,
"maxLength": 18,
"description": "Folio o número del documento referenciado, hasta 18 caracteres. Para documentos tributarios (30, 32, 33, 34, 38, 39, 40, 45, 46, 50, 52, 55, 56, 60, 61 y 103) debe ser un entero mayor que 0 sin ceros a la izquierda; usa 0 únicamente junto con indicadorGlobal igual a 1."
},
"fecha": {
"type": "string",
"x-emisso-formato": "AAAA-MM-DD",
"description": "Fecha del documento referenciado, en formato AAAA-MM-DD, entre 2002-08-01 y 2050-12-31."
},
"razon": {
"description": "Razón opcional de la referencia, hasta 90 caracteres.",
"type": "string",
"minLength": 1,
"maxLength": 90
}
},
"required": [
"tipoDocumento",
"folio",
"fecha"
],
"additionalProperties": false,
"description": "Referencia de la factura a otro documento; se permiten entre una y tres."
}
},
"solicitanteRut": {
"description": "RUT opcional de quien solicita el despacho, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"transporte": {
"type": "object",
"properties": {
"transportistaRut": {
"description": "RUT del transportista, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"patente": {
"type": "string",
"minLength": 1,
"maxLength": 8,
"description": "Patente del vehículo, hasta 8 caracteres."
},
"choferRut": {
"description": "RUT del chofer, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"choferNombre": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "Nombre del chofer, hasta 30 caracteres."
}
},
"required": [
"transportistaRut",
"patente",
"choferRut",
"choferNombre"
],
"additionalProperties": false,
"description": "Datos de transporte opcionales. Si van, van completos: transportista, patente y chofer con RUT y nombre, como exige el formulario del portal."
}
},
"required": [
"tipoDte",
"receptor",
"motivoTraslado",
"detalles"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"tipoDte": {
"type": "string",
"const": "52",
"description": "Guía de despacho electrónica."
},
"receptor": {
"type": "object",
"properties": {
"rut": {
"description": "RUT chileno del receptor, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"razonSocial": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Razón social legal del receptor."
},
"giro": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Giro comercial del receptor."
},
"direccion": {
"type": "string",
"minLength": 1,
"maxLength": 70,
"description": "Dirección tributaria del receptor."
},
"comuna": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "Comuna de la dirección tributaria del receptor."
},
"ciudad": {
"type": "string",
"minLength": 1,
"maxLength": 15,
"description": "Ciudad de la dirección tributaria del receptor."
},
"contacto": {
"description": "Contacto opcional dentro de la empresa receptora: nombre, correo o teléfono, hasta 80 caracteres.",
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"required": [
"rut",
"razonSocial",
"giro",
"direccion",
"comuna",
"ciudad"
],
"additionalProperties": false,
"description": "Datos del receptor; el contacto es opcional."
},
"motivoTraslado": {
"type": "string",
"const": "otro_traslado_no_venta",
"description": "Motivo de traslado: Otros traslados no venta (código 6 del SII)."
},
"detalles": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"nombre": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Nombre del ítem, hasta 80 caracteres."
},
"cantidad": {
"type": "number",
"description": "Cantidad con mínimo 1, hasta dos decimales y wire máximo de 12 caracteres."
},
"precioUnitario": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 999999999999,
"description": "Precio unitario positivo en pesos chilenos, antes de impuestos, con hasta dos decimales y hasta 12 caracteres (por ejemplo 8402.49). El subtotal de la línea, round(cantidad × precioUnitario), debe ser un entero de 1 a 10 dígitos."
},
"unidad": {
"description": "Unidad de medida opcional, hasta 4 caracteres (por ejemplo UN, KG).",
"type": "string",
"minLength": 1,
"maxLength": 4
},
"codigo": {
"type": "object",
"properties": {
"tipo": {
"type": "string",
"minLength": 1,
"maxLength": 10,
"description": "Tipo de codificación del ítem, hasta 10 caracteres (por ejemplo INT1, EAN13)."
},
"valor": {
"type": "string",
"minLength": 1,
"maxLength": 35,
"description": "Código del ítem en esa codificación, hasta 35 caracteres."
}
},
"required": [
"tipo",
"valor"
],
"additionalProperties": false,
"description": "Código opcional del ítem. Si una línea lo lleva, el portal dibuja la columna de código en todas."
},
"descripcion": {
"type": "string",
"minLength": 1,
"maxLength": 999,
"description": "Descripción opcional del ítem, hasta 999 caracteres, sin palabras de más de 30; va debajo del nombre y ocupa un renglón impreso cada 45 caracteres."
}
},
"required": [
"nombre",
"cantidad",
"precioUnitario"
],
"additionalProperties": false
},
"description": "Entre una y diez líneas, en el orden en que van en la guía."
},
"referencias": {
"description": "Entre una y tres referencias opcionales: orden de compra, factura, contrato u otro documento del selector del portal.",
"minItems": 1,
"maxItems": 3,
"type": "array",
"items": {
"type": "object",
"properties": {
"tipoDocumento": {
"type": "string",
"enum": [
"30",
"32",
"33",
"34",
"35",
"38",
"39",
"40",
"41",
"43",
"45",
"46",
"48",
"50",
"52",
"55",
"56",
"60",
"61",
"103",
"801",
"802",
"803",
"804",
"805",
"806",
"813",
"820",
"821",
"822",
"823",
"HES"
],
"description": "Código del documento referenciado, tal como lo ofrece el Facturador Gratuito: un documento tributario (30, 32, 33, 34, 35, 38, 39, 40, 41, 43, 45, 46, 48, 50, 52, 55, 56, 60, 61 o 103), 801 orden de compra, 802 nota de pedido, 803 contrato, 804 resolución, 805 proceso ChileCompra, 806 ficha ChileCompra, 813 pasaporte, 820 código de registro de Economía, 821 georreferencia, 822 rol de avalúo del predio, 823 plan de manejo Conaf o HES hoja de entrada de servicio."
},
"indicadorGlobal": {
"description": "Indicador de referencia global opcional; si vale 1, la referencia cubre un conjunto de documentos y el folio debe ser exactamente 0.",
"type": "number",
"const": 1
},
"folio": {
"type": "string",
"minLength": 1,
"maxLength": 18,
"description": "Folio o número del documento referenciado, hasta 18 caracteres. Para documentos tributarios (30, 32, 33, 34, 38, 39, 40, 45, 46, 50, 52, 55, 56, 60, 61 y 103) debe ser un entero mayor que 0 sin ceros a la izquierda; usa 0 únicamente junto con indicadorGlobal igual a 1."
},
"fecha": {
"type": "string",
"x-emisso-formato": "AAAA-MM-DD",
"description": "Fecha del documento referenciado, en formato AAAA-MM-DD, entre 2002-08-01 y 2050-12-31."
},
"razon": {
"description": "Razón opcional de la referencia, hasta 90 caracteres.",
"type": "string",
"minLength": 1,
"maxLength": 90
}
},
"required": [
"tipoDocumento",
"folio",
"fecha"
],
"additionalProperties": false,
"description": "Referencia de la factura a otro documento; se permiten entre una y tres."
}
},
"solicitanteRut": {
"description": "RUT opcional de quien solicita el despacho, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"transporte": {
"type": "object",
"properties": {
"transportistaRut": {
"description": "RUT del transportista, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"patente": {
"type": "string",
"minLength": 1,
"maxLength": 8,
"description": "Patente del vehículo, hasta 8 caracteres."
},
"choferRut": {
"description": "RUT del chofer, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"choferNombre": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "Nombre del chofer, hasta 30 caracteres."
}
},
"required": [
"transportistaRut",
"patente",
"choferRut",
"choferNombre"
],
"additionalProperties": false,
"description": "Datos de transporte opcionales. Si van, van completos: transportista, patente y chofer con RUT y nombre, como exige el formulario del portal."
}
},
"required": [
"tipoDte",
"receptor",
"motivoTraslado",
"detalles"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"tipoDte": {
"type": "string",
"const": "52",
"description": "Guía de despacho electrónica."
},
"receptor": {
"type": "object",
"properties": {
"rut": {
"description": "RUT chileno del receptor, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"razonSocial": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Razón social legal del receptor."
},
"giro": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Giro comercial del receptor."
},
"direccion": {
"type": "string",
"minLength": 1,
"maxLength": 70,
"description": "Dirección tributaria del receptor."
},
"comuna": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "Comuna de la dirección tributaria del receptor."
},
"ciudad": {
"type": "string",
"minLength": 1,
"maxLength": 15,
"description": "Ciudad de la dirección tributaria del receptor."
},
"contacto": {
"description": "Contacto opcional dentro de la empresa receptora: nombre, correo o teléfono, hasta 80 caracteres.",
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"required": [
"rut",
"razonSocial",
"giro",
"direccion",
"comuna",
"ciudad"
],
"additionalProperties": false,
"description": "Datos del receptor; el contacto es opcional."
},
"motivoTraslado": {
"type": "string",
"const": "devolucion",
"description": "Motivo de traslado: Guía de devolución (código 7 del SII)."
},
"detalles": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"nombre": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Nombre del ítem, hasta 80 caracteres."
},
"cantidad": {
"type": "number",
"description": "Cantidad con mínimo 1, hasta dos decimales y wire máximo de 12 caracteres."
},
"precioUnitario": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 999999999999,
"description": "Precio unitario positivo en pesos chilenos, antes de impuestos, con hasta dos decimales y hasta 12 caracteres (por ejemplo 8402.49). El subtotal de la línea, round(cantidad × precioUnitario), debe ser un entero de 1 a 10 dígitos."
},
"unidad": {
"description": "Unidad de medida opcional, hasta 4 caracteres (por ejemplo UN, KG).",
"type": "string",
"minLength": 1,
"maxLength": 4
},
"codigo": {
"type": "object",
"properties": {
"tipo": {
"type": "string",
"minLength": 1,
"maxLength": 10,
"description": "Tipo de codificación del ítem, hasta 10 caracteres (por ejemplo INT1, EAN13)."
},
"valor": {
"type": "string",
"minLength": 1,
"maxLength": 35,
"description": "Código del ítem en esa codificación, hasta 35 caracteres."
}
},
"required": [
"tipo",
"valor"
],
"additionalProperties": false,
"description": "Código opcional del ítem. Si una línea lo lleva, el portal dibuja la columna de código en todas."
},
"descripcion": {
"type": "string",
"minLength": 1,
"maxLength": 999,
"description": "Descripción opcional del ítem, hasta 999 caracteres, sin palabras de más de 30; va debajo del nombre y ocupa un renglón impreso cada 45 caracteres."
}
},
"required": [
"nombre",
"cantidad",
"precioUnitario"
],
"additionalProperties": false
},
"description": "Entre una y diez líneas, en el orden en que van en la guía."
},
"referencias": {
"description": "Entre una y tres referencias opcionales: orden de compra, factura, contrato u otro documento del selector del portal.",
"minItems": 1,
"maxItems": 3,
"type": "array",
"items": {
"type": "object",
"properties": {
"tipoDocumento": {
"type": "string",
"enum": [
"30",
"32",
"33",
"34",
"35",
"38",
"39",
"40",
"41",
"43",
"45",
"46",
"48",
"50",
"52",
"55",
"56",
"60",
"61",
"103",
"801",
"802",
"803",
"804",
"805",
"806",
"813",
"820",
"821",
"822",
"823",
"HES"
],
"description": "Código del documento referenciado, tal como lo ofrece el Facturador Gratuito: un documento tributario (30, 32, 33, 34, 35, 38, 39, 40, 41, 43, 45, 46, 48, 50, 52, 55, 56, 60, 61 o 103), 801 orden de compra, 802 nota de pedido, 803 contrato, 804 resolución, 805 proceso ChileCompra, 806 ficha ChileCompra, 813 pasaporte, 820 código de registro de Economía, 821 georreferencia, 822 rol de avalúo del predio, 823 plan de manejo Conaf o HES hoja de entrada de servicio."
},
"indicadorGlobal": {
"description": "Indicador de referencia global opcional; si vale 1, la referencia cubre un conjunto de documentos y el folio debe ser exactamente 0.",
"type": "number",
"const": 1
},
"folio": {
"type": "string",
"minLength": 1,
"maxLength": 18,
"description": "Folio o número del documento referenciado, hasta 18 caracteres. Para documentos tributarios (30, 32, 33, 34, 38, 39, 40, 45, 46, 50, 52, 55, 56, 60, 61 y 103) debe ser un entero mayor que 0 sin ceros a la izquierda; usa 0 únicamente junto con indicadorGlobal igual a 1."
},
"fecha": {
"type": "string",
"x-emisso-formato": "AAAA-MM-DD",
"description": "Fecha del documento referenciado, en formato AAAA-MM-DD, entre 2002-08-01 y 2050-12-31."
},
"razon": {
"description": "Razón opcional de la referencia, hasta 90 caracteres.",
"type": "string",
"minLength": 1,
"maxLength": 90
}
},
"required": [
"tipoDocumento",
"folio",
"fecha"
],
"additionalProperties": false,
"description": "Referencia de la factura a otro documento; se permiten entre una y tres."
}
},
"solicitanteRut": {
"description": "RUT opcional de quien solicita el despacho, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"transporte": {
"type": "object",
"properties": {
"transportistaRut": {
"description": "RUT del transportista, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"patente": {
"type": "string",
"minLength": 1,
"maxLength": 8,
"description": "Patente del vehículo, hasta 8 caracteres."
},
"choferRut": {
"description": "RUT del chofer, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"choferNombre": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "Nombre del chofer, hasta 30 caracteres."
}
},
"required": [
"transportistaRut",
"patente",
"choferRut",
"choferNombre"
],
"additionalProperties": false,
"description": "Datos de transporte opcionales. Si van, van completos: transportista, patente y chofer con RUT y nombre, como exige el formulario del portal."
}
},
"required": [
"tipoDte",
"receptor",
"motivoTraslado",
"detalles"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"tipoDte": {
"type": "string",
"const": "52",
"description": "Guía de despacho electrónica."
},
"receptor": {
"type": "object",
"properties": {
"rut": {
"description": "RUT chileno del receptor, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"razonSocial": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Razón social legal del receptor."
},
"giro": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Giro comercial del receptor."
},
"direccion": {
"type": "string",
"minLength": 1,
"maxLength": 70,
"description": "Dirección tributaria del receptor."
},
"comuna": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "Comuna de la dirección tributaria del receptor."
},
"ciudad": {
"type": "string",
"minLength": 1,
"maxLength": 15,
"description": "Ciudad de la dirección tributaria del receptor."
},
"contacto": {
"description": "Contacto opcional dentro de la empresa receptora: nombre, correo o teléfono, hasta 80 caracteres.",
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"required": [
"rut",
"razonSocial",
"giro",
"direccion",
"comuna",
"ciudad"
],
"additionalProperties": false,
"description": "Datos del receptor; el contacto es opcional."
},
"motivoTraslado": {
"type": "string",
"const": "traslado_exportacion_no_venta",
"description": "Motivo de traslado: Traslado para exportación (no venta) (código 8 del SII)."
},
"detalles": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"nombre": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Nombre del ítem, hasta 80 caracteres."
},
"cantidad": {
"type": "number",
"description": "Cantidad con mínimo 1, hasta dos decimales y wire máximo de 12 caracteres."
},
"precioUnitario": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 999999999999,
"description": "Precio unitario positivo en pesos chilenos, antes de impuestos, con hasta dos decimales y hasta 12 caracteres (por ejemplo 8402.49). El subtotal de la línea, round(cantidad × precioUnitario), debe ser un entero de 1 a 10 dígitos."
},
"unidad": {
"description": "Unidad de medida opcional, hasta 4 caracteres (por ejemplo UN, KG).",
"type": "string",
"minLength": 1,
"maxLength": 4
},
"codigo": {
"type": "object",
"properties": {
"tipo": {
"type": "string",
"minLength": 1,
"maxLength": 10,
"description": "Tipo de codificación del ítem, hasta 10 caracteres (por ejemplo INT1, EAN13)."
},
"valor": {
"type": "string",
"minLength": 1,
"maxLength": 35,
"description": "Código del ítem en esa codificación, hasta 35 caracteres."
}
},
"required": [
"tipo",
"valor"
],
"additionalProperties": false,
"description": "Código opcional del ítem. Si una línea lo lleva, el portal dibuja la columna de código en todas."
},
"descripcion": {
"type": "string",
"minLength": 1,
"maxLength": 999,
"description": "Descripción opcional del ítem, hasta 999 caracteres, sin palabras de más de 30; va debajo del nombre y ocupa un renglón impreso cada 45 caracteres."
}
},
"required": [
"nombre",
"cantidad",
"precioUnitario"
],
"additionalProperties": false
},
"description": "Entre una y diez líneas, en el orden en que van en la guía."
},
"referencias": {
"description": "Entre una y tres referencias opcionales: orden de compra, factura, contrato u otro documento del selector del portal.",
"minItems": 1,
"maxItems": 3,
"type": "array",
"items": {
"type": "object",
"properties": {
"tipoDocumento": {
"type": "string",
"enum": [
"30",
"32",
"33",
"34",
"35",
"38",
"39",
"40",
"41",
"43",
"45",
"46",
"48",
"50",
"52",
"55",
"56",
"60",
"61",
"103",
"801",
"802",
"803",
"804",
"805",
"806",
"813",
"820",
"821",
"822",
"823",
"HES"
],
"description": "Código del documento referenciado, tal como lo ofrece el Facturador Gratuito: un documento tributario (30, 32, 33, 34, 35, 38, 39, 40, 41, 43, 45, 46, 48, 50, 52, 55, 56, 60, 61 o 103), 801 orden de compra, 802 nota de pedido, 803 contrato, 804 resolución, 805 proceso ChileCompra, 806 ficha ChileCompra, 813 pasaporte, 820 código de registro de Economía, 821 georreferencia, 822 rol de avalúo del predio, 823 plan de manejo Conaf o HES hoja de entrada de servicio."
},
"indicadorGlobal": {
"description": "Indicador de referencia global opcional; si vale 1, la referencia cubre un conjunto de documentos y el folio debe ser exactamente 0.",
"type": "number",
"const": 1
},
"folio": {
"type": "string",
"minLength": 1,
"maxLength": 18,
"description": "Folio o número del documento referenciado, hasta 18 caracteres. Para documentos tributarios (30, 32, 33, 34, 38, 39, 40, 45, 46, 50, 52, 55, 56, 60, 61 y 103) debe ser un entero mayor que 0 sin ceros a la izquierda; usa 0 únicamente junto con indicadorGlobal igual a 1."
},
"fecha": {
"type": "string",
"x-emisso-formato": "AAAA-MM-DD",
"description": "Fecha del documento referenciado, en formato AAAA-MM-DD, entre 2002-08-01 y 2050-12-31."
},
"razon": {
"description": "Razón opcional de la referencia, hasta 90 caracteres.",
"type": "string",
"minLength": 1,
"maxLength": 90
}
},
"required": [
"tipoDocumento",
"folio",
"fecha"
],
"additionalProperties": false,
"description": "Referencia de la factura a otro documento; se permiten entre una y tres."
}
},
"solicitanteRut": {
"description": "RUT opcional de quien solicita el despacho, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"transporte": {
"type": "object",
"properties": {
"transportistaRut": {
"description": "RUT del transportista, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"patente": {
"type": "string",
"minLength": 1,
"maxLength": 8,
"description": "Patente del vehículo, hasta 8 caracteres."
},
"choferRut": {
"description": "RUT del chofer, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"choferNombre": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "Nombre del chofer, hasta 30 caracteres."
}
},
"required": [
"transportistaRut",
"patente",
"choferRut",
"choferNombre"
],
"additionalProperties": false,
"description": "Datos de transporte opcionales. Si van, van completos: transportista, patente y chofer con RUT y nombre, como exige el formulario del portal."
}
},
"required": [
"tipoDte",
"receptor",
"motivoTraslado",
"detalles"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"tipoDte": {
"type": "string",
"const": "52",
"description": "Guía de despacho electrónica."
},
"receptor": {
"type": "object",
"properties": {
"rut": {
"description": "RUT chileno del receptor, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"razonSocial": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Razón social legal del receptor."
},
"giro": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Giro comercial del receptor."
},
"direccion": {
"type": "string",
"minLength": 1,
"maxLength": 70,
"description": "Dirección tributaria del receptor."
},
"comuna": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "Comuna de la dirección tributaria del receptor."
},
"ciudad": {
"type": "string",
"minLength": 1,
"maxLength": 15,
"description": "Ciudad de la dirección tributaria del receptor."
},
"contacto": {
"description": "Contacto opcional dentro de la empresa receptora: nombre, correo o teléfono, hasta 80 caracteres.",
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"required": [
"rut",
"razonSocial",
"giro",
"direccion",
"comuna",
"ciudad"
],
"additionalProperties": false,
"description": "Datos del receptor; el contacto es opcional."
},
"motivoTraslado": {
"type": "string",
"const": "venta_exportacion",
"description": "Motivo de traslado: Venta para exportación (código 9 del SII)."
},
"detalles": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"nombre": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Nombre del ítem, hasta 80 caracteres."
},
"cantidad": {
"type": "number",
"description": "Cantidad con mínimo 1, hasta dos decimales y wire máximo de 12 caracteres."
},
"precioUnitario": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 999999999999,
"description": "Precio unitario positivo en pesos chilenos, antes de impuestos, con hasta dos decimales y hasta 12 caracteres (por ejemplo 8402.49). El subtotal de la línea, round(cantidad × precioUnitario), debe ser un entero de 1 a 10 dígitos."
},
"unidad": {
"description": "Unidad de medida opcional, hasta 4 caracteres (por ejemplo UN, KG).",
"type": "string",
"minLength": 1,
"maxLength": 4
},
"codigo": {
"type": "object",
"properties": {
"tipo": {
"type": "string",
"minLength": 1,
"maxLength": 10,
"description": "Tipo de codificación del ítem, hasta 10 caracteres (por ejemplo INT1, EAN13)."
},
"valor": {
"type": "string",
"minLength": 1,
"maxLength": 35,
"description": "Código del ítem en esa codificación, hasta 35 caracteres."
}
},
"required": [
"tipo",
"valor"
],
"additionalProperties": false,
"description": "Código opcional del ítem. Si una línea lo lleva, el portal dibuja la columna de código en todas."
},
"descripcion": {
"type": "string",
"minLength": 1,
"maxLength": 999,
"description": "Descripción opcional del ítem, hasta 999 caracteres, sin palabras de más de 30; va debajo del nombre y ocupa un renglón impreso cada 45 caracteres."
}
},
"required": [
"nombre",
"cantidad",
"precioUnitario"
],
"additionalProperties": false
},
"description": "Entre una y diez líneas, en el orden en que van en la guía."
},
"referencias": {
"description": "Entre una y tres referencias opcionales: orden de compra, factura, contrato u otro documento del selector del portal.",
"minItems": 1,
"maxItems": 3,
"type": "array",
"items": {
"type": "object",
"properties": {
"tipoDocumento": {
"type": "string",
"enum": [
"30",
"32",
"33",
"34",
"35",
"38",
"39",
"40",
"41",
"43",
"45",
"46",
"48",
"50",
"52",
"55",
"56",
"60",
"61",
"103",
"801",
"802",
"803",
"804",
"805",
"806",
"813",
"820",
"821",
"822",
"823",
"HES"
],
"description": "Código del documento referenciado, tal como lo ofrece el Facturador Gratuito: un documento tributario (30, 32, 33, 34, 35, 38, 39, 40, 41, 43, 45, 46, 48, 50, 52, 55, 56, 60, 61 o 103), 801 orden de compra, 802 nota de pedido, 803 contrato, 804 resolución, 805 proceso ChileCompra, 806 ficha ChileCompra, 813 pasaporte, 820 código de registro de Economía, 821 georreferencia, 822 rol de avalúo del predio, 823 plan de manejo Conaf o HES hoja de entrada de servicio."
},
"indicadorGlobal": {
"description": "Indicador de referencia global opcional; si vale 1, la referencia cubre un conjunto de documentos y el folio debe ser exactamente 0.",
"type": "number",
"const": 1
},
"folio": {
"type": "string",
"minLength": 1,
"maxLength": 18,
"description": "Folio o número del documento referenciado, hasta 18 caracteres. Para documentos tributarios (30, 32, 33, 34, 38, 39, 40, 45, 46, 50, 52, 55, 56, 60, 61 y 103) debe ser un entero mayor que 0 sin ceros a la izquierda; usa 0 únicamente junto con indicadorGlobal igual a 1."
},
"fecha": {
"type": "string",
"x-emisso-formato": "AAAA-MM-DD",
"description": "Fecha del documento referenciado, en formato AAAA-MM-DD, entre 2002-08-01 y 2050-12-31."
},
"razon": {
"description": "Razón opcional de la referencia, hasta 90 caracteres.",
"type": "string",
"minLength": 1,
"maxLength": 90
}
},
"required": [
"tipoDocumento",
"folio",
"fecha"
],
"additionalProperties": false,
"description": "Referencia de la factura a otro documento; se permiten entre una y tres."
}
},
"solicitanteRut": {
"description": "RUT opcional de quien solicita el despacho, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"transporte": {
"type": "object",
"properties": {
"transportistaRut": {
"description": "RUT del transportista, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"patente": {
"type": "string",
"minLength": 1,
"maxLength": 8,
"description": "Patente del vehículo, hasta 8 caracteres."
},
"choferRut": {
"description": "RUT del chofer, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"choferNombre": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "Nombre del chofer, hasta 30 caracteres."
}
},
"required": [
"transportistaRut",
"patente",
"choferRut",
"choferNombre"
],
"additionalProperties": false,
"description": "Datos de transporte opcionales. Si van, van completos: transportista, patente y chofer con RUT y nombre, como exige el formulario del portal."
}
},
"required": [
"tipoDte",
"receptor",
"motivoTraslado",
"detalles"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"tipoDte": {
"type": "string",
"const": "56",
"description": "Nota de débito electrónica."
},
"receptor": {
"type": "object",
"properties": {
"rut": {
"description": "RUT chileno del receptor, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"razonSocial": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Razón social legal del receptor."
},
"giro": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Giro comercial del receptor."
},
"direccion": {
"type": "string",
"minLength": 1,
"maxLength": 70,
"description": "Dirección tributaria del receptor."
},
"comuna": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "Comuna de la dirección tributaria del receptor."
},
"ciudad": {
"type": "string",
"minLength": 1,
"maxLength": 15,
"description": "Ciudad de la dirección tributaria del receptor."
}
},
"required": [
"rut",
"razonSocial",
"giro",
"direccion",
"comuna",
"ciudad"
],
"additionalProperties": false,
"description": "Datos obligatorios del receptor; esta variante no admite un campo de contacto."
},
"operacion": {
"type": "string",
"const": "corregir_montos",
"description": "Operación fija de corrección de montos."
},
"referencia": {
"type": "object",
"properties": {
"tipoDteReferido": {
"type": "number",
"const": 34,
"description": "Factura exenta 34 referida por la nota."
},
"folio": {
"type": "string",
"pattern": "^[1-9][0-9]{0,17}$",
"description": "Folio decimal sin cero inicial."
},
"fecha": {
"type": "string",
"x-emisso-formato": "AAAA-MM-DD",
"description": "Fecha de emisión de la factura 34 referida."
},
"razon": {
"type": "string",
"minLength": 1,
"maxLength": 55,
"description": "Razón obligatoria de la corrección de montos."
}
},
"required": [
"tipoDteReferido",
"folio",
"fecha",
"razon"
],
"additionalProperties": false,
"description": "Referencia tributaria principal."
},
"detalles": {
"type": "array",
"prefixItems": [
{
"type": "object",
"properties": {
"nombre": {
"type": "string",
"minLength": 1,
"maxLength": 25,
"description": "Nombre del único ítem de la línea."
},
"cantidad": {
"type": "number",
"description": "Cantidad con mínimo 1, hasta dos decimales y wire máximo de 12 caracteres."
},
"precioUnitario": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 999999999999,
"description": "Precio unitario positivo en pesos chilenos, antes de impuestos. El subtotal de línea, redondeado a entero, debe caber en 10 dígitos."
}
},
"required": [
"nombre",
"cantidad",
"precioUnitario"
],
"additionalProperties": false,
"description": "Única línea de la variante baseline: sin código, unidad, descripción ni descuentos."
}
],
"description": "Una única línea baseline.",
"items": false,
"minItems": 1,
"maxItems": 1
}
},
"required": [
"tipoDte",
"receptor",
"operacion",
"referencia",
"detalles"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"tipoDte": {
"type": "string",
"const": "61",
"description": "Nota de crédito electrónica."
},
"receptor": {
"type": "object",
"properties": {
"rut": {
"description": "RUT chileno del receptor, sin puntos, con guion y DV módulo 11 válido.",
"type": "string"
},
"razonSocial": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Razón social legal del receptor."
},
"giro": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Giro comercial del receptor."
},
"direccion": {
"type": "string",
"minLength": 1,
"maxLength": 70,
"description": "Dirección tributaria del receptor."
},
"comuna": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "Comuna de la dirección tributaria del receptor."
},
"ciudad": {
"type": "string",
"minLength": 1,
"maxLength": 15,
"description": "Ciudad de la dirección tributaria del receptor."
}
},
"required": [
"rut",
"razonSocial",
"giro",
"direccion",
"comuna",
"ciudad"
],
"additionalProperties": false,
"description": "Datos obligatorios del receptor; esta variante no admite un campo de contacto."
},
"operacion": {
"type": "string",
"const": "corregir_montos",
"description": "Operación fija de corrección de montos."
},
"referencia": {
"type": "object",
"properties": {
"tipoDteReferido": {
"type": "number",
"const": 34,
"description": "Factura exenta 34 referida por la nota."
},
"folio": {
"type": "string",
"pattern": "^[1-9][0-9]{0,17}$",
"description": "Folio decimal sin cero inicial."
},
"fecha": {
"type": "string",
"x-emisso-formato": "AAAA-MM-DD",
"description": "Fecha de emisión de la factura 34 referida."
},
"razon": {
"type": "string",
"minLength": 1,
"maxLength": 55,
"description": "Razón obligatoria de la corrección de montos."
}
},
"required": [
"tipoDteReferido",
"folio",
"fecha",
"razon"
],
"additionalProperties": false,
"description": "Referencia tributaria principal."
},
"detalles": {
"type": "array",
"prefixItems": [
{
"type": "object",
"properties": {
"nombre": {
"type": "string",
"minLength": 1,
"maxLength": 25,
"description": "Nombre del único ítem de la línea."
},
"cantidad": {
"type": "number",
"description": "Cantidad con mínimo 1, hasta dos decimales y wire máximo de 12 caracteres."
},
"precioUnitario": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 999999999999,
"description": "Precio unitario positivo en pesos chilenos, antes de impuestos. El subtotal de línea, redondeado a entero, debe caber en 10 dígitos."
}
},
"required": [
"nombre",
"cantidad",
"precioUnitario"
],
"additionalProperties": false,
"description": "Única línea de la variante baseline: sin código, unidad, descripción ni descuentos."
}
],
"description": "Una única línea baseline.",
"items": false,
"minItems": 1,
"maxItems": 1
}
},
"required": [
"tipoDte",
"receptor",
"operacion",
"referencia",
"detalles"
],
"additionalProperties": false
}
],
"description": "Formulario completo de una variante publicada en el schema. La matriz productiva marca las cinco variantes baseline como elegibles para preview (33, 34, 52, 56 y 61); aun ellas requieren que estén abiertas todas las compuertas de rollout, organización, scope, credencial y perfil. El 46 se rechaza antes de red. Usa exactamente una rama y no combines campos entre documentos."
}
},
"required": [
"candidato"
],
"additionalProperties": false
}
```
## Ejemplo [#ejemplo]
```bash title="curl"
curl -X POST https://connect.emisso.ai/api/v1/tools/sii.dte.previsualizar/execute \
-H "Authorization: Bearer connect_sk_…" \
-H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
-H "Content-Type: application/json" \
-d '{"input":{"candidato":{"tipoDte":"33","receptor":{"rut":"77123456-9","razonSocial":"Comercial Los Aromos SpA","giro":"Venta de artículos de oficina","direccion":"Av. Providencia 1234, oficina 501","comuna":"Providencia","ciudad":"Santiago"},"tipoVenta":"del_giro","tipoCompra":"del_giro","condicionPago":{"formaPago":"credito"},"detalles":[{"nombre":"Asesoría contable","cantidad":1,"precioUnitario":450000},{"nombre":"Horas extra","cantidad":2.5,"precioUnitario":32000},{"nombre":"Traslado","cantidad":1,"precioUnitario":18000}],"referencias":[{"tipoDocumento":"801","folio":"OC-4512","fecha":"2026-09-10","razon":"Orden de compra"},{"tipoDocumento":"HES","folio":"7781","fecha":"2026-09-12"}]}}}'
```
```json title="MCP · meta-tool execute"
{
"tool": "sii.dte.previsualizar",
"params": {
"candidato": {
"tipoDte": "33",
"receptor": {
"rut": "77123456-9",
"razonSocial": "Comercial Los Aromos SpA",
"giro": "Venta de artículos de oficina",
"direccion": "Av. Providencia 1234, oficina 501",
"comuna": "Providencia",
"ciudad": "Santiago"
},
"tipoVenta": "del_giro",
"tipoCompra": "del_giro",
"condicionPago": {
"formaPago": "credito"
},
"detalles": [
{
"nombre": "Asesoría contable",
"cantidad": 1,
"precioUnitario": 450000
},
{
"nombre": "Horas extra",
"cantidad": 2.5,
"precioUnitario": 32000
},
{
"nombre": "Traslado",
"cantidad": 1,
"precioUnitario": 18000
}
],
"referencias": [
{
"tipoDocumento": "801",
"folio": "OC-4512",
"fecha": "2026-09-10",
"razon": "Orden de compra"
},
{
"tipoDocumento": "HES",
"folio": "7781",
"fecha": "2026-09-12"
}
]
}
},
"connectionId": "conn_9tKfR2mQx4Vb"
}
```
**Salida esperada (200):**
```json
{
"data": {
"estado": "previsualizado",
"tipoDte": "33",
"variante": "33:del_giro:del_giro:credito",
"fechaEmision": "2026-09-15",
"receptorRut": "77123456-9",
"totales": {
"tributacion": "afecta",
"neto": 548000,
"iva": 104120,
"total": 652120
},
"advertencias": [],
"previewRef": "spt1.1.Xq7Lm2Vt9RbN4c8K.3hVdQ0nWk8ZpT1yFbG6sR9mLc2XeJ5uA7tKqN4wHv0PzY8iDf3oUj6lBr1gSx9Ma.pW3nK8vQz1Lr5Tb9Xh2YcA",
"expiraEn": "2026-09-15T14:15:00.000Z",
"contractVersion": 3
},
"meta": {
"request_id": "req_…",
"tool_id": "sii.dte.previsualizar",
"plane": "action",
"latency_ms": 7410,
"audit_status": "recorded"
}
}
```
> Revisa los totales antes de emitir: los calculó el SII. El `previewRef` es de un solo uso, vence en 15 minutos y se emite con `sii.dte.emitir`. Paso a paso en [Facturas 33 y 34](/docs/emitir/facturas).
## Salida [#salida]
| Campo | Tipo | Requerido | Descripción | | | | | | | | | | | | | | | | | | |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------- | ------------------------------------------------------------------------------------------------------------------------ | ---------------- | ---------------------- | --------------------- | ------------------ | ------- | ------- | ---------- | -------------- | ------- | --- | ----------------- | --- | ------------------------ | -------------------------------------------- | ----------------- | ----------------------- | -- | --------------------------------------------- |
| `estado` | string | sí | Confirma que el flujo terminó en la vista previa y no guardó ni emitió el documento. | | | | | | | | | | | | | | | | | | |
| `tipoDte` | `"33"` · `"34"` · `"52"` · `"56"` · `"61"` | sí | Tipo DTE contemplado por los contratos publicados: 33, 34, 52, 56 o 61. Su presencia no implica habilitación productiva. | | | | | | | | | | | | | | | | | | |
| `variante` | `"33:del_giro:del_giro:credito"` · `"34:del_giro:del_giro:credito"` · `"52:constituye_venta"` · `"52:ventas_por_efectuar"` · `"52:consignacion"` · `"52:entrega_gratuita"` · … | sí | Identidad exacta de la variante tributaria previsualizada. | | | | | | | | | | | | | | | | | | |
| `fechaEmision` | string | sí | Fecha efectiva de emisión mostrada por la vista previa del SII. | | | | | | | | | | | | | | | | | | |
| `receptorRut` | string `^\d{1,8}-[0-9K]$` | sí | RUT canonizado, sin puntos y con guion. | | | | | | | | | | | | | | | | | | |
| `totales` | valor | sí | Totales normalizados desde la vista previa del SII. | | | | | | | | | | | | | | | | | | |
| `advertencias` | lista de objeto | sí | Advertencias no bloqueantes de la previsualización; nunca contiene HTML ni datos ocultos. | | | | | | | | | | | | | | | | | | |
| `advertencias[].codigo` | string | sí | Código estable de una advertencia no bloqueante. | | | | | | | | | | | | | | | | | | |
| `advertencias[].campo` | string | no | Campo al que aplica la advertencia, cuando corresponde. | | | | | | | | | | | | | | | | | | |
| `previewRef` | string | sí | Referencia opaca, sellada y de vida corta que liga esta vista previa a una eventual emisión. | | | | | | | | | | | | | | | | | | |
| `expiraEn` | string \`^(?:(?:\d\d\[2468]\[048] | \d\d\[13579]\[26] | \d\d0\[48] | \[02468]\[048]00 | \[13579]\[26]00)-02-29 | \d{4}-(?:(?:0\[13578] | 1\[02])-(?:0\[1-9] | \[12]\d | 3\[01]) | (?:0\[469] | 11)-(?:0\[1-9] | \[12]\d | 30) | (?:02)-(?:0\[1-9] | 1\d | 2\[0-8])))T(?:(?:\[01]\d | 2\[0-3]):\[0-5]\d(?::\[0-5]\d(?:.\d+)?)?(?:Z | (\[+-]\(?:\[01]\d | 2\[0-3]):\[0-5]\d)))$\` | sí | Instante ISO 8601 con zona horaria explícita. |
| `contractVersion` | entero | sí | Versión del contrato de formulario usada para construir y validar la vista previa. | | | | | | | | | | | | | | | | | | |
JSON Schema de salida
```json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"estado": {
"type": "string",
"const": "previsualizado",
"description": "Confirma que el flujo terminó en la vista previa y no guardó ni emitió el documento."
},
"tipoDte": {
"type": "string",
"enum": [
"33",
"34",
"52",
"56",
"61"
],
"description": "Tipo DTE contemplado por los contratos publicados: 33, 34, 52, 56 o 61. Su presencia no implica habilitación productiva."
},
"variante": {
"type": "string",
"enum": [
"33:del_giro:del_giro:credito",
"34:del_giro:del_giro:credito",
"52:constituye_venta",
"52:ventas_por_efectuar",
"52:consignacion",
"52:entrega_gratuita",
"52:traslado_interno",
"52:otro_traslado_no_venta",
"52:devolucion",
"52:traslado_exportacion_no_venta",
"52:venta_exportacion",
"56:corregir_montos:34_exenta",
"61:corregir_montos:34_exenta"
],
"description": "Identidad exacta de la variante tributaria previsualizada."
},
"fechaEmision": {
"type": "string",
"x-emisso-formato": "AAAA-MM-DD",
"description": "Fecha efectiva de emisión mostrada por la vista previa del SII."
},
"receptorRut": {
"type": "string",
"pattern": "^\\d{1,8}-[0-9K]$",
"description": "RUT canonizado, sin puntos y con guion."
},
"totales": {
"oneOf": [
{
"type": "object",
"properties": {
"tributacion": {
"type": "string",
"const": "afecta",
"description": "Totales afectos a IVA."
},
"neto": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Monto neto calculado por el SII, en CLP."
},
"iva": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "IVA calculado por el SII, en CLP."
},
"total": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Total calculado por el SII, en CLP."
}
},
"required": [
"tributacion",
"neto",
"iva",
"total"
],
"additionalProperties": false,
"description": "Totales de una factura o guía afecta a IVA."
},
{
"type": "object",
"properties": {
"tributacion": {
"type": "string",
"const": "exenta",
"description": "Totales exentos de IVA."
},
"exento": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Monto exento calculado por el SII, en CLP."
},
"total": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Total calculado por el SII, en CLP."
}
},
"required": [
"tributacion",
"exento",
"total"
],
"additionalProperties": false,
"description": "Totales de una factura o nota exenta de IVA."
}
],
"description": "Totales normalizados desde la vista previa del SII."
},
"advertencias": {
"type": "array",
"items": {
"type": "object",
"properties": {
"codigo": {
"type": "string",
"minLength": 1,
"description": "Código estable de una advertencia no bloqueante."
},
"campo": {
"description": "Campo al que aplica la advertencia, cuando corresponde.",
"type": "string",
"minLength": 1
}
},
"required": [
"codigo"
],
"additionalProperties": false,
"description": "Advertencia normalizada y allowlisted."
},
"description": "Advertencias no bloqueantes de la previsualización; nunca contiene HTML ni datos ocultos."
},
"previewRef": {
"type": "string",
"minLength": 1,
"description": "Referencia opaca, sellada y de vida corta que liga esta vista previa a una eventual emisión."
},
"expiraEn": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"description": "Instante ISO 8601 con zona horaria explícita."
},
"contractVersion": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Versión del contrato de formulario usada para construir y validar la vista previa."
}
},
"required": [
"estado",
"tipoDte",
"variante",
"fechaEmision",
"receptorRut",
"totales",
"advertencias",
"previewRef",
"expiraEn",
"contractVersion"
],
"additionalProperties": false
}
```
## Errores de esta tool [#errores-de-esta-tool]
| Código | HTTP | Reintentable | Qué hacer |
| -------------------------------- | ---- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `connection_disabled` | 403 | no | Reactívala en /connections o usa otra conexión del mismo sistema. |
| `connection_not_found` | 404 | no | Usa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada. |
| `connection_credential_required` | 428 | no | Crea un enlace con conexiones.enlace.crear (modo reconectar si la conexión ya existe) y pide a la persona que entregue la credencial de nuevo. No reintentes con la credencial anterior. |
| `connection_busy` | 409 | sí | Espera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez. |
| `upstream_error` | 502 | sí | Reintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración. |
| `timeout` | 504 | sí | Reintenta. Para sincronizaciones largas usa la vía asíncrona y consulta el estado del trabajo. |
Toda llamada puede devolver además los códigos transversales (`validation_error`, `unauthorized`, `scope_not_granted`, `rate_limited`, entre otros): el detalle vive en el [catálogo de errores](/docs/referencia/errores).