openapi: 3.0.3
info:
  title: API Gateway
  description: >-
    Proveemos en [www.apigateway.cl](https://www.apigateway.cl) una API para
    interacturar con diferentes funcionalidades del SII.


    > ¡Tenemos una API que ni el propio SII tiene disponible!


    **Importante**: esta API no está relacionada de ninguna forma con el SII, es
    sólo una pasarela para interactuar con funcionalidades del sitio web del
    SII. No somos parte del SII ni de otra institución pública.


    Si requiere soporte con el uso de la API, por favor [abrir un ticket de
    soporte](https://legacy.apigateway.cl/help).


    **IMPORTANTE** los ejemplos con código de esta documentación son generados
    automáticamente y no representan ejemplos reales ni funcionales.
    Cada usuario deberá construir los códigos necesarios según su lenguaje y
    sistema con la documentación existente. Donde los códigos sugeridos por
    Postman podrían servir de guía, pero nada más.


    **POSTMAN WEB**: Al usar Postman en la web, compartes la IP con otros
    usuarios de Postman web. Por lo que tu cuenta se bloqueará. Usa la
    aplicación de escritorio de Postman. Así usarás tu propia IP en las
    consultas.


    ---

    #### Academia de API Gateway

    La Academia de API Gateway es un espacio diseñado para ayudar a los usuarios a entender y utilizar la API de API Gateway de manera eficiente.


    En la [Academia de API Gateway](/academy) encontrarás una serie de lecciones para aprender a usar la API.

    #### Clientes de la API

    | Lenguaje | Autor | Repositorio |

    | --- | --- | --- |

    | PHP | API Gateway |
    [github.com/apigatewaycl/apigateway-api-client-php](https://github.com/apigatewaycl/apigateway-api-client-php)
    |

    | Python | API Gateway |
    [github.com/apigatewaycl/apigateway-api-client-python](https://github.com/apigatewaycl/apigateway-api-client-python)
    |
  version: 1.0.0
  contact: {}
servers:
  - url: 'https://legacy.apigateway.cl'
paths:
  /api/v1/sii/contribuyentes/situacion_tributaria/tercero/{rut}:
    get:
      tags:
        - API Contribuyentes - Consultas públicas
      summary: Situación Tributaria de un Contribuyente
      description: >-
        **Permiso requerido**: `query contribuyentes`


        **Pasarela a**:
        [https://zeus.sii.cl/cvc/stc/stc.html](https://zeus.sii.cl/cvc/stc/stc.html)


        Permite obtener la situación tributaria de un contribuyente.


        Este método no necesita autenticación en el SII, esto permite que sea un
        método `GET`


        La respuesta incluye:


        - RUT.

        - Razón social.

        - Si tiene o no inicio de actividades.

        - Fecha inicio de actividades.

        - Si tiene autorización para declarar impuestos en moneda extranjera.

        - Si es contribuyente PRO-PYME.

        - El listado de actividades económicas vigentes.

        - Los documentos que ha timbrado y el año del último timbraje.

        - La fecha desde cuando está obligado a emitir sus documentos de manera
        electrónica.

        - Si tiene períodos donde haya estado exento de emitir DTE y el motivo.

        - Observaciones (como inconcurrencia a llamados del SII o posible
        suplantación de identidad).


        Las observaciones específicas que se están considerando son:


        - `inconcurrente` Contribuyente Inconcurrente

        - `suplantado` Contribuyente en riesgo de ser suplantado

        - `no_ubicado` Contribuyente no ubicado

        - `termino_giro` Presentación en trámite término de giro

        - `domicilio_inexistente` Domicilio Inexistente

        - `actividad_esporadica` Contribuyente tasado para realizar actividad
        esporádica

        - `no_habido_domicilio` Contribuyente no es habido en el domicilio
        declarado al SII

        - `termino_giro_obligatorio` Contribuyente obligado a dar aviso de
        Término de Giro
      operationId: situaciNTributariaDeUnContribuyente
      parameters:
        - name: formato
          in: query
          schema:
            type: string
            example: json
      responses:
        '200':
          description: Situación Tributaria de un Contribuyente
          content:
            application/json:
              schema:
                type: object
                properties:
                  actividades:
                    type: array
                    items:
                      type: object
                      properties:
                        afecta:
                          type: boolean
                          example: true
                        categoria:
                          type: number
                          example: 1
                        codigo:
                          type: string
                          example: '619090'
                        glosa:
                          type: string
                          example: OTRAS ACTIVIDADES DE TELECOMUNICACIONES N.C.P.
                    example:
                      - afecta: true
                        categoria: 1
                        codigo: '619090'
                        glosa: OTRAS ACTIVIDADES DE TELECOMUNICACIONES N.C.P.
                      - afecta: true
                        categoria: 1
                        codigo: '620200'
                        glosa: >-
                          ACTIVIDADES DE CONSULTORIA DE INFORMATICA Y DE GESTION
                          DE INSTALACIONE
                  documentos_timbrados:
                    type: array
                    items:
                      type: object
                      properties:
                        documento:
                          type: string
                          example: Factura Electronica
                        ultimo_timbraje:
                          type: number
                          example: 2020
                    example:
                      - documento: Factura Electronica
                        ultimo_timbraje: 2020
                      - documento: Factura No Afecta O Exenta Electronica
                        ultimo_timbraje: 2015
                      - documento: Boleta Electronica
                        ultimo_timbraje: 2019
                      - documento: Boleta Exenta Electronica
                        ultimo_timbraje: 2016
                      - documento: Factura Compra Electronica
                        ultimo_timbraje: 2020
                      - documento: Guia Despacho Electronica
                        ultimo_timbraje: 2016
                      - documento: Nota Debito Electronica
                        ultimo_timbraje: 2015
                      - documento: Nota Credito Electronica
                        ultimo_timbraje: 2020
                      - documento: Boleta De Terceros Electronicas
                        ultimo_timbraje: 2020
                      - documento: Factura De Exportacion Electronica
                        ultimo_timbraje: 2017
                  dv:
                    type: string
                    example: '9'
                  excepcion_dte:
                    type: boolean
                    example: false
                  fecha_inicio_actividades:
                    type: string
                    example: '2012-06-08'
                  inicio_actividades:
                    type: boolean
                    example: true
                  moneda_extranjera:
                    type: boolean
                    example: false
                  obligacion_dte:
                    type: boolean
                    example: true
                  observaciones:
                    type: object
                    properties:
                      actividad_esporadica:
                        type: boolean
                        example: false
                      domicilio_inexistente:
                        type: boolean
                        example: false
                      inconcurrente:
                        type: boolean
                        example: false
                      no_habido_domicilio:
                        type: boolean
                        example: false
                      no_ubicado:
                        type: boolean
                        example: false
                      suplantado:
                        type: boolean
                        example: false
                      termino_giro:
                        type: boolean
                        example: false
                      termino_giro_obligatorio:
                        type: boolean
                        example: false
                  pro_pyme:
                    type: boolean
                    example: true
                  razon_social:
                    type: string
                    example: SASCO SPA
                  rut:
                    type: number
                    example: 76192083
              examples:
                Situación Tributaria de un Contribuyente:
                  value:
                    actividades:
                      - afecta: true
                        categoria: 1
                        codigo: '619090'
                        glosa: OTRAS ACTIVIDADES DE TELECOMUNICACIONES N.C.P.
                      - afecta: true
                        categoria: 1
                        codigo: '620200'
                        glosa: >-
                          ACTIVIDADES DE CONSULTORIA DE INFORMATICA Y DE GESTION
                          DE INSTALACIONE
                    documentos_timbrados:
                      - documento: Factura Electronica
                        ultimo_timbraje: 2020
                      - documento: Factura No Afecta O Exenta Electronica
                        ultimo_timbraje: 2015
                      - documento: Boleta Electronica
                        ultimo_timbraje: 2019
                      - documento: Boleta Exenta Electronica
                        ultimo_timbraje: 2016
                      - documento: Factura Compra Electronica
                        ultimo_timbraje: 2020
                      - documento: Guia Despacho Electronica
                        ultimo_timbraje: 2016
                      - documento: Nota Debito Electronica
                        ultimo_timbraje: 2015
                      - documento: Nota Credito Electronica
                        ultimo_timbraje: 2020
                      - documento: Boleta De Terceros Electronicas
                        ultimo_timbraje: 2020
                      - documento: Factura De Exportacion Electronica
                        ultimo_timbraje: 2017
                    dv: '9'
                    excepcion_dte: false
                    fecha_inicio_actividades: '2012-06-08'
                    inicio_actividades: true
                    moneda_extranjera: false
                    obligacion_dte: true
                    observaciones:
                      actividad_esporadica: false
                      domicilio_inexistente: false
                      inconcurrente: false
                      no_habido_domicilio: false
                      no_ubicado: false
                      suplantado: false
                      termino_giro: false
                      termino_giro_obligatorio: false
                    pro_pyme: true
                    razon_social: SASCO SPA
                    rut: 76192083
    parameters:
      - name: rut
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
  /api/v1/sii/contribuyentes/rut/verificar/{rut}/{serie}:
    get:
      tags:
        - API Contribuyentes - Consultas públicas
      summary: Verificación de Cédula RUT
      description: >-
        **Permiso requerido**: `query contribuyentes`


        **Pasarela a**:
        [https://www4.sii.cl/crepInternet/VerificacionCedula.html](https://www4.sii.cl/crepInternet/VerificacionCedula.html)


        Recurso para verificar la validez de la cédula RUT de empresas chilenas.


        **Experimental**: este recurso podría no entregar una respuesta correcta
        el 100% de las veces. Si tienes problemas, avísanos y revisamos para
        mejorar.
      operationId: verificaciNDeCDulaRut
      responses:
        '200':
          description: Verificación de Cédula RUT
          content:
            application/json:
              schema:
                type: object
                properties:
                  anulada:
                    type: boolean
                    example: false
                  apellido_materno:
                    type: string
                    example: ''
                  apellido_paterno:
                    type: string
                    example: ''
                  contribuyente_dv:
                    type: string
                    example: ''
                  direccion:
                    type: string
                    example: ''
                  fecha:
                    type: string
                    example: '2018-04-02'
                  nombres:
                    type: string
                    example: ''
                  razon_social:
                    type: string
                    example: ''
                  serie:
                    type: number
                    example: 1234
                  usuario_dv:
                    type: string
                    example: ''
              examples:
                Verificación de Cédula RUT:
                  value:
                    anulada: false
                    apellido_materno: ''
                    apellido_paterno: ''
                    contribuyente_dv: ''
                    direccion: ''
                    fecha: '2018-04-02'
                    nombres: ''
                    razon_social: ''
                    serie: 1234
                    usuario_dv: ''
    parameters:
      - name: rut
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
      - name: serie
        in: path
        required: true
        schema:
          type: string
          example: ''
        description: Serie de la cédula de RUT que se desea validar
  /api/v1/sii/contribuyentes/actividades_economicas:
    get:
      tags:
        - API Contribuyentes - Consultas públicas
      summary: Actividades Económicas
      description: >-
        **Permiso requerido**: `query contribuyentes`


        **Pasarela a**:
        [https://www.sii.cl/ayudas/ayudas_por_servicios/1956-codigos-1959.html](https://www.sii.cl/ayudas/ayudas_por_servicios/1956-codigos-1959.html)


        Recurso para obtener el listado de actividades económicas de los
        contribuyentes.
      operationId: actividadesEconMicas
      responses:
        '200':
          description: ''
  /api/v1/sii/misii/representantes/listado:
    post:
      tags:
        - API Contribuyentes - Consultas MiSii - Representantes (otros al contribuyente)
      summary: Representantes del contribuyente
      description: >-
        **Permiso requerido**: `query contribuyentes`


        **Pasarela a**:
        [https://zeusr.sii.cl/cgi_AUT2000/admRPTEBuild.cgi](https://zeusr.sii.cl/cgi_AUT2000/admRPTEBuild.cgi)


        Recurso para obtener el listado de representantes del contribuyente.


        Además se obtiene el listado de posibles permisos que se pueden asignar.
      operationId: representantesDelContribuyente
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              Representantes del contribuyente:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: Respuesta exitosa con datos del representado y sus permisos
          content:
            application/json:
              schema:
                type: object
                properties:
                  representado:
                    type: object
                    properties:
                      rut:
                        type: integer
                        example: 111111111
                      dv:
                        type: string
                        example: "4"
                      nombre:
                        type: string
                        example: "Contribuyente"
                  representantes:
                    type: array
                    items:
                      type: object
                      description: "Representantes asociados (actualmente vacío en el ejemplo)"
                  permisos:
                    type: array
                    items:
                      type: object
                      properties:
                        codigo:
                          type: string
                          example: "MISII"
                        descripcion:
                          type: string
                          example: "Acceso a MiSII"
                        nivel:
                          type: string
                          example: "B"
  /api/v1/sii/misii/representados/listado:
    post:
      tags:
        - API Contribuyentes - Consultas MiSii - Representados (contribuyente a otros)
      summary: Listado contribuyentes representados
      description: >-
        **Permiso requerido**: `query contribuyentes`


        **Pasarela a**:
        [https://zeusr.sii.cl/cgi_AUT2000/admRPDOBuild.cgi](https://zeusr.sii.cl/cgi_AUT2000/admRPDOBuild.cgi)


        Recurso para obtener el listado de representandos autorizados a un
        contribuyente.
      operationId: listadoContribuyentesRepresentados
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: '1111111-1'
            examples:
              Listado contribuyentes representados:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: '1111111-1'
      responses:
        '200':
          description: ''
  /api/v1/sii/misii/representados/representar/{rut}/{permisos}:
    post:
      tags:
        - API Contribuyentes - Consultas MiSii - Representados (contribuyente a otros)
      summary: Representar un contribuyente
      description: >-
        **Permiso requerido**: `query contribuyentes`


        **Pasarela a**:
        [https://zeusr.sii.cl/cgi_AUT2000/admRPDOBuild.cgi](https://zeusr.sii.cl/cgi_AUT2000/admRPDOBuild.cgi)


        Recurso para asignar un contribuyente que se desea representar en la
        siguientes llamadas a la API.
      operationId: representarUnContribuyente
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: '1111111-1'
            examples:
              Representar un contribuyente:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: '1111111-1'
      responses:
        '200':
          description: ''
    parameters:
      - name: rut
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: >-
          RUT del contribuyente que se desea representar en las siguientes
          llamadas a la API.
      - name: permisos
        in: path
        required: true
        schema:
          type: string
          example: MISII
        description: >-
          Códigos de las aplicaciones a las que se desea acceder con la
          representación. Ejemplos: `RPETC`, `SIFM1` o `MISII`.
  /api/v1/sii/misii/contribuyente/datos:
    post:
      tags:
        - API Contribuyentes - Consultas MiSii - Datos del contribuyente
      summary: Datos del contribuyente
      description: >-
        **Permiso requerido**: `query contribuyentes`


        **Pasarela a**:
        [https://misiir.sii.cl/cgi_misii/siihome.cgi](https://misiir.sii.cl/cgi_misii/siihome.cgi)


        Recurso para obtener los datos del contribuyente autenticado en la
        página MiSii.
      operationId: datosDelContribuyente
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              Datos del contribuyente:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: Respuesta con los datos del contribuyente
          content:
            application/json:
              schema:
                type: object
                properties:
                  datos:
                    type: object
                    properties:
                      codigoError:
                        type: integer
                        example: 0
                      descripcionError:
                        type: string
                        example: "OK"
                      sysdate:
                        type: string
                        nullable: true
                      contribuyente:
                        type: object
                        properties:
                          codigoError: { type: integer, example: 0 }
                          descripcionError: { type: string, example: "Contribuyente existe" }
                          sysdate: { type: string, nullable: true }
                          rut: { type: string, example: "1111111" }
                          dv: { type: string, example: "4" }
                          nombres: { type: string, example: "Juan" }
                          apellidoPaterno: { type: string, example: "Perez" }
                          apellidoMaterno: { type: string, example: "Gomez" }
                          razonSocial: { type: string, nullable: true }
                          tipoContribuyenteCodigo: { type: string, example: "1" }
                          tipoContribuyenteDescripcion: { type: string, example: "PERSONA NATURAL" }
                          subtipoContribuyenteCodigo: { type: string, example: "111" }
                          subtipoContribuyenteDescrip: { type: string, example: "PERSONA NATURAL CHILENA" }
                          paisCodigo: { type: string, example: "999" }
                          sexo: { type: string, example: "M" }
                          numeroPasaporte: { type: string, nullable: true }
                          fechaConstitucion: { type: string, nullable: true }
                          fechaNacimiento: { type: string, format: date, example: "1960-02-02" }
                          fechaDefuncion: { type: string, nullable: true }
                          eMail: { type: string, example: "juan.perez@juanperez.com" }
                          fechaCreaRegistroCntr: { type: string, example: "2001-03-05 00:00:00.0" }
                          fechaModiRegistroCntr: { type: string, example: "2019-05-03 09:13:14.0" }
                          telefonoMovil: { type: string, example: "" }
                          fechaTerminoGiro: { type: string, nullable: true }
                          autorizadoDeclararDia20: { type: string, example: "S" }
                          fechaInicioActividades: { type: string, example: "2019-05-02 00:00:00.0" }
                          unidadOperativaCodigo: { type: string, example: "06205" }
                          unidadOperativaDescripcion: { type: string, example: "RANCAGUA" }
                          unidadOperativaDireccion: { type: string, example: "21 DE ABRIL 312, RANCAGUA" }
                          unidadOperativaGcCodigo: { type: string, nullable: true }
                          unidadOperativaGcDescripcion: { type: string, nullable: true }
                          unidadOperativaGcDireccion: { type: string, nullable: true }
                          capitalPorEnterar: { type: string, example: "0" }
                          capitalEnterado: { type: string, example: "0" }
                          fIndVerificacion: { type: string, nullable: true }
                          fechaCreaRegistroNeg: { type: string, example: "2000-05-03 09:13:14.0" }
                          fechaModiRegistroNeg: { type: string, nullable: true }
                          segmentoCodigo: { type: string, example: "SGPE" }
                          segmentoDescripcion: { type: string, example: "PERSONA" }
                          personaEmpresa: { type: string, example: "PERSONA" }
                          glosaActividad: { type: string, example: "ACTIVIDAD ECONOMICA GLOSA" }
                          tipoActuacion: { type: string, nullable: true }
                          descripcionActuacion: { type: string, example: "1" }
                          declaraTG: { type: string, example: "No" }
                          personaMiSii: { type: string, example: "S" }
                      direcciones:
                        type: array
                        items:
                          type: object
                          properties:
                            codigoError: { type: integer, example: 0 }
                            descripcionError: { type: string, example: "Contribuyente posee dirección" }
                            sysdate: { type: string, nullable: true }
                            codigo: { type: string, example: "123456789" }
                            comunaCodigo: { type: string, example: "43231" }
                            comunaDescripcion: { type: string, example: "RANCAGUA" }
                            regionCodigo: { type: string, example: "1" }
                            regionDescripcion: { type: string, example: "REGION DE O'HIGGINS" }
                            tipoDomicilioCodigo: { type: string, example: "1" }
                            tipoDomicilioDescripcion: { type: string, example: "DOMICILIO" }
                            manzana: { type: string, nullable: true }
                            predio: { type: string, nullable: true }
                            calle: { type: string, example: "21 DE ABRIL" }
                            numero: { type: string, example: "312" }
                            bloque: { type: string, nullable: true }
                            departamento: { type: string, nullable: true }
                            villaPoblacion: { type: string, example: "RANCAGUA" }
                            ciudad: { type: string, example: "RANCAGUA" }
                            fax: { type: string, example: "0" }
                            telefono: { type: string, nullable: true }
                            fuente: { type: string, example: "I" }
                            tipoPropiedadCodigo: { type: string, nullable: true }
                            tipoPropiedadDescripcion: { type: string, nullable: true }
                            rutPropietario: { type: string, nullable: true }
                            dvPropietario: { type: string, nullable: true }
                            canon: { type: string, nullable: true }
                            areaTelefono: { type: string, nullable: true }
                            areaFax: { type: string, example: "0" }
                            codigoPostal: { type: string, example: "1313333" }
                            casilla: { type: string, nullable: true }
                            correo: { type: string, nullable: true }
                            mail: { type: string, nullable: true }
                            fechaModiRegistro: { type: string, example: "2000-05-03 09:13:14.0" }
                      atributos:
                        type: array
                        items:
                          type: object
                          properties:
                            rut: { type: integer, example: 1111111 }
                            dv: { type: string, example: "4" }
                            atrCodigo: { type: string, example: "NOTI" }
                            descAtrCodigo: { type: string, example: "CONTRIBUYENTE ES NOTIFICADO POR CORREO ELECTRONICO" }
                            fechaInicio: { type: string, example: "01-05-2025" }
                            valor: { type: string, example: "juan.perez@juanperez.com" }
                            fechaTermino: { type: string, nullable: true }
                            usuarioActivacion: { type: string, example: "S1111111" }
                            usuarioDesactivacion: { type: string, nullable: true }
                            eliminado: { type: string, nullable: true }
                            fechaCreacion: { type: string, example: "01-05-2025" }
                      alertas:
                        type: array
                        items:
                          type: object
                          description: Lista vacía (sin alertas)
                  actividades_economicas:
                    type: array
                    items:
                      type: object
                      properties:
                        codigoError: { type: integer, example: 0 }
                        descripcionError: { type: string, example: "Contribuyente posee actividades económicas" }
                        sysdate: { type: string, nullable: true }
                        codigo: { type: string, example: "1111111" }
                        descripcion: { type: string, example: "ACTIVIDAD ECONOMICA GLOSA" }
                        categoriaTributaria: { type: string, example: "2" }
                        afectoIva: { type: string, example: "N" }
                        fechaInicio: { type: string, example: "02-05-2000" }
                  alertas:
                    type: object
                    properties:
                      codigoError: { type: integer, example: 0 }
                      descripcionError: { type: string, nullable: true }
                      sysdate: { type: string, nullable: true }
                      alertas:
                        type: array
                        items:
                          type: object
                          description: Lista vacía
  /api/v1/sii/indicadores/uf/anual/{anio}/{mes}/{dia}:
    get:
      tags:
        - API SII
      summary: Unidad de fomento (UF)
      description: >-
        **Permiso requerido**: `query sii`


        **Pasarela a**:
        [https://www.sii.cl/valores_y_fechas/uf/uf2023.htm](https://www.sii.cl/valores_y_fechas/uf/uf2023.htm)


        Este recurso permite entregar los datos de 3 formas:


        - Anual

        - Mensual

        - Diaria


        Los valores `:mes` u `:dia` son opcionales.
      operationId: unidadDeFomentoUf
      responses:
        '200':
          description: Valor de la UF de día específico
          content:
            application/json:
              schema:
                type: object
                properties:
                  '20200522':
                    type: number
                    example: 28716.52
              examples:
                Valor de la UF de día específico:
                  value:
                    '20200522': 28716.52
    parameters:
      - name: anio
        in: path
        required: true
        schema:
          type: string
          example: '2023'
        description: Año que se desea consultar el valor de la UF
      - name: mes
        in: path
        required: true
        schema:
          type: string
          example: '12'
        description: Mes que se desea consultar el valor de la UF
      - name: dia
        in: path
        required: true
        schema:
          type: string
          example: '01'
        description: Día que se desea consultar el valor de la UF
  /api/v1/sii/indicadores/correccion_monetaria/anual/{anio}:
    get:
      tags:
        - API SII
      summary: Corrección monetaria
      description: >-
        **Permiso requerido**: `query sii`


        **Pasarela a**:
        [https://www.sii.cl/valores_y_fechas/correccion_monetaria/correccion2023.htm](https://www.sii.cl/valores_y_fechas/correccion_monetaria/correccion2023.htm)


        Este recurso entrega los datos de manera anual. Se debe considerar que
        en el resultado se obtendrá para cada año consultado una lista con los
        valores de la corrección monetaria. Dicha lista tendrá 12 elementos,
        donde:


        - Elemento de índice `0`: es la corrección mensual del "capital
        inicial".

        - Elementos de índices `1` al `11`: es la corrección mensual de los
        meses de enero a noviembre, siendo enero el índice `1` y noviembre el
        índice `11`.


        En diciembre no existe corrección monetaria mensual (pues estamos en el
        mes final).


        Cada elemento de la lista será un diccionario con índices del `1` al
        `12`, enero a diciembre respectivamente.
      operationId: correcciNMonetaria
      responses:
        '200':
          description: Valor de la UF de día específico
          content:
            application/json:
              schema:
                type: object
                properties:
                  '20200522':
                    type: number
                    example: 28716.52
              examples:
                Valor de la UF de día específico:
                  value:
                    '20200522': 28716.52
    parameters:
      - name: anio
        in: path
        required: true
        schema:
          type: string
          example: '2024'
        description: Año que se desea consultar el valor de la corrección monetaria
  /api/v1/sii/indicadores/impuesto_segunda_categoria/anual/{anio}/{mes}:
    get:
      tags:
        - API SII
      summary: Impuesto de segunda categoría
      description: >-
        **Permiso requerido**: `query sii`


        **Pasarela a**:
        [https://www.sii.cl/valores_y_fechas/impuesto_2da_categoria/impuesto2023.htm](https://www.sii.cl/valores_y_fechas/impuesto_2da_categoria/impuesto2023.htm)


        Este recurso permite entregar los datos de 2 formas:


        - Anual

        - Mensual


        El valor `:mes` es opcional.
      operationId: impuestoDeSegundaCategorA
      responses:
        '200':
          description: ''
    parameters:
      - name: anio
        in: path
        required: true
        schema:
          type: string
          example: '2024'
      - name: mes
        in: path
        required: true
        schema:
          type: string
          example: '10'
  /api/v1/sii/dte/caf/solicitar/{emisor}/{dte}/{cantidad}:
    post:
      tags:
        - API DTE - Código de Asignación de Folios (CAF)
      summary: Solicitar CAF
      description: >-
        **Permiso requerido**: `query dte`


        **Pasarela a**: [https://palena.sii.cl/cvc_cgi/dte/of_solicita_folios]()
        (palena o maullin)


        Recurso que permite solicitar un nuevo XML de un CAF al SII.

      operationId: solicitarCaf
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
            examples:
              Solicitar CAF:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
      responses:
        '200':
          description: ''
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT emisor del CAF
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '33'
        description: Tipo de DTE
      - name: cantidad
        in: path
        required: true
        schema:
          type: string
          example: '10'
        description: Cantidad de folios a solicitar
  /api/v1/sii/dte/caf/xml/{emisor}/{dte}/{folio_inicial}/{folio_final}/{fecha_autorizacion}:
    post:
      tags:
        - API DTE - Código de Asignación de Folios (CAF)
      summary: Descargar XML
      description: >-
        **Permiso requerido**: `query dte`


        **Pasarela a**:
        [https://palena.sii.cl/cvc_cgi/dte/rf_reobtencion1_folios]() (palena o
        maullin)
      operationId: descargarXml
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
            examples:
              Descargar XML:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
      responses:
        '200':
          description: ''
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT emisor del CAF
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '33'
        description: Tipo de DTE
      - name: folio_inicial
        in: path
        required: true
        schema:
          type: string
          example: '669'
        description: Folio inicial del CAF
      - name: folio_final
        in: path
        required: true
        schema:
          type: string
          example: '678'
        description: Folio final del CAF
      - name: fecha_autorizacion
        in: path
        required: true
        schema:
          type: string
          example: '2019-11-19'
        description: Fecha de autorización del CAF
  /api/v1/sii/dte/caf/estado/{emisor}/{dte}/{folio}:
    post:
      tags:
        - API DTE - Código de Asignación de Folios (CAF)
      summary: Consultar Estado de un Folio
      description: >-
        **Permiso requerido**: `query dte`


        **Pasarela a**:
        [https://palena.sii.cl/cgi_dte/UPL/DTEauth?2](https://palena.sii.cl/cgi_dte/UPL/DTEauth?2)
        (palena o maullin)
      operationId: consultarEstadoDeUnFolio
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `html`'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
            examples:
              Consultar Estado de un Folio:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
      responses:
        '200':
          description: Consultar Estado de un Folio
          content:
            application/json:
              schema:
                type: object
                properties:
                  estado:
                    type: string
                    example: recibido
                  estado_glosa:
                    type: string
                    example: Documento recibido por el SII
                  track_id:
                    type: string
                    example: '1234'
              examples:
                Consultar Estado de un Folio:
                  value:
                    estado: recibido
                    estado_glosa: Documento recibido por el SII
                    track_id: '1234'
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del emisor del folio
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '33'
        description: Código de DTE del folio
      - name: folio
        in: path
        required: true
        schema:
          type: string
          example: '77'
        description: Folio que se desea consultar
  /api/v1/sii/dte/caf/anular/{emisor}/{dte}/{folio_inicial}/{folio_final}:
    post:
      tags:
        - API DTE - Código de Asignación de Folios (CAF)
      summary: Anulación de Folios
      description: >-
        **Permiso requerido**: `query dte`


        **Pasarela a**:
        [https://palena.sii.cl/cvc_cgi/dte/af_anular1](https://palena.sii.cl/cvc_cgi/dte/af_anular1)
        (palena o maullin)
      operationId: anulaciNDeFolios
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `html`'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
            examples:
              Anulación de Folios:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
      responses:
        '200':
          description: ''
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del emisor del folio
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '33'
        description: Código de DTE del folio
      - name: folio_inicial
        in: path
        required: true
        schema:
          type: string
          example: '707'
        description: Primer folio que se desea anular
      - name: folio_final
        in: path
        required: true
        schema:
          type: string
          example: '707'
        description: Último folio que se desea anular
  /api/v1/sii/dte/caf/solicitudes/{emisor}/{dte}:
    post:
      tags:
        - API DTE - Código de Asignación de Folios (CAF)
      summary: Listado de Folios Solicitados
      description: >-
        **Permiso requerido**: `query dte`


        **Pasarela a**:
        [https://palena.sii.cl/cvc_cgi/dte/rf_reobtencion1_folios](https://palena.sii.cl/cvc_cgi/dte/rf_reobtencion1_folios)
        (palena o maullin)
      operationId: listadoDeFoliosSolicitados
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `html`'
        - name: pagina
          in: query
          schema:
            type: string
            example: '0'
          description: >-
            `0` todas las solicitudes que existan<br/>`>0` página específica de
            las solicitudes de CAF
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
            examples:
              Listado de Folios Solicitados:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
      responses:
        '200':
          description: Listado de Folios Solicitados
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    cantidad:
                      type: number
                      example: 601
                    fecha:
                      type: string
                      example: '2020-07-01'
                    final:
                      type: number
                      example: 6218
                    inicial:
                      type: number
                      example: 5618
                    mandatario:
                      type: string
                      example: ''
                example:
                  - cantidad: 601
                    fecha: '2020-07-01'
                    final: 6218
                    inicial: 5618
                    mandatario: ''
              examples:
                Listado de Folios Solicitados:
                  value:
                    - cantidad: 601
                      fecha: '2020-07-01'
                      final: 6218
                      inicial: 5618
                      mandatario: ''
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del emisor del CAF
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '33'
        description: Código de DTE del CAF
  /api/v1/sii/dte/caf/estados/{emisor}/{dte}/{folio_inicial}/{folio_final}/{estado}:
    post:
      tags:
        - API DTE - Código de Asignación de Folios (CAF)
      summary: Listado de Folios por Estado
      description: >-
        **Permiso requerido**: `query dte`


        **Pasarela a**:
        [https://www4.sii.cl/anulacionMsvDteInternet/](https://www4.sii.cl/anulacionMsvDteInternet/)
        (www4 y www4c)
      operationId: listadoDeFoliosPorEstado
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
            examples:
              Listado de Folios por Estado:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
      responses:
        '200':
          description: Listado de Folios por Estado
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    cantidad:
                      type: string
                      example: '9'
                    final:
                      type: string
                      example: '9'
                    inicial:
                      type: string
                      example: '1'
                example:
                  - cantidad: '9'
                    final: '9'
                    inicial: '1'
                  - cantidad: '1'
                    final: '11'
                    inicial: '11'
                  - cantidad: '31'
                    final: '43'
                    inicial: '13'
                  - cantidad: '2'
                    final: '101'
                    inicial: '100'
              examples:
                Listado de Folios por Estado:
                  value:
                    - cantidad: '9'
                      final: '9'
                      inicial: '1'
                    - cantidad: '1'
                      final: '11'
                      inicial: '11'
                    - cantidad: '31'
                      final: '43'
                      inicial: '13'
                    - cantidad: '2'
                      final: '101'
                      inicial: '100'
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT emisor del CAF
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '52'
        description: Código del DTE
      - name: folio_inicial
        in: path
        required: true
        schema:
          type: string
          example: '1'
        description: Folio inicial a consultar
      - name: folio_final
        in: path
        required: true
        schema:
          type: string
          example: '104'
        description: Folio final a consultar
      - name: estado
        in: path
        required: true
        schema:
          type: string
          example: recibidos
        description: '`recibidos` `anulados` `pendientes`'
  /api/v1/sii/dte/contribuyentes/autorizados:
    post:
      tags:
        - API DTE - Contribuyentes
      summary: Listado Contribuyentes Autorizados
      description: >-
        **Permiso requerido**: `query dte`


        **Pasarela a**:
        [https://palena.sii.cl/cvc/dte/ee_empresas_dte.html](https://palena.sii.cl/cvc/dte/ee_empresas_dte.html)
        (palena o maullin)


        Permite descargar la base de datos de contribuyentes autorizados por el
        SII a operar con documentos tributarios electrónicos.


        Se incluyen los siguientes datos:


        - RUT.

        - Razón social.

        - Número de resolución que autoriza la emisión de DTE.

        - Fecha de resolución que autoriza la emisión de DTE.

        - Correo electrónico de intercambio.

        - Página web declarada en SII del sofware que se usa.


        **Tiempo de respuesta del servicio web**


        Este servicio requiere bastante tiempo para entregar la respuesta,
        puesto que los registros entregados son cercanos al millón. Descargar
        los datos en formato `csv_sii`, en la mayoría de los casos, debiese ser
        más rápido que usar `json` o `csv`.


        **Datos con problemas en formato** **`json`** **o** **`csv`**


        Adicionalmente usar el formato `csv_sii` entregará los datos oficiales
        del SII sin ser manipulados para darles formato `json` o `csv`. API
        Gateway evita manipular los datos del SII, por eso de ser necesario, te
        recomendamos bajar el formato oficial del SII y procesar dicho archivo
        en tu sistema
      operationId: listadoContribuyentesAutorizados
      parameters:
        - name: dia
          in: query
          schema:
            type: string
            example: '2024-10-03'
          description: Día para el cual se desean obtener los contribuyentes
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
        - name: formato
          in: query
          schema:
            type: string
            example: csv_sii
          description: >-
            `json` versión JSON de los datos que vienen en el archivo CSV
            descargado del SII<br/>

            `csv` versión modificada del archivo CSV descargado del SII,
            codificado en UTF-8<br/>

            `csv_sii` versión sin modificar del archivo CSV descargado del SII,
            codificado en ISO-8859-1`0`
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
            examples:
              Listado Contribuyentes Autorizados:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
      responses:
        '200':
          description: ''
  /api/v1/sii/dte/contribuyentes/autorizado/{rut}:
    get:
      tags:
        - API DTE - Contribuyentes
      summary: Estado Autorización de un Contribuyente
      description: >-
        **Permiso requerido**: `query dte`


        **Pasarela a**:
        [https://palena.sii.cl/cvc/dte/ee_empresas_dte.html](https://palena.sii.cl/cvc/dte/ee_empresas_dte.html)
        (palena o maullin)


        Este servicio entrega el estado de autorización de un contribuyente para
        usar Documentos Tributarios Electrónicos (DTE). Se indicará si está o no
        autorizado, la fecha y número de resolución que lo autoriza, la
        dirección regional a la que pertenece el contribuyente y si usa el
        Software del SII Portal MIPYME o Software de Mercado para facturar.


        Además, se entregará un listado de los documentos que el contribuyente
        tiene autorizados a llevar de manera electrónica y desde qué fecha
        cuenta con la autorización del SII para hacerlo.
      operationId: estadoAutorizaciNDeUnContribuyente
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `html`'
      responses:
        '200':
          description: Estado Autorización de un Contribuyente
          content:
            application/json:
              schema:
                type: object
                properties:
                  autorizado:
                    type: boolean
                    example: true
                  direccion_regional:
                    type: string
                    example: VI
                  documentos:
                    type: array
                    items:
                      type: object
                      properties:
                        autorizado:
                          type: string
                          example: '2015-09-01'
                        codigo:
                          type: number
                          example: 33
                        desautorizado:
                          nullable: true
                          example: null
                        descripcion:
                          type: string
                          example: FACTURA ELECTRONICA
                    example:
                      - autorizado: '2015-09-01'
                        codigo: 33
                        desautorizado: null
                        descripcion: FACTURA ELECTRONICA
                      - autorizado: '2015-09-01'
                        codigo: 34
                        desautorizado: null
                        descripcion: FACTURA NO AFECTA O EXENTA ELECTRONICA
                      - autorizado: '2016-03-01'
                        codigo: 39
                        desautorizado: null
                        descripcion: BOLETA ELECTRONICA
                      - autorizado: '2016-03-01'
                        codigo: 41
                        desautorizado: null
                        descripcion: BOLETA EXENTA ELECTRONICA
                      - autorizado: '2016-03-02'
                        codigo: 46
                        desautorizado: null
                        descripcion: FACTURA COMPRA ELECTRONICA
                      - autorizado: '2015-10-27'
                        codigo: 52
                        desautorizado: null
                        descripcion: GUIA DESPACHO ELECTRONICA
                      - autorizado: '2015-09-01'
                        codigo: 56
                        desautorizado: null
                        descripcion: NOTA DEBITO ELECTRONICA
                      - autorizado: '2015-09-01'
                        codigo: 61
                        desautorizado: null
                        descripcion: NOTA CREDITO ELECTRONICA
                      - autorizado: '2016-07-04'
                        codigo: 110
                        desautorizado: null
                        descripcion: FACTURA DE EXPORTACION ELECTRONICA
                      - autorizado: '2016-07-04'
                        codigo: 111
                        desautorizado: null
                        descripcion: NOTA DE DEBITO EXPORTACION ELECTRONICA
                      - autorizado: '2016-07-04'
                        codigo: 112
                        desautorizado: null
                        descripcion: NOTA DE CREDITO EXPORTACION ELECTRONICA
                      - autorizado: '2017-12-07'
                        codigo: 850
                        desautorizado: null
                        descripcion: LIBROS CONTALES ELECTRONICOS
                  razon_social:
                    type: string
                    example: SASCO SPA
                  resolucion:
                    type: object
                    properties:
                      fecha:
                        type: string
                        example: '2014-08-22'
                      numero:
                        type: number
                        example: 80
                  rut:
                    type: string
                    example: 76192083-9
                  software:
                    type: string
                    example: mercado
              examples:
                Estado Autorización de un Contribuyente:
                  value:
                    autorizado: true
                    direccion_regional: VI
                    documentos:
                      - autorizado: '2015-09-01'
                        codigo: 33
                        desautorizado: null
                        descripcion: FACTURA ELECTRONICA
                      - autorizado: '2015-09-01'
                        codigo: 34
                        desautorizado: null
                        descripcion: FACTURA NO AFECTA O EXENTA ELECTRONICA
                      - autorizado: '2016-03-01'
                        codigo: 39
                        desautorizado: null
                        descripcion: BOLETA ELECTRONICA
                      - autorizado: '2016-03-01'
                        codigo: 41
                        desautorizado: null
                        descripcion: BOLETA EXENTA ELECTRONICA
                      - autorizado: '2016-03-02'
                        codigo: 46
                        desautorizado: null
                        descripcion: FACTURA COMPRA ELECTRONICA
                      - autorizado: '2015-10-27'
                        codigo: 52
                        desautorizado: null
                        descripcion: GUIA DESPACHO ELECTRONICA
                      - autorizado: '2015-09-01'
                        codigo: 56
                        desautorizado: null
                        descripcion: NOTA DEBITO ELECTRONICA
                      - autorizado: '2015-09-01'
                        codigo: 61
                        desautorizado: null
                        descripcion: NOTA CREDITO ELECTRONICA
                      - autorizado: '2016-07-04'
                        codigo: 110
                        desautorizado: null
                        descripcion: FACTURA DE EXPORTACION ELECTRONICA
                      - autorizado: '2016-07-04'
                        codigo: 111
                        desautorizado: null
                        descripcion: NOTA DE DEBITO EXPORTACION ELECTRONICA
                      - autorizado: '2016-07-04'
                        codigo: 112
                        desautorizado: null
                        descripcion: NOTA DE CREDITO EXPORTACION ELECTRONICA
                      - autorizado: '2017-12-07'
                        codigo: 850
                        desautorizado: null
                        descripcion: LIBROS CONTALES ELECTRONICOS
                    razon_social: SASCO SPA
                    resolucion:
                      fecha: '2014-08-22'
                      numero: 80
                    rut: 76192083-9
                    software: mercado
    post:
      tags:
        - API DTE - Contribuyentes
      summary: Estado Autorización de un Contribuyente (incluye email)
      description: >-
        **Permiso requerido**: `query dte`


        **Pasarela a**:
        [https://palena.sii.cl/cvc_cgi/dte/ce_consulta_rut](https://palena.sii.cl/cvc_cgi/dte/ce_consulta_rut)
        (palena o maullin)


        Este servicio entrega el estado de autorización de un contribuyente para
        usar Documentos Tributarios Electrónicos (DTE). Se indicará si está o no
        autorizado, la fecha y número de resolución que lo autoriza, la
        dirección regional a la que pertenece el contribuyente y si usa el
        Software del SII Portal MIPYME o Software de Mercado para facturar.


        Además, se entregará un listado de los documentos que el contribuyente
        tiene autorizados a llevar de manera electrónica y desde qué fecha
        cuenta con la autorización del SII para hacerlo.


        Esta consulta, a diferencia de la que es por `GET`, requiere un
        certificado digital para poder obtener el correo electrónico de
        intercambio del contribuyente. Este dato extra es la única diferencia
        entre esta llamada y la que se hace vía `GET`.


        La respuesta se entrega sólo en formato `json`.
      operationId: estadoAutorizaciNDeUnContribuyenteIncluyeEmail
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json``html`'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
            examples:
              Estado Autorización de un Contribuyente (incluye email):
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
      responses:
        '200':
          description: Estado Autorización de un Contribuyente (incluye email)
          content:
            application/json:
              schema:
                type: object
                properties:
                  autorizado:
                    type: boolean
                    example: true
                  direccion_regional:
                    type: string
                    example: VI
                  documentos:
                    type: array
                    items:
                      type: object
                      properties:
                        autorizado:
                          type: string
                          example: '2015-09-01'
                        codigo:
                          type: number
                          example: 33
                        desautorizado:
                          nullable: true
                          example: null
                        descripcion:
                          type: string
                          example: FACTURA ELECTRONICA
                    example:
                      - autorizado: '2015-09-01'
                        codigo: 33
                        desautorizado: null
                        descripcion: FACTURA ELECTRONICA
                      - autorizado: '2015-09-01'
                        codigo: 34
                        desautorizado: null
                        descripcion: FACTURA NO AFECTA O EXENTA ELECTRONICA
                      - autorizado: '2016-03-01'
                        codigo: 39
                        desautorizado: null
                        descripcion: BOLETA ELECTRONICA
                      - autorizado: '2016-03-01'
                        codigo: 41
                        desautorizado: null
                        descripcion: BOLETA EXENTA ELECTRONICA
                      - autorizado: '2016-03-02'
                        codigo: 46
                        desautorizado: null
                        descripcion: FACTURA COMPRA ELECTRONICA
                      - autorizado: '2015-10-27'
                        codigo: 52
                        desautorizado: null
                        descripcion: GUIA DESPACHO ELECTRONICA
                      - autorizado: '2015-09-01'
                        codigo: 56
                        desautorizado: null
                        descripcion: NOTA DEBITO ELECTRONICA
                      - autorizado: '2015-09-01'
                        codigo: 61
                        desautorizado: null
                        descripcion: NOTA CREDITO ELECTRONICA
                      - autorizado: '2016-07-04'
                        codigo: 110
                        desautorizado: null
                        descripcion: FACTURA DE EXPORTACION ELECTRONICA
                      - autorizado: '2016-07-04'
                        codigo: 111
                        desautorizado: null
                        descripcion: NOTA DE DEBITO EXPORTACION ELECTRONICA
                      - autorizado: '2016-07-04'
                        codigo: 112
                        desautorizado: null
                        descripcion: NOTA DE CREDITO EXPORTACION ELECTRONICA
                      - autorizado: '2017-12-07'
                        codigo: 850
                        desautorizado: null
                        descripcion: LIBROS CONTALES ELECTRONICOS
                  emails:
                    type: object
                    properties:
                      intercambio:
                        type: string
                        example: dte@example.com
                  razon_social:
                    type: string
                    example: SASCO SPA
                  resolucion:
                    type: object
                    properties:
                      fecha:
                        type: string
                        example: '2014-08-22'
                      numero:
                        type: number
                        example: 80
                  rut:
                    type: string
                    example: 76192083-9
                  software:
                    type: string
                    example: mercado
              examples:
                Estado Autorización de un Contribuyente (incluye email):
                  value:
                    autorizado: true
                    direccion_regional: VI
                    documentos:
                      - autorizado: '2015-09-01'
                        codigo: 33
                        desautorizado: null
                        descripcion: FACTURA ELECTRONICA
                      - autorizado: '2015-09-01'
                        codigo: 34
                        desautorizado: null
                        descripcion: FACTURA NO AFECTA O EXENTA ELECTRONICA
                      - autorizado: '2016-03-01'
                        codigo: 39
                        desautorizado: null
                        descripcion: BOLETA ELECTRONICA
                      - autorizado: '2016-03-01'
                        codigo: 41
                        desautorizado: null
                        descripcion: BOLETA EXENTA ELECTRONICA
                      - autorizado: '2016-03-02'
                        codigo: 46
                        desautorizado: null
                        descripcion: FACTURA COMPRA ELECTRONICA
                      - autorizado: '2015-10-27'
                        codigo: 52
                        desautorizado: null
                        descripcion: GUIA DESPACHO ELECTRONICA
                      - autorizado: '2015-09-01'
                        codigo: 56
                        desautorizado: null
                        descripcion: NOTA DEBITO ELECTRONICA
                      - autorizado: '2015-09-01'
                        codigo: 61
                        desautorizado: null
                        descripcion: NOTA CREDITO ELECTRONICA
                      - autorizado: '2016-07-04'
                        codigo: 110
                        desautorizado: null
                        descripcion: FACTURA DE EXPORTACION ELECTRONICA
                      - autorizado: '2016-07-04'
                        codigo: 111
                        desautorizado: null
                        descripcion: NOTA DE DEBITO EXPORTACION ELECTRONICA
                      - autorizado: '2016-07-04'
                        codigo: 112
                        desautorizado: null
                        descripcion: NOTA DE CREDITO EXPORTACION ELECTRONICA
                      - autorizado: '2017-12-07'
                        codigo: 850
                        desautorizado: null
                        descripcion: LIBROS CONTALES ELECTRONICOS
                    emails:
                      intercambio: dte@example.com
                    razon_social: SASCO SPA
                    resolucion:
                      fecha: '2014-08-22'
                      numero: 80
                    rut: 76192083-9
                    software: mercado
    parameters:
      - name: rut
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del contribuyente que se desea consultar
  /api/v1/sii/dte/contribuyentes/datos/{contribuyente}:
    post:
      tags:
        - API DTE - Contribuyentes
      summary: Datos Privados de un Contribuyente
      description: >-
        **Permiso requerido**: `query dte`


        **Pasarela a:**
        [https://palena.sii.cl/cvc_cgi/dte/ad_empresa1](https://palena.sii.cl/cvc_cgi/dte/ad_empresa1)
        (palena o maullin)
      operationId: datosPrivadosDeUnContribuyente
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `html`'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
            examples:
              Datos Privados de un Contribuyente:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
      responses:
        '200':
          description: Datos Personales de un Contribuyente
          content:
            application/json:
              schema:
                type: object
                properties:
                  autorizado:
                    type: string
                    example: '2015-09-14'
                  emails:
                    type: object
                    properties:
                      administrador:
                        type: string
                        example: administrador@example.com
                      intercambio:
                        type: string
                        example: dte@example.com
                      sii:
                        type: string
                        example: dte@example.com
                  razon_social:
                    type: string
                    example: SASCO SPA
                  resolucion:
                    type: object
                    properties:
                      fecha:
                        type: string
                        example: '2014-08-22'
                      numero:
                        type: number
                        example: 80
                  rut:
                    type: string
                    example: 76192083-9
                  software:
                    type: object
                    properties:
                      nombre:
                        type: string
                        example: LIBREDTE
                      url:
                        type: string
                        example: www.libredte.cl
              examples:
                Datos Personales de un Contribuyente:
                  value:
                    autorizado: '2015-09-14'
                    emails:
                      administrador: administrador@example.com
                      intercambio: dte@example.com
                      sii: dte@example.com
                    razon_social: SASCO SPA
                    resolucion:
                      fecha: '2014-08-22'
                      numero: 80
                    rut: 76192083-9
                    software:
                      nombre: LIBREDTE
                      url: www.libredte.cl
    parameters:
      - name: contribuyente
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del contribuyente que se desea consultar
  /api/v1/sii/dte/contribuyentes/set_datos/{contribuyente}:
    post:
      tags:
        - API DTE - Contribuyentes
      summary: Asignar Datos Privados de un Contribuyente
      description: >-
        **Permiso requerido**: `query dte`


        **Pasarela a:**
        [https://palena.sii.cl/cvc_cgi/dte/ad_empresa1](https://palena.sii.cl/cvc_cgi/dte/ad_empresa1)
        (palena o maullin)
      operationId: asignarDatosPrivadosDeUnContribuyente
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
                datos:
                  type: object
                  properties:
                    emails:
                      type: object
                      properties:
                        administrador:
                          type: string
                          example: esteban@example.com
                        intercambio:
                          type: string
                          example: dte@example.com
                        sii:
                          type: string
                          example: sii@example.com
                    software:
                      type: object
                      properties:
                        nombre:
                          type: string
                          example: LibreDTE
                        url:
                          type: string
                          example: libredte.cl
            examples:
              Asignar Datos Privados de un Contribuyente:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
                  datos:
                    emails:
                      administrador: esteban@example.com
                      intercambio: dte@example.com
                      sii: sii@example.com
                    software:
                      nombre: LibreDTE
                      url: libredte.cl
      responses:
        '200':
          description: ''
    parameters:
      - name: contribuyente
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del contribuyente que se desea modificar
  /api/v1/sii/dte/contribuyentes/usuarios/{rut}:
    post:
      tags:
        - API DTE - Contribuyentes
      summary: Usuarios Autorizados de un Contribuyente
      description: >-
        **Permiso requerido**: `query dte`


        **Pasarela a:**
        [https://palena.sii.cl/cvc_cgi/dte/eu_enrola_usuarios](https://palena.sii.cl/cvc_cgi/dte/eu_enrola_usuarios)
        (palena o maullin)
      operationId: usuariosAutorizadosDeUnContribuyente
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `html`'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
            examples:
              Usuarios Autorizados de un Contribuyente:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
      responses:
        '200':
          description: Usuarios Autorizados de un Contribuyente
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    nombre:
                      type: string
                      example: ''
                    permisos:
                      type: object
                      properties:
                        administrador:
                          type: boolean
                          example: true
                        anular_folios:
                          type: boolean
                          example: true
                        consultar:
                          type: boolean
                          example: true
                        enviar:
                          type: boolean
                          example: true
                        firmar:
                          type: boolean
                          example: true
                        solicitar_folios:
                          type: boolean
                          example: true
                    run:
                      type: string
                      example: 1-9
                example:
                  - nombre: ''
                    permisos:
                      administrador: true
                      anular_folios: true
                      consultar: true
                      enviar: true
                      firmar: true
                      solicitar_folios: true
                    run: 1-9
                  - nombre: ''
                    permisos:
                      administrador: false
                      anular_folios: true
                      consultar: true
                      enviar: true
                      firmar: true
                      solicitar_folios: true
                    run: 2-7
              examples:
                Usuarios Autorizados de un Contribuyente:
                  value:
                    - nombre: ''
                      permisos:
                        administrador: true
                        anular_folios: true
                        consultar: true
                        enviar: true
                        firmar: true
                        solicitar_folios: true
                      run: 1-9
                    - nombre: ''
                      permisos:
                        administrador: false
                        anular_folios: true
                        consultar: true
                        enviar: true
                        firmar: true
                        solicitar_folios: true
                      run: 2-7
    parameters:
      - name: rut
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del contribuyente que se desea consultar sus usuarios autorizados
  /api/v1/sii/dte/contribuyentes/set_usuario/{contribuyente}:
    post:
      tags:
        - API DTE - Contribuyentes
      summary: Asignar Usuarios Autorizados a un Contribuyente
      description: >-
        **Permiso requerido**: `query dte`


        **Pasarela a:**
        [https://palena.sii.cl/cvc_cgi/dte/eu_enrola_usuarios](https://palena.sii.cl/cvc_cgi/dte/eu_enrola_usuarios)
        (palena o maullin)
      operationId: asignarUsuariosAutorizadosAUnContribuyente
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
                usuario:
                  type: object
                  properties:
                    permisos:
                      type: object
                      properties:
                        administrador:
                          type: boolean
                          example: false
                        anular_folios:
                          type: boolean
                          example: true
                        consultar:
                          type: boolean
                          example: true
                        enviar:
                          type: boolean
                          example: true
                        firmar:
                          type: boolean
                          example: true
                        solicitar_folios:
                          type: boolean
                          example: true
                    run:
                      type: string
                      example: 66666666-6
            examples:
              Asignar Usuarios Autorizados a un Contribuyente:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
                  usuario:
                    permisos:
                      administrador: false
                      anular_folios: true
                      consultar: true
                      enviar: true
                      firmar: true
                      solicitar_folios: true
                    run: 66666666-6
      responses:
        '200':
          description: ''
    parameters:
      - name: contribuyente
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del contribuyente que se desea modificar
  /api/v1/sii/dte/emitidos/estado_envio/{emisor}/{track_id}:
    post:
      tags:
        - API DTE - Documentos Emitidos
      summary: Estado de un envío de XML al SII
      description: >-
        **Permiso requerido**: `query dte`


        **Pasarela a**:
        [https://palena.sii.cl/cgi_dte/UPL/DTEauth?3](https://palena.sii.cl/cgi_dte/UPL/DTEauth?3)
        (palena o maullin)


        Entrega el estado del envío de un XML de DTE al SII.


        **Nota**: solo se pueden consultar por envíoa al SII de empresas que el
        usuario autenticado con certificado digital tenga acceso.
      operationId: estadoDeUnEnvODeXmlAlSii
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `html`'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
            examples:
              Estado de un envío de XML al SII:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
      responses:
        '200':
          description: Estado de un envío de XML al SII
          content:
            application/json:
              schema:
                type: object
                properties:
                  documentos:
                    type: object
                    properties:
                      '33':
                        type: object
                        properties:
                          aceptados:
                            type: number
                            example: 1
                          dte:
                            type: number
                            example: 33
                          informados:
                            type: number
                            example: 1
                          rechazados:
                            type: number
                            example: 0
                          reparos:
                            type: number
                            example: 0
                          total:
                            type: number
                            example: 1
                  emisor:
                    type: string
                    example: 76192083-9
                  estado:
                    type: string
                    example: Envio Procesado [EPR].
                  track_id:
                    type: string
                    example: '1234'
              examples:
                Estado de un envío de XML al SII:
                  value:
                    documentos:
                      '33':
                        aceptados: 1
                        dte: 33
                        informados: 1
                        rechazados: 0
                        reparos: 0
                        total: 1
                    emisor: 76192083-9
                    estado: Envio Procesado [EPR].
                    track_id: '1234'
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del emisor del envío al SII
      - name: track_id
        in: path
        required: true
        schema:
          type: string
          example: '10023246938'
        description: Número de seguimiento asignado por el SII
  /api/v1/sii/dte/emitidos/verificar:
    post:
      tags:
        - API DTE - Documentos Emitidos
      summary: Verificación Avanzada de un Documento en SII
      description: >-
        **Permiso requerido**: `query dte`


        **Pasarela a**:
        [https://www.sii.cl/factura_electronica/factura_mercado/OIFE2006_QueryEstDteAv_MDE.pdf](https://www.sii.cl/factura_electronica/factura_mercado/OIFE2006_QueryEstDteAv_MDE.pdf)


        Este recurso permite hacer una verificación avanzada de un documento
        emitido enviado al SII.


        Lo más importante, permite verificar que la firma electrónica del DTE
        consultado corresponda con la firma electrónica que el SII tiene
        registrada para el DTE enviado.


        En la respuesta se encontrará la siguiente información:


        - Estado del envío del XML al SII.

        - Track ID del envío.

        - Si la firma coincide o no con la registrada por SII.

        - Eventos que el DTE tenga asociados al acuse de recibo.

        - Si el documento es o no cedible.

        - Fecha de recepción del DTE en el SII.
      operationId: verificaciNAvanzadaDeUnDocumentoEnSii
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
                dte:
                  type: object
                  properties:
                    dte:
                      type: number
                      example: 33
                    emisor:
                      type: string
                      example: 76192083-9
                    fecha:
                      type: string
                      example: '2017-10-01'
                    firma:
                      type: string
                      example: >-
                        pnaJ2qw49PttDIfh5b+xkHW+pToZLzRF2yxVPmKADzjAHTa8RB5tYKjp2eHtQPByta0L7BQgL1KujJeqYk2qMakucRL0GckQgzqrMFL+NEWf+hSZXHnhOtti00i0ZvEb8kDdViTWSxUKQX08qHQSm/KMjNAeCXMlRIXv/rEx112yQsX3pbxKs9uGNER9MwWS7nTakM9WQFllSXmSdty51Y429XX2LA4hrSyv3EZfWvWItUiPBRzWnS2LbG2j10WYmbsN173WUxYpqIN6VzP5Z6iEWknYLDI8wErIwA9yNbAxqB9QTQ+W782V16dJD5scT/wnfH06UkCskiN9gxLfeg==
                    folio:
                      type: number
                      example: 1000
                    receptor:
                      type: string
                      example: 76524238-K
                    total:
                      type: number
                      example: 31724
            examples:
              Verificación Avanzada de un Documento en SII:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
                  dte:
                    dte: 33
                    emisor: 76192083-9
                    fecha: '2017-10-01'
                    firma: >-
                      pnaJ2qw49PttDIfh5b+xkHW+pToZLzRF2yxVPmKADzjAHTa8RB5tYKjp2eHtQPByta0L7BQgL1KujJeqYk2qMakucRL0GckQgzqrMFL+NEWf+hSZXHnhOtti00i0ZvEb8kDdViTWSxUKQX08qHQSm/KMjNAeCXMlRIXv/rEx112yQsX3pbxKs9uGNER9MwWS7nTakM9WQFllSXmSdty51Y429XX2LA4hrSyv3EZfWvWItUiPBRzWnS2LbG2j10WYmbsN173WUxYpqIN6VzP5Z6iEWknYLDI8wErIwA9yNbAxqB9QTQ+W782V16dJD5scT/wnfH06UkCskiN9gxLfeg==
                    folio: 1000
                    receptor: 76524238-K
                    total: 31724
      responses:
        '200':
          description: Verificación Avanzada de un Documento en SII
          content:
            application/json:
              schema:
                type: object
                properties:
                  cedible:
                    type: object
                    properties:
                      codigo:
                        type: number
                        example: 25
                      glosa:
                        type: string
                        example: >-
                          DTE Cedible, habiendo pasado 8 días se entiende dado
                          acuse de recibo
                  datos:
                    type: object
                    properties:
                      detalle:
                        type: string
                        example: >-
                          Documento Recibido por el SII. Datos Coinciden con los
                          Registrados
                      estado:
                        type: string
                        example: DOK
                      firma:
                        type: boolean
                        example: true
                      track_id:
                        type: number
                        example: 1234
                  eventos:
                    type: array
                    items:
                      type: object
                      properties:
                        codigo:
                          type: string
                          example: ERM
                        fecha:
                          type: string
                          example: 05-10-2017 13:40:47
                        glosa:
                          type: string
                          example: >-
                            Acuse de  Recibo de Mercaderías y Servicios Ley
                            19.983
                        responsable:
                          type: string
                          example: 1-9
                    example:
                      - codigo: ERM
                        fecha: 05-10-2017 13:40:47
                        glosa: Acuse de  Recibo de Mercaderías y Servicios Ley 19.983
                        responsable: 1-9
                  fecha_recepcion:
                    type: string
                    example: '2017-10-02 17:56:36'
              examples:
                Verificación Avanzada de un Documento en SII:
                  value:
                    cedible:
                      codigo: 25
                      glosa: >-
                        DTE Cedible, habiendo pasado 8 días se entiende dado
                        acuse de recibo
                    datos:
                      detalle: >-
                        Documento Recibido por el SII. Datos Coinciden con los
                        Registrados
                      estado: DOK
                      firma: true
                      track_id: 1234
                    eventos:
                      - codigo: ERM
                        fecha: 05-10-2017 13:40:47
                        glosa: Acuse de  Recibo de Mercaderías y Servicios Ley 19.983
                        responsable: 1-9
                    fecha_recepcion: '2017-10-02 17:56:36'
  /api/v1/sii/dte/iecv/codigo_reemplazo/{emisor}/{periodo}/{operacion}/{tipo}/{track_id}:
    post:
      tags:
        - API DTE - Información Electrónica de Compras y Ventas
      summary: Obtener Código de Reemplazo de Libro
      description: >-
        **Permiso requerido**: `query dte`


        **Pasarela a**:
        [https://palena.sii.cl/cgi_dte/UPL/DTEauth?11](https://palena.sii.cl/cgi_dte/UPL/DTEauth?11)
        (palena o maullin)


        Recurso que entrega el código de reemplazo de libro de compras o ventas
        para poder rectificar un libro.


        Nota: sólo para períodos de 201707 hacia atrás.
      operationId: obtenerCDigoDeReemplazoDeLibro
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
            examples:
              Obtener Código de Reemplazo de Libro:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
      responses:
        '200':
          description: ''
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del emisor del libro
      - name: periodo
        in: path
        required: true
        schema:
          type: string
          example: '201707'
        description: Período del libro
      - name: operacion
        in: path
        required: true
        schema:
          type: string
          example: VENTA
        description: '`VENTA` `COMPRA`'
      - name: tipo
        in: path
        required: true
        schema:
          type: string
          example: MENSUAL
        description: '`MENSUAL` `RECTIFICA`'
      - name: track_id
        in: path
        required: true
        schema:
          type: string
          example: '61325006'
        description: Identificador del envío del libro que se desea reemplazar
  /api/v1/sii/rcv/compras/resumen/{receptor}/{periodo}/{estado}:
    post:
      tags:
        - API RCV - Registro de Compras
      summary: Resumen de Compras
      description: >-
        **Permiso requerido**: `query rcv`


        **Pasarela a**:
        [https://www4.sii.cl/consdcvinternetui/#/index](https://www4.sii.cl/consdcvinternetui/#/index)
        (www4 o www4c)
      operationId: resumenDeCompras
      parameters:
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `csv`'
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
        - name: csv_delimiter
          in: query
          schema:
            type: string
            example: ;
          description: Delimitador que se debe usar en el formato CSV
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              Resumen de Compras:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: Resumen de Compras
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        dcvCodigo:
                          type: number
                          example: 1234
                        dcvNombreTipoDoc:
                          type: string
                          example: Factura Electrónica
                        dcvOperacion:
                          nullable: true
                          example: null
                        dcvTipoIngresoDoc:
                          type: string
                          example: DET_ELE
                        rsmnCodigo:
                          type: number
                          example: 1234
                        rsmnEstadoContab:
                          nullable: true
                          example: null
                        rsmnIVAUsoComun:
                          type: number
                          example: 0
                        rsmnLink:
                          type: boolean
                          example: true
                        rsmnMntExe:
                          type: number
                          example: 0
                        rsmnMntIVA:
                          type: number
                          example: 0
                        rsmnMntIVANoRec:
                          type: number
                          example: 0
                        rsmnMntNeto:
                          type: number
                          example: 0
                        rsmnMntTotal:
                          type: number
                          example: 0
                        rsmnTipoDocInteger:
                          type: number
                          example: 33
                        rsmnTotDoc:
                          type: number
                          example: 1
                        rsmnTotalRutEmisor:
                          nullable: true
                          example: null
                    example:
                      - dcvCodigo: 1234
                        dcvNombreTipoDoc: Factura Electrónica
                        dcvOperacion: null
                        dcvTipoIngresoDoc: DET_ELE
                        rsmnCodigo: 1234
                        rsmnEstadoContab: null
                        rsmnIVAUsoComun: 0
                        rsmnLink: true
                        rsmnMntExe: 0
                        rsmnMntIVA: 0
                        rsmnMntIVANoRec: 0
                        rsmnMntNeto: 0
                        rsmnMntTotal: 0
                        rsmnTipoDocInteger: 33
                        rsmnTotDoc: 1
                        rsmnTotalRutEmisor: null
                      - dcvCodigo: 1234
                        dcvNombreTipoDoc: Factura no Afecta o Exenta Electrónica
                        dcvOperacion: null
                        dcvTipoIngresoDoc: DET_ELE
                        rsmnCodigo: 1234
                        rsmnEstadoContab: null
                        rsmnIVAUsoComun: 0
                        rsmnLink: true
                        rsmnMntExe: 0
                        rsmnMntIVA: 0
                        rsmnMntIVANoRec: 0
                        rsmnMntNeto: 0
                        rsmnMntTotal: 0
                        rsmnTipoDocInteger: 34
                        rsmnTotDoc: 1
                        rsmnTotalRutEmisor: null
              examples:
                Resumen de Compras:
                  value:
                    data:
                      - dcvCodigo: 1234
                        dcvNombreTipoDoc: Factura Electrónica
                        dcvOperacion: null
                        dcvTipoIngresoDoc: DET_ELE
                        rsmnCodigo: 1234
                        rsmnEstadoContab: null
                        rsmnIVAUsoComun: 0
                        rsmnLink: true
                        rsmnMntExe: 0
                        rsmnMntIVA: 0
                        rsmnMntIVANoRec: 0
                        rsmnMntNeto: 0
                        rsmnMntTotal: 0
                        rsmnTipoDocInteger: 33
                        rsmnTotDoc: 1
                        rsmnTotalRutEmisor: null
                      - dcvCodigo: 1234
                        dcvNombreTipoDoc: Factura no Afecta o Exenta Electrónica
                        dcvOperacion: null
                        dcvTipoIngresoDoc: DET_ELE
                        rsmnCodigo: 1234
                        rsmnEstadoContab: null
                        rsmnIVAUsoComun: 0
                        rsmnLink: true
                        rsmnMntExe: 0
                        rsmnMntIVA: 0
                        rsmnMntIVANoRec: 0
                        rsmnMntNeto: 0
                        rsmnMntTotal: 0
                        rsmnTipoDocInteger: 34
                        rsmnTotDoc: 1
                        rsmnTotalRutEmisor: null
    parameters:
      - name: receptor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del receptor de los documentos
      - name: periodo
        in: path
        required: true
        schema:
          type: string
          example: '202410'
        description: Período del registro
      - name: estado
        in: path
        required: true
        schema:
          type: string
          example: REGISTRO
        description: '`REGISTRO` `PENDIENTE` `NO_INCLUIR` `RECLAMADO`'
  /api/v1/sii/rcv/compras/detalle/{receptor}/{periodo}/{dte}/{estado}:
    post:
      tags:
        - API RCV - Registro de Compras
      summary: Detalle de Compras
      description: >-
        **Permiso requerido**: `query rcv`


        **Pasarela a**:
        [https://www4.sii.cl/consdcvinternetui/#/index](https://www4.sii.cl/consdcvinternetui/#/index)
        (www4 o www4c)


        Recurso para obtener el detalle de las compras a partir de los datos del
        Registro de Compras.


        El detalle es el listado de documentos de cierto tipo disponibles en el
        registro de compras. En ningún caso este recurso entregará el listado de
        items (productos o servicios) de cada documento. Esto no es posible
        porque ese dato no se encuentra en el listado de documentos del registro
        de compras.


        **Archivo en CSV del RCV del SII**


        Se pueden obtener los datos en distintos tipos. Sin embargo, el tipo
        `rcv_csv` tiene ciertas ventajas:


        - No es necesario indicar el código de DTE, se recomienda usar 0 para el
        campo `dte` en la URL ya que no se usa. Siempre se obtienen todos los
        tipos de documentos del período.

        - Permite obtener los datos de impuestos específicos.

        - En general, debería ser el tipo con mejor tiempo de respuesta.


        Considerar adicionalmente, que es más rápido usar el tipo `rcv_csv` con
        el formato `csv`.


        **Importante**: el tipo `rcv_csv` y formato `json` sólo funciona con el
        estado `REGISTRO`. No es posible bajar otros estados con este tipo y
        formato de datos. Si desea utilizar el topo `rcv_csv` con otro estado
        deberá usar el formato `csv`.


        **Respuesta**


        La respuesta incluirá por defecto los datos obtenidos directamente desde
        el SII, donde los campos vienen desde el SII. Se recomienda revisar el
        registro de compras para ir comparando aquellos campos que no se
        entienda a partir de su nombre lo que significan. Adjuntamos una
        descripción general de los campos:


        - `detTipoDoc`: código del tipo de DTE recibido.

        - `detRutDoc`: RUT del proveedor, sin dígito verificador.

        - `detDvDoc`: dígito verificador del RUT del proveedor.

        - `detRznSoc`: razón social del proveedor.

        - `detNroDoc`: folio del DTE recibido.

        - `detFchDoc`: fecha de emisión del DTE recibido.

        - `detFecAcuse`: fecha en que el receptor generó el acuse de recibido
        (si es que se generó).

        - `detFecReclamado`: fecha en que el receptor generó el reclamo (si es
        que se generó).

        - `detFecRecepcion`: fecha de recepción del XML del DTE por parte del
        SII.

        - `detMntExe`: total monto exento.

        - `detMntNeto`: total monto neto.

        - `detMntIVA`: total monto IVA.

        - `detMntTotal`: total del documento.

        - `detTipoDocRef`: código del tipo de DTE de la referencia en el DTE
        recibido.

        - `detFolioDocRef`: folio del DTE referenciado en el documento de
        compra.

        - `detEventoReceptor`: código del evento que a realizado el receptor (si
        se ha realizado).

        - `detEventoReceptorLeyenda`: glosa del evento que a realizado el
        receptor (si se ha realizado).

        - `detPcarga`: período contable en el que corresponde registrar este
        documento de compra.

        - `detMntActFijo`: Corresponde al monto del activo fijo del DTE (si fue
        clasificado como activo fijo).

        - `detMntIVAActFijo`: Monto del IVA del activo fijo del DTE (si fue
        clasificado como activo fijo).

        - `detMntIVANoRec`: Monto IVA no recuperable del DTE.

        - `detMntCodNoRec`: corresponde el código del IVA no recuperable (si es
        que hay IVA no recuperable).

        - `detAnulado`: cantidad de documentos anulados.

        - `detMntSinCredito`: es el monto del IVA sin derecho a crédito fiscal.

        - `detCdgSIISucur`: corresponde al código de la sucursal registrada en
        el SII.

        - `detIndServicio`: código del indicador de servicio.

        - `detTipoTransaccion`: tipo de transacción del documento.

        - `detIndSinCosto`: indica si la compra es sin costo (solo en facturas).

        - `detIVAFueraPlazo`: valor del total del IVA que está fuera de plazo,
        sólo aplica para notas de crédito.

        - `detMntNoFact`: monto no facturable del DTE.

        - `detIVATerceros`: monto del IVA terceros, sólo cuando hay venta o
        servicio por cuenta de terceros.

        - `detMntPeriodo`: se refiere a la cantidad o monto de dinero declarado
        durante un período determinado. Este valor puede ser negativo.

        - `detCredEc`: es el crédito especial del 65% para Empresas
        Constructoras.

        - `detIVAPropio`: se refiere al monto del Impuesto al Valor Agregado
        (IVA) propio que ha sido declarado durante un período determinado.
        Aplica sólo cuando hay venta o servicio por cuenta de terceros.

        - `detDepEnvase`: se refiera a la garantía de depósito por envase.

        - `detLiqValComIVA`: se refiere al valor líquido de una compra o
        transacción que incluye el Impuesto al Valor Agregado (IVA).

        - `detTasaImp`: se refiere a la tasa o porcentaje de impuesto aplicado a
        una transacción específica.

        - `"detLiqValComExe`: se refiere al valor líquido de una compra o
        transacción exenta de impuestos.

        - `detMntSinCredito`: corresponde al monto sin derecho a crédito.

        - `detLiqValComNeto`: se refiere al valor líquido o neto de una compra o
        transacción.

        - `detExpNumId`: se refiere al número de identificación del exportador.

        - `detExpNacionalidad`: se refiere a la nacionalidad del exportador.

        - `detLiqDvEmisor`: se refiere al dígito verificador del emisor en una
        transacción o documento tributario.

        - `detCodigo`: puede referirse a diferentes códigos asociados a
        transacciones, productos o servicios en el contexto de los registros -
        tributarios\`.

        - `detTabPuros`: corresponde al impuesto por tabacos manufacturados
        (cigarros puros)

        - `detTabCigarrillos`: corresponde al impuesto por tabacos
        manufacturados (cigarrillos)

        - `detTabElaborado`: corresponde al impuesto por tabacos manufacturados
        (tabaco elaborado)

        - `detIVARetTotal`: se refiere al monto total de Impuesto al Valor
        Agregado (IVA) retenido en una transacción o período determinado.

        - `detIVARetParcial`: Corresponde al monto parcial de Impuesto al Valor
        Agregado (IVA) retenido en una transacción o período determinado.

        - `detIVANoRetenido`: es el monto de Impuesto al Valor Agregado (IVA)
        que no ha sido retenido en una transacción o período determinado.

        - `detImpVehiculo`: corresponde al impuesto a los vehículos automóviles

        - `detIVAUsoComun`: se refiere al Impuesto al Valor Agregado (IVA)
        aplicado a los bienes o servicios de uso común.

        - `detTpoImp`: corresponde al código del tipo impuesto del DTE.

        - `detLiqRutEmisor`: se refiere al RUT (Rol Único Tributario) del emisor
        en una transacción o documento tributario.

        - `descTipoTransaccion`: descripción de cómo se clasifica el tipo de
        compra del DTE.

        - `detEmisorNota`: se refiere al emisor de una nota de crédito o débito.

        - `totalDinrMontoIVANoR`: se refiere al monto total en dinero del
        Impuesto al Valor Agregado (IVA) no retenido en una transacción o
        período determinado.

        - `detPsjNac`: se refiere al número de pasajeros nacionales en una
        transacción o documento tributario.

        - `detPsjInt`: se refiere al número de pasajeros internacionales en una
        transacción o documento tributario.

        - `detNumInt`: corresponde al número o cantidad relacionada con
        operaciones o transacciones internacionales.

        - `totalDtoiMontoImp`: se refiere al monto total del descuento sobre
        impuestos en una transacción o período determinado.

        - `dcvCodigo`: corresponde al código que permite al SII tener
        información precisa sobre la actividad económica del contribuyente.

        - `dcvEstadoContab`: se refiere al estado contable de una entidad o
        contribuyente.

        - `detLey18211`: corresponde al impuesto del 4.4% por la importación de
        mercancías extranjeras, efectuada desde Zona Franca Primaria a Zona
        Franca de Extensión, el cual se calculará sobre el valor CIF de dichas
        mercancías.
      operationId: detalleDeCompras
      parameters:
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `csv`'
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
        - name: tipo
          in: query
          schema:
            type: string
            example: rcv
          description: '`rcv` `iecv` `rcv_csv`'
        - name: csv_delimiter
          in: query
          schema:
            type: string
            example: ;
          description: >-
            Delimitador que se debe usar en el formato `csv` con tipo `rcv` o
            `iecv`
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              Detalle de Compras:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: Detalle de Compras
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        cambiarTipoTran:
                          type: boolean
                          example: true
                        dcvCodigo:
                          type: number
                          example: 1234
                        dcvEstadoContab:
                          nullable: true
                          example: null
                        descTipoTransaccion:
                          type: string
                          example: Del Giro
                        detAnulado:
                          nullable: true
                          example: null
                        detCdgSIISucur:
                          type: number
                          example: 0
                        detCodigo:
                          type: number
                          example: 1234
                        detCredEc:
                          nullable: true
                          example: null
                        detDepEnvase:
                          nullable: true
                          example: null
                        detDvDoc:
                          type: string
                          example: '9'
                        detEmisorNota:
                          type: number
                          example: 0
                        detEventoReceptor:
                          type: string
                          example: C
                        detEventoReceptorLeyenda:
                          type: string
                          example: Recibo otorgado por el receptor
                        detExpNacionalidad:
                          nullable: true
                          example: null
                        detExpNumId:
                          nullable: true
                          example: null
                        detFchDoc:
                          type: string
                          example: 31/10/2019
                        detFecAcuse:
                          type: string
                          example: 02/11/2019 13:26:04
                        detFecRecepcion:
                          type: string
                          example: 30/10/2019 11:28:07
                        detFecReclamado:
                          nullable: true
                          example: null
                        detFolioDocRef:
                          nullable: true
                          example: null
                        detIVAFueraPlazo:
                          nullable: true
                          example: null
                        detIVANoRetenido:
                          type: number
                          example: 0
                        detIVAPropio:
                          nullable: true
                          example: null
                        detIVARetParcial:
                          nullable: true
                          example: null
                        detIVARetTotal:
                          nullable: true
                          example: null
                        detIVATerceros:
                          nullable: true
                          example: null
                        detIVAUsoComun:
                          type: number
                          example: 0
                        detImpVehiculo:
                          type: number
                          example: 0
                        detIndServicio:
                          nullable: true
                          example: null
                        detIndSinCosto:
                          nullable: true
                          example: null
                        detLey18211:
                          nullable: true
                          example: null
                        detLiqDvEmisor:
                          nullable: true
                          example: null
                        detLiqRutEmisor:
                          nullable: true
                          example: null
                        detLiqValComExe:
                          nullable: true
                          example: null
                        detLiqValComIVA:
                          nullable: true
                          example: null
                        detLiqValComNeto:
                          nullable: true
                          example: null
                        detMntActFijo:
                          type: number
                          example: 0
                        detMntCodNoRec:
                          type: number
                          example: 0
                        detMntExe:
                          type: number
                          example: 0
                        detMntIVA:
                          type: number
                          example: 733
                        detMntIVAActFijo:
                          type: number
                          example: 0
                        detMntIVANoRec:
                          type: number
                          example: 0
                        detMntNeto:
                          type: number
                          example: 3859
                        detMntNoFact:
                          nullable: true
                          example: null
                        detMntPeriodo:
                          nullable: true
                          example: null
                        detMntSinCredito:
                          type: number
                          example: 0
                        detMntTotal:
                          type: number
                          example: 4592
                        detNroDoc:
                          type: number
                          example: 123
                        detNumInt:
                          nullable: true
                          example: null
                        detPcarga:
                          type: number
                          example: 201910
                        detPsjInt:
                          nullable: true
                          example: null
                        detPsjNac:
                          nullable: true
                          example: null
                        detRutDoc:
                          type: number
                          example: 1
                        detRznSoc:
                          type: string
                          example: ''
                        detTabCigarrillos:
                          type: number
                          example: 0
                        detTabElaborado:
                          type: number
                          example: 0
                        detTabPuros:
                          type: number
                          example: 0
                        detTasaImp:
                          nullable: true
                          example: null
                        detTipoDoc:
                          type: number
                          example: 33
                        detTipoDocRef:
                          type: number
                          example: 0
                        detTipoTransaccion:
                          type: number
                          example: 1
                        detTpoImp:
                          type: number
                          example: 1
                        dhdrCodigo:
                          type: number
                          example: 1234
                        totalDinrMontoIVANoR:
                          nullable: true
                          example: null
                        totalDtoiMontoImp:
                          type: number
                          example: 0
                    example:
                      - cambiarTipoTran: true
                        dcvCodigo: 1234
                        dcvEstadoContab: null
                        descTipoTransaccion: Del Giro
                        detAnulado: null
                        detCdgSIISucur: 0
                        detCodigo: 1234
                        detCredEc: null
                        detDepEnvase: null
                        detDvDoc: '9'
                        detEmisorNota: 0
                        detEventoReceptor: C
                        detEventoReceptorLeyenda: Recibo otorgado por el receptor
                        detExpNacionalidad: null
                        detExpNumId: null
                        detFchDoc: 31/10/2019
                        detFecAcuse: 02/11/2019 13:26:04
                        detFecRecepcion: 30/10/2019 11:28:07
                        detFecReclamado: null
                        detFolioDocRef: null
                        detIVAFueraPlazo: null
                        detIVANoRetenido: 0
                        detIVAPropio: null
                        detIVARetParcial: null
                        detIVARetTotal: null
                        detIVATerceros: null
                        detIVAUsoComun: 0
                        detImpVehiculo: 0
                        detIndServicio: null
                        detIndSinCosto: null
                        detLey18211: null
                        detLiqDvEmisor: null
                        detLiqRutEmisor: null
                        detLiqValComExe: null
                        detLiqValComIVA: null
                        detLiqValComNeto: null
                        detMntActFijo: 0
                        detMntCodNoRec: 0
                        detMntExe: 0
                        detMntIVA: 733
                        detMntIVAActFijo: 0
                        detMntIVANoRec: 0
                        detMntNeto: 3859
                        detMntNoFact: null
                        detMntPeriodo: null
                        detMntSinCredito: 0
                        detMntTotal: 4592
                        detNroDoc: 123
                        detNumInt: null
                        detPcarga: 201910
                        detPsjInt: null
                        detPsjNac: null
                        detRutDoc: 1
                        detRznSoc: ''
                        detTabCigarrillos: 0
                        detTabElaborado: 0
                        detTabPuros: 0
                        detTasaImp: null
                        detTipoDoc: 33
                        detTipoDocRef: 0
                        detTipoTransaccion: 1
                        detTpoImp: 1
                        dhdrCodigo: 1234
                        totalDinrMontoIVANoR: null
                        totalDtoiMontoImp: 0
              examples:
                Detalle de Compras:
                  value:
                    data:
                      - cambiarTipoTran: true
                        dcvCodigo: 1234
                        dcvEstadoContab: null
                        descTipoTransaccion: Del Giro
                        detAnulado: null
                        detCdgSIISucur: 0
                        detCodigo: 1234
                        detCredEc: null
                        detDepEnvase: null
                        detDvDoc: '9'
                        detEmisorNota: 0
                        detEventoReceptor: C
                        detEventoReceptorLeyenda: Recibo otorgado por el receptor
                        detExpNacionalidad: null
                        detExpNumId: null
                        detFchDoc: 31/10/2019
                        detFecAcuse: 02/11/2019 13:26:04
                        detFecRecepcion: 30/10/2019 11:28:07
                        detFecReclamado: null
                        detFolioDocRef: null
                        detIVAFueraPlazo: null
                        detIVANoRetenido: 0
                        detIVAPropio: null
                        detIVARetParcial: null
                        detIVARetTotal: null
                        detIVATerceros: null
                        detIVAUsoComun: 0
                        detImpVehiculo: 0
                        detIndServicio: null
                        detIndSinCosto: null
                        detLey18211: null
                        detLiqDvEmisor: null
                        detLiqRutEmisor: null
                        detLiqValComExe: null
                        detLiqValComIVA: null
                        detLiqValComNeto: null
                        detMntActFijo: 0
                        detMntCodNoRec: 0
                        detMntExe: 0
                        detMntIVA: 733
                        detMntIVAActFijo: 0
                        detMntIVANoRec: 0
                        detMntNeto: 3859
                        detMntNoFact: null
                        detMntPeriodo: null
                        detMntSinCredito: 0
                        detMntTotal: 4592
                        detNroDoc: 123
                        detNumInt: null
                        detPcarga: 201910
                        detPsjInt: null
                        detPsjNac: null
                        detRutDoc: 1
                        detRznSoc: ''
                        detTabCigarrillos: 0
                        detTabElaborado: 0
                        detTabPuros: 0
                        detTasaImp: null
                        detTipoDoc: 33
                        detTipoDocRef: 0
                        detTipoTransaccion: 1
                        detTpoImp: 1
                        dhdrCodigo: 1234
                        totalDinrMontoIVANoR: null
                        totalDtoiMontoImp: 0
    parameters:
      - name: receptor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del receptor de los documentos
      - name: periodo
        in: path
        required: true
        schema:
          type: string
          example: '202409'
        description: Período del registro
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '33'
        description: Tipo de DTE a consultar el detalle
      - name: estado
        in: path
        required: true
        schema:
          type: string
          example: REGISTRO
        description: '`REGISTRO` `PENDIENTE` `NO_INCLUIR` `RECLAMADO`'
  /api/v1/sii/rcv/compras/set_tipo_transaccion/{receptor}/{periodo}:
    post:
      tags:
        - API RCV - Registro de Compras
      summary: Asignación Tipo de Transacción de una Compra
      description: >-
        **Permiso requerido**: `query rcv`


        **Pasarela a**:
        [https://www4.sii.cl/consdcvinternetui/#/index](https://www4.sii.cl/consdcvinternetui/#/index)
        (www4 o www4c)


        Tipos de transacciones que se pueden asignar usando `tipo_transaccion`:


        - `1` Compras del giro

        - `2` Compras en supermercados o comercios similares

        - `3` Adquisición de bienes raíces

        - `4` Compra de activo fijo

        - `5` Compras con IVA uso común

        - `6` Compras sin derecho a crédito


        Para el campo `codigo_iva` los posible valores son:


        - Caso normal se usa `1` donde la empresa es sólo afecta, no hay IVA de
        uso común y el IVA es recuperable.

        - Caso IVA de uso común se asigna `2`.

        - Caso IVA no recuperable, se usará uno de los códigos de IVA no
        recuperable, ya sean:
            - `1` Compras destinadas a IVA a generar operaciones no gravadas o exentas
            - `2` Facturas de proveedores registradas fuera de plazo.
            - `3` Gastos rechazados.
            - `4` Entregas gratuitas (premios, bonificaciones, etc) recibidas.
            - `9` Otros.
      operationId: asignaciNTipoDeTransacciNDeUnaCompra
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '1'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
                documentos:
                  type: array
                  items:
                    type: object
                    properties:
                      codigo_iva:
                        type: number
                        example: 1
                      dte:
                        type: number
                        example: 33
                      emisor:
                        type: string
                        example: 77666555-4
                      folio:
                        type: number
                        example: 1
                      tipo_transaccion:
                        type: number
                        example: 1
                  example:
                    - codigo_iva: 1
                      dte: 33
                      emisor: 77666555-4
                      folio: 1
                      tipo_transaccion: 1
            examples:
              Asignación Tipo de Transacción de una Compra:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
                  documentos:
                    - codigo_iva: 1
                      dte: 33
                      emisor: 77666555-4
                      folio: 1
                      tipo_transaccion: 1
      responses:
        '200':
          description: ''
    parameters:
      - name: receptor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: >-
          RUT del receptor de los documentos que se asignará el tipo de
          transacción
      - name: periodo
        in: path
        required: true
        schema:
          type: string
          example: '201912'
        description: Período para el cual se están asignando los tipos de transacción
  /api/v1/sii/rcv/compras/async/solicitar/{receptor}/{periodo}/{dte}/{estado}:
    post:
      tags:
        - API RCV - Registro de Compras
      summary: 'Async: Solicitar'
      description: 'Async: Solicitar'
      operationId: asyncSolicitar
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              'Async: Solicitar':
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: ''
    parameters:
      - name: receptor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
      - name: periodo
        in: path
        required: true
        schema:
          type: string
          example: '202411'
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '0'
      - name: estado
        in: path
        required: true
        schema:
          type: string
          example: REGISTRO
        description: '`REGISTRO` `PENDIENTE` `NO_INCLUIR` `RECLAMADO`'
  /api/v1/sii/rcv/compras/async/estado/{receptor}/{periodo}/{id}/{dte}/{estado}:
    post:
      tags:
        - API RCV - Registro de Compras
      summary: 'Async: Estado'
      description: 'Async: Estado'
      operationId: asyncEstado
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              'Async: Estado':
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: ''
    parameters:
      - name: receptor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
      - name: periodo
        in: path
        required: true
        schema:
          type: string
          example: '202411'
      - name: id
        in: path
        required: true
        schema:
          type: string
          example: ''
        description: ID entregado al solicitar las compras.
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '0'
      - name: estado
        in: path
        required: true
        schema:
          type: string
          example: REGISTRO
        description: '`REGISTRO` `PENDIENTE` `NO_INCLUIR` `RECLAMADO`'
  /api/v1/sii/rcv/compras/async/detalle/{receptor}/{periodo}/{id}/{dte}/{estado}:
    post:
      tags:
        - API RCV - Registro de Compras
      summary: 'Async: Detalle'
      description: 'Async: Detalle'
      operationId: asyncDetalle
      parameters:
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `csv`'
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              'Async: Detalle':
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: ''
    parameters:
      - name: receptor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
      - name: periodo
        in: path
        required: true
        schema:
          type: string
          example: '202411'
      - name: id
        in: path
        required: true
        schema:
          type: string
          example: ''
        description: ID entregado al solicitar las compras.
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '0'
      - name: estado
        in: path
        required: true
        schema:
          type: string
          example: REGISTRO
        description: '`REGISTRO` `PENDIENTE` `NO_INCLUIR` `RECLAMADO`'
  /api/v1/sii/rcv/ventas/resumen/{emisor}/{periodo}:
    post:
      tags:
        - API RCV - Registro de Ventas
      summary: Resumen de Ventas
      description: >-
        **Permiso requerido**: `query rcv`


        **Pasarela a**:
        [https://www4.sii.cl/consdcvinternetui/#/index](https://www4.sii.cl/consdcvinternetui/#/index)
        (www4 o www4c)
      operationId: resumenDeVentas
      parameters:
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `csv`'
        - name: certificacion
          in: query
          schema:
            type: string
            example: '1'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
        - name: csv_delimiter
          in: query
          schema:
            type: string
            example: ;
          description: Delimitador que se debe usar en el formato CSV
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              Resumen de Ventas:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: Resumen de Ventas
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        dcvCodigo:
                          type: number
                          example: 1234
                        dcvNombreTipoDoc:
                          type: string
                          example: Factura Electrónica
                        dcvOperacion:
                          nullable: true
                          example: null
                        dcvTipoIngresoDoc:
                          type: string
                          example: DET_ELE
                        rsmnCodigo:
                          type: number
                          example: 1234
                        rsmnEstadoContab:
                          nullable: true
                          example: null
                        rsmnIVAUsoComun:
                          type: number
                          example: 0
                        rsmnLink:
                          type: boolean
                          example: true
                        rsmnMntExe:
                          type: number
                          example: 0
                        rsmnMntIVA:
                          type: number
                          example: 0
                        rsmnMntIVANoRec:
                          type: number
                          example: 0
                        rsmnMntNeto:
                          type: number
                          example: 0
                        rsmnMntTotal:
                          type: number
                          example: 0
                        rsmnTipoDocInteger:
                          type: number
                          example: 33
                        rsmnTotDoc:
                          type: number
                          example: 1
                        rsmnTotalRutEmisor:
                          nullable: true
                          example: null
                    example:
                      - dcvCodigo: 1234
                        dcvNombreTipoDoc: Factura Electrónica
                        dcvOperacion: null
                        dcvTipoIngresoDoc: DET_ELE
                        rsmnCodigo: 1234
                        rsmnEstadoContab: null
                        rsmnIVAUsoComun: 0
                        rsmnLink: true
                        rsmnMntExe: 0
                        rsmnMntIVA: 0
                        rsmnMntIVANoRec: 0
                        rsmnMntNeto: 0
                        rsmnMntTotal: 0
                        rsmnTipoDocInteger: 33
                        rsmnTotDoc: 1
                        rsmnTotalRutEmisor: null
                      - dcvCodigo: 1234
                        dcvNombreTipoDoc: Nota de Crédito Electrónica
                        dcvOperacion: null
                        dcvTipoIngresoDoc: DET_ELE
                        rsmnCodigo: 1234
                        rsmnEstadoContab: null
                        rsmnIVAUsoComun: 0
                        rsmnLink: true
                        rsmnMntExe: 0
                        rsmnMntIVA: 0
                        rsmnMntIVANoRec: 0
                        rsmnMntNeto: 0
                        rsmnMntTotal: 0
                        rsmnTipoDocInteger: 61
                        rsmnTotDoc: 1
                        rsmnTotalRutEmisor: null
              examples:
                Resumen de Ventas:
                  value:
                    data:
                      - dcvCodigo: 1234
                        dcvNombreTipoDoc: Factura Electrónica
                        dcvOperacion: null
                        dcvTipoIngresoDoc: DET_ELE
                        rsmnCodigo: 1234
                        rsmnEstadoContab: null
                        rsmnIVAUsoComun: 0
                        rsmnLink: true
                        rsmnMntExe: 0
                        rsmnMntIVA: 0
                        rsmnMntIVANoRec: 0
                        rsmnMntNeto: 0
                        rsmnMntTotal: 0
                        rsmnTipoDocInteger: 33
                        rsmnTotDoc: 1
                        rsmnTotalRutEmisor: null
                      - dcvCodigo: 1234
                        dcvNombreTipoDoc: Nota de Crédito Electrónica
                        dcvOperacion: null
                        dcvTipoIngresoDoc: DET_ELE
                        rsmnCodigo: 1234
                        rsmnEstadoContab: null
                        rsmnIVAUsoComun: 0
                        rsmnLink: true
                        rsmnMntExe: 0
                        rsmnMntIVA: 0
                        rsmnMntIVANoRec: 0
                        rsmnMntNeto: 0
                        rsmnMntTotal: 0
                        rsmnTipoDocInteger: 61
                        rsmnTotDoc: 1
                        rsmnTotalRutEmisor: null
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del emisor de los documentos
      - name: periodo
        in: path
        required: true
        schema:
          type: string
          example: '202409'
        description: Período de emisión de los documentos
  /api/v1/sii/rcv/ventas/detalle/{emisor}/{periodo}/{dte}:
    post:
      tags:
        - API RCV - Registro de Ventas
      summary: Detalle de Ventas
      description: >-
        **Permiso requerido**: `query rcv`


        **Pasarela a**:
        [https://www4.sii.cl/consdcvinternetui/#/index](https://www4.sii.cl/consdcvinternetui/#/index)
        (www4 o www4c)


        Recurso para obtener el detalle de las ventas a partir de los datos del
        Registro de Ventas.


        El detalle es el listado de documentos de cierto tipo disponibles en el
        registro de ventas. En ningún caso este recurso entregará el listado de
        items (productos o servicios) de cada documento. Esto no es posible
        porque ese dato no se encuentra en el listado de documentos del registro
        de ventas.


        **Archivo en CSV del RCV del SII**


        Se pueden obtener los datos en distintos tipos. Sin embargo, el tipo
        `rcv_csv` tiene ciertas ventajas:


        - No es necesario indicar el código de DTE, se recomienda usar 0 para el
        campo `dte` en la URL ya que no se usa. Siempre se obtienen todos los
        tipos de documentos del período.

        - Permite obtener los datos de impuestos específicos.

        - En general, debería ser el tipo con mejor tiempo de respuesta.


        Considerar adicionalmente, que es más rápido usar el tipo `rcv_csv` con
        el formato `csv`.


        **Respuesta**


        La respuesta incluirá por defecto los datos obtenidos directamente desde
        el SII, donde los campos vienen desde el SII. Se recomienda revisar el
        registro de compras para ir comparando aquellos campos que no se
        entienda a partir de su nombre lo que significan. Los más importantes
        son:


        - `detTipoDoc`: código del tipo de DTE emitido.

        - `detRutDoc`: RUT del cliente, sin dígito verificador.

        - `detDvDoc`: dígito verificador del RUT del cliente.

        - `detRznSoc`: razón social del cliente.

        - `detNroDoc`: folio del DTE emitido.

        - `detFchDoc`: fecha de emisión del DTE emitido.

        - `detFecAcuse`: fecha en que el receptor generó el acuse de recibido
        (si es que se generó).

        - `detFecReclamado`: fecha en que el receptor generó el reclamo (si es
        que se generó).

        - `detFecRecepcion`: fecha de recepción del XML del DTE por parte del
        SII.

        - `detMntExe`: total monto exento.

        - `detMntNeto`: total monto neto.

        - `detMntIVA`: total monto IVA.

        - `detMntTotal`: total del documento.

        - `detTipoDocRef`: código del tipo de DTE de la referencia en el DTE
        emitido.

        - `detFolioDocRef`: folio del DTE referenciado en el documento de venta.

        - `detEventoReceptor`: código del evento que a realizado el receptor (si
        se ha realizado).

        - `detEventoReceptorLeyenda`: glosa del evento que a realizado el
        receptor (si se ha realizado).

        - `detPcarga`: período contable en el que corresponde registrar este
        documento de venta.
      operationId: detalleDeVentas
      parameters:
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `csv`'
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
        - name: tipo
          in: query
          schema:
            type: string
            example: rcv_csv
          description: '`rcv` `iecv` `rcv_csv`'
        - name: csv_delimiter
          in: query
          schema:
            type: string
            example: ;
          description: >-
            Delimitador que se debe usar en el formato `csv` con tipo `rcv` o
            `iecv`
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              Detalle de Ventas:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: Detalle de Ventas
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        cambiarTipoTran:
                          type: boolean
                          example: false
                        dcvCodigo:
                          type: number
                          example: 1234
                        dcvEstadoContab:
                          nullable: true
                          example: null
                        descTipoTransaccion:
                          type: string
                          example: Del Giro
                        detAnulado:
                          nullable: true
                          example: null
                        detCdgSIISucur:
                          type: number
                          example: 0
                        detCodigo:
                          type: number
                          example: 1234
                        detCredEc:
                          type: number
                          example: 0
                        detDepEnvase:
                          type: number
                          example: 0
                        detDvDoc:
                          type: string
                          example: '9'
                        detEmisorNota:
                          type: number
                          example: 0
                        detEventoReceptor:
                          nullable: true
                          example: null
                        detEventoReceptorLeyenda:
                          nullable: true
                          example: null
                        detExpNacionalidad:
                          nullable: true
                          example: null
                        detExpNumId:
                          nullable: true
                          example: null
                        detFchDoc:
                          type: string
                          example: 25/11/2019
                        detFecAcuse:
                          nullable: true
                          example: null
                        detFecRecepcion:
                          type: string
                          example: 04/12/2019 14:58:09
                        detFecReclamado:
                          nullable: true
                          example: null
                        detFolioDocRef:
                          nullable: true
                          example: null
                        detIVAFueraPlazo:
                          type: number
                          example: 0
                        detIVANoRetenido:
                          type: number
                          example: 0
                        detIVAPropio:
                          type: number
                          example: 0
                        detIVARetParcial:
                          type: number
                          example: 0
                        detIVARetTotal:
                          type: number
                          example: 0
                        detIVATerceros:
                          type: number
                          example: 0
                        detIVAUsoComun:
                          nullable: true
                          example: null
                        detImpVehiculo:
                          nullable: true
                          example: null
                        detIndServicio:
                          type: number
                          example: 0
                        detIndSinCosto:
                          type: number
                          example: 0
                        detLey18211:
                          type: number
                          example: 0
                        detLiqDvEmisor:
                          nullable: true
                          example: null
                        detLiqRutEmisor:
                          type: number
                          example: 0
                        detLiqValComExe:
                          type: number
                          example: 0
                        detLiqValComIVA:
                          type: number
                          example: 0
                        detLiqValComNeto:
                          type: number
                          example: 0
                        detMntActFijo:
                          nullable: true
                          example: null
                        detMntCodNoRec:
                          nullable: true
                          example: null
                        detMntExe:
                          type: number
                          example: 0
                        detMntIVA:
                          type: number
                          example: 0
                        detMntIVAActFijo:
                          nullable: true
                          example: null
                        detMntIVANoRec:
                          nullable: true
                          example: null
                        detMntNeto:
                          type: number
                          example: 0
                        detMntNoFact:
                          type: number
                          example: 0
                        detMntPeriodo:
                          type: number
                          example: 0
                        detMntSinCredito:
                          nullable: true
                          example: null
                        detMntTotal:
                          type: number
                          example: 0
                        detNroDoc:
                          type: number
                          example: 123
                        detNumInt:
                          nullable: true
                          example: null
                        detPcarga:
                          type: number
                          example: 201912
                        detPsjInt:
                          type: number
                          example: 0
                        detPsjNac:
                          type: number
                          example: 0
                        detRutDoc:
                          type: number
                          example: 1
                        detRznSoc:
                          type: string
                          example: ''
                        detTabCigarrillos:
                          nullable: true
                          example: null
                        detTabElaborado:
                          nullable: true
                          example: null
                        detTabPuros:
                          nullable: true
                          example: null
                        detTasaImp:
                          type: string
                          example: '19'
                        detTipoDoc:
                          type: number
                          example: 33
                        detTipoDocRef:
                          type: number
                          example: 0
                        detTipoTransaccion:
                          nullable: true
                          example: null
                        detTpoImp:
                          nullable: true
                          example: null
                        dhdrCodigo:
                          type: number
                          example: 1234
                        totalDinrMontoIVANoR:
                          nullable: true
                          example: null
                        totalDtoiMontoImp:
                          type: number
                          example: 0
                    example:
                      - cambiarTipoTran: false
                        dcvCodigo: 1234
                        dcvEstadoContab: null
                        descTipoTransaccion: Del Giro
                        detAnulado: null
                        detCdgSIISucur: 0
                        detCodigo: 1234
                        detCredEc: 0
                        detDepEnvase: 0
                        detDvDoc: '9'
                        detEmisorNota: 0
                        detEventoReceptor: null
                        detEventoReceptorLeyenda: null
                        detExpNacionalidad: null
                        detExpNumId: null
                        detFchDoc: 25/11/2019
                        detFecAcuse: null
                        detFecRecepcion: 04/12/2019 14:58:09
                        detFecReclamado: null
                        detFolioDocRef: null
                        detIVAFueraPlazo: 0
                        detIVANoRetenido: 0
                        detIVAPropio: 0
                        detIVARetParcial: 0
                        detIVARetTotal: 0
                        detIVATerceros: 0
                        detIVAUsoComun: null
                        detImpVehiculo: null
                        detIndServicio: 0
                        detIndSinCosto: 0
                        detLey18211: 0
                        detLiqDvEmisor: null
                        detLiqRutEmisor: 0
                        detLiqValComExe: 0
                        detLiqValComIVA: 0
                        detLiqValComNeto: 0
                        detMntActFijo: null
                        detMntCodNoRec: null
                        detMntExe: 0
                        detMntIVA: 0
                        detMntIVAActFijo: null
                        detMntIVANoRec: null
                        detMntNeto: 0
                        detMntNoFact: 0
                        detMntPeriodo: 0
                        detMntSinCredito: null
                        detMntTotal: 0
                        detNroDoc: 123
                        detNumInt: null
                        detPcarga: 201912
                        detPsjInt: 0
                        detPsjNac: 0
                        detRutDoc: 1
                        detRznSoc: ''
                        detTabCigarrillos: null
                        detTabElaborado: null
                        detTabPuros: null
                        detTasaImp: '19'
                        detTipoDoc: 33
                        detTipoDocRef: 0
                        detTipoTransaccion: null
                        detTpoImp: null
                        dhdrCodigo: 1234
                        totalDinrMontoIVANoR: null
                        totalDtoiMontoImp: 0
              examples:
                Detalle de Ventas:
                  value:
                    data:
                      - cambiarTipoTran: false
                        dcvCodigo: 1234
                        dcvEstadoContab: null
                        descTipoTransaccion: Del Giro
                        detAnulado: null
                        detCdgSIISucur: 0
                        detCodigo: 1234
                        detCredEc: 0
                        detDepEnvase: 0
                        detDvDoc: '9'
                        detEmisorNota: 0
                        detEventoReceptor: null
                        detEventoReceptorLeyenda: null
                        detExpNacionalidad: null
                        detExpNumId: null
                        detFchDoc: 25/11/2019
                        detFecAcuse: null
                        detFecRecepcion: 04/12/2019 14:58:09
                        detFecReclamado: null
                        detFolioDocRef: null
                        detIVAFueraPlazo: 0
                        detIVANoRetenido: 0
                        detIVAPropio: 0
                        detIVARetParcial: 0
                        detIVARetTotal: 0
                        detIVATerceros: 0
                        detIVAUsoComun: null
                        detImpVehiculo: null
                        detIndServicio: 0
                        detIndSinCosto: 0
                        detLey18211: 0
                        detLiqDvEmisor: null
                        detLiqRutEmisor: 0
                        detLiqValComExe: 0
                        detLiqValComIVA: 0
                        detLiqValComNeto: 0
                        detMntActFijo: null
                        detMntCodNoRec: null
                        detMntExe: 0
                        detMntIVA: 0
                        detMntIVAActFijo: null
                        detMntIVANoRec: null
                        detMntNeto: 0
                        detMntNoFact: 0
                        detMntPeriodo: 0
                        detMntSinCredito: null
                        detMntTotal: 0
                        detNroDoc: 123
                        detNumInt: null
                        detPcarga: 201912
                        detPsjInt: 0
                        detPsjNac: 0
                        detRutDoc: 1
                        detRznSoc: ''
                        detTabCigarrillos: null
                        detTabElaborado: null
                        detTabPuros: null
                        detTasaImp: '19'
                        detTipoDoc: 33
                        detTipoDocRef: 0
                        detTipoTransaccion: null
                        detTpoImp: null
                        dhdrCodigo: 1234
                        totalDinrMontoIVANoR: null
                        totalDtoiMontoImp: 0
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del emisor de los documentos
      - name: periodo
        in: path
        required: true
        schema:
          type: string
          example: '202409'
        description: Período de emisión de los documentos
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '0'
        description: Tipo de documento que se desea obtener el detalle
  /api/v1/sii/rcv/ventas/set_resumen/{emisor}/{periodo}:
    post:
      tags:
        - API RCV - Registro de Ventas
      summary: Asignación de Resumen de Ventas por Documento
      description: >-
        **Permiso requerido**: `query rcv`


        **Pasarela a**:
        [https://www4.sii.cl/consdcvinternetui/#/index](https://www4.sii.cl/consdcvinternetui/#/index)
        (www4 o www4c)


        Permite asignar un resumen de documentos emitidos al registro de ventas.


        Por ejemplo, agregar mensualmente el resumen de boletas emitidas.
      operationId: asignaciNDeResumenDeVentasPorDocumento
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
                documentos:
                  type: array
                  items:
                    type: object
                    properties:
                      det_mnt_exe:
                        type: number
                        example: 5000
                      det_mnt_iva:
                        type: number
                        example: 1900
                      det_mnt_neto:
                        type: number
                        example: 10000
                      det_mnt_total:
                        type: number
                        example: 16900
                      det_nro_doc:
                        type: number
                        example: 10
                      det_tipo_doc:
                        type: number
                        example: 39
                  example:
                    - det_mnt_exe: 5000
                      det_mnt_iva: 1900
                      det_mnt_neto: 10000
                      det_mnt_total: 16900
                      det_nro_doc: 10
                      det_tipo_doc: 39
            examples:
              Asignación de Resumen de Ventas por Documento:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
                  documentos:
                    - det_mnt_exe: 5000
                      det_mnt_iva: 1900
                      det_mnt_neto: 10000
                      det_mnt_total: 16900
                      det_nro_doc: 10
                      det_tipo_doc: 39
      responses:
        '200':
          description: ''
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del emisor de los documentos del resumen
      - name: periodo
        in: path
        required: true
        schema:
          type: string
          example: '201911'
        description: Período de emisión de los documentos del resumen
  /api/v1/sii/rcv/ventas/async/solicitar/{receptor}/{periodo}/{dte}:
    post:
      tags:
        - API RCV - Registro de Ventas
      summary: 'Async: Solicitar'
      description: 'Async: Solicitar'
      operationId: asyncSolicitar1
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              'Async: Solicitar':
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: ''
    parameters:
      - name: receptor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
      - name: periodo
        in: path
        required: true
        schema:
          type: string
          example: '202411'
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '0'
  /api/v1/sii/rcv/ventas/async/estado/{receptor}/{periodo}/{id}/{dte}:
    post:
      tags:
        - API RCV - Registro de Ventas
      summary: 'Async: Estado'
      description: 'Async: Estado'
      operationId: asyncEstado1
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              'Async: Estado':
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: ''
    parameters:
      - name: receptor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
      - name: periodo
        in: path
        required: true
        schema:
          type: string
          example: '202411'
      - name: id
        in: path
        required: true
        schema:
          type: string
          example: ''
        description: ID entregado al solicitar las ventas.
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '0'
  /api/v1/sii/rcv/ventas/async/detalle/{emisor}/{periodo}/{id}/{dte}:
    post:
      tags:
        - API RCV - Registro de Ventas
      summary: 'Async: Detalle'
      description: 'Async: Detalle'
      operationId: asyncDetalle1
      parameters:
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `csv`'
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              'Async: Detalle':
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: ''
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
      - name: periodo
        in: path
        required: true
        schema:
          type: string
          example: '202411'
      - name: id
        in: path
        required: true
        schema:
          type: string
          example: ''
        description: ID entregado al solicitar las ventas.
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: ''
        description: >-
          El tipo de documento a obtener. Si se desean obtener boletas (afectas
          y/o exentas) se debe pasar el valor `3941`.
  /api/v1/sii/rtc/cesiones/certificado/{emisor}/{dte}/{folio}/{fecha}:
    post:
      tags:
        - API RTC
      summary: Obtener Certificado de Cesión Electrónica
      description: >-
        **Permiso requerido**: `query rtc`


        **Pasarela a:**
        [https://palena.sii.cl/rtc/RTC/RTCObtCertif.html](https://palena.sii.cl/rtc/RTC/RTCObtCertif.html)
        (palena o maullin)


        Entrega el certificado, en HTML, de la cesión del documento.
      operationId: obtenerCertificadoDeCesiNElectrNica
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: '1111111-1'
            examples:
              Obtener Certificado de Cesión Electrónica:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: '1111111-1'
      responses:
        '200':
          description: ''
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del emisor del documento
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '33'
        description: Tipo de documento
      - name: folio
        in: path
        required: true
        schema:
          type: string
          example: '6542'
        description: Folio del documento
      - name: fecha
        in: path
        required: true
        schema:
          type: string
          example: '2024-02-02'
        description: 'Fecha de la cesión, formato: AAAA-MM-DD'
  /api/v1/sii/rtc/cesiones/estado_envio/{track_id}:
    post:
      tags:
        - API RTC
      summary: Estado de Envío de Cesión Electrónica
      description: >-
        **Permiso requerido**: `query rtc`


        **Pasarela a:**
        [https://palena.sii.cl/rtc/RTC/RTCAnotConsulta.html](https://palena.sii.cl/rtc/RTC/RTCAnotConsulta.html)
        (palena o maullin)


        Retorna el estado del envío de la cesión al SII.
      operationId: estadoDeEnvODeCesiNElectrNica
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `html`'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
            examples:
              Estado de Envío de Cesión Electrónica:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
      responses:
        '200':
          description: Estado de Envío de Cesión Electrónica
          content:
            application/json:
              schema:
                type: object
                properties:
                  estado:
                    type: string
                    example: Anotacion de Cesion Aceptada, Envio Aceptado
                  track_id:
                    type: number
                    example: 75312822
              examples:
                Estado de Envío de Cesión Electrónica:
                  value:
                    estado: Anotacion de Cesion Aceptada, Envio Aceptado
                    track_id: 75312822
    parameters:
      - name: track_id
        in: path
        required: true
        schema:
          type: string
          example: '75312822'
        description: Track ID de la cesión del DTE
  /api/v1/sii/rtc/cesiones/estado/{emisor}/{dte}/{folio}:
    post:
      tags:
        - API RTC
      summary: Estado de Cesión de un DTE
      description: >-
        **Permiso requerido**: `query rtc`


        **Pasarela a:**
        [https://palena.sii.cl/rtc/RTC/RTCConsultas.html](https://palena.sii.cl/rtc/RTC/RTCConsultas.html)
        (palena o maullin)


        Para el caso con respuesta del SII "Tenedor Vigente" se entrega el
        estado de un DTE para conocer si está o no cedido junto con datos del
        estado actual de la cesión.


        En el caso de que el SII sólo indique "Documento Cedido" se entrega sólo
        si está o no cedido.
      operationId: estadoDeCesiNDeUnDte
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
            examples:
              Estado de Cesión de un DTE:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
      responses:
        '200':
          description: Estado de Cesión de un DTE
          content:
            application/json:
              schema:
                type: object
                properties:
                  cedido:
                    type: boolean
                    example: true
                  clave_acceso:
                    type: string
                    example: ''
                  declaracion_jurada:
                    type: string
                    example: >-
                      Archivo Electrónico de Cesión incluye la declaración
                      jurada de que fueron puestos a disposición del Cesionario
                      acuses de recibo no electrónicos conformes de acuerdo con
                      la ley 19.983.
                  fecha_ultima_anotacion:
                    type: string
                    example: '2019-07-06 19:56:58'
                  tenedor_vigente:
                    type: string
                    example: 1-9
              examples:
                Estado de Cesión de un DTE:
                  value:
                    cedido: true
                    clave_acceso: ''
                    declaracion_jurada: >-
                      Archivo Electrónico de Cesión incluye la declaración
                      jurada de que fueron puestos a disposición del Cesionario
                      acuses de recibo no electrónicos conformes de acuerdo con
                      la ley 19.983.
                    fecha_ultima_anotacion: '2019-07-06 19:56:58'
                    tenedor_vigente: 1-9
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del emisor del documento
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '33'
        description: Tipo de documento
      - name: folio
        in: path
        required: true
        schema:
          type: string
          example: '612'
        description: Folio del documento
  /api/v1/sii/rtc/cesiones/documentos/{desde}/{hasta}/{consulta}:
    post:
      tags:
        - API RTC
      summary: Listado de Cesiones
      description: >-
        **Permiso requerido**: `query rtc`


        **Pasarela a:**
        [https://palena.sii.cl/cgi_rtc/RTC/RTCConsultaCesionesHtml.cgi](https://palena.sii.cl/cgi_rtc/RTC/RTCConsultaCesionesHtml.cgi)
        (palena o maullin)


        Obtener las cesiones de un periodo.


        Para acceder a la información entregada en esta opción, debe
        autenticarse:


        - **Con RUT/Clave o Certificado Digital**: un contribuyente relacionado
        con la cesión (como deudor, cedente o cesionario).

        - ~~**Con RUT/Clave o Certificado Digital**~~~~: una persona que haya
        sido autorizada para representar electrónicamente a algunos de los
        contribuyentes antes indicados.~~


        El rango de tiempo de la búsqueda no puede ser superior a 1 mes.


        **Importante**: si no obtiene datos al usar el certificado digital. Se
        recomienda probar con RUT y clave. Ya que en la mayoría de los casos es
        por permisos y es mejor usar directamente el RUT y clave del
        contribuyente.
      operationId: listadoDeCesiones
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `xml` `csv` `txt`'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
            examples:
              Listado de Cesiones:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
      responses:
        '200':
          description: Listado de Cesiones
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    CEDENTE:
                      type: string
                      example: 76192083-9
                    CESIONARIO:
                      type: string
                      example: 2-7
                    DEUDOR:
                      type: string
                      example: 1-9
                    ESTADO_CESION:
                      type: string
                      example: Cesion Vigente
                    FCH_CESION:
                      type: string
                      example: 2019-07-06 19:56
                    FCH_EMIS_DTE:
                      type: string
                      example: '2019-07-01'
                    FCH_VENCIMIENTO:
                      type: string
                      example: '2019-07-01'
                    FOLIO_DOC:
                      type: string
                      example: '123'
                    MAIL_CEDENTE:
                      type: string
                      example: cedente@example.com
                    MAIL_CESIONARIO:
                      type: string
                      example: cesionario@example.com
                    MNT_CESION:
                      type: string
                      example: '0'
                    MNT_TOTAL:
                      type: string
                      example: '0'
                    NOMBRE_DOC:
                      type: string
                      example: Factura Electronica
                    RZ_CEDENTE:
                      type: string
                      example: SASCO SpA
                    RZ_CESIONARIO:
                      type: string
                      example: ''
                    TIPO_DOC:
                      type: string
                      example: '33'
                    VENDEDOR:
                      type: string
                      example: 76192083-9
                example:
                  - CEDENTE: 76192083-9
                    CESIONARIO: 2-7
                    DEUDOR: 1-9
                    ESTADO_CESION: Cesion Vigente
                    FCH_CESION: 2019-07-06 19:56
                    FCH_EMIS_DTE: '2019-07-01'
                    FCH_VENCIMIENTO: '2019-07-01'
                    FOLIO_DOC: '123'
                    MAIL_CEDENTE: cedente@example.com
                    MAIL_CESIONARIO: cesionario@example.com
                    MNT_CESION: '0'
                    MNT_TOTAL: '0'
                    NOMBRE_DOC: Factura Electronica
                    RZ_CEDENTE: SASCO SpA
                    RZ_CESIONARIO: ''
                    TIPO_DOC: '33'
                    VENDEDOR: 76192083-9
              examples:
                Listado de Cesiones:
                  value:
                    - CEDENTE: 76192083-9
                      CESIONARIO: 2-7
                      DEUDOR: 1-9
                      ESTADO_CESION: Cesion Vigente
                      FCH_CESION: 2019-07-06 19:56
                      FCH_EMIS_DTE: '2019-07-01'
                      FCH_VENCIMIENTO: '2019-07-01'
                      FOLIO_DOC: '123'
                      MAIL_CEDENTE: cedente@example.com
                      MAIL_CESIONARIO: cesionario@example.com
                      MNT_CESION: '0'
                      MNT_TOTAL: '0'
                      NOMBRE_DOC: Factura Electronica
                      RZ_CEDENTE: SASCO SpA
                      RZ_CESIONARIO: ''
                      TIPO_DOC: '33'
                      VENDEDOR: 76192083-9
    parameters:
      - name: desde
        in: path
        required: true
        schema:
          type: string
          example: '2022-06-01'
        description: 'Desde cuando buscar, formato: AAAA-MM-DD'
      - name: hasta
        in: path
        required: true
        schema:
          type: string
          example: '2022-07-01'
        description: >-
          Hasta cuando buscar (máximo 30 días desde `desde`), formato:
          AAAA-MM-DD
      - name: consulta
        in: path
        required: true
        schema:
          type: string
          example: '1'
        description: >-
          `0` consulta para el deudor (está obligado a pagar)<br/>`1` consulta
          para el cedente (ha cedido)<br/>`2` consulta para el cesionario (ha
          adquirido)
  /api/v1/sii/bhe/emitidas/documentos/{emisor}/{periodo}:
    post:
      tags:
        - API BHE - Boletas de Honorarios Emitidas
      summary: Listado de Boletas de Honorarios Emitidas
      description: >-
        **Permiso requerido**: `query bhe`


        **Pasarela a:**
        [https://loa.sii.cl/cgi_IMT/TMBCOC_MenuConsultasContrib.cgi](https://loa.sii.cl/cgi_IMT/TMBCOC_MenuConsultasContrib.cgi)


        La consulta de BHE debe ser realizada con el RUT y clave tributaria del
        emisor de las boletas.
      operationId: listadoDeBoletasDeHonorariosEmitidas
      parameters:
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `csv`'
        - name: csv_delimiter
          in: query
          schema:
            type: string
            example: ;
          description: Delimitador que se debe usar en el formato CSV
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: '1111111-1'
            examples:
              Listado de Boletas de Honorarios Emitidas:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: '1111111-1'
      responses:
        '200':
          description: Listado de Boletas de Honorarios Emitidas
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    anulada:
                      type: string
                      example: '2019-08-15'
                    codigo:
                      type: string
                      example: ''
                    dv:
                      type: string
                      example: '9'
                    email_envio:
                      type: string
                      example: ''
                    estado:
                      type: string
                      example: S
                    fecha:
                      type: string
                      example: '2019-08-14'
                    fecha_emision:
                      type: string
                      example: '2019-08-15'
                    nombre:
                      type: string
                      example: ''
                    numero:
                      type: number
                      example: 123
                    retencion_emisor:
                      type: number
                      example: 15
                    retencion_receptor:
                      type: number
                      example: 0
                    rut:
                      type: number
                      example: 1
                    sociedad_profesional:
                      type: string
                      example: 'NO'
                    total_honorarios:
                      type: number
                      example: 150
                    total_liquido:
                      type: number
                      example: 135
                    usuario_emisor:
                      type: string
                      example: ''
                example:
                  - anulada: '2019-08-15'
                    codigo: ''
                    dv: '9'
                    email_envio: ''
                    estado: S
                    fecha: '2019-08-14'
                    fecha_emision: '2019-08-15'
                    nombre: ''
                    numero: 123
                    retencion_emisor: 15
                    retencion_receptor: 0
                    rut: 1
                    sociedad_profesional: 'NO'
                    total_honorarios: 150
                    total_liquido: 135
                    usuario_emisor: ''
              examples:
                Listado de Boletas de Honorarios Emitidas:
                  value:
                    - anulada: '2019-08-15'
                      codigo: ''
                      dv: '9'
                      email_envio: ''
                      estado: S
                      fecha: '2019-08-14'
                      fecha_emision: '2019-08-15'
                      nombre: ''
                      numero: 123
                      retencion_emisor: 15
                      retencion_receptor: 0
                      rut: 1
                      sociedad_profesional: 'NO'
                      total_honorarios: 150
                      total_liquido: 135
                      usuario_emisor: ''
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: '1111111-1'
        description: RUT del emisor de la boleta
      - name: periodo
        in: path
        required: true
        schema:
          type: string
          example: '202404'
        description: Período donde buscar las boletas
  /api/v1/sii/bhe/emitidas/emitir:
    post:
      tags:
        - API BHE - Boletas de Honorarios Emitidas
      summary: Emitir Boleta de Honorarios
      description: "**Permiso requerido**: `query bhe`\n\n**Pasarela a:** [https://loa.sii.cl/cgi_IMT/TMBECN_ValidaTimbrajeContrib.cgi?modo=1](https://loa.sii.cl/cgi_IMT/TMBECN_ValidaTimbrajeContrib.cgi?modo=1) (emisor normal) y [https://loa.sii.cl/cgi_IMT/TMBEUS_ValidaAutoriz.cgi?modo=1](https://loa.sii.cl/cgi_IMT/TMBEUS_ValidaAutoriz.cgi?modo=1) (emisor autorizado).\n\nEl campo `TipoRetencion` puede tener los siguientes valores:\n\n- `0` sin retención. Para sociedades de profesionales que tributan en 1era categoría.\n- `1` la retención la hace el receptor de la boleta.\n- `2` la retención la hace el contribuyente emisor de la boleta.\n    \n\nAdicionalmente, este recurso permite emitir BHE directamente con las credenciales del emisor o bien con las de un usuario autorizado. En este último caso el RUT del emisor será diferente al RUT usado para autenticar en el SII al usuario.\n\nLa API permite emitir una boleta sin datos del receptor. Para esto se debe omitir el campo `Receptor` en el JSON o bien enviar `RUTRecep` con valor `0-0`.\n\nSi se indica `RUTRecep`, y el RUT indicado existe en el SII, la boleta será siempre generada con los datos que el SII tenga (datos oficiales). Y, en dicho caso, los datos enviados en el JSON serán omitidos.\n\n**Datos del emisor**\n\nActualmente se obtiene la dirección automáticamente del SII, pero siempre la primera dirección (casa matriz).\n\n\uFEFFPara asignar la dirección, y otros datos, en el TAG Emisor hay que enviar estos campos:\n\n- \uFEFF\uFEFF`GiroEmis`\n- \uFEFF\uFEFF`Telefono`\n- \uFEFF\uFEFF`CodigoDirOrigen`\n- \uFEFF\uFEFF`DirOrigen`\n- \uFEFF\uFEFF`CmnaOrigen`\n    \n\n\uFEFFLos campos deben tener los valores que usa SII en la web."
      operationId: emitirBoletaDeHonorarios
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: '1111111-1'
                boleta:
                  type: object
                  properties:
                    Detalle:
                      type: array
                      items:
                        type: object
                        properties:
                          MontoItem:
                            type: number
                            example: 50
                          NmbItem:
                            type: string
                            example: Prueba integracion LibreDTE 1
                      example:
                        - MontoItem: 50
                          NmbItem: Prueba integracion LibreDTE 1
                        - MontoItem: 100
                          NmbItem: Prueba integracion LibreDTE 2
                    Encabezado:
                      type: object
                      properties:
                        Emisor:
                          type: object
                          properties:
                            RUTEmisor:
                              type: string
                              example: '1111111-1'
                        IdDoc:
                          type: object
                          properties:
                            FchEmis:
                              type: string
                              example: '2020-09-16'
                            TipoRetencion:
                              type: number
                              example: 1
                        Receptor:
                          type: object
                          properties:
                            CmnaRecep:
                              type: string
                              example: Santa Cruz
                            DirRecep:
                              type: string
                              example: Santa Cruz
                            RUTRecep:
                              type: string
                              example: 66666666-6
                            RznSocRecep:
                              type: string
                              example: Receptor generico
            examples:
              Emitir Boleta de Honorarios:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: '1111111-1'
                  boleta:
                    Detalle:
                      - MontoItem: 50
                        NmbItem: Prueba integracion LibreDTE 1
                      - MontoItem: 100
                        NmbItem: Prueba integracion LibreDTE 2
                    Encabezado:
                      Emisor:
                        RUTEmisor: '1111111-1'
                      IdDoc:
                        FchEmis: '2020-09-16'
                        TipoRetencion: 1
                      Receptor:
                        CmnaRecep: Santa Cruz
                        DirRecep: Santa Cruz
                        RUTRecep: 66666666-6
                        RznSocRecep: Receptor generico
      responses:
        '200':
          description: Emitir Boleta de Honorarios
          content:
            application/json:
              schema:
                type: object
                properties:
                  Detalle:
                    type: array
                    items:
                      type: object
                      properties:
                        MontoItem:
                          type: number
                          example: 50
                        NmbItem:
                          type: string
                          example: Prueba integracion LibreDTE 1
                    example:
                      - MontoItem: 50
                        NmbItem: Prueba integracion LibreDTE 1
                      - MontoItem: 100
                        NmbItem: Prueba integracion LibreDTE 2
                  Encabezado:
                    type: object
                    properties:
                      Emisor:
                        type: object
                        properties:
                          CmnaOrigen:
                            type: string
                            example: SANTA CRUZ
                          CodigoDirOrigen:
                            type: string
                            example: '065722046'
                          DirOrigen:
                            type: string
                            example: SANTA CRUZ
                          GiroEmis:
                            type: string
                            example: SERVICIOS, ASESORIAS Y SOLUCIONES COMPUTACIONALES
                          RUTEmisor:
                            type: string
                            example: 11222333-4
                          RznSoc:
                            type: string
                            example: EMISOR
                      IdDoc:
                        type: object
                        properties:
                          CodigoBarras:
                            type: string
                            example: XXXXXXXXXXXXXXXXX
                          CodigoInferior:
                            type: string
                            example: '11111111111111111'
                          FchEmis:
                            type: string
                            example: '2020-09-16'
                          Folio:
                            type: number
                            example: 155
                          TipoDTE:
                            type: number
                            example: 66
                          TipoRetencion:
                            type: number
                            example: 1
                      Receptor:
                        type: object
                        properties:
                          CmnaRecep:
                            type: string
                            example: Santa Cruz
                          CodigoCmnaRecep:
                            type: number
                            example: 6205
                          CodigoRegionRecep:
                            type: number
                            example: 6
                          DirRecep:
                            type: string
                            example: Santa Cruz
                          RUTRecep:
                            type: string
                            example: 66666666-6
                          RznSocRecep:
                            type: string
                            example: Receptor generico
              examples:
                Emitir Boleta de Honorarios:
                  value:
                    Detalle:
                      - MontoItem: 50
                        NmbItem: Prueba integracion LibreDTE 1
                      - MontoItem: 100
                        NmbItem: Prueba integracion LibreDTE 2
                    Encabezado:
                      Emisor:
                        CmnaOrigen: SANTA CRUZ
                        CodigoDirOrigen: '065722046'
                        DirOrigen: SANTA CRUZ
                        GiroEmis: SERVICIOS, ASESORIAS Y SOLUCIONES COMPUTACIONALES
                        RUTEmisor: 11222333-4
                        RznSoc: EMISOR
                      IdDoc:
                        CodigoBarras: XXXXXXXXXXXXXXXXX
                        CodigoInferior: '11111111111111111'
                        FchEmis: '2020-09-16'
                        Folio: 155
                        TipoDTE: 66
                        TipoRetencion: 1
                      Receptor:
                        CmnaRecep: Santa Cruz
                        CodigoCmnaRecep: 6205
                        CodigoRegionRecep: 6
                        DirRecep: Santa Cruz
                        RUTRecep: 66666666-6
                        RznSocRecep: Receptor generico
  /api/v1/sii/bhe/emitidas/pdf/{codigo}:
    post:
      tags:
        - API BHE - Boletas de Honorarios Emitidas
      summary: Descargar PDF Boleta de Honorarios Emitida
      description: >-
        **Permiso requerido**: `query bhe`


        **Pasarela a:**
        [https://loa.sii.cl/cgi_IMT/TMBCOC_MenuConsultasContrib.cgi](https://loa.sii.cl/cgi_IMT/TMBCOC_MenuConsultasContrib.cgi)


        Este recurso permite obtener el PDF de una boleta de honorarios.


        Se utiliza el código de la boleta asignado por SII para obtener el PDF.
      operationId: descargarPdfBoletaDeHonorariosEmitida
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              Descargar PDF Boleta de Honorarios Emitida:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: ''
    parameters:
      - name: codigo
        in: path
        required: true
        schema:
          type: string
          example: 1626106300143D0D5733
        description: Código de la boleta
  /api/v1/sii/bhe/emitidas/email/{codigo}:
    post:
      tags:
        - API BHE - Boletas de Honorarios Emitidas
      summary: Enviar Email con la Boleta de Honorarios Emitida
      description: >-
        **Permiso requerido**: `query bhe`


        **Pasarela a:**
        [https://loa.sii.cl/cgi_IMT/TMBCOC_MenuConsultasContrib.cgi](https://loa.sii.cl/cgi_IMT/TMBCOC_MenuConsultasContrib.cgi)


        Este recurso permite enviar por email la boleta de honorarios
        electrónica.


        La principal ventaja que tiene enviar por esta vía en vez del software
        propio, es que se envía directo desde los sistemas del SII. Y ellos
        adjuntan el mensaje estándar, el PDF y el XML de la boleta.


        Se utiliza el código de la boleta asignado por SII para obtener enviar
        el correo.


        El correo del destinatario es opcional. Si se omite se usará el correo
        que el SIi tenga registrado por defecto para el contribuyente receptor
        de la boleta.
      operationId: enviarEmailConLaBoletaDeHonorariosEmitida
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: '1111111-1'
                destinatario:
                  type: object
                  properties:
                    email:
                      type: string
                      example: correo@example.com
            examples:
              Enviar Email con la Boleta de Honorarios Emitida:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: '1111111-1'
                  destinatario:
                    email: correo@example.com
      responses:
        '200':
          description: ''
    parameters:
      - name: codigo
        in: path
        required: true
        schema:
          type: string
          example: 1626106300135B281699
        description: Código de la boleta
  /api/v1/sii/bhe/emitidas/anular/{emisor}/{folio}:
    post:
      tags:
        - API BHE - Boletas de Honorarios Emitidas
      summary: Anular Boleta de Honorarios Emitida
      description: >-
        **Permiso requerido**: `query bhe`


        **Pasarela a:**
        [https://loa.sii.cl/cgi_IMT/TMBANU_PrevalidaAnulacion.cgi](https://loa.sii.cl/cgi_IMT/TMBANU_PrevalidaAnulacion.cgi)


        Permite anular una boleta de honorarios electrónica previamente emitida.


        La respuesta JSON incluye el índice `boleta_anulada` que puede tener 2
        valores al llamar a este recurso:


        - `S` indica que la boleta estaba vigente y fue anulada.

        - `A` indica que la boleta ya se encontraba anulada previamente.
      operationId: anularBoletaDeHonorariosEmitida
      parameters:
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `html`'
        - name: causa
          in: query
          schema:
            type: string
            example: '3'
          description: >-
            `1` No se efectuó el pago de los servicios por parte del
            receptor<br/>`2` No se efectuó la prestación de servicios<br/>`3`
            Error en la digitación
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: '1111111-1'
            examples:
              Anular Boleta de Honorarios Emitida:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: '1111111-1'
      responses:
        '200':
          description: Anular Boleta de Honorarios Emitida
          content:
            application/json:
              schema:
                type: object
                properties:
                  boleta_anulada:
                    type: string
                    example: S
                  dv_autentificado:
                    type: string
                    example: '4'
                  dv_receptor:
                    type: string
                    example: '6'
                  fecha_cgi:
                    type: string
                    example: 16/09/2020
                  monto_maximo_anulacion:
                    type: string
                    example: '100000000'
                  nombre_contribuyente:
                    type: string
                    example: EMISOR
                  nombre_receptor:
                    type: string
                    example: >-
                      NACIONALES SIN RUT   (USO EXCLUSIVO F-29, NO USAR PARA
                      PRUEBAS)
                  nro_boleta_eliminar:
                    type: string
                    example: '155'
                  rut_autentificado:
                    type: string
                    example: '11222333'
                  rut_receptor:
                    type: string
                    example: '66666666'
              examples:
                Anular Boleta de Honorarios Emitida:
                  value:
                    boleta_anulada: S
                    dv_autentificado: '4'
                    dv_receptor: '6'
                    fecha_cgi: 16/09/2020
                    monto_maximo_anulacion: '100000000'
                    nombre_contribuyente: EMISOR
                    nombre_receptor: >-
                      NACIONALES SIN RUT   (USO EXCLUSIVO F-29, NO USAR PARA
                      PRUEBAS)
                    nro_boleta_eliminar: '155'
                    rut_autentificado: '11222333'
                    rut_receptor: '66666666'
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: '1111111-1'
        description: RUT del emisor de boleta
      - name: folio
        in: path
        required: true
        schema:
          type: string
          example: '155'
        description: Folio de la boleta
  /api/v1/sii/bhe/recibidas/documentos/{receptor}/{periodo}:
    post:
      tags:
        - API BHE - Boletas de Honorarios Recibidas
      summary: Listado de Boletas de Honorarios Recibidas
      description: >-
        **Permiso requerido**: `query bhe`


        **Pasarela a:**
        [https://loa.sii.cl/cgi_IMT/TMBCOC_MenuConsultasContribRec.cgi](https://loa.sii.cl/cgi_IMT/TMBCOC_MenuConsultasContribRec.cgi)


        La consulta de BHE debe ser realizada con el RUT y clave tributaria del
        receptor de las boletas.


        **¿Tienes muchas boletas recibidas?**


        Si tienes más de 100 BHE recibidas en un período, deberás bajar los
        listados de boletas de manera paginada.


        Para esto indica en tu primera llamada el parámetro `pagina=1` en la
        URL. Esta llamada te entregará:


        - La cantidad de boletas disponibles en el período en `n_boletas`.

        - Un código llamado `pagina_sig_codigo` que deberá ser pasado en la
        siguiente llamada.

        - El listado de boletas en `boletas`.


        Para obtener las siguientes páginas (desde la 2) deberás indicar el
        parámetro `pagina` y además el parámetro `pagina_sig_codigo` (también en
        la URL) con el código entregado previamente. Esto permitirá ir
        obteniendo de manera paginada las boletas.


        Finalmente, cuando no queden páginas, el campo `pagina_sig_codigo`
        tendrá el valor `00000000000000` en la respuesta de la API.


        **¿Se pueden consultar por día?**


        Si, es posible consultar las boletas de manera diaria. Por ejemplo
        20220316 consultará por el día 16 de marzo del año 2022.


        **¿Por qué no veo la retención del emisor cuando consulto por mes?**


        El SII no entrega la retención por día cuando es del emisor. Se podría
        asumir con el total de honorarios y el líquido.


        **¿Por qué no veo el RUT del emisor cuando consulto por día?**


        El SII no entrega el RUT del emisor de la BHE al consultar por día.


        **¿Qué significa el valor del campo "estado"?**


        - **N:** Vigente.

        - **S**: Anulada.

        - **V**: Vigente con solicitud de anulacion pendiente.

        - **R**: Observada por el Receptor.

        - **U**: Observada en la Unidad del SII.


        Otros valores de estado no están definidos por SII.
      operationId: listadoDeBoletasDeHonorariosRecibidas
      parameters:
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `csv`'
        - name: csv_delimiter
          in: query
          schema:
            type: string
            example: ;
          description: Delimitador que se debe usar en el formato CSV
        - name: pagina
          in: query
          schema:
            type: string
            example: '1'
        - name: pagina_sig_codigo
          in: query
          schema:
            type: string
            example: '00000000000000'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              Listado de Boletas de Honorarios Recibidas:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: Listado de Boletas de Honorarios Recibidas
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    anulada:
                      type: string
                      example: ''
                    codigo:
                      type: string
                      example: ''
                    comuna:
                      type: string
                      example: '13159'
                    dv:
                      type: string
                      example: '9'
                    estado:
                      type: string
                      example: 'N'
                    fecha:
                      type: string
                      example: '2020-07-02'
                    nombre:
                      type: string
                      example: ''
                    numero:
                      type: string
                      example: '123'
                    rut:
                      type: string
                      example: '1'
                    sociedad_profesional:
                      type: string
                      example: 'NO'
                    total_honorarios:
                      type: string
                      example: '67227'
                    total_liquido:
                      type: string
                      example: '60000'
                    total_retencion:
                      type: string
                      example: '7227'
                example:
                  - anulada: ''
                    codigo: ''
                    comuna: '13159'
                    dv: '9'
                    estado: 'N'
                    fecha: '2020-07-02'
                    nombre: ''
                    numero: '123'
                    rut: '1'
                    sociedad_profesional: 'NO'
                    total_honorarios: '67227'
                    total_liquido: '60000'
                    total_retencion: '7227'
              examples:
                Listado de Boletas de Honorarios Recibidas:
                  value:
                    - anulada: ''
                      codigo: ''
                      comuna: '13159'
                      dv: '9'
                      estado: 'N'
                      fecha: '2020-07-02'
                      nombre: ''
                      numero: '123'
                      rut: '1'
                      sociedad_profesional: 'NO'
                      total_honorarios: '67227'
                      total_liquido: '60000'
                      total_retencion: '7227'
    parameters:
      - name: receptor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: Receptor de la boleta
      - name: periodo
        in: path
        required: true
        schema:
          type: string
          example: '202404'
        description: Período donde buscar las boletas
  /api/v1/sii/bhe/recibidas/pdf/{codigo}:
    post:
      tags:
        - API BHE - Boletas de Honorarios Recibidas
      summary: Descargar PDF Boleta de Honorarios Recibida
      description: >-
        **Permiso requerido**: `query bhe`


        **Pasarela a:**
        [https://loa.sii.cl/cgi_IMT/TMBCOC_MenuConsultasContribRec.cgi](https://loa.sii.cl/cgi_IMT/TMBCOC_MenuConsultasContribRec.cgi)


        Este recurso permite obtener el PDF de una boleta de honorarios.


        Se utiliza el código de la boleta asignado por SII para obtener el PDF.


        Un listado de código se encuentra en el servicio que permite obtener el
        listado de boletas.
      operationId: descargarPdfBoletaDeHonorariosRecibida
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              Descargar PDF Boleta de Honorarios Recibida:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: ''
    parameters:
      - name: codigo
        in: path
        required: true
        schema:
          type: string
          example: 1626106300140D0D5733
        description: Código de la boleta
  /api/v1/sii/bhe/recibidas/observar/{emisor}/{folio}:
    post:
      tags:
        - API BHE - Boletas de Honorarios Recibidas
      summary: Observar Boleta de Honorarios Recibida
      description: >-
        **Permiso requerido**: `query bhe`


        **Pasarela a:**
        [https://loa.sii.cl/cgi_IMT/TMBANU_ListarBheRechazarReceptor.cgi?dummy=1](https://loa.sii.cl/cgi_IMT/TMBANU_ListarBheRechazarReceptor.cgi?dummy=1)


        Permite observar una boleta de honorarios electrónica previamente
        recibida.
      operationId: observarBoletaDeHonorariosRecibida
      parameters:
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `html`'
        - name: causa
          in: query
          schema:
            type: string
            example: '1'
          description: >-
            `1` No se reconoce la relación contractual o comercial con el
            emisor<br/>

            `2` No se reconoce al emisor de la BHE
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              Observar Boleta de Honorarios Recibida:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: Observar Boleta de Honorarios Recibida
          content:
            application/json:
              schema:
                type: object
                properties:
                  dv_arrastre:
                    type: string
                    example: '9'
                  fecha_cgi:
                    type: string
                    example: 16/08/2020
                  nombre_contribuyente:
                    type: string
                    example: SASCO SPA
                  nro_trx:
                    type: string
                    example: '12345678'
                  rut_arrastre:
                    type: string
                    example: '76192083'
              examples:
                Observar Boleta de Honorarios Recibida:
                  value:
                    dv_arrastre: '9'
                    fecha_cgi: 16/08/2020
                    nombre_contribuyente: SASCO SPA
                    nro_trx: '12345678'
                    rut_arrastre: '76192083'
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: '1111111-1'
        description: RUT del emisor de boleta
      - name: folio
        in: path
        required: true
        schema:
          type: string
          example: '151'
        description: Folio de la boleta
  /api/v1/sii/bte/emitidas/resumen/{emisor}/{anio}:
    post:
      tags:
        - API BTE - Boletas de Terceros Emitidas
      summary: Resumen Mensual y Anual de Boletas de Terceros Emitidas
      description: >-
        **Permiso requerido**: `query bte`


        **Pasarela a:**
        [https://zeus.sii.cl/cvc_cgi/bte/bte_indiv_cons?1](https://zeus.sii.cl/cvc_cgi/bte/bte_indiv_cons?1)


        Obtiene el resumen anual de las boletas emitidas.
      operationId: resumenMensualYAnualDeBoletasDeTercerosEmitidas
      parameters:
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `csv` `html`'
        - name: csv_delimiter
          in: query
          schema:
            type: string
            example: ;
          description: Delimitador del archivo CSV
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              Resumen Mensual y Anual de Boletas de Terceros Emitidas:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: Resumen Mensual de Boletas de Terceros Emitidas
          content:
            application/json:
              schema:
                type: object
                properties:
                  anual:
                    type: object
                    properties:
                      anuladas:
                        type: number
                        example: 0
                      bruto:
                        type: number
                        example: 0
                      folio_final:
                        type: number
                        example: 0
                      folio_inicial:
                        type: number
                        example: 0
                      retencion:
                        type: number
                        example: 0
                      total:
                        type: number
                        example: 0
                      vigentes:
                        type: number
                        example: 0
                  mensual:
                    type: array
                    items:
                      type: object
                      properties:
                        anuladas:
                          type: number
                          example: 0
                        bruto:
                          type: number
                          example: 0
                        folio_final:
                          type: number
                          example: 0
                        folio_inicial:
                          type: number
                          example: 0
                        mes_codigo:
                          type: string
                          example: '01'
                        mes_glosa:
                          type: string
                          example: Enero
                        retencion:
                          type: number
                          example: 0
                        total:
                          type: number
                          example: 0
                        vigentes:
                          type: number
                          example: 0
                    example:
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '01'
                        mes_glosa: Enero
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '02'
                        mes_glosa: Febrero
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '03'
                        mes_glosa: Marzo
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '04'
                        mes_glosa: Abril
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '05'
                        mes_glosa: Mayo
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '06'
                        mes_glosa: Junio
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '07'
                        mes_glosa: Julio
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '08'
                        mes_glosa: Agosto
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '09'
                        mes_glosa: Septiembre
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '10'
                        mes_glosa: Octubre
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '11'
                        mes_glosa: Noviembre
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '12'
                        mes_glosa: Diciembre
                        retencion: 0
                        total: 0
                        vigentes: 0
              examples:
                Resumen Mensual de Boletas de Terceros Emitidas:
                  value:
                    anual:
                      anuladas: 0
                      bruto: 0
                      folio_final: 0
                      folio_inicial: 0
                      retencion: 0
                      total: 0
                      vigentes: 0
                    mensual:
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '01'
                        mes_glosa: Enero
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '02'
                        mes_glosa: Febrero
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '03'
                        mes_glosa: Marzo
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '04'
                        mes_glosa: Abril
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '05'
                        mes_glosa: Mayo
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '06'
                        mes_glosa: Junio
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '07'
                        mes_glosa: Julio
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '08'
                        mes_glosa: Agosto
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '09'
                        mes_glosa: Septiembre
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '10'
                        mes_glosa: Octubre
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '11'
                        mes_glosa: Noviembre
                        retencion: 0
                        total: 0
                        vigentes: 0
                      - anuladas: 0
                        bruto: 0
                        folio_final: 0
                        folio_inicial: 0
                        mes_codigo: '12'
                        mes_glosa: Diciembre
                        retencion: 0
                        total: 0
                        vigentes: 0
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: Emitsor de la BTE
      - name: anio
        in: path
        required: true
        schema:
          type: string
          example: '2024'
        description: Año que se desea obtener el resumen
  /api/v1/sii/bte/emitidas/documentos/{emisor}/{periodo}:
    post:
      tags:
        - API BTE - Boletas de Terceros Emitidas
      summary: Listado de Boletas de Terceros Emitidas
      description: >-
        **Permiso requerido**: `query bte`


        **Pasarela a:**
        [https://zeus.sii.cl/cvc_cgi/bte/bte_indiv_cons?1](https://zeus.sii.cl/cvc_cgi/bte/bte_indiv_cons?1)


        La consulta de BTE debe ser realizada con el RUT y clave tributaria del
        emisor de las boletas.
      operationId: listadoDeBoletasDeTercerosEmitidas
      parameters:
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `csv`'
        - name: csv_delimiter
          in: query
          schema:
            type: string
            example: ;
          description: Delimitador que se debe usar en el formato CSV
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              Listado de Boletas de Terceros Emitidas:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: Listado de Boletas de Terceros Emitidas
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    codigo:
                      type: string
                      example: ''
                    emisor_nombre:
                      type: string
                      example: SASCO SPA
                    emisor_rut:
                      type: string
                      example: 76192083-9
                    estado:
                      type: string
                      example: ANUL
                    fecha:
                      type: string
                      example: '2019-12-03'
                    fecha_emision:
                      type: string
                      example: '2019-12-03'
                    numero:
                      type: string
                      example: '123'
                    receptor_nombre:
                      type: string
                      example: ''
                    receptor_rut:
                      type: string
                      example: 1-9
                    total_honorarios:
                      type: number
                      example: 150
                    total_liquido:
                      type: number
                      example: 135
                    total_retencion:
                      type: number
                      example: 15
                example:
                  - codigo: ''
                    emisor_nombre: SASCO SPA
                    emisor_rut: 76192083-9
                    estado: ANUL
                    fecha: '2019-12-03'
                    fecha_emision: '2019-12-03'
                    numero: '123'
                    receptor_nombre: ''
                    receptor_rut: 1-9
                    total_honorarios: 150
                    total_liquido: 135
                    total_retencion: 15
              examples:
                Listado de Boletas de Terceros Emitidas:
                  value:
                    - codigo: ''
                      emisor_nombre: SASCO SPA
                      emisor_rut: 76192083-9
                      estado: ANUL
                      fecha: '2019-12-03'
                      fecha_emision: '2019-12-03'
                      numero: '123'
                      receptor_nombre: ''
                      receptor_rut: 1-9
                      total_honorarios: 150
                      total_liquido: 135
                      total_retencion: 15
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del emisor de las BTE
      - name: periodo
        in: path
        required: true
        schema:
          type: string
          example: '20220131'
        description: Período de las BTE buscadas
  /api/v1/sii/bte/emitidas/emitir:
    post:
      tags:
        - API BTE - Boletas de Terceros Emitidas
      summary: Emitir Boleta de Terceros
      description: >-
        **Permiso requerido**: `query bte`


        **Pasarela a:**
        [https://zeus.sii.cl/cvc_cgi/bte/bte_indiv_ing](https://zeus.sii.cl/cvc_cgi/bte/bte_indiv_ing)


        Este recurso permite emitir una BTE en el SII.


        Se aplica una tasa de retención que varía según el período de emisión de
        la BTE:


        | Período | Retención |

        | --- | --- |

        | 2020 | 10,75% |

        | 2021 | 11,50% |

        | 2022 | 12,25% |

        | 2023 | 13,00% |

        | 2024 | 13,75% |

        | 2025 | 14,50% |

        | 2026 | 15,25% |

        | 2027 | 16,00% |

        | 2028 | 17,00% |


        Sin embargo, por el [préstamo
        solidario](https://www.sii.cl/destacados/prestamo_solidario/), algunos
        contribuyentes pueden tener una tasa de retención adicional del 3%. Es
        importante al emitir una BTE [corroborar la tasa de
        retención](https://documenter.getpostman.com/view/5911929/SWLiYkK9#4d6d7113-bf96-4580-a057-da150000e4cb).


        Si el receptor de la BTE tiene retención adiciona del 3%. Envía la tasa
        real en los datos de la boleta, esto será meramente informativo y no
        afectará la creación de la boleta en el SII (ya que el SII hace los
        cálculos sin considerar lo que envíes). Sin embargo, servirá para que en
        nuestra respuesta se entregue la retención correcta.


        Debes enviar la retención en el encabezado:


        ```

        {
            "Encabezado": {
                "Totales": {
                    "TasaRetencion": 15.25
                }
            }
        }


        ```
      operationId: emitirBoletaDeTerceros
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
                boleta:
                  type: object
                  properties:
                    Detalle:
                      type: array
                      items:
                        type: object
                        properties:
                          MontoItem:
                            type: number
                            example: 50
                          NmbItem:
                            type: string
                            example: Prueba integracion API Gateway 1
                      example:
                        - MontoItem: 50
                          NmbItem: Prueba integracion API Gateway 1
                        - MontoItem: 100
                          NmbItem: Prueba integracion API Gateway 2
                    Encabezado:
                      type: object
                      properties:
                        Emisor:
                          type: object
                          properties:
                            RUTEmisor:
                              type: string
                              example: 76192083-9
                        IdDoc:
                          type: object
                          properties:
                            FchEmis:
                              type: string
                              example: '2024-10-10'
                        Receptor:
                          type: object
                          properties:
                            CmnaRecep:
                              type: string
                              example: Santa Cruz
                            DirRecep:
                              type: string
                              example: Santa Cruz
                            RUTRecep:
                              type: string
                              example: 66666666-6
                            RznSocRecep:
                              type: string
                              example: Receptor generico
            examples:
              Emitir Boleta de Terceros:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
                  boleta:
                    Detalle:
                      - MontoItem: 50
                        NmbItem: Prueba integracion API Gateway 1
                      - MontoItem: 100
                        NmbItem: Prueba integracion API Gateway 2
                    Encabezado:
                      Emisor:
                        RUTEmisor: 76192083-9
                      IdDoc:
                        FchEmis: '2024-10-10'
                      Receptor:
                        CmnaRecep: Santa Cruz
                        DirRecep: Santa Cruz
                        RUTRecep: 66666666-6
                        RznSocRecep: Receptor generico
      responses:
        '200':
          description: ''
  /api/v1/sii/bte/emitidas/html/{codigo}:
    post:
      tags:
        - API BTE - Boletas de Terceros Emitidas
      summary: Descargar HTML Boleta de Terceros
      description: "**Permiso requerido**: `query bte`\n\n**Pasarela a:**\_[https://zeus.sii.cl/cvc_cgi/bte/bte_indiv_cons?1](https://desktop.postman.com/?desktopVersion=10.13.0&userId=5911929&teamId=649152)\n\nEste recurso permite obtener el HTML de una boleta de terceros.\n\nSe utiliza el código de la boleta asignado por SII para obtener el HTML."
      operationId: descargarHtmlBoletaDeTerceros
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              Descargar HTML Boleta de Terceros:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: ''
    parameters:
      - name: codigo
        in: path
        required: true
        schema:
          type: string
          example: C76192083000257D09D17
        description: Código de la BTE
  /api/v1/sii/bte/emitidas/anular/{emisor}/{folio}:
    post:
      tags:
        - API BTE - Boletas de Terceros Emitidas
      summary: Anular Boleta de Terceros Emitida
      description: >-
        **Permiso requerido**: `query bte`


        **Pasarela a:**
        [https://zeus.sii.cl/cvc_cgi/bte/bte_indiv_anula](https://zeus.sii.cl/cvc_cgi/bte/bte_indiv_anula)


        Permite anular una Boleta de Terceros Electrónica.
      operationId: anularBoletaDeTercerosEmitida
      parameters:
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `html`'
        - name: causa
          in: query
          schema:
            type: string
            example: '3'
          description: >-
            `2` No se efectuó la prestación de servicios<br/>`3` Error en la
            digitación
        - name: periodo
          in: query
          schema:
            type: string
            example: '0'
          description: >-
            Período de la boleta (usado para acelerar la consulta si el formato
            es `json`)
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              Anular Boleta de Terceros Emitida:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: Anular Boleta de Terceros Emitida
          content:
            application/json:
              schema:
                type: object
                properties:
                  emisor_rut:
                    type: string
                    example: 76192083-9
                  estado:
                    type: string
                    example: ANUL
                  fecha_anulacion:
                    type: string
                    example: '2024-10-10'
                  numero:
                    type: number
                    example: 336
              examples:
                Anular Boleta de Terceros Emitida:
                  value:
                    emisor_rut: 76192083-9
                    estado: ANUL
                    fecha_anulacion: '2024-10-10'
                    numero: 336
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: Emisor de la BTE
      - name: folio
        in: path
        required: true
        schema:
          type: string
          example: '336'
        description: Folio de la BTE
  /api/v1/sii/bte/emitidas/documento/{emisor}/{folio}:
    post:
      tags:
        - API BTE - Boletas de Terceros Emitidas
      summary: Buscar datos Boleta de Terceros
      description: "**Permiso requerido**: `query bte`\n\n**Pasarela a:**\_[https://zeus.sii.cl/cvc_cgi/bte/bte_indiv_cons?1](https://desktop.postman.com/?desktopVersion=10.13.0&userId=5911929&teamId=649152)\n\nPermite obtener los datos de una Boleta de Terceros Electrónica."
      operationId: buscarDatosBoletaDeTerceros
      parameters:
        - name: periodo
          in: query
          schema:
            type: string
            example: '20241010'
          description: Período de la boleta (acelera la búsqueda)
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              Buscar datos Boleta de Terceros:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: Buscar datos Boleta de Terceros
          content:
            application/json:
              schema:
                type: object
                properties:
                  codigo:
                    type: string
                    example: ''
                  emisor_nombre:
                    type: string
                    example: SASCO SPA
                  emisor_rut:
                    type: string
                    example: 76192083-9
                  estado:
                    type: string
                    example: ANUL
                  fecha:
                    type: string
                    example: '2019-12-22'
                  fecha_emision:
                    type: string
                    example: '2019-12-22'
                  numero:
                    type: string
                    example: '123'
                  receptor_nombre:
                    type: string
                    example: ''
                  receptor_rut:
                    type: string
                    example: 1-9
                  total_honorarios:
                    type: number
                    example: 150
                  total_liquido:
                    type: number
                    example: 135
                  total_retencion:
                    type: number
                    example: 15
              examples:
                Buscar datos Boleta de Terceros:
                  value:
                    codigo: ''
                    emisor_nombre: SASCO SPA
                    emisor_rut: 76192083-9
                    estado: ANUL
                    fecha: '2019-12-22'
                    fecha_emision: '2019-12-22'
                    numero: '123'
                    receptor_nombre: ''
                    receptor_rut: 1-9
                    total_honorarios: 150
                    total_liquido: 135
                    total_retencion: 15
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: Emisor de la BTE
      - name: folio
        in: path
        required: true
        schema:
          type: string
          example: '336'
        description: Folio de la BTE
  /api/v1/sii/bte/emitidas/receptor_tasa/{emisor}/{receptor}:
    post:
      tags:
        - API BTE - Boletas de Terceros Emitidas
      summary: Obtener la tasa del receptor de una BTE
      description: "**Permiso requerido**: `query bte`\n\n**Pasarela a:**\_[https://zeus.sii.cl/cvc_cgi/bte/bte_indiv_ing](https://desktop.postman.com/?desktopVersion=10.13.0&userId=5911929&teamId=649152)\n\nPermite obtener la tasa real que se debe usar con el receptor de la Boleta de Terceros Electrónica.\n\nEsto es necesario por la tasa adicional que puede existir en la retención. Ejemplo: 3% adicional por préstamo del SII."
      operationId: obtenerLaTasaDelReceptorDeUnaBte
      parameters:
        - name: periodo
          in: query
          schema:
            type: string
            example: '202111'
          description: 'Período de la tasa de retención buscada: AAAAMM'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: 76192083-9
            examples:
              Obtener la tasa del receptor de una BTE:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: 76192083-9
      responses:
        '200':
          description: Obtener la tasa del receptor de una BTE
          content:
            application/json:
              schema:
                type: object
                properties:
                  periodo:
                    type: number
                    example: 202111
                  tasa_base:
                    type: number
                    example: 11.5
                  tasa_receptor:
                    type: number
                    example: 11.5
              examples:
                Obtener la tasa del receptor de una BTE:
                  value:
                    periodo: 202111
                    tasa_base: 11.5
                    tasa_receptor: 11.5
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: Emisor de la BTE
      - name: receptor
        in: path
        required: true
        schema:
          type: string
          example: '1111111-1'
        description: Receptor de la BTE
  /api/v1/sii/bte/recibidas/documentos/{receptor}/{periodo}:
    post:
      tags:
        - API BTE - Boletas de Terceros Recibidas
      summary: Listado de Boletas de Terceros Recibidas
      description: >-
        **Permiso requerido**: `query bte`


        **Pasarela a:**
        [https://zeus.sii.cl/cvc_cgi/bte/bte_indiv_cons?2](https://zeus.sii.cl/cvc_cgi/bte/bte_indiv_cons?2)


        La consulta de BHE debe ser realizada con el RUT y clave tributaria del
        emisor de las boletas.
      operationId: listadoDeBoletasDeTercerosRecibidas
      parameters:
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `csv`'
        - name: csv_delimiter
          in: query
          schema:
            type: string
            example: ;
          description: Delimitador que se debe usar en el formato CSV
        - name: error_detail
          in: query
          schema:
            type: string
            example: '1'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: '1111111-1'
            examples:
              Listado de Boletas de Terceros Recibidas:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: '1111111-1'
      responses:
        '200':
          description: Listado de Boletas de Honorarios Emitidas
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    anulada:
                      type: string
                      example: '2019-08-15'
                    codigo:
                      type: string
                      example: ''
                    dv:
                      type: string
                      example: '9'
                    email_envio:
                      type: string
                      example: ''
                    estado:
                      type: string
                      example: S
                    fecha:
                      type: string
                      example: '2019-08-14'
                    fecha_emision:
                      type: string
                      example: '2019-08-15'
                    nombre:
                      type: string
                      example: ''
                    numero:
                      type: number
                      example: 123
                    retencion_emisor:
                      type: number
                      example: 15
                    retencion_receptor:
                      type: number
                      example: 0
                    rut:
                      type: number
                      example: 1
                    sociedad_profesional:
                      type: string
                      example: 'NO'
                    total_honorarios:
                      type: number
                      example: 150
                    total_liquido:
                      type: number
                      example: 135
                    usuario_emisor:
                      type: string
                      example: ''
                example:
                  - anulada: '2019-08-15'
                    codigo: ''
                    dv: '9'
                    email_envio: ''
                    estado: S
                    fecha: '2019-08-14'
                    fecha_emision: '2019-08-15'
                    nombre: ''
                    numero: 123
                    retencion_emisor: 15
                    retencion_receptor: 0
                    rut: 1
                    sociedad_profesional: 'NO'
                    total_honorarios: 150
                    total_liquido: 135
                    usuario_emisor: ''
              examples:
                Listado de Boletas de Honorarios Emitidas:
                  value:
                    - anulada: '2019-08-15'
                      codigo: ''
                      dv: '9'
                      email_envio: ''
                      estado: S
                      fecha: '2019-08-14'
                      fecha_emision: '2019-08-15'
                      nombre: ''
                      numero: 123
                      retencion_emisor: 15
                      retencion_receptor: 0
                      rut: 1
                      sociedad_profesional: 'NO'
                      total_honorarios: 150
                      total_liquido: 135
                      usuario_emisor: ''
    parameters:
      - name: receptor
        in: path
        required: true
        schema:
          type: string
          example: '1111111-1'
        description: Receptor de la boleta
      - name: periodo
        in: path
        required: true
        schema:
          type: string
          example: '202107'
        description: Período donde buscar las boletas
  /api/v1/sii/bte/recibidas/html/{codigo}:
    post:
      tags:
        - API BTE - Boletas de Terceros Recibidas
      summary: Descargar HTML Boleta de Terceros Recibida
      description: >-
        **Permiso requerido**: `query bte`


        **Pasarela a:**
        [https://zeus.sii.cl/cvc_cgi/bte/bte_indiv_cons?2](https://zeus.sii.cl/cvc_cgi/bte/bte_indiv_cons?2)


        Este recurso permite obtener el HTML de una boleta de terceros.


        Se utiliza el código de la boleta asignado por SII para obtener el HTML.
      operationId: descargarHtmlBoletaDeTercerosRecibida
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: '1111111-1'
            examples:
              Descargar HTML Boleta de Terceros Recibida:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: '1111111-1'
      responses:
        '200':
          description: ''
    parameters:
      - name: codigo
        in: path
        required: true
        schema:
          type: string
          example: C76192083000257D09D17
        description: Código de la BTE
  /api/v1/sii/vehiculos/tasacion/buscar:
    post:
      tags:
        - API Vehículos
      summary: Buscar Tasación Vehicular
      description: >-
        **Permiso requerido**: `query vehiculos`


        **Pasarela a:**
        [https://www4.sii.cl/vehiculospubui/#/searchtasacion](https://www4.sii.cl/vehiculospubui/#/searchtasacion)


        Recurso de la API que permite buscar la tasación fiscal de un vehículo y
        el valor del permiso de circulación para cierto periodo.


        Campos obligatorios:


        - `anioTasa`: año fiscal de la búsqueda (por defecto el año actual).

        - `categoria`: 1 es vehículo liviano.

        - `tipo`: 6 es SUV.


        Estos valores son opcionales, pero se recomienda al menos filtrar por
        `marca` y `anio` para que la búsqueda sea eficiente.


        - `marca`: 229 es SUZUKI.

        - `modelo`

        - `version`

        - `anio`


        Buscar sin estos filtros, descargará todos los registros, que puede ser
        útil si se desea obtener todos los datos para almacenar localmente y
        consultar con posterioridad.
      operationId: buscarTasaciNVehicular
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                anio:
                  type: number
                  example: 2017
                anioTasa:
                  type: number
                  example: 2020
                categoria:
                  type: number
                  example: 1
                marca:
                  type: number
                  example: 229
                modelo:
                  type: string
                  example: VITARA
                tipo:
                  type: number
                  example: 6
                version:
                  type: string
                  example: GLX SPORT
            examples:
              Buscar Tasación Vehicular:
                value:
                  anio: 2017
                  anioTasa: 2020
                  categoria: 1
                  marca: 229
                  modelo: VITARA
                  tipo: 6
                  version: GLX SPORT
      responses:
        '200':
          description: Buscar Tasación Vehicular
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    anio:
                      type: string
                      example: '2017'
                    anioAfabCase:
                      type: boolean
                      example: false
                    anioFab:
                      nullable: true
                      example: null
                    anioTasa:
                      type: string
                      example: '2020'
                    captcha:
                      nullable: true
                      example: null
                    cara:
                      type: number
                      example: 5
                    cateId:
                      type: string
                      example: '6'
                    cateName:
                      type: string
                      example: Liviano
                    category:
                      nullable: true
                      example: null
                    code:
                      type: string
                      example: SU2290241
                    codeVehicle:
                      nullable: true
                      example: null
                    data:
                      nullable: true
                      example: null
                    detail:
                      nullable: true
                      example: null
                    equi:
                      type: number
                      example: 0
                    filter:
                      nullable: true
                      example: null
                    haveFeatures:
                      type: boolean
                      example: false
                    id:
                      type: number
                      example: 15057
                    idCate:
                      type: number
                      example: 1
                    listData:
                      nullable: true
                      example: null
                    listas:
                      nullable: true
                      example: null
                    marca:
                      type: string
                      example: SUZUKI
                    markId:
                      type: string
                      example: '229'
                    method:
                      nullable: true
                      example: null
                    model:
                      type: string
                      example: GRAND VITARA
                    modelVehicle:
                      nullable: true
                      example: null
                    montoPerm:
                      type: number
                      example: 149389
                    montoTasa:
                      type: number
                      example: 7960000
                    name:
                      nullable: true
                      example: null
                    nameHtml:
                      nullable: true
                      example: null
                    page:
                      nullable: true
                      example: null
                    precio:
                      type: number
                      example: 0
                    recordsNumber:
                      nullable: true
                      example: null
                    rowCount:
                      nullable: true
                      example: null
                    txtCaptcha:
                      nullable: true
                      example: null
                    type:
                      type: string
                      example: Suv
                    typeClass:
                      nullable: true
                      example: null
                    version:
                      type: string
                      example: GLX SPORT
                    versionVehicle:
                      nullable: true
                      example: null
                    vin:
                      nullable: true
                      example: null
                    year:
                      nullable: true
                      example: null
                example:
                  - anio: '2017'
                    anioAfabCase: false
                    anioFab: null
                    anioTasa: '2020'
                    captcha: null
                    cara: 5
                    cateId: '6'
                    cateName: Liviano
                    category: null
                    code: SU2290241
                    codeVehicle: null
                    data: null
                    detail: null
                    equi: 0
                    filter: null
                    haveFeatures: false
                    id: 15057
                    idCate: 1
                    listData: null
                    listas: null
                    marca: SUZUKI
                    markId: '229'
                    method: null
                    model: GRAND VITARA
                    modelVehicle: null
                    montoPerm: 149389
                    montoTasa: 7960000
                    name: null
                    nameHtml: null
                    page: null
                    precio: 0
                    recordsNumber: null
                    rowCount: null
                    txtCaptcha: null
                    type: Suv
                    typeClass: null
                    version: GLX SPORT
                    versionVehicle: null
                    vin: null
                    year: null
              examples:
                Buscar Tasación Vehicular:
                  value:
                    - anio: '2017'
                      anioAfabCase: false
                      anioFab: null
                      anioTasa: '2020'
                      captcha: null
                      cara: 5
                      cateId: '6'
                      cateName: Liviano
                      category: null
                      code: SU2290241
                      codeVehicle: null
                      data: null
                      detail: null
                      equi: 0
                      filter: null
                      haveFeatures: false
                      id: 15057
                      idCate: 1
                      listData: null
                      listas: null
                      marca: SUZUKI
                      markId: '229'
                      method: null
                      model: GRAND VITARA
                      modelVehicle: null
                      montoPerm: 149389
                      montoTasa: 7960000
                      name: null
                      nameHtml: null
                      page: null
                      precio: 0
                      recordsNumber: null
                      rowCount: null
                      txtCaptcha: null
                      type: Suv
                      typeClass: null
                      version: GLX SPORT
                      versionVehicle: null
                      vin: null
                      year: null
  /api/v1/sii/vehiculos/categorias/tipos/{categoria}:
    get:
      tags:
        - API Vehículos
      summary: Tipos de Vehículos según Categoría
      description: >-
        **Permiso requerido**: `query vehiculos`


        **Pasarela a:**
        [https://www4.sii.cl/vehiculospubui/#/searchtasacion](https://www4.sii.cl/vehiculospubui/#/searchtasacion)
      operationId: tiposDeVehCulosSegNCategorA
      responses:
        '200':
          description: Tipos de Vehículos según Categoría
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: number
                      example: 37
                    name:
                      type: string
                      example: Cabriolet
                example:
                  - id: 37
                    name: Cabriolet
              examples:
                Tipos de Vehículos según Categoría:
                  value:
                    - id: 37
                      name: Cabriolet
    parameters:
      - name: categoria
        in: path
        required: true
        schema:
          type: string
          example: '1'
        description: |
          ID de categorías:

          ID | Categoría
          ---|----------
          1  | Livianos
          2  | Pesados
          3  | Motos

  /api/v1/sii/vehiculos/categorias/marcas/{categoria}:
    get:
      tags:
        - API Vehículos
      summary: Marcas de Vehículos según Categoría
      description: >-
        **Permiso requerido**: `query vehiculos`


        **Pasarela a:**
        [https://www4.sii.cl/vehiculospubui/#/searchtasacion](https://www4.sii.cl/vehiculospubui/#/searchtasacion)
      operationId: marcasDeVehCulosSegNCategorA
      responses:
        '200':
          description: Marcas de Vehículos según Categoría
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      example: '1'
                    name:
                      type: string
                      example: ACADIAN
                example:
                  - id: '1'
                    name: ACADIAN
              examples:
                Marcas de Vehículos según Categoría:
                  value:
                    - id: '1'
                      name: ACADIAN
    parameters:
      - name: categoria
        in: path
        required: true
        schema:
          type: string
          example: '1'
        description: |
            ID de categorías:

            ID | Categoría
            ---|----------
            1  | Livianos
            2  | Pesados
            3  | Motos
  /api/v1/sii/vehiculos/categorias/caracteristicas/{categoria}:
    get:
      tags:
        - API Vehículos
      summary: Características de Vehículos según Categoría
      description: >-
        **Permiso requerido**: `query vehiculos`


        **Pasarela a:**
        [https://www4.sii.cl/vehiculospubui/#/searchtasacion](https://www4.sii.cl/vehiculospubui/#/searchtasacion)
      operationId: caracterSticasDeVehCulosSegNCategorA
      responses:
        '200':
          description: Características de Vehículos según Categoría
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    data:
                      type: array
                      items:
                        type: object
                        properties:
                          id:
                            type: string
                            example: '2'
                          name:
                            type: string
                            example: Bencina
                      nullable: true
                      example:
                        - id: '2'
                          name: Bencina
                        - id: '3'
                          name: Diesel
                        - id: '4'
                          name: Electrico
                        - id: '201'
                          name: Gas
                    id:
                      type: number
                      example: 1
                    name:
                      type: string
                      example: Combustible
                example:
                  - data:
                      - id: '2'
                        name: Bencina
                      - id: '3'
                        name: Diesel
                      - id: '4'
                        name: Electrico
                      - id: '201'
                        name: Gas
                    id: 1
                    name: Combustible
                  - data: null
                    id: 5
                    name: Cilindrada (CC)
              examples:
                Características de Vehículos según Categoría:
                  value:
                    - data:
                        - id: '2'
                          name: Bencina
                        - id: '3'
                          name: Diesel
                        - id: '4'
                          name: Electrico
                        - id: '201'
                          name: Gas
                      id: 1
                      name: Combustible
                    - data: null
                      id: 5
                      name: Cilindrada (CC)
    parameters:
      - name: categoria
        in: path
        required: true
        schema:
          type: string
          example: '1'
        description: |
            ID de categorías:

            ID | Categoría
            ---|----------
            1  | Livianos
            2  | Pesados
            3  | Motos
  /api/v1/sii/mipyme/contribuyentes/info/{contribuyente}/{emisor}/{dte}:
    post:
      tags:
        - API Software MIPYME SII - Contribuyentes
      summary: Información Pública de un Contribuyente
      description: >-
        **Permiso requerido**: `query mipyme`


        **Pasarela a:**
        [https://www1.sii.cl/cgi-bin/Portal001/mipeGenFacEx.cgi?PTDC_CODIGO=33](https://www1.sii.cl/cgi-bin/Portal001/mipeGenFacEx.cgi?PTDC_CODIGO=33)


        El RUT y clave tributaria del cuerpo de la solicitud deben ser de un
        usuario (persona) que tenga acceso a la empresa "emisora" que está
        registrada en el Portal MIPYME del SII.
      operationId: informaciNPBlicaDeUnContribuyente
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: '1111111-1'
            examples:
              Información Pública de un Contribuyente:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: '1111111-1'
      responses:
        '200':
          description: Información Pública de un Contribuyente
          content:
            application/json:
              schema:
                type: object
                properties:
                  actividades:
                    type: array
                    items:
                      type: object
                      properties:
                        codigo:
                          type: string
                          example: '619090'
                        glosa:
                          type: string
                          example: OTRAS ACTIVIDADES DE TELECOMUNICACIONES
                    example:
                      - codigo: '619090'
                        glosa: OTRAS ACTIVIDADES DE TELECOMUNICACIONES
                      - codigo: '620200'
                        glosa: ACTIVIDADES DE CONSULTORIA DE INFORMATIC
                  direcciones:
                    type: array
                    items:
                      type: object
                      properties:
                        ciudad:
                          type: string
                          example: SANTA CRUZ
                        comuna:
                          type: string
                          example: SANTA CRUZ
                        direccion:
                          type: string
                          example: Daniel Barros Grez 191
                        telefono:
                          type: string
                          example: 2 32102297
                    example:
                      - ciudad: SANTA CRUZ
                        comuna: SANTA CRUZ
                        direccion: Daniel Barros Grez 191
                        telefono: 2 32102297
                  dv:
                    type: string
                    example: '9'
                  razon_social:
                    type: string
                    example: SASCO SPA
                  rut:
                    type: number
                    example: 76192083
              examples:
                Información Pública de un Contribuyente:
                  value:
                    actividades:
                      - codigo: '619090'
                        glosa: OTRAS ACTIVIDADES DE TELECOMUNICACIONES
                      - codigo: '620200'
                        glosa: ACTIVIDADES DE CONSULTORIA DE INFORMATIC
                    direcciones:
                      - ciudad: SANTA CRUZ
                        comuna: SANTA CRUZ
                        direccion: Daniel Barros Grez 191
                        telefono: 2 32102297
                    dv: '9'
                    razon_social: SASCO SPA
                    rut: 76192083
    parameters:
      - name: contribuyente
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del Contribuyente que se desea consultar
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: '1111111-1'
        description: RUT del emisor en el Portal MIPYME del SII
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '33'
        description: Código de DTE que puede emitir el Emisor
  /api/v1/sii/mipyme/borradores/documentos/{emisor}:
    post:
      tags:
        - API Software MIPYME SII - Documentos Borradores
      summary: Listado de Documentos Borradores
      description: >-
        **Permiso requerido**: `query mipyme`


        **Pasarela a:**
        [https://www4.sii.cl/mipymeinternetui/#!/borradores](https://www4.sii.cl/mipymeinternetui/#!/borradores)


        Por defecto se buscan todos los borradores, se puede usar el atributo
        `filtros` para definir filtrar por cualquier campo del borrador.


        Algunos filtros útiles son los siguientes:


        - `ptdc_CODIGO` Código del tipo de DTE

        - `efxp_RUT_RECEP` RUT sin DV del receptor

        - `efxp_MNT_TOTAL` Monto total del DTE
      operationId: listadoDeDocumentosBorradores
      parameters:
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `csv`'
        - name: csv_delimiter
          in: query
          schema:
            type: string
            example: ;
          description: Delimitador que se debe usar en el formato CSV
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: '1111111-1'
                filtros:
                  type: object
                  properties: {}
            examples:
              Listado de Documentos Borradores:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: '1111111-1'
                  filtros: {}
      responses:
        '200':
          description: ''
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: '1111111-1'
        description: RUT del emisor de los documentos
  /api/v1/sii/mipyme/borradores/emitir:
    post:
      tags:
        - API Software MIPYME SII - Documentos Borradores
      summary: Emitir Documento Borrador
      description: >-
        **Permiso requerido**: `query mipyme`


        **Pasarela a:**
        [https://www1.sii.cl/cgi-bin/Portal001/mipeGenFacEx.cgi?PTDC_CODIGO=33](https://www1.sii.cl/cgi-bin/Portal001/mipeGenFacEx.cgi?PTDC_CODIGO=33)


        Considerar los siguientes puntos al emitir un DTE:


        - Los datos del emisor si se envían no se usan, se usa lo por defecto
        del emisor en el SII. Se puede emitir sólo enviando el RUT del emisor.

        - Los datos del receptor deben ir por requerimiento de nuestra API, pero
        no se utilizan para generar el borrador. Se ocuparán los datos por
        defecto que tenga el receptor en el SII.

        - El descuento de un item sólo puede ser en porcentaje.

        - El descuento global puede ser en porcentaje o en monto, pero debe ser
        sólo 1 descuento (no se permiten recargos).

        - Los items son máximo 10.

        - Las referencias son máximo 3.

        - La factura afecta debe llevar sólo items afectos. Si se desea facturar
        items exentos deberán ir en una factura exenta aparte.

        - Para emitir una factura exenta se debe indicar en los items el campo
        `"IndExe": 1`. En el descuento global, en caso de existir, se debe
        indicar el campo `"IndExeDR": 1`

        - La guía de despacho no puede ir con descuentos, ni por item, ni
        global.

        - No se guarda la forma de pago en el borrador. Por lo que no se puede
        asignar algo diferente a crédito que es el valor por defecto.

        - No se guardan los datos de transporte en el borrador.
      operationId: emitirDocumentoBorrador
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: '1111111-1'
                dte:
                  type: object
                  properties:
                    Detalle:
                      type: array
                      items:
                        type: object
                        properties:
                          CdgItem:
                            type: object
                            properties:
                              TpoCodigo:
                                type: string
                                example: INT1
                              VlrCodigo:
                                type: string
                                example: cod1
                          DescuentoPct:
                            type: number
                            example: 50
                          DscItem:
                            type: string
                            example: Esta es la descripción del producto.
                          NmbItem:
                            type: string
                            example: Producto sin código, el más sencillo.
                          PrcItem:
                            type: number
                            example: 1000
                          QtyItem:
                            type: number
                            example: 1
                          UnmdItem:
                            type: string
                            example: Un
                      example:
                        - NmbItem: Producto sin código, el más sencillo.
                          PrcItem: 1000
                          QtyItem: 1
                        - CdgItem:
                            TpoCodigo: INT1
                            VlrCodigo: cod1
                          NmbItem: Producto con código.
                          PrcItem: 1000
                          QtyItem: 1
                        - DscItem: Esta es la descripción del producto.
                          NmbItem: Producto con descripción.
                          PrcItem: 1000
                          QtyItem: 1
                        - NmbItem: Producto con más de 1 cantidad y con unidad.
                          PrcItem: 1000
                          QtyItem: 3.5
                          UnmdItem: Un
                        - DescuentoPct: 50
                          NmbItem: Producto con descuento.
                          PrcItem: 1000
                          QtyItem: 1
                    DscRcgGlobal:
                      type: object
                      properties:
                        TpoMov:
                          type: string
                          example: D
                        TpoValor:
                          type: string
                          example: '%'
                        ValorDR:
                          type: string
                          example: '10'
                    Encabezado:
                      type: object
                      properties:
                        Emisor:
                          type: object
                          properties:
                            RUTEmisor:
                              type: string
                              example: '1111111-1'
                        IdDoc:
                          type: object
                          properties:
                            TipoDTE:
                              type: number
                              example: 33
                        RUTSolicita:
                          type: string
                          example: '1111111-1'
                        Receptor:
                          type: object
                          properties:
                            CmnaRecep:
                              type: string
                              example: Santa Cruz
                            DirRecep:
                              type: string
                              example: Santa Cruz
                            GiroRecep:
                              type: string
                              example: Informática
                            RUTRecep:
                              type: string
                              example: 76192083-9
                            RznSocRecep:
                              type: string
                              example: SASCO SpA
                    Referencia:
                      type: array
                      items:
                        type: object
                        properties:
                          FchRef:
                            type: string
                            example: '2022-09-03'
                          FolioRef:
                            type: number
                            example: 1
                          RazonRef:
                            type: string
                            example: Pedido por Esteban
                          TpoDocRef:
                            type: number
                            example: 52
                      example:
                        - FchRef: '2022-09-03'
                          FolioRef: 1
                          TpoDocRef: 52
                        - FchRef: '2022-09-01'
                          FolioRef: 123
                          RazonRef: Pedido por Esteban
                          TpoDocRef: 801
            examples:
              Emitir Documento Borrador:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: '1111111-1'
                  dte:
                    Detalle:
                      - NmbItem: Producto sin código, el más sencillo.
                        PrcItem: 1000
                        QtyItem: 1
                      - CdgItem:
                          TpoCodigo: INT1
                          VlrCodigo: cod1
                        NmbItem: Producto con código.
                        PrcItem: 1000
                        QtyItem: 1
                      - DscItem: Esta es la descripción del producto.
                        NmbItem: Producto con descripción.
                        PrcItem: 1000
                        QtyItem: 1
                      - NmbItem: Producto con más de 1 cantidad y con unidad.
                        PrcItem: 1000
                        QtyItem: 3.5
                        UnmdItem: Un
                      - DescuentoPct: 50
                        NmbItem: Producto con descuento.
                        PrcItem: 1000
                        QtyItem: 1
                    DscRcgGlobal:
                      TpoMov: D
                      TpoValor: '%'
                      ValorDR: '10'
                    Encabezado:
                      Emisor:
                        RUTEmisor: '1111111-1'
                      IdDoc:
                        TipoDTE: 33
                      RUTSolicita: '1111111-1'
                      Receptor:
                        CmnaRecep: Santa Cruz
                        DirRecep: Santa Cruz
                        GiroRecep: Informática
                        RUTRecep: 76192083-9
                        RznSocRecep: SASCO SpA
                    Referencia:
                      - FchRef: '2022-09-03'
                        FolioRef: 1
                        TpoDocRef: 52
                      - FchRef: '2022-09-01'
                        FolioRef: 123
                        RazonRef: Pedido por Esteban
                        TpoDocRef: 801
      responses:
        '200':
          description: ''
  /api/v1/sii/mipyme/borradores/eliminar/{emisor}/{codigo}:
    post:
      tags:
        - API Software MIPYME SII - Documentos Borradores
      summary: Eliminar Documento Borrador
      description: >-
        **Permiso requerido**: `query mipyme`


        **Pasarela a:**
        [https://www4.sii.cl/mipymeinternetui/#!/borradores](https://www4.sii.cl/mipymeinternetui/#!/borradores)
      operationId: eliminarDocumentoBorrador
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: '1111111-1'
            examples:
              Eliminar Documento Borrador:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: '1111111-1'
      responses:
        '200':
          description: ''
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: '1111111-1'
        description: RUT del emisor de los documentos
      - name: codigo
        in: path
        required: true
        schema:
          type: string
          example: '1792997'
        description: Código del Borrador que se desea eliminar
  /api/v1/sii/mipyme/borradores/pdf/{emisor}/{codigo}:
    post:
      tags:
        - API Software MIPYME SII - Documentos Borradores
      summary: Descargar PDF de un Documento Borrador
      description: >-
        **Permiso requerido**: `query mipyme`


        **Pasarela a:**
        [https://www4.sii.cl/mipymeinternetui/#!/borradores](https://www4.sii.cl/mipymeinternetui/#!/borradores)
      operationId: descargarPdfDeUnDocumentoBorrador
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: '1111111-1'
            examples:
              Descargar PDF de un Documento Borrador:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: '1111111-1'
      responses:
        '200':
          description: ''
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: '1111111-1'
        description: RUT del emisor de los documentos
      - name: codigo
        in: path
        required: true
        schema:
          type: string
          example: '2784513'
        description: Código del Borrador que se desea descargar su PDF
  /api/v1/sii/mipyme/emitidos/documentos/{emisor}:
    post:
      tags:
        - API Software MIPYME SII - Documentos Emitidos
      summary: Listado de Documentos Emitidos
      description: >-
        **Permiso requerido**: `query mipyme`


        **Pasarela a:**
        [https://www1.sii.cl/cgi-bin/Portal001/mipeAdminDocsEmi.cgi?RUT_RECP=&FOLIO=&RZN_SOC=&FEC_DESDE=&FEC_HASTA=&TPO_DOC=&ESTADO=&ORDEN=&NUM_PAG=1](https://www1.sii.cl/cgi-bin/Portal001/mipeAdminDocsEmi.cgi?RUT_RECP=&FOLIO=&RZN_SOC=&FEC_DESDE=&FEC_HASTA=&TPO_DOC=&ESTADO=&ORDEN=&NUM_PAG=1)


        Al realizar la búsqueda se pueden utilizar los siguientes filtros:


        - `FEC_DESDE` desde qué fecha buscar, formato AAAA-MM-DD.

        - `FEC_HASTA` hasta qué fecha buscar, formato AAAA-MM-DD.

        - `RUT_RECP` RUT del receptor del documento, sin puntos ni dígito
        verificador.

        - `RZN_SOC` razón social del receptor del documento.

        - `TPO_DOC` código de DTE que se está buscando.

        - `FOLIO` folio del documento.

        - `ESTADO` estado del DTE que se está buscando.


        Los valores para `ESTADO` pueden ser:


        - `EMI` Documento emitido

        - `PRV` Borrador (pre-view) de documento

        - `DCD` Certificado rechazado

        - `DEI` RUT emisor inválido

        - `DFI` Folio DTE inválido

        - `DIN` Incompleto

        - `DPF` Sin permiso de firma

        - `DRF` DTE rechazado por firma

        - `DRI` RUT receptor inválido

        - `DRR` Rechazado por repetido

        - `INI` DTE inicializado

        - `RAC` DTE aceptado por receptor

        - `RAD` DTE aceptado con discrepancias

        - `RNR` DTE no recibido por receptor

        - `RRC` DTE recibido por receptor

        - `RRH` DTE rechazado por receptor

        - `RSR` Recibido sin reparos
      operationId: listadoDeDocumentosEmitidos
      parameters:
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `csv`'
        - name: csv_delimiter
          in: query
          schema:
            type: string
            example: ;
          description: Delimitador que se debe usar en el formato CSV
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: '1111111-1'
                filtros:
                  type: object
                  properties:
                    FEC_DESDE:
                      type: string
                      example: '2019-01-01'
                    FEC_HASTA:
                      type: string
                      example: '2019-12-31'
            examples:
              Listado de Documentos Emitidos:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: '1111111-1'
                  filtros:
                    FEC_DESDE: '2019-01-01'
                    FEC_HASTA: '2019-12-31'
      responses:
        '200':
          description: Listado de Documentos Emitidos
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    codigo:
                      type: string
                      example: '123456789'
                    dte:
                      type: number
                      example: 34
                    dte_glosa:
                      type: string
                      example: Factura Exenta Electronica
                    dv:
                      type: string
                      example: '4'
                    estado:
                      type: string
                      example: Documento Emitido
                    fecha:
                      type: string
                      example: '2021-02-07'
                    folio:
                      type: string
                      example: '1'
                    razon_social:
                      type: string
                      example: EMPRESA SpA
                    rut:
                      type: string
                      example: '11222333'
                    total:
                      type: string
                      example: '10000'
                example:
                  - codigo: '123456789'
                    dte: 34
                    dte_glosa: Factura Exenta Electronica
                    dv: '4'
                    estado: Documento Emitido
                    fecha: '2021-02-07'
                    folio: '1'
                    razon_social: EMPRESA SpA
                    rut: '11222333'
                    total: '10000'
              examples:
                Listado de Documentos Emitidos:
                  value:
                    - codigo: '123456789'
                      dte: 34
                      dte_glosa: Factura Exenta Electronica
                      dv: '4'
                      estado: Documento Emitido
                      fecha: '2021-02-07'
                      folio: '1'
                      razon_social: EMPRESA SpA
                      rut: '11222333'
                      total: '10000'
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: '1111111-1'
        description: RUT del emisor de los documentos
  /api/v1/sii/mipyme/emitidos/pdf/{emisor}/{dte}/{folio}:
    post:
      tags:
        - API Software MIPYME SII - Documentos Emitidos
      summary: Descargar PDF de un DTE Emitido
      description: >-
        **Permiso requerido**: `query mipyme`


        **Pasarela a:**
        [https://www1.sii.cl/cgi-bin/Portal001/mipeAdminDocsEmi.cgi?RUT_RECP=&FOLIO=&RZN_SOC=&FEC_DESDE=&FEC_HASTA=&TPO_DOC=&ESTADO=&ORDEN=&NUM_PAG=1](https://www1.sii.cl/cgi-bin/Portal001/mipeAdminDocsEmi.cgi?RUT_RECP=&FOLIO=&RZN_SOC=&FEC_DESDE=&FEC_HASTA=&TPO_DOC=&ESTADO=&ORDEN=&NUM_PAG=1)
      operationId: descargarPdfDeUnDteEmitido
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: '1111111-1'
            examples:
              Descargar PDF de un DTE Emitido:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: '1111111-1'
      responses:
        '200':
          description: ''
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: '1111111-1'
        description: RUT del emisor del DTE
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '33'
        description: Código del DTE
      - name: folio
        in: path
        required: true
        schema:
          type: string
          example: '639'
        description: Folio del DTE
  /api/v1/sii/mipyme/emitidos/xml/{emisor}/{dte}/{folio}:
    post:
      tags:
        - API Software MIPYME SII - Documentos Emitidos
      summary: Descargar XML de un DTE emitido
      description: >-
        **Permiso requerido**: `query mipyme`


        **Pasarela a:**
        [https://www1.sii.cl/cgi-bin/Portal001/mipeAdminDocsEmi.cgi?RUT_RECP=&FOLIO=&RZN_SOC=&FEC_DESDE=&FEC_HASTA=&TPO_DOC=&ESTADO=&ORDEN=&NUM_PAG=1](https://www1.sii.cl/cgi-bin/Portal001/mipeAdminDocsEmi.cgi?RUT_RECP=&FOLIO=&RZN_SOC=&FEC_DESDE=&FEC_HASTA=&TPO_DOC=&ESTADO=&ORDEN=&NUM_PAG=1)
      operationId: descargarXmlDeUnDteEmitido
      parameters:
        - name: auth_cache
          in: query
          schema:
            type: string
            example: '0'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: '1111111-1'
            examples:
              Descargar XML de un DTE emitido:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: '1111111-1'
      responses:
        '200':
          description: ''
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: '1111111-1'
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '33'
      - name: folio
        in: path
        required: true
        schema:
          type: string
          example: '913'
  /api/v1/sii/mipyme/recibidos/documentos/{receptor}:
    post:
      tags:
        - API Software MIPYME SII - Documentos Recibidos
      summary: Listado de Documentos Recibidos
      description: >-
        **Permiso requerido**: `query mipyme`


        **Pasarela a:**
        [https://www1.sii.cl/cgi-bin/Portal001/mipeAdminDocsRcp.cgi?RUT_EMI=&FOLIO=&RZN_SOC=&FEC_DESDE=&FEC_HASTA=&TPO_DOC=&ESTADO=&ORDEN=&NUM_PAG=1](https://www1.sii.cl/cgi-bin/Portal001/mipeAdminDocsRcp.cgi?RUT_EMI=&FOLIO=&RZN_SOC=&FEC_DESDE=&FEC_HASTA=&TPO_DOC=&ESTADO=&ORDEN=&NUM_PAG=1)


        Al realizar la búsqueda se pueden utilizar los siguientes filtros:


        - `FEC_DESDE` desde qué fecha buscar, formato AAAA-MM-DD.

        - `FEC_HASTA` hasta qué fecha buscar, formato AAAA-MM-DD.

        - `RUT_EMI` RUT del emisor del documento, sin puntos ni dígito
        verificador.

        - `RZN_SOC` razón social del emisor del documento.

        - `TPO_DOC` código de DTE que se está buscando.

        - `FOLIO` folio del documento.

        - `ESTADO` estado del DTE que se está buscando.


        Los valores para `ESTADO` pueden ser:


        - `EMI` Documento emitido

        - `PRV` Borrador (pre-view) de documento

        - `DCD` Certificado rechazado

        - `DEI` RUT emisor inválido

        - `DFI` Folio DTE inválido

        - `DIN` Incompleto

        - `DPF` Sin permiso de firma

        - `DRF` DTE rechazado por firma

        - `DRI` RUT receptor inválido

        - `DRR` Rechazado por repetido

        - `INI` DTE inicializado

        - `RAC` DTE aceptado por receptor

        - `RAD` DTE aceptado con discrepancias

        - `RNR` DTE no recibido por receptor

        - `RRC` DTE recibido por receptor

        - `RAL` DTE aceptado Ley 19.983

        - `RRH` DTE rechazado por receptor

        - `RSR` Recibido sin reparos
      operationId: listadoDeDocumentosRecibidos
      parameters:
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `csv`'
        - name: csv_delimiter
          in: query
          schema:
            type: string
            example: ;
          description: Delimitador que se debe usar en el formato CSV
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: '1111111-1'
                filtros:
                  type: object
                  properties:
                    FEC_DESDE:
                      type: string
                      example: '2019-01-01'
                    FEC_HASTA:
                      type: string
                      example: '2019-12-31'
            examples:
              Listado de Documentos Recibidos:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: '1111111-1'
                  filtros:
                    FEC_DESDE: '2019-01-01'
                    FEC_HASTA: '2019-12-31'
      responses:
        '200':
          description: Listado de Documentos Recibidos
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    codigo:
                      type: string
                      example: '123456789'
                    dte:
                      type: number
                      example: 33
                    dte_glosa:
                      type: string
                      example: Factura Electronica
                    dv:
                      type: string
                      example: '4'
                    estado:
                      type: string
                      example: DTE Recibido Sin Reparos
                    fecha:
                      type: string
                      example: '2020-02-07'
                    folio:
                      type: string
                      example: '1'
                    razon_social:
                      type: string
                      example: Proveedor SpA
                    rut:
                      type: string
                      example: '11222333'
                    total:
                      type: string
                      example: '10000'
                example:
                  - codigo: '123456789'
                    dte: 33
                    dte_glosa: Factura Electronica
                    dv: '4'
                    estado: DTE Recibido Sin Reparos
                    fecha: '2020-02-07'
                    folio: '1'
                    razon_social: Proveedor SpA
                    rut: '11222333'
                    total: '10000'
              examples:
                Listado de Documentos Recibidos:
                  value:
                    - codigo: '123456789'
                      dte: 33
                      dte_glosa: Factura Electronica
                      dv: '4'
                      estado: DTE Recibido Sin Reparos
                      fecha: '2020-02-07'
                      folio: '1'
                      razon_social: Proveedor SpA
                      rut: '11222333'
                      total: '10000'
    parameters:
      - name: receptor
        in: path
        required: true
        schema:
          type: string
          example: '1111111-1'
        description: RUT del receptor de los documentos
  /api/v1/sii/mipyme/recibidos/pdf/{receptor}/{emisor}/{dte}/{folio}:
    post:
      tags:
        - API Software MIPYME SII - Documentos Recibidos
      summary: Descargar PDF de un DTE Recibido
      description: "**Permiso requerido**: `query mipyme`\n\n**Pasarela a:**\_[https://www1.sii.cl/cgi-bin/Portal001/mipeAdminDocsRcp.cgi?RUT_EMI=&FOLIO=&RZN_SOC=&FEC_DESDE=&FEC_HASTA=&TPO_DOC=&ESTADO=&ORDEN=&NUM_PAG=1](https://desktop.postman.com/?desktopVersion=10.13.0&userId=5911929&teamId=649152)"
      operationId: descargarPdfDeUnDteRecibido
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: '1111111-1'
            examples:
              Descargar PDF de un DTE Recibido:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: '1111111-1'
      responses:
        '200':
          description: ''
    parameters:
      - name: receptor
        in: path
        required: true
        schema:
          type: string
          example: '1111111-1'
        description: RUT del receptor del DTE
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 96800570-7
        description: Emisor del DTE
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '33'
        description: Código del DTE
      - name: folio
        in: path
        required: true
        schema:
          type: string
          example: '20043280'
        description: Folio del DTE
  /api/v1/sii/mipyme/recibidos/xml/{receptor}/{emisor}/{dte}/{folio}:
    post:
      tags:
        - API Software MIPYME SII - Documentos Recibidos
      summary: Descargar XML de un DTE Recibido
      description: "**Permiso requerido**: `query mipyme`\n\n**Pasarela a:**\_[https://www1.sii.cl/cgi-bin/Portal001/mipeAdminDocsRcp.cgi?RUT_EMI=&FOLIO=&RZN_SOC=&FEC_DESDE=&FEC_HASTA=&TPO_DOC=&ESTADO=&ORDEN=&NUM_PAG=1](https://desktop.postman.com/?desktopVersion=10.13.0&userId=5911929&teamId=649152)"
      operationId: descargarXmlDeUnDteRecibido
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    pass:
                      type: object
                      properties:
                        clave:
                          type: string
                          example: ''
                        rut:
                          type: string
                          example: '1111111-1'
            examples:
              Descargar XML de un DTE Recibido:
                value:
                  auth:
                    pass:
                      clave: ''
                      rut: '1111111-1'
      responses:
        '200':
          description: ''
    parameters:
      - name: receptor
        in: path
        required: true
        schema:
          type: string
          example: '1111111-1'
        description: RUT del receptor del DTE
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 96800570-7
        description: Emisor del DTE
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '33'
        description: Código del DTE
      - name: folio
        in: path
        required: true
        schema:
          type: string
          example: '20043280'
        description: Folio del DTE
  /api/v1/sii/dte/certificacion/contribuyentes/datos/{contribuyente}:
    post:
      tags:
        - API Certificación DTE - Contribuyentes
      summary: Datos del contribuyente
      description: >-
        **Permiso requerido**: `query dte_cert`


        **Pasarela a:**
        [https://maullin.sii.cl/cvc_cgi/dte/pe_construccion_dte](https://maullin.sii.cl/cvc_cgi/dte/pe_construccion_dte)


        Permite obtener los datos del contribuyente registrado en SII para la
        confección de los documentos PDF según el formato entregado por el SII.
      operationId: datosDelContribuyente1
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
                datos:
                  type: object
                  properties:
                    administrador:
                      type: string
                      example: 66666666-6
                    documentos:
                      type: array
                      items:
                        type: number
                        example: 33
                      example:
                        - 33
                    emails:
                      type: object
                      properties:
                        administrador:
                          type: string
                          example: esteban@example.com
                        intercambio:
                          type: string
                          example: dte@example.com
                        sii:
                          type: string
                          example: sii@example.com
                    software:
                      type: object
                      properties:
                        nombre:
                          type: string
                          example: LibreDTE
                        url:
                          type: string
                          example: libredte.cl
            examples:
              Datos del contribuyente:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
                  datos:
                    administrador: 66666666-6
                    documentos:
                      - 33
                    emails:
                      administrador: esteban@example.com
                      intercambio: dte@example.com
                      sii: sii@example.com
                    software:
                      nombre: LibreDTE
                      url: libredte.cl
      responses:
        '200':
          description: Datos del contribuyente
          content:
            application/json:
              schema:
                type: object
                properties:
                  actividades:
                    type: array
                    items:
                      type: object
                      properties:
                        afecta:
                          type: boolean
                          example: true
                        codigo:
                          type: string
                          example: '619090'
                        glosa:
                          type: string
                          example: OTRAS ACTIVIDADES DE TELECOMUNICACIONES N.C.P.
                    example:
                      - afecta: true
                        codigo: '619090'
                        glosa: OTRAS ACTIVIDADES DE TELECOMUNICACIONES N.C.P.
                      - afecta: true
                        codigo: '620200'
                        glosa: >-
                          ACTIVIDADES DE CONSULTORIA DE INFORMATICA Y DE GESTION
                          DE INSTALACIONE
                  casa_matriz:
                    type: object
                    properties:
                      ciudad:
                        type: string
                        example: SANTA CRUZ
                      comuna:
                        type: string
                        example: SANTA CRUZ
                      direccion:
                        type: string
                        example: Daniel Barros Grez 191
                  dv:
                    type: string
                    example: '9'
                  giro:
                    type: string
                    example: SERVICIOS ASESORIAS Y SOLUCIONES COMPUTACIONALES
                  razon_social:
                    type: string
                    example: SASCO SPA
                  rut:
                    type: number
                    example: 76192083
                  unidad_sii:
                    type: string
                    example: SANTA CRUZ
              examples:
                Datos del contribuyente:
                  value:
                    actividades:
                      - afecta: true
                        codigo: '619090'
                        glosa: OTRAS ACTIVIDADES DE TELECOMUNICACIONES N.C.P.
                      - afecta: true
                        codigo: '620200'
                        glosa: >-
                          ACTIVIDADES DE CONSULTORIA DE INFORMATICA Y DE GESTION
                          DE INSTALACIONE
                    casa_matriz:
                      ciudad: SANTA CRUZ
                      comuna: SANTA CRUZ
                      direccion: Daniel Barros Grez 191
                    dv: '9'
                    giro: SERVICIOS ASESORIAS Y SOLUCIONES COMPUTACIONALES
                    razon_social: SASCO SPA
                    rut: 76192083
                    unidad_sii: SANTA CRUZ
    parameters:
      - name: contribuyente
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del contribuyente que postula a facturación electrónica
  /api/v1/sii/dte/certificacion/facturas/postular/{contribuyente}:
    post:
      tags:
        - API Certificación DTE - Certificación de Facturas y otros documentos
      summary: Postulación a Software de Mercado
      description: >-
        **Permiso requerido**: `query dte_cert`


        **Pasarela a:**
        [https://maullin.sii.cl/cvc_cgi/dte/pe_ingrut](https://maullin.sii.cl/cvc_cgi/dte/pe_ingrut)
      operationId: postulaciNASoftwareDeMercado
      parameters:
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: '`json` `html`'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
                datos:
                  type: object
                  properties:
                    administrador:
                      type: string
                      example: 66666666-6
                    documentos:
                      type: array
                      items:
                        type: number
                        example: 33
                      example:
                        - 33
                    emails:
                      type: object
                      properties:
                        administrador:
                          type: string
                          example: esteban@example.com
                        intercambio:
                          type: string
                          example: dte@example.com
                        sii:
                          type: string
                          example: sii@example.com
                    software:
                      type: object
                      properties:
                        nombre:
                          type: string
                          example: LibreDTE
                        url:
                          type: string
                          example: libredte.cl
            examples:
              Postulación a Software de Mercado:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
                  datos:
                    administrador: 66666666-6
                    documentos:
                      - 33
                    emails:
                      administrador: esteban@example.com
                      intercambio: dte@example.com
                      sii: sii@example.com
                    software:
                      nombre: LibreDTE
                      url: libredte.cl
      responses:
        '200':
          description: ''
    parameters:
      - name: contribuyente
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del contribuyente que postula a facturación electrónica
  /api/v1/sii/dte/certificacion/facturas/solicitar_set/{contribuyente}:
    post:
      tags:
        - API Certificación DTE - Certificación de Facturas y otros documentos
      summary: Solicitar Set de Pruebas
      description: >-
        **Permiso requerido**: `query dte_cert`


        **Pasarela a:**
        [https://maullin.sii.cl/cvc_cgi/dte/pe_generar](https://maullin.sii.cl/cvc_cgi/dte/pe_generar)
      operationId: solicitarSetDePruebas
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
                sets:
                  type: array
                  items:
                    type: number
                    example: 33
                  example:
                    - 33
            examples:
              Solicitar Set de Pruebas:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
                  sets:
                    - 33
      responses:
        '200':
          description: ''
    parameters:
      - name: contribuyente
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del contribuyente al que se solicitan los sets de prueba
  /api/v1/sii/dte/certificacion/boletas/solicitar_set/{contribuyente}:
    post:
      tags:
        - API Certificación DTE - Certificación de Boletas
      summary: Solicitar Set de Pruebas de Boletas
      description: >-
        **Permiso requerido**: `query dte_cert`


        **Pasarela a:**
        [https://www4.sii.cl/certBolElectDteInternet/?SET=1](https://www4.sii.cl/certBolElectDteInternet/?SET=1)
      operationId: solicitarSetDePruebasDeBoletas
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
                datos:
                  type: object
                  properties:
                    email:
                      type: string
                      example: libredte@sasco.cl
            examples:
              Solicitar Set de Pruebas de Boletas:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
                  datos:
                    email: libredte@sasco.cl
      responses:
        '200':
          description: ''
    parameters:
      - name: contribuyente
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: RUT del contribuyente al que se solicita el SET de prueba
  /api/v1/libredte/dte/documentos/generar:
    post:
      tags:
        - API Facturación - Documentos Tributarios
      summary: Generar XML de un DTE
      description: >-
        **Permiso requerido**: `query libredte`


      operationId: generarXmlDeUnDte
      parameters:
        - name: normalizar
          in: query
          schema:
            type: string
            example: '1'
          description: >-
            `1` Se usa normalización: se calcularán ciertos valores<br/>

            `0` No se usa normalización: se deben enviar todos los valores según
            esquema XML
        - name: formato
          in: query
          schema:
            type: string
            example: json
          description: |
            Formato de los datos que se están enviando para crear el DTE:<br/>
            `json` formato por defecto en JSON<br/>
            `xml` igual que `json` pero en formato XML<br/>
            `yaml` igual que `json` pero en formato YAML<br/>
            `JSONString` String JSON que contiene el JSON completo<br/>
            `Acepta.Normal` todos los DTE menos boletas ni exportación<br/>
            `Acepta.Boleta` para generar boletas<br/>
            `FacturacionCL.XML`
        - name: enviar_sii
          in: query
          schema:
            type: string
            example: '0'
          description: >-
            `0` No se envía el XML generado al SII<br/>`1` Se envía el XML
            generado al SII
        - name: gzip
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` enviar sin comprimir<br/>`1` enviar comprimido'
        - name: retry
          in: query
          schema:
            type: string
            example: '1'
          description: Cantidad de intentos de envío que se deben realizar
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
                caf:
                  type: string
                  example: ''
                dte:
                  type: object
                  properties:
                    Detalle:
                      type: object
                      properties:
                        NmbItem:
                          type: string
                          example: Venta
                        PrcItem:
                          type: number
                          example: 10000
                        QtyItem:
                          type: number
                          example: 1
                    Encabezado:
                      type: object
                      properties:
                        Emisor:
                          type: object
                          properties:
                            Acteco:
                              type: string
                              example: '620200'
                            CmnaOrigen:
                              type: string
                              example: Santa Cruz
                            DirOrigen:
                              type: string
                              example: Santa Cruz
                            GiroEmis:
                              type: string
                              example: Servicios integrales de informática
                            RUTEmisor:
                              type: string
                              example: 76192083-9
                            RznSoc:
                              type: string
                              example: SASCO SpA
                        IdDoc:
                          type: object
                          properties:
                            Folio:
                              type: number
                              example: 782
                            TipoDTE:
                              type: number
                              example: 33
                        Receptor:
                          type: object
                          properties:
                            CmnaRecep:
                              type: string
                              example: Santiago
                            DirRecep:
                              type: string
                              example: Santiago
                            GiroRecep:
                              type: string
                              example: Gobierno
                            RUTRecep:
                              type: string
                              example: 60803000-K
                            RznSocRecep:
                              type: string
                              example: Servicio de Impuestos Internos
                resolucion:
                  type: object
                  properties:
                    fecha:
                      type: string
                      example: '2019-12-23'
                    numero:
                      type: number
                      example: 0
            examples:
              Generar XML de un DTE:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
                  caf: ''
                  dte:
                    Detalle:
                      NmbItem: Venta
                      PrcItem: 10000
                      QtyItem: 1
                    Encabezado:
                      Emisor:
                        Acteco: '620200'
                        CmnaOrigen: Santa Cruz
                        DirOrigen: Santa Cruz
                        GiroEmis: Servicios integrales de informática
                        RUTEmisor: 76192083-9
                        RznSoc: SASCO SpA
                      IdDoc:
                        Folio: 782
                        TipoDTE: 33
                      Receptor:
                        CmnaRecep: Santiago
                        DirRecep: Santiago
                        GiroRecep: Gobierno
                        RUTRecep: 60803000-K
                        RznSocRecep: Servicio de Impuestos Internos
                  resolucion:
                    fecha: '2019-12-23'
                    numero: 0
      responses:
        '200':
          description: Generar el XML de un DTE
          content:
            application/json:
              schema:
                type: object
                properties:
                  certificacion:
                    type: number
                    example: 1
                  track_id:
                    type: number
                    example: 82503930
                  xml:
                    type: object
                    properties:
                      dte:
                        type: string
                        example: ''
                      receptor:
                        type: string
                        example: ''
                      sii:
                        type: string
                        example: ''
              examples:
                Generar el XML de un DTE:
                  value:
                    certificacion: 1
                    track_id: 82503930
                    xml:
                      dte: ''
                      receptor: ''
                      sii: ''
  /api/v1/libredte/dte/documentos/pdf:
    post:
      tags:
        - API Facturación - Documentos Tributarios
      summary: Generar PDF a partir del XML del DTE
      description: >-
        **Permiso requerido**: `query libredte`


        Recurso que permite obtener el PDF de un documento tributario
        electrónico que le ha sido enviado como XML.
      operationId: generarPdfAPartirDelXmlDelDte
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                cedible:
                  type: boolean
                  example: true
                copias_cedibles:
                  type: number
                  example: 1
                copias_tributarias:
                  type: number
                  example: 1
                extra:
                  type: object
                  properties:
                    codigo_barras:
                      type: object
                      properties:
                        cotizacion:
                          type: boolean
                          example: true
                        dte:
                          type: boolean
                          example: true
                        incluirrut:
                          type: boolean
                          example: false
                    color:
                      type: object
                      properties:
                        razonsocial:
                          type: array
                          items:
                            type: number
                            example: 14
                          example:
                            - 14
                            - 66
                            - 170
                    detalle:
                      type: object
                      properties:
                        ancho:
                          type: object
                          properties:
                            CdgItem:
                              type: number
                              example: 30
                            DescuentoMonto:
                              type: number
                              example: 22
                            MontoItem:
                              type: number
                              example: 22
                            PrcItem:
                              type: number
                              example: 22
                            QtyItem:
                              type: number
                              example: 15
                            RecargoMonto:
                              type: number
                              example: 22
                        fuente:
                          type: number
                          example: 9
                        posicion:
                          type: number
                          example: 0
                    emisor:
                      type: object
                      properties:
                        direccion:
                          type: boolean
                          example: false
                        email:
                          type: boolean
                          example: false
                        giro:
                          type: boolean
                          example: false
                        razonsocial:
                          type: boolean
                          example: false
                        telefono:
                          type: boolean
                          example: false
                        web:
                          type: boolean
                          example: false
                    historial:
                      type: object
                      properties:
                        datos:
                          type: object
                          properties:
                            Abril:
                              type: number
                              example: 12
                            Febrero:
                              type: number
                              example: 12
                            Julio:
                              type: number
                              example: 5
                            Junio:
                              type: number
                              example: 4
                            Marzo:
                              type: number
                              example: 11
                            Mayo:
                              type: number
                              example: 10.5
                        titulo:
                          type: string
                          example: Consumo de Agua Potable
                    img:
                      type: object
                      properties:
                        cotizacion:
                          type: string
                          example: ''
                        historial:
                          type: string
                          example: ''
                        logo:
                          type: string
                          example: ''
                        pie:
                          type: string
                          example: ''
                footer:
                  type: object
                  properties:
                    left:
                      type: string
                      example: Boletas y Facturas con LibreDTE
                    right:
                      type: string
                      example: www.libredte.cl
                formato:
                  type: string
                  example: general
                webVerificacion:
                  type: boolean
                  example: false
                xml:
                  type: string
                  example: ''
            examples:
              Generar PDF a partir del XML del DTE:
                value:
                  cedible: true
                  copias_cedibles: 1
                  copias_tributarias: 1
                  extra:
                    codigo_barras:
                      cotizacion: true
                      dte: true
                      incluirrut: false
                    color:
                      razonsocial:
                        - 14
                        - 66
                        - 170
                    detalle:
                      ancho:
                        CdgItem: 30
                        DescuentoMonto: 22
                        MontoItem: 22
                        PrcItem: 22
                        QtyItem: 15
                        RecargoMonto: 22
                      fuente: 9
                      posicion: 0
                    emisor:
                      direccion: false
                      email: false
                      giro: false
                      razonsocial: false
                      telefono: false
                      web: false
                    historial:
                      datos:
                        Abril: 12
                        Febrero: 12
                        Julio: 5
                        Junio: 4
                        Marzo: 11
                        Mayo: 10.5
                      titulo: Consumo de Agua Potable
                    img:
                      cotizacion: ''
                      historial: ''
                      logo: ''
                      pie: ''
                  footer:
                    left: Boletas y Facturas con LibreDTE
                    right: www.libredte.cl
                  formato: general
                  webVerificacion: false
                  xml: ''
      responses:
        '200':
          description: ''
  /api/v1/libredte/dte/documentos/escpos:
    post:
      tags:
        - API Facturación - Documentos Tributarios
      summary: Generar ESCPOS a partir del XML del DTE
      description: >-
        **Permiso requerido**: `query libredte`


        Recurso que permite obtener el código ESCPOS de un Documento Tributario
        Electrónico (DTE) a partir de su XML.


        El código ESCPOS puede ser enviado directamente a una impresora térmica
        (papel contínuo).


        Tiene como principal ventaja una mejor calidad de impresión versus
        imprimir en la impresora térmica el PDF del DTE.


        El código binario ESCPOS generado ha sido probado correctamente con una
        impresora Epson TM-T20II Ethernet con el profile `default`.
      operationId: generarEscposAPartirDelXmlDelDte
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                caratula:
                  type: boolean
                  example: false
                cedible:
                  type: number
                  example: 0
                copias_cedibles:
                  type: number
                  example: 1
                copias_tributarias:
                  type: number
                  example: 1
                cut:
                  type: boolean
                  example: true
                footer:
                  type: boolean
                  example: true
                logo:
                  type: boolean
                  example: false
                papelContinuo:
                  type: number
                  example: 80
                pdf417:
                  type: string
                  example: pdf417
                profile:
                  type: string
                  example: default
                specialchars:
                  type: boolean
                  example: true
                webVerificacion:
                  type: boolean
                  example: false
                xml:
                  type: string
                  example: WE1MIGVuIEJhc2U2NAo=
            examples:
              Generar ESCPOS a partir del XML del DTE:
                value:
                  caratula: false
                  cedible: 0
                  copias_cedibles: 1
                  copias_tributarias: 1
                  cut: true
                  footer: true
                  logo: false
                  papelContinuo: 80
                  pdf417: pdf417
                  profile: default
                  specialchars: true
                  webVerificacion: false
                  xml: WE1MIGVuIEJhc2U2NAo=
      responses:
        '200':
          description: ''
  /api/v1/libredte/dte/formatos/json:
    post:
      tags:
        - API Facturación - Documentos Tributarios
      summary: Normalizar DTE al formato estándar del SII
      description: >-
        **Permiso requerido**: `query libredte`


        El campo `dte` del JSON debe ser un string codificado en base64 con los
        datos del formato desde el que se desea convertir.


        Para ver los formatos soportados revisar el recurso "Generar el XML de
        un DTE".
      operationId: normalizarDteAlFormatoEstNdarDelSii
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                dte:
                  type: string
                  example: ''
                formato:
                  type: string
                  example: Acepta.Boleta
            examples:
              Normalizar DTE al formato estándar del SII:
                value:
                  dte: ''
                  formato: Acepta.Boleta
      responses:
        '200':
          description: ''
  /api/v1/libredte/dte/rcof/generar:
    post:
      tags:
        - API Facturación - Documentos Tributarios
      summary: Generar XML de RVD de Boletas (ex RCOF)
      description: >-
        **Permiso requerido**: `query libredte`


        El Reporte de Ventas Diarias (RDV) o ex RCOF (Reporte de Consumo de
        Folios) es un archivo XML que se debe enviar de lunes a domingo al SII.
        Todos los días, existan o no movimientos.


        Cada envío que se hace del RCOF, reemplazará al anterior. Siempre y
        cuando tenga una secuencia siguiente a la última enviada. Dicho de otra
        forma, el SII sólo considerará el último XML enviado.


        El ambiente al que se envía el XML al SII estará determinado por número
        de resolución indicada en los datos de la solicitud.


        Para forzar la generación del RCOF, aunque no existan documentos,
        siempre considerar el envío de la llave `dtes` en los datos:

            {
                "fecha": "2021-09-25",
                "dtes": [39]
            }

        El ejemplo anterior (que sólo tiene los campos nuevos), siempre generará
        un XML con boletas afectas. Y de no existir documentos, el resumen
        estará en 0.
      operationId: generarXmlDeRvdDeBoletasExRcof
      parameters:
        - name: enviar_sii
          in: query
          schema:
            type: string
            example: '0'
          description: >-
            `0` No se envía el XML generado al SII<br/>`1` Se envía el XML
            generado al SII
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
                documentos:
                  type: array
                  items:
                    type: object
                    properties:
                      FchDoc:
                        type: string
                        example: '2020-07-05'
                      MntExe:
                        type: number
                        example: 0
                      MntIVA:
                        type: number
                        example: 19
                      MntNeto:
                        type: number
                        example: 100
                      MntTotal:
                        type: number
                        example: 119
                      NroDoc:
                        type: number
                        example: 1
                      TasaImp:
                        type: number
                        example: 19
                      TpoDoc:
                        type: number
                        example: 39
                  example:
                    - FchDoc: '2020-07-05'
                      MntExe: 0
                      MntIVA: 19
                      MntNeto: 100
                      MntTotal: 119
                      NroDoc: 1
                      TasaImp: 19
                      TpoDoc: 39
                    - FchDoc: '2020-07-05'
                      MntExe: 50
                      MntIVA: 190
                      MntNeto: 1000
                      MntTotal: 1190
                      NroDoc: 2
                      TasaImp: 19
                      TpoDoc: 39
                    - FchDoc: '2020-07-05'
                      MntExe: 100
                      MntIVA: 0
                      MntNeto: 0
                      MntTotal: 100
                      NroDoc: 2
                      TasaImp: 0
                      TpoDoc: 41
                emisor:
                  type: string
                  example: '76192083-9'
                resolucion:
                  type: object
                  properties:
                    fecha:
                      type: string
                      example: '2019-12-23'
                    numero:
                      type: number
                      example: 0
                secuencia:
                  type: number
                  example: 1
            examples:
              Generar XML de RVD de Boletas (ex RCOF):
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
                  documentos:
                    - FchDoc: '2020-07-05'
                      MntExe: 0
                      MntIVA: 19
                      MntNeto: 100
                      MntTotal: 119
                      NroDoc: 1
                      TasaImp: 19
                      TpoDoc: 39
                    - FchDoc: '2020-07-05'
                      MntExe: 50
                      MntIVA: 190
                      MntNeto: 1000
                      MntTotal: 1190
                      NroDoc: 2
                      TasaImp: 19
                      TpoDoc: 39
                    - FchDoc: '2020-07-05'
                      MntExe: 100
                      MntIVA: 0
                      MntNeto: 0
                      MntTotal: 100
                      NroDoc: 2
                      TasaImp: 0
                      TpoDoc: 41
                  emisor: '76192083-9'
                  resolucion:
                    fecha: '2019-12-23'
                    numero: 0
                  secuencia: 1
      responses:
        '200':
          description: Generar RCOF sin movimiento / Generar RCOF
          content:
            application/json:
              schema:
                type: object
                properties:
                  certificacion:
                    type: number
                    example: 1
                  track_id:
                    type: number
                    nullable: true
                    example: null
                  xml:
                    type: string
                    example: WE1MIGVuIEJhc2U2NAo=
              examples:
                Generar RCOF:
                  value:
                    certificacion: 1
                    track_id: 82508020
                    xml: WE1MIGVuIEJhc2U2NAo=
                Generar RCOF sin movimiento:
                  value:
                    certificacion: 1
                    track_id: null
                    xml: WE1MIGVuIEJhc2U2NAo=
  /api/v1/libredte/dte/cesion/ceder:
    post:
      tags:
        - API Facturación - Documentos Tributarios
      summary: Generar XML de Cesión de DTE (AEC)
      description: >-
        **Permiso requerido**: `query libredte`


        Se debe enviar el XML de EnvioDTE codificado en base64 y la respuesta lo
        entregará de igual forma.


        **Envío al SII**


        Si se solicita enviar al SII el XML de la cesión con el parámetro
        `enviar_sii=1` la respuesta contendrá el identificador de envío al SII
        que luego debe ser usado para validar el envío de la cesión al SII, esto
        en el campo `track_id`. Dicho campo es un valor numérico, si el
        resultado es `track_id = false` signficará que el XML no pudo ser
        enviado al SII. Cuando no se pueda enviar el XML de la cesión al SII, se
        incluirá un campo en el JSON de respuesta llamado `logs` que podría
        contener el motivo por el cual no se logró enviar el XML al SII.


        El ambiente al que se envía el XML al SII estará determinado por el
        ambiente del DTE que se está cediendo.


        **Declaración jurada**


        El campo `cedente.declaracion_jurada` es opcional, si no se especifica
        se usará una declaración jurada por defecto con el formato:


        ```

        Yo, {usuario_nombre}, RUN {usuario_run}, representando a
        {cedente_razon_social}, RUT {cedente_rut}, declaro que he puesto a
        disposición del cesionario {cesionario_razon_social}, RUT
        {cesionario_rut}, el documento donde constan los recibos de la recepción
        de mercaderías entregadas o servicios prestados, entregados por parte
        del deudor de la factura {deudor_razon_social}, RUT {deudor_rut}, de
        acuerdo a lo establecido en la Ley N° 19.983

         ```

        **Datos cedente**


        Es posible indicar los siguientes campos en el índice `cedente` del
        cuerpo de la solicitud que se asignarán a los índices que se indica en
        el XML de la cesión en Cesion.DocumentoCesion.Cedente:


        - `rut`: se asignará al campo `RUT` del `Cedente` (opcional). Por
        defecto se asignará el RUT del emisor del DTE cedido (`RUTEmisor`).

        - `razon_social`: se asignará al campo `RazonSocial` del `Cedente`
        (opcional). Por defecto se asignará la razón social del emisor del DTE
        cedido (`RznSoc`).

        - `direccion`: se asignará al campo `Direccion` del `Cedente`
        (opcional). Por defecto se asignará la dirección de origen unida a la
        comuna de origen del emisor del DTE cedido (`DirOrigen` y `CmnaOrigen`).

        - `email`: se asignará al campo `eMail` del `Cedente` (obligatorio).


        La `declaracion_jurada` se obtiene según lo indicado previamente para
        dicho campo. Respecto al campo `RUTAutorizado` se se obtiene tanto el
        `RUT` como el `Nombre` de la firma electrónica enviada al consumir el
        servicio web.


        **Datos cesionario**


        Es posible indicar los siguientes campos en el índice `cesionario` del
        cuerpo de la solicitud que se asignarán a los índices que se indican en
        el XML de la cesión en `Cesion.DocumentoCesion.Cesionario`:


        - `rut`: se asignará al campo `RUT` del `Cesionario` (obligatorio).

        - `razon_social`: se asignará al campo `RazonSocial` del `Cesionario`
        (obligatorio).

        - `direccion`: se asignará al campo `Direccion` del `Cesionario`
        (obligatorio).

        - `email`: se asignará al campo `eMail` del `Cesionario` (obligatorio).


        **Cesión de un documento previmante cedido**


        El servicio web no tiene probada la funcionalidad que permite ceder un
        documento previamente cedido (receder), por lo que no se debe considerar
        como una característica de la API esta opción.


        Si la desea probar, considere que es una función experimental y no se
        garantiza el funcionamiento.


        Para probar esta opción deberá indicar los datos completos del cedente.
      operationId: generarXmlDeCesiNDeDteAec
      parameters:
        - name: enviar_sii
          in: query
          schema:
            type: string
            example: '0'
          description: >-
            `0` No se envía el XML generado al SII<br/>`1` Se envía el XML
            generado al SII
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                cedente:
                  type: object
                  properties:
                    email:
                      type: string
                      example: ''
                cert:
                  type: object
                  properties:
                    cert-data:
                      type: string
                      example: ''
                    pkey-data:
                      type: string
                      example: ''
                cesionario:
                  type: object
                  properties:
                    direccion:
                      type: string
                      example: ''
                    email:
                      type: string
                      example: ''
                    razon_social:
                      type: string
                      example: ''
                    rut:
                      type: string
                      example: '1111111-1'
                xml:
                  type: string
                  example: ''
            examples:
              Generar XML de Cesión de DTE (AEC):
                value:
                  cedente:
                    email: ''
                  cert:
                    cert-data: ''
                    pkey-data: ''
                  cesionario:
                    direccion: ''
                    email: ''
                    razon_social: ''
                    rut: '1111111-1'
                  xml: ''
      responses:
        '200':
          description: Ceder un DTE
          content:
            application/json:
              schema:
                type: object
                properties:
                  certificacion:
                    type: number
                    example: 1
                  track_id:
                    type: number
                    example: 82483478
                  xml:
                    type: string
                    example: PEFFQz4uLi48L0FFQz4K
              examples:
                Ceder un DTE:
                  value:
                    certificacion: 1
                    track_id: 82483478
                    xml: PEFFQz4uLi48L0FFQz4K
  /api/v1/libredte/dte/envios/enviar:
    post:
      tags:
        - API Facturación - Envíos al SII
      summary: Enviar XML al SII
      description: >-
        **Permiso requerido**: `query libredte`


        Recurso que permite realizar el envío de un XML AL SII.
      operationId: enviarXmlAlSii
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
        - name: gzip
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` enviar sin comprimir<br/>`1` enviar comprimido'
        - name: retry
          in: query
          schema:
            type: string
            example: '1'
          description: Cantidad de intentos de envío que se deben realizar
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
                emisor:
                  type: string
                  example: '76192083-9'
                xml:
                  type: string
                  example: >-
                    PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iSVNPLTg4NTktMSI/Pgo8RW52aW9CT0xFVEEgeG1sbnM9Imh0dHA6Ly93d3cuc2lpLmNsL1NpaUR0ZSIgeG1sbnM6eHNpPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYS1pbnN0YW5jZSIgeHNpOnNjaGVtYUxvY2F0aW9uPSJodHRwOi8vd3d3LnNpaS5jbC9TaWlEdGUgRW52aW9CT0xFVEFfdjExLnhzZCIgdmVyc2lvbj0iMS4wIj4KICA8U2V0RFRFIElEPSJMaWJyZURURV9TZXREb2MiPgogICAgPENhcmF0dWxhIHZlcnNpb249IjEuMCI+CiAgICAgIDxSdXRFbWlzb3I+NzYxOTIwODMtOTwvUnV0RW1pc29yPgogICAgICA8UnV0RW52aWE+MTYyNjEwNjMtNTwvUnV0RW52aWE+CiAgICAgIDxSdXRSZWNlcHRvcj4xNjI2MTA2My01PC9SdXRSZWNlcHRvcj4KICAgICAgPEZjaFJlc29sPjIwMTktMTItMjM8L0ZjaFJlc29sPgogICAgICA8TnJvUmVzb2w+MDwvTnJvUmVzb2w+CiAgICAgIDxUbXN0RmlybWFFbnY+MjAyMC0wNy0xN1QxMDowODo0OTwvVG1zdEZpcm1hRW52PgogICAgICA8U3ViVG90RFRFPgogICAgICAgIDxUcG9EVEU+Mzk8L1Rwb0RURT4KICAgICAgICA8TnJvRFRFPjE8L05yb0RURT4KICAgICAgPC9TdWJUb3REVEU+CiAgICA8L0NhcmF0dWxhPgogICAgPERURSB2ZXJzaW9uPSIxLjAiPgogIDxEb2N1bWVudG8gSUQ9IkxpYnJlRFRFX1QzOUY1NzciPgogICAgPEVuY2FiZXphZG8+CiAgICAgIDxJZERvYz4KICAgICAgICA8VGlwb0RURT4zOTwvVGlwb0RURT4KICAgICAgICA8Rm9saW8+NTc3PC9Gb2xpbz4KICAgICAgICA8RmNoRW1pcz4yMDIwLTA3LTE3PC9GY2hFbWlzPgogICAgICAgIDxJbmRTZXJ2aWNpbz4zPC9JbmRTZXJ2aWNpbz4KICAgICAgPC9JZERvYz4KICAgICAgPEVtaXNvcj4KICAgICAgICA8UlVURW1pc29yPjc2MTkyMDgzLTk8L1JVVEVtaXNvcj4KICAgICAgICA8UnpuU29jRW1pc29yPlNBU0NPIFNwQTwvUnpuU29jRW1pc29yPgogICAgICAgIDxHaXJvRW1pc29yPlNlcnZpY2lvcyBpbnRlZ3JhbGVzIGRlIGluZm9ybeF0aWNhPC9HaXJvRW1pc29yPgogICAgICAgIDxEaXJPcmlnZW4+RGFuaWVsIEJhcnJvcyBHcmV6IDE5MTwvRGlyT3JpZ2VuPgogICAgICAgIDxDbW5hT3JpZ2VuPlNhbnRhIENydXo8L0NtbmFPcmlnZW4+CiAgICAgIDwvRW1pc29yPgogICAgICA8UmVjZXB0b3I+CiAgICAgICAgPFJVVFJlY2VwPjE2MjYxMDYzLTU8L1JVVFJlY2VwPgogICAgICAgIDxSem5Tb2NSZWNlcD5Fc3RlYmFuIEVJUkw8L1J6blNvY1JlY2VwPgogICAgICAgIDxDb250YWN0bz4rNTYgOSA3NDIxOTUzMjwvQ29udGFjdG8+CiAgICAgICAgPERpclJlY2VwPlNhbnRpYWdvPC9EaXJSZWNlcD4KICAgICAgICA8Q21uYVJlY2VwPlNhbnRpYWdvPC9DbW5hUmVjZXA+CiAgICAgIDwvUmVjZXB0b3I+CiAgICAgIDxUb3RhbGVzPgogICAgICAgIDxNbnRUb3RhbD4yMDA8L01udFRvdGFsPgogICAgICA8L1RvdGFsZXM+CiAgICA8L0VuY2FiZXphZG8+CiAgICA8RGV0YWxsZT4KICAgICAgPE5yb0xpbkRldD4xPC9Ocm9MaW5EZXQ+CiAgICAgIDxObWJJdGVtPnAxPC9ObWJJdGVtPgogICAgICA8UXR5SXRlbT4xPC9RdHlJdGVtPgogICAgICA8UHJjSXRlbT4xOTkuOTI8L1ByY0l0ZW0+CiAgICAgIDxNb250b0l0ZW0+MjAwPC9Nb250b0l0ZW0+CiAgICA8L0RldGFsbGU+CiAgICA8UmVmZXJlbmNpYT4KICAgICAgPE5yb0xpblJlZj4xPC9Ocm9MaW5SZWY+CiAgICAgIDxSYXpvblJlZj5FbWFpbCByZWNlcHRvcjogZXN0ZWJhbkBkZWxhZi5jbDwvUmF6b25SZWY+CiAgICA8L1JlZmVyZW5jaWE+CiAgICA8VEVEIHZlcnNpb249IjEuMCI+CiAgPEREPgogICAgPFJFPjc2MTkyMDgzLTk8L1JFPgogICAgPFREPjM5PC9URD4KICAgIDxGPjU3NzwvRj4KICAgIDxGRT4yMDIwLTA3LTE3PC9GRT4KICAgIDxSUj4xNjI2MTA2My01PC9SUj4KICAgIDxSU1I+RXN0ZWJhbiBFSVJMPC9SU1I+CiAgICA8TU5UPjIwMDwvTU5UPgogICAgPElUMT5wMTwvSVQxPgogICAgPENBRiB2ZXJzaW9uPSIxLjAiPgo8REE+CjxSRT43NjE5MjA4My05PC9SRT4KPFJTPlNBU0NPIFNQQTwvUlM+CjxURD4zOTwvVEQ+CjxSTkc+PEQ+MTE8L0Q+PEg+MTAxMDwvSD48L1JORz4KPEZBPjIwMTYtMDItMTM8L0ZBPgo8UlNBUEs+PE0+MnZXTmg0dGlldldYVjF4UnRYMjlRYjB2NU9QYzV0eEFtdWk0SHFUNHlNOFZNMkwxNHAxeWNoa09aYXh3L3I1WkIxWVNYdmNFRnUrY2J3VHVHL0QxeFE9PTwvTT48RT5Bdz09PC9FPjwvUlNBUEs+CjxJREs+MTAwPC9JREs+CjwvREE+CjxGUk1BIGFsZ29yaXRtbz0iU0hBMXdpdGhSU0EiPldJVDRTTklaUTlGNmNPVHJ1WnVJVzhYYTdNN3BOZmVOTnhIQXpaMzg2c09CVE05T0YwcHFuVkM5anllU1ZkQmxwM1pMYmN5VWZrcGdyc0gzVVNmT1BBPT08L0ZSTUE+CjwvQ0FGPgogICAgPFRTVEVEPjIwMjAtMDctMTdUMTA6MDg6NDk8L1RTVEVEPgogIDwvREQ+CiAgPEZSTVQgYWxnb3JpdG1vPSJTSEExd2l0aFJTQSI+ZjVVQnpPb21MNDNNcUZoMTUyRnh1YzhQa1Q0RXI1K2pNcTZjN3VTYmYzcVdYVmt2eVRPV1VvcXRIOFo4TEprcUJyL1dVeER5UmJHMjJKMkFLR2ZsNVE9PTwvRlJNVD4KPC9URUQ+CiAgPFRtc3RGaXJtYT4yMDIwLTA3LTE3VDEwOjA4OjQ5PC9UbXN0RmlybWE+PC9Eb2N1bWVudG8+CjxTaWduYXR1cmUgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDkveG1sZHNpZyMiPjxTaWduZWRJbmZvIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjIj48Q2Fub25pY2FsaXphdGlvbk1ldGhvZCBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnL1RSLzIwMDEvUkVDLXhtbC1jMTRuLTIwMDEwMzE1Ii8+PFNpZ25hdHVyZU1ldGhvZCBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDkveG1sZHNpZyNyc2Etc2hhMSIvPjxSZWZlcmVuY2UgVVJJPSIjTGlicmVEVEVfVDM5RjU3NyI+PFRyYW5zZm9ybXM+PFRyYW5zZm9ybSBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDkveG1sZHNpZyNlbnZlbG9wZWQtc2lnbmF0dXJlIi8+PC9UcmFuc2Zvcm1zPjxEaWdlc3RNZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjc2hhMSIvPjxEaWdlc3RWYWx1ZT5sMGd2UXVITklYcENCQU45bWRSYlhBaE1VczQ9PC9EaWdlc3RWYWx1ZT48L1JlZmVyZW5jZT48L1NpZ25lZEluZm8+PFNpZ25hdHVyZVZhbHVlPlZiZ1dTeUFkdHJKam1nWURDcUxVNElYSTVUV05tMkN1N0o2L3FnVThLWFFOWVNsZ3BVdjdKM0kybHpBUHpLemsKUUhLTlByTHc5SW5QSWxpSlNybTU3YjJzdXlkVndXMFZEOCs5Tkp3SkVkSFBmM1R4VXRraFNVWGF4SytCOGQ4RwpDWU1xQkx5cUVUOUxhNHFxbUVWUDVQd2VYY3FZeFF1TXczSnBMU0g4SG1UNXpLdmJ3c29HNERNSFdvUFZyeWxxCjV2Y0VaTytJOVpZb0NydzM0b1l3YnhqMHFob3VvcXNBbG9WZWdueFJQTXhzV0dJVXAwQnpya3dROERYek5YaHAKNlJKTWJzMnRpcHF3VDVhUEFQYWFVNS9jZ0ozaGlEaC8xU3JZR1RiLzY0YzZFaDI0VkNNMDZHU09MNGhBSkpYdgpraEgvVlhhM25mbTM1eFM5RURBbkVBPT08L1NpZ25hdHVyZVZhbHVlPjxLZXlJbmZvPjxLZXlWYWx1ZT48UlNBS2V5VmFsdWU+PE1vZHVsdXM+bEhJODN0YzI1YWZtdUQ1NFRLbFF2RWE4SnJseXEyeHJiU3Nld2pwTXlYa3hTWlZnazRqdys0d1N5VWtlakZoTQplbUlsUHRndlJFZHVhNHNUV3FxUldXckovWmFqbWIrcm5qdC9LSlF0Q0tSaStaelZKMXM0bVllZWhKRmxKdDlyCk0zN0JMSUk4bThMN1lqUGRuaDVIbzBJYTVtcmFZeGM2QStUQ1VEWHN4TWxaM1NYRkpoMzB1Z0hvNG1NdUZTbmkKdUdIemlYb3YwWXV3eVgzZm1LbXEzLyt4L20wVDA4MGlDc1NSUGZPTXBqajY2a1ltbndSQW5DYzdhbFYyTDQzTApTYkRDL0dqTERxZHIrSkNrdmhmbUdreEJ2ZnM4Z2JjZnROMDNmWVNuWGdSbXJCN3QvT3BHM0JrVGtJbjlBK0JnClNVcXdNQVRFNW9DazJRL3BFaEZzMXc9PTwvTW9kdWx1cz48RXhwb25lbnQ+QVFBQjwvRXhwb25lbnQ+PC9SU0FLZXlWYWx1ZT48L0tleVZhbHVlPjxYNTA5RGF0YT48WDUwOUNlcnRpZmljYXRlPk1JSUdiekNDQlZlZ0F3SUJBZ0lEQVdscE1BMEdDU3FHU0liM0RRRUJDd1VBTUlHbU1Rc3dDUVlEVlFRR0V3SkQKVERFWU1CWUdBMVVFQ2hNUFFXTmxjSFJoTG1OdmJTQlRMa0V1TVVnd1JnWURWUVFERXo5QlkyVndkR0V1WTI5dApJRUYxZEc5eWFXUmhaQ0JEWlhKMGFXWnBZMkZrYjNKaElFTnNZWE5sSURJZ1VHVnljMjl1WVNCT1lYUjFjbUZzCklDMGdSelF4SGpBY0Jna3Foa2lHOXcwQkNRRVdEMmx1Wm05QVlXTmxjSFJoTG1OdmJURVRNQkVHQTFVRUJSTUsKT1RZNU1Ua3dOVEF0T0RBZUZ3MHhOekV4TURZeE5ETTNOVEphRncweU1ERXhNRFl4TkRNM05USmFNSUdLTVFzdwpDUVlEVlFRR0V3SkRUREVZTUJZR0ExVUVEQk1QVUVWU1UwOU9RU0JPUVZSVlVrRk1NU3N3S1FZRFZRUURFeUpGClUxUkZRa0ZPSUVWRVZVRlNSRThnUkVVZ1RFRWdSbFZGVGxSRklGSlZRa2xQTVI4d0hRWUpLb1pJaHZjTkFRa0IKRmhCbGMzUmxZbUZ1UUdSbGJHRm1MbU5zTVJNd0VRWURWUVFGRXdveE5qSTJNVEEyTXkwMU1JSUJJakFOQmdrcQpoa2lHOXcwQkFRRUZBQU9DQVE4QU1JSUJDZ0tDQVFFQWxISTgzdGMyNWFmbXVENTRUS2xRdkVhOEpybHlxMnhyCmJTc2V3anBNeVhreFNaVmdrNGp3KzR3U3lVa2VqRmhNZW1JbFB0Z3ZSRWR1YTRzVFdxcVJXV3JKL1pham1iK3IKbmp0L0tKUXRDS1JpK1p6VkoxczRtWWVlaEpGbEp0OXJNMzdCTElJOG04TDdZalBkbmg1SG8wSWE1bXJhWXhjNgpBK1RDVURYc3hNbFozU1hGSmgzMHVnSG80bU11RlNuaXVHSHppWG92MFl1d3lYM2ZtS21xMy8reC9tMFQwODBpCkNzU1JQZk9NcGpqNjZrWW1ud1JBbkNjN2FsVjJMNDNMU2JEQy9HakxEcWRyK0pDa3ZoZm1Ha3hCdmZzOGdiY2YKdE4wM2ZZU25YZ1JtckI3dC9PcEczQmtUa0luOUErQmdTVXF3TUFURTVvQ2syUS9wRWhGczF3SURBUUFCbzRJQwp2akNDQXJvd0h3WURWUjBqQkJnd0ZvQVVaYVdyUGovSXRsRnRFWDVmd3dvSDVrT2dDTFl3SFFZRFZSME9CQllFCkZQeFJhYVVWYm9IRGU5MUw3cXU4RGhVc0hwN2hNQXNHQTFVZER3UUVBd0lFOERBZEJnTlZIU1VFRmpBVUJnZ3IKQmdFRkJRY0RBZ1lJS3dZQkJRVUhBd1F3RVFZSllJWklBWWI0UWdFQkJBUURBZ1dnTUlIMUJnTlZIU0FFZ2UwdwpnZW93Z2VjR0NDc0dBUVFCdFdzQ01JSGFNREVHQ0NzR0FRVUZCd0lCRmlWb2RIUndjem92TDJGalp6UXVZV05sCmNIUmhMbU52YlM5RFVGTXRRV05sY0hSaFkyOXRNSUdrQmdnckJnRUZCUWNDQWpDQmx6QVdGZzlCWTJWd2RHRXUKWTI5dElGTXVRUzR3QXdJQkNScDlSV3dnZEdsMGRXeGhjaUJvWVNCemFXUnZJSFpoYkdsa1lXUnZJR1Z1SUdadgpjbTFoSUc5dWJHbHVaU3dnY1hWbFpHRnVaRzhnYUdGaWFXeHBkR0ZrYnlCbGJDQkRaWEowYVdacFkyRmtieUJ3CllYSmhJSFZ6YnlCMGNtbGlkWFJoY21sdkxDQndZV2R2Y3l3Z1kyOXRaWEpqYVc4Z2VTQnZkSEp2Y3k0d1dnWUQKVlIwU0JGTXdVYUFZQmdnckJnRUVBY0VCQXFBTUZnbzVOamt4T1RBMU1DMDRvQ1FHQ0NzR0FRVUZCd2dEb0JndwpGZ3dLT1RZNU1Ua3dOVEF0T0FZSUt3WUJCQUhCQVFLQkQybHVabTlBWVdObGNIUmhMbU52YlRCYkJnTlZIUkVFClZEQlNvQmdHQ0NzR0FRUUJ3UUVCb0F3V0NqRTJNall4TURZekxUV2dKQVlJS3dZQkJRVUhDQU9nR0RBV0RBb3gKTmpJMk1UQTJNeTAxQmdnckJnRUVBY0VCQW9FUVpYTjBaV0poYmtCa1pXeGhaaTVqYkRCSEJnZ3JCZ0VGQlFjQgpBUVE3TURrd053WUlLd1lCQlFVSE1BR0dLMmgwZEhCek9pOHZZV05uTkM1aFkyVndkR0V1WTI5dEwyRmpaelF2CmIyTnpjQzlEYkdGelpUSXRSelF3UHdZRFZSMGZCRGd3TmpBMG9ES2dNSVl1YUhSMGNITTZMeTloWTJjMExtRmoKWlhCMFlTNWpiMjB2WVdObk5DOWpjbXd2UTJ4aGMyVXlMVWMwTG1OeWJEQU5CZ2txaGtpRzl3MEJBUXNGQUFPQwpBUUVBT3BORjMranRqOENSbEhRRkduWGhmMHNBWGduV2s1R0xGbko5VTQyUDEyTC91b1VkV0F3WEVKNGc0Zmh1CjROdGhPdTBqL2o3OXlmYzJuL1dQUHJRUEl5VjFjaSs5UG9NcXUwU1VYVnBVdC93N0JIUFY2Wm00ZXRqQjhubVUKb1RHUlZLWnUxZktCOTE5TlRGTU1ELzFaNHZ3RWdlYVhSMjIzUURsVnZTQW1wenpvcGY0bzlRelptOHBpcTZDTQpnQ3p0UjkvOC9RSjRhWWs0cmdhYi9scnB1U1RMRURjT2hkZHJKd1l0Q3dpdE1lcjZoMVE0NWswa3BWMHphd0R0ClovaHFXakluSHZZelpUY1JNNjk5SThWbFl0MVQzb1cyWWJmSXZpMHlYV3FFK3FRVG1WcHFDdG5yaTBMTElJNjUKNWZyY3BGTElPN1p4TXBobzRmalNNa3FlMEE9PTwvWDUwOUNlcnRpZmljYXRlPjwvWDUwOURhdGE+PC9LZXlJbmZvPjwvU2lnbmF0dXJlPjwvRFRFPgogIDwvU2V0RFRFPgo8U2lnbmF0dXJlIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjIj48U2lnbmVkSW5mbyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC8wOS94bWxkc2lnIyIgeG1sbnM6eHNpPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYS1pbnN0YW5jZSI+PENhbm9uaWNhbGl6YXRpb25NZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy9UUi8yMDAxL1JFQy14bWwtYzE0bi0yMDAxMDMxNSIvPjxTaWduYXR1cmVNZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjcnNhLXNoYTEiLz48UmVmZXJlbmNlIFVSST0iI0xpYnJlRFRFX1NldERvYyI+PFRyYW5zZm9ybXM+PFRyYW5zZm9ybSBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDkveG1sZHNpZyNlbnZlbG9wZWQtc2lnbmF0dXJlIi8+PC9UcmFuc2Zvcm1zPjxEaWdlc3RNZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjc2hhMSIvPjxEaWdlc3RWYWx1ZT40ZlArbW9TTTJtYTFDMENUTmpONS9wNEEwTDg9PC9EaWdlc3RWYWx1ZT48L1JlZmVyZW5jZT48L1NpZ25lZEluZm8+PFNpZ25hdHVyZVZhbHVlPklzM3ZnaVBDbzhjMzZpRWg4U3lZeXc4aDl0VXUyeEczaEFZK0pzR2taeS9DVjh3UXZVTHFCY091WU1VSzVDOUIKUXJqbm9MeFZybFlXam9IeEl0czdCeHEwK1Y1RGxzVFlveFhFWDFRZWJneVZJOXd1cGlqYU9EOWNwbnE2WWFydwo2SjZEcmxmMDJxZWJ6VDZ5WjVFazZxZXVNTEFpZDE3NTRDQ0ZDeGZyeWo0RFBGT1hocGdXZHJkMzM1ejZVQXF0CjB4RWthR2RqTDRJVncvL21TbUQvbnl5YnQrM3kwaFJqTUVjMjhYSW9HcHcrWnM4K2dLNWJQTHZOWXNWM2dUb2cKSXg0N0ExNXRxSmZNYzVlU2pyamZydXFoV0xDeFltVE9EMTFIbWpZUFpLbFlUblJ2NlBTRnNncVc1d2pYZG56Ygo4ZVJ4bDdsSWxiNlFRZ3JVVTRzYUpnPT08L1NpZ25hdHVyZVZhbHVlPjxLZXlJbmZvPjxLZXlWYWx1ZT48UlNBS2V5VmFsdWU+PE1vZHVsdXM+bEhJODN0YzI1YWZtdUQ1NFRLbFF2RWE4SnJseXEyeHJiU3Nld2pwTXlYa3hTWlZnazRqdys0d1N5VWtlakZoTQplbUlsUHRndlJFZHVhNHNUV3FxUldXckovWmFqbWIrcm5qdC9LSlF0Q0tSaStaelZKMXM0bVllZWhKRmxKdDlyCk0zN0JMSUk4bThMN1lqUGRuaDVIbzBJYTVtcmFZeGM2QStUQ1VEWHN4TWxaM1NYRkpoMzB1Z0hvNG1NdUZTbmkKdUdIemlYb3YwWXV3eVgzZm1LbXEzLyt4L20wVDA4MGlDc1NSUGZPTXBqajY2a1ltbndSQW5DYzdhbFYyTDQzTApTYkRDL0dqTERxZHIrSkNrdmhmbUdreEJ2ZnM4Z2JjZnROMDNmWVNuWGdSbXJCN3QvT3BHM0JrVGtJbjlBK0JnClNVcXdNQVRFNW9DazJRL3BFaEZzMXc9PTwvTW9kdWx1cz48RXhwb25lbnQ+QVFBQjwvRXhwb25lbnQ+PC9SU0FLZXlWYWx1ZT48L0tleVZhbHVlPjxYNTA5RGF0YT48WDUwOUNlcnRpZmljYXRlPk1JSUdiekNDQlZlZ0F3SUJBZ0lEQVdscE1BMEdDU3FHU0liM0RRRUJDd1VBTUlHbU1Rc3dDUVlEVlFRR0V3SkQKVERFWU1CWUdBMVVFQ2hNUFFXTmxjSFJoTG1OdmJTQlRMa0V1TVVnd1JnWURWUVFERXo5QlkyVndkR0V1WTI5dApJRUYxZEc5eWFXUmhaQ0JEWlhKMGFXWnBZMkZrYjNKaElFTnNZWE5sSURJZ1VHVnljMjl1WVNCT1lYUjFjbUZzCklDMGdSelF4SGpBY0Jna3Foa2lHOXcwQkNRRVdEMmx1Wm05QVlXTmxjSFJoTG1OdmJURVRNQkVHQTFVRUJSTUsKT1RZNU1Ua3dOVEF0T0RBZUZ3MHhOekV4TURZeE5ETTNOVEphRncweU1ERXhNRFl4TkRNM05USmFNSUdLTVFzdwpDUVlEVlFRR0V3SkRUREVZTUJZR0ExVUVEQk1QVUVWU1UwOU9RU0JPUVZSVlVrRk1NU3N3S1FZRFZRUURFeUpGClUxUkZRa0ZPSUVWRVZVRlNSRThnUkVVZ1RFRWdSbFZGVGxSRklGSlZRa2xQTVI4d0hRWUpLb1pJaHZjTkFRa0IKRmhCbGMzUmxZbUZ1UUdSbGJHRm1MbU5zTVJNd0VRWURWUVFGRXdveE5qSTJNVEEyTXkwMU1JSUJJakFOQmdrcQpoa2lHOXcwQkFRRUZBQU9DQVE4QU1JSUJDZ0tDQVFFQWxISTgzdGMyNWFmbXVENTRUS2xRdkVhOEpybHlxMnhyCmJTc2V3anBNeVhreFNaVmdrNGp3KzR3U3lVa2VqRmhNZW1JbFB0Z3ZSRWR1YTRzVFdxcVJXV3JKL1pham1iK3IKbmp0L0tKUXRDS1JpK1p6VkoxczRtWWVlaEpGbEp0OXJNMzdCTElJOG04TDdZalBkbmg1SG8wSWE1bXJhWXhjNgpBK1RDVURYc3hNbFozU1hGSmgzMHVnSG80bU11RlNuaXVHSHppWG92MFl1d3lYM2ZtS21xMy8reC9tMFQwODBpCkNzU1JQZk9NcGpqNjZrWW1ud1JBbkNjN2FsVjJMNDNMU2JEQy9HakxEcWRyK0pDa3ZoZm1Ha3hCdmZzOGdiY2YKdE4wM2ZZU25YZ1JtckI3dC9PcEczQmtUa0luOUErQmdTVXF3TUFURTVvQ2syUS9wRWhGczF3SURBUUFCbzRJQwp2akNDQXJvd0h3WURWUjBqQkJnd0ZvQVVaYVdyUGovSXRsRnRFWDVmd3dvSDVrT2dDTFl3SFFZRFZSME9CQllFCkZQeFJhYVVWYm9IRGU5MUw3cXU4RGhVc0hwN2hNQXNHQTFVZER3UUVBd0lFOERBZEJnTlZIU1VFRmpBVUJnZ3IKQmdFRkJRY0RBZ1lJS3dZQkJRVUhBd1F3RVFZSllJWklBWWI0UWdFQkJBUURBZ1dnTUlIMUJnTlZIU0FFZ2UwdwpnZW93Z2VjR0NDc0dBUVFCdFdzQ01JSGFNREVHQ0NzR0FRVUZCd0lCRmlWb2RIUndjem92TDJGalp6UXVZV05sCmNIUmhMbU52YlM5RFVGTXRRV05sY0hSaFkyOXRNSUdrQmdnckJnRUZCUWNDQWpDQmx6QVdGZzlCWTJWd2RHRXUKWTI5dElGTXVRUzR3QXdJQkNScDlSV3dnZEdsMGRXeGhjaUJvWVNCemFXUnZJSFpoYkdsa1lXUnZJR1Z1SUdadgpjbTFoSUc5dWJHbHVaU3dnY1hWbFpHRnVaRzhnYUdGaWFXeHBkR0ZrYnlCbGJDQkRaWEowYVdacFkyRmtieUJ3CllYSmhJSFZ6YnlCMGNtbGlkWFJoY21sdkxDQndZV2R2Y3l3Z1kyOXRaWEpqYVc4Z2VTQnZkSEp2Y3k0d1dnWUQKVlIwU0JGTXdVYUFZQmdnckJnRUVBY0VCQXFBTUZnbzVOamt4T1RBMU1DMDRvQ1FHQ0NzR0FRVUZCd2dEb0JndwpGZ3dLT1RZNU1Ua3dOVEF0T0FZSUt3WUJCQUhCQVFLQkQybHVabTlBWVdObGNIUmhMbU52YlRCYkJnTlZIUkVFClZEQlNvQmdHQ0NzR0FRUUJ3UUVCb0F3V0NqRTJNall4TURZekxUV2dKQVlJS3dZQkJRVUhDQU9nR0RBV0RBb3gKTmpJMk1UQTJNeTAxQmdnckJnRUVBY0VCQW9FUVpYTjBaV0poYmtCa1pXeGhaaTVqYkRCSEJnZ3JCZ0VGQlFjQgpBUVE3TURrd053WUlLd1lCQlFVSE1BR0dLMmgwZEhCek9pOHZZV05uTkM1aFkyVndkR0V1WTI5dEwyRmpaelF2CmIyTnpjQzlEYkdGelpUSXRSelF3UHdZRFZSMGZCRGd3TmpBMG9ES2dNSVl1YUhSMGNITTZMeTloWTJjMExtRmoKWlhCMFlTNWpiMjB2WVdObk5DOWpjbXd2UTJ4aGMyVXlMVWMwTG1OeWJEQU5CZ2txaGtpRzl3MEJBUXNGQUFPQwpBUUVBT3BORjMranRqOENSbEhRRkduWGhmMHNBWGduV2s1R0xGbko5VTQyUDEyTC91b1VkV0F3WEVKNGc0Zmh1CjROdGhPdTBqL2o3OXlmYzJuL1dQUHJRUEl5VjFjaSs5UG9NcXUwU1VYVnBVdC93N0JIUFY2Wm00ZXRqQjhubVUKb1RHUlZLWnUxZktCOTE5TlRGTU1ELzFaNHZ3RWdlYVhSMjIzUURsVnZTQW1wenpvcGY0bzlRelptOHBpcTZDTQpnQ3p0UjkvOC9RSjRhWWs0cmdhYi9scnB1U1RMRURjT2hkZHJKd1l0Q3dpdE1lcjZoMVE0NWswa3BWMHphd0R0ClovaHFXakluSHZZelpUY1JNNjk5SThWbFl0MVQzb1cyWWJmSXZpMHlYV3FFK3FRVG1WcHFDdG5yaTBMTElJNjUKNWZyY3BGTElPN1p4TXBobzRmalNNa3FlMEE9PTwvWDUwOUNlcnRpZmljYXRlPjwvWDUwOURhdGE+PC9LZXlJbmZvPjwvU2lnbmF0dXJlPjwvRW52aW9CT0xFVEE+Cg==
            examples:
              Enviar XML al SII:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
                  emisor: '76192083-9'
                  xml: >-
                    PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iSVNPLTg4NTktMSI/Pgo8RW52aW9CT0xFVEEgeG1sbnM9Imh0dHA6Ly93d3cuc2lpLmNsL1NpaUR0ZSIgeG1sbnM6eHNpPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYS1pbnN0YW5jZSIgeHNpOnNjaGVtYUxvY2F0aW9uPSJodHRwOi8vd3d3LnNpaS5jbC9TaWlEdGUgRW52aW9CT0xFVEFfdjExLnhzZCIgdmVyc2lvbj0iMS4wIj4KICA8U2V0RFRFIElEPSJMaWJyZURURV9TZXREb2MiPgogICAgPENhcmF0dWxhIHZlcnNpb249IjEuMCI+CiAgICAgIDxSdXRFbWlzb3I+NzYxOTIwODMtOTwvUnV0RW1pc29yPgogICAgICA8UnV0RW52aWE+MTYyNjEwNjMtNTwvUnV0RW52aWE+CiAgICAgIDxSdXRSZWNlcHRvcj4xNjI2MTA2My01PC9SdXRSZWNlcHRvcj4KICAgICAgPEZjaFJlc29sPjIwMTktMTItMjM8L0ZjaFJlc29sPgogICAgICA8TnJvUmVzb2w+MDwvTnJvUmVzb2w+CiAgICAgIDxUbXN0RmlybWFFbnY+MjAyMC0wNy0xN1QxMDowODo0OTwvVG1zdEZpcm1hRW52PgogICAgICA8U3ViVG90RFRFPgogICAgICAgIDxUcG9EVEU+Mzk8L1Rwb0RURT4KICAgICAgICA8TnJvRFRFPjE8L05yb0RURT4KICAgICAgPC9TdWJUb3REVEU+CiAgICA8L0NhcmF0dWxhPgogICAgPERURSB2ZXJzaW9uPSIxLjAiPgogIDxEb2N1bWVudG8gSUQ9IkxpYnJlRFRFX1QzOUY1NzciPgogICAgPEVuY2FiZXphZG8+CiAgICAgIDxJZERvYz4KICAgICAgICA8VGlwb0RURT4zOTwvVGlwb0RURT4KICAgICAgICA8Rm9saW8+NTc3PC9Gb2xpbz4KICAgICAgICA8RmNoRW1pcz4yMDIwLTA3LTE3PC9GY2hFbWlzPgogICAgICAgIDxJbmRTZXJ2aWNpbz4zPC9JbmRTZXJ2aWNpbz4KICAgICAgPC9JZERvYz4KICAgICAgPEVtaXNvcj4KICAgICAgICA8UlVURW1pc29yPjc2MTkyMDgzLTk8L1JVVEVtaXNvcj4KICAgICAgICA8UnpuU29jRW1pc29yPlNBU0NPIFNwQTwvUnpuU29jRW1pc29yPgogICAgICAgIDxHaXJvRW1pc29yPlNlcnZpY2lvcyBpbnRlZ3JhbGVzIGRlIGluZm9ybeF0aWNhPC9HaXJvRW1pc29yPgogICAgICAgIDxEaXJPcmlnZW4+RGFuaWVsIEJhcnJvcyBHcmV6IDE5MTwvRGlyT3JpZ2VuPgogICAgICAgIDxDbW5hT3JpZ2VuPlNhbnRhIENydXo8L0NtbmFPcmlnZW4+CiAgICAgIDwvRW1pc29yPgogICAgICA8UmVjZXB0b3I+CiAgICAgICAgPFJVVFJlY2VwPjE2MjYxMDYzLTU8L1JVVFJlY2VwPgogICAgICAgIDxSem5Tb2NSZWNlcD5Fc3RlYmFuIEVJUkw8L1J6blNvY1JlY2VwPgogICAgICAgIDxDb250YWN0bz4rNTYgOSA3NDIxOTUzMjwvQ29udGFjdG8+CiAgICAgICAgPERpclJlY2VwPlNhbnRpYWdvPC9EaXJSZWNlcD4KICAgICAgICA8Q21uYVJlY2VwPlNhbnRpYWdvPC9DbW5hUmVjZXA+CiAgICAgIDwvUmVjZXB0b3I+CiAgICAgIDxUb3RhbGVzPgogICAgICAgIDxNbnRUb3RhbD4yMDA8L01udFRvdGFsPgogICAgICA8L1RvdGFsZXM+CiAgICA8L0VuY2FiZXphZG8+CiAgICA8RGV0YWxsZT4KICAgICAgPE5yb0xpbkRldD4xPC9Ocm9MaW5EZXQ+CiAgICAgIDxObWJJdGVtPnAxPC9ObWJJdGVtPgogICAgICA8UXR5SXRlbT4xPC9RdHlJdGVtPgogICAgICA8UHJjSXRlbT4xOTkuOTI8L1ByY0l0ZW0+CiAgICAgIDxNb250b0l0ZW0+MjAwPC9Nb250b0l0ZW0+CiAgICA8L0RldGFsbGU+CiAgICA8UmVmZXJlbmNpYT4KICAgICAgPE5yb0xpblJlZj4xPC9Ocm9MaW5SZWY+CiAgICAgIDxSYXpvblJlZj5FbWFpbCByZWNlcHRvcjogZXN0ZWJhbkBkZWxhZi5jbDwvUmF6b25SZWY+CiAgICA8L1JlZmVyZW5jaWE+CiAgICA8VEVEIHZlcnNpb249IjEuMCI+CiAgPEREPgogICAgPFJFPjc2MTkyMDgzLTk8L1JFPgogICAgPFREPjM5PC9URD4KICAgIDxGPjU3NzwvRj4KICAgIDxGRT4yMDIwLTA3LTE3PC9GRT4KICAgIDxSUj4xNjI2MTA2My01PC9SUj4KICAgIDxSU1I+RXN0ZWJhbiBFSVJMPC9SU1I+CiAgICA8TU5UPjIwMDwvTU5UPgogICAgPElUMT5wMTwvSVQxPgogICAgPENBRiB2ZXJzaW9uPSIxLjAiPgo8REE+CjxSRT43NjE5MjA4My05PC9SRT4KPFJTPlNBU0NPIFNQQTwvUlM+CjxURD4zOTwvVEQ+CjxSTkc+PEQ+MTE8L0Q+PEg+MTAxMDwvSD48L1JORz4KPEZBPjIwMTYtMDItMTM8L0ZBPgo8UlNBUEs+PE0+MnZXTmg0dGlldldYVjF4UnRYMjlRYjB2NU9QYzV0eEFtdWk0SHFUNHlNOFZNMkwxNHAxeWNoa09aYXh3L3I1WkIxWVNYdmNFRnUrY2J3VHVHL0QxeFE9PTwvTT48RT5Bdz09PC9FPjwvUlNBUEs+CjxJREs+MTAwPC9JREs+CjwvREE+CjxGUk1BIGFsZ29yaXRtbz0iU0hBMXdpdGhSU0EiPldJVDRTTklaUTlGNmNPVHJ1WnVJVzhYYTdNN3BOZmVOTnhIQXpaMzg2c09CVE05T0YwcHFuVkM5anllU1ZkQmxwM1pMYmN5VWZrcGdyc0gzVVNmT1BBPT08L0ZSTUE+CjwvQ0FGPgogICAgPFRTVEVEPjIwMjAtMDctMTdUMTA6MDg6NDk8L1RTVEVEPgogIDwvREQ+CiAgPEZSTVQgYWxnb3JpdG1vPSJTSEExd2l0aFJTQSI+ZjVVQnpPb21MNDNNcUZoMTUyRnh1YzhQa1Q0RXI1K2pNcTZjN3VTYmYzcVdYVmt2eVRPV1VvcXRIOFo4TEprcUJyL1dVeER5UmJHMjJKMkFLR2ZsNVE9PTwvRlJNVD4KPC9URUQ+CiAgPFRtc3RGaXJtYT4yMDIwLTA3LTE3VDEwOjA4OjQ5PC9UbXN0RmlybWE+PC9Eb2N1bWVudG8+CjxTaWduYXR1cmUgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDkveG1sZHNpZyMiPjxTaWduZWRJbmZvIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjIj48Q2Fub25pY2FsaXphdGlvbk1ldGhvZCBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnL1RSLzIwMDEvUkVDLXhtbC1jMTRuLTIwMDEwMzE1Ii8+PFNpZ25hdHVyZU1ldGhvZCBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDkveG1sZHNpZyNyc2Etc2hhMSIvPjxSZWZlcmVuY2UgVVJJPSIjTGlicmVEVEVfVDM5RjU3NyI+PFRyYW5zZm9ybXM+PFRyYW5zZm9ybSBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDkveG1sZHNpZyNlbnZlbG9wZWQtc2lnbmF0dXJlIi8+PC9UcmFuc2Zvcm1zPjxEaWdlc3RNZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjc2hhMSIvPjxEaWdlc3RWYWx1ZT5sMGd2UXVITklYcENCQU45bWRSYlhBaE1VczQ9PC9EaWdlc3RWYWx1ZT48L1JlZmVyZW5jZT48L1NpZ25lZEluZm8+PFNpZ25hdHVyZVZhbHVlPlZiZ1dTeUFkdHJKam1nWURDcUxVNElYSTVUV05tMkN1N0o2L3FnVThLWFFOWVNsZ3BVdjdKM0kybHpBUHpLemsKUUhLTlByTHc5SW5QSWxpSlNybTU3YjJzdXlkVndXMFZEOCs5Tkp3SkVkSFBmM1R4VXRraFNVWGF4SytCOGQ4RwpDWU1xQkx5cUVUOUxhNHFxbUVWUDVQd2VYY3FZeFF1TXczSnBMU0g4SG1UNXpLdmJ3c29HNERNSFdvUFZyeWxxCjV2Y0VaTytJOVpZb0NydzM0b1l3YnhqMHFob3VvcXNBbG9WZWdueFJQTXhzV0dJVXAwQnpya3dROERYek5YaHAKNlJKTWJzMnRpcHF3VDVhUEFQYWFVNS9jZ0ozaGlEaC8xU3JZR1RiLzY0YzZFaDI0VkNNMDZHU09MNGhBSkpYdgpraEgvVlhhM25mbTM1eFM5RURBbkVBPT08L1NpZ25hdHVyZVZhbHVlPjxLZXlJbmZvPjxLZXlWYWx1ZT48UlNBS2V5VmFsdWU+PE1vZHVsdXM+bEhJODN0YzI1YWZtdUQ1NFRLbFF2RWE4SnJseXEyeHJiU3Nld2pwTXlYa3hTWlZnazRqdys0d1N5VWtlakZoTQplbUlsUHRndlJFZHVhNHNUV3FxUldXckovWmFqbWIrcm5qdC9LSlF0Q0tSaStaelZKMXM0bVllZWhKRmxKdDlyCk0zN0JMSUk4bThMN1lqUGRuaDVIbzBJYTVtcmFZeGM2QStUQ1VEWHN4TWxaM1NYRkpoMzB1Z0hvNG1NdUZTbmkKdUdIemlYb3YwWXV3eVgzZm1LbXEzLyt4L20wVDA4MGlDc1NSUGZPTXBqajY2a1ltbndSQW5DYzdhbFYyTDQzTApTYkRDL0dqTERxZHIrSkNrdmhmbUdreEJ2ZnM4Z2JjZnROMDNmWVNuWGdSbXJCN3QvT3BHM0JrVGtJbjlBK0JnClNVcXdNQVRFNW9DazJRL3BFaEZzMXc9PTwvTW9kdWx1cz48RXhwb25lbnQ+QVFBQjwvRXhwb25lbnQ+PC9SU0FLZXlWYWx1ZT48L0tleVZhbHVlPjxYNTA5RGF0YT48WDUwOUNlcnRpZmljYXRlPk1JSUdiekNDQlZlZ0F3SUJBZ0lEQVdscE1BMEdDU3FHU0liM0RRRUJDd1VBTUlHbU1Rc3dDUVlEVlFRR0V3SkQKVERFWU1CWUdBMVVFQ2hNUFFXTmxjSFJoTG1OdmJTQlRMa0V1TVVnd1JnWURWUVFERXo5QlkyVndkR0V1WTI5dApJRUYxZEc5eWFXUmhaQ0JEWlhKMGFXWnBZMkZrYjNKaElFTnNZWE5sSURJZ1VHVnljMjl1WVNCT1lYUjFjbUZzCklDMGdSelF4SGpBY0Jna3Foa2lHOXcwQkNRRVdEMmx1Wm05QVlXTmxjSFJoTG1OdmJURVRNQkVHQTFVRUJSTUsKT1RZNU1Ua3dOVEF0T0RBZUZ3MHhOekV4TURZeE5ETTNOVEphRncweU1ERXhNRFl4TkRNM05USmFNSUdLTVFzdwpDUVlEVlFRR0V3SkRUREVZTUJZR0ExVUVEQk1QVUVWU1UwOU9RU0JPUVZSVlVrRk1NU3N3S1FZRFZRUURFeUpGClUxUkZRa0ZPSUVWRVZVRlNSRThnUkVVZ1RFRWdSbFZGVGxSRklGSlZRa2xQTVI4d0hRWUpLb1pJaHZjTkFRa0IKRmhCbGMzUmxZbUZ1UUdSbGJHRm1MbU5zTVJNd0VRWURWUVFGRXdveE5qSTJNVEEyTXkwMU1JSUJJakFOQmdrcQpoa2lHOXcwQkFRRUZBQU9DQVE4QU1JSUJDZ0tDQVFFQWxISTgzdGMyNWFmbXVENTRUS2xRdkVhOEpybHlxMnhyCmJTc2V3anBNeVhreFNaVmdrNGp3KzR3U3lVa2VqRmhNZW1JbFB0Z3ZSRWR1YTRzVFdxcVJXV3JKL1pham1iK3IKbmp0L0tKUXRDS1JpK1p6VkoxczRtWWVlaEpGbEp0OXJNMzdCTElJOG04TDdZalBkbmg1SG8wSWE1bXJhWXhjNgpBK1RDVURYc3hNbFozU1hGSmgzMHVnSG80bU11RlNuaXVHSHppWG92MFl1d3lYM2ZtS21xMy8reC9tMFQwODBpCkNzU1JQZk9NcGpqNjZrWW1ud1JBbkNjN2FsVjJMNDNMU2JEQy9HakxEcWRyK0pDa3ZoZm1Ha3hCdmZzOGdiY2YKdE4wM2ZZU25YZ1JtckI3dC9PcEczQmtUa0luOUErQmdTVXF3TUFURTVvQ2syUS9wRWhGczF3SURBUUFCbzRJQwp2akNDQXJvd0h3WURWUjBqQkJnd0ZvQVVaYVdyUGovSXRsRnRFWDVmd3dvSDVrT2dDTFl3SFFZRFZSME9CQllFCkZQeFJhYVVWYm9IRGU5MUw3cXU4RGhVc0hwN2hNQXNHQTFVZER3UUVBd0lFOERBZEJnTlZIU1VFRmpBVUJnZ3IKQmdFRkJRY0RBZ1lJS3dZQkJRVUhBd1F3RVFZSllJWklBWWI0UWdFQkJBUURBZ1dnTUlIMUJnTlZIU0FFZ2UwdwpnZW93Z2VjR0NDc0dBUVFCdFdzQ01JSGFNREVHQ0NzR0FRVUZCd0lCRmlWb2RIUndjem92TDJGalp6UXVZV05sCmNIUmhMbU52YlM5RFVGTXRRV05sY0hSaFkyOXRNSUdrQmdnckJnRUZCUWNDQWpDQmx6QVdGZzlCWTJWd2RHRXUKWTI5dElGTXVRUzR3QXdJQkNScDlSV3dnZEdsMGRXeGhjaUJvWVNCemFXUnZJSFpoYkdsa1lXUnZJR1Z1SUdadgpjbTFoSUc5dWJHbHVaU3dnY1hWbFpHRnVaRzhnYUdGaWFXeHBkR0ZrYnlCbGJDQkRaWEowYVdacFkyRmtieUJ3CllYSmhJSFZ6YnlCMGNtbGlkWFJoY21sdkxDQndZV2R2Y3l3Z1kyOXRaWEpqYVc4Z2VTQnZkSEp2Y3k0d1dnWUQKVlIwU0JGTXdVYUFZQmdnckJnRUVBY0VCQXFBTUZnbzVOamt4T1RBMU1DMDRvQ1FHQ0NzR0FRVUZCd2dEb0JndwpGZ3dLT1RZNU1Ua3dOVEF0T0FZSUt3WUJCQUhCQVFLQkQybHVabTlBWVdObGNIUmhMbU52YlRCYkJnTlZIUkVFClZEQlNvQmdHQ0NzR0FRUUJ3UUVCb0F3V0NqRTJNall4TURZekxUV2dKQVlJS3dZQkJRVUhDQU9nR0RBV0RBb3gKTmpJMk1UQTJNeTAxQmdnckJnRUVBY0VCQW9FUVpYTjBaV0poYmtCa1pXeGhaaTVqYkRCSEJnZ3JCZ0VGQlFjQgpBUVE3TURrd053WUlLd1lCQlFVSE1BR0dLMmgwZEhCek9pOHZZV05uTkM1aFkyVndkR0V1WTI5dEwyRmpaelF2CmIyTnpjQzlEYkdGelpUSXRSelF3UHdZRFZSMGZCRGd3TmpBMG9ES2dNSVl1YUhSMGNITTZMeTloWTJjMExtRmoKWlhCMFlTNWpiMjB2WVdObk5DOWpjbXd2UTJ4aGMyVXlMVWMwTG1OeWJEQU5CZ2txaGtpRzl3MEJBUXNGQUFPQwpBUUVBT3BORjMranRqOENSbEhRRkduWGhmMHNBWGduV2s1R0xGbko5VTQyUDEyTC91b1VkV0F3WEVKNGc0Zmh1CjROdGhPdTBqL2o3OXlmYzJuL1dQUHJRUEl5VjFjaSs5UG9NcXUwU1VYVnBVdC93N0JIUFY2Wm00ZXRqQjhubVUKb1RHUlZLWnUxZktCOTE5TlRGTU1ELzFaNHZ3RWdlYVhSMjIzUURsVnZTQW1wenpvcGY0bzlRelptOHBpcTZDTQpnQ3p0UjkvOC9RSjRhWWs0cmdhYi9scnB1U1RMRURjT2hkZHJKd1l0Q3dpdE1lcjZoMVE0NWswa3BWMHphd0R0ClovaHFXakluSHZZelpUY1JNNjk5SThWbFl0MVQzb1cyWWJmSXZpMHlYV3FFK3FRVG1WcHFDdG5yaTBMTElJNjUKNWZyY3BGTElPN1p4TXBobzRmalNNa3FlMEE9PTwvWDUwOUNlcnRpZmljYXRlPjwvWDUwOURhdGE+PC9LZXlJbmZvPjwvU2lnbmF0dXJlPjwvRFRFPgogIDwvU2V0RFRFPgo8U2lnbmF0dXJlIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjIj48U2lnbmVkSW5mbyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC8wOS94bWxkc2lnIyIgeG1sbnM6eHNpPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYS1pbnN0YW5jZSI+PENhbm9uaWNhbGl6YXRpb25NZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy9UUi8yMDAxL1JFQy14bWwtYzE0bi0yMDAxMDMxNSIvPjxTaWduYXR1cmVNZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjcnNhLXNoYTEiLz48UmVmZXJlbmNlIFVSST0iI0xpYnJlRFRFX1NldERvYyI+PFRyYW5zZm9ybXM+PFRyYW5zZm9ybSBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDkveG1sZHNpZyNlbnZlbG9wZWQtc2lnbmF0dXJlIi8+PC9UcmFuc2Zvcm1zPjxEaWdlc3RNZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjc2hhMSIvPjxEaWdlc3RWYWx1ZT40ZlArbW9TTTJtYTFDMENUTmpONS9wNEEwTDg9PC9EaWdlc3RWYWx1ZT48L1JlZmVyZW5jZT48L1NpZ25lZEluZm8+PFNpZ25hdHVyZVZhbHVlPklzM3ZnaVBDbzhjMzZpRWg4U3lZeXc4aDl0VXUyeEczaEFZK0pzR2taeS9DVjh3UXZVTHFCY091WU1VSzVDOUIKUXJqbm9MeFZybFlXam9IeEl0czdCeHEwK1Y1RGxzVFlveFhFWDFRZWJneVZJOXd1cGlqYU9EOWNwbnE2WWFydwo2SjZEcmxmMDJxZWJ6VDZ5WjVFazZxZXVNTEFpZDE3NTRDQ0ZDeGZyeWo0RFBGT1hocGdXZHJkMzM1ejZVQXF0CjB4RWthR2RqTDRJVncvL21TbUQvbnl5YnQrM3kwaFJqTUVjMjhYSW9HcHcrWnM4K2dLNWJQTHZOWXNWM2dUb2cKSXg0N0ExNXRxSmZNYzVlU2pyamZydXFoV0xDeFltVE9EMTFIbWpZUFpLbFlUblJ2NlBTRnNncVc1d2pYZG56Ygo4ZVJ4bDdsSWxiNlFRZ3JVVTRzYUpnPT08L1NpZ25hdHVyZVZhbHVlPjxLZXlJbmZvPjxLZXlWYWx1ZT48UlNBS2V5VmFsdWU+PE1vZHVsdXM+bEhJODN0YzI1YWZtdUQ1NFRLbFF2RWE4SnJseXEyeHJiU3Nld2pwTXlYa3hTWlZnazRqdys0d1N5VWtlakZoTQplbUlsUHRndlJFZHVhNHNUV3FxUldXckovWmFqbWIrcm5qdC9LSlF0Q0tSaStaelZKMXM0bVllZWhKRmxKdDlyCk0zN0JMSUk4bThMN1lqUGRuaDVIbzBJYTVtcmFZeGM2QStUQ1VEWHN4TWxaM1NYRkpoMzB1Z0hvNG1NdUZTbmkKdUdIemlYb3YwWXV3eVgzZm1LbXEzLyt4L20wVDA4MGlDc1NSUGZPTXBqajY2a1ltbndSQW5DYzdhbFYyTDQzTApTYkRDL0dqTERxZHIrSkNrdmhmbUdreEJ2ZnM4Z2JjZnROMDNmWVNuWGdSbXJCN3QvT3BHM0JrVGtJbjlBK0JnClNVcXdNQVRFNW9DazJRL3BFaEZzMXc9PTwvTW9kdWx1cz48RXhwb25lbnQ+QVFBQjwvRXhwb25lbnQ+PC9SU0FLZXlWYWx1ZT48L0tleVZhbHVlPjxYNTA5RGF0YT48WDUwOUNlcnRpZmljYXRlPk1JSUdiekNDQlZlZ0F3SUJBZ0lEQVdscE1BMEdDU3FHU0liM0RRRUJDd1VBTUlHbU1Rc3dDUVlEVlFRR0V3SkQKVERFWU1CWUdBMVVFQ2hNUFFXTmxjSFJoTG1OdmJTQlRMa0V1TVVnd1JnWURWUVFERXo5QlkyVndkR0V1WTI5dApJRUYxZEc5eWFXUmhaQ0JEWlhKMGFXWnBZMkZrYjNKaElFTnNZWE5sSURJZ1VHVnljMjl1WVNCT1lYUjFjbUZzCklDMGdSelF4SGpBY0Jna3Foa2lHOXcwQkNRRVdEMmx1Wm05QVlXTmxjSFJoTG1OdmJURVRNQkVHQTFVRUJSTUsKT1RZNU1Ua3dOVEF0T0RBZUZ3MHhOekV4TURZeE5ETTNOVEphRncweU1ERXhNRFl4TkRNM05USmFNSUdLTVFzdwpDUVlEVlFRR0V3SkRUREVZTUJZR0ExVUVEQk1QVUVWU1UwOU9RU0JPUVZSVlVrRk1NU3N3S1FZRFZRUURFeUpGClUxUkZRa0ZPSUVWRVZVRlNSRThnUkVVZ1RFRWdSbFZGVGxSRklGSlZRa2xQTVI4d0hRWUpLb1pJaHZjTkFRa0IKRmhCbGMzUmxZbUZ1UUdSbGJHRm1MbU5zTVJNd0VRWURWUVFGRXdveE5qSTJNVEEyTXkwMU1JSUJJakFOQmdrcQpoa2lHOXcwQkFRRUZBQU9DQVE4QU1JSUJDZ0tDQVFFQWxISTgzdGMyNWFmbXVENTRUS2xRdkVhOEpybHlxMnhyCmJTc2V3anBNeVhreFNaVmdrNGp3KzR3U3lVa2VqRmhNZW1JbFB0Z3ZSRWR1YTRzVFdxcVJXV3JKL1pham1iK3IKbmp0L0tKUXRDS1JpK1p6VkoxczRtWWVlaEpGbEp0OXJNMzdCTElJOG04TDdZalBkbmg1SG8wSWE1bXJhWXhjNgpBK1RDVURYc3hNbFozU1hGSmgzMHVnSG80bU11RlNuaXVHSHppWG92MFl1d3lYM2ZtS21xMy8reC9tMFQwODBpCkNzU1JQZk9NcGpqNjZrWW1ud1JBbkNjN2FsVjJMNDNMU2JEQy9HakxEcWRyK0pDa3ZoZm1Ha3hCdmZzOGdiY2YKdE4wM2ZZU25YZ1JtckI3dC9PcEczQmtUa0luOUErQmdTVXF3TUFURTVvQ2syUS9wRWhGczF3SURBUUFCbzRJQwp2akNDQXJvd0h3WURWUjBqQkJnd0ZvQVVaYVdyUGovSXRsRnRFWDVmd3dvSDVrT2dDTFl3SFFZRFZSME9CQllFCkZQeFJhYVVWYm9IRGU5MUw3cXU4RGhVc0hwN2hNQXNHQTFVZER3UUVBd0lFOERBZEJnTlZIU1VFRmpBVUJnZ3IKQmdFRkJRY0RBZ1lJS3dZQkJRVUhBd1F3RVFZSllJWklBWWI0UWdFQkJBUURBZ1dnTUlIMUJnTlZIU0FFZ2UwdwpnZW93Z2VjR0NDc0dBUVFCdFdzQ01JSGFNREVHQ0NzR0FRVUZCd0lCRmlWb2RIUndjem92TDJGalp6UXVZV05sCmNIUmhMbU52YlM5RFVGTXRRV05sY0hSaFkyOXRNSUdrQmdnckJnRUZCUWNDQWpDQmx6QVdGZzlCWTJWd2RHRXUKWTI5dElGTXVRUzR3QXdJQkNScDlSV3dnZEdsMGRXeGhjaUJvWVNCemFXUnZJSFpoYkdsa1lXUnZJR1Z1SUdadgpjbTFoSUc5dWJHbHVaU3dnY1hWbFpHRnVaRzhnYUdGaWFXeHBkR0ZrYnlCbGJDQkRaWEowYVdacFkyRmtieUJ3CllYSmhJSFZ6YnlCMGNtbGlkWFJoY21sdkxDQndZV2R2Y3l3Z1kyOXRaWEpqYVc4Z2VTQnZkSEp2Y3k0d1dnWUQKVlIwU0JGTXdVYUFZQmdnckJnRUVBY0VCQXFBTUZnbzVOamt4T1RBMU1DMDRvQ1FHQ0NzR0FRVUZCd2dEb0JndwpGZ3dLT1RZNU1Ua3dOVEF0T0FZSUt3WUJCQUhCQVFLQkQybHVabTlBWVdObGNIUmhMbU52YlRCYkJnTlZIUkVFClZEQlNvQmdHQ0NzR0FRUUJ3UUVCb0F3V0NqRTJNall4TURZekxUV2dKQVlJS3dZQkJRVUhDQU9nR0RBV0RBb3gKTmpJMk1UQTJNeTAxQmdnckJnRUVBY0VCQW9FUVpYTjBaV0poYmtCa1pXeGhaaTVqYkRCSEJnZ3JCZ0VGQlFjQgpBUVE3TURrd053WUlLd1lCQlFVSE1BR0dLMmgwZEhCek9pOHZZV05uTkM1aFkyVndkR0V1WTI5dEwyRmpaelF2CmIyTnpjQzlEYkdGelpUSXRSelF3UHdZRFZSMGZCRGd3TmpBMG9ES2dNSVl1YUhSMGNITTZMeTloWTJjMExtRmoKWlhCMFlTNWpiMjB2WVdObk5DOWpjbXd2UTJ4aGMyVXlMVWMwTG1OeWJEQU5CZ2txaGtpRzl3MEJBUXNGQUFPQwpBUUVBT3BORjMranRqOENSbEhRRkduWGhmMHNBWGduV2s1R0xGbko5VTQyUDEyTC91b1VkV0F3WEVKNGc0Zmh1CjROdGhPdTBqL2o3OXlmYzJuL1dQUHJRUEl5VjFjaSs5UG9NcXUwU1VYVnBVdC93N0JIUFY2Wm00ZXRqQjhubVUKb1RHUlZLWnUxZktCOTE5TlRGTU1ELzFaNHZ3RWdlYVhSMjIzUURsVnZTQW1wenpvcGY0bzlRelptOHBpcTZDTQpnQ3p0UjkvOC9RSjRhWWs0cmdhYi9scnB1U1RMRURjT2hkZHJKd1l0Q3dpdE1lcjZoMVE0NWswa3BWMHphd0R0ClovaHFXakluSHZZelpUY1JNNjk5SThWbFl0MVQzb1cyWWJmSXZpMHlYV3FFK3FRVG1WcHFDdG5yaTBMTElJNjUKNWZyY3BGTElPN1p4TXBobzRmalNNa3FlMEE9PTwvWDUwOUNlcnRpZmljYXRlPjwvWDUwOURhdGE+PC9LZXlJbmZvPjwvU2lnbmF0dXJlPjwvRW52aW9CT0xFVEE+Cg==
      responses:
        '200':
          description: Enviar DTE al SII
          content:
            application/json:
              schema:
                type: object
                properties:
                  certificacion:
                    type: number
                    example: 0
                  track_id:
                    type: number
                    example: 4753411374
              examples:
                Enviar DTE al SII:
                  value:
                    certificacion: 0
                    track_id: 4753411374
  /api/v1/libredte/dte/envios/estado:
    post:
      tags:
        - API Facturación - Envíos al SII
      summary: Consultar Envio de XML al SII
      description: >-
        **Permiso requerido**: `query libredte`


        Recurso que permite consultar por el estado de un DTE enviado al SII.
      operationId: consultarEnvioDeXmlAlSii
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
                dte:
                  type: number
                  example: 39
                emisor:
                  type: string
                  example: '76192083-9'
                folio:
                  type: number
                  example: 0
                track_id:
                  type: number
                  example: 12094110
            examples:
              Consultar Envio de XML al SII:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
                  dte: 39
                  emisor: '76192083-9'
                  folio: 0
                  track_id: 12094110
      responses:
        '200':
          description: >-
            Consultar Estado de un Envío de DTE al SII (boleta con folio) /
            Consultar Estado de un Envío de DTE al SII (boleta sin folio)
          content:
            application/json:
              schema:
                type: object
                properties:
                  certificacion:
                    type: number
                    example: 1
                  detalle_rep_rech:
                    type: array
                    items: {}
                    example: []
                  estadistica:
                    type: array
                    items:
                      type: object
                      properties:
                        aceptados:
                          type: number
                          example: 1
                        informados:
                          type: number
                          example: 1
                        rechazados:
                          type: number
                          example: 0
                        reparos:
                          type: number
                          example: 0
                        tipo:
                          type: number
                          example: 39
                    example:
                      - aceptados: 1
                        informados: 1
                        rechazados: 0
                        reparos: 0
                        tipo: 39
                  estado:
                    type: string
                    example: EPR
                  fecha_recepcion:
                    type: string
                    example: 15/07/2021 11:03:18
                  revision_detalle:
                    nullable: true
                    example: null
                  revision_estado:
                    type: string
                    example: RCT - Rechazado por Error en Caratula
                  rut_emisor:
                    type: string
                    example: 1-9
                  rut_envia:
                    type: string
                    example: 2-7
                  track_id:
                    type: string
                    example: '82484882'
                  trackid:
                    type: string
                    example: '12094110'
              examples:
                Consultar Estado de un Envío de DTE al SII (boleta con folio):
                  value:
                    certificacion: 1
                    revision_detalle: null
                    revision_estado: RCT - Rechazado por Error en Caratula
                    track_id: '82484882'
                Consultar Estado de un Envío de DTE al SII (boleta sin folio):
                  value:
                    detalle_rep_rech: []
                    estadistica:
                      - aceptados: 1
                        informados: 1
                        rechazados: 0
                        reparos: 0
                        tipo: 39
                    estado: EPR
                    fecha_recepcion: 15/07/2021 11:03:18
                    rut_emisor: 1-9
                    rut_envia: 2-7
                    trackid: '12094110'
  /api/v1/libredte/dte/intercambios/respuesta_sii:
    post:
      tags:
        - API Facturación - Intercambios de DTE
      summary: Registrar Respuesta de Intercambio de DTE en el SII
      description: >-
        **Permiso requerido**: `query libredte`


        Permite ingresar la respuesta al proceso de intercambio en el SII. En
        general se permite recibir o reclamar un documento.


        Específicamente, las acciones que se pueden asignar a un documento,
        usando el campo `EstadoRecepDTE` son:


        - `ERM` Otorga recibo de mercaderías o servicios.

        - `ACD` Acepta contenido del documento.

        - `RCD` Reclamo al contenido del documento.

        - `RFP` Reclamo por falta parcial de mercaderías.

        - `RFT` Reclamo por falta total de mercaderías.


        Es importante indicar que el IVA crédito de un documento sólo puede ser
        usado en el período donde el DTE fue recibido. O sea, si un documento es
        Aceptado `ACD` en Enero, pero Recibido `ERM` en Febrero, el documento
        quedará en Febrero en el Registro de Compras. Y por lo tanto su IVA
        podrá ser usado sólo en Febrero.


        Es importante siempre ingresar el estado `ERM` si lo que queremos es
        recibir el documento.


        Por el contrario, si queremos reclamar algún documento. Informar alguno
        de los 3 posibles estados. Considerar, que luego de ser reclamado, un
        documento no podrá ser aceptado ni recibido. Lo mismo al revés.
      operationId: registrarRespuestaDeIntercambioDeDteEnElSii
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
                documentos:
                  type: array
                  items:
                    type: object
                    properties:
                      EstadoRecepDTE:
                        type: string
                        example: ERM
                      FchEmis:
                        type: string
                        example: '2020-10-26'
                      Folio:
                        type: number
                        example: 859423
                      MntTotal:
                        type: number
                        example: 25938
                      RUTEmisor:
                        type: string
                        example: 96919050-8
                      RUTRecep:
                        type: string
                        example: 76192083-9
                      RecepDTEGlosa:
                        type: string
                        example: Ok
                      TipoDTE:
                        type: number
                        example: 33
                  example:
                    - EstadoRecepDTE: ERM
                      FchEmis: '2020-10-26'
                      Folio: 859423
                      MntTotal: 25938
                      RUTEmisor: 96919050-8
                      RUTRecep: 76192083-9
                      RecepDTEGlosa: Ok
                      TipoDTE: 33
            examples:
              Registrar Respuesta de Intercambio de DTE en el SII:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
                  documentos:
                    - EstadoRecepDTE: ERM
                      FchEmis: '2020-10-26'
                      Folio: 859423
                      MntTotal: 25938
                      RUTEmisor: 96919050-8
                      RUTRecep: 76192083-9
                      RecepDTEGlosa: Ok
                      TipoDTE: 33
      responses:
        '200':
          description: Registrar Respuesta de Intercambio al SII
          content:
            application/json:
              schema:
                type: object
                properties:
                  T33F1:
                    type: object
                    properties:
                      codigo:
                        type: number
                        example: 7
                      glosa:
                        type: string
                        example: Evento registrado previamente
                      registrado:
                        nullable: true
                        example: null
              examples:
                Registrar Respuesta de Intercambio al SII:
                  value:
                    T33F1:
                      codigo: 7
                      glosa: Evento registrado previamente
                      registrado: null
  /api/v1/libredte/dte/intercambios/recepcion_sii/{emisor}/{dte}/{folio}:
    post:
      tags:
        - API Facturación - Intercambios de DTE
      summary: Fecha de Recepción de un DTE en el SII
      description: >-
        **Permiso requerido**: `query libredte`


        Entrega la fecha en que el SII dió por recibido el DTE, desde esta fecha
        son los 8 días que tiene el receptor para reclamar el DTE.


        Posterior a estos 8 días, el DTE se entiende por aceptado.
      operationId: fechaDeRecepciNDeUnDteEnElSii
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
            examples:
              Fecha de Recepción de un DTE en el SII:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
      responses:
        '200':
          description: Fecha de Recepción de un DTE en el SII
          content:
            application/json:
              schema:
                type: object
                properties:
                  fecha_recepcion_sii:
                    type: string
                    example: '2020-03-11 17:01:33'
              examples:
                Fecha de Recepción de un DTE en el SII:
                  value:
                    fecha_recepcion_sii: '2020-03-11 17:01:33'
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: Emisor del DTE
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '33'
        description: Código del tipo de DTE
      - name: folio
        in: path
        required: true
        schema:
          type: string
          example: '4788'
        description: Folio del DTE
  /api/v1/libredte/dte/intercambios/eventos/{emisor}/{dte}/{folio}:
    post:
      tags:
        - API Facturación - Intercambios de DTE
      summary: Historial de Eventos de un DTE
      description: >-
        **Permiso requerido**: `query libredte`


        Entrega el historial de eventos asociados al documento en el SII. Son
        todos los eventos que el receptor del documento a asignado.
      operationId: historialDeEventosDeUnDte
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
            examples:
              Historial de Eventos de un DTE:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
      responses:
        '200':
          description: Historial de Eventos de un DTE
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    codigo:
                      type: string
                      example: ERM
                    fecha:
                      type: string
                      example: 11-03-2020 17:23:11
                    glosa:
                      type: string
                      example: Acuse de  Recibo de Mercaderías y Servicios Ley 19.983
                    responsable:
                      type: string
                      example: 1-9
                example:
                  - codigo: ERM
                    fecha: 11-03-2020 17:23:11
                    glosa: Acuse de  Recibo de Mercaderías y Servicios Ley 19.983
                    responsable: 1-9
                  - codigo: ACD
                    fecha: 11-03-2020 17:24:20
                    glosa: Acepta Contenido del Documento
                    responsable: 2-7
              examples:
                Historial de Eventos de un DTE:
                  value:
                    - codigo: ERM
                      fecha: 11-03-2020 17:23:11
                      glosa: Acuse de  Recibo de Mercaderías y Servicios Ley 19.983
                      responsable: 1-9
                    - codigo: ACD
                      fecha: 11-03-2020 17:24:20
                      glosa: Acepta Contenido del Documento
                      responsable: 2-7
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: Emisor del DTE
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '33'
        description: Código del tipo de DTE
      - name: folio
        in: path
        required: true
        schema:
          type: string
          example: '4788'
        description: Folio del DTE
  /api/v1/libredte/dte/intercambios/cesion/{emisor}/{dte}/{folio}:
    post:
      tags:
        - API Facturación - Intercambios de DTE
      summary: Información para Cesión de un DTE
      description: |-
        **Permiso requerido**: `query libredte`

        Indica si el DTE puede o no ser cedido.
      operationId: informaciNParaCesiNDeUnDte
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '0'
          description: '`0` ambiente de producción<br/>`1` ambiente de certificación'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
            examples:
              Información para Cesión de un DTE:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
      responses:
        '200':
          description: Información para Cesión de un DTE
          content:
            application/json:
              schema:
                type: object
                properties:
                  codigo:
                    type: number
                    example: 25
                  glosa:
                    type: string
                    example: >-
                      DTE Cedible, habiendo pasado 8 días se entiende dado acuse
                      de recibo
              examples:
                Información para Cesión de un DTE:
                  value:
                    codigo: 25
                    glosa: >-
                      DTE Cedible, habiendo pasado 8 días se entiende dado acuse
                      de recibo
    parameters:
      - name: emisor
        in: path
        required: true
        schema:
          type: string
          example: 76192083-9
        description: Emisor del DTE
      - name: dte
        in: path
        required: true
        schema:
          type: string
          example: '33'
        description: Código del tipo de DTE
      - name: folio
        in: path
        required: true
        schema:
          type: string
          example: '4788'
        description: Folio del DTE
  /api/v1/libredte/auth/token:
    post:
      tags:
        - API Facturación - Utilidades
      summary: Token autenticación
      description: Token autenticación
      operationId: tokenAutenticaciN
      parameters:
        - name: certificacion
          in: query
          schema:
            type: string
            example: '1'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
            examples:
              Token autenticación:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
      responses:
        '200':
          description: ''
  /api/v1/libredte/certificate/info:
    post:
      tags:
        - API Facturación - Utilidades
      summary: Datos certificado digital
      description: Datos certificado digital
      operationId: datosCertificadoDigital
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                auth:
                  type: object
                  properties:
                    cert:
                      type: object
                      properties:
                        cert-data:
                          type: string
                          example: ''
                        pkey-data:
                          type: string
                          example: ''
            examples:
              Datos certificado digital:
                value:
                  auth:
                    cert:
                      cert-data: ''
                      pkey-data: ''
      responses:
        '200':
          description: Auth Token
          headers:
            Cache-Control:
              schema:
                type: string
                example: no-cache, private
            Connection:
              schema:
                type: string
                example: Keep-Alive
            Date:
              schema:
                type: string
                example: Tue, 24 Sep 2024 09:37:15 GMT
            Keep-Alive:
              schema:
                type: string
                example: timeout=5, max=95
            Server:
              schema:
                type: string
                example: Apache
            Transfer-Encoding:
              schema:
                type: string
                example: chunked
            Vary:
              schema:
                type: string
                example: Authorization
            X-RateLimit-Limit:
              schema:
                type: string
                example: '500'
            X-RateLimit-Remaining:
              schema:
                type: string
                example: '202'
            X-Stats-EndedAt:
              schema:
                type: string
                example: '2024-09-24 06:37:15'
            X-Stats-MemoryUsed:
              schema:
                type: string
                example: '25.5'
            X-Stats-StartedAt:
              schema:
                type: string
                example: '2024-09-24 06:37:15'
            X-Stats-TimeUsed:
              schema:
                type: string
                example: '0.18'
          content:
            application/json:
              schema:
                type: object
                properties:
                  active:
                    type: boolean
                    example: true
                  certificate:
                    type: string
                    example: ''
                  email:
                    type: string
                    example: ''
                  expiration_days:
                    type: number
                    example: 382
                  exponent:
                    type: string
                    example: ''
                  from:
                    type: string
                    example: ''
                  id:
                    type: string
                    example: ''
                  issuer:
                    type: string
                    example: ''
                  modulus:
                    type: string
                    example: ''
                  name:
                    type: string
                    example: ''
                  private_key:
                    type: string
                    example: ''
                  to:
                    type: string
                    example: ''
                  total_days:
                    type: number
                    example: 450
              examples:
                Auth Token:
                  value:
                    active: true
                    certificate: ''
                    email: ''
                    expiration_days: 382
                    exponent: ''
                    from: ''
                    id: ''
                    issuer: ''
                    modulus: ''
                    name: ''
                    private_key: ''
                    to: ''
                    total_days: 450
  /api/v1/users/{id}:
    get:
      tags:
        - Back Office
      summary: Información del Usuario
      description: >-
        Recurso que permite conocer la información del usuario en la API.


        Entrega, entre otros datos, os roles que tiene, los permisos para hacer
        consultas y los límites de consulta en un rango de tiempo.
      operationId: informaciNDelUsuario
      responses:
        '200':
          description: ''
    parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          example: me
        description: >-
          Usuarios normales sólo pueden acceder a `me`.<br/>

          Administradores pueden acceder al perfil de cualquier usuario
          indicando el `id`
  /api/v1/admin/bills/biller/{biller}/notify:
    post:
      tags:
        - Back Office
      summary: Notificar pago
      description: >-
        Recurso que permite conocer la información del usuario en la API.


        Entrega, entre otros datos, os roles que tiene, los permisos para hacer
        consultas y los límites de consulta en un rango de tiempo.
      operationId: notificarPago
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                codigo:
                  type: string
                  example: ZTs3NjE5MjA4MzszOTsxMDg0
                emisor:
                  type: number
                  example: 76192083
            examples:
              Notificar pago:
                value:
                  codigo: ZTs3NjE5MjA4MzszOTsxMDg0
                  emisor: 76192083
      responses:
        '200':
          description: ''
    parameters:
      - name: biller
        in: path
        required: true
        schema:
          type: string
          example: libredte
  /api/v1/admin/tasks/beat:
    get:
      tags:
        - Back Office
      summary: Tasks Beat
      description: >-
        Recurso que permite conocer la información del usuario en la API.


        Entrega, entre otros datos, os roles que tiene, los permisos para hacer
        consultas y los límites de consulta en un rango de tiempo.
      operationId: tasksBeat
      parameters:
        - name: run_async
          in: query
          schema:
            type: string
            example: '0'
        - name: tasks
          in: query
          schema:
            type: string
            example: TaskUsersBilling,TaskBillsSync
      responses:
        '200':
          description: ''
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
security:
  - bearerAuth: []
tags:
  - name: API Contribuyentes - Consultas públicas
  - name: API Contribuyentes - Consultas MiSii - Representantes (otros al contribuyente)
  - name: API Contribuyentes - Consultas MiSii - Representados (contribuyente a otros)
  - name: API Contribuyentes - Consultas MiSii - Datos del contribuyente
  - name: API SII
  - name: API DTE - Código de Asignación de Folios (CAF)
  - name: API DTE - Contribuyentes
  - name: API DTE - Documentos Emitidos
    description: >-
      Recursos que permiten consultar por documentos emitidos por
      contribuyentes. Ya sean, emitidos por el propio usuario o por terceros.


      Permiten, principalmente, validar documentos emitidos por empresas.
  - name: API DTE - Información Electrónica de Compras y Ventas
  - name: API RCV - Registro de Compras
    description: >-
      Los documentos en el registro de compras pueden estar en 4 posibles
      estados:


      - `REGISTRO`: documentos que tienen acuse de recibo, fueron pagados al
      contado o bien pasaron los 8 días y se registraron de manera automática en
      el registro de compras.


      - `PENDIENTE`: documentos sin acuse de recibo que están aún dentro de los
      8 días. Pueden ser recibidos o reclamados por el receptor.


      - `NO_INCLUIR`: documentos que fueron parte del registro, pero que por X
      motivo la empresan o desea incluir en su contabilidad.


      - `RECLAMADO`: son los documentos que estaban pendientes y fueron
      reclamados antes de los 8 días.


      **Si el contribuyente posee mas de 1000 registros en el mes, se debe utilizar la forma asíncrona.**
  - name: API RCV - Registro de Ventas
  - name: API RTC
    description: >-
      Recursos para interactuar con el [Registro de Transferencia de
      Créditos](https://palena.sii.cl/rtc/RTC/RTCMenu.html) del SII. En otras
      palabras, lo asociado a la cesión de documentos tributarios.


      **Importante**: en estos recursos, la autenticación del SII fue probada
      originalmente con certificado digital. Sin embargo, al menos un usuario ha
      reportado que sólo le funcionó con RUT y clave tributaria del
      contribuyente. Considerar esto en caso de algún problema al obtener los
      datos.
  - name: API BHE
    description: >-
      Los siguientes son recursos para operar con las Boletas de Honorarios
      Electrónicas emitidas por personas, por servicios de 2da categoría.
  - name: API BHE - Boletas de Honorarios Emitidas
  - name: API BHE - Boletas de Honorarios Recibidas
  - name: API BTE
    description: >-
      Los siguientes son recursos para operar con las Boletas de Terceros
      Electrónicas emitidas por empresas, por servicios de 2da categoría.
  - name: API BTE - Boletas de Terceros Emitidas
  - name: API BTE - Boletas de Terceros Recibidas
  - name: API Vehículos
  - name: API Software MIPYME SII
    description: >-
      Los siguientes recursos permiten interacturar con el sistema gratuito de
      facturación ofrecido por el SII, llamado normalmente Portal MIPYME.


      Para poder usar estas consultas, se requiere:


      - El RUT de una empresa que use el Portal MIPYME.

      - El RUT y clave tributaria de un usuario (persona) que tenga acceso a la
      empresa del punto previo.


      La autenticación en el SII en este caso se hará con el RUT y clave
      tributaria de la persona. Y las consultas se harán asociadas al RUT de la
      empresa.


      Esto es muy importante, sobre todo para el caso de la extracción de datos
      de una empresa. No es posible extraer los datos de una empresa (donde se
      provee, por ejemplo, la dirección) desde el Portal MIPYME, si no se tiene
      acceso a una empresa que use el Portal MIPYME (sistema gratuito de
      facturación) del SII.


      **Importante**: los servicios web asociados al Portal MIPYME del SII son
      sólo para extraer datos, no permiten, actualmente, emitir documentos.
  - name: API Software MIPYME SII - Contribuyentes
  - name: API Software MIPYME SII - Documentos Borradores
  - name: API Software MIPYME SII - Documentos Emitidos
  - name: API Software MIPYME SII - Documentos Recibidos
  - name: API Certificación DTE
    description: >-
      Recursos que permiten realizar la automatización del proceso de
      certificación de documentos tributarios electrónicos.


      **Importante**: estos recursos son experimentales y no están completos en
      la documentación. No se deben considerar como recursos disponibles ya que
      no son parte de las características o planes ofrecidos por nuestra
      plataforma API Gateway.
  - name: API Certificación DTE - Contribuyentes
  - name: API Certificación DTE - Certificación de Facturas y otros documentos
  - name: API Certificación DTE - Certificación de Boletas
  - name: API Facturación
    description: >-
      Recursos para trabajar con Documentos Tributarios Electróncios (DTE) y
      Facturación Electrónica generando los XML y realizando los
      correspondientes envíos al SII.


      El uso de estas funcionalidades a través de API Gateway está limitado a
      los recursos acá descritos, y al igual que el resto de API Gateway no
      existe persistencia de datos. Estos recursos no proveen un sistema de
      facturación electrónica y deberán ser utilizados en un sistema que tenga
      el resto de funcionalidades.


      Si se requiere una plataforma de facturación "llegar y usar"
      [LibreDTE](https://www.libredte.cl) provee lo necesario para empezar a
      emitir documentos rápidamente con el respaldo de una plataforma web que
      considera todo lo asociado al proceso de facturación (administración de
      folios, firma, persistencia de datos, recepción de compras, acuses de
      recibo a proveedores, etc).


      [<img src="https://libredte.cl/img/banners/libredte_banner_750x110.png"
      alt="LibreDTE">](https://libredte.cl)
  - name: API Facturación - Documentos Tributarios
  - name: API Facturación - Envíos al SII
  - name: API Facturación - Intercambios de DTE
    description: >-
      Recursos asociados al proceso de Intercambio de DTE entre contribuyentes.
      Proceso durante el cual un Proveedor envía uno o más DTE a un Cliente y
      este indica si acepta o reclama dichos documentos.
  - name: API Facturación - Utilidades
  - name: Back Office
