tario.

API de Tario

API REST, webhooks salientes y servidor MCP para integrar tu sistema con la facturación electrónica y la contabilidad de Tario.

La API de Tario usa los mismos servicios que la aplicación: lo que registrás o emitís por API pasa por las mismas validaciones de Hacienda, permisos y asientos contables que en la web. La base es https://app.tario.io/api/v1 y todas las respuestas son JSON.

  • Autenticación: tokens personales (Authorization: Bearer) con habilidades read, create y update, u OAuth 2.1 con PKCE para conectores.
  • Empresa: el header X-Tario-Company elige la empresa cuando el usuario pertenece a varias.
  • Montos: siempre en céntimos (total_cents).
  • Especificación: OpenAPI 3.1 generada desde el router de la aplicación; cada ruta nueva aparece sola.

Primer llamado

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

Creá el token en Tario desde Perfil → API tokens. Las rutas con nombres en español (facturas-venta, facturas-compra, reportes, utilidades) son compatibles con la API del sistema anterior (eTax); los recursos JSON (invoices, bills, accounts, banking, inventory…) exponen cada módulo con el mismo servicio que la web.

Autenticación y habilidadesTokens personales Sanctum con habilidades read, create y update, enviados como Authorization: Bearer.Empresa (tenant) y límitesCómo elige la API la empresa de cada solicitud, el aislamiento entre empresas y los límites de uso.Webhooks salientesSuscribite a eventos de facturas y compras y verificá cada entrega con la firma HMAC-SHA256.Servidor MCPConectá Claude Code, Cursor u otro cliente de IA a los datos de tu empresa con herramientas de solo lectura.OAuth 2.1 para conectoresDescubrimiento, registro dinámico, autorización con PKCE y tokens fijados a una empresa para conectores web como claude.ai y ChatGPT.Referencia interactivaTodos los endpoints de la API de Tario desde la especificación OpenAPI 3.1, con parámetros, autenticación y ejemplos.Cambios de la APICambios que afectan a las integraciones con la API de Tario, empezando por los incompatibles.

Endpoints

Lista generada desde la especificación OpenAPI. Los resúmenes están en español, como en la especificación. Descargar openapi.json

Plataforma

  • POST/api/hacienda-inbox/xmlRegistrar factura de compra desde un XMLRequiere token
  • POST/api/hacienda/callbackCallback asíncrono del API de Hacienda (plataforma)Pública
  • POST/api/inbound-email/sendgridWebhook de correo entrante de SendGrid (plataforma)Pública

MCP

  • POST/api/mcpEndpoint MCP (JSON-RPC 2.0, Streamable HTTP)Requiere token

General

  • GET/api/userUsuario autenticado del tokenRequiere token
  • GET/api/v1/attachments/{kind}/{attachable}V1 Attachments IndexRequiere token
  • POST/api/v1/attachments/{kind}/{attachable}V1 Attachments StoreRequiere token
  • DELETE/api/v1/attachments/{kind}/{attachable}/{attachment}V1 Attachments DestroyRequiere token
  • GET/api/v1/attachments/{kind}/{attachable}/{attachment}/downloadV1 Attachments DownloadRequiere token
  • POST/api/v1/emitir-facturaEmitir una factura de venta ya registradaRequiere token
  • GET/api/v1/openapi.jsonEspecificación OpenAPI de esta APIPública
  • GET/api/versionCommit y fecha de build de la imagen desplegadaPública

Contabilidad

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

Catálogos

  • GET/api/v1/actividades-economicasCatálogo de actividades económicasRequiere token
  • GET/api/v1/cabys/searchBuscar códigos CABYS por código o descripciónRequiere token
  • GET/api/v1/utilidades/actividad-comercialCatálogo de actividad comercialRequiere token
  • GET/api/v1/utilidades/actividad-comercialesCatálogo de actividades económicas (legado)Requiere token
  • GET/api/v1/utilidades/cantonCantonesRequiere token
  • GET/api/v1/utilidades/categorias-haciendaCategorías de producto de HaciendaRequiere token
  • GET/api/v1/utilidades/categorias-hacienda/{code}Categorías para un código CABYSRequiere token
  • GET/api/v1/utilidades/codigos-compraCódigos IVA para comprasRequiere token
  • GET/api/v1/utilidades/codigos-ventaCódigos IVA para ventasRequiere token
  • GET/api/v1/utilidades/distritoDistritosRequiere token
  • GET/api/v1/utilidades/paisPaísesRequiere token
  • GET/api/v1/utilidades/provinciasProvinciasRequiere token
  • GET/api/v1/utilidades/unidades-medicionUnidades de medidaRequiere token

Bancos

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

Operaciones de compra

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

Cierres fiscales

  • POST/api/v1/cierres/actualizar-retencion-tarjetaActualizar una retención de tarjetaRequiere token
  • POST/api/v1/cierres/cerrar-mesCerrar un mes fiscalRequiere token
  • GET/api/v1/cierres/lista-cierresListar cierres fiscales mensualesRequiere token
  • POST/api/v1/cierres/rectificacionRectificar un mes cerradoRequiere token
  • GET/api/v1/cierres/retenciones-tarjetaListar retenciones de tarjetaRequiere token

