# API de Ocost
> Lo que hace la API de Ocost (leer documentos comerciales como datos estructurados y buscar en ellos), su dirección, claves, formato y rutas.

Envía a Ocost tus documentos comerciales, como facturas, pedidos y contratos. Ocost los lee, archiva, contabiliza y concilia, y recibes cada uno como JSON estructurado. También puedes buscar en todo lo que tu empresa guarda en Ocost.

| Qué | Valor |
| --- | --- |
| Dirección | `https://api.ocost.io/public/v1` |
| Clave | `Authorization: Bearer ocost_sk_…`, de [Ajustes › Desarrolladores](https://app.ocost.io/settings/api) |
| Formato | JSON, archivos como `multipart/form-data`, errores como problemas RFC 9457 |
| Documentos | [`ocost.document.v1`](https://ocost.io/docs/es/document.md), en términos de EN 16931 |
| Dónde | En la UE. Los documentos nunca entrenan un modelo. |

## Las rutas

| Ruta | Hace |
| --- | --- |
| `POST /public/v1/files` | Enviar un archivo |
| `GET /public/v1/files` | Archivos cambiados desde un momento o un cursor |
| `GET /public/v1/files/{file_id}` | Un archivo y su estado |
| `GET /public/v1/files/{file_id}/content` | Los bytes originales |
| `GET /public/v1/files/{file_id}/document` | Su primer documento |
| `GET /public/v1/documents/{document_id}` | Cualquier documento |
| `DELETE /public/v1/files/{file_id}` | Borrar un archivo para siempre |
| `GET /public/v1/search` | Buscar por palabras y por significado |

Empieza por el [Inicio rápido](https://ocost.io/docs/es/quickstart.md). La [referencia de la API](https://ocost.io/docs/openapi.json) tiene cada campo. Lo que Ocost lee en cada país está en [Alemania](https://ocost.io/docs/es/germany.md) y [Ucrania](https://ocost.io/docs/es/ukraine.md).

## Uso con asistentes de IA

Claude, ChatGPT, Cursor y otros asistentes leen estas guías como Markdown:

- `https://ocost.io/docs/llms.txt`: un mapa de todas las guías
- `https://ocost.io/docs/llms-full.txt`: todas las guías en un archivo, en inglés
- `https://ocost.io/docs/openapi.json`: el documento OpenAPI
- **Copiar página para IA**, junto a cada título

Un prompt para una integración con Odoo:

```text
Lee https://ocost.io/docs/llms.txt y las guías que enlaza, primero la de Odoo. Después escribe un módulo de Odoo 19 que envíe el PDF de una factura de proveedor en borrador a la API de Ocost, consulte el archivo hasta que esté leído y rellene el proveedor, el número, las fechas y las líneas de la factura a partir de su ocost.document.v1 sin contabilizarla. Guarda la clave de API en el parámetro del sistema ocost.api_key.
```

## Véase también

- [Inicio rápido](https://ocost.io/docs/es/quickstart.md): Cinco pasos hasta la primera factura como JSON: registrarse, crear una clave, enviar un PDF, esperar hasta que esté leído, leer su documento. curl, Python y JavaScript.
- [Enviar un archivo y leerlo](https://ocost.io/docs/es/files.md): Enviar un archivo, reenviarlo sin riesgo, esperar hasta que esté leído, leer sus documentos, obtener el original, borrarlo.
- [Conectar un asistente](https://ocost.io/docs/es/mcp.md): Conectar un asistente al servidor MCP (https://api.ocost.io/public/mcp, las mismas claves): Claude Code, Claude Desktop, Cursor, claude.ai y ChatGPT por OAuth, y cualquier cliente.
- [El documento](https://ocost.io/docs/es/document.md): El esquema ocost.document.v1 en términos de EN 16931 (se corresponde con UBL y CII): un ejemplo, tipo y dirección, fuentes, comprobaciones, versiones, y cada campo y valor.
- En ocost.io: [API and MCP](https://ocost.io/en/product/api-and-mcp), [Pricing](https://ocost.io/en/pricing)
