Guía para el Servicio REST /getDTE


Descripción del Servicio

El servicio REST /getDTE permite obtener el archivo XML asociado a un documento DTE (Documento Tributario Electrónico) en formato Base64. Este servicio acepta una solicitud POST con un JSON que contiene el RUT del emisor, el folio del documento y el código SII del documento. La respuesta es una cadena en Base64 que representa el contenido del archivo XML.

Endpoint

    • URL: http://<tu-servidor>:8080/AppDTEWS/api/getDTE

    • Método HTTP: POST

    • Tipo de Contenido: application/json

Datos de Solicitud

La solicitud debe incluir un cuerpo en formato JSON con los siguientes campos:

    • rut: El RUT del emisor del documento.

    • folio: El número de folio del documento.

    • codsii: El código SII del documento.

Ejemplo de JSON de Solicitud

json

Copiar código

{

  "rut": "76040308-3",

  "folio": "12345",

  "codsii": "33"

}

Realización de la Solicitud

Para realizar una solicitud a este servicio, puedes usar la herramienta curl en la línea de comandos. Aquí tienes un ejemplo de cómo hacerlo:


curl -X POST http://<tu-servidor>/AppDTEWS/api/getDTE \

-H "Content-Type: application/json" \

-d '{

  "rut": "76040308-3",

  "folio": "12345",

  "codsii": "33"

}'

    • -X POST: Especifica el método HTTP POST.

    • http://<tu-servidor>:8080/AppDTEWS/api/getDTE: Reemplaza <tu-servidor> con la dirección de tu servidor.

    • -H "Content-Type: application/json": Indica que el contenido de la solicitud es JSON.

    • -d '...': Define el cuerpo de la solicitud en formato JSON.

Respuesta del Servicio

El servicio responde con una cadena en formato Base64 que representa el contenido del archivo XML solicitado.

Ejemplo de Respuesta


"PHhtbCB2ZXJzaW9uPSIxLjEiIHhtbG5zPSJodHRwOi8vd3d3LnhtbC5vcmcvMjAwMyIiIHhtbG9naW5nPSJodHRwOi8vd3d3LnhtbC5vcmcvMjAwMyI+PGd0ZSB2ZXJzaW9uPSI1LjAiPjxkYmU+..."

Manejo de Errores

En caso de error durante el procesamiento, como problemas con el archivo o errores en la base de datos, el servicio registrará el error y devolverá null.

Notas Adicionales

    • Asegúrate de que el servicio esté disponible en la URL proporcionada.

    • Verifica que los valores de rut, folio, y codsii sean válidos y existan en el sistema.


Comentarios

Entradas populares de este blog

Creación de un DTE de boleta electrónica usando AppDTE Api:

Guía de Consulta de DTE

¡Nuevo Entorno de Pruebas Disponible para AppDTE API!