canonical: https://jentic.com/apis/emisso.ai/emisso

# Emisso Connect API

The Emisso Connect API connects your agents to Chilean financial, tax, banking, social-security, and public systems through a single gateway: it reads account balances and movements from banks such as BancoEstado, Banco de Chile, BCI, BICE, and Santander, queries the SII for tax documents, and issues electronic tax documents like boletas and DTEs. It also reads economic indicators, public-procurement attachments from Mercado Publico, and judicial case records from the Poder Judicial. Every call is a POST to a single execute path with the input wrapped in one envelope, and every response carries a request id that identifies it in the log.

## For AI agents

Read balances and movements from Chilean banks, query and issue SII tax documents, and pull economic indicators, procurement, and judicial records, all through one envelope-based gateway.

## Scope

Does not move money, run payroll, or serve markets outside Chile. Use for reading Chilean financial and public data and issuing Chilean tax documents only.

## Capabilities

- Read account balances and movements from Chilean banks such as BancoEstado and BCI
- Query the SII for tax documents and taxpayer folders
- Issue electronic tax documents such as boletas and DTEs through the SII
- Read current and historical economic indicator values
- Retrieve public-procurement tender attachments from Mercado Publico
- Look up judicial case records and filings from the Poder Judicial

## Use cases

### Agent that reconciles bank movements

An AI agent pulls transactions for reconciliation. Through Jentic the agent reads account balances and movements from a connected Chilean bank such as BancoEstado or BCI and returns them for matching against invoices. Each response carries a request id that ties the read back to the gateway's log for audit.

Example prompt: Read the balance and latest movements of a connected BancoEstado account and return them for reconciliation

### Issuing tax documents

An agent issues a compliant document at the point of sale. The SII operations preview and then issue electronic tax documents such as boletas and DTEs, and can consult or download the ones already issued, so billing happens through calls instead of the SII portal. The signed document can be retrieved afterward from the same gateway.

Example prompt: Preview a boleta, issue it through the SII, and download the resulting document

### Economic indicator lookups

A workflow needs an official rate. The indicator operations return the current value of an economic indicator and its historical series or value on a given date, so an agent can convert amounts or index a contract against the right figure. The connectable-systems list shows which sources are available first.

Example prompt: Get the current value of an economic indicator and read its historical series for the last month

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/v1/tools/banco_estado.saldos.consultar/execute` | Query BancoEstado account balances |
| POST | `/v1/tools/banco_estado.movimientos.consultar/execute` | Query BancoEstado account movements |
| POST | `/v1/tools/sii.boleta.emitir/execute` | Issue an e-Boleta at the SII |
| POST | `/v1/tools/sii.dte.emitir/execute` | Issue a DTE at the SII |
| POST | `/v1/tools/indicadores.valor.actual/execute` | Get an indicator's current value |
| POST | `/v1/tools/conexiones.sistemas.listar/execute` | List connectable systems |

## Key resources

- **Banks** — Balances, movements, and transfers across connected Chilean banks
- **SII** — Query tax documents and taxpayer folders and issue boletas and DTEs
- **Indicators** — Current and historical economic indicator values
- **Connections** — List, create, enable, disable, and remove connected systems
- **Public records** — Mercado Publico procurement attachments and Poder Judicial case records

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 62 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 54 / 100
  - Developer Experience & Jentic Compatibility: 69 / 100
  - AI-Readiness & Agent Experience: 49 / 100
  - Agent Usability: 75 / 100
  - Security: 75 / 100
  - AI Discoverability: 76 / 100
- **View full report:** https://jentic.com/apis/emisso.ai/emisso/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the Emisso Connect API by hand means handling its bearer API key or an OAuth2 flow, wrapping every input in its envelope, and reading the request id and suggested fix out of each response yourself. Through Jentic you install once, import Emisso Connect from the API Directory, store the credential once, and your agent calls it.
- **Permission scoping:** Emisso puts the tool id in the URL path (`/v1/tools/{tool_id}/execute`), so a rule can pin your agent to the specific tools it needs, such as reading bank balances and movements. Issuing tax documents or removing a connection is not included unless you add it.
- **Credential handling:** Your Emisso Connect credential is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'read a bank account balance' or 'issue a boleta', and Jentic returns the matching Emisso Connect operation with its input schema so the agent calls the right endpoint without reading the reference docs.

## Related APIs

- **Belvo** — Aggregates bank and fiscal data across Latin America
- **Plaid** — Connects bank accounts and reads balances and transactions
- **Avalara AvaTax** — Calculates tax and manages compliance filings

## FAQ

### What authentication does the Emisso Connect API use?

The Emisso Connect API authenticates with a bearer organization API key sent as `Authorization: Bearer connect_sk_...`, and additionally supports an OAuth2 authorization-code flow with PKCE for interactive clients, per its OpenAPI spec. Through Jentic the credential is stored encrypted by your own Jentic One instance and injected at call time, so it never enters the agent's context.

### Is there an Emisso Connect MCP server?

You don't need a separate MCP server to give your agent the Emisso Connect API. Jentic connects it directly from the API Directory: import it, store your credential once, and your agent calls its bank and tax operations on demand without loading extra tool definitions into its context.

### Can I issue a boleta with the Emisso Connect API?

Yes. The SII operations issue electronic tax documents such as boletas and DTEs, preview them first, and consult or download the ones already issued. Reading bank balances and movements and querying economic indicators run through the same gateway.

### What are the rate limits for the Emisso Connect API?

The OpenAPI spec does not state specific rate limits. Check the provider's documentation at https://connect.emisso.ai/docs for the limits that apply to your organization before running high-volume reads.

### Can I limit what my agent is allowed to do with the Emisso Connect API?

Yes. Emisso puts the tool id in the URL path, so write a rule that lets your agent read balances and movements while issuing tax documents or removing a connection stays out of its reach. Every call it makes is logged.

### How do I read a bank balance with the Emisso Connect API through Jentic?

Search Jentic for 'read a bank account balance' and it returns the matching execute operation with its input schema; your agent names the bank tool and reads back the balance and movements. To run it on your own infrastructure, install Jentic One from its GitHub repo.
