Fuentes externas

Una fuente externa es el sistema del que Nodda extrae datos. Este endpoint lista las fuentes disponibles y los scopes que soporta cada una — útil para saber qué external_source_code y qué scopes usar al crear una conexión.

Listar fuentes

GET /external-sources

Endpoint público — no requiere autenticación. Acepta filtros opcionales por query:

Query	Tipo	Notas
`country`	string	filtra por país (p. ej. `CL`)
`type`	string	filtra por tipo (p. ej. `tax_authority`)
`is_active`	boolean	filtra por estado activo

curl https://app.nodda.cl/api/external-sources

Respuesta (200):

{
  "data": [
    {
      "code": "sii",
      "name": "SII",
      "type": "tax_authority",
      "country": "CL",
      "is_active": true,
      "supported_scopes": ["rcv", "guias"],
      "scopes": [
        {
          "name": "rcv",
          "label": "RCV (Registro de Compras y Ventas)",
          "sync_metadata": {
            "period": { "type": "string", "description": "Período YYYY-MM" }
          },
          "data_path_template": "/api/connections/{connection_id}/sii-rcv-documents",
          "filters": ["period", "direction", "from", "to", "limit", "offset"]
        },
        {
          "name": "guias",
          "label": "Guías de despacho",
          "sync_metadata": {
            "period": { "type": "string", "description": "Período YYYY-MM" },
            "issueType": { "type": "string", "enum": ["issued", "received"], "description": "Tipo de documentos (opcional)" }
          },
          "data_path_template": "/api/connections/{connection_id}/sii-dispatch-guides",
          "filters": ["period", "direction", "from", "to", "q", "limit", "offset"]
        }
      ],
      "metadata": { "credentialModes": ["portal_credentials", "certificate"] }
    },
    {
      "code": "banco_security",
      "name": "Banco Security",
      "type": "bank",
      "country": "CL",
      "is_active": true,
      "supported_scopes": ["directas", "masivas", "saldos", "movimientos"],
      "scopes": [
        {
          "name": "directas",
          "label": "Transferencias directas",
          "sync_metadata": {
            "period": { "type": "string", "description": "Período YYYY-MM" }
          },
          "data_path_template": "/api/connections/{connection_id}/security-transfers",
          "filters": ["period", "direction", "from", "to", "limit", "offset"]
        },
        {
          "name": "masivas",
          "label": "Nóminas masivas",
          "sync_metadata": {
            "period": { "type": "string", "description": "Período YYYY-MM" }
          },
          "data_path_template": "/api/connections/{connection_id}/security-nominas",
          "filters": ["period", "from", "to", "limit", "offset"]
        },
        {
          "name": "saldos",
          "label": "Saldos de cuenta",
          "sync_metadata": {},
          "data_path_template": "/api/connections/{connection_id}/security-balances",
          "filters": ["currency", "from", "to", "latest", "limit", "offset"]
        },
        {
          "name": "movimientos",
          "label": "Movimientos de cuenta",
          "sync_metadata": {
            "period": { "type": "string", "description": "Período YYYY-MM" }
          },
          "data_path_template": "/api/connections/{connection_id}/security-movements",
          "filters": ["period", "direction", "from", "to", "limit", "offset"]
        }
      ],
      "metadata": {}
    }
  ]
}

Campos de una fuente

Campo	Tipo	Notas
`code`	string	slug único de la fuente (p. ej. `sii`, `banco_security`)
`name`	string	nombre legible
`type`	string	clasificación (p. ej. `tax_authority`, `bank`)
`country`	string	código de país (p. ej. `CL`)
`is_active`	boolean	si está disponible para conectarse
`supported_scopes`	string[]	nombres de scopes que soporta la fuente
`scopes`	object[]	descriptores de scopes — ver abajo
`metadata`	object	metadata de la fuente (p. ej. modos de credencial)

Descriptor de scope (`scopes[]`)

Campo	Tipo	Notas
`name`	string	identificador del scope (p. ej. `rcv`, `masivas`)
`label`	string	nombre legible
`sync_metadata`	object	JSON Schema de los parámetros aceptados al gatillar un sync para este scope (`{}` si no tiene)
`data_path_template`	string \| null	plantilla de ruta del endpoint de lectura (`null` si no hay proyección legible)
`filters`	string[]	parámetros de filtrado disponibles en el endpoint de datos

data_path_template contiene {connection_id} como placeholder. Sustitúyelo por el id de tu conexión para construir el URL de lectura.

Las fuentes mock internas (mock_bank, mock_sii) se filtran y no aparecen en este endpoint. Ver SII, Banco Security y BCI PyME.

Fuentes externas

Listar fuentes

Campos de una fuente

Descriptor de scope (scopes[])

On this page

Descriptor de scope (`scopes[]`)