# Consulta um processo por np e codvalid

Este endpoint permite consultar um processo específico utilizando o número do processo (nP) e o código validador (codValid).

Endpoint: POST /hub-api/process/get-by-np
Security: InternalAuth

## Request fields (application/json):

  - `nP` (string, required)
    Número do processo
    Example: "337-25-pro-alv"

  - `codValid` (string, required)
    Código validador
    Example: "ckusqxyx"

## Response 200 fields (application/json):

  - `id` (string)
    Identificador único do processo
    Example: "507f1f77bcf86cd799439011"

  - `nP` (string)
    Número do processo
    Example: "123-25-PRO-EXE"

  - `cod_valid` (string)
    Código validador do processo
    Example: "abc12xyz"

  - `from` (object)
    Informações do criador do processo

  - `from.userID` (string)
    Example: "auth0|123456789abcdef012345678"

  - `configMetadata` (object)
    Metadados da configuração do processo

  - `configMetadata.title` (string)
    Título da configuração
    Example: "Alvará de Construção"

  - `configMetadata.id` (string)
    ID da configuração
    Example: "507f191e810c19729de860ea"

  - `lastVersion` (object)
    Última versão do processo com todos os dados e campos preenchidos

  - `lastVersion.from` (object)

  - `lastVersion.from.type` (string)
    Example: "user"

  - `lastVersion.from.label` (string)
    Example: "João da Silva Santos"

  - `lastVersion.from.value` (string)
    Example: "auth0|123456789abcdef012345678"

  - `lastVersion.from.accessLevel` (string)
    Example: "FULL"

  - `lastVersion.proprietario` (array)
    Example: []

  - `lastVersion.destinatario` (array)
    Example: [{"sector_type":"sector","value":"setor_urbanismo","label":"Setor de Urbanismo","id":"507f191e810c19729de860ea"}]

  - `lastVersion.destinatario.sector_type` (string)
    Example: "sector"

  - `lastVersion.destinatario.value` (string)
    Example: "setor_urbanismo"

  - `lastVersion.destinatario.label` (string)
    Example: "Setor de Urbanismo"

  - `lastVersion.destinatario.id` (string)
    Example: "507f191e810c19729de860ea"

  - `lastVersion.refinamento` (object)
    Example: {"area_construcao":150.5}

  - `lastVersion.cpf_cnpj` (string)
    Example: "123.456.789-00"

  - `lastVersion.created_at_iso` (string)
    Example: "2025-10-15T14:30:00.000Z"

  - `lastVersion.created_at` (string)
    Example: "15/10/2025 11:30:00"

  - `lastVersion.hasSensitiveField` (boolean)
    Example: true

  - `createdAt` (string)
    Data de criação do processo
    Example: "15/10/2025 09:30:00"

  - `timeline` (array)
    Linha do tempo com todos os eventos do processo
    Example: [{"from":{"userId":"auth0|123456789abcdef012345678","name":"João da Silva Santos","asSector":null},"class":"user","type":"evento","data":{"action":"Processo criado"},"date":"15/10/2025 09:30:00","created_at_iso":"2025-10-15T12:30:00.000Z"},{"from":{"userId":"Desconhecido","name":"Desconhecido/Evento Automático"},"to":{"name":"Setor de Urbanismo","userId":"setor_urbanismo"},"class":"prefeituraEncaminha","type":"evento","data":{"action":"Processo encaminhado com acesso total para Setor de Urbanismo"},"date":"15/10/2025 09:30:15","created_at_iso":"2025-10-15T12:30:15.000Z"},{"class":"message","type":"evento","data":{"action":"Documento de Aprovação emitido"},"from":{"userId":"auth0|987654321fedcba987654321","name":"Maria Oliveira Costa"},"date":"16/10/2025 14:20:00","created_at_iso":"2025-10-16T17:20:00.000Z"}]

  - `timeline.from` (object)

  - `timeline.from.userId` (string)
    Example: "auth0|123456789abcdef012345678"

  - `timeline.from.name` (string)
    Example: "João da Silva Santos"

  - `timeline.from.asSector` (string,null)

  - `timeline.class` (string)
    Classe do evento (user, prefeituraEncaminha, message, despacho, analise, deadline)
    Example: "user"

  - `timeline.type` (string)
    Tipo do evento
    Example: "evento"

  - `timeline.data` (object)

  - `timeline.data.action` (string)
    Descrição da ação executada
    Example: "Processo criado"

  - `timeline.date` (string)
    Example: "15/10/2025 09:30:00"

  - `timeline.created_at_iso` (string)
    Example: "2025-10-15T12:30:00.000Z"

## Response 400 fields (application/json):

  - `error` (string)
    Example: "Invalid NP"

  - `message` (string)
    Example: "Número de processo inválido"

## Response 401 fields (application/json):

  - `error` (string)
    Example: "Unauthorized"

  - `message` (string)
    Example: "API Key is required"

## Response 404 fields (application/json):

  - `error` (string)
    Example: "Process not found"

  - `message` (string)
    Example: "Processo não encontrado"