# Retornar a pessoa por legacyid

Esse endpoint existe para garantir compatibilidade entre a API antiga (V1 legada) e a API nova de Pessoas. Quando você faz requisições na API nova, cada pessoa passa a ter um UUID, que é o novo identificador usado pelo ERP e pelas integrações atuais. Ao mesmo tempo, algumas aplicações antigas ainda usam o id_legado, que era o identificador utilizado na API V1. Importante saber - Relação entre os IDs: uuid → ID novo da pessoa (padrão atual), id_legado → ID antigo, usado na primeira versão da API.

Endpoint: GET /v1/pessoas/legado/{id}
Version: v1
Security: BearerAuth

## Security:

  - `BearerAuth` (unknown)
    apiKey in header Authorization

## Path parameters:

  - `id` (string, required)
    legacyId da pessoa

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `ativo` (boolean)
    Ativo
    Example: true

  - `atrasos_pagamentos` (number)
    Atrasos nos pagamentos
    Example: 750.25

  - `atrasos_recebimentos` (number)
    Atrasos nos recebimentos
    Example: 1500.5

  - `codigo` (string)
    Código da pessoa
    Example: CLI001

  - `contato_cobranca_faturamento` (object)
    Contato para cobrança e faturamento

  - `contato_cobranca_faturamento.emails` (array)
    Email do contato de cobrança e faturamento
    Example: ["carlos.oliveira@email.com","joao.silva@email.com"]

  - `contato_cobranca_faturamento.whatsapp` (string)
    Telefone do contato de cobrança e faturamento
    Example: 5511999999999

  - `criado_em` (string)
    Data de criação da pessoa (ISO 8601, São Paulo/GMT-3)
    Example: 2024-01-15

  - `data_alteracao` (string)
    Data de alteração da pessoa (ISO 8601, São Paulo/GMT-3)
    Example: 2024-01-15T10:30:00

  - `data_nascimento` (string)
    Data de nascimento
    Example: 1990-01-01

  - `documento` (string)
    Documento da pessoa
    Example: 123.456.789-00

  - `email` (string)
    Emails da pessoa separados por vírgula
    Example: joao.silva@email.com, maria.silva@email.com

  - `enderecos` (array)
    Endereços da pessoa

  - `enderecos.bairro` (string)
    Bairro do endereço
    Example: Centro

  - `enderecos.cep` (string)
    CEP do endereço
    Example: 12345-678

  - `enderecos.cidade` (string)
    Cidade do endereço
    Example: São Paulo

  - `enderecos.complemento` (string)
    Complemento do endereço
    Example: Apto 45

  - `enderecos.estado` (string)
    Estado do endereço
    Example: SP

  - `enderecos.id` (string)
    ID do endereço
    Example: 550e8400-e29b-41d4-a716-446655440000

  - `enderecos.id_cidade` (integer)
    ID da cidade
    Example: 3550308

  - `enderecos.logradouro` (string)
    Logradouro do endereço
    Example: Rua das Flores

  - `enderecos.numero` (string)
    Número do endereço
    Example: 123

  - `enderecos.pais` (string)
    País do endereço
    Example: Brasil

  - `id` (string)
    ID da pessoa
    Example: 550e8400-e29b-41d4-a716-446655440000

  - `inscricoes` (array)
    Informações fiscais

  - `inscricoes.id` (string)
    ID da informação fiscal
    Example: 550e8400-e29b-41d4-a716-446655440000

  - `inscricoes.indicador_inscricao_estadual` (string)
    Indicador de inscrição estadual
    Enum: "NAO CONTRIBUINTE", "CONTRIBUINTE", "ISENTO"

  - `inscricoes.inscricao_estadual` (string)
    Inscrição estadual
    Example: 123456789

  - `inscricoes.inscricao_municipal` (string)
    Inscrição municipal
    Example: 12345678901234

  - `inscricoes.inscricao_suframa` (string)
    Inscrição SUFRAMA
    Example: 123456789

  - `lembretes_vencimento` (array)
    Lembretes de vencimento

  - `lembretes_vencimento.ativo` (boolean)
    Status do lembrete de vencimento
    Example: true

  - `lembretes_vencimento.email` (string)
    Email do lembrete de vencimento
    Example: lembrete@email.com

  - `lembretes_vencimento.id` (string)
    ID do lembrete de vencimento
    Example: 550e8400-e29b-41d4-a716-446655440000

  - `mensagem_pagamentos_abertos` (object)
    Mensagens de pagamentos em aberto

  - `mensagem_pagamentos_abertos.numero` (integer)
    Número de mensagens de pagamentos em aberto
    Example: 10

  - `mensagem_pagamentos_abertos.total` (integer)
    Total de mensagens de pagamentos em aberto
    Example: 10

  - `nome` (string)
    Nome da pessoa
    Example: João Silva

  - `nome_empresa` (string)
    Nome da empresa
    Example: Empresa LTDA

  - `observacao` (string)
    Observações gerais da pessoa
    Example: Observação geral

  - `optante_simples_nacional` (boolean)
    Optante do Simples Nacional
    Example: true

  - `orgao_publico` (boolean)
    Órgão público
    Example: true

  - `outros_contatos` (array)
    Outros contatos

  - `outros_contatos.cargo` (string)
    Escritório do contato
    Example: Escritório Central

  - `outros_contatos.email` (string)
    Email do contato
    Example: maria.silva@email.com

  - `outros_contatos.id` (string)
    ID do contato
    Example: 550e8400-e29b-41d4-a716-446655440000

  - `outros_contatos.nome` (string)
    Nome do contato
    Example: Maria Silva

  - `outros_contatos.telefone_celular` (string)
    Celular do contato
    Example: 11987654321

  - `outros_contatos.telefone_comercial` (string)
    Telefone comercial do contato
    Example: 1112345678

  - `pagamentos_mes_atual` (number)
    Pagamentos do mês atual
    Example: 2500

  - `perfis` (array)
    Perfis da pessoa

  - `perfis.tipo_perfil` (string)
    Tipo de perfil: Cliente, Fornecedor ou Transportadora
    Enum: "Cliente", "Fornecedor", "Transportadora"

  - `pessoas_legado` (array)
    Pessoas legadas

  - `pessoas_legado.id` (integer)
    ID da pessoa legada
    Example: 12345

  - `pessoas_legado.perfil` (string)
    Perfil da pessoa legada
    Example: CLIENTE

  - `pessoas_legado.uuid` (string)
    UUID da pessoa legada
    Example: 550e8400-e29b-41d4-a716-446655440000

  - `recebimentos_mes_atual` (number)
    Recebimentos do mês atual
    Example: 5000

  - `rg` (string)
    Registro Geral (RG) da pessoa. Para pessoas estrangeiras, este campo representa o identificador estrangeiro.
    Example: 12.345.678-9

  - `telefone_celular` (string)
    Celular da pessoa
    Example: (11) 98765-4321

  - `telefone_comercial` (string)
    Telefone comercial da pessoa
    Example: (11) 1234-5678

  - `tipo_pessoa` (string)
    Tipo de pessoa
    Example: FISICA

## Response 400:

  - `400` (unknown)
    Bad Request

## Response 400 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: Mensagem de erro detalhada

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: Mensagem de erro detalhada

## Response 404:

  - `404` (unknown)
    Not Found

## Response 404 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: Mensagem de erro detalhada

## Response 429:

  - `429` (unknown)
    Too Many Requests

## Response 429 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: Mensagem de erro detalhada

## Response 500:

  - `500` (unknown)
    Internal Server Error

## Response 500 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: Mensagem de erro detalhada