Operaciones de venta

  • POST/api/v1/clients/{client}/statement/emailEnviar el estado de cuenta del cliente por correoRequiere token
  • GET/api/v1/clients/{client}/statement/exportDescargar el estado de cuenta del cliente (CSV)Requiere token
  • GET/api/v1/estimatesListar cotizaciones (paginado, con filtros)Requiere token
  • POST/api/v1/estimatesCrear una cotizaciónRequiere token
  • GET/api/v1/estimates/{estimate}Consultar una cotizaciónRequiere token
  • PUT/api/v1/estimates/{estimate}Actualizar una cotizaciónRequiere token
  • POST/api/v1/estimates/{estimate}/acceptMarcar una cotización como aceptadaRequiere token
  • POST/api/v1/estimates/{estimate}/approveAprobar una cotización en borradorRequiere token
  • POST/api/v1/estimates/{estimate}/convert-to-invoiceConvertir una cotización en factura de ventaRequiere token
  • POST/api/v1/estimates/{estimate}/declineMarcar una cotización como rechazadaRequiere token
  • POST/api/v1/estimates/{estimate}/mark-sentMarcar una cotización como enviadaRequiere token
  • GET/api/v1/invoicesListar facturas de venta (paginado, con filtros)Requiere token
  • POST/api/v1/invoicesCrear una factura de ventaRequiere token
  • POST/api/v1/invoices/bulk-payRegistrar pagos sobre varias facturas de ventaRequiere token
  • GET/api/v1/invoices/{invoice}Consultar una factura de venta con sus líneasRequiere token
  • PUT/api/v1/invoices/{invoice}Actualizar una factura de ventaRequiere token
  • POST/api/v1/invoices/{invoice}/attachmentsAdjuntar un archivo a una factura de ventaRequiere token
  • DELETE/api/v1/invoices/{invoice}/attachments/{attachment}Quitar un adjunto de una factura de ventaRequiere token
  • POST/api/v1/invoices/{invoice}/emailEnviar la factura de venta por correo al clienteRequiere token
  • POST/api/v1/invoices/{invoice}/notesCrear una nota de crédito o débito sobre una facturaRequiere token
  • POST/api/v1/invoices/{invoice}/paymentsRegistrar un pago sobre una factura de ventaRequiere token
  • POST/api/v1/invoices/{invoice}/receiptsEmitir un recibo electrónico de pago (REP)Requiere token
  • POST/api/v1/invoices/{invoice}/voidAnular una factura de venta (opcionalmente con nota de crédito)Requiere token
  • GET/api/v1/recurring-invoicesListar facturas recurrentes (paginado, con filtros)Requiere token
  • POST/api/v1/recurring-invoicesCrear una factura recurrenteRequiere token
  • GET/api/v1/recurring-invoices/{recurringInvoice}Consultar una factura recurrenteRequiere token
  • PUT/api/v1/recurring-invoices/{recurringInvoice}Actualizar una factura recurrenteRequiere token
  • POST/api/v1/recurring-invoices/{recurringInvoice}/approveAprobar y activar una factura recurrenteRequiere token
  • POST/api/v1/recurring-invoices/{recurringInvoice}/endFinalizar una factura recurrenteRequiere token
  • POST/api/v1/recurring-invoices/{recurringInvoice}/generateGenerar la siguiente factura de la serieRequiere token
  • POST/api/v1/recurring-invoices/{recurringInvoice}/pausePausar una factura recurrenteRequiere token
  • POST/api/v1/recurring-invoices/{recurringInvoice}/resumeReanudar una factura recurrente pausadaRequiere token

Facturas de compra

  • POST/api/v1/facturas-compra/aceptarEnviar mensaje de aceptación (1/2/3)Requiere token
  • POST/api/v1/facturas-compra/autorizar-correoAutorizar el envío del mensaje por correoRequiere token
  • GET/api/v1/facturas-compra/consultarConsultar una factura de compra por claveRequiere token
  • GET/api/v1/facturas-compra/consultar-haciendaCompras pendientes de respuesta de HaciendaRequiere token
  • GET/api/v1/facturas-compra/descargar-xml-respuesta/{clave}Descargar el XML de respuesta de HaciendaRequiere token
  • GET/api/v1/facturas-compra/descargar-xml/{clave}Descargar el XML firmado de la compraRequiere token
  • GET/api/v1/facturas-compra/listaListar facturas de compra (paginado)Requiere token
  • GET/api/v1/facturas-compra/lista-correoCompras en cola de envío de correoRequiere token
  • GET/api/v1/facturas-compra/lista-no-aceptadasCompras pendientes de aceptaciónRequiere token
  • GET/api/v1/facturas-compra/lista-no-validadasCompras pendientes de validaciónRequiere token
  • POST/api/v1/facturas-compra/registrarRegistrar factura de compraRequiere token
  • POST/api/v1/facturas-compra/validarValidar códigos IVA/CABYS de las líneasRequiere token

Facturas de venta

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

Inventario

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

Recursos

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

Reportes

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

Webhooks

  • GET/api/v1/webhooksListar suscripciones de webhooksRequiere token
  • POST/api/v1/webhooksCrear suscripción de webhook (el secreto se muestra una vez)Requiere token
  • PATCH/api/v1/webhooks/{webhook}Activar o desactivar una suscripción de webhookRequiere token
  • DELETE/api/v1/webhooks/{webhook}Eliminar suscripción de webhookRequiere token
  • POST/api/v1/webhooks/{webhook}/testEncolar un evento de prueba (ping) firmado a la suscripciónRequiere token