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

# Endpoint Depreciado - Validar Nota Fiscal

> Depreciado: use o endpoint /validate/nf para validar um arquivo de Nota Fiscal (PDF) com os dados fornecidos no formulário.



## OpenAPI

````yaml api-reference/openapi.json post /validate_nf
openapi: 3.1.0
info:
  title: Noodle API
  contact:
    name: Time de Engenharia da Noodle
    url: https://www.noodle.cx/contato
    email: dev@noodle.cx
  version: 1.0.0
servers:
  - url: https://production.api.noodle.cx/external
    description: Servidor de Produção
  - url: https://homolog.api.noodle.cx/external
    description: Servidor de Homologação (Staging)
security: []
paths:
  /validate_nf:
    post:
      tags:
        - Validacao
      summary: Endpoint Depreciado - Validar Nota Fiscal
      description: >-
        Depreciado: use o endpoint /validate/nf para validar um arquivo de Nota
        Fiscal (PDF) com os dados fornecidos no formulário.
      operationId: validate_nf_validate_nf_post
      requestBody:
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Body_validate_nf_validate_nf_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NFValidationResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      deprecated: true
      security:
        - APIKeyHeader: []
components:
  schemas:
    Body_validate_nf_validate_nf_post:
      properties:
        data:
          type: string
          title: Data
          description: >
            Uma string JSON contendo os seguintes campos (todos opcionais):


            - **`due_date`** (`Optional`): Data de vencimento da Nota Fiscal.
              - *Exemplo: `2025-12-31`*
            - **`invoice_date`** (`Optional`): Data de emissão da Nota fiscal.
              - *Exemplo: `2025-11-30`*
            - **`invoice_id`** (`Optional`): Número de identificação da nota
            fiscal.
              - *Exemplo: `123456`*
            - **`receiver_email`** (`Optional`): E-mail do sacado
            (destinatário/comprador).
              - *Exemplo: `comprador@email.com`*
            - **`receiver_name`** (`Optional`): Nome ou razão social do sacado
            (destinatário/comprador).
              - *Exemplo: `Empresa Compradora LTDA`*
            - **`receiver_tax_id`** (`Optional`): CNPJ ou CPF do sacado
            (destinatário/comprador).
              - *Exemplo: `11.222.333/0001-44`*
            - **`supplier_address`** (`Optional`): Endereço do cedente
            (emissor/vendedor).
              - *Exemplo: `Rua Exemplo, 123, São Paulo, SP`*
            - **`supplier_name`** (`Optional`): Nome ou razão social do cedente
            (emissor/vendedor).
              - *Exemplo: `Empresa Vendedora S.A.`*
            - **`supplier_tax_id`** (`Optional`): CNPJ ou CPF do cedente
            (emissor/vendedor).
              - *Exemplo: `55.666.777/0001-88`*
            - **`total_amount`** (`Optional`): Valor total da nota fiscal.
              - *Exemplo: `1500.5`*
        file:
          type: string
          format: binary
          title: File
          description: Arquivo da Nota Fiscal (PDF) para extração e validação dos dados.
      type: object
      required:
        - data
        - file
      title: Body_validate_nf_validate_nf_post
    NFValidationResponse:
      properties:
        valid:
          type: boolean
          title: Valid
          description: Indica se TODOS os campos enviados foram validados com sucesso.
        message:
          anyOf:
            - type: string
            - type: 'null'
          title: Message
          description: Mensagem adicional, geralmente explicando o motivo de uma falha.
        fields:
          items:
            $ref: '#/components/schemas/NFValidationFieldResponse'
          type: array
          title: Fields
          description: Lista com os resultados detalhados da validação de cada campo.
      type: object
      required:
        - valid
      title: NFValidationResponse
      description: Modelo de resposta para a validação da Nota Fiscal.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    NFValidationFieldResponse:
      properties:
        valid:
          type: boolean
          title: Valid
          description: Indica se o campo específico foi validado com sucesso.
        field_name:
          type: string
          title: Field Name
          description: Nome do campo que foi validado.
          examples:
            - total_amount
        request_value:
          type: string
          title: Request Value
          description: Valor enviado pelo usuário para validação.
          examples:
            - '1500.5'
        extracted_value:
          type: string
          title: Extracted Value
          description: Valor extraído do documento para comparação.
          examples:
            - '1500.50'
        confidence_score:
          type: number
          title: Confidence Score
          description: Pontuação de confiança da extração (de 0.0 a 1.0).
          examples:
            - 0.99
        message:
          anyOf:
            - type: string
            - type: 'null'
          title: Message
          description: Mensagem adicional, geralmente explicando o motivo de uma falha.
          examples:
            - O valor corresponde ao extraído.
      type: object
      required:
        - valid
        - field_name
        - request_value
        - extracted_value
        - confidence_score
      title: NFValidationFieldResponse
      description: Descreve o resultado da validação para um único campo.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: Authorization

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.