tario.

Tario API

REST API, outgoing webhooks, and an MCP server to connect your system to Tario's electronic invoicing and accounting.

The Tario API uses the same services as the app: whatever you register or issue through the API goes through the same Hacienda validations, permissions, and journal entries as on the web. The base URL is https://app.tario.io/api/v1 and every response is JSON.

  • Authentication: personal tokens (Authorization: Bearer) with read, create, and update abilities, or OAuth 2.1 with PKCE for connectors.
  • Company: the X-Tario-Company header picks the company when the user belongs to several.
  • Amounts: always in cents (total_cents).
  • Specification: OpenAPI 3.1 generated from the app's router; every new route shows up automatically.

First call

curl https://app.tario.io/api/v1/facturas-venta/lista \
  -H "Authorization: Bearer $TARIO_TOKEN" \
  -H "X-Tario-Company: 42" \
  -H "Accept: application/json"

Create the token in Tario under Profile → API tokens. Routes with Spanish names (facturas-venta, facturas-compra, reportes, utilidades) are compatible with the previous system's API (eTax); the JSON resources (invoices, bills, accounts, banking, inventory…) expose each module through the same service as the web app.

Authentication and abilitiesSanctum personal tokens with read, create, and update abilities, sent as Authorization: Bearer.Company (tenant) and limitsHow the API picks the company for each request, isolation between companies, and usage limits.Outgoing webhooksSubscribe to invoice and purchase events and verify every delivery with the HMAC-SHA256 signature.MCP serverConnect Claude Code, Cursor, or another AI client to your company's data with read-only tools.OAuth 2.1 for connectorsDiscovery, dynamic registration, PKCE authorization, and company-pinned tokens for web connectors such as claude.ai and ChatGPT.Interactive referenceEvery Tario API endpoint from the OpenAPI 3.1 specification, with parameters, authentication, and examples.API changelogChanges that affect integrations with the Tario API, breaking changes first.

Endpoints

List generated from the OpenAPI specification. Summaries are in Spanish, as in the specification. Download openapi.json

Plataforma

  • POST/api/hacienda-inbox/xmlRegistrar factura de compra desde un XMLToken required
  • POST/api/hacienda/callbackCallback asíncrono del API de Hacienda (plataforma)Public
  • POST/api/inbound-email/sendgridWebhook de correo entrante de SendGrid (plataforma)Public

MCP

  • POST/api/mcpEndpoint MCP (JSON-RPC 2.0, Streamable HTTP)Token required

General

  • GET/api/userUsuario autenticado del tokenToken required
  • GET/api/v1/attachments/{kind}/{attachable}V1 Attachments IndexToken required
  • POST/api/v1/attachments/{kind}/{attachable}V1 Attachments StoreToken required
  • DELETE/api/v1/attachments/{kind}/{attachable}/{attachment}V1 Attachments DestroyToken required
  • GET/api/v1/attachments/{kind}/{attachable}/{attachment}/downloadV1 Attachments DownloadToken required
  • POST/api/v1/emitir-facturaEmitir una factura de venta ya registradaToken required
  • GET/api/v1/openapi.jsonEspecificación OpenAPI de esta APIPublic
  • GET/api/versionCommit y fecha de build de la imagen desplegadaPublic

Contabilidad

  • GET/api/v1/accountsListar el catálogo de cuentas (paginado, con filtros)Token required
  • POST/api/v1/accountsCrear una cuenta contableToken required
  • GET/api/v1/accounts/{account}Consultar una cuenta contableToken required
  • PUT/api/v1/accounts/{account}Actualizar una cuenta contableToken required
  • POST/api/v1/fiscal-periods/closeCerrar un período contable mensualToken required
  • POST/api/v1/fiscal-periods/close-yearCerrar el año fiscal (asientos de cierre)Token required
  • POST/api/v1/fiscal-periods/reopenReabrir un período contable cerradoToken required
  • POST/api/v1/fiscal-periods/reopen-yearReabrir un año fiscal cerrado (revierte los asientos de cierre)Token required
  • GET/api/v1/transactionsListar movimientos y asientos contables (paginado, con filtros)Token required
  • POST/api/v1/transactionsCrear un movimiento o asiento contableToken required
  • GET/api/v1/transactions/{transaction}Consultar un movimiento contable con sus líneasToken required
  • PUT/api/v1/transactions/{transaction}Actualizar un movimiento contable en borradorToken required
  • DELETE/api/v1/transactions/{transaction}Eliminar un movimiento contable en borradorToken required
  • POST/api/v1/transactions/{transaction}/post-to-ledgerMayorizar un asiento en borradorToken required
  • POST/api/v1/transactions/{transaction}/reverseRevertir un movimiento contable mayorizadoToken required
  • POST/api/v1/transactions/{transaction}/voidAnular un movimiento contable (reversa y marca de anulación)Token required

