> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Activar una obtención e ingesta manual desde un transporte externo > Lista cada objeto que coincide con las coordenadas de transporte proporcionadas (SFTP hoy) y transmite cada uno al pipeline de ingesta de contenido confiable (dedup + outbox + activación de coincidencia), devolviendo un resultado por archivo en orden de obtención. El tenant se resuelve del JWT y el contexto/fuente de la ruta — NUNCA del cuerpo. El cuerpo lleva coordenadas de conexión más una referencia de credencial OPACA, nunca un secreto. Un fallo de obtención a nivel de transporte (el endpoint externo es inalcanzable o rechaza la credencial) devuelve 503; los fallos de ingesta por archivo se reportan en el cuerpo de la respuesta sin fallar el lote. ## OpenAPI ````yaml es/openapi/v3-current/matcher.yaml post /v1/imports/contexts/{contextId}/sources/{sourceId}/fetch openapi: 3.1.0 info: title: Matcher APIs description: >- Referencia completa de la API para el motor de conciliación Matcher, que proporciona conciliación automatizada de transacciones entre Midaz Ledger y sistemas externos. version: 4.1.0 license: name: Elastic License 2.0 url: https://www.elastic.co/licensing/elastic-license servers: - url: https://matcher.sandbox.lerian.net security: [] paths: /v1/imports/contexts/{contextId}/sources/{sourceId}/fetch: post: tags: - Ingestion summary: Activar una obtención e ingesta manual desde un transporte externo description: >- Lista cada objeto que coincide con las coordenadas de transporte proporcionadas (SFTP hoy) y transmite cada uno al pipeline de ingesta de contenido confiable (dedup + outbox + activación de coincidencia), devolviendo un resultado por archivo en orden de obtención. El tenant se resuelve del JWT y el contexto/fuente de la ruta — NUNCA del cuerpo. El cuerpo lleva coordenadas de conexión más una referencia de credencial OPACA, nunca un secreto. Un fallo de obtención a nivel de transporte (el endpoint externo es inalcanzable o rechaza la credencial) devuelve 503; los fallos de ingesta por archivo se reportan en el cuerpo de la respuesta sin fallar el lote. operationId: fetchTrigger parameters: - description: Context ID in: path name: contextId required: true schema: description: ID del contexto format: uuid type: string - description: Source ID in: path name: sourceId required: true schema: description: ID de la fuente format: uuid type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/FetchTriggerRequest' required: true responses: '202': content: application/json: schema: $ref: '#/components/schemas/FetchTriggerResponse' description: Aceptado default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error security: - BearerAuth: [] components: schemas: FetchTriggerRequest: additionalProperties: false properties: connectOptions: additionalProperties: type: string description: >- Ajuste de transporte no secreto opcional (p. ej. known_hosts, user, timeout_seconds) type: object credentialRef: description: Referencia de credencial almacenada opaca (no un secreto) examples: - cred-handle-123 minLength: 1 type: string format: description: >- Sugerencia de formato de contenido de respaldo aplicada cuando un objeto obtenido no declara ninguno. Acepta la clave FormatDescriptor con espacio de nombres (región/familia/variante) o los alias planos heredados (cnab240, cielo_edi, ...); ambos se resuelven a través del mismo registro de parsers examples: - br/cnab240/febraban-base type: string glob: description: Filtro glob opcional; vacío obtiene todo examples: - '*.ret' type: string host: description: Nombre de host o IP del endpoint remoto examples: - sftp.bank.example minLength: 1 type: string kind: description: Tipo de transporte que selecciona el adaptador enum: - sftp - https - s3 - imap examples: - sftp type: string path: description: Directorio remoto del cual listar/obtener examples: - outbound/returns minLength: 1 type: string port: description: Puerto del endpoint remoto examples: - 22 format: int64 maximum: 65535 minimum: 1 type: integer required: - host - port - path - credentialRef type: object FetchTriggerResponse: additionalProperties: false properties: files: description: >- Resultados por archivo del lote de obtención e ingesta, en orden de obtención items: $ref: '#/components/schemas/FileOutcomeResponse' type: - array - 'null' required: - files type: object Detail: additionalProperties: false properties: code: description: >- Código de error de dominio estable y legible por máquina con alcance al servicio emisor (formato: -NNNN). examples: - ERR-0001 type: string detail: description: >- Una explicación legible por humanos específica de esta ocurrencia del problema. examples: - Property foo is required but is missing. type: string errors: description: Lista opcional de detalles de errores individuales items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- Una referencia URI que identifica la ocurrencia específica del problema. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: Código de estado HTTP examples: - 400 format: int64 type: integer title: description: >- Un resumen breve y legible por humanos del tipo de problema. Este valor no debería cambiar entre ocurrencias del error. examples: - Bad Request type: string type: default: about:blank description: >- Una referencia URI a documentación legible por humanos para el error. examples: - https://example.com/errors/example format: uri type: string type: object FileOutcomeResponse: additionalProperties: false properties: error: description: Mensaje de fallo de ingesta por archivo; vacío si tiene éxito examples: - '' type: string ingestionJobId: description: >- ID del trabajo de ingesta posterior; vacío cuando el objeto falló en la ingesta examples: - 550e8400-e29b-41d4-a716-446655440000 format: uuid type: string name: description: Nombre base del objeto obtenido examples: - statement-2025-06.ret type: string transactionCount: description: >- Número de transacciones ingestadas de este objeto; cero en caso de fallo examples: - 42 format: int64 type: integer required: - name - transactionCount type: object ErrorDetail: additionalProperties: false properties: location: description: >- Dónde ocurrió el error, p. ej. 'body.items[3].tags' o 'path.thing-id' type: string message: description: Texto del mensaje de error type: string value: description: El valor en la ubicación indicada type: object securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: 'Autenticación con token Bearer (formato: "Bearer {token}")' ````