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

# Retorna duplicatas em aberto

> Retorna lista de duplicatas em aberto, filtrando por data de vencimento e cliente (se informado)



## OpenAPI

````yaml /api-convertr/openapi.yaml get /pessoas/duplicatas/aberto
openapi: 3.1.0
info:
  title: Agulhão API - Convertr
  description: API do sistema Agulhão para integração com Convertr.
  contact:
    email: contato@softros.com.br
    url: https://agulhao.com.br
  version: 1.0.1
servers:
  - url: https://api-integracoes.agulhao.com.br
    description: Produção
security: []
tags:
  - name: filiais-cr
  - name: pessoas-cr
  - name: produtos-cr
  - name: pedidos-cr
  - name: tipos-lancamento-cr
externalDocs:
  description: Mais sobre a API
  url: https://docs.agulhao.com.br/api
paths:
  /pessoas/duplicatas/aberto:
    get:
      tags:
        - pessoas-cr
      summary: Retorna duplicatas em aberto
      description: >-
        Retorna lista de duplicatas em aberto, filtrando por data de vencimento
        e cliente (se informado)
      operationId: getPessoasDuplicatasAberto
      parameters:
        - name: cliente
          in: query
          description: Identificador único do usuário
          schema:
            type: string
            example: '1'
        - name: vencimentoInicial
          in: query
          description: Data inicial de vencimento das duplicatas
          required: true
          schema:
            type: string
            example: '2025-08-06'
        - name: vencimentoFinal
          in: query
          description: Data final de vencimento das duplicatas
          required: true
          schema:
            type: string
            example: '2025-08-06'
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: number
                      description: Identificador único da duplicata
                      example: 1
                    filialId:
                      type: number
                      description: Identificador da filial da duplicata
                      example: 1
                    filialNome:
                      type: string
                      description: Nome da filial da duplicata
                      example: Filial 1
                    emissao:
                      type: string
                      description: Data de emissão da duplicata
                      example: '2025-09-10'
                    vencimento:
                      type: string
                      description: Data de vencimento da duplicata
                      example: '2025-10-10'
                    valor:
                      type: number
                      format: float
                      description: Valor da duplicata
                      example: 1000
                    saldo:
                      type: number
                      format: float
                      description: Saldo da duplicata em aberto (valor devido)
                      example: 1000
                    numero:
                      type: string
                      description: Número da duplicata
                      example: '123456'
                    pedidoId:
                      type: string
                      description: Identificador do pedido relacionado à duplicata
                      example: '1'
                    clienteCodigo:
                      type: number
                      description: Código do cliente relacionado à duplicata
                      example: 1
                    clienteNome:
                      type: string
                      description: Nome do cliente relacionado à duplicata
                      example: Nome do Cliente
                    clienteFone:
                      type: string
                      description: Telefone do cliente relacionado à duplicata
                      example: '11912345678'
                    clienteCelular:
                      type: string
                      description: Celular do cliente relacionado à duplicata
                      example: '11912345678'
                    clienteEmail:
                      type: string
                      description: E-mail do cliente relacionado à duplicata
                      example: teste@softros.com.br
        '400':
          description: Parâmetros inválidos
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: >-
                      Os parâmetros vencimentoInicial e vencimentoFinal são
                      obrigatórios.
      security:
        - chaveApi: []
components:
  securitySchemes:
    chaveApi:
      description: Chave da API gerada no agulhão
      type: apiKey
      name: x-api-key
      in: header

````