# Alegra API Documentation Documentation > API de Alegra, la cual te permite conectarte con la aplicación Alegra ## Información General: Inicio - [Información General](https://developer.alegra.com/docs/información-general.md): Esta página te ayudará a comenzar con el API de Alegra - [Términos y Condiciones API Alegra](https://developer.alegra.com/docs/términos-y-condiciones-api-alegra.md): Términos y condiciones que debes tener en cuenta al utilizar el API de Alegra ## Información General: Referencia - [Productos y servicios](https://developer.alegra.com/docs/productos-y-servicios.md): Endpoint /items - [Contactos](https://developer.alegra.com/docs/contactos.md) - [Facturas de venta](https://developer.alegra.com/docs/facturas-de-venta-1.md) - [Cotizaciones](https://developer.alegra.com/docs/cotizaciones-1.md) - [Numeración de documentos](https://developer.alegra.com/docs/numeración-de-documentos.md): Endpoint /number-templates - [Pagos](https://developer.alegra.com/docs/pagos-2.md) - [Términos de pago](https://developer.alegra.com/docs/términos-de-pago.md) - [Notas crédito](https://developer.alegra.com/docs/notas-crédito-1.md) - [Remisiones](https://developer.alegra.com/docs/remisiones-1.md) ## Documentación: Inicio - [Autenticación](https://developer.alegra.com/reference/autenticación.md) - [Límite de request](https://developer.alegra.com/reference/límite-de-request.md) - [Respuestas del API](https://developer.alegra.com/reference/respuestas-del-api-y-manejo-de-errores.md) ## Documentación: Ingresos - Facturas de venta - [Lista de facturas de venta](https://developer.alegra.com/reference/get_invoices.md): Endpoint que retorna las facturas registradas en la cuenta de Alegra. Si no se envía límite de facturas, por defecto se envían 30 facturas. - [Crear factura de venta](https://developer.alegra.com/reference/post_invoices.md): Endpoint que permite crear una factura de venta desde cero. - [Consultar una factura de venta](https://developer.alegra.com/reference/get_invoices-id.md): Endpoint que permite consultar una factura de venta registrada en la aplicación. Retorna toda la información asociada al ID de la factura de venta que se envía como parámetro. - [Editar factura de venta](https://developer.alegra.com/reference/put_invoices-id.md): Endpoint que permite editar una factura de venta. Únicamente se modifican los atributos que se envían en el request, los otros atributos del objeto que no se envían quedan intactos. Se retorna la… - [Eliminar factura de venta](https://developer.alegra.com/reference/delete_invoices-id.md): Endpoint que permite eliminar una factura de venta en estado borrador/draft. - [Enviar factura por correo](https://developer.alegra.com/reference/post_invoices-id-email.md): Endpoint para envíar una factura de venta por correo. - [Adjuntar archivos a facturas de venta](https://developer.alegra.com/reference/post_invoices-id-attachment.md): Para adjuntar un archivo a una factura de venta se debe enviar un request en el cual se debe especificar el header Content-Type como multipart/form-data. Se debe tener en cuenta que solo se puede… - [Eliminar archivos adjuntos](https://developer.alegra.com/reference/delete_invoices-attachment-idattachment.md): Eliminar un archivo adjunto de una factura de venta - [Abrir factura de venta](https://developer.alegra.com/reference/post_invoices-id-open.md): Endpoint que permite revertir la anulación de una factura. Nota: En caso de no enviar el objeto stamp se asume que se desea abrir la factura sin timbrar. - [Anular factura de venta](https://developer.alegra.com/reference/post_invoices-id-void.md): Endpoint que permite anular una factura de venta. - [Edita las retenciones aplicadas a factura de venta](https://developer.alegra.com/reference/put_invoices-id-retentionsapplied.md): Endpoint que permite editar retenciones aplicadas a factura de venta abierta. Enviar arreglo vacio si desea remover todas las retenciones aplicadas - [Vista previa factura de venta](https://developer.alegra.com/reference/post_invoices-preview.md): Endpoint que permite generar la url para consultar el pdf de la vista previa de la creación de la factura de venta. - [Emitir facturas de venta masivamente](https://developer.alegra.com/reference/post_invoices-stamp.md): Endpoint que permite timbrar hasta 10 facturas cuando se encuentran es estado borrador o en estado abierto. - Pagos - [Lista de pagos](https://developer.alegra.com/reference/get_payments-1.md): Endpoint que retorna los pagos registrados en la cuenta de Alegra. Si no se envía límite de pagos por defecto se envían 30. - [Crear pago](https://developer.alegra.com/reference/post_payments-1.md): Endpoint que permite registrar un pago en la aplicación. - [Consultar un pago](https://developer.alegra.com/reference/get_payments-id-1.md): Endpoint que retorna el pago registrado en la cuenta de Alegra que está identificado con el id que se envía como parámetro. - [Editar pago](https://developer.alegra.com/reference/put_payments-id-1.md): Endpoint que permite editar un pago en la aplicación. Únicamente se modifican los atributos que se envían en el request, los otros atributos del objeto que no se envían quedan intactos. Se retorna el… - [Eliminar pago](https://developer.alegra.com/reference/delete_payments-id-1.md): Endpoint disponible para eliminar pagos recibidos o transacciones realizadas - [Anular pago](https://developer.alegra.com/reference/post_payments-id-void-1.md): Endpoint que permite anular un pago en la aplicación. La anulación de pagos sirve para mantener registro del pago en la aplicación pero que este documento no tenga efecto en la contabilidad o… - [Convertir pago a abierto](https://developer.alegra.com/reference/post_payments-id-open-1.md): Endpoint que permite revertir la anulación de un pago. Para revertir la anulación de un pago y que éste tenga efecto en la contabilidad y reportes de la aplicación se debe convertir a abierto el… - [Adjuntar archivos a pagos](https://developer.alegra.com/reference/post_payments-id-attachment-1.md): Endpoint que permite adjuntar archivos a un pago. Para adjuntar un archivo a un pago se debe enviar un request en el cual se debe especificar el header Content-Type como multipart/form-data. Se debe… - [Emitir REP (Recibo Electrónico de Pago)](https://developer.alegra.com/reference/post_payments-id-stamp.md): Endpoint que permite emitir un Recibo Electrónico de Pago (REP) de Costa Rica una vez que se haya creado el pago. El pago debe haber sido creado previamente con una numeración electrónica y debe… - Notas Crédito - [Lista de notas de crédito](https://developer.alegra.com/reference/get_credit-notes.md): Endpoint que permite consultar las notas de crédito registradas en la cuenta de Alegra. Si no se envía límite de notas de crédito por defecto se envían 30. - [Crear nota de crédito](https://developer.alegra.com/reference/post_credit-notes.md): Endpoint que permite crear una nota de crédito desde cero. - [Consultar una nota de crédito](https://developer.alegra.com/reference/get_credit-notes-id.md): Endpoint que permite consultar una nota de crédito registrada en la aplicación. - [Editar nota crédito](https://developer.alegra.com/reference/put_credit-notes-id.md): Endpoint que permite editar una nota de crédito en la aplicación. Únicamente se modifican los atributos que se envían en el request, los otros atributos del objeto que no se envían quedan intactos.… - [Eliminar nota de crédito](https://developer.alegra.com/reference/delete_credit-notes-id.md): Endpoint para eliminar la información de una nota de crédito. - [Enviar nota de crédito por correo](https://developer.alegra.com/reference/post_credit-notes-id-email.md): Enpoint para envíar una nota de crédito por correo. - Notas Débito cliente - [Lista de notas débito cliente](https://developer.alegra.com/reference/get_income-debit-notes.md): Endpoint que permite consultar un listado de notas débito cliente registradas en alegra. - [Crear nota débito cliente](https://developer.alegra.com/reference/post_income-debit-notes.md): Endpoint que permite crear una nota débito cliente desde cero. - [Consultar una nota débito cliente](https://developer.alegra.com/reference/get_income-debit-notes-id.md): Endpoint que permite consultar una nota débito cliente registrada en la aplicación. - [Editar nota débito cliente](https://developer.alegra.com/reference/put_income-debit-notes-id.md): Endpoint que permite editar una nota débito cliente en la aplicación. Únicamente se modifican los atributos que se envían en el request, los otros atributos del objeto que no se envían quedan… - [Eliminar nota débito cliente](https://developer.alegra.com/reference/delete_income-debit-notes-id.md): Endpoint para eliminar la información de una nota débito cliente. - [Anular nota débito cliente](https://developer.alegra.com/reference/post_income-debit-notes-id-void.md): Endpoint que permite anular una nota débito cliente. - Cotizaciones - [Lista de cotizaciones](https://developer.alegra.com/reference/get_estimates.md): Endpoint que permite consultar las cotizaciones registradas en la aplicación. - [Crear una cotización](https://developer.alegra.com/reference/post_estimates.md): Endpoint que permite crear una cotización desde cero. - [Consultar una cotización](https://developer.alegra.com/reference/get_estimates-id.md): Endpoint que retorna la cotización registrada en la aplicación y está identificada con el id que se envía como parámetro. - [Editar una cotización](https://developer.alegra.com/reference/put_estimates-id.md): Endpoint para editar una cotización. Únicamente se modifican los atributos que se envían en el request, los otros atributos del objeto que no se envían quedan intactos. Se retorna el pago que se ha… - [Eliminar una cotización](https://developer.alegra.com/reference/delete_estimates-id.md): Endpoint para eliminar la información de una cotización. - [Enviar cotización por correo](https://developer.alegra.com/reference/post_estimates-id-email.md): Enpoint para enviar una cotización por correo - Remisiones - [Lista de remisiones](https://developer.alegra.com/reference/get_remissions.md): Endpoint que permite consultar una remisión registrada en la aplicación. Si no se envía límite de remisiones, por defecto se envían 30 remisiones. Se debe tener en cuenta que el valor máximo para el… - [Crea una remisión](https://developer.alegra.com/reference/post_remissions.md): Endpoint que permite crear una remisión desde cero. - [Consultar una remisión](https://developer.alegra.com/reference/get_remissions-id.md): Endpoint que permite consultar las remisiones registradas en la aplicación. - [Editar una remisión](https://developer.alegra.com/reference/put_remissions-id.md): Endpoint que permite editar una remisión. - [Eliminar una remisión](https://developer.alegra.com/reference/delete_remissions-id.md): Endpoint para eliminar la información de una remisión. - [Abrir remisión](https://developer.alegra.com/reference/post_remissions-id-open.md): Endpoint para abrir una remisión. - [Anular remisión](https://developer.alegra.com/reference/post_remissions-id-void.md): Endpoint para anular una remisión. - [Adjuntar archivos o imágenes](https://developer.alegra.com/reference/post_remissions-id-attachment.md): Adjuntar archivos o imágenes a una remisión - [Eliminar archivos adjuntos](https://developer.alegra.com/reference/delete_remissions-attachment-idattachment.md): Eliminar un archivo adjunto de la remisión - Facturas Globales - [Lista de facturas globales](https://developer.alegra.com/reference/get_global-invoices.md): Endpoint que permite consultar las facturas globales registradas en la aplicación. - [Crear factura global](https://developer.alegra.com/reference/post_global-invoices.md): Endpoint que permite crear una factura global Nota: Las facturas globales son timbradas automáticamente, en caso de error de timbre son creadas en estado Borrador. - [Consultar una factura global](https://developer.alegra.com/reference/get_global-invoices-id.md): Endpoint que permite consultar una factura global registrada en la aplicación - [Editar factura global](https://developer.alegra.com/reference/put_global-invoices-id.md): Endpoint que permite editar una factura global registrada en la aplicación. Únicamente se modifican los atributos que se envían en el request, los otros atributos del objeto que no se envían quedan… - [Eliminar factura global](https://developer.alegra.com/reference/delete_global-invoices-id.md): Endpoint que permite eliminar una factura global registrada en la aplicación - Documentos de traslado - [Lista de documentos de traslado](https://developer.alegra.com/reference/get_transportation-receipts.md): Endpoint que permite consultar los documentos de traslado registrados en la aplicación. - [Crear un documento de traslado](https://developer.alegra.com/reference/post_transportation-receipts.md): Endpoint que permite registrar un documento de traslado en la aplicación. - [Consultar un documento de traslado](https://developer.alegra.com/reference/get_transportation-receipts-id.md): Endpoint que permite consultar un documento de traslado registrada en la aplicación. Retorna toda la información asociada al ID del documento de traslado que se envía como parámetro. - [Editar documento de traslado](https://developer.alegra.com/reference/put_transportation-receipts-id.md): Endpoint que permite editar un documento de traslado. Únicamente se modifican los atributos que se envían en el request, los otros atributos del objeto que no se envían quedan intactos. Se retorna… - [Eliminar documento de traslado](https://developer.alegra.com/reference/delete_transportation-receipts-id.md): Endpoint que permite eliminar un documento de traslado en estado borrador/draft. - [Enviar documento por correo](https://developer.alegra.com/reference/post_transportation-receipts-id-email.md): Endpoint para envíar un documento de traslado por correo. - [Adjuntar archivos a un documento de traslado](https://developer.alegra.com/reference/post_transportation-receipts-id-attachment.md): Para adjuntar un archivo a un documento de traslado se debe enviar un request en el cual se debe especificar el header Content-Type como multipart/form-data. Se debe tener en cuenta que solo se… - [Eliminar archivos adjuntos](https://developer.alegra.com/reference/delete_transportation-receipts-attachment-idattachment.md): Eliminar un archivo adjunto de un documento de traslado - [Abrir documento de traslado](https://developer.alegra.com/reference/post_transportation-receipts-id-open.md): Endpoint que permite revertir la anulación de una factura. Nota: En caso de no enviar el objeto stamp se asume que se desea abrir la factura sin timbrar. - [Anular documento de traslado](https://developer.alegra.com/reference/post_transportation-receipts-id-void.md): Endpoint que permite anular un documento de traslado. - [Vista previa de un documento de traslado](https://developer.alegra.com/reference/post_transportation-receipts-preview.md): Endpoint que permite generar la url para consultar el pdf de la vista previa de la creación del documento de traslado. - Facturas recurrentes - [Lista de facturas recurrentes](https://developer.alegra.com/reference/get_recurring-invoices.md): Endpoint que retorna las facturas recurrentes registradas en la cuenta de Alegra. Si no se envía límite de facturas, por defecto se envían 30 facturas. - [Crea una factura recurrente](https://developer.alegra.com/reference/post_recurring-invoices.md): Endpoint que permite crear una factura recurrente. - [Consultar una factura recurrente](https://developer.alegra.com/reference/get_recurring-invoices-id.md): Endpoint que permite consultar una factura recurrente registrada en la aplicación. Retorna toda la información asociada al ID de la factura recurrente que se envía como parámetro. - [Editar una factura recurrente](https://developer.alegra.com/reference/put_recurring-invoices-id.md): Endpoint que permite editar una factura recurrente. Únicamente se modifican los atributos que se envían en el request, los otros atributos del objeto que no se envían quedan intactos. Se retorna la… - [Eliminar una factura recurrente](https://developer.alegra.com/reference/delete_recurring-invoices-id.md): Endpoint que permite eliminar una factura recurrente. ## Documentación: Gastos - Facturas de proveedor - [Lista de facturas de proveedor](https://developer.alegra.com/reference/get_bills.md): Endpoint que permite consultar las facturas de proveedor registradas en la aplicación - [Crear una factura de proveedor](https://developer.alegra.com/reference/post_bills.md): Endpoint que permite crear una factura de proveedor en la aplicación - [Consultar una factura de proveedor](https://developer.alegra.com/reference/get_bills-id.md): Este endpoint permite consultar una factura de proveedor registrada en la aplicación, mediante su identificador - [Editar una factura de proveedor](https://developer.alegra.com/reference/put_bills-id.md): Este endpoint permite editar una factura de proveedor registrada en la aplicación, mediante su identificador. Únicamente se modifican los atributos que se envían en el request, los otros atributos… - [Eliminar una factura de proveedor](https://developer.alegra.com/reference/delete_bills-id.md): Este endpoint permite eliminar una factura de proveedor registrada en la aplicación, mediante su identificador - [Adjuntar un archivo](https://developer.alegra.com/reference/post_bills-id-attachment.md): Este endpoint permite adjuntar un archivo a factura de proveedor registrada en la aplicación, mediante su identificador - [Eliminar un archivo](https://developer.alegra.com/reference/delete_bills-attachment-attachment-id.md): Este endpoint permite eliminar un archivo adjunto - [Cerrar con saldo pendiente](https://developer.alegra.com/reference/post_bills-id-close.md): Este endpoint permite cerrar una factura de proveedor registrada en la aplicación, mediante su identificador. Se crea un comprobante contable y se da por ganado el saldo pendiente. - [Agregar un nuevo comentario a una factura de proveedor](https://developer.alegra.com/reference/post_bills-id-comments.md): Este endpoint permite crear un nuevo comentario sobre una factura de proveedor registrada en la aplicación, mediante su identificador. - Comprobantes recibidos - [Listar personas receptoras](https://developer.alegra.com/reference/get_receivers-for-stamp-documents.md): Consulta las personas receptoras de comprobantes registradas para Colombia. - [Registrar una persona receptora](https://developer.alegra.com/reference/post_receivers-for-stamp-documents.md): Registra una persona receptora de comprobantes para Colombia. Su información se puede utilizar en los eventos que requieren receiverInfo. Para consultar su identificador, solicita fields=idGlobal al… - [Consultar una persona receptora](https://developer.alegra.com/reference/get_receivers-for-stamp-documents-receiverid.md): Consulta una persona receptora de comprobantes para Colombia mediante su identificador. - [Listar comprobantes recibidos](https://developer.alegra.com/reference/get_stamp-documents-received.md): Consulta los comprobantes del buzón de recepción para Colombia. - [Consultar un comprobante recibido](https://developer.alegra.com/reference/get_stamp-documents-received-id.md): Consulta un comprobante recibido en Colombia, mediante su identificador. - [Emitir respuesta](https://developer.alegra.com/reference/post_stamp-documents-received-id-response.md): Emite una respuesta a un comprobante recibido en Colombia. Elige una de las cuatro respuestas y completa su formulario: - Acuse de recibo (ACKNOWLEDGMENT): confirma la recepción del comprobante. -… - Órdenes de compra - [Retorna la lista de órdenes de compra](https://developer.alegra.com/reference/listpurchaseorders.md): Endpoitn para obtener una lista de ordenes de compra - [Crear una orden de compra](https://developer.alegra.com/reference/createpurchaseorder.md): Endpoint para crear una orden de compra - [Consultar una una orden de compra](https://developer.alegra.com/reference/get_purchase-orders-id.md): Endpoint para obener una orden de compra especifica - [Editar una orden de compra](https://developer.alegra.com/reference/put_purchase-orders-id.md): Este endpoint permite editar una orden de compra registrada en la aplicación, mediante su identificador. Únicamente se modifican los atributos que se envían en el request, los otros atributos del… - [Eliminar una orden de compra](https://developer.alegra.com/reference/delete_purchase-orders-id.md): Este endpoint permite eliminar una orden de compra registrada en la aplicación, mediante su identificador - [Anular orden de compra](https://developer.alegra.com/reference/post_purchase-orders-id-void.md): Este endpoint permite anular una orden de compra registrada en la aplicación, mediante su identificador. - [Adjuntar un archivo](https://developer.alegra.com/reference/post_purchase-orders-id-attachment.md): Este endpoint permite adjuntar un archivo a una orden de compra registrada en la aplicación, mediante su identificador - [Eliminar un archivo](https://developer.alegra.com/reference/delete_purchase-orders-attachment-attachment-id.md): Este endpoint permite eliminar un archivo adjunto - Notas de débito - [Consultar notas de débito](https://developer.alegra.com/reference/get_debit-notes.md): Este endpoint permite consultar todas las notas de débito registradas en la aplicación - [Crear una nota de débito](https://developer.alegra.com/reference/post_debit-notes.md): Este endpoint permite registrar una nueva nota de débito en la aplicación - [Consultar una nota de débito](https://developer.alegra.com/reference/get_debit-notes-id.md): Este endpoint permite consultar una nota de débito registrada en la aplicación, mediante su identificador - [Editar una nota de débito](https://developer.alegra.com/reference/put_debit-notes-id.md): Este endpoint permite editar una nota de débito registrada en la aplicación, mediante su identificador - [Eliminar una nota de débito](https://developer.alegra.com/reference/delete_debit-notes-id.md): Este endpoint permite eliminar una nota de débito registrada en la aplicación, mediante su identificador. La nota débito no podrá ser eliminada si posee alguna factura de proveedor asociada que este… - Pagos - [Consultar pagos](https://developer.alegra.com/reference/get_payments.md): Endpoint que permite consultar los pagos registrados en la aplicación - [Crear un nuevo pago](https://developer.alegra.com/reference/post_payments.md): Este endpoint permite registrar un nuevo pago en la aplicación - [Consultar un pago](https://developer.alegra.com/reference/get_payments-id.md): Endpoint que permite consultar un pago registrado en la aplicación, mediante su identificador - [Editar un pago](https://developer.alegra.com/reference/put_payments-id.md): Este endpoint permite editar un pago registrado en la aplicación, mediante su identificador - [Eliminar un pago](https://developer.alegra.com/reference/delete_payments-id.md): Este endpoint permite eliminar un pago registrado en la aplicación, mediante su identificador. - [Anular un pago](https://developer.alegra.com/reference/post_payments-id-void.md): Endpoint que anula un pago mediante su id. La anulación de pagos sirve para mantener registro del pago en la aplicación pero que este documento no tenga efecto en la contabilidad o reportes de la… - [Convertir pago a abierto](https://developer.alegra.com/reference/post_payments-id-open.md): Endpoint que permite revertir la anulación de un pago. Para revertir la anulación de un pago y que éste tenga efecto en la contabilidad y reportes de la aplicación se debe convertir a abierto el… - [Adjuntar un archivo](https://developer.alegra.com/reference/post_payments-id-attachment.md): Este endpoint permite adjuntar un archivo a un pago registrado en la aplicación, mediante su identificador - Pagos recurrentes - [Consultar pagos recurrentes](https://developer.alegra.com/reference/get_recurring-payments.md): Endpoint que permite consultar los pagos registrados en la aplicación - [Consultar un pago recurrente](https://developer.alegra.com/reference/get_recurring-payments-id.md): Endpoint que permite consultar un pago registrado en la aplicación, mediante su identificador ## Documentación: Inventario - Ítems - [Listado de items](https://developer.alegra.com/reference/get_items.md): Endpoint que permite consultar los productos o servicios registrados en la aplicación - [Crear ítem](https://developer.alegra.com/reference/post_items.md): Endpoint que permite crear un producto o servicio - [Eliminar ítem](https://developer.alegra.com/reference/delete_items.md): Endpoint que permite eliminar varios productos y/o servicios. - [Consultar un ítem](https://developer.alegra.com/reference/get_items-id.md): Endpoint que permite consultar un producto o servicio registrado en la aplicación - [Editar ítem](https://developer.alegra.com/reference/put_items-id.md): Endpoint que permite editar un producto o servicio registrado en la aplicación - [Eliminar ítem](https://developer.alegra.com/reference/delete_items-id.md): Endpoint que permite eliminar un producto o servicio registrado en la aplicación - [Adjuntar un archivo a un ítem](https://developer.alegra.com/reference/post_items-id-attachment.md): Endpoint que permite adjuntar un archivo a un producto o servicio registrado en la aplicación. Para adjuntar una imagen o un archivo a un producto o servicio se debe enviar un request en el cual se… - [Eliminar un adjunto de un ítem](https://developer.alegra.com/reference/delete_items-attachment-idattachment.md): Endpoint que permite eliminar un archivo de un producto o servicio registrado en la aplicación - Bodegas - [Listado de bodegas](https://developer.alegra.com/reference/get_warehouses.md): Endpoint que permite consultar las bodegas registradas en la aplicación - [Crear bodega](https://developer.alegra.com/reference/post_warehouses.md): Endpoint que permite crear una bodega - [Consultar bodega](https://developer.alegra.com/reference/get_warehouses-id.md): Endpoint que permite consultar una bodega registrada en la aplicación - [Editar bodega](https://developer.alegra.com/reference/put_warehouses-id.md): Endpoint que permite editar una bodega - [Eliminar bodega](https://developer.alegra.com/reference/delete_warehouses-id.md): Endpoint que permite eliminar una bodega registrada en la aplicación - Transferencia de bodegas - [Listado de transferencias de bodegas](https://developer.alegra.com/reference/get_warehouse-transfers.md): Endpoint que permite consultar las transferencias de bodegas registradas en la aplicación - [Crear transferencia de bodegas](https://developer.alegra.com/reference/post_warehouse-transfers.md): Endpoint que permite crear una transferencia de bodegas. - [Consultar una transferencia de bodegas](https://developer.alegra.com/reference/get_warehouse-transfers-id.md): Endpoint que permite consultar una transferencia de bodegas registrada en la aplicación - [Editar transferencia de bodegas](https://developer.alegra.com/reference/put_warehouse-transfers-id.md): Endpoint que permite editar una transferencia de bodegas - [Eliminar transferencia de bodegas](https://developer.alegra.com/reference/delete_warehouse-transfers-id.md): Endpoint que permite eliminar una transferencia de bodegas registrada en la aplicación - Ajustes de inventario - [Listado de ajustes de inventario](https://developer.alegra.com/reference/get_inventory-adjustments.md): Endpoint que permite consultar los ajustes de inventario registrados en la aplicación - [Crear ajuste de inventario](https://developer.alegra.com/reference/post_inventory-adjustments.md): Endpoint que permite crear un ajuste de inventario. - [Consultar ajuste de inventario](https://developer.alegra.com/reference/get_inventory-adjustments-id.md): Endpoint que permite consultar un ajuste de inventario registrado en la aplicación - [Editar ajuste de inventario](https://developer.alegra.com/reference/put_inventory-adjustments-id.md): Endpoint que permite editar un ajuste de inventario - [Eliminar ajuste de inventario](https://developer.alegra.com/reference/delete_inventory-adjustments-id.md): Endpoint que permite eliminar un ajuste de inventario - [Listar numeraciones de ajustes de inventario](https://developer.alegra.com/reference/get_inventory-adjustments-numerations.md): Endpoint que permite listar las numeraciones de ajuste de inventario. - [Crear numeración de ajuste de inventario](https://developer.alegra.com/reference/post_inventory-adjustments-numerations.md): Endpoint que permite crear una numeración de ajuste de inventario. - [Consultar una numeración de ajuste de inventario](https://developer.alegra.com/reference/get_inventory-adjustments-numerations-id.md): Endpoint que permite consultar una numeración de ajuste de inventario - [Editar numeración de ajuste de inventario](https://developer.alegra.com/reference/put_inventory-adjustments-numerations-id.md): Endpoint que permite editar una numeración de ajuste de inventario - [Eliminar numeración de ajuste de inventario](https://developer.alegra.com/reference/delete_inventory-adjustments-numerations-id.md): Endpoint que permite eliminar una numeración de ajuste de inventario - Listas de precios - [Listar listas de precios](https://developer.alegra.com/reference/get_price-lists.md): Endpoint que permite consultar las listas de precios registradas en la aplicación - [Crear lista de precio](https://developer.alegra.com/reference/post_price-lists.md): Endpoint que permite crear una lista de precios - [Consultar lista de precio](https://developer.alegra.com/reference/get_price-lists-id.md): Endpoint que permite consultar una lista de precios registrada en la aplicación - [Editar lista de precio](https://developer.alegra.com/reference/put_price-lists-id.md): Endpoint que permite editar una lista de precios - [Eliminar lista de precio](https://developer.alegra.com/reference/delete_price-lists-id.md): Endpoint que permite eliminar una lista de precios registrada en la aplicación - Campos adicionales - [Listar campos adicionales](https://developer.alegra.com/reference/get_custom-fields.md): Endpoint que permite consultar los campos adicionales registrados en la aplicación. - [Crear campo adicional](https://developer.alegra.com/reference/post_custom-fields.md): Endpoint que permite crear un campo adicional. - [Consultar campo adicional](https://developer.alegra.com/reference/get_custom-fields-id.md): Endpoint que permite consultar un campo adicional registrado en la aplicación - [Editar campo adicional](https://developer.alegra.com/reference/put_custom-fields-id.md): Endpoint que permite editar un campo adicional - [Eliminar campo adicional](https://developer.alegra.com/reference/delete_custom-fields-id.md): Endpoint que permite eliminar un campo adicional registrado en la aplicación - Variantes - [Listado de atributos variantes](https://developer.alegra.com/reference/get_variant-attributes.md): Endpoint que permite consultar las variantes registradas en la aplicación. - [Crear atributos variante](https://developer.alegra.com/reference/post_variant-attributes.md): Endpoint que permite crear una variante. - [Consultar atributos variante](https://developer.alegra.com/reference/get_variant-attributes-id.md): Endpoint que permite consultar una variante registrada en la aplicación - [Editar atributos variante](https://developer.alegra.com/reference/put_variant-attributes-id.md): Endpoint que permite editar una variante - [Eliminar atributos variante](https://developer.alegra.com/reference/delete_variant-attributes-id.md): Endpoint que permite eliminar una variante registrada en la aplicación - Categorías de ítems - [Listado de categoría de items](https://developer.alegra.com/reference/get_item-categories.md): Endpoint que permite consultar las categorías de ítems registradas en la aplicación - [Crear categoría de item](https://developer.alegra.com/reference/post_item-categories.md): Endpoint que permite crear una categoría de ítems. - [Consultar categoría de item](https://developer.alegra.com/reference/get_item-categories-id.md): Endpoint que permite consultar una categoría de ítems registrada en la aplicación - [Editar categoría de item](https://developer.alegra.com/reference/put_item-categories-id.md): Endpoint que permite editar una categoría de ítems - [Eliminar categoría de item](https://developer.alegra.com/reference/delete_item-categories-id.md): Endpoint que permite eliminar una categoría de item registrada en la aplicación - [Adjuntar archivo a una categoría de items](https://developer.alegra.com/reference/post_item-categories-id-attachment.md): Endpoint que permite adjuntar un archivo a una categoría de items registrado en la aplicación. Para adjuntar una imagen o un archivo a una categoría de items se debe enviar un request en el cual se… - [Eliminar un archivo adjunto de una categoría de items](https://developer.alegra.com/reference/delete_item-categories-attachment-idattachment.md): Endpoint que permite eliminar un archivo de una Categoría de ítems registrada en la aplicación ## Documentación: Contactos - Contactos - [Listado de contactos](https://developer.alegra.com/reference/listcontacts-1.md): Endpoint que permite consultar los contactos registrados en la aplicación - [Crear un contacto](https://developer.alegra.com/reference/post_contacts.md): Endpoint que permite crear un contacto en la aplicación - [Eliminar varios contactos](https://developer.alegra.com/reference/deletemultiplecontacts.md): Endpoint que permite eliminar varios contactos en la aplicación Se debe tener en cuenta que un contacto que tenga documentos (facturas de venta, notas crédito, facturas de compra, etc) no puede ser… - [Obtener detalle de un contacto](https://developer.alegra.com/reference/contactsdetails-1.md): Endpoint que permite consultar un contacto registrado en la aplicación - [Editar contacto](https://developer.alegra.com/reference/editcontact.md): Endpoint que permite editar un contacto en la aplicación - [Eliminar contacto](https://developer.alegra.com/reference/deletecontact.md): Endpoint que permite eliminar un contacto en la aplicación - [Restaurar contacto](https://developer.alegra.com/reference/restorecontact.md): Endpoint que permite restaurar un contacto en la aplicación - Adjuntos - [Adjuntar archivos](https://developer.alegra.com/reference/contactsattachment.md): Endpoint que permite adjuntar archivos a un contacto en la aplicación Para adjuntar un archivo a un contacto se debe enviar un request en el cual se debe especificar el header Content-Type como… - [Eliminar archivos adjuntos](https://developer.alegra.com/reference/deleteattachmentcontact.md): Endpoint que permite eliminar archivos a un contacto en la aplicación ## Documentación: Contabilidad - Cuentas contables - [Listar cuentas contables](https://developer.alegra.com/reference/categoriesindex.md): Permite obtener las cuentas contables existentes utilizando filtros y formatos de respuesta para apreciar la jerarquía entre cuentas como se necesite - [Crear cuenta contables](https://developer.alegra.com/reference/categoriescreate.md): Endpoint que permite crear cuentas contables - [Detalle cuenta contable](https://developer.alegra.com/reference/categoriesview.md): Permite obtener una cuenta contable particular a partir de su identificador - [Editar cuenta contable](https://developer.alegra.com/reference/categoriesupdate.md): Endpoint que permite editar cuentas contables - [Listar configuración del catálogo](https://developer.alegra.com/reference/categoriessettingsview.md): Endpoint que permite consultar las configuraciones del catálogo de cuentas contables - [Editar configuraciones del catálogo de cuentas](https://developer.alegra.com/reference/categoriessettingsupdate.md): Endpoint que permite cambiar un valor a las configuraciones del catálogo - Centros de costos - [Listar centros de costos](https://developer.alegra.com/reference/costcentersindex.md): Endpoint que permite consultar todos los centros de costos registrados en la aplicación - [Crear centro de costos](https://developer.alegra.com/reference/costcentercreate.md): Endpoint que permite crear centros de costos - [Consultar un centro de costos](https://developer.alegra.com/reference/costcentersview.md): Endpoint que permite consultar un centro de costos registrado en la aplicación - [Editar un centro de costos](https://developer.alegra.com/reference/costcentersupdate.md): Endpoint que permite editar centros de costos - [Eliminar un centro de costos](https://developer.alegra.com/reference/costcentersdelete.md) - Comprobantes contables - [Lista de comprobantes contables](https://developer.alegra.com/reference/journalsindex.md): Permite consultar los comprobantes contables - [Crear comprobante contable](https://developer.alegra.com/reference/journalscreate.md): Endpoint que permite crear un comprobante contable. En cuentas habilitadas como cuentas por cobrar, cuentas por pagar o anticipos recibidos, cada `entry` puede incluir adicionalmente los objetos… - [Detalle de un comprobante contable](https://developer.alegra.com/reference/journalsview.md): Permite consultar un comprobante contable a partir de su identificador - [Editar un comprobante contable](https://developer.alegra.com/reference/journalsupdate.md): Endpoint que permite editar un comprobante contable - [Eliminar un comprobante contable](https://developer.alegra.com/reference/journalsdelete.md) - Lineas de comprobantes contables - [Recupera los saldos agrupados por mes o dia](https://developer.alegra.com/reference/get_journals-entries-graph.md) ## Documentación: Bancos - Cuentas de banco - [Listado de cuentas bancarias](https://developer.alegra.com/reference/listbankaccounts.md) - [Crear cuenta bancaria](https://developer.alegra.com/reference/createbankaccount.md) - [Consultar una cuenta bancaria](https://developer.alegra.com/reference/bankaccountdetails.md) - [Editar cuenta bancaria](https://developer.alegra.com/reference/bankaccountedit.md) - [Eliminar cuenta bancaria](https://developer.alegra.com/reference/bankaccountdelete.md) - [Realizar una transferencia a otra cuenta bancaria](https://developer.alegra.com/reference/bankaccounttransfer.md) - Conciliaciones - [Listar las conciliaciones](https://developer.alegra.com/reference/listreconciliations.md) - [Crea/actualiza una conciliación](https://developer.alegra.com/reference/createreconciliation.md) - [Consultar una conciliación](https://developer.alegra.com/reference/reconciliationdetails.md) - [Eliminar una conciliación](https://developer.alegra.com/reference/reconciliationdelete.md) ## Documentación: Configuraciones - Impuestos - [Crear un impuesto](https://developer.alegra.com/reference/post_taxes.md): Endpoint que permite crear un impuesto en la cuenta de Alegra. - [Listado de impuestos](https://developer.alegra.com/reference/get_taxes.md): Endpoint que retorna los impuestos registrados en la cuenta de Alegra. Si no se envía límite de impuestos, por defecto se envían 30 impuestos. - [Consultar un impuesto](https://developer.alegra.com/reference/get_taxes-id.md): Endpoint que retorna el detalle de un impuesto registrado en la cuenta de Alegra. - [Editar un impuesto](https://developer.alegra.com/reference/put_taxes-id.md): Endpoint que permite actualizar la información de un impuesto registrado en la cuenta de Alegra. - [Eliminar un impuesto](https://developer.alegra.com/reference/delete_taxes-id.md): Endpoint que permite eliminar un impuesto registrado en la cuenta de Alegra. - Retenciones - [Crear una retención](https://developer.alegra.com/reference/post_retentions.md): Endpoint que permite crear una retención en la cuenta de Alegra. - [Listado de retenciones](https://developer.alegra.com/reference/get_retentions.md): Endpoint que retorna las retenciones registradas en la cuenta de Alegra. Si no se envía límite de retenciones, por defecto se envían 30 retenciones. - [Consultar una retención](https://developer.alegra.com/reference/get_retentions-id.md): Endpoint que retorna el detalle de una retención registrada en la cuenta de Alegra. - [Editar una retención](https://developer.alegra.com/reference/put_retentions-id.md): Endpoint que permite actualizar la información de una retención registrada en la cuenta de Alegra. - [Eliminar una retención](https://developer.alegra.com/reference/delete_retentions-id.md): Endpoint que permite eliminar una retención registrada en la cuenta de Alegra. - Monedas - [Crear una moneda](https://developer.alegra.com/reference/post_currencies.md): Endpoint que permite crear una moneda en la cuenta de Alegra. - [Listado de monedas](https://developer.alegra.com/reference/get_currencies.md): Endpoint que retorna las monedas registradas en la cuenta de Alegra. Si no se envía límite de monedas, por defecto se envían 30 monedas. - [Consultar un moneda](https://developer.alegra.com/reference/get_currencies-code.md): Endpoint que retorna el detalle de una moneda registrada en la cuenta de Alegra. - [Editar una moneda](https://developer.alegra.com/reference/put_currencies-code.md): Endpoint que permite editar la información de una moneda registrada en la cuenta de Alegra. - [Eliminar una moneda](https://developer.alegra.com/reference/delete_currencies-code.md): Endpoint que permite eliminar una moneda registrada en la cuenta de Alegra. - Términos de pago - [Crear un término de pago](https://developer.alegra.com/reference/post_terms.md): Endpoint que permite crear un término de pago en la cuenta de Alegra. - [Listado de términos de pago](https://developer.alegra.com/reference/get_terms.md): Endpoint que retorna los términos de pago registrados en la cuenta de Alegra. Si no se envía límite de términos de pago, por defecto se envían 30 términos de pago. - [Consultar un término de pago](https://developer.alegra.com/reference/get_terms-id.md): Endpoint que retorna el detalle de un término de pago registrado en la cuenta de Alegra. - [Editar un término de pago](https://developer.alegra.com/reference/put_terms-id.md): Endpoint que permite editar la información de un término de pago registrado en la cuenta de Alegra. - [Eliminar un término de pago](https://developer.alegra.com/reference/delete_terms-id.md): Endpoint que permite eliminar un término de pago registrado en la cuenta de Alegra. - Empresa - [Consultar la empresa](https://developer.alegra.com/reference/get_company-1.md): Endpoint que permite consultar la información de la empresa registrada en la cuenta de Alegra. - [Editar la empresa](https://developer.alegra.com/reference/put_company-1.md): Endpoint que permite actualizar la información de la empresa registrada en la cuenta de Alegra. - [Subir un archivo adjunto a la empresa](https://developer.alegra.com/reference/post_company-attachment-1.md): Endpoint que permite subir un archivo adjunto a la empresa registrada en la cuenta de Alegra. - Usuarios - [Crear un usuario](https://developer.alegra.com/reference/post_users.md): Endpoint que permite crear un usuario en la cuenta de Alegra. - [Listado de usuarios](https://developer.alegra.com/reference/get_users.md): Endpoint que retorna los usuarios registrados en la cuenta de Alegra. - [Consultar un usuario](https://developer.alegra.com/reference/get_users-id.md): Endpoint que retorna el detalle de un usuario registrado en la cuenta de Alegra. - [Editar un usuario](https://developer.alegra.com/reference/put_users-id.md): Endpoint que permite editar la información de un usuario registrado en la cuenta de Alegra. - [Eliminar un usuario](https://developer.alegra.com/reference/delete_users-id.md): Endpoint que permite eliminar un usuario registrado en la cuenta de Alegra. - [Editar los metadatos de un usuario](https://developer.alegra.com/reference/put_users-id-metadata-1.md): Endpoint que permite editar los metadatos de un usuario registrado en la cuenta de Alegra. - [Subir un archivo adjunto al usuario autenticado](https://developer.alegra.com/reference/post_users-attachment-1.md): Endpoint que permite subir un archivo adjunto al usuario autenticado en la cuenta de Alegra. - [Consultar el usuario autenticado](https://developer.alegra.com/reference/get_users-self-1.md): Endpoint que retorna el detalle del usuario autenticado en la cuenta de Alegra. - [Editar el usuario autenticado](https://developer.alegra.com/reference/put_users-self-1.md): Endpoint que permite editar la información del usuario autenticado en la cuenta de Alegra. - [Editar los metadatos del usuario autenticado](https://developer.alegra.com/reference/put_users-self-metadata-1.md): Endpoint que permite editar los metadatos del usuario autenticado en la cuenta de Alegra. - Numeraciones de facturación - [Crear una numeración de facturación](https://developer.alegra.com/reference/post_number-templates-1.md): Endpoint que permite crear una numeración de facturación en la cuenta de Alegra. - [Listado de numeraciones de facturación](https://developer.alegra.com/reference/get_number-templates-1.md): Endpoint que retorna las numeraciones de facturación registradas en la cuenta de Alegra. - [Consultar una numeración de facturación](https://developer.alegra.com/reference/get_number-templates-id-1.md): Endpoint que retorna el detalle de una numeración de facturación registrada en la cuenta de Alegra. - [Editar una numeración de facturación](https://developer.alegra.com/reference/put_number-templates-id-1.md): Endpoint que permite editar la información de una numeración de facturación registrada en la cuenta de Alegra. - [Eliminar una numeración de facturación](https://developer.alegra.com/reference/delete_number-templates-id.md): Endpoint que permite eliminar una numeración de facturación registrada en la cuenta de Alegra. ## Documentación: Suscripciones a Webhooks - [Descripción general](https://developer.alegra.com/reference/descripción-general.md) - Crear Suscripción - [Crear una suscripción](https://developer.alegra.com/reference/post_webhooks-subscriptions.md): Suscribirse a un evento de Webhooks. - Listar Suscripciones - [Listar suscripciones](https://developer.alegra.com/reference/get_webhooks-subscriptions.md): Consultar todas las suscripciones de la empresa. - Consultar Suscripción - [Consultar una suscripción](https://developer.alegra.com/reference/get_webhooks-subscriptions-id.md): Consultar una suscripción específica de la empresa. - Editar Suscripción - [Editar una suscripción](https://developer.alegra.com/reference/put_webhooks-subscriptions-id.md): Editar una suscripción de Webhooks. - Eliminar Suscripción - [Eliminar una suscripción](https://developer.alegra.com/reference/delete_webhooks-subscriptions-id.md): Eliminar una suscripción de Webhooks. ## Documentación: Catalogo de parámetros por país - [Colombia](https://developer.alegra.com/reference/colombia.md): Catálogo de parámetros para Colombia - [Costa Rica](https://developer.alegra.com/reference/costa-rica.md): Catálogo de parámetros para Costa Rica - [España](https://developer.alegra.com/reference/españa.md): Catálogo de parámetros para España - [México](https://developer.alegra.com/reference/méxico.md): Catálogo de parámetros para México - [Panamá](https://developer.alegra.com/reference/panamá.md): Catálogo de parámetros para Panamá ## Documentación: API de cargos adicionales : Propina - Cargos adicionales - [Obtener todos los cargos adicionales](https://developer.alegra.com/reference/getalladditionalcharges.md) - [Crear un cargo adicional](https://developer.alegra.com/reference/createadditionalcharge.md) - [Obtener un cargo adicional](https://developer.alegra.com/reference/getadditionalchargebyid.md) - [Actualizar un cargo adicional](https://developer.alegra.com/reference/updateadditionalcharge.md) - [Eliminar un cargo adicional](https://developer.alegra.com/reference/deleteadditionalcharge.md) ## Documentación: MCP Alegra - Maestros - [Ejecutar herramientas MCP](https://developer.alegra.com/reference/mcpexecute.md): Endpoint principal del protocolo MCP (JSON-RPC 2.0). Soporta los métodos `initialize`, `tools/list` y `tools/call`. **Solo lectura:** todas las herramientas son de consulta. El servidor rechaza… - [Conexión SSE](https://developer.alegra.com/reference/mcpsse.md): Establece conexión SSE (Server-Sent Events) para streaming de eventos MCP. - [Cerrar sesión MCP](https://developer.alegra.com/reference/mcpclosesession.md): Termina una sesión MCP activa. - [Health check](https://developer.alegra.com/reference/healthcheck.md): Endpoint de verificación de salud del servidor MCP. - Gastos - [Listar facturas de compra](https://developer.alegra.com/reference/expenses_list-bills.md): Herramienta MCP: `expenses_list-bills`. Lista facturas de compra (gastos) con filtros opcionales de estado, rango de fechas, proveedor, moneda, centro de costos y más. Soporta paginación con `start`… - [Obtener factura de compra](https://developer.alegra.com/reference/expenses_get-bill.md): Herramienta MCP: `expenses_get-bill`. Obtiene una factura de compra (gasto) completa por su ID numérico local de Alegra: proveedor, ítems, impuestos, retenciones, pagos y totales. El `id` es el… - [Obtener nota de débito de compra](https://developer.alegra.com/reference/expenses_get-debit-note.md): Herramienta MCP: `expenses_get-debit-note`. Obtiene una nota de débito de compra por su ID numérico local (el mismo que se usa en las URLs de Alegra). Obtén el `id` con `expenses_list-debit-notes`;… - [Obtener pago saliente](https://developer.alegra.com/reference/expenses_get-outgoing-payment.md): Herramienta MCP: `expenses_get-outgoing-payment`. Obtiene un pago saliente por su ID local, con su detalle completo: cuenta, documento asociado, retenciones y valores. Obtén el `id` con… - [Obtener orden de compra](https://developer.alegra.com/reference/expenses_get-purchase-order.md): Herramienta MCP: `expenses_get-purchase-order`. Obtiene una orden de compra por su ID numérico local. Obtén el `id` con `expenses_list-purchase-orders`; úsalo cuando el usuario consulte una orden… - [Listar notas de débito de compra](https://developer.alegra.com/reference/expenses_list-debit-notes.md): Herramienta MCP: `expenses_list-debit-notes`. Lista notas de débito de compras (cuentas por pagar) con paginación y filtros: proveedor, fecha, estado de emisión, número de documento o tipo de… - [Listar pagos salientes](https://developer.alegra.com/reference/expenses_list-outgoing-payments.md): Herramienta MCP: `expenses_list-outgoing-payments`. Lista pagos salientes (lado de cuentas por pagar) desde la cuenta bancaria o de caja. El tipo siempre es `out`: el servicio lo aplica de forma… - [Listar órdenes de compra](https://developer.alegra.com/reference/expenses_list-purchase-orders.md): Herramienta MCP: `expenses_list-purchase-orders`. Lista órdenes de compra con paginación (`start` por defecto 0, `limit` por defecto 30) y filtros de fechas, estado, nombre del proveedor, ítem,… - Items - [Listar productos y servicios](https://developer.alegra.com/reference/items_getitems.md): Herramienta MCP: `items_getItems`. Devuelve la lista de productos y servicios de la compañía, con filtros opcionales y paginación (máximo 30 por página, por defecto 30). Ejemplo de llamada… - [Obtener campo adicional](https://developer.alegra.com/reference/customfields_getcustomfield.md): Herramienta MCP: `customFields_getCustomField`. Devuelve un campo adicional por su ID, con la opción de incluir campos extra. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc": "2.0", "id": 1,… - [Listar campos adicionales](https://developer.alegra.com/reference/customfields_getcustomfields.md): Herramienta MCP: `customFields_getCustomFields`. Devuelve la lista de campos adicionales de la compañía, con filtros opcionales y paginación. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc":… - [Listar categorías de ítems](https://developer.alegra.com/reference/itemcategories_getitemcategories.md): Herramienta MCP: `itemCategories_getItemCategories`. Devuelve la lista de categorías de productos y servicios, con filtros opcionales y paginación. Ejemplo de llamada JSON-RPC: ```json {… - [Obtener categoría de ítem](https://developer.alegra.com/reference/itemcategories_getitemcategory.md): Herramienta MCP: `itemCategories_getItemCategory`. Devuelve una categoría de productos por su ID, con la opción de incluir campos extra. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc": "2.0",… - [Obtener ítem](https://developer.alegra.com/reference/items_getitem.md): Herramienta MCP: `items_getItem`. Devuelve un producto o servicio por su ID, con la opción de incluir campos extra. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc": "2.0", "id": 1,… - [Listar listas de precios](https://developer.alegra.com/reference/pricelist_getpricelists.md): Herramienta MCP: `priceList_getPriceLists`. Devuelve la lista de listas de precios de la compañía. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call",… - [Obtener atributo de variante](https://developer.alegra.com/reference/variant_getvariantattribute.md): Herramienta MCP: `variant_getVariantAttribute`. Devuelve un atributo de variante por su ID numérico. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call",… - [Listar atributos de variante](https://developer.alegra.com/reference/variant_getvariantattributes.md): Herramienta MCP: `variant_getVariantAttributes`. Devuelve la lista de atributos de variante (por ejemplo `Color`, `Talla`), con filtros opcionales y paginación. Ejemplo de llamada JSON-RPC:… - [Obtener bodega](https://developer.alegra.com/reference/warehouses_getwarehouse.md): Herramienta MCP: `warehouses_getWarehouse`. Devuelve una bodega por su ID, con la opción de incluir campos extra. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc": "2.0", "id": 1, "method":… - [Listar bodegas](https://developer.alegra.com/reference/warehouses_getwarehouses.md): Herramienta MCP: `warehouses_getWarehouses`. Devuelve la lista de bodegas de la compañía, con filtros opcionales y paginación. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc": "2.0", "id": 1,… - [Consultar stock de un ítem](https://developer.alegra.com/reference/itemsstock_get_item_stock.md): Herramienta MCP: `itemsStock_get_item_stock`. Devuelve la cantidad de stock de un solo ítem, con desglose opcional por bodega. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc": "2.0", "id": 1,… - [Resumir stock por condición](https://developer.alegra.com/reference/itemsstock_get_item_stock_summary.md): Herramienta MCP: `itemsStock_get_item_stock_summary`. Devuelve el stock de varios ítems según una condición de existencias (stock negativo, en cero, bajo o actual). Ejemplo de llamada JSON-RPC:… - [Obtener transferencia entre bodegas](https://developer.alegra.com/reference/warehousestransfers_getwarehousetransfer.md): Herramienta MCP: `warehousesTransfers_getWarehouseTransfer`. Devuelve una transferencia entre bodegas por su ID. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc": "2.0", "id": 1, "method":… - [Listar transferencias entre bodegas](https://developer.alegra.com/reference/warehousestransfers_getwarehousetransfers.md): Herramienta MCP: `warehousesTransfers_getWarehouseTransfers`. Devuelve la lista de transferencias entre bodegas, con filtros opcionales y paginación. Ejemplo de llamada JSON-RPC: ```json {… - [Obtener ajuste de inventario](https://developer.alegra.com/reference/inventoryadjustments_getinventoryadjustment.md): Herramienta MCP: `inventoryAdjustments_getInventoryAdjustment`. Devuelve un ajuste de inventario por su ID, con la opción de incluir campos extra. Ejemplo de llamada JSON-RPC: ```json {… - [Obtener numeración de ajuste de inventario](https://developer.alegra.com/reference/inventoryadjustments_getinventoryadjustmentnumeration.md): Herramienta MCP: `inventoryAdjustments_getInventoryAdjustmentNumeration`. Devuelve una numeración de ajustes de inventario por su ID, con la opción de incluir campos extra. Ejemplo de llamada… - [Listar numeraciones de ajustes de inventario](https://developer.alegra.com/reference/inventoryadjustments_getinventoryadjustmentnumerations.md): Herramienta MCP: `inventoryAdjustments_getInventoryAdjustmentNumerations`. Devuelve la lista de numeraciones (esquemas de numeración) de ajustes de inventario, con filtros opcionales. Ejemplo de… - [Listar ajustes de inventario](https://developer.alegra.com/reference/inventoryadjustments_getinventoryadjustments.md): Herramienta MCP: `inventoryAdjustments_getInventoryAdjustments`. Devuelve la lista de ajustes de inventario, con filtros opcionales por fecha, bodega, número y observaciones. Ejemplo de llamada… - Config - [Consultar claves de producto](https://developer.alegra.com/reference/config_getproductkeys.md): Herramienta MCP: `config_getProductKeys`. Devuelve los códigos de claves de producto disponibles para clasificar ítems, con filtros opcionales de búsqueda y cantidad de resultados. Ejemplo de… - [Listar unidades de medida](https://developer.alegra.com/reference/config_getunits.md): Herramienta MCP: `config_getUnits`. Devuelve las unidades de medida disponibles en Alegra para asignar a ítems, con filtros opcionales de búsqueda, idioma y cantidad de resultados. Ejemplo de… - Contacts - [Listar contactos](https://developer.alegra.com/reference/contacts_getcontacts.md): Herramienta MCP: `contacts_getContacts`. Lista los contactos de la cuenta (clientes, proveedores o ambos) con filtros opcionales y paginación. Los filtros se envían dentro del objeto `params` (p.… - [Obtener contacto por nombre](https://developer.alegra.com/reference/contacts_getcontactbyname.md): Herramienta MCP: `contacts_getContactByName`. Busca un contacto por su nombre y retorna los datos del primer resultado encontrado. Requiere un `name` no vacío. Ejemplo de llamada JSON-RPC: ```json… - Invoices - [Exportar facturas](https://developer.alegra.com/reference/invoice_createinvoicesexportable.md): Herramienta MCP: `invoice_createInvoicesExportable`. Genera un archivo exportable de facturas o tiquetes de venta. Úsalo en lugar de paginar `invoice_getInvoices` cuando el usuario necesite un… - [Consultar estado DGI de factura](https://developer.alegra.com/reference/invoice_getdgistatus.md): Herramienta MCP: `invoice_getDGIStatus`. Solo lectura. Exclusiva de Panamá: solo está disponible cuando la empresa de Alegra es panameña. Consulta el estado de facturación electrónica ante la DGI… - [Obtener actividades económicas](https://developer.alegra.com/reference/invoice_geteconomicactivities.md): Herramienta MCP: `invoice_getEconomicActivities`. Solo lectura. Exclusiva de Costa Rica: solo está disponible cuando la empresa de Alegra es costarricense. Obtiene las actividades económicas del… - [Obtener factura por ID](https://developer.alegra.com/reference/invoice_getinvoicebyid.md): Herramienta MCP: `invoice_getInvoiceById`. Obtiene una factura de venta completa por su ID interno de Alegra: ítems, impuestos, pagos, numeración y cliente, además de los campos de facturación… - [Obtener factura por número](https://developer.alegra.com/reference/invoice_getinvoicebynumber.md): Herramienta MCP: `invoice_getInvoiceByNumber`. Obtiene una factura de venta por su número completo (por ejemplo, "FE-15" o el NCF) y devuelve el detalle completo. Úsalo cuando el usuario indique el… - [Obtener facturas](https://developer.alegra.com/reference/invoice_getinvoices.md): Herramienta MCP: `invoice_getInvoices`. Lista facturas de venta con filtros opcionales y paginación (`start` y `limit`, máximo 30 por página). Por defecto devuelve una versión ligera de cada… - [Obtener tipos de pago](https://developer.alegra.com/reference/invoice_getpaymenttypes.md): Herramienta MCP: `invoice_getPaymentTypes`. Obtiene los tipos de pago disponibles para facturar (por ejemplo, Contado, Crédito o Gratuito), según la normativa DGII de República Dominicana.… - [Consultar estado SAT de factura](https://developer.alegra.com/reference/invoice_getsatstatus.md): Herramienta MCP: `invoice_getSATStatus`. Solo lectura. Exclusiva de México: solo está disponible cuando la empresa de Alegra es mexicana. Consulta el estado de timbrado SAT de UNA factura por su ID… - [Listar facturas rechazadas por DGI](https://developer.alegra.com/reference/invoice_listrejecteddgi.md): Herramienta MCP: `invoice_listRejectedDGI`. Solo lectura. Exclusiva de Panamá: solo está disponible cuando la empresa de Alegra es panameña. Lista las facturas que la DGI rechazó (`emissionStatus`… - [Listar facturas rechazadas por SAT](https://developer.alegra.com/reference/invoice_listrejectedsat.md): Herramienta MCP: `invoice_listRejectedSAT`. Solo lectura. Exclusiva de México: solo está disponible cuando la empresa de Alegra es mexicana. Lista las facturas cuyo timbrado SAT fue rechazado… - Banks - [Listar cuentas bancarias](https://developer.alegra.com/reference/banks_getbanks.md): Herramienta MCP: `banks_getBanks`. Lista las cuentas bancarias y de caja de la compañía con filtros opcionales y paginación. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc": "2.0", "id": 1,… - [Obtener cuenta bancaria por id](https://developer.alegra.com/reference/banks_getbanksbyid.md): Herramienta MCP: `banks_getBanksById`. Obtiene una cuenta bancaria o de caja por su identificador: datos de la cuenta, banco, número de cuenta, tipo y estado. Ejemplo de llamada JSON-RPC: ```json… - [Buscar cuenta bancaria por nombre](https://developer.alegra.com/reference/banks_getbanksbyname.md): Herramienta MCP: `banks_getBanksByName`. Busca una cuenta bancaria por su nombre y retorna los datos de la primera cuenta que coincide. Requiere un `name` no vacío. Ejemplo de llamada JSON-RPC:… - [Obtener conciliación bancaria](https://developer.alegra.com/reference/banks_getreconciliationbyid.md): Herramienta MCP: `banks_getReconciliationById`. Obtiene una conciliación bancaria por su identificador, con su estado, fecha, cuenta y balance. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc":… - [Listar conciliaciones bancarias](https://developer.alegra.com/reference/banks_getreconciliations.md): Herramienta MCP: `banks_getReconciliations`. Lista las conciliaciones bancarias de la compañía con filtros opcionales y paginación. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc": "2.0",… - [Listar movimientos de una cuenta bancaria](https://developer.alegra.com/reference/banks_gettransactions.md): Herramienta MCP: `banks_getTransactions`. Lista los movimientos de una cuenta bancaria: transacciones, comprobantes de diario y ajustes por diferencia en cambio. Ejemplo de llamada JSON-RPC:… - Income Payments - [Obtener pago recibido](https://developer.alegra.com/reference/incomepayments_getincomepaymentbyid.md): Herramienta MCP: `incomePayments_getIncomePaymentById`. Devuelve un pago del libro de pagos de ingresos a partir de su `id`, con el payload completo (categorías, facturas aplicadas, retenciones,… - [Listar pagos recibidos](https://developer.alegra.com/reference/incomepayments_getincomepayments.md): Herramienta MCP: `incomePayments_getIncomePayments`. Devuelve los pagos registrados en el libro de pagos de ingresos, con paginación (hasta 30 por página) y filtros. Por defecto devuelve una versión… - Sales Documents - [Obtener nota de crédito de venta](https://developer.alegra.com/reference/creditnotes_getcreditnote.md): Herramienta MCP: `creditNotes_getCreditNote`. Obtiene una nota de crédito de venta por su ID local de Alegra y devuelve el documento completo: fecha, estado de Alegra, tipo de nota de crédito,… - [Listar notas de crédito de venta](https://developer.alegra.com/reference/creditnotes_listcreditnotes.md): Herramienta MCP: `creditNotes_listCreditNotes`. Lista notas de crédito de venta: los documentos que reducen lo que un cliente debe sobre facturas de venta ya emitidas (devoluciones, anulaciones,… - [Obtener cotización](https://developer.alegra.com/reference/estimates_getestimatebyid.md): Herramienta MCP: `estimates_getEstimateById`. Obtiene una cotización (estimate) por su ID y devuelve el payload completo (ítems, impuestos, etc.), sin mapeo ligero. Obtén el `id` con… - [Obtener PDF de cotización](https://developer.alegra.com/reference/estimates_getestimatepdf.md): Herramienta MCP: `estimates_getEstimatePdf`. Devuelve el enlace de descarga del PDF de una cotización existente. Responde `{ pdf, number }`, donde `pdf` es una URL firmada de corta vida — ten en… - [Obtener cotizaciones](https://developer.alegra.com/reference/estimates_getestimates.md): Herramienta MCP: `estimates_getEstimates`. Obtiene cotizaciones (estimates) paginadas, máximo 30 por página. Por defecto devuelve una versión ligera de cada cotización; con `detail: true` añade los… - [Obtener factura global](https://developer.alegra.com/reference/globalinvoices_getglobalinvoice.md): Herramienta MCP: `globalInvoices_getGlobalInvoice`. Obtiene una factura global mexicana ("factura global") por su ID local de Alegra y devuelve el documento completo: fecha, estado, numeración,… - [Listar facturas globales](https://developer.alegra.com/reference/globalinvoices_listglobalinvoices.md): Herramienta MCP: `globalInvoices_listGlobalInvoices`. Lista facturas globales mexicanas ("facturas globales"): los documentos CFDI que agrupan muchos tiquetes de venta (tiquetes de venta) emitidos… - [Obtener nota débito de venta](https://developer.alegra.com/reference/incomedebitnotes_income_get-debit-note-by-id.md): Herramienta MCP: `incomeDebitNotes_income_get-debit-note-by-id`. Obtiene una nota débito de venta por su ID y devuelve el payload completo (ítems, impuestos, etc.), sin mapeo ligero. Úsala cuando… - [Obtener notas débito de venta](https://developer.alegra.com/reference/incomedebitnotes_income_get-debit-notes.md): Herramienta MCP: `incomeDebitNotes_income_get-debit-notes`. Obtiene o busca notas débito de venta, paginadas (máximo 30 por página). Por defecto devuelve una versión ligera de cada nota débito (IDs,… - [Obtener factura recurrente](https://developer.alegra.com/reference/recurringinvoices_getrecurringinvoicebyid.md): Herramienta MCP: `recurringInvoices_getRecurringInvoiceById`. Obtiene una factura recurrente por su ID y devuelve el payload completo, incluidos los ítems. Obtén el `id` con… - [Obtener facturas recurrentes](https://developer.alegra.com/reference/recurringinvoices_getrecurringinvoices.md): Herramienta MCP: `recurringInvoices_getRecurringInvoices`. Lista facturas recurrentes (paginadas, máximo 30 por página). Permite filtrar por nombre del cliente (`name`, coincidencia de nombre, no… - [Obtener remisión](https://developer.alegra.com/reference/remissions_getremissionbyid.md): Herramienta MCP: `remissions_getRemissionById`. Obtiene una remisión por su ID y devuelve el payload completo (ítems, impuestos, etc.), sin mapeo ligero. Obtén el `id` con… - [Obtener PDF de remisión](https://developer.alegra.com/reference/remissions_getremissionpdf.md): Herramienta MCP: `remissions_getRemissionPdf`. Obtiene el PDF de una remisión existente. Devuelve la URL de descarga y el número del documento. La URL es de corta vida: entrégasela al usuario en… - [Obtener remisiones](https://developer.alegra.com/reference/remissions_getremissions.md): Herramienta MCP: `remissions_getRemissions`. Obtiene remisiones (paginadas, máximo 30 por página). Por defecto devuelve una versión ligera de cada remisión; con `detail: true` devuelve la fila… - Income Catalogs - [Obtener usos CFDI](https://developer.alegra.com/reference/incomeresources_getcfdiuses.md): Herramienta MCP: `incomeResources_getCfdiUses`. Obtiene el catálogo de usos CFDI del SAT (solo México). `value` es la etiqueta en lenguaje natural que se muestra al usuario; `id`/`key`/`code` es el… - [Obtener regímenes de la empresa](https://developer.alegra.com/reference/incomeresources_getcompanyregimes.md): Herramienta MCP: `incomeResources_getCompanyRegimes`. Obtiene el catálogo de regímenes fiscales/de empresa del país de la cuenta actual. `value` es la etiqueta en lenguaje natural que se muestra al… - [Obtener tipos de descuento](https://developer.alegra.com/reference/incomeresources_getdiscounttypes.md): Herramienta MCP: `incomeResources_getDiscountTypes`. Obtiene el catálogo de tipos/naturalezas de descuento (solo Costa Rica). `value` es la etiqueta en lenguaje natural que se muestra al usuario;… - [Obtener actividades económicas](https://developer.alegra.com/reference/incomeresources_geteconomicactivities.md): Herramienta MCP: `incomeResources_getEconomicActivities`. Obtiene el catálogo de actividades económicas del país de la cuenta actual. `value` es la etiqueta en lenguaje natural que se muestra al… - [Obtener tipos de operación](https://developer.alegra.com/reference/incomeresources_getoperationtypes.md): Herramienta MCP: `incomeResources_getOperationTypes`. Obtiene el catálogo de tipos de operación del país de la cuenta actual. `value` es la etiqueta en lenguaje natural que se muestra al usuario;… - [Obtener formas de pago](https://developer.alegra.com/reference/incomeresources_getpaymentmethods.md): Herramienta MCP: `incomeResources_getPaymentMethods`. Obtiene el catálogo de formas de pago (forma de pago) del país de la cuenta actual. `value` es la etiqueta en lenguaje natural que se muestra al… - [Obtener tipos de pago](https://developer.alegra.com/reference/incomeresources_getpaymenttypes.md): Herramienta MCP: `incomeResources_getPaymentTypes`. Obtiene el catálogo de tipos de pago (por ejemplo PUE/PPD de México) del país de la cuenta actual. `value` es la etiqueta en lenguaje natural que… - [Obtener condiciones de venta](https://developer.alegra.com/reference/incomeresources_getsaleconditions.md): Herramienta MCP: `incomeResources_getSaleConditions`. Obtiene el catálogo de condiciones de venta (condición de venta / forma de pago) del país de la cuenta actual. `value` es la etiqueta en… - Operational Tools - [Obtener tarea](https://developer.alegra.com/reference/taskmanager_gettask.md): Herramienta MCP: `taskManager_getTask`. Obtiene el detalle completo de una tarea del gestor de tareas de Alegra a partir de su ID. Úsala cuando ya conoces el ID de la tarea. Si solo conoces el… - [Listar tareas](https://developer.alegra.com/reference/taskmanager_listtasks.md): Herramienta MCP: `taskManager_listTasks`. Lista todas las tareas del gestor de tareas de Alegra para el usuario o la empresa autenticada. Cada elemento devuelve sus atributos principales: `id`,… - [Obtener término de pago](https://developer.alegra.com/reference/terms_getterm.md): Herramienta MCP: `terms_getTerm`. Obtiene un término de pago (plazo de pago) por su ID. Úsala cuando ya conoces el ID del término. Si el usuario describe el plazo en lenguaje natural (por ejemplo… - [Listar términos de pago](https://developer.alegra.com/reference/terms_getterms.md): Herramienta MCP: `terms_getTerms`. Lista los términos de pago configurados en la cuenta (por ejemplo "De contado", "30 días" o "60 días"). Úsala para resolver un término que el usuario describe en… - [Obtener documento de traslado](https://developer.alegra.com/reference/transportationreceipts_gettransportationreceipt.md): Herramienta MCP: `transportationReceipts_getTransportationReceipt`. Obtiene un documento de traslado de México ("documento de traslado" o carta porte) por su ID de Alegra y devuelve el documento… - [Listar documentos de traslado](https://developer.alegra.com/reference/transportationreceipts_listtransportationreceipts.md): Herramienta MCP: `transportationReceipts_listTransportationReceipts`. Lista los documentos de traslado de México ("documentos de traslado" o CFDI de traslado con el Complemento Carta Porte del SAT),… - Resolutions - [Consultar resolución predeterminada](https://developer.alegra.com/reference/resolutions_getdefaultresolutions.md): Herramienta MCP: `resolutions_getDefaultResolutions`. Devuelve la resolución de numeración predeterminada de la compañía para un tipo de documento específico. Ejemplo de llamada JSON-RPC: ```json… - [Obtener resolución de numeración](https://developer.alegra.com/reference/resolutions_getresolutionbyid.md): Herramienta MCP: `resolutions_getResolutionById`. Devuelve una resolución de numeración específica a partir de su `id`. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc": "2.0", "id": 1,… - [Listar resoluciones de numeración](https://developer.alegra.com/reference/resolutions_getresolutionss.md): Herramienta MCP: `resolutions_getResolutionss`. Devuelve las resoluciones de numeración (plantillas de numeración de documentos) configuradas en la compañía, con paginación, búsqueda y filtros.… - Currencies - [Listar monedas](https://developer.alegra.com/reference/currencies_getcurrencies.md): Herramienta MCP: `currencies_getCurrencies`. Devuelve las monedas configuradas en la empresa, paginadas y con filtros opcionales de moneda principal, estado, ordenamiento y selección de campos.… - [Obtener moneda principal](https://developer.alegra.com/reference/currencies_getdefaultcurrency.md): Herramienta MCP: `currencies_getDefaultCurrency`. Devuelve la moneda principal configurada en la empresa, sin parámetros. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc": "2.0", "id": 1,… - Sellers - [Listar vendedores](https://developer.alegra.com/reference/sellers_getsellers.md): Herramienta MCP: `sellers_getSellers`. Devuelve la lista de vendedores de la compañía, con paginación y, opcionalmente, metadatos del resultado. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc":… - Taxes - [Listar impuestos](https://developer.alegra.com/reference/taxes_gettaxes.md): Herramienta MCP: `taxes_getTaxes`. Devuelve los impuestos configurados en la empresa, paginados y con filtros opcionales de búsqueda, estado, ordenamiento y selección de campos. Ejemplo de llamada… - Retentions - [Listar retenciones](https://developer.alegra.com/reference/retentions_getretentions.md): Herramienta MCP: `retentions_getRetentions`. Devuelve las retenciones fiscales configuradas en la empresa, con paginación, búsqueda, filtro por estado y por tipo. Ejemplo de llamada JSON-RPC:… - Reports - [Obtener flujo de caja](https://developer.alegra.com/reference/reports_get_cash_flow.md): Herramienta MCP: `reports_get_cash_flow`. Devuelve el reporte de flujo de caja de la compañía para un periodo, con desglose mensual y cinco secciones fijas. Ejemplo de llamada JSON-RPC: ```json {… - [Obtener balance general](https://developer.alegra.com/reference/reports_get_general_balance.md): Herramienta MCP: `reports_get_general_balance`. Devuelve el Estado de Situación Financiera (balance general) en JSON: árboles de cuentas de activos, pasivos, patrimonio y cuentas de orden no nulas,… - [Consultar estado de resultados](https://developer.alegra.com/reference/reports_get_profit_and_loss.md): Herramienta MCP: `reports_get_profit_and_loss`. Devuelve el Estado de Resultados de la compañía para un rango de fechas, como un árbol jerárquico de cuentas (ingresos, costo, costo de producción y… - [Consultar balance de prueba por tercero](https://developer.alegra.com/reference/reports_get_third_party_trial_balance.md): Herramienta MCP: `reports_get_third_party_trial_balance`. Devuelve el balance de prueba por tercero como un árbol JSON anidado: raíces del catálogo (activos, pasivos, patrimonio, ingresos, gastos,… - [Consultar balance de prueba](https://developer.alegra.com/reference/reports_get_trial_balance.md): Herramienta MCP: `reports_get_trial_balance`. Devuelve el balance de prueba (también llamado balance de comprobación o sumas y saldos) como un árbol jerárquico de cuentas contables: raíces del… - [Consultar movimiento por cuenta contable](https://developer.alegra.com/reference/reports_get_ledger_journal_categories.md): Herramienta MCP: `reports_get_ledger_journal_categories`. Devuelve, paginados, los comprobantes contables (por cuenta o categoría contable) de una cuenta específica dentro de un periodo. Corresponde… - [Totalizar movimiento por cuenta contable](https://developer.alegra.com/reference/reports_get_ledger_journal_categories_totals.md): Herramienta MCP: `reports_get_ledger_journal_categories_totals`. Devuelve los totales de una cuenta contable en un periodo, agrupados por día, mes o año: saldo inicial, débito, crédito, movimiento… - [Consultar cuentas por pagar](https://developer.alegra.com/reference/reports_get_payables.md): Herramienta MCP: `reports_get_payables`. Devuelve las cuentas por pagar como una lista paginada de facturas de compra abiertas a una fecha de corte. Cada fila incluye el número de la factura de… - [Totalizar cuentas por pagar](https://developer.alegra.com/reference/reports_get_payables_summary.md): Herramienta MCP: `reports_get_payables_summary`. Devuelve los totales agregados de las cuentas por pagar a una fecha de corte, en un único objeto de resumen: `missingAmount` (saldo total pendiente… - [Consultar cuentas por cobrar](https://developer.alegra.com/reference/reports_get_receivables.md): Herramienta MCP: `reports_get_receivables`. Devuelve las cuentas por cobrar como una lista paginada de facturas abiertas a una fecha de corte. Cada fila incluye el número del documento, el tipo de… - [Totalizar cuentas por cobrar](https://developer.alegra.com/reference/reports_get_receivables_summary.md): Herramienta MCP: `reports_get_receivables_summary`. Devuelve los totales agregados de las cuentas por cobrar a una fecha de corte, en un único objeto de resumen: `missingAmount` (saldo total… - [Consultar exportable](https://developer.alegra.com/reference/reports_get_exportable.md): Herramienta MCP: `reports_get_exportable`. Devuelve el detalle público de un exportable por su identificador: estado, filtros, fechas, progreso y nombre de archivo. Devuelve 404 si el exportable no… - [Consultar detalle de retenciones](https://developer.alegra.com/reference/reports_get_retentions_detail.md): Herramienta MCP: `reports_get_retentions_detail`. Devuelve el detalle de los documentos que componen las retenciones (practicadas o recibidas) de la compañía en un periodo. El parámetro `type`… - [Consultar reporte de retenciones](https://developer.alegra.com/reference/reports_get_retentions_report.md): Herramienta MCP: `reports_get_retentions_report`. Devuelve el reporte de retenciones practicadas y recibidas de la compañía en un periodo. El parámetro `type` define la ruta interna del reporte y… - [Listar exportables](https://developer.alegra.com/reference/reports_list_exportables.md): Herramienta MCP: `reports_list_exportables`. Devuelve el historial de exportaciones de reportes de la compañía de los últimos 15 días, con su estado (`IN_PROCESS`, `FINISHED`, `FAILED`), filtros,… - [Listar documentos de venta](https://developer.alegra.com/reference/reports_get_general_sales_documents.md): Herramienta MCP: `reports_get_general_sales_documents`. Devuelve una LISTA de documentos individuales de venta (facturas, notas crédito y notas débito) dentro de un rango de fechas, paginada.… - [Totalizar ventas por periodo](https://developer.alegra.com/reference/reports_get_general_sales_totals.md): Herramienta MCP: `reports_get_general_sales_totals`. Devuelve los totales de ventas agregados y AGRUPADOS POR PERIODO DE TIEMPO (día, mes o año): para cada periodo muestra los montos de ventas… - [Consultar rentabilidad por producto](https://developer.alegra.com/reference/reports_get_profitability_by_product.md): Herramienta MCP: `reports_get_profitability_by_product`. Devuelve una LISTA de productos con sus datos de rentabilidad en un periodo: ingresos (`totalSold`), costo (`totalCost`), ganancia (`profit`)… - [Totalizar rentabilidad por producto](https://developer.alegra.com/reference/reports_get_profitability_by_product_totals.md): Herramienta MCP: `reports_get_profitability_by_product_totals`. Devuelve los TOTALES agregados de rentabilidad de un periodo: ingresos totales (`totalSold`), costo total (`totalCost`) y ganancia… - [Listar ventas por cliente](https://developer.alegra.com/reference/reports_get_sales_by_client.md): Herramienta MCP: `reports_get_sales_by_client`. Devuelve una LISTA paginada de clientes con sus métricas de compra en un periodo: qué compró cada uno, cuántos documentos emitió y cuánto gastó.… - [Totalizar ventas por cliente](https://developer.alegra.com/reference/reports_get_sales_by_client_totals.md): Herramienta MCP: `reports_get_sales_by_client_totals`. Devuelve el TOTAL de las compras o transacciones de los clientes en un único objeto de resumen agregado, con `subTotal`, `total` y… - [Consultar ventas con descuento](https://developer.alegra.com/reference/reports_get_sales_by_discount.md): Herramienta MCP: `reports_get_sales_by_discount`. Devuelve las ventas de documentos a los que se les aplicó un descuento en un periodo, ordenados por monto de descuento (de mayor a menor), junto con… - [Consultar ventas por producto](https://developer.alegra.com/reference/reports_get_sales_by_item.md): Herramienta MCP: `reports_get_sales_by_item`. Devuelve una LISTA de productos con sus datos de venta en un periodo: cantidad vendida, monto antes de impuestos y monto con impuestos. Es una muestra… - [Totalizar ventas por producto](https://developer.alegra.com/reference/reports_get_sales_by_item_totals.md): Herramienta MCP: `reports_get_sales_by_item_totals`. Devuelve el TOTAL de las ventas de productos en un único objeto de resumen agregado, con los montos monetarios totales `totalAmountBeforeTaxes` y… - [Listar ventas por vendedor](https://developer.alegra.com/reference/reports_get_sales_by_seller.md): Herramienta MCP: `reports_get_sales_by_seller`. Devuelve las ventas por vendedor con dos vistas según el uso de `sellerId`: - Sin `sellerId`: vista RESUMEN paginada, con una fila por vendedor y sus… - [Totalizar ventas por vendedor](https://developer.alegra.com/reference/reports_get_sales_by_seller_totals.md): Herramienta MCP: `reports_get_sales_by_seller_totals`. Devuelve el TOTAL de las ventas de los vendedores en un único objeto de resumen agregado, con `beforeTaxes`, `total`,… - [Consultar ventas por bodega](https://developer.alegra.com/reference/reports_get_sales_by_warehouse.md): Herramienta MCP: `reports_get_sales_by_warehouse`. Devuelve el valor de las ventas agregado de un periodo, opcionalmente filtrado por una sola bodega: total, monto antes de impuestos, descuento,… - Ledger - [Listar cuentas contables](https://developer.alegra.com/reference/ledger_listcategories.md): Herramienta MCP: `ledger_listCategories`. Lista las cuentas contables (categorías) registradas en Alegra, con filtros opcionales por tipo, estado, nombre, formato de respuesta (árbol o plano) y más.… - [Obtener cuenta contable](https://developer.alegra.com/reference/ledger_getcategory.md): Herramienta MCP: `ledger_getCategory`. Obtiene el detalle de una cuenta contable (categoría) a partir de su `id`, incluyendo tipo, naturaleza, regla contable y jerarquía. Ejemplo de llamada… - [Consultar configuración del catálogo de cuentas](https://developer.alegra.com/reference/ledger_getcategorysettings.md): Herramienta MCP: `ledger_getCategorySettings`. Obtiene la configuración del catálogo de cuentas contables en Alegra. Devuelve el campo `orderBy`, que indica si las cuentas se ordenan por código… - [Consultar cuentas contables predeterminadas](https://developer.alegra.com/reference/ledger_getdefaultaccounts.md): Herramienta MCP: `ledger_getDefaultAccounts`. Obtiene las cuentas contables predeterminadas configuradas en Alegra. Devuelve un objeto JSON con hasta 7 secciones: `contacts`, `sales`, `inventory`,… - [Obtener entrada del libro mayor](https://developer.alegra.com/reference/ledger_getledgerentry.md): Herramienta MCP: `ledger_getLedgerEntry`. Obtiene una entrada del libro mayor a partir de su tipo de recurso e ID. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc": "2.0", "id": 1, "method":… - [Listar reglas de categoría](https://developer.alegra.com/reference/ledger_listcategoryrules.md): Herramienta MCP: `ledger_listCategoryRules`. Lista las reglas de categoría (reglas contables) registradas en Alegra, con filtros opcionales por tipo, estado, clave, ID, ordenamiento y selección de… - [Listar entradas del libro mayor](https://developer.alegra.com/reference/ledger_listledgerentries.md): Herramienta MCP: `ledger_listLedgerEntries`. Lista las entradas del libro mayor de Alegra de forma paginada y filtrable, con filtros por rango de fechas, tipo de recurso, centro de costos y número… - Accounting - [Listar comprobantes contables](https://developer.alegra.com/reference/accounting_listjournals.md): Herramienta MCP: `accounting_listJournals`. Lista los comprobantes contables de la compañía con filtros opcionales y paginación. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc": "2.0", "id":… - [Obtener centro de costos](https://developer.alegra.com/reference/accounting_getcostcenter.md): Herramienta MCP: `accounting_getCostCenter`. Obtiene el detalle de un centro de costos a partir de su `id`. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc": "2.0", "id": 1, "method":… - [Obtener comprobante contable](https://developer.alegra.com/reference/accounting_getjournal.md): Herramienta MCP: `accounting_getJournal`. Obtiene el detalle de un comprobante contable a partir de su `id`, incluyendo sus entradas con cuenta, débito y crédito. Ejemplo de llamada JSON-RPC:… - [Consultar gráfica de saldos de un comprobante contable](https://developer.alegra.com/reference/accounting_getjournalentriesgraph.md): Herramienta MCP: `accounting_getJournalEntriesGraph`. Recupera los saldos de las entradas de un comprobante contable agrupados por mes o por día, para analizar la distribución temporal de sus… - [Listar centros de costos](https://developer.alegra.com/reference/accounting_listcostcenters.md): Herramienta MCP: `accounting_listCostCenters`. Lista todos los centros de costos registrados en la compañía con filtros opcionales y paginación. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc":… - [Listar terceros](https://developer.alegra.com/reference/accounting_listthirdparties.md): Herramienta MCP: `accounting_listThirdParties`. Lista los terceros (contactos) activos de la compañía con su `id` e `idGlobal`, para identificar los terceros disponibles y resolver los… - [Consultar estado de un periodo contable](https://developer.alegra.com/reference/accounting_getaccountingperiodstatus.md): Herramienta MCP: `accounting_getAccountingPeriodStatus`. Consulta si un periodo contable está abierto o cerrado en Closing Periods, usando el año indicado y el mes solo cuando el usuario lo… - [Consultar bloqueos del cierre de periodo](https://developer.alegra.com/reference/accounting_getperiodclosingblockingreasons.md): Herramienta MCP: `accounting_getPeriodClosingBlockingReasons`. Identifica bloqueos o señales de bloqueo del cierre de periodo a partir del historial de ejecuciones en estado `in_process` y `error`.… - [Consultar estado del cierre de periodo](https://developer.alegra.com/reference/accounting_getperiodclosingstatus.md): Herramienta MCP: `accounting_getPeriodClosingStatus`. Consulta el estado operativo del cierre de un periodo combinando el estado del periodo en Closing Periods con la ejecución más reciente del… - [Listar periodos cerrados](https://developer.alegra.com/reference/accounting_listclosedperiods.md): Herramienta MCP: `accounting_listClosedPeriods`. Lista los periodos contables cerrados de la compañía para un año y, opcionalmente, un mes específico. Ejemplo de llamada JSON-RPC: ```json {… - [Listar categorías de patrimonio en cierres](https://developer.alegra.com/reference/accounting_listclosingequitycategories.md): Herramienta MCP: `accounting_listClosingEquityCategories`. Lista las cuentas de patrimonio (equity) con movimiento de un año, para que el usuario elija la cuenta destino de los saldos en un cierre… - [Obtener comprobante de un cierre de terceros](https://developer.alegra.com/reference/accounting_getthirdpartyclosingjournal.md): Herramienta MCP: `accounting_getThirdPartyClosingJournal`. Obtiene el comprobante contable generado por un cierre de cuentas por terceros: consulta el cierre y luego el journal a partir de su… - [Obtener estado de un cierre de terceros](https://developer.alegra.com/reference/accounting_getthirdpartyclosingstatus.md): Herramienta MCP: `accounting_getThirdPartyClosingStatus`. Consulta el estado y el detalle enriquecido de un cierre de cuentas por terceros, con los terceros como contactos y las categorías como… - [Listar cuentas de cierre de terceros](https://developer.alegra.com/reference/accounting_listthirdpartyclosingaccounts.md): Herramienta MCP: `accounting_listThirdPartyClosingAccounts`. Lista las cuentas contables (categorías) que tuvieron movimientos en un periodo, con su `idGlobal`, para identificar las cuentas… - [Listar cierres de terceros](https://developer.alegra.com/reference/accounting_listthirdpartyclosings.md): Herramienta MCP: `accounting_listThirdPartyClosings`. Lista todos los cierres de cuentas por terceros registrados para la compañía, con su estado y periodo. Ejemplo de llamada JSON-RPC: ```json {… - [Obtener activo fijo](https://developer.alegra.com/reference/accounting_getfixedasset.md): Herramienta MCP: `accounting_getFixedAsset`. Obtiene un activo fijo por su `id`. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {… - [Obtener depreciaciones de un activo fijo](https://developer.alegra.com/reference/accounting_getfixedassetdepreciations.md): Herramienta MCP: `accounting_getFixedAssetDepreciations`. Obtiene las depreciaciones de un activo fijo por su `id`. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc": "2.0", "id": 1,… - [Listar depreciaciones de un activo fijo por estado](https://developer.alegra.com/reference/accounting_listfixedassetdepreciationsbystatus.md): Herramienta MCP: `accounting_listFixedAssetDepreciationsByStatus`. Lista las depreciaciones de un activo fijo filtrando por estado. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc": "2.0",… - [Listar activos fijos](https://developer.alegra.com/reference/accounting_listfixedassets.md): Herramienta MCP: `accounting_listFixedAssets`. Lista los activos fijos de la compañía con paginación basada en cursores. Ejemplo de llamada JSON-RPC: ```json { "jsonrpc": "2.0", "id": 1,… - [Consultar documentos generados de una importación de saldo inicial](https://developer.alegra.com/reference/accounting_getopeningbalancegenerateddocuments.md): Herramienta MCP: `accounting_getOpeningBalanceGeneratedDocuments`. Devuelve los documentos generados por una importación de saldos iniciales por su `id`: el comprobante contable (journal) creado,… - [Consultar errores de una importación de saldo inicial](https://developer.alegra.com/reference/accounting_getopeningbalanceimporterrors.md): Herramienta MCP: `accounting_getOpeningBalanceImportErrors`. Devuelve los errores de una importación de saldos iniciales por su `id`: el error global del proceso (si lo hubo) y los errores por fila,… - [Consultar estado de una importación de saldo inicial](https://developer.alegra.com/reference/accounting_getopeningbalanceimportstatus.md): Herramienta MCP: `accounting_getOpeningBalanceImportStatus`. Devuelve el estado de avance de una importación de saldos iniciales por su `id`: estado del proceso, filas procesadas frente a totales,… - [Obtener comprobante de una importación de saldo inicial](https://developer.alegra.com/reference/accounting_getopeningbalancejournal.md): Herramienta MCP: `accounting_getOpeningBalanceJournal`. Devuelve el comprobante contable (journal) generado por una importación de saldos iniciales por su `id`, con sus partidas (entries), fecha,… - [Listar importaciones de saldo inicial](https://developer.alegra.com/reference/accounting_listopeningbalanceimports.md): Herramienta MCP: `accounting_listOpeningBalanceImports`. Lista todas las importaciones de saldos iniciales de la compañía autenticada, ordenadas de la más reciente a la más antigua, con resúmenes… - [Obtener tipo de documento](https://developer.alegra.com/reference/accounting_getdocumenttype.md): Herramienta MCP: `accounting_getDocumentType`. Obtiene el detalle de un tipo de comprobante contable por su `id`: nombre, código, type interno, estado y clasificación del módulo de contabilidad.… - [Obtener plantilla de numeración](https://developer.alegra.com/reference/accounting_getnumbertemplate.md): Herramienta MCP: `accounting_getNumberTemplate`. Obtiene el detalle de una numeración contable específica por su `id`: prefijo, consecutivo actual, numeración preferida y tipo de comprobante… - [Listar tipos de documento](https://developer.alegra.com/reference/accounting_listdocumenttypes.md): Herramienta MCP: `accounting_listDocumentTypes`. Lista los tipos de comprobante contable de la compañía (ajuste contable, cierre, saldos iniciales, factura de venta, nota crédito, etc.) para… - [Listar plantillas de numeración](https://developer.alegra.com/reference/accounting_listnumbertemplates.md): Herramienta MCP: `accounting_listNumberTemplates`. Lista las numeraciones contables de la compañía (prefijos, consecutivos y numeración preferida de los comprobantes del módulo de contabilidad). No… - Support Center - [Generar respuesta a partir de los artículos de ayuda](https://developer.alegra.com/reference/supportcenter_generate-search-response.md): Herramienta MCP: `supportCenter_generate-search-response`. Genera, con ayuda de IA, una respuesta para consultas sobre la documentación de ayuda, preguntas frecuentes y guías de producto de Alegra.… - [Obtener contenido de un artículo de ayuda](https://developer.alegra.com/reference/supportcenter_get-article-content.md): Herramienta MCP: `supportCenter_get-article-content`. Obtiene el contenido completo de un artículo de la base de conocimientos de Alegra, incluyendo título, cuerpo y URL pública del artículo. Es… - [Buscar artículos de ayuda](https://developer.alegra.com/reference/supportcenter_search-helpers.md): Herramienta MCP: `supportCenter_search-helpers`. Busca artículos y documentación de ayuda en la base de conocimientos de Alegra. Devuelve guías, tutoriales y preguntas frecuentes relevantes para una… - Pagos - [Gestión de cuentas bancarias](https://developer.alegra.com/reference/referencebanks.md): Herramientas de **bancos y conciliaciones**. Se invocan con **`POST /mcp`** (`tools/call`). - [Gestión de monedas y tasas de cambio](https://developer.alegra.com/reference/referencecurrencies.md): Herramientas de **divisas**. Se invocan con **`POST /mcp`** (`tools/call`). - Contactos - [Gestión de contactos y clientes](https://developer.alegra.com/reference/referencecontacts.md): Herramientas de **contactos**. Se invocan con **`POST /mcp`** (`tools/call`). - [Gestión de vendedores](https://developer.alegra.com/reference/referencesellers.md): Herramientas de **vendedores**. Se invocan con **`POST /mcp`** (`tools/call`). - Impuestos y Retenciones - [Gestión de impuestos](https://developer.alegra.com/reference/referencetaxes.md): Herramientas de **impuestos**. Se invocan con **`POST /mcp`** (`tools/call`). - [Gestión de retenciones fiscales](https://developer.alegra.com/reference/referenceretentions.md): Herramientas de **retenciones**. Se invocan con **`POST /mcp`** (`tools/call`). ## Documentación: API NÓMINA - [Primeros Pasos - Nómina](https://developer.alegra.com/reference/primeros-pasos-payroll.md) - Configuración de organización - [Obtiene la organización actual](https://developer.alegra.com/reference/getorganization.md): Devuelve la organización a la que pertenece el token. En Colombia puede sincronizar automáticamente el estado gubernamental (AUTHORIZED / PENDING / REJECTED). - [Actualiza la organización](https://developer.alegra.com/reference/updateorganization.md) - [Crea una organización](https://developer.alegra.com/reference/createorganization.md): Da de alta una organización a partir de un `id` de empresa. Inicializa plan free y numeraciones por defecto del país. - [Genera el PDF de firmas de mandato](https://developer.alegra.com/reference/generatemandatesignatures.md) - [Envía el PDF de firmas por correo](https://developer.alegra.com/reference/sendmandatesignatures.md): Verifica que la organización tenga dv y nit definidos antes de enviar. - [Registra la organización en el plan free](https://developer.alegra.com/reference/registerfreeplan.md) - [Envía un set de prueba al proveedor electrónico](https://developer.alegra.com/reference/sendtestset.md): Valida el estado de gobierno antes de enviar. - [Lista los planes disponibles para la organización](https://developer.alegra.com/reference/getmembershipplans.md) - [Obtiene el intake de la organización](https://developer.alegra.com/reference/getorganizationintake.md): Devuelve la información de intake asociada a la organización (formularios, datos requeridos, etc.). - [Lista las cuentas bancarias asociadas a la organización](https://developer.alegra.com/reference/getbankaccounts.md) - Catálogos - [Consulta un catálogo por país y clave](https://developer.alegra.com/reference/getconfig.md): Cada `key` se resuelve contra una fuente distinta (catálogo estático, configuración de la organización o archivo country-specific). El país disponible depende del claim `applicationVersion` del JWT:… - Empleados - [Crea uno o varios empleados](https://developer.alegra.com/reference/createemployees.md): Crea empleados en lote. Los campos disponibles dependen del país del token. Por país, hay campos adicionales requeridos para liquidar nómina: Colombia (salary, type, subType, highRisk,… - [Lista los empleados de la organización](https://developer.alegra.com/reference/getemployees.md) - [Obtiene un empleado por ID](https://developer.alegra.com/reference/getemployee.md) - [Actualiza un empleado](https://developer.alegra.com/reference/updateemployee.md): Aplica cambios parciales. Validación idéntica a createEmployee, pero todos los campos son opcionales. - [Elimina un empleado](https://developer.alegra.com/reference/deleteemployee.md): Verifica que no existan nóminas ni documentos electrónicos emitidos para el empleado antes de permitir el borrado. - [Valida un lote de empleados sin crearlos](https://developer.alegra.com/reference/validateemployeesimport.md): Procesa el mismo formato que POST /employees/import y devuelve el número de filas válidas, las que tienen errores y el detalle de estos. No persiste cambios. - [Importa un lote de empleados](https://developer.alegra.com/reference/importemployees.md): Mismo formato que /import/validate. Crea los empleados válidos y devuelve el reporte de los rechazados. - Usuarios - [Cierra la sesión del usuario](https://developer.alegra.com/reference/userlogout.md): Lee el cookie de sesión, llama al servicio de autenticación de Alegra para invalidarlo, y devuelve un 302 al FRONTEND_LOGOUT_URL configurado, además de los Set-Cookie que borran las cookies de sesión… - [Redirige a la pantalla de configuración](https://developer.alegra.com/reference/userconfiguration.md): Devuelve un 302 con Location: /configuration. Usado como atajo desde otros productos del ecosistema Alegra para saltar al panel de configuración del usuario. - Numeraciones - [Crea una o varias numeraciones](https://developer.alegra.com/reference/createnumeration.md): Crea numeraciones para la organización del token. Los documentType disponibles dependen del país (claim applicationVersion del JWT). - [Lista las numeraciones de la organización](https://developer.alegra.com/reference/getnumerations.md): Devuelve una página de numeraciones de la organización del token. Filtros combinables vía query strings. - [Actualiza una numeración](https://developer.alegra.com/reference/updatenumeration.md): Aplica cambios parciales. Todos los campos del body son opcionales; solo se actualizan los enviados. - [Obtiene una numeración por ID](https://developer.alegra.com/reference/getnumeration.md) - [Elimina una numeración](https://developer.alegra.com/reference/deletenumeration.md): Borra la numeración. Si ya emitió documentos electrónicos, devuelve 409 y la numeración permanece intacta. - Emisión - [Crea un documento electrónico](https://developer.alegra.com/reference/createelectronicpayroll.md): Crea el e-payroll en estado draft a partir de una nómina líquida. Valida el estado del empleado y de la organización en el proveedor electrónico. - [Lista e-payrolls de la organización](https://developer.alegra.com/reference/getelectronicpayrolls.md) - [Obtiene un e-payroll por ID](https://developer.alegra.com/reference/getelectronicpayroll.md) - [Actualiza un e-payroll](https://developer.alegra.com/reference/updateelectronicpayroll.md): Solo permitido en e-payrolls en estados que no han sido firmados aún. - [Elimina un e-payroll](https://developer.alegra.com/reference/deleteelectronicpayroll.md) - [Acción sobre un e-payroll existente](https://developer.alegra.com/reference/epayrollactionbyid.md): Endpoint multipropósito detrás de POST /e-payrolls/{electronicPayrollId}. Según el verbo, ejecuta: validate, emit, cancel. La operacion concreta depende de la convención del handler (ver… - [Descarga un archivo del e-payroll](https://developer.alegra.com/reference/downloadelectronicpayrollfile.md): Devuelve el archivo solicitado (xml, pdf) del e-payroll. - [Crea e-payrolls para varios empleados en una sola llamada](https://developer.alegra.com/reference/createelectronicpayrollsbyemployees.md) - [Actualiza el estado de emisión desde un webhook](https://developer.alegra.com/reference/updateemissionstatus.md): Usado internamente por el webhook del proveedor electrónico. Protegido por token de servicio (no JWT de Integraciones). - [Genera un reporte de e-payrolls](https://developer.alegra.com/reference/createelectronicpayrollsreport.md) - [Obtiene el resumen anual de uso de e-payrolls](https://developer.alegra.com/reference/getannualusageepayrolls.md) - Liquidación - [Crea una nómina liquidada](https://developer.alegra.com/reference/createpayroll.md) - [Lista nóminas de la organización](https://developer.alegra.com/reference/getpayrolls.md) - [Obtiene una nómina por ID](https://developer.alegra.com/reference/getpayroll.md) - [Actualiza una nómina](https://developer.alegra.com/reference/updatepayroll.md) - [Elimina una nómina](https://developer.alegra.com/reference/deletepayroll.md) - [Recalcula una nómina](https://developer.alegra.com/reference/calculatepayroll.md): Aplica los conceptos, novedades y reglas del país del token, y devuelve el resultado detallado sin persistir. - [Crea nóminas para varios empleados](https://developer.alegra.com/reference/createpayrollsbyemployees.md) - [Crea un resumen de nóminas](https://developer.alegra.com/reference/createsummary.md) - [Descarga múltiples archivos de nóminas](https://developer.alegra.com/reference/downloadmultiplepayrolls.md) - [Crea una cuenta contable](https://developer.alegra.com/reference/createaccountingaccount.md) - [Lista las cuentas contables de la organización](https://developer.alegra.com/reference/getaccountingaccounts.md) - [Actualiza una cuenta contable](https://developer.alegra.com/reference/updateaccountingaccount.md) - [Genera recibos contables](https://developer.alegra.com/reference/createaccountingreceipt.md) - [Lista recibos contables](https://developer.alegra.com/reference/getaccountingreceipts.md) - [Obtiene el recibo contable de una nómina](https://developer.alegra.com/reference/getaccountingreceipt.md) - [Envía un recibo contable](https://developer.alegra.com/reference/sendaccountingreceipt.md) - [Actualiza un recibo contable](https://developer.alegra.com/reference/updateaccountingreceipt.md) - [Valida el recibo contable de una nómina](https://developer.alegra.com/reference/validateaccountingreceipt.md) - [Crea pagos en lote para un periodo](https://developer.alegra.com/reference/createpaymentbyperiod.md) - [Actualiza un pago](https://developer.alegra.com/reference/updatepayment.md) - [Lista los pagos asociados a una nómina](https://developer.alegra.com/reference/getpaymentsforpayroll.md) - [Crea un pago para una nómina](https://developer.alegra.com/reference/createpayment.md) - [Envía nóminas por correo electrónico](https://developer.alegra.com/reference/sendpayrollviaemail.md) - [Obtiene la estructura del periodo de nómina](https://developer.alegra.com/reference/getperioddata.md): Devuelve la descripción (fechas, periodo, etc.) del periodo de nómina. - [Genera un reporte de nóminas](https://developer.alegra.com/reference/createpayrollsreport.md) - [Obtiene el resumen anual de uso de nóminas](https://developer.alegra.com/reference/getannualusagepayrolls.md) ## Novedades - [¡Nuevo formato de ID para Items!](https://developer.alegra.com/changelog/nuevo-formato-de-id-para-items.md) - [¡Nuevo formato de ID para Cotizaciones y Remisiones!](https://developer.alegra.com/changelog/nuevo-formato-de-id-para-cotizaciones-y-remisiones.md) - [¡Nuevo formato de ID para Vendedores!](https://developer.alegra.com/changelog/page.md) - [¡Nuevo formato de ID para Términos de Pago!](https://developer.alegra.com/changelog/nuevo-formato-de-id-para-términos-de-pago.md) - [¡Nuevo formato de ID para Transferencia de Bodegas!](https://developer.alegra.com/changelog/nuevo-formato-de-id-para-transferencia-de-bodegas.md) - [¡Nuevo formato de ID para Bodegas!](https://developer.alegra.com/changelog/nuevo-formato-de-id-para-bodegas.md) - [🛠️ Actualización de condicion IVA – Argentina](https://developer.alegra.com/changelog/️-actualización-de-condicion-iva-argentina.md) - [🛠️ Actualización de Configuración de Items – España](https://developer.alegra.com/changelog/️-actualización-de-configuración-de-items-españa.md) - [🛠️ Actualización de Validaciones de Identificación – España](https://developer.alegra.com/changelog/nueva-estructura-de-identificaciones-esp.md) - [¡Nuevo formato de ID para Listas de Precios!](https://developer.alegra.com/changelog/nuevo-formato-de-id-para-listas-de-precios.md)