---
title: "FileValidationProblemDetail"
url: "https://devcenter.stone.com.br/apis/chargeback-api-v2026-02-01/versions/277b2a7a-855b-475c-a343-f67650befb83/schemas/FileValidationProblemDetail"
---

> Full API specification: https://devcenter.stone.com.br/apis/chargeback-api-v2026-02-01/versions/277b2a7a-855b-475c-a343-f67650befb83.md

# FileValidationProblemDetail

Extensão do ProblemDetail (RFC 9457) específica para o erro `/errors/invalid-file` quando a submissão de evidência é rejeitada por validação. Inclui o detalhamento por arquivo (`validated_files`) e a lista de falhas agregadas por transação (`transaction_batch_errors`). O `detail` é um sumário legível dos códigos de erro retornados.

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Disputas
  version: v2026-02-01
servers:
  - url: https://api.stone.com.br
    description: production
  - url: https://sandbox.api.stone.com.br
    description: sandbox
components:
  schemas:
    ProblemDetail:
      type: object
      description: >
        Estrutura de erro padronizada conforme RFC 9457 (Problem Details for
        HTTP APIs).

        Content-Type da resposta: `application/problem+json`.
      properties:
        type:
          type: string
          description: "Identificador relativo do tipo de erro (ex.:
            `/errors/resource-not-found`)."
          example: /errors/resource-not-found
        title:
          type: string
          description: Resumo curto e legível do tipo de erro (em inglês).
          example: Resource Not Found
        status:
          type: integer
          description: Código de status HTTP correspondente.
          example: 404
        detail:
          type: string
          description: Explicação humana específica desta ocorrência (em inglês).
          example: Dispute '12332125088527' could not be found.
        instance:
          type: string
          description: Caminho do recurso requisitado.
          example: /v1/disputes/12332125088527
        traceId:
          type: string
          description: Identificador da requisição (echo de `X-Request-Id`), útil para
            rastrear a requisição em caso de suporte.
          example: abc-123-trace
    ValidatedFile:
      type: object
      description: >
        Resultado da validação de um único arquivo enviado como evidência.
        Quando

        uma submissão é rejeitada, cada arquivo é reportado neste formato,

        listando todos os códigos de erro que ele violou (vazio quando o arquivo

        em si está OK, mesmo que a transação tenha falhado por outro motivo).
      properties:
        name:
          type: string
          description: Nome do arquivo conforme enviado no multipart.
          example: evidence.pdf
        transaction_id:
          type:
            - string
            - "null"
          description: Identificador da transação associada ao arquivo, quando aplicável.
          example: "12332125088527"
        institution:
          type:
            - string
            - "null"
          description: Instituição associada à transação, quando aplicável.
          example: stone
        errors:
          type: array
          items:
            type: string
            description: Código do erro de validação do arquivo.
            enum:
              - FILE_NAME_IS_NOT_VALID
              - FILE_SIZE_TOO_SMALL
              - FILE_SIZE_TOO_BIG
              - FILE_MIME_TYPE_NOT_ALLOWED
              - FILE_EXTENSION_NOT_ALLOWED
              - DISPUTE_NOT_FOUND_TO_INFORMED_TRANSACTION_ID
              - DISPUTE_STATUS_NOT_ALLOWED
              - DISPUTE_DOESNT_BELONG_TO_MERCHANT
          description: >
            Lista de códigos de erro de validação deste arquivo.

            Estará vazia quando `is_valid_file` for `true`.


            **Códigos possíveis:**


            | Código | Significado |

            |---|---|

            | `FILE_NAME_IS_NOT_VALID` | Nome do arquivo não contém um ID de
            transação válido. |

            | `FILE_SIZE_TOO_SMALL` | Tamanho do arquivo abaixo do mínimo
            permitido (1 byte). |

            | `FILE_SIZE_TOO_BIG` | Tamanho do arquivo acima do máximo permitido
            (2 MB). |

            | `FILE_MIME_TYPE_NOT_ALLOWED` | MIME real do arquivo não é
            `application/pdf`. |

            | `FILE_EXTENSION_NOT_ALLOWED` | Extensão não permitida. Permitidas:
            `.pdf`. |

            | `DISPUTE_NOT_FOUND_TO_INFORMED_TRANSACTION_ID` | Não existe
            disputa para o `transaction_id` informado. |

            | `DISPUTE_STATUS_NOT_ALLOWED` | Status atual da disputa não permite
            envio de evidência. |

            | `DISPUTE_DOESNT_BELONG_TO_MERCHANT` | A disputa não pertence ao
            merchant informado. |
          example:
            - FILE_MIME_TYPE_NOT_ALLOWED
            - FILE_SIZE_TOO_BIG
        is_valid_file:
          type: boolean
          description: Indica se o arquivo passou em todas as regras de validação
            individuais.
          example: false
    TransactionBatchError:
      type: object
      description: >
        Falha de validação aplicada ao conjunto de arquivos de uma mesma
        transação

        (independente de cada arquivo ser individualmente válido), ex.: a soma
        de

        páginas dos arquivos enviados excede o limite de 10 páginas por
        transação.
      properties:
        transaction_id:
          type: string
          description: Transação alvo da regra de batch.
          example: "12332125088527"
        filenames:
          type: array
          items:
            type: string
          description: Arquivos considerados no batch desta transação.
          example:
            - 12332125088527.pdf
            - dummy_print.pdf
        errors:
          type: array
          items:
            type: string
            description: Código do erro de validação de batch da transação.
            enum:
              - MAX_ITEMS_PER_TRANSACTION_QUANTITY_EXCEEDED
          description: Códigos de erro de validação da transação.
          example:
            - MAX_ITEMS_PER_TRANSACTION_QUANTITY_EXCEEDED
    FileValidationProblemDetail:
      type: object
      description: >
        Extensão do ProblemDetail (RFC 9457) específica para o erro
        `/errors/invalid-file`

        quando a submissão de evidência é rejeitada por validação. Inclui o

        detalhamento por arquivo (`validated_files`) e a lista de falhas
        agregadas por

        transação (`transaction_batch_errors`). O `detail` é um sumário legível
        dos

        códigos de erro retornados.
      allOf:
        - $ref: "#/components/schemas/ProblemDetail"
        - type: object
          required:
            - validated_files
          properties:
            validated_files:
              type: array
              items:
                $ref: "#/components/schemas/ValidatedFile"
              description: Resultado da validação individual de cada arquivo da submissão.
            transaction_batch_errors:
              type: array
              items:
                $ref: "#/components/schemas/TransactionBatchError"
              description: Falhas de validação agregadas por transação.
```