> ## 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 cliente com o seu financeiro

> Retorna cliente específico com o seu financeiro (duplicatas em aberto)



## OpenAPI

````yaml /api-convertr/openapi.yaml get /pessoas/financeiro
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/financeiro:
    get:
      tags:
        - pessoas-cr
      summary: Retorna cliente com o seu financeiro
      description: Retorna cliente específico com o seu financeiro (duplicatas em aberto)
      operationId: getPessoasFinanceiro
      parameters:
        - name: id
          in: query
          description: Identificador único do usuário
          schema:
            type: string
            example: '1'
        - name: duplicataId
          in: query
          description: Identificador único da duplicata
          schema:
            type: string
            example: '1'
        - name: pedidoId
          in: query
          description: Identificador único do pedido
          schema:
            type: string
            example: '1'
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      description: Identificador único do usuário
                      example: '1'
                    razaoSocial:
                      type: string
                      description: Razão social do usuário
                      example: RAZÃO SOCIAL DA EMPRESA
                    documento:
                      type: string
                      description: CNPJ ou CPF do usuário
                      example: '00000000000000'
                    fantasia:
                      type: string
                      description: Nome fantasia do usuário
                      example: FANTASIA DA EMPRESA
                    email:
                      type: string
                      description: E-mail do usuário
                      example: contato@empresa.com
                    telefone:
                      type: string
                      description: Telefone do usuário
                      example: '1112345678'
                    celular:
                      type: string
                      description: Celular do usuário
                      example: '11912345678'
                    ultimaAtualizacao:
                      type: string
                      format: date-time
                      description: Data da última atualização do usuário
                      example: '2025-01-01T00:00:00'
                    endereco:
                      type: object
                      properties:
                        cidadeId:
                          type: string
                          description: Identificador da cidade do endereço (Código IBGE)
                          example: '1'
                        cidadeNome:
                          type: string
                          description: Nome da cidade do endereço
                          example: São Paulo
                        uf:
                          type: string
                          description: Sigla da unidade federativa do endereço
                          example: SP
                        cep:
                          type: string
                          description: CEP do endereço
                          example: '01000000'
                        logradouro:
                          type: string
                          description: Logradouro do endereço
                          example: Avenida Paulista
                        numero:
                          type: string
                          description: Número do endereço
                          example: '1000'
                        complemento:
                          type: string
                          description: Complemento do endereço
                          example: Apto 101
                        bairro:
                          type: string
                          description: Bairro do endereço
                          example: Bela Vista
                    duplicatas:
                      type: array
                      items:
                        type: object
                        properties:
                          id:
                            type: string
                            description: Identificador único da duplicata
                            example: '1'
                          filialId:
                            type: string
                            description: Identificador da filial da duplicata
                            example: '1'
                          filialNome:
                            type: string
                            description: Nome da filial da duplicata
                            example: Filial 1
                          emissao:
                            type: string
                            format: date-time
                            description: Data de emissão da duplicata
                            example: '2025-01-01T00:00:00'
                          vencimento:
                            type: string
                            format: date-time
                            description: Data de vencimento da duplicata
                            example: '2025-02-01T00:00:00'
                          numero:
                            type: string
                            description: Número da duplicata
                            example: '123456'
                          localCobrancaId:
                            type: string
                            description: Identificador do local de cobrança da duplicata
                            example: '1'
                          valor:
                            type: number
                            format: float
                            description: Valor da duplicata
                            example: 1000
                          saldo:
                            type: number
                            format: float
                            description: Saldo da duplicata
                            example: 500
                          diasAtrasado:
                            type: integer
                            description: Dias de atraso da duplicata
                            example: 10
                          diasVencer:
                            type: integer
                            description: Dias para vencer da duplicata
                            example: 5
        '400':
          description: Parâmetros inválidos
          content:
            application/json:
              schema:
                type: object
                properties:
                  mensagem:
                    type: string
                    example: >-
                      Parâmetros inválidos. Informe o id da pessoa, duplicataId
                      ou pedidoId.
        '404':
          description: Usuário não encontrado
          content:
            application/json:
              schema:
                type: object
                properties:
                  mensagem:
                    type: string
                    example: Pessoa não encontrada.
        '500':
          description: Erro interno do servidor
          content:
            application/json:
              schema:
                type: object
                properties:
                  mensagem:
                    type: string
                    example: Erro ao buscar financeiro da pessoa.
      security:
        - chaveApi: []
components:
  securitySchemes:
    chaveApi:
      description: Chave da API gerada no agulhão
      type: apiKey
      name: x-api-key
      in: header

````