--- title: "API Integration" description: "How to integrate your own software with the LibreDTE API and start invoicing." type: "academy" category: "course" tags: [api, english] authors: [LibreDTE] date: "2026-08-25" last_update: "2026-08-25" time_minutes: 10 draft: false unlisted: false image: "https://www.libredte.cl/img/content/academy/integracion-con-la-api/academy-integracion-api.jpg" url: "https://www.stage.libredte.cl/academy/integration" --- # API Integration --- ## Integration Guide for the Issuance of Electronic Tax Documents (DTE) --- ### Integration Guide for the Issuance of Electronic Tax Documents (DTE) Integration Guide for the Issuance of Electronic Tax Documents (DTE) # LibreDTE Web Services # Integration Guide for the Issuance of Electronic Tax Documents (DTE) ## LibreDTE Web Services [LibreDTE](https://www.libredte.cl) offers a web platform primarily focused on Electronic Invoicing. It provides a web application designed to generate electronic tax documents, known in Chile as "Documentros Tributarios Electrónicos" or "DTE". Throught its Web Services, LibreDTE enables external systems to integrate with its platform and issue DTEs directly from third-party software. The complete official documentation is available at [libredte.cl/doc](https://libredte.cl/doc). ## Authentication via Hash LibreDTE's Web Services use HTTP Basic authentication based on a **32-character hash**, which you can obtain from your user profile on the platform. ### Authentication Options #### 1. Using the API HASH The hash is available in the [API hash](https://libredte.cl/usuarios/perfil#datos:hashField) field of your user profile. The following image shows the corresponding field: ![API Hash Field in LibreDTE](https://www.libredte.cl/img/content/academy/integracion-con-la-api/guia-de-integracion-para-emision-de-dte/api_hash_field.jpg){.w-75 .mx-auto} To authenticate requests, this hash must be sent using **HTTP Basic Auth**, where the **username is the letter "X"** and the **password is your user's hash**. If your user hash is **"hash123"** (real values are 32 characters long), then your API credentials must be Base64-encoded as follows: ```PHP // Example usage in PHP. $hash = 'hash123'; $credentials = base64_encode('X:' . $hash); $headers = ['Authorization' => 'Basic ' . $credentials]; ``` The resulting header will look like this: ```http Authorization: Basic WDpoYXNoMTIz ``` #### 2. Using the API Key Alternatively, you can use the **Base64-encoded value** available directly in the [API KEY](https://libredte.cl/usuarios/perfil#datos:api_keyField) field of your profile. The following image shows the corresponding field: ![Campo API Key en LibreDTE](https://www.libredte.cl/img/content/academy/integracion-con-la-api/guia-de-integracion-para-emision-de-dte/api_key_field.jpg){.w-75 .mx-auto} This API key can be used directly in HTTP header: ```http Authorization: Basic APIKEY ``` --- ### Requirements for DTE Issuance Testing Requirements for DTE Issuance Testing # Requirements for DTE Issuance Testing To carry out integration and electronic tax document (DTE) issuance tests, the following requirements must be met: 1. **Have a user account and register a company in LibreDTE.** - You can register and request access to the **Servicio Plus trial** through the following link: [https://www.libredte.cl/trial](https://www.libredte.cl/trial). <br> The trial period lasts **10 days** from the moment of registration. 2. **Upload the digital signature (Firma Electrónica Simple) of the legal representative.** - This signature is required to issue valid documents. You can upload it here: [https://libredte.cl/dte/admin/firma_electronicas](https://libredte.cl/dte/admin/firma_electronicas) 3. **Configure the folios (CAF) in the system.** - You must create the folio definitions and upload the CAF files authorized by the SII via the following link: [https://libredte.cl/dte/admin/dte_folios](https://libredte.cl/dte/admin/dte_folios) --- ### General Integration Flow # General Integration Flow ## General Integration Flow The process for issuing a DTE (Electronic Tax Document) consists of the following steps: 1. **Data Preparation** – Structuring the document’s information. 2. **Consuming Web Services** - Communicating with the LibreDTE API. 3. **Replicating the Basic Issuance Flow** - Executing the standard flow to issue a DTE using LibreDTE services. ### 1. Preparing DTE Data You must structure the data that will be used to create the DTE. You can refer to example files covering the most common use cases in the following repository: [Example YAML Files](https://github.com/LibreDTE/libredte-lib-core/tree/master/tests/fixtures/yaml/documentos_ok). Other scenarios should be constructed using the official documentation provided by the SII (Chilean Internal Revenue Service). ### 2. Consuming the Web Services You have several options to interact with LibreDTE’s Web Services: - Use the official SDKs provided by LibreDTE for your programming language. You can find them here: [LibreDTE Client Repositories](https://github.com/LibreDTE?q=Cliente). - Develop your own client (SDK) to consume the services directly from your application. - Use an HTTP library appropriate for your language to handle Web Services interactions (e.g., Guzzle HTTP for PHP or Requests for Python). ### 3. Replicating the Basic Issuance Flow The minimum steps required to issue a DTE are: 1. Issue a temporary DTE 2. Generate a real DTE from the temporary version. 3. Check the status of the DTE submitted to the SII. 4. Retrieve the PDF of the finalized DTE. > [!NOTE] Note > >There are additional optional steps such as emailing documents or listing issued DTEs. These are not mandatory and are not covered here. If you wish to perform these actions, please refer to the full documentation: [Web Service Documentation](https://www.libredte.cl/docs/api) To issue a DTE and obtain its corresponding PDF, your code must perform the API calls illustrated in the following sequence diagram: ![LibreDTE Sequence Diagram](https://www.libredte.cl/img/content/academy/integracion-con-la-api/guia-de-integracion-para-emision-de-dte/diagrama_secuencial_libredte.jpg "Diagrama de Secuencia para la Emisión de un DTE"){.w-50 .mx-auto} ### DTE Normalization LibreDTE includes a **DTE normalization process**, which helps reduce the amount of information required when building a DTE. For instance, the VAT amount on an invoice is calculated automatically based on the net amount and VAT rate, so if these values are not explicitly provided in the request, LibreDTE will compute them. The normalization process performs the following actions: - Adds missing discount/charge numbers and references. - Normalizes the line item details: item numbers and item-level discounts. - Applies global discounts or surcharges, calculating the respective amounts. - Applies additional taxes or withholdings. - Calculates VAT and/or total amounts. ### Request Format The JSON object structure used to submit a DTE (Electronic Tax Document) follows the same fields, data types, and constraints as the corresponding DTE XML format. The full specification of the available fields in the XML can be found in the official documentation provided by the Chilean IRS (SII) at the following links: - Electronic Tax Documents (excluding receipts/boletas): - DTE format description: [Electronic Tax Documents Format](https://www.sii.cl/factura_electronica/factura_mercado/formato_dte_202602.pdf). - DTE XML diagram: [DTE Diagram](https://www.sii.cl/factura_electronica/factura_mercado/diagrama_dte.zip) - Electronic Receipts (Boletas): - Receipt format description: [Electronic Receipts Format](https://www.sii.cl/factura_electronica/factura_mercado/boletas_elec_0720_3.pdf) - Receipt XML diagram: [Receipt Diagram](https://www.sii.cl/factura_electronica/factura_mercado/diag_boleta_0920.zip) In addition to **JSON**, other formats can be used to submit DTE data: **XML** and **YAML**. These formats must follow the same structural rules as JSON, adapted to their respective syntax. If the submitted format is not JSON, the content must be sent encoded in **Base64**. All examples in this documentation use JSON, which is the **default and recommended format** for integrating with LibreDTE’s Web Services. If you have any questions or need assistance regarding the supported formats, please open a support ticket at: [Technical Support Request](https://www.libredte.cl/help?topic=technical). --- ### Steps for Issuing a DTE Steps for Issuing a DTE # Steps for Issuing a DTE Below are the necessary steps to issue an Electronic Tax Document (DTE) through LibreDTE. ## 1. [POST] Issuing a Temporary DTE (Draft or Quotation) This endpoint allows you to issue a temporary document in LibreDTE: ```http POST https://libredte.cl/api/dte/documentos/emitir?normalizar=1&formato=json&links=0&email=0 ``` | Parameter | Type | Description | |--------------|-----------|-------------| | `normalizar` | int | `1`: Apply normalization.<br>`0`: Do not apply normalization. | | `formato` | string | Format of the submitted data used to create the DTE:<br>`json`: JSON format (default).<br>`xml`: XML format.<br>`yaml`: YAML format. | | `links` | int | `1`: Include links associated with the temporary document.<br>`0`: Do not include links. | | `email` | int | `1`: Send the document by email to the recipient..<br>`0`: Do not send the document by email. | The body of the request must include the DTE or receipt content. For example, the following JSON represents the contents of an electronic receipt (boleta electrónica): ```json { "Encabezado": { "IdDoc": { "TipoDTE": 39 }, "Emisor": { "RUTEmisor": "76123456-9" }, "Receptor": { "RUTRecep": "11222333-4", "RznSocRecep": "Juan Pérez", "GiroRecep": "Informática", "DirRecep": "Domicilio de Juan 123", "CmnaRecep": "Santa Cruz" } }, "Detalle": [ { "NmbItem": "Conectores RJ45", "QtyItem": 450, "PrcItem": 70 } ] } ``` In this example, field normalization is applied, so it is not necessary to include total amounts or VAT, as these will be calculated automatically. ### Adding Extra Data to the DTE LibreDTE allows the inclusion of extra data, which is mainly used to enhance the content shown in the generated PDF files. This functionality is useful in various scenarios, such as: - **Adding invoice-specific fields to other document types**, like receipts.<br> *Example*: the **TermPagoGlosa** field to indicate payment terms. - **Including custom business information not covered by SII but relevant to the client or business.**<br> *Example*: a graph showing a customer's water consumption history. To include this extra data, add a **LibreDTE** index inside the DTE data structure. This index must contain an `extra` array with the custom fields, using a structure like the following: ```json { "LibreDTE": { "extra": { "dte": { "Encabezado": { "IdDoc": { "TermPagoGlosa": "OBSERVACIONES" } } }, "historial": { "titulo": "Consumo de Agua Potable", "datos": { "Feb": 12, "Mar": 11, "Abr": 12, "May": 10.5, "Jun": 4, "Jul": 5 } }, "servicios_basicos": { "consumos": { "unidad": "M3", "lectura_actual": 9, "lectura_anterior": 5.9, "consumo_calculado": 3.1, "consumo_facturado": 3, "limite_sobreconsumo": 40 } } } } } ``` ## 2. [POST] Generate Real DTE from Temporary DTE This endpoint allows you to generate a real DTE based on a previously created temporary document. ```http https://libredte.cl/api/dte/documentos/generar?getXML=0&links=0&email=0&retry=10&gzip=0 ``` | Parámetro | Tipo | Descripción | | --------- | ---- | -------------------------------------------------------------------------------------------------------------------------- | | `getXML` | int | `1`: Includes the XML in the response.<br> `0`: Does not include the XML. | | `links` | int | `1`: Includes links associated with the DTE.<br> `0`: Does not include links. | | `email` | int | `1`: Sends the document by email to the recipient.<br> `0`: Does not send the document by email. | The body of the request must contain the data returned from the previous step (temporary DTE issuance): ```json { "emisor": 76123456, "receptor": 66666666, "dte": 39, "codigo": "557ccc1706a77a212354d0f1734fd0adc" } ``` ## 3. [GET] Generate PDF of an Issued DTE This endpoint allows you to generate a PDF version of a DTE issued in LibreDTE. ```http https://libredte.cl/api/dte/dte_emitidos/pdf/:dte/:folio/:emisor?formato=general&papelContinuo=0 ``` **Key Parameters** - **formato**: Defines the PDF layout: - estandar: basic layout. - general: includes images and an additional chart. - servicios_basicos: layout for utility billing documents. - **papelContinuo**: Defines the paper format: - 0: letter size. - 80: continuous paper (80mm). - 57: continuous paper (57mm). The response will return the binary content of the generated PDF. More details are available in the official [developer documentation](https://www.libredte.cl/docs/api#/Facturaci%C3%B3n/pdfDeUnDteEmitido). <twig:block-cta class="my-4 rounded p-4" title="Need Additional Help?" content='If you need help with the points mentioned in the document, please open a support ticket.' buttonText="I need help" buttonUrl="/help?topic=technical" /> --- Last updated on 25/08/2026 #api, #english