> ## 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. # Proponer un mapeo de campos/dialecto solo de configuración para una muestra de origen > Inspecciona una muestra representativa de un archivo de origen y devuelve una propuesta de mapeo/dialecto SOLO DE CONFIGURACIÓN (sugerencias de columna→clave-canónica, dialecto, confianza y justificación por campo). Es CONSULTIVA y sin efectos secundarios: producir una propuesta NO PERSISTE NADA. El operador revisa la propuesta y la confirma a través de la ruta de declaración de mapeo de campos EXISTENTE. El tenant se resuelve del JWT y el contexto/fuente de la ruta — nunca del cuerpo. La respuesta nunca lleva valores parseados, importes ni transacciones. ## OpenAPI ````yaml es/openapi/v3-current/matcher.yaml post /v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal 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}/mapping-proposal: post: tags: - Ingestion summary: >- Proponer un mapeo de campos/dialecto solo de configuración para una muestra de origen description: >- Inspecciona una muestra representativa de un archivo de origen y devuelve una propuesta de mapeo/dialecto SOLO DE CONFIGURACIÓN (sugerencias de columna→clave-canónica, dialecto, confianza y justificación por campo). Es CONSULTIVA y sin efectos secundarios: producir una propuesta NO PERSISTE NADA. El operador revisa la propuesta y la confirma a través de la ruta de declaración de mapeo de campos EXISTENTE. El tenant se resuelve del JWT y el contexto/fuente de la ruta — nunca del cuerpo. La respuesta nunca lleva valores parseados, importes ni transacciones. operationId: proposeMapping 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/ProposeMappingRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/MappingProposalResponse' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error security: - BearerAuth: [] components: schemas: ProposeMappingRequest: additionalProperties: false properties: format: description: Sugerencia de formato de archivo declarado enum: - csv - json - xml - camt053 examples: - csv type: string hints: additionalProperties: type: string description: >- Sugerencias no secretas opcionales del operador (p. ej. locale=pt-BR, has_header=true) type: object sample: description: Muestra representativa de archivo de origen examples: - | id;value;ccy;posted_at A1;10,50;BRL;2025-06-01 minLength: 1 type: string required: - sample type: object MappingProposalResponse: additionalProperties: false properties: dialect: $ref: '#/components/schemas/DialectResponse' description: >- Dialecto de origen propuesto; null cuando el asesor no tiene sugerencia de dialecto fields: description: Desglose por campo que respalda el mapeo propuesto items: $ref: '#/components/schemas/FieldProposalResponse' type: - array - 'null' mapping: additionalProperties: {} description: >- Mapeo de campos canónico propuesto (clave canónica -> columna de origen); null cuando el asesor no pudo proponer un mapeo type: object required: - fields 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 DialectResponse: additionalProperties: false properties: dateStyle: description: >- Convención de fecha detectada: iso (YYYY-MM-DD), iso_offset (RFC 3339 con offset), dmy (DD/MM/YYYY) o mdy (MM/DD/YYYY) examples: - iso type: string decimalStyle: description: >- Convención decimal de importes detectada: punto (1234.56) o coma (1234,56) examples: - comma type: string delimiter: description: >- Separador de campos CSV detectado: coma, punto y coma, tabulación o barra vertical examples: - semicolon type: string encoding: description: >- Codificación de caracteres del archivo detectada: utf-8, utf-8-sig (UTF-8 con BOM), cp1252 (Windows Latin-1) o iso-8859-1 examples: - utf-8 type: string required: - encoding - delimiter - decimalStyle - dateStyle type: object FieldProposalResponse: additionalProperties: false properties: canonicalKey: description: Clave canónica de mapeo de campo a la que apunta la propuesta examples: - amount type: string confidence: description: Confianza del asesor en este mapeo, de 0.0 (ninguna) a 1.0 (certeza) examples: - 0.92 format: double maximum: 1 minimum: 0 type: number rationale: description: Explicación breve y legible por humanos de la sugerencia examples: - numeric column with comma decimal type: string sourceColumn: description: Columna de origen propuesta que alimenta la clave canónica examples: - value type: string required: - canonicalKey - sourceColumn - confidence - rationale 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}")' ````