# Retornar o contrato por id

Recupera os detalhes de um contrato específico por ID. Útil quando quiser exibir ou sincronizar todos os dados de um contrato específico.

Endpoint: GET /v1/contratos/{id}
Version: v1
Security: BearerAuth

## Path parameters:

  - `id` (string, required)
    ID do contrato (UUID)

## Response 200 fields (application/json):

  - `cliente` (object)
    Resumo dos dados do cliente vinculado ao contrato

  - `cliente.id` (string)
    ID do cliente
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `cliente.nome` (string)
    Nome do cliente
    Example: "João da Silva"

  - `composicao_valor` (object)
    Resumo da composição de valores do contrato

  - `composicao_valor.desconto` (number)
    Valor do desconto aplicado
    Example: 200

  - `composicao_valor.frete` (number)
    Valor do frete
    Example: 50

  - `composicao_valor.valor_bruto` (number)
    Valor bruto do contrato
    Example: 1200

  - `composicao_valor.valor_impostos_servico` (number)
    Valor total dos impostos sobre o serviço
    Example: 100

  - `composicao_valor.valor_liquido` (number)
    Valor líquido do contrato
    Example: 1050

  - `condicao_pagamento` (object)
    Resumo das condições de pagamento do contrato

  - `condicao_pagamento.dia_vencimento` (integer)
    Dia do mês para vencimento do pagamento
    Example: 15

  - `condicao_pagamento.nome_conta_financeira` (string)
    Nome da conta financeira vinculada ao pagamento
    Example: "Conta Corrente"

  - `condicao_pagamento.observacoes_pagamento` (string)
    Observações sobre o pagamento
    Example: "Pagamento mensal"

  - `condicao_pagamento.tipo_pagamento` (string)
    Tipo de pagamento do contrato
    Enum: "BOLETO_BANCARIO", "CARTAO_CREDITO", "CARTAO_DEBITO", "CARTEIRA_DIGITAL", "CASHBACK", "CHEQUE", "CREDITO_LOJA", "CREDITO_VIRTUAL", "DEPOSITO_BANCARIO", "DINHEIRO", "OUTRO", "DEBITO_AUTOMATICO", "LINK_PAGAMENTO", "PIX_PAGAMENTO_INSTANTANEO", "COBRANCA_PIX", "PROGRAMA_FIDELIDADE", "SEM_PAGAMENTO", "TRANSFERENCIA_BANCARIA", "VALE_ALIMENTACAO", "VALE_COMBUSTIVEL", "VALE_PRESENTE", "VALE_REFEICAO"

  - `configuracao_recorrencia` (object)
    Resumo da configuração de recorrência do contrato

  - `configuracao_recorrencia.vigencia_restante` (integer)
    Vigência restante do contrato
    Example: 12

  - `configuracao_recorrencia.vigencia_total` (integer)
    Vigência total do contrato
    Example: 24

  - `data_proxima_emissao` (string)
    Data da próxima emissão
    Example: "2026-09-15"

  - `data_proximo_vencimento` (string)
    Data do próximo vencimento
    Example: "2026-09-15"

  - `data_ultima_emissao` (string)
    Data da última emissão
    Example: "2026-08-15"

  - `id` (string)
    ID do contrato
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `id_proxima_venda_agendada` (string)
    ID da próxima venda agendada
    Example: "123e4567-e89b-12d3-a456-426614174002"

  - `id_ultima_venda_confirmada` (string)
    ID da última venda confirmada
    Example: "123e4567-e89b-12d3-a456-426614174001"

  - `local_prestacao_servico` (object)
    Resumo do local de prestação de serviço do contrato

  - `local_prestacao_servico.nome` (string)
    Nome do local de prestação de serviço
    Example: "Escritório Central"

  - `observacoes` (string)
    Observações adicionais sobre o contrato
    Example: "Contrato de venda recorrente para serviços de consultoria."

  - `status` (string)
    Status do contrato
    Enum: "ATIVO", "INATIVO", "DELETADO"

  - `termos` (object)
    Resumo dos termos do contrato

  - `termos.data_fim` (string)
    Data de término do contrato
    Example: "2026-10-21"

  - `termos.data_inicio` (string)
    Data de início do contrato
    Example: "2026-08-15"

  - `termos.dia_emissao_venda` (integer)
    Dia do mês para emissão da venda
    Example: 15

  - `termos.intervalo_frequencia` (integer)
    Intervalo entre as cobranças (ex: a cada 1 mês)
    Example: 1

  - `termos.numero` (integer)
    Número do contrato
    Example: 1

  - `termos.tipo_expiracao` (string)
    Tipo de expiração do contrato
    Enum: "DATA", "VEZES", "NUNCA"

  - `termos.tipo_frequencia` (string)
    Tipo de frequência de cobrança
    Enum: "MENSAL", "SEMANAL", "ANUAL"

  - `vendedor` (object)
    Resumo dos dados do vendedor responsável pelo contrato

  - `vendedor.id` (string)
    ID do vendedor
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `vendedor.nome` (string)
    Nome do vendedor
    Example: "Maria Oliveira"

## Response 400 fields (application/json):

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