Proponer un mapeo de campos/dialecto solo de configuración para una muestra de origen

curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sample": "<string>",
  "hints": {}
}
'

import requests

url = "https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal"

payload = {
    "sample": "<string>",
    "hints": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({sample: '<string>', hints: {}})
};

fetch('https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'sample' => '<string>',
    'hints' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal"

	payload := strings.NewReader("{\n  \"sample\": \"<string>\",\n  \"hints\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"sample\": \"<string>\",\n  \"hints\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"sample\": \"<string>\",\n  \"hints\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "fields": [
    {
      "canonicalKey": "<string>",
      "confidence": 0.5,
      "rationale": "<string>",
      "sourceColumn": "<string>"
    }
  ],
  "dialect": {
    "dateStyle": "<string>",
    "decimalStyle": "<string>",
    "delimiter": "<string>",
    "encoding": "<string>"
  },
  "mapping": {}
}

{
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

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.

POST

imports

contexts

{contextId}

sources

{sourceId}

mapping-proposal

Proponer un mapeo de campos/dialecto solo de configuración para una muestra de origen

curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sample": "<string>",
  "hints": {}
}
'

import requests

url = "https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal"

payload = {
    "sample": "<string>",
    "hints": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({sample: '<string>', hints: {}})
};

fetch('https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'sample' => '<string>',
    'hints' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal"

	payload := strings.NewReader("{\n  \"sample\": \"<string>\",\n  \"hints\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"sample\": \"<string>\",\n  \"hints\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"sample\": \"<string>\",\n  \"hints\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "fields": [
    {
      "canonicalKey": "<string>",
      "confidence": 0.5,
      "rationale": "<string>",
      "sourceColumn": "<string>"
    }
  ],
  "dialect": {
    "dateStyle": "<string>",
    "decimalStyle": "<string>",
    "delimiter": "<string>",
    "encoding": "<string>"
  },
  "mapping": {}
}

{
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

Autorizaciones

Authorization

string

header

requerido

Autenticación con token Bearer (formato: "Bearer {token}")

Parámetros de ruta

contextId

string<uuid>

requerido

Context ID ID del contexto

sourceId

string<uuid>

requerido

Source ID ID de la fuente

Cuerpo

application/json

sample

string

requerido

Muestra representativa de archivo de origen

Minimum string length: 1

Ejemplo:

"id;value;ccy;posted_at\nA1;10,50;BRL;2025-06-01\n"

format

enum<string>

Sugerencia de formato de archivo declarado

Opciones disponibles:

csv,

json,

xml,

camt053

Ejemplo:

"csv"

hints

object

Sugerencias no secretas opcionales del operador (p. ej. locale=pt-BR, has_header=true)

Show child attributes

Respuesta

fields

object[] | null

requerido

Desglose por campo que respalda el mapeo propuesto

Show child attributes

dialect

object

Dialecto de origen propuesto; null cuando el asesor no tiene sugerencia de dialecto

Show child attributes

mapping

object

Mapeo de campos canónico propuesto (clave canónica -> columna de origen); null cuando el asesor no pudo proponer un mapeo

Show child attributes

⌘I

Primeros pasos

API de Contextos de Configuración

API de Reglas de Coincidencia

API de Fuentes

API de Mapeo de Campos

API de Tablas de Tarifas

API de Configuración de Reglas de Tarifas

API de Programaciones

Flujo de excepciones

Acciones masivas

Comentarios

Credenciales de callback

API de Disputas

API de Trabajos de Exportación

API de Gobernanza

Trabajos de ingestión

Diseños y formatos

Revisiones de extracción

Extracción de documentos

Ejecuciones de matching

Matching manual y ajustes

Candidatos y partidas abiertas

Sugerencias de reglas

Panel y métricas

Informes

Exportaciones

Estado del descubrimiento

Conexiones de descubrimiento

Extracciones

Conexiones de agregadores

Webhooks de agregadores

Manejo de errores

Proponer un mapeo de campos/dialecto solo de configuración para una muestra de origen

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta