> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.nufi.mx/llms.txt
> Use this file to discover all available pages before exploring further.

# Seguimiento

Consultar el seguimiento del expediente de un cliente y visualizar el estado del enrolamiento de cada persona.

## 📌 Campos de la respuesta

### 1️⃣ DocumentStatus

Indica la etapa actual del **expediente completo** dentro del flujo operativo.

```text theme={null}
"DocumentStatus": "Pendiente"
```

### 📊 Estados del Expediente

| Estatus                   | Descripción                                                                                  | Responsable     | ¿Es estado final? |
| ------------------------- | -------------------------------------------------------------------------------------------- | --------------- | ----------------- |
| Ingresado                 | Estado inicial del expediente. El usuario está capturando información y cargando documentos. | Usuario final   | ❌                 |
| Pendiente                 | El expediente fue enviado para revisión y está en bandeja de Mesa de Control.                | Sistema         | ❌                 |
| En Revisión               | Un analista está validando la información y documentos.                                      | Mesa de Control | ❌                 |
| Corrección por el Usuario | Se detectaron inconsistencias y se regresó al usuario para ajustes.                          | Usuario         | ❌                 |
| Enrolamiento Iniciado     | Se detonó el proceso de enrolamiento (biometría, validaciones externas, etc.).               | Mesa de Control | ❌                 |
| Enrolamiento Fallido      | El proceso de enrolamiento no se completó correctamente.                                     | Sistema         | ❌                 |
| Aceptado                  | El expediente fue aprobado satisfactoriamente.                                               | Mesa de Control | ✅                 |
| Finalizado                | El expediente se cerró sin completar el proceso exitosamente.                                | Mesa de Control | ✅                 |

### 2️⃣ Comments

El campo **Comments** devuelve un arreglo de strings que representan:

* El nombre de la sección.
* El estatus actual de esa sección (entre paréntesis).
* Si la sección cuenta con comentarios, se agregarán con 2 puntos y a la derecha los comentarios que presente.

```text theme={null}
"Comments": [
  "Info. Fiscal (Rechazado): La CSF no pertenece al cliente",
  "Personas Físicas (Completado)"
]
```

📌 El estatus entre paréntesis corresponde al estado individual de cada sección del expediente.

### 📊 Estados de Sección (Entre Paréntesis en Comments)

| Estatus           | Descripción                                                    | Tipo de Validación                   | ¿Requiere Acción del Usuario? |
| ----------------- | -------------------------------------------------------------- | ------------------------------------ | ----------------------------- |
| Pendiente         | Estado inicial. La sección no ha sido completada ni enviada.   | Ninguna                              | ✅                             |
| En Revisión       | El sistema está ejecutando validaciones automáticas.           | OCR, metadata, APIs externas         | ❌                             |
| Requiere Atención | Falló alguna validación automática.                            | OCR fallido, inconsistencia de datos | ✅                             |
| Completado        | Validaciones automáticas exitosas. Lista para revisión humana. | Validaciones automáticas aprobadas   | ❌                             |
| Aceptado          | Aprobación final por back office.                              | Revisión humana aprobada             | ❌                             |
| Rechazado         | Rechazo definitivo por back office.                            | Revisión humana rechazada            | ✅                             |


## OpenAPI

````yaml POST /expedientes/v1/tracking
openapi: 3.0.0
info:
  title: KYB API
  version: 1.0.0
servers:
  - url: https://nufi.azure-api.net/kyb
    description: Productivo
  - url: https://nufi.azure-api.net/kyb/dev
    description: Sandbox
  - url: https://nufi-kyb-services-staging-azurefunction.azurewebsites.net/api
    description: Staging