Catálogos

  • GET/api/v1/actividades-economicasCatálogo de actividades económicasToken required
  • GET/api/v1/cabys/searchBuscar códigos CABYS por código o descripciónToken required
  • GET/api/v1/utilidades/actividad-comercialCatálogo de actividad comercialToken required
  • GET/api/v1/utilidades/actividad-comercialesCatálogo de actividades económicas (legado)Token required
  • GET/api/v1/utilidades/cantonCantonesToken required
  • GET/api/v1/utilidades/categorias-haciendaCategorías de producto de HaciendaToken required
  • GET/api/v1/utilidades/categorias-hacienda/{code}Categorías para un código CABYSToken required
  • GET/api/v1/utilidades/codigos-compraCódigos IVA para comprasToken required
  • GET/api/v1/utilidades/codigos-ventaCódigos IVA para ventasToken required
  • GET/api/v1/utilidades/distritoDistritosToken required
  • GET/api/v1/utilidades/paisPaísesToken required
  • GET/api/v1/utilidades/provinciasProvinciasToken required
  • GET/api/v1/utilidades/unidades-medicionUnidades de medidaToken required

Bancos

  • POST/api/v1/banking/accounts/{bankAccount}/archiveArchivar una cuenta bancariaToken required
  • POST/api/v1/banking/accounts/{bankAccount}/restoreRestaurar una cuenta bancaria archivadaToken required
  • GET/api/v1/banking/statement-importsListar importaciones de estados de cuenta (paginado, con filtros)Token required
  • POST/api/v1/banking/statement-importsSubir un estado de cuenta bancario (multipart)Token required
  • GET/api/v1/banking/statement-imports/{import}Consultar una importación con sus líneas, decisiones y emparejamientosToken required
  • DELETE/api/v1/banking/statement-imports/{import}Eliminar una importación no confirmadaToken required
  • POST/api/v1/banking/statement-imports/{import}/accept-gapAceptar la diferencia de saldo con una justificaciónToken required
  • POST/api/v1/banking/statement-imports/{import}/commitConfirmar la importación (encola el registro contable)Token required
  • POST/api/v1/banking/statement-imports/{import}/complete-reconciliationCompletar la conciliación bancaria formalToken required
  • POST/api/v1/banking/statement-imports/{import}/linesAgregar una línea manual al estado de cuentaToken required
  • POST/api/v1/banking/statement-imports/{import}/rerun-matchingReejecutar el emparejamiento automático de las líneasToken required
  • POST/api/v1/banking/statement-imports/{import}/retryReintentar el análisis de una importación fallidaToken required
  • POST/api/v1/banking/statement-imports/{import}/rollbackRevertir una importación confirmadaToken required
  • POST/api/v1/banking/statement-lines/bulk-decisionsAplicar decisiones en lote a varias líneasToken required
  • PUT/api/v1/banking/statement-lines/{line}/decisionDecidir una línea (asignar documento, categorizar u omitir)Token required
  • POST/api/v1/banking/statement-lines/{line}/merchant-ruleCrear una regla de comercio a partir de una líneaToken required

