---
title: "Download de XMLs - Solicitar."
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/paths/api-v1-DocumentoFiscal-DownloadXml-Solicitar/post"
---

> Full API specification: https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050.md

# Download de XMLs - Solicitar.

`POST` `/api/v1/DocumentoFiscal/DownloadXml/Solicitar`

Inicia o processo de <strong>geração e recuperação de arquivos XML</strong> das notas fiscais de forma assíncrona. Devido ao volume de dados, a requisição não retorna os arquivos imediatamente, mas sim um <strong>identificador de solicitação</strong>. ⚠️ **ATENÇÃO**: O ticket (ID) retornado deve ser utilizado posteriormente no endpoint de consulta de status para verificar se o pacote de arquivos já está disponível para download. ⚙️ **PROCESSAMENTO**: O tempo de geração pode variar conforme o intervalo de datas e a quantidade de documentos filtrados. Recomenda-se evitar solicitações com intervalos superiores a 30 dias para otimizar a performance. 📅 **RESTRIÇÃO DE PERÍODO**: O sistema processa solicitações com um <strong>intervalo máximo de 90 dias</strong> entre a data inicial e final. Solicitações que excedam este limite retornarão erro de validação. 📂 **CONTEÚDO**: O arquivo final será disponibilizado em formato compactado (.zip) contendo os XMLs autorizados que atendam aos critérios informados.

## Header parameters

- `DocumentoEmissor` (string, required) - Documento do emissor.

## Request body

Content types: `application/json-patch+json`, `application/json`, `text/json`, `application/*+json`

## Responses

- `200` - OK
- `400` - Bad Request
- `401` - Unauthorized
- `403` - Forbidden
- `500` - Internal Server Error

## OpenAPI definition

```yaml
openapi: 3.0.4
info:
  title: Stone Tax API
  version: 1.0.0
servers:
  - url: https://stone-tax-sdx.stone.com.br
    description: Ambiente de Desenvolvimento
  - url: https://stone-tax.stone.com.br
    description: Ambiente de Produção
paths:
  /api/v1/DocumentoFiscal/DownloadXml/Solicitar:
    post:
      tags:
        - DocumentoFiscal
      summary: Download de XMLs - Solicitar.
      description: >-
        Inicia o processo de <strong>geração e recuperação de arquivos
        XML</strong> das notas fiscais de forma assíncrona. 

        Devido ao volume de dados, a requisição não retorna os arquivos
        imediatamente, mas sim um <strong>identificador de solicitação</strong>.


        ⚠️ **ATENÇÃO**: O ticket (ID) retornado deve ser utilizado
        posteriormente no endpoint de consulta de status para verificar se o
        pacote de arquivos já está disponível para download.


        ⚙️ **PROCESSAMENTO**: O tempo de geração pode variar conforme o
        intervalo de datas e a quantidade de documentos filtrados. Recomenda-se
        evitar solicitações com intervalos superiores a 30 dias para otimizar a
        performance.


        📅 **RESTRIÇÃO DE PERÍODO**: O sistema processa solicitações com um
        <strong>intervalo máximo de 90 dias</strong> entre a data inicial e
        final. Solicitações que excedam este limite retornarão erro de
        validação.


        📂 **CONTEÚDO**: O arquivo final será disponibilizado em formato
        compactado (.zip) contendo os XMLs autorizados que atendam aos critérios
        informados.
      parameters:
        - name: DocumentoEmissor
          in: header
          description: Documento do emissor.
          required: true
          schema:
            type: string
      requestBody:
        description: Filtros e critérios para a extração dos arquivos XML.
        content:
          application/json-patch+json:
            schema:
              $ref: "#/components/schemas/SolicitarDownloadXmlInputModel"
          application/json:
            schema:
              $ref: "#/components/schemas/SolicitarDownloadXmlInputModel"
          text/json:
            schema:
              $ref: "#/components/schemas/SolicitarDownloadXmlInputModel"
          application/*+json:
            schema:
              $ref: "#/components/schemas/SolicitarDownloadXmlInputModel"
      responses:
        "200":
          description: OK
          content:
            text/plain:
              schema:
                type: string
                format: uuid
            application/json:
              schema:
                type: string
                format: uuid
            text/json:
              schema:
                type: string
                format: uuid
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "401":
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "403":
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "500":
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
      security:
        - BearerAuth: []
security:
  - BearerAuth: []
components:
  schemas:
    SolicitarDownloadXmlInputModel:
      required:
        - dataFim
        - dataInicio
      type: object
      properties:
        dataInicio:
          minLength: 1
          type: string
          description: Filtrar pela data de emissão da nota "a partir de".
          format: date
          example: 2025-03-31
        dataFim:
          minLength: 1
          type: string
          description: Filtrar pela data de emissão da nota "até".
          format: date
          example: 2025-03-31
        inscricaoEstadual:
          type: string
          description: Filtrar pela inscrição estadual do emissor da nota fiscal.
          nullable: true
        busca:
          type: string
          description: Filtro de busca genérica (dados do destinatário, transportador,
            chave de acesso, intermediador ou número do documento).
          nullable: true
        modelosDocumento:
          type: array
          items:
            $ref: "#/components/schemas/ModeloDocumentoDownloadXmlModelEnum"
          description: Filtrar pelo modelo do arquivo XML.
          nullable: true
        urlCallback:
          type: string
          description: URL de callback para disparar notificação após conclusão do
            processamento da solicitação.
          nullable: true
      additionalProperties: false
      description: Filtros solicitados para download de arquivos xmls.
    ResponseErrorResult:
      type: object
      properties:
        status:
          type: integer
          format: int32
        titulo:
          type: string
          nullable: true
        erros:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          nullable: true
      additionalProperties: false
    ModeloDocumentoDownloadXmlModelEnum:
      enum:
        - Nfe
        - Nfce
      type: string
      description: Modelo de documentos solicitados para download.
  securitySchemes:
    BearerAuth:
      type: http
      description: Autenticação via token JWT. Obtenha o token através do endpoint
        /Autenticacao/ObterToken usando Basic Auth. O token expira em 1 hora.
      scheme: bearer
      bearerFormat: JWT
```