security: []
paths:
  /expedientes/v1/tracking:
    post:
      tags:
        - default
      summary: tracking
      operationId: getTracking
      parameters:
        - name: NUFI-API-KEY
          in: header
          required: true
          schema:
            type: string
          example: '{{NUFI_API_KEY}}'
        - name: X-Workspace
          in: header
          required: true
          schema:
            type: string
          example: '{{WORKSPACE_ID}}'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - FlowID
                - RFC
                - AgentMail
              properties:
                FlowID:
                  type: string
                RFC:
                  type: string
                AgentMail:
                  type: string
            examples:
              default:
                value:
                  FlowID: f-001
                  RFC: NUF201221PC7
                  AgentMail: ejecutivo@correo.com
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  Code:
                    type: integer
                    example: 200
                  Status:
                    type: string
                    example: Success
                  Message:
                    type: string
                    example: Seguimiento obtenido
                  Data:
                    type: object
                    properties:
                      DocumentId:
                        type: string
                        example: eaeea393-81db-4269-9dcc-ede8669f2ecf
                      CompanyRfc:
                        type: string
                        example: NUF201221PC7
                      CompanyName:
                        type: string
                        example: NUFI SAPI DE CV
                      GuestUrl:
                        type: string
                        example: >-
                          https://kyb.nufi.mx/guest/Q0JiWmc3aWJNNm1sMVNwSnBOU0x1eis1NGRQWEMxT1Y1OGNGM21Tck9TUT0
                      ChannelName:
                        type: string
                        example: MESA CONTROL
                      DocumentStatus:
                        type: string
                        example: Pendiente
                      Comments:
                        type: array
                        items:
                          type: string
                        example:
                          - >-
                            Info. Fiscal (Rechazado): La CSF no pertenece al
                            cliente
                          - Personas Físicas (Completado)
                      CreatedAtUtc:
                        type: string
                        format: date-time
                        example: '2026-02-25T16:40:12.000Z'
                      UpdatedAtUtc:
                        type: string
                        format: date-time
                        example: '2026-02-25T16:40:12.000Z'
                      Person:
                        type: array
                        items:
                          type: object
                          properties:
                            PersonId:
                              type: string
                              example: 7c1cf3c0-9c2c-4c66-9b34-6b5f4c6c9a1e
                            FullName:
                              type: string
                              example: ILICH NUÑEZ SANCHEZ
                            Email:
                              type: string
                              format: email
                              example: ilich@nufi.mx
                            Rfc:
                              type: string
                              example: NUSI900824LY3
                            Curp:
                              type: string
                              example: NUSI900824HSRXNL03
                            FaceKeyId:
                              type: string
                              example: T000083729
                            EnrollmentRequestAtUtc:
                              type: string
                              format: date-time
                              example: '2026-02-19T23:25:56.767Z'
                            CallbackAtUtc:
                              type: string
                              format: date-time
                              example: '2026-02-19T23:26:20.421Z'
                            NotificationAtUtc:
                              type: string
                              format: date-time
                              example: '2026-02-20T00:58:08.639Z'
                            EnrollmentStatus:
                              type: string
                              example: AUTORIZADO
                            EnrollmentReason:
                              type: string
                              example: ''
                            IsCompleted:
                              type: boolean
                              example: true
                            IsEnrollmentAllowed:
                              type: boolean
                              example: false
              examples:
                success:
                  value:
                    Code: 200
                    Status: Success
                    Message: Seguimiento obtenido
                    Data:
                      DocumentId: eaeea393-81db-4269-9dcc-ede8669f2ecf
                      CompanyRfc: NUF201221PC7
                      CompanyName: NUFI SAPI DE CV
                      GuestUrl: >-
                        https://kyb.nufi.mx/guest/Q0JiWmc3aWJNNm1sMVNwSnBOU0x1eis1NGRQWEMxT1Y1OGNGM21Tck9TUT0
                      ChannelName: MESA CONTROL
                      DocumentStatus: Pendiente
                      Comments:
                        - >-
                          Info. Fiscal (Rechazado): La CSF no pertenece al
                          cliente
                        - Personas Físicas (Completado)
                      CreatedAtUtc: '2026-02-25T16:40:12.000Z'
                      UpdatedAtUtc: '2026-02-25T16:40:12.000Z'
                      Person:
                        - PersonId: 7c1cf3c0-9c2c-4c66-9b34-6b5f4c6c9a1e
                          FullName: ILICH NUÑEZ SANCHEZ
                          Email: ilich@nufi.mx
                          Rfc: NUSI900824LY3
                          Curp: NUSI900824HSRXNL03
                          FaceKeyId: T000083729
                          EnrollmentRequestAtUtc: '2026-02-19T23:25:56.767Z'
                          CallbackAtUtc: '2026-02-19T23:26:20.421Z'
                          NotificationAtUtc: '2026-02-20T00:58:08.639Z'
                          EnrollmentStatus: AUTORIZADO
                          EnrollmentReason: ''
                          IsCompleted: true
                          IsEnrollmentAllowed: false
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  Code:
                    type: integer
                    example: 400
                  Status:
                    type: string
                    example: bad_request
                  Message:
                    type: string
                    example: Error de validacion
                  Data:
                    type: array
                    items:
                      type: string
              examples:
                validationError:
                  value:
                    Code: 400
                    Status: bad_request
                    Message: Error de validacion
                    Data:
                      - El campo FlowId es obligatorio
                      - El campo RFC es obligatorio
                      - El campo AgentMail es obligatorio
                      - El FlowId no es válido.
                      - El RFC no es válido.
                      - El AgentMail no es válido.
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    example: 401
                  status:
                    type: string
                    example: forbidden
                  message:
                    type: string
                  data:
                    nullable: true
              examples:
                unauthorized:
                  value:
                    code: 401
                    status: forbidden
                    message: >-
                      La API Key ha sido denegada, asegurate de mandar una API
                      Key valida y con una suscripción activa
                    data: null
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  Code:
                    type: integer
                    example: 403
                  Status:
                    type: string
                    example: forbidden
                  Message:
                    type: string
                  Data:
                    nullable: true
              examples:
                forbidden:
                  value:
                    Code: 403
                    Status: forbidden
                    Message: El ID de Workspace no es válido o no está activo
                    Data: null
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  Code:
                    type: integer
                    example: 404
                  Status:
                    type: string
                    example: not_found
                  Message:
                    type: string
                  Data:
                    nullable: true
              examples:
                notFound:
                  value:
                    Code: 404
                    Status: not_found
                    Message: Expediente no encontrado
                    Data: null

````