Operaciones de compra

  • GET/api/v1/billsListar facturas de compra (paginado, con filtros)Token required
  • POST/api/v1/billsCrear una factura de compraToken required
  • POST/api/v1/bills/bulk-payRegistrar pagos sobre varias facturas de compraToken required
  • POST/api/v1/bills/reception/queryConsultar en Hacienda los mensajes receptor enviadosToken required
  • POST/api/v1/bills/reception/retryReintentar mensajes receptor pendientes de respuestaToken required
  • GET/api/v1/bills/reception/{bill}/download-zipDescargar el ZIP de archivos de una factura recibidaToken required
  • GET/api/v1/bills/{bill}Consultar una factura de compra con sus líneasToken required
  • PUT/api/v1/bills/{bill}Actualizar una factura de compraToken required
  • POST/api/v1/bills/{bill}/hacienda/queryConsultar en Hacienda el estado de la FECToken required
  • POST/api/v1/bills/{bill}/hacienda/sendEmitir la factura electrónica de compra (FEC) a HaciendaToken required
  • PUT/api/v1/bills/{bill}/inventory-assignmentsAsignar artículos de inventario a las líneas de una compraToken required
  • PUT/api/v1/bills/{bill}/line-validationValidar códigos IVA/CABYS de las líneas de una compraToken required
  • POST/api/v1/bills/{bill}/paymentsRegistrar un pago sobre una factura de compraToken required
  • POST/api/v1/bills/{bill}/voidAnular una factura de compraToken required
  • GET/api/v1/purchase-ordersListar órdenes de compra (paginado, con filtros)Token required
  • POST/api/v1/purchase-ordersCrear una orden de compraToken required
  • GET/api/v1/purchase-orders/{purchaseOrder}Consultar una orden de compraToken required
  • PUT/api/v1/purchase-orders/{purchaseOrder}Actualizar una orden de compraToken required
  • POST/api/v1/purchase-orders/{purchaseOrder}/associate-billAsociar una factura de compra existente y cerrar la ordenToken required
  • POST/api/v1/purchase-orders/{purchaseOrder}/cancelCancelar una orden de compraToken required
  • POST/api/v1/purchase-orders/{purchaseOrder}/closeCerrar una orden de compraToken required
  • POST/api/v1/purchase-orders/{purchaseOrder}/convert-to-billConvertir la orden en factura de compra (FEC)Token required
  • POST/api/v1/vendors/{vendor}/statement/emailEnviar el estado de cuenta del proveedor por correoToken required
  • GET/api/v1/vendors/{vendor}/statement/exportDescargar el estado de cuenta del proveedor (CSV)Token required

Cierres fiscales

  • POST/api/v1/cierres/actualizar-retencion-tarjetaActualizar una retención de tarjetaToken required
  • POST/api/v1/cierres/cerrar-mesCerrar un mes fiscalToken required
  • GET/api/v1/cierres/lista-cierresListar cierres fiscales mensualesToken required
  • POST/api/v1/cierres/rectificacionRectificar un mes cerradoToken required
  • GET/api/v1/cierres/retenciones-tarjetaListar retenciones de tarjetaToken required

