> ## Documentation Index
> Fetch the complete documentation index at: https://docs.json.pe/llms.txt
> Use this file to discover all available pages before exploring further.

# Descarga Guía XML (SUNAT)

> Descarga la guía de remisión electrónica (GRE) en XML codificado en Base64.

Obtén la **guía de remisión electrónica (GRE)** emitida en SUNAT en su formato XML. La respuesta devuelve el archivo codificado en **Base64** en el campo `data`.

## Parámetros de la guía

| Parámetro                 | Ejemplo       | Descripción                            |
| ------------------------- | ------------- | -------------------------------------- |
| `numRuc`                  | `20293774308` | RUC del emisor                         |
| `tipoDocumento`           | `09`          | Tipo de comprobante (guía de remisión) |
| `numSerieComprobante`     | `T002`        | Serie del comprobante                  |
| `numDocumentoComprobante` | `7721`        | Correlativo                            |

**URL resultante:**

```
GET /sunat/guia/xml/20293774308-09-T002-7721
```

## Ejemplo de respuesta

```json theme={null}
{
  "success": true,
  "message": "Exito",
  "data": "PERlc3BhdGNoQWR2aWNl..."
}
```

<Alert type="info">
  El campo `data` contiene el XML de la guía en Base64. Decodifica el string para obtener el archivo XML y utilizarlo en tu sistema.
</Alert>


## OpenAPI

````yaml GET /sunat/guia/xml/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante}
openapi: 3.0.1
info:
  title: json.pe - API Consulta RUC, DNI, Placa, SOAT, Licencia de Conducir y más
  description: >-
    Documentación oficial de [json.pe](https://json.pe) — API Consulta RUC, DNI,
    Placa, SOAT, Licencia de Conducir y más. Regístrate gratis en
    [json.pe/signup](https://json.pe/signup).
  version: 1.0.0
servers:
  - url: https://api.json.pe/api
security:
  - bearerAuth: []
paths:
  /sunat/guia/xml/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante}:
    get:
      tags:
        - sunat
      description: >-
        Descarga la guía de remisión electrónica (GRE) en formato XML codificado
        en Base64.
      parameters:
        - name: numRuc
          in: path
          required: true
          style: simple
          schema:
            type: string
            example: '20293774308'
        - name: tipoDocumento
          in: path
          required: true
          style: simple
          schema:
            type: string
            example: '09'
        - name: numSerieComprobante
          in: path
          required: true
          style: simple
          schema:
            type: string
            example: T002
        - name: numDocumentoComprobante
          in: path
          required: true
          style: simple
          schema:
            type: string
            example: '7721'
      responses:
        '200':
          description: >-
            Guía obtenida correctamente. El campo `data` contiene el XML en
            Base64.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sunat-guia-xml'
        '400':
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
components:
  schemas:
    sunat-guia-xml:
      type: object
      properties:
        success:
          type: boolean
          description: El estado de la respuesta  true o false
        message:
          type: string
          description: Mensaje de la respuesta
        data:
          type: string
          description: XML de la guía codificado en Base64
      example:
        success: true
        message: Exito
        data: PERlc3BhdGNoQWR2aWNl...
    error:
      required:
        - message
        - success
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
      example:
        success: false
        message: Bad Request
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````