Operaciones de venta

  • POST/api/v1/clients/{client}/statement/emailEnviar el estado de cuenta del cliente por correoToken required
  • GET/api/v1/clients/{client}/statement/exportDescargar el estado de cuenta del cliente (CSV)Token required
  • GET/api/v1/estimatesListar cotizaciones (paginado, con filtros)Token required
  • POST/api/v1/estimatesCrear una cotizaciónToken required
  • GET/api/v1/estimates/{estimate}Consultar una cotizaciónToken required
  • PUT/api/v1/estimates/{estimate}Actualizar una cotizaciónToken required
  • POST/api/v1/estimates/{estimate}/acceptMarcar una cotización como aceptadaToken required
  • POST/api/v1/estimates/{estimate}/approveAprobar una cotización en borradorToken required
  • POST/api/v1/estimates/{estimate}/convert-to-invoiceConvertir una cotización en factura de ventaToken required
  • POST/api/v1/estimates/{estimate}/declineMarcar una cotización como rechazadaToken required
  • POST/api/v1/estimates/{estimate}/mark-sentMarcar una cotización como enviadaToken required
  • GET/api/v1/invoicesListar facturas de venta (paginado, con filtros)Token required
  • POST/api/v1/invoicesCrear una factura de ventaToken required
  • POST/api/v1/invoices/bulk-payRegistrar pagos sobre varias facturas de ventaToken required
  • GET/api/v1/invoices/{invoice}Consultar una factura de venta con sus líneasToken required
  • PUT/api/v1/invoices/{invoice}Actualizar una factura de ventaToken required
  • POST/api/v1/invoices/{invoice}/attachmentsAdjuntar un archivo a una factura de ventaToken required
  • DELETE/api/v1/invoices/{invoice}/attachments/{attachment}Quitar un adjunto de una factura de ventaToken required
  • POST/api/v1/invoices/{invoice}/emailEnviar la factura de venta por correo al clienteToken required
  • POST/api/v1/invoices/{invoice}/notesCrear una nota de crédito o débito sobre una facturaToken required
  • POST/api/v1/invoices/{invoice}/paymentsRegistrar un pago sobre una factura de ventaToken required
  • POST/api/v1/invoices/{invoice}/receiptsEmitir un recibo electrónico de pago (REP)Token required
  • POST/api/v1/invoices/{invoice}/voidAnular una factura de venta (opcionalmente con nota de crédito)Token required
  • GET/api/v1/recurring-invoicesListar facturas recurrentes (paginado, con filtros)Token required
  • POST/api/v1/recurring-invoicesCrear una factura recurrenteToken required
  • GET/api/v1/recurring-invoices/{recurringInvoice}Consultar una factura recurrenteToken required
  • PUT/api/v1/recurring-invoices/{recurringInvoice}Actualizar una factura recurrenteToken required
  • POST/api/v1/recurring-invoices/{recurringInvoice}/approveAprobar y activar una factura recurrenteToken required
  • POST/api/v1/recurring-invoices/{recurringInvoice}/endFinalizar una factura recurrenteToken required
  • POST/api/v1/recurring-invoices/{recurringInvoice}/generateGenerar la siguiente factura de la serieToken required
  • POST/api/v1/recurring-invoices/{recurringInvoice}/pausePausar una factura recurrenteToken required
  • POST/api/v1/recurring-invoices/{recurringInvoice}/resumeReanudar una factura recurrente pausadaToken required

Facturas de compra

  • POST/api/v1/facturas-compra/aceptarEnviar mensaje de aceptación (1/2/3)Token required
  • POST/api/v1/facturas-compra/autorizar-correoAutorizar el envío del mensaje por correoToken required
  • GET/api/v1/facturas-compra/consultarConsultar una factura de compra por claveToken required
  • GET/api/v1/facturas-compra/consultar-haciendaCompras pendientes de respuesta de HaciendaToken required
  • GET/api/v1/facturas-compra/descargar-xml-respuesta/{clave}Descargar el XML de respuesta de HaciendaToken required
  • GET/api/v1/facturas-compra/descargar-xml/{clave}Descargar el XML firmado de la compraToken required
  • GET/api/v1/facturas-compra/listaListar facturas de compra (paginado)Token required
  • GET/api/v1/facturas-compra/lista-correoCompras en cola de envío de correoToken required
  • GET/api/v1/facturas-compra/lista-no-aceptadasCompras pendientes de aceptaciónToken required
  • GET/api/v1/facturas-compra/lista-no-validadasCompras pendientes de validaciónToken required
  • POST/api/v1/facturas-compra/registrarRegistrar factura de compraToken required
  • POST/api/v1/facturas-compra/validarValidar códigos IVA/CABYS de las líneasToken required

Facturas de venta

  • GET/api/v1/facturas-venta/consultarConsultar una factura de venta por claveToken required
  • POST/api/v1/facturas-venta/consultar-haciendaConsultar estado en Hacienda (asíncrono)Token required
  • GET/api/v1/facturas-venta/consultar-haciendaFacturas pendientes de respuesta de HaciendaToken required
  • GET/api/v1/facturas-venta/descargar-xml-respuesta/{clave}Descargar el XML de respuesta de HaciendaToken required
  • GET/api/v1/facturas-venta/descargar-xml/{clave}Descargar el XML firmado de la facturaToken required
  • POST/api/v1/facturas-venta/emitirRegistrar y emitir factura de venta a HaciendaToken required
  • POST/api/v1/facturas-venta/emitir/n-credito/{clave}Emitir nota de crédito sobre una facturaToken required
  • POST/api/v1/facturas-venta/emitir/n-debito/{clave}Emitir nota de débito sobre una facturaToken required
  • GET/api/v1/facturas-venta/listaListar facturas de venta (paginado)Token required
  • GET/api/v1/facturas-venta/lista-correoFacturas en cola de envío de correoToken required
  • GET/api/v1/facturas-venta/lista-no-validadasFacturas pendientes de validaciónToken required
  • POST/api/v1/facturas-venta/reenviar-correoReenviar el correo de la facturaToken required
  • POST/api/v1/facturas-venta/registrarRegistrar factura de venta (sin emitir)Token required
  • POST/api/v1/facturas-venta/validarValidar códigos IVA/CABYS de las líneasToken required

Inventario

  • POST/api/v1/inventory/assignmentsAsignar un artículo de inventario a un empleadoToken required
  • POST/api/v1/inventory/assignments/{assignment}/returnRegistrar la devolución de un artículo asignadoToken required
  • GET/api/v1/inventory/items/{item}/kardexKardex del artículo (historial con saldo corrido)Token required
  • GET/api/v1/inventory/movementsListar movimientos de inventario (paginado, con filtros)Token required
  • POST/api/v1/inventory/movementsRegistrar un movimiento de inventario (actualiza existencias)Token required
  • GET/api/v1/inventory/movements/{movement}Consultar un movimiento de inventario con sus líneasToken required
  • POST/api/v1/inventory/repairsRegistrar una reparación de un artículo de inventarioToken required
  • POST/api/v1/inventory/repairs/{repair}/completeCompletar una reparación de inventarioToken required

Recursos

  • POST/api/v1/quick-productsCrear un producto rápido desde el editor de documentosToken required
  • GET/api/v1/resources/{screen}Listar recursos de un tipo (paginado, con búsqueda)Token required
  • POST/api/v1/resources/{screen}Crear un recurso (clientes, proveedores, productos, inventario)Token required
  • GET/api/v1/resources/{screen}/{record}Consultar un recursoToken required
  • PUT/api/v1/resources/{screen}/{record}Actualizar un recursoToken required
  • DELETE/api/v1/resources/{screen}/{record}Eliminar un recursoToken required

Reportes

  • GET/api/v1/reportes/borrador-ivaBorrador de la declaración de IVAToken required
  • GET/api/v1/reportes/detalle-creditoDetalle de crédito fiscalToken required
  • GET/api/v1/reportes/detalle-debitoDetalle de débito fiscalToken required
  • GET/api/v1/reportes/libro-comprasLibro de comprasToken required
  • GET/api/v1/reportes/libro-ventasLibro de ventasToken required
  • GET/api/v1/reports/books/{book}/exportExportar el libro de ventas o compras (CSV, XLSX o PDF)Token required
  • GET/api/v1/reports/d104/exportExportar el XML de la declaración D-104Token required
  • GET/api/v1/reports/d151/exportExportar la declaración informativa D-151 (CSV)Token required
  • GET/api/v1/reports/financial/{report}/exportExportar un estado financiero (CSV, XLSX o PDF)Token required
  • GET/api/v1/reports/model-270/exportExportar la declaración informativa modelo 270 (CSV)Token required

Webhooks

  • GET/api/v1/webhooksListar suscripciones de webhooksToken required
  • POST/api/v1/webhooksCrear suscripción de webhook (el secreto se muestra una vez)Token required
  • PATCH/api/v1/webhooks/{webhook}Activar o desactivar una suscripción de webhookToken required
  • DELETE/api/v1/webhooks/{webhook}Eliminar suscripción de webhookToken required
  • POST/api/v1/webhooks/{webhook}/testEncolar un evento de prueba (ping) firmado a la suscripciónToken required