# api-loggro Documentation > Documentation for api-loggro Append .md to any documentation page URL to get its markdown version. ## Guides - [Guía de uso – Documentación del Catálogo de Productos (APIs)](https://developer.loggro.com/docs/guia-de-uso.md): Esta guía te ayudará a entender cómo están organizados los servicios, cómo autenticarse, y cómo trabajar basados en ejemplos de uso. ## API Reference - [Autenticación](https://developer.loggro.com/reference/autenticacion.md) - [Introducción](https://developer.loggro.com/reference/introduccion.md) - [Autenticación](https://developer.loggro.com/reference/autenticacion-documentos-electronicos.md) - [Introducción](https://developer.loggro.com/reference/introduccion-facturacion-electronica.md) - [Autenticación](https://developer.loggro.com/reference/autenticacion-1.md) - [Consultar información de resolución DIAN](https://developer.loggro.com/reference/consultarinformacionresoluciondian.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl/consultarInformacionResolucionDian Este servicio **SOAP** te permite consultar la información detallada de una resolución de numeración de facturación electrónica previamente registrada en el sistema de la **DIAN**. Es útil en escenarios donde se requiere validar si una resolución está vigente y conocer los rangos de numeración autorizados antes de emitir facturas electrónicas, asegurando así que el proceso de facturación cumpla con los requisitos legales establecidos. *** ## Requisitos de entrada - **Número de identificación del facturador (obligatorio):** NIT o cédula del emisor de la factura. - **Prefijo de la resolución (opcional).** - **Número de resolución (obligatorio).** *** ## Información que puedes obtener - Número de resolución. - Prefijo (si aplica). - Rango de numeración autorizado (número inicial y número final). - Fecha de inicio y fecha de vencimiento de la vigencia de la resolución. - Clave técnica asociada a la resolución _(aplica solo para numeración de facturación electrónica, no para facturación por contingencia)._ *** ## Ejemplos de uso comunes - Confirmar los rangos autorizados de numeración para la emisión de facturas. - Validar la vigencia de una resolución específica antes de facturar. - [Generar Documento Electrónico](https://developer.loggro.com/reference/generardocumentoelectronicoxml.md): **Url Servicio** : Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl/generarDocumentoElectronicoXML Este servicio SOAP te permite emitir de forma segura documentos electrónicos por compras realizadas a proveedores no obligados a facturar electrónicamente, cumpliendo con la normatividad vigente de la DIAN (Dirección de Impuestos y Aduanas Nacionales) en Colombia. A través de este servicio, las empresas pueden **automatizar la generación y envío** de documentos tributarios electrónicos como: - **Documento Soporte Electrónico**: para reportar legalmente las adquisiciones de bienes y/o servicios realizadas a proveedores no obligados a expedir factura electrónica. - **Nota de Ajuste al Documento Soporte**: para anular un documento soporte previamente emitido, registrar devoluciones, corregir errores o realizar ajustes sobre valores reportados. ## ¿Cómo funciona? 1. Envías un archivo `.zip` codificado en **Base64** que contiene: - Un archivo **XML estructurado** con la información correspondiente al tipo de documento que deseas generar (documento soporte, nota de ajuste). - El XML debe seguir un **formato específico**, detallado en la sección correspondiente (ver enlace al final). 2. El servicio **valida la estructura y el contenido del XML**: - Si la información es válida, el documento se transmite automáticamente a la **DIAN**. - Si se detectan errores, el servicio devuelve los mensajes de validación correspondientes para su corrección. ## Formato específico del XML **Consulta el detalle técnico del formato requerido para el XML:** [Estructura Documentos Electrónicos - Facturación Electrónica - 1.9 4.xlsx](https://loggro.com/download/Estructura%20Documentos%20Electr%C3%B3nicos%20-%20Facturaci%C3%B3n%20Electr%C3%B3nica%20-%201.9%204.xlsx) ## Casos de uso comunes - **Generación de Documento Soporte** para registrar compras a proveedores no obligados a facturar electrónicamente. - **Emisión de Notas de Ajuste** para corregir errores en documentos previamente generados (por ejemplo, valores incorrectos, datos del proveedor, etc.). - **Registro de devoluciones o anulaciones** de operaciones asociadas a Documentos Soporte emitidos. - [Generar Documentos Electrónicos masivamente](https://developer.loggro.com/reference/generarlistadocumentoselectronicosxml.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl/generarListaDocumentosElectronicosXML Este servicio SOAP permite la emisión masiva de documentos electrónicos de facturación ante la DIAN, facilitando el envío de hasta 30 documentos en un solo lote. Está diseñado para optimizar procesos de facturación de alto volumen de forma segura y conforme a la normativa colombiana. Este servicio está orientado a escenarios donde se requiere emitir múltiples documentos en una sola operación, como procesos de facturación nocturnos, cierre de ciclos de venta o actualización masiva de transacciones. Soporta los siguientes tipos de documentos: - **Factura de venta electrónica:** para reportar múltiples ventas de bienes y/o servicios a clientes. - **Nota crédito electrónica:** para anular facturas, realizar devoluciones, aplicar descuentos o corregir errores en facturas previamente emitidas. - **Nota débito electrónica:** para revertir notas crédito, ajustar montos o cambiar valores en facturas previamente emitidas. **Recomendación:** Este servicio **no está optimizado para procesos en línea o en tiempo real**, ya que los tiempos de respuesta pueden aumentar debido al procesamiento de varios documentos. ## ¿Cómo funciona? 1. Envías un archivo **.zip** codificado en **Base64** que contiene: - Múltiples XML estructurados con la información de los documentos (factura, nota crédito o nota débito). 2. Cada uno de los XML debe seguir un **formato específico**, detallado en la sección correspondiente (ver enlace al final). 3. El servicio valida y procesa cada documento individualmente: - Los documentos válidos son transmitidos a la DIAN conforme a los estándares oficiales. - Los documentos con errores no se transmiten, y se retorna una respuesta individual con el detalle de los errores encontrados. ## Formato específico XML: **Consulta el detalle técnico del formato requerido para el XML:** [Estructura Documentos Electrónicos - Facturación Electrónica - 1.9 4.xlsx](https://loggro.com/download/Estructura%20Documentos%20Electr%C3%B3nicos%20-%20Facturaci%C3%B3n%20Electr%C3%B3nica%20-%201.9%204.xlsx) ## Ejemplos de uso comunes: - Emisión diaria o periódica de grandes volúmenes de documentos de facturación. - Procesamiento por lotes desde sistemas contables o ERP. - [Consultar Información Documento Electrónico](https://developer.loggro.com/reference/consultarinformaciondocumentoelectronico.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl/consultarInformacionDocumentoElectronico Este servicio SOAP permite consultar la información completa y actualizada de un documento electrónico previamente emitido, ya sea una factura, una nota crédito o una nota débito de venta. Está diseñado para facilitar el seguimiento del ciclo de vida del documento, desde su generación hasta su aprobación por la DIAN y notificación al cliente. Este servicio es útil cuando se requiere verificar el estado de un documento electrónico en el sistema de facturación o ante la DIAN. También permite recuperar los elementos asociados al documento, como el XML original, el PDF de la representación gráfica, el código QR, entre otros. El servicio requiere como entrada: - **Prefijo del documento** (si aplica) - **Número del documento** - **Tipo de documento** (factura, nota crédito o nota débito) - **ID del facturador** electrónico propietario del documento ## ¿Qué tipo de información puedes obtener? **Estado del documento:** - Si el documento ya fue transmitido a la DIAN. - Si está en proceso de validación. - Si fue aprobado por la DIAN. - Si fue rechazado por la DIAN o por el sistema de facturación electrónica. - Fecha de aprobación y respuesta oficial (código y descripción). **Estado de notificación al cliente:** - Si el documento fue notificado por correo electrónico. - Si está pendiente de notificación. - Si no requiere notificación, entre otros estados posibles. - Fecha de notificación al cliente (si aplica). **Obtención de elementos electrónicos generados en el proceso:** - XML del documento transmitido (codificado en Base64). - PDF de la representación gráfica oficial (codificado en Base64). - Código QR del documento (codificado en Base64). - CUFE o CUDE, según corresponda al tipo de documento. ## Ejemplos de uso comunes: - Verificación del estado de un documento en procesos de auditoría o conciliación. - Consulta de documentos desde portales de clientes o backoffice. - Validación de documentos ante quejas o solicitudes de clientes. - [Consultar Información Documento Electrónico por ID](https://developer.loggro.com/reference/consultarinformaciondocumentoelectronicobyid.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl/consultarInformacionDocumentoElectronicoById Este servicio SOAP permite consultar toda la información relacionada con un documento electrónico (factura, nota crédito o nota débito), utilizando como criterios de búsqueda el **ID interno del documento** y el **ID del facturador electrónico**. **Nota:** Este servicio ofrece la misma funcionalidad que el servicio **Consultar Información Documento Electrónico** descrito anteriormente. La única diferencia es la forma en que se realiza la consulta: - En lugar de utilizar el **prefijo, número y tipo de documento,** aquí se utiliza el **ID del documento**. Este servicio está orientado a escenarios donde se dispone del ID del documento, y se requiere consultar sus estados u obtener los elementos electrónicos generados. El servicio requiere como entrada: - **ID del documento** (identificador interno asignado por el sistema de facturación) - **ID del facturador electrónico** (propietario del documento) ## ¿Qué tipo de información puedes obtener? **Estado frente a la DIAN:** - Si el documento fue transmitido. - Si está en proceso de recepción. - Si fue aprobado o rechazado por la DIAN. - Fecha de aprobación y respuesta oficial (código y descripción). **Estado de notificación al cliente:** - Si el documento fue notificado por correo electrónico. - Si está pendiente de notificación. - Si no requiere notificación, entre otros estados. - Fecha de notificación al cliente (si aplica). **Obtención de elementos electrónicos generados en el proceso:** - XML del documento transmitido (codificado en Base64). - PDF de la representación gráfica oficial (codificado en Base64). - Código QR del documento (codificado en Base64). - CUFE o CUDE, según corresponda al tipo de documento. ## Ejemplos de uso comunes: - Verificación del estado de un documento en procesos de auditoría o conciliación. - Consulta de documentos desde portales de clientes o backoffice. - Validación de documentos ante quejas o solicitudes de clientes. - [Consultar Información Básica de Documentos Electrónicos masivamente](https://developer.loggro.com/reference/consultarinformacionbasicalistadocumentoselectronicos.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl/consultarInformacionBasicaListaDocumentosElectronicos Este servicio SOAP permite consultar de forma masiva información **básica** sobre documentos electrónicos emitidos, como facturas, notas crédito o notas débito. Está diseñado para proporcionar una vista general del estado, sin incluir su contenido completo (PDF, XML, etc.). Este servicio es útil para escenarios donde se requiere hacer un seguimiento general o verificación rápida de múltiples documentos sin necesidad de acceder a sus archivos completos. Permite identificar el estado de los documentos y extraer algunos elementos esenciales como el CUFE/CUDE o el código QR. El servicio requiere como entrada: - **ID del facturador electrónico** propietario del documento - Lista de documentos a consultar, donde cada uno debe incluir: - **Prefijo del documento** (si aplica) - **Número del documento** - **Tipo de documento** (factura, nota crédito o nota débito) ## ¿Qué tipo de información puedes obtener?** - Estado del documento. - Fecha de aprobación de la DIAN. - Código QR del documento (codificado en Base64). - CUFE o CUDE, según corresponda al tipo de documento. ## Ejemplos de uso comunes: - Consolidación de reportes de documentos electrónicos emitidos. - Validación masiva en procesos administrativos o contables. - Integraciones donde se necesita obtener un resumen de varios documentos rápidamente. - Seguimiento sin requerir archivos completos (PDF/XML). - [Consultar Información Básica de Documentos Electrónicos masivamente por ID](https://developer.loggro.com/reference/consultarinformacionbasicalistadocumentoselectronicosbyid.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl/consultarInformacionBasicaListaDocumentosElectronicosById Este servicio SOAP permite consultar en lote la información básica de varios documentos electrónicos (facturas, notas crédito o notas débito), utilizando como criterios de búsqueda el ID interno del documento y el ID del facturador electrónico. **Nota:** Este servicio ofrece la misma funcionalidad que el servicio **Consultar Información Básica de Documentos Electrónicos masivamente**, con la diferencia de que aquí la consulta se realiza mediante los **ID internos de los documentos**, en lugar del prefijo, número y tipo de documento. Este servicio está diseñado para integraciones técnicas donde se trabaja con los identificadores internos de los documentos en sistemas contables, **ERPs** o bases de datos, lo que permite simplificar la consulta y mejorar la eficiencia del proceso. El servicio requiere como entrada: - **ID del facturador electrónico** propietario del documento. - **Lista de documentos a consultar**, donde cada uno debe incluir: - **ID interno del documento electrónico**. ## ¿Qué tipo de información puedes obtener? - Estado del documento (Aprobado, rechazado, en validación, etc.). - Fecha de aprobación por parte de la DIAN. - Código QR del documento (codificado en Base64). - CUFE o CUDE, según corresponda al tipo de documento. ## Casos de uso comunes: - Consultas masivas desde sistemas que almacenan únicamente los ID de los documentos. - Integraciones automatizadas en procesos de conciliación, auditoría o seguimiento de documentos. - Consultas simplificadas cuando no se cuenta con la información pública del documento (como número o prefijo). - [Consultar Evento generado por el cliente para Factura a Crédito](https://developer.loggro.com/reference/consultarinformaciondocumentoelectronicoconinformaciontitulovalor.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl/consultarInformacionDocumentoElectronicoConInformacionTituloValor Este servicio SOAP permite consultar la información completa de un documento electrónico emitido (factura, nota crédito o nota débito), incluyendo el **estado del evento de aceptación** generado por el cliente, necesario para que la factura adquiera la condición de título valor según lo establece la normativa vigente. **Nota:** Este servicio extiende la funcionalidad del servicio **Consultar Información del Documento Electrónico**, añadiendo un campo adicional que indica el **estado del evento de aceptación**. Es especialmente útil para escenarios de facturación a **crédito o con plazos de pago**, donde se requiere comprobar si el cliente ha aceptado formalmente el documento. Además de obtener toda la información técnica y de estado del documento electrónico, este servicio permite verificar si la factura ya ha sido aceptada por el cliente mediante el evento correspondiente, lo que habilita su uso como título valor (requisito para cobro jurídico, factoring, entre otros procesos financieros). **El servicio requiere como entrada:** - **Prefijo del documento** (si aplica) - **Número del documento** - **Tipo de documento** (factura, nota crédito o nota débito) - **ID del facturador electrónico** propietario del documento ## ¿Qué tipo de información puedes obtener? Incluye toda la información disponible en el servicio **Consultar Información Documento Electrónico**, como: - Estado frente a la DIAN - Estado de notificación al cliente - Fecha de aprobación - Respuesta de la DIAN - XML transmitido (Base64) - PDF de la representación gráfica (Base64) - Código QR (Base64) - CUFE o CUDE Y adicionalmente, el **estado del documento con el evento generado por el cliente** para que el documento se convierta en título valor. ## Ejemplos de uso comunes: - Validación del estado de aceptación en facturas emitidas a crédito. - Verificación en procesos de cesión de factura (**factoring**). - Gestión de cartera y cobranza. - Soporte documental para procesos jurídicos o financieros. - [Consultar Evento generado por el cliente para Factura a Crédito por ID](https://developer.loggro.com/reference/consultarinformaciondocumentoelectronicoconinformaciontitulovalorbyid.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl/consultarInformacionDocumentoElectronicoConInformacionTituloValorById Este servicio SOAP permite consultar toda la información detallada de un documento electrónico emitido (factura, nota crédito o nota débito), **utilizando el ID interno del documento**, e incluye adicionalmente el estado del **evento de aceptación generado por el cliente**, requisito indispensable para que una factura pueda convertirse en **título valor**. **Nota:** Este servicio extiende la funcionalidad de **Consultar Información del Documento Electrónico por ID**, añadiendo en la respuesta un campo adicional con el **estado del evento de aceptación** del cliente. Es especialmente relevante en procesos de facturación a **crédito o con plazos de pago**, donde la aceptación del documento impacta su validez legal como **título valor**. Además de permitir la consulta técnica completa de un documento electrónico usando su identificador interno, este servicio aporta visibilidad sobre si el cliente ha aceptado formalmente la factura, lo cual habilita su uso en operaciones financieras, legales y de cartera. **El servicio requiere como entrada:** - **ID del documento** (identificador interno asignado por el sistema de facturación) - **ID del facturador electrónico** (propietario del documento) ## ¿Qué tipo de información puedes obtener? Incluye toda la información disponible en el servicio **Consultar Documento Electrónico por ID**, como: - Estado frente a la DIAN - Estado de notificación al cliente - Fecha de aprobación - Código y descripción de respuesta DIAN - XML transmitido (Base64) - PDF de la representación gráfica (Base64) - Código QR (Base64) - CUFE o CUDE Y adicionalmente, el **estado del documento con el evento generado por el cliente** para que el documento se convierta en **título valor**. ## Ejemplos de uso comunes: - Seguimiento de facturas emitidas a crédito. - Verificación del estatus legal previo a procesos de **factoring** o cesión de cartera. - Evaluación de aceptación de documentos en gestión de cobranza. - Integración con sistemas de riesgo, tesorería o jurídico. - [Consultar Estado de notificación a la DIAN de varios documentos electrónicos](https://developer.loggro.com/reference/consultarestadonotificacionlistadocumentoselectronicos.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl/consultarEstadoNotificacionListaDocumentosElectronicos Este servicio SOAP permite consultar de forma masiva el estado de transmisión a la DIAN y el estado de notificación al cliente de varios documentos electrónicos (facturas, notas crédito o notas débito). Está orientado a escenarios en los que se requiere realizar verificaciones rápidas y simultáneas sobre el estado de múltiples documentos. **Nota:** A diferencia de los servicios de consulta detallada, este servicio no retorna la información completa del documento ni elementos electrónicos asociados (XML, PDF, QR, etc.). Su propósito es únicamente informar sobre los **estados del documento**. Es ideal para hacer seguimiento masivo al proceso de validación de documentos ante la DIAN y a la notificación al cliente, sin necesidad de consultar cada documento individualmente ni acceder a su contenido. El servicio requiere como entrada: - **ID del facturador electrónico**. - **Lista de documentos a consultar**, donde cada uno debe incluir: - **Prefijo del documento** (si aplica). - **Número del documento**. - **Tipo de documento** (factura, nota crédito o nota débito). ## ¿Qué tipo de información puedes obtener? - **Estado del documento:** - Si el documento ya fue transmitido a la DIAN. - Si está en proceso de validación. - Si fue aprobado por la DIAN. - Si fue rechazado por la DIAN o por el sistema de facturación electrónica. - Fecha de aprobación de la DIAN. - **Estado de notificación al cliente:** - Si el documento fue notificado por correo electrónico. - Si está pendiente de notificación. - Si no requiere notificación, entre otros estados posibles. - Fecha de notificación al cliente (si aplica). ## Ejemplos de uso comunes: - Seguimiento en lote al estado de múltiples documentos emitidos recientemente. - Procesos de control y monitoreo automatizados. - Validaciones previas a procesos de cierre contable o envío de reportes. - Integraciones que requieren verificar el estado sin necesidad del contenido del documento. - [Consultar Estado de notificación a la DIAN de varios documentos electrónicos por ID](https://developer.loggro.com/reference/consultarestadonotificacionlistadocumentoselectronicosbyid.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl/consultarEstadoNotificacionListaDocumentosElectronicosById Este servicio SOAP permite consultar en lote el estado de transmisión a la DIAN y de notificación al cliente de varios documentos electrónicos, utilizando como criterio de búsqueda el **ID interno del documento** junto con el **ID del facturador electrónico**. **Nota:** Este servicio ofrece la misma funcionalidad que el servicio **Consultar Estado de Notificación a la DIAN (por Lote)**, pero permite realizar la consulta utilizando los **ID internos de los documentos**, en lugar de los datos públicos (prefijo, número y tipo). Está diseñado para integraciones en las que se trabaja directamente con los identificadores internos del sistema de facturación, lo cual permite simplificar la consulta y reducir errores asociados al uso de prefijos o números incorrectos. **El servicio requiere como entrada:** - **ID del facturador electrónico** - Lista de documentos a consultar, donde cada uno debe incluir: - **ID interno del documento electrónico** ## ¿Qué tipo de información puedes obtener?** - **Estado del documento:** - Si el documento ya fue transmitido a la DIAN. - Si está en proceso de validación. - Si fue aprobado por la DIAN. - Si fue rechazado por la DIAN o por el sistema de facturación electrónica. - Fecha de aprobación de la DIAN. - **Estado de notificación al cliente:** - Si el documento fue notificado por correo electrónico. - Si está pendiente de notificación. - Si no requiere notificación, entre otros estados posibles. - Fecha de notificación al cliente (si aplica). ## Ejemplos de uso comunes: - Consultas masivas cuando ya se cuenta con los ID internos de los documentos. - Procesos de verificación automatizados sin necesidad de datos visibles del documento. - Seguimiento interno de documentos emitidos desde sistemas ERP o backoffice. - [Consultar Evento generado por el cliente para Facturas a Crédito masivamente](https://developer.loggro.com/reference/consultarestadonotificacionconinformaciontitulovalorlistadocumentoselectronicos.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl/consultarEstadoNotificacionConInformacionTituloValorListaDocumentosElectronicos Este servicio SOAP permite consultar en lote el estado de transmisión a la DIAN y el estado de notificación al cliente de múltiples documentos electrónicos (facturas, notas crédito o notas débito), e incluye adicionalmente el **estado del evento de aceptación del cliente**, necesario para que una factura pueda convertirse en **título valor**. **Nota:** Este servicio es una extensión de **Consultar Estado de Notificación a la DIAN de Varios Documentos Electrónicos**. Además de informar sobre los estados de transmisión y notificación, incluye un **campo adicional** en la respuesta que indica si el cliente ha aceptado formalmente la factura, lo cual es clave en escenarios de **venta a crédito** o con **plazos de pago**. Este servicio es especialmente útil en contextos donde se requiere verificar el estado de varios documentos a la vez, incluyendo si han sido aceptados por los clientes. La aceptación formal habilita a la factura para ser usada como **título valor** en procesos legales o financieros, como la gestión de cartera o el **factoring**. El servicio requiere como entrada: - **ID del facturador electrónico** - **Lista de documentos a consultar**, donde cada uno debe incluir: - **Prefijo del documento** - **Número del documento** - **Tipo de documento** (factura, nota crédito o nota débito) ## ¿Qué tipo de información puedes obtener? - **Estado del documento:** - Si el documento ya fue transmitido a la DIAN. - Si está en proceso de validación. - Si fue aprobado por la DIAN. - Si fue rechazado por la DIAN o por el sistema de facturación electrónica. - Fecha de aprobación de la DIAN. - **Estado de notificación al cliente:** - Si el documento fue notificado por correo electrónico. - Si está pendiente de notificación. - Si no requiere notificación, entre otros estados posibles. - Fecha de notificación al cliente (si aplica). Y adicionalmente, el estado del documento con el **evento** generado por el cliente para que el documento se convierta en **título valor**. ## Casos de uso comunes: - Verificación masiva del estado de facturas a crédito. - Procesos de gestión de cartera o cobranza donde se requiere saber si la factura ya es **título valor**. - Integraciones con módulos financieros o jurídicos. - Automatización con controles previos a cesión de facturas (**factoring**). - [Consultar Evento generado por el cliente para Facturas a Crédito por ID masivamente](https://developer.loggro.com/reference/consultarestadonotificacionconinformaciontitulovalorlistadocumentoselectronicosbyid.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl/consultarEstadoNotificacionConInformacionTituloValorListaDocumentosElectronicosById Este servicio SOAP permite consultar de forma masiva el **estado de transmisión a la DIAN**, el **estado de notificación al cliente**, y el **estado del evento de aceptación del cliente**, utilizando como criterios de entrada los ID Internos de los documentos electrónicos. **Nota:** Este servicio ofrece la misma funcionalidad que el servicio Consultar Estado de Notificación a la DIAN de Varios Documentos Electrónicos con Estado de Evento de Aceptación, pero permite realizar la consulta utilizando directamente los **ID Internos** de los documentos, en lugar del número, prefijo y tipo de documento. Este servicio permite a los sistemas integrados consultar de forma eficiente y masiva si los documentos electrónicos: * Ya fueron transmitidos a la DIAN, * Fueron notificados al cliente, * Y si han sido aceptados formalmente por el cliente, habilitándolos como **títulos valor**. Es especialmente útil en contextos de venta a crédito o con pagos a plazos, donde la aceptación del documento es un requisito legal para su cobro como título valor. El servicio requiere como entrada: * ID del facturador electrónico * Lista de documentos a consultar, donde cada uno debe incluir: * ID interno del documento electrónico ## ¿Qué tipo de información puedes obtener? * **Estado del documento:** * Si el documento ya fue transmitido a la DIAN. * Si está en proceso de validación. * Si fue aprobado por la DIAN. * Si fue rechazado por la DIAN o por el sistema de facturación electrónica. * Fecha de aprobación de la DIAN. * **Estado de notificación al cliente:** * Si el documento fue notificado por correo electrónico. * Si está pendiente de notificación. * Si no requiere notificación, entre otros estados posibles. * Fecha de notificación al cliente (si aplica). Y adicionalmente, el estado del documento con el **evento** generado por el cliente para que el documento se convierta en título valor. ## Casos de uso comunes: * Integradores que trabajan con los identificadores internos de los documentos. * Automatización de verificaciones en sistemas ERP o de gestión financiera. * Procesos de validación masiva de facturas a crédito. * Seguimiento previo a la cesión de facturas (factoring, cobranza, títulos valores). - [Enviar Notificación de Documento Electrónico al cliente por ID](https://developer.loggro.com/reference/iniciarnotificacionclientebyid.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl/iniciarNotificacionClienteById Este servicio SOAP permite **iniciar la notificación al cliente** de un documento electrónico (factura, nota crédito o nota débito), utilizando el **ID interno del documento** como parámetro de identificación, una vez dicho documento ha sido **aprobado por la DIAN**. **Nota:** Este servicio ofrece la misma funcionalidad que el servicio **Enviar Notificación de Documento Electrónico al Cliente**, con la diferencia de que la consulta del documento se realiza a través de su **ID interno**, en lugar de por prefijo y número. Esto libera para integraciones técnicas que gestionan documentos mediante sus identificadores únicos. Permite ejecutar la notificación al cliente final de un documento electrónico aprobado, enviando el PDF correspondiente y los archivos adjuntos si aplica. Es útil para reenviar documentos o realizar notificaciones pendientes de forma programática y más eficiente. El servicio requiere como entrada: - **ID del facturador electrónico** - **ID del documento electrónico** - **Tipo de documento** (factura, nota crédito o nota débito) - **Archivo .ZIP en Base64** que contiene el PDF del documento - **Archivo .ZIP en Base64** con los archivos adjuntos (opcional, si aplica) **Requisitos previos:** - El documento debe haber sido **aprobado por la DIAN**. - Se debe contar con el PDF generado correctamente. ## ¿Qué ocurre al ejecutar el servicio? - Se inicia el proceso de notificación al cliente (vía correo electrónico). - Se asocia el PDF del documento a la notificación. - Se agregan archivos adicionales si fueron suministrados. - El sistema actualiza el estado de notificación del documento. ## Ejemplos de uso comunes: - Notificación automatizada de documentos gestionados internamente por ID. - Procesamiento de notificaciones masivas en procesos batch. - [Enviar Notificación de Documento Electrónico al cliente](https://developer.loggro.com/reference/iniciarnotificacioncliente.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl/iniciarNotificacionCliente Este servicio SOAP permite **iniciar el proceso de notificación al cliente** de un documento electrónico (factura, nota crédito o nota débito), una vez dicho documento ha sido **validado y aprobado por la DIAN**, es decir, cuando se considera oficialmente **expedido**. La notificación es un paso esencial en el proceso de facturación electrónica, ya que garantiza que el adquiriente reciba el documento electrónico generado y la representación gráfica (PDF), y los archivos adjuntos que correspondan. Permite notificar manual o programáticamente al cliente final los documentos electrónicos emitidos, facilitando la entrega del PDF y otros archivos relacionados. El servicio requiere como entrada: - **ID del facturador electrónico** - **Prefijo del documento** - **Número del documento** - **Tipo de documento** (factura, nota crédito o nota débito) - **Archivo .ZIP en Base64** que contiene el PDF del documento - **Archivo .ZIP en Base64** con los archivos adjuntos (opcional, si aplica) Requisitos previos: - El documento debe haber sido **aprobado por la DIAN**. - Se debe contar con el **PDF generado correctamente**. ## ¿Qué ocurre al ejecutar el servicio? - Se inicia el proceso de notificación al cliente (vía correo electrónico). - Se asocia el PDF del documento a la notificación. **Notas:** - Se agregan adjuntos adicionales si fueron suministrados. - El sistema actualiza el estado de notificación del documento. ## Ejemplos de uso comunes: - Procesos automáticos de notificación para facturación masiva. - Integración con portales de clientes o herramientas de atención postventa. - [Reenviar Notificación de Documento Electrónico al cliente por ID](https://developer.loggro.com/reference/reenviarnotificacionclientebyid.md): PENDIENTE - Reenvía la notificación al cliente usando el **ID** del documento y el ID del facturador. - [Reenviar Notificación de Documento Electrónico al cliente](https://developer.loggro.com/reference/reenviarnotificacioncliente.md): PENDIENTE - Reenvía la notificación al cliente por prefijo/número/tipo de documento e ID del facturador. - [Actualizar correo del cliente masivamente](https://developer.loggro.com/reference/actualizarcorreoclientelistadocumentos.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl/actualizarCorreoClienteListaDocumentos Este servicio SOAP permite actualizar la dirección de correo electrónico del cliente asociada a una lista de documentos electrónicos (facturas, notas crédito o notas débito) y, de forma automática, **realiza la notificación al nuevo correo actualizado**. Está diseñado para casos en los que la notificación original falló debido a una dirección de correo inválida o incorrecta, facilitando la corrección y **reenvío automático** del documento sin necesidad de consumir otro servicio adicional. **Importante:** Al ejecutar este servicio, el sistema **actualiza el correo electrónico del cliente y notifica automáticamente** los documentos al nuevo correo suministrado. **No es necesario invocar posteriormente el servicio de notificación.** ### Recomendación importante: Antes de ejecutar este servicio, asegúrate de que el **nuevo correo electrónico esté validado** o correctamente formateado. Una dirección inválida generará una nueva falla de notificación automática, lo que podría afectar la trazabilidad del proceso. Este servicio agiliza el proceso de corrección de notificaciones fallidas, permitiendo una solución eficiente cuando se detectan errores en las direcciones de correo registradas en los documentos. ### El servicio requiere como entrada: - **ID del facturador electrónico** - Lista de documentos, donde cada uno debe incluir: - **Prefijo del documento** (si aplica) - **Número del documento** - **Tipo de documento** (factura, nota crédito o nota débito) - **Nueva dirección de correo electrónico del cliente** ### ¿Qué realiza este servicio? - **Actualiza el correo electrónico del cliente** para cada documento especificado. - Ejecuta de forma inmediata **la notificación al nuevo correo registrado**. - Genera el resultado de la notificación correspondiente dentro del sistema. ### Casos de uso comunes: - Corrección de errores de digitación en correos electrónicos de clientes. - Reenvío automático de notificaciones fallidas sin intervención adicional. - Corrección masiva de documentos con notificaciones no entregadas. - Solución de errores del cliente en bloque, con notificación incluida. - [Actualizar correo del cliente masivamente por ID](https://developer.loggro.com/reference/actualizarcorreoclientelistadocumentosbyid.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl/actualizarCorreoClienteListaDocumentosById Este servicio SOAP permite **actualizar la dirección de correo electrónico del cliente** para una lista de documentos electrónicos (facturas, notas crédito o notas débito), identificados por su **ID interno**, y **realiza automáticamente la notificación** al nuevo correo proporcionado. **Nota:** Este servicio es equivalente a *Actualizar Correo del Cliente Masivamente*, pero en lugar de requerir prefijo, número y tipo de documento, permite identificar los documentos mediante su **ID interno**, lo cual es ideal para integraciones más técnicas o sistemas que ya manejan esos identificadores únicos. **Recomendación importante:** Asegúrate de que la nueva dirección de correo electrónico esté correctamente escrita y validada, ya que la notificación se enviará de forma inmediata al actualizar el correo. Una dirección inválida causará una nueva falla en la entrega del documento. ## El servicio requiere como entrada: - **ID del facturador electrónico** - **Lista de documentos**, donde cada uno debe incluir: - **ID del documento electrónico** - **Nueva dirección de correo electrónico del cliente** ## ¿Qué realiza este servicio? - Actualiza el correo electrónico del cliente en cada documento especificado por su ID. - Notifica automáticamente el documento al nuevo correo. - Registra el resultado de la notificación y deja trazabilidad del proceso. ## Ejemplos de uso comunes: - Corrección masiva de correos fallidos en notificaciones. - Automatización de procesos postventa o de atención al cliente. - Actualización desde sistemas internos que manejan solo los IDs de documentos. - Minimizar errores humanos al no depender de prefijos y números de documento. - [Consultar si Factura a Crédito cuenta con evento de Aceptación](https://developer.loggro.com/reference/consultardocumentoyaaceptadodian.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/FacturacionElectronica/FacturacionElectronicaValidacionPrevia?wsdl/consultarDocumentoYaAceptadoDian Este servicio SOAP permite consultar si una **factura electrónica emitida a crédito** ya cuenta con un **evento de aceptación** registrado, ya sea expreso o tácito. Esta información es fundamental para garantizar el cumplimiento normativo y controlar la gestión de ajustes posteriores a la emisión. **Importante:** Si una factura ya ha sido aceptada (expresa o tácitamente), **no será posible emitir notas crédito o débito** que hagan referencia directa a ella. En estos casos, si se requiere realizar un ajuste, la nota correspondiente deberá generarse en relación con la factura original como **documento referenciado**. Este servicio está diseñado para validar, previo a la generación de notas crédito o débito, si la factura ya ha sido aceptada por el cliente. Permite a las compañías evitar errores de procesamiento y cumplir con las restricciones legales asociadas al uso de facturas como título valor. El servicio requiere como entrada: - **Prefijo del documento** (si aplica) - **Número del documento** - **ID del facturador electrónico** propietario del documento ## ¿Qué información puedes obtener? - **Indicador** de si la factura ha sido aceptada o no - **CUFE** de la factura electrónica ## Casos de uso comunes: - Validación previa a la generación de notas crédito o débito. - Procesos de control interno para evitar ajustes inválidos sobre facturas aceptadas. - Cumplimiento normativo en escenarios de venta a crédito. - Verificaciones dentro de flujos de aprobación en gestión de cartera. - [Consultar documentos electrónicos recibidos por lote según origen](https://developer.loggro.com/reference/consultardocumentosrecibidoslotepororigen.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/FacturacionElectronica/RecepcionDocumentoElectronicoValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/FacturacionElectronica/RecepcionDocumentoElectronicoValidacionPrevia?wsdl/consultarDocumentosRecibidosLotePorOrigen Este servicio SOAP permite consultar los documentos electrónicos que han sido enviados a tu compañía por proveedores u otros emisores, filtrando por el origen del sistema facturador. Los documentos se entregan agrupados en un lote identificado por el parámetro **idLote**, lo que permite un seguimiento ordenado del proceso de recepción. El flujo de uso recomendado es el siguiente: 1. Llamas a este servicio para obtener los documentos pendientes de procesar en el lote indicado, para el origen especificado. 2. Procesas los documentos en tu sistema (validación, registro contable, etc.). 3. Confirmas el lote mediante el servicio **Confirmar Lote de Documentos Recibidos Por Origen**, indicando que los documentos fueron recibidos y procesados exitosamente. Este servicio soporta los siguientes tipos de documentos: - **Factura de venta electrónica** (FAVE): documentos de compra emitidos por tus proveedores. - **Nota crédito electrónica** (NCVE): ajustes o devoluciones sobre facturas recibidas. - **Nota débito electrónica** (NDVE): cargos adicionales o ajustes sobre facturas recibidas. ## El servicio requiere como entrada - **NIT del facturador** (obligatorio): identificación de tu compañía como receptor de los documentos. - **ID del lote** (obligatorio): identificador único del lote de documentos a consultar. Este identificador es generado por el sistema receptor y se utiliza para rastrear y confirmar el grupo de documentos retornados. - **Origen** (obligatorio): código del sistema facturador desde el cual se originaron los documentos. Valores posibles: - `L`: Loggro - `E`: Enterprise - `X`: Externo - `R`: Restobar - `A`: Alojamientos - `P`: Postienda ## ¿Qué tipo de información puedes obtener? - Lista de documentos electrónicos recibidos, cada uno con: - Información del proveedor (identificación, tipo, nombre). - Tipo, prefijo y número del documento. - XML de información del documento en Base64 (`xmlInformacionDocumento`). - XML completo del documento en formato origen en Base64 (`xmlInformacionCompletaDocumentoEnFormatoOrigen`). - XML de la DIAN en Base64 (`xmlDian`). - PDF de la representación gráfica en Base64. - Estado del documento y descripción. - Fecha de recepción. - Indicador de procesamiento exitoso y mensajes de error si aplica. - Totales por tipo de documento (facturas, notas crédito, notas débito). - Cantidad de documentos faltantes en el lote. ## Formato específico del XML **Consulta el detalle técnico del formato:** [Estructura Documentos Recibidos - Facturación Electrónica 1.xlsx](https://loggro.com/download/Estructura%20Documentos%20Recibidos%20-%20Facturaci%C3%B3n%20Electr%C3%B3nica%201.xlsx) ## Ejemplos de uso comunes - Integración de facturas de proveedores desde tu ERP o sistema contable, segmentando por origen del sistema facturador. - Automatización del registro de compras a partir de documentos electrónicos recibidos desde un origen específico. - Procesos de conciliación y validación de compras contra órdenes de pedido, diferenciando por origen. - [Confirmar lote de documentos electrónicos recibidos por origen](https://developer.loggro.com/reference/confirmarlotepororigen.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/FacturacionElectronica/RecepcionDocumentoElectronicoValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/FacturacionElectronica/RecepcionDocumentoElectronicoValidacionPrevia?wsdl/confirmarLotePorOrigenDocumentosRecibidos Este servicio SOAP permite confirmar que un lote de documentos electrónicos recibidos, de un origen específico, fue procesado exitosamente por tu compañía. **Importante:** Este servicio debe ser invocado siempre después de **Consultar Documentos Recibidos Por Origen**, una vez que los documentos del lote hayan sido procesados en tu sistema. La confirmación es necesaria para que el sistema marque el lote como procesado y no lo retorne en consultas posteriores. Si el lote **no es confirmado**, los documentos seguirán disponibles en futuras consultas con el mismo identificador de lote y origen, lo que permite reintentar el procesamiento en caso de fallo. ## El servicio requiere como entrada - **NIT del facturador** (obligatorio): identificación de tu compañía como receptor de los documentos. - **ID del lote** (obligatorio): identificador único del lote a confirmar, previamente obtenido al consultar los documentos recibidos mediante el servicio **Consultar Documentos Recibidos Por Origen**. - **Origen** (obligatorio): código del sistema facturador desde el cual se originaron los documentos. Debe ser el mismo valor utilizado en la consulta previa. Valores posibles: - `L`: Loggro - `E`: Enterprise - `X`: Externo - `R`: Restobar - `A`: Alojamientos - `P`: Postienda ## Respuesta del servicio El servicio retorna un valor booleano: - `true`: la confirmación fue exitosa y el lote quedó marcado como procesado. - `false`: la confirmación no pudo completarse. ## ¿Qué ocurre al confirmar el lote? - El sistema marca los documentos del lote como procesados. - Los documentos confirmados no se retornarán en consultas posteriores de documentos recibidos para ese origen. - Se registra trazabilidad del proceso de recepción y confirmación. ## Ejemplos de uso comunes - Confirmación automática tras la integración exitosa de documentos en un ERP, segmentando por origen del sistema facturador. - Procesos de carga nocturna donde se consultan y confirman lotes en ciclos batch por origen. - Reintentos controlados cuando el procesamiento falla: si no se confirma, el lote se puede consultar nuevamente con el mismo origen. - [Introducción](https://developer.loggro.com/reference/introducción.md) - [Autenticación ](https://developer.loggro.com/reference/autenticación.md) - [Generar Documento Soporte](https://developer.loggro.com/reference/generardocumentosoporte.md): description: > **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/DocumentoSoporte/DocumentoSoporteValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/DocumentoSoporte/DocumentoSoporteValidacionPrevia?wsdl/generarDocumentoSoporte

Este servicio permite emitir un Documento Soporte electrónico ante la DIAN. Envía un archivo `.zip` codificado en **Base64** que contiene el XML estructurado del documento soporte. El servicio valida automáticamente la estructura y el contenido del XML según las especificaciones de la DIAN, y si es válido, transmite el documento a la autoridad tributaria para su registro oficial. ## Formato específico del XML **Consulta el detalle técnico del formato requerido para el XML:** [Estructura Documentos Electrónicos - Documento Soporte.xlsx](https://loggro.com/download/Estructura%20Documentos%20Electr%C3%B3nicos%20-%20Documento%20Soporte.xlsx) ## Ejemplos de uso comunes - Emitir documentos soporte de adquisiciones para soportar costos y deducciones tributarias. - Registrar compras a proveedores no obligados a facturar electrónicamente. - Documentar transacciones con personas naturales sin obligación de facturación electrónica. - [Generar Documentos Soporte masivamente](https://developer.loggro.com/reference/generarlistadocumentossoporte.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/DocumentoSoporte/DocumentoSoporteValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/DocumentoSoporte/DocumentoSoporteValidacionPrevia?wsdl/generarListaDocumentosSoporte Este servicio **SOAP** permite la **emisión masiva de documentos soporte electrónicos** ante la **DIAN**, facilitando el envío de hasta **30 documentos en un solo lote**. Está diseñado para **optimizar procesos de alto volumen** de forma segura y cumpliendo con la **normativa vigente en Colombia**. Este servicio está orientado a escenarios donde se requiere **emitir múltiples documentos en una sola operación** y soporta los siguientes tipos: - **Documento Soporte Electrónico**: para reportar adquisiciones a proveedores no obligados a facturar electrónicamente. - **Nota de Ajuste**: para corregir, anular o ajustar documentos soporte previamente enviados. ⚠️ **Recomendación:** Este servicio **no está optimizado para procesos en línea o en tiempo real**. Los tiempos de respuesta pueden ser mayores debido al procesamiento simultáneo de múltiples documentos. ## ¿Cómo funciona? 1. Envías un archivo `.zip` codificado en **Base64** que contiene: - Hasta **30 archivos XML**, cada uno representando un documento soporte o una nota de ajuste individual. - Cada uno de los XML debe seguir un **formato específico**, detallado en la sección correspondiente (ver enlace al final). 2. El servicio **valida y procesa cada documento individualmente**: - Los documentos válidos son transmitidos a la **DIAN** conforme a los estándares oficiales. - Los documentos con errores no se transmiten y se retorna una respuesta individual con el detalle de los errores encontrados. ## Formato específico del XML **Consulta el detalle técnico del formato requerido para el XML:** [Estructura Documentos Electrónicos - Documento Soporte.xlsx](https://loggro.com/download/Estructura%20Documentos%20Electr%C3%B3nicos%20-%20Documento%20Soporte.xlsx) ## Ejemplos de uso comunes - **Emisión diaria o periódica** de grandes volúmenes de Documentos Soporte. - **Procesamiento por lotes** desde sistemas contables o **ERP**. - [Consultar Información Documento Soporte](https://developer.loggro.com/reference/consultarinformaciondocumentosoporte.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/DocumentoSoporte/DocumentoSoporteValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/DocumentoSoporte/DocumentoSoporteValidacionPrevia?wsdl/consultarInformacionDocumentoSoporte Este servicio **SOAP** permite **consultar la información relacionada con un documento electrónico previamente emitido**, ya sea un **Documento Soporte** por compras a no obligados a facturar o una **Nota de Ajuste**. Está diseñado para facilitar el **seguimiento del ciclo de vida del documento**, desde su generación hasta su aprobación por la **DIAN**. Este servicio es útil cuando se requiere **verificar el estado de un documento electrónico** en el sistema de facturación o ante la DIAN. También permite **recuperar los elementos asociados al documento**, como el XML original, el código QR, entre otros. ## Parámetros de entrada requeridos - **Prefijo del documento** (si aplica) - **Número del documento** - **Tipo de documento** (*Documento Soporte* o *Nota de Ajuste*) - **ID del facturador electrónico** propietario del documento ## ¿Qué tipo de información puedes obtener? ### Estado del documento - Si el documento **ya fue transmitido a la DIAN**. - Si está **en proceso de validación**. - Si fue **aprobado** por la DIAN. - Si fue **rechazado** por la DIAN o por el sistema de facturación electrónica. - **Fecha de aprobación** y **respuesta oficial** (código y descripción). ### Elementos electrónicos generados en el proceso - **XML** del documento transmitido (*codificado en Base64*). - **Código QR** del documento (*codificado en Base64*). - **CUDS** del documento electrónico. ## Casos de uso comunes - **Consulta de Documentos Soporte** para verificar el estado o información aprobada por la DIAN. - **Verificación de Notas de Ajuste** emitidas para corregir errores en documentos previamente generados (por ejemplo, valores incorrectos y datos del proveedor). - **Obtención de XML o QR** del documento electrónico transmitido, para procesos de auditoría o almacenamiento contable. - [Consultar Información Documento Soporte por ID](https://developer.loggro.com/reference/consultarinformaciondocumentosoportebyid.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/DocumentoSoporte/DocumentoSoporteValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/DocumentoSoporte/DocumentoSoporteValidacionPrevia?wsdl/consultarInformacionDocumentoSoporteById Este servicio SOAP permite consultar la información relacionada con un documento electrónico previamente emitido, ya sea un **Documento Soporte** por compras a no obligados a facturar o una **Nota de Ajuste**, utilizando como criterios de búsqueda el **ID interno del documento** y el **ID del facturador electrónico**. > **Nota:** Este servicio ofrece la misma funcionalidad que el servicio *Consultar Información Documento Soporte Electrónico* descrito anteriormente. La única diferencia radica en la forma en que se realiza la consulta: en lugar de utilizar el **prefijo**, **número** y **tipo de documento**, aquí se usa directamente el **ID del documento**. Este servicio está orientado a escenarios donde se dispone del **ID del documento** y se requiere consultar sus estados u obtener los elementos electrónicos generados. ## Parámetros de entrada - **ID del documento:** Identificador interno asignado por el sistema de facturación. - **ID del facturador electrónico:** Identificador del facturador propietario del documento. ## ¿Qué tipo de información puedes obtener? ### Estado del documento: - Si el documento ya fue transmitido a la DIAN. - Si está en proceso de validación. - Si fue aprobado por la DIAN. - Si fue rechazado por la DIAN o por el sistema de facturación electrónica. - Fecha de aprobación y respuesta oficial (código y descripción). ### Elementos electrónicos generados: - **XML del documento:** codificado en Base64. - **Código QR:** imagen codificada en Base64. - **CUDS del documento electrónico.** ## Casos de uso comunes - Generación de **Documentos Soporte** para registrar compras a proveedores no obligados a facturar electrónicamente. - Emisión de **Notas de Ajuste** para corregir errores en documentos previamente generados (por ejemplo, valores incorrectos o datos del proveedor). - Registro de **devoluciones o anulaciones** de operaciones asociadas a Documentos Soporte emitidos. - [Consultar Acuse Recibo DIAN Documento Soporte por ID](https://developer.loggro.com/reference/consultaracuserecibodiandocumentosoportebyid.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/DocumentoSoporte/DocumentoSoporteValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/DocumentoSoporte/DocumentoSoporteValidacionPrevia?wsdl/consultarAcuseReciboDianDocumentoSoporteById Este servicio SOAP permite consultar el **acuse de recibo de la DIAN** para un **Documento Soporte** o una **Nota de Ajuste**, utilizando el **ID interno del documento** y el **ID del facturador electrónico**. El **acuse de recibo** contiene la respuesta oficial emitida por la DIAN, indicando si el documento fue **aprobado** o **rechazado**, junto con la **fecha de validación** y la **descripción detallada del estado**. ## Parámetros de entrada - **ID del documento:** Identificador interno asignado por el sistema de facturación. - **ID del facturador electrónico:** Identificador del facturador propietario del documento. ## ¿Qué información se obtiene? - Estado del documento validado por la DIAN (Aprobado o Rechazado). - Descripción oficial del resultado de la validación. - Fecha y hora en que la DIAN procesó la validación del documento. - Identificadores asociados al acuse (CUDE, nombre de archivo, etc.). ## Ejemplos de uso comunes - Verificar la **respuesta de la DIAN** sobre un Documento Soporte o Nota de Ajuste transmitido. - Consultar el **estado de aprobación o rechazo** emitido por la autoridad tributaria. - Obtener la **fecha y hora exacta** en que la DIAN realizó la validación del documento. - [Consultar XML Acuse Recibo DIAN Documento Soporte por ID](https://developer.loggro.com/reference/consultarxmlacuserecibodiandocumentosoportebyid.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/DocumentoSoporte/DocumentoSoporteValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/DocumentoSoporte/DocumentoSoporteValidacionPrevia?wsdl/consultarXmlAcuseReciboDianDocumentoSoporteById Este servicio SOAP permite consultar el **XML del acuse de recibo de la DIAN** para un **Documento Soporte** o una **Nota de Ajuste**, utilizando el **ID interno del documento** y el **ID del facturador electrónico**. El **acuse de recibo** contiene la respuesta oficial emitida por la DIAN, indicando si el documento fue **aprobado** o **rechazado**, junto con la **fecha de validación** y la **descripción detallada del estado**. ## Ejemplos de uso comunes - Obtener el **archivo XML** del acuse de recibo de la DIAN para almacenamiento permanente. - Conservar el **XML del acuse** para propósitos de auditoría, respaldo legal y cumplimiento normativo. - Procesar automáticamente la **respuesta estructurada de la DIAN** en sistemas de información contable o tributaria. - [Obtener URL para consultar Documento Soporte en la DIAN](https://developer.loggro.com/reference/consultarinformacionurldocumento.md): **Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/DocumentoSoporte/DocumentoSoporteValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/DocumentoSoporte/DocumentoSoporteValidacionPrevia?wsdl/consultarInformacionUrlDocumento Este servicio SOAP permite obtener una **URL de acceso** al sistema **Facturando Electrónicamente de la DIAN**. A través de esta URL, se puede consultar el **Documento Soporte Electrónico** o la **Nota de Ajuste** directamente en el sistema oficial de la DIAN, garantizando la **integridad** y **validez** de la información. ## Ejemplos de uso comunes - Permite al área contable o al usuario final **verificar que un Documento Soporte** ha sido registrado correctamente en el sistema oficial de la DIAN. - Integra la **URL oficial del documento** en plataformas donde los proveedores pueden consultar el estado y validez de sus comprobantes electrónicos. - Facilita la **trazabilidad de documentos** ante auditorías internas o requerimientos de la DIAN, generando enlaces verificables. - [Introducción](https://developer.loggro.com/reference/introducción-1.md) - [Autenticación](https://developer.loggro.com/reference/autenticarusuario.md): **Url Servicio:** Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL, que siempre va a terminar en /api/auth. Ejemplo:: https://apiprb.loggro.com/api/auth En el Header del Response del servicio de autenticación se entrega el **Bearer Token**, el cual deberá incluirse en todas las llamadas posteriores a los servicios REST de Nómina Electrónica. Una vez autenticado, deberás: - Utilizar en todas las llamadas posteriores a los servicios REST de Nómina Electrónica la **URL** entregada en el campo `url` de la respuesta. - Incluir el **Bearer Token** en el Header de cada solicitud. - De esta forma podrás realizar las operaciones disponibles dentro de los servicios REST de Nómina Electrónica. - [Generar comprobante individual de nómina electrónica](https://developer.loggro.com/reference/post_comprobante.md): **Url Servicio:** Debes reemplazar el valor {urlServicio} por la URL que recibiste en la respuesta del servicio de Autenticación. Ejemplo: Si la URL recibida en el servicio es https://apiprb.loggro.com Entonces, la Url para el consumo del servicio será: https://apiprb.loggro.com/api/v1/comprobante Este servicio REST permite generar un documento soporte por pago de nómina electrónica para un empleado, cumpliendo con los requisitos establecidos por la DIAN. **Formato del JSON:** Consulta el detalle técnico del formato requerido en [Estructura Documentos Electrónicos - Nómina Electrónica.xlsx](https://loggro.com/download/Estructura%20Documentos%20Electr%C3%B3nicos%20-%20N%C3%B3mina%20Electr%C3%B3nica.xlsx) - [Generar múltiples comprobantes de nómina electrónica](https://developer.loggro.com/reference/post_comprobantes.md): **Url Servicio:** Debes reemplazar el valor {urlServicio} por la URL que recibiste en la respuesta del servicio de Autenticación. Ejemplo: Si la URL recibida en el servicio es https://apiprb.loggro.com Entonces, la Url para el consumo del servicio será: https://apiprb.loggro.com/api/v1/comprobantes Este servicio REST permite generar hasta 100 documentos soporte por pago de nómina electrónica, cumpliendo con los requisitos establecidos por la DIAN. **Formato del JSON:** Consulta el detalle técnico del formato requerido en [Estructura Documentos Electrónicos - Nómina Electrónica.xlsx](https://loggro.com/download/Estructura%20Documentos%20Electr%C3%B3nicos%20-%20N%C3%B3mina%20Electr%C3%B3nica.xlsx) - [Consultar comprobantes generados](https://developer.loggro.com/reference/get_comprobantes.md): **Url Servicio:** Debes reemplazar el valor {urlServicio} por la URL que recibiste en la respuesta del servicio de Autenticación. Ejemplo: Si la URL recibida en el servicio es https://apiprb.loggro.com Entonces, la Url para el consumo del servicio será: https://apiprb.loggro.com/api/v1/comprobantes A través de este servicio REST es posible obtener la información de uno o varios Documentos Soporte de Pago de Nómina Electrónica, previamente generados y transmitidos a la DIAN. El servicio admite la consulta de hasta 300 documentos por petición. Permite verificar si un documento fue correctamente generado y transmitido a la DIAN, así como identificar posibles errores reportados por la entidad o por el sistema interno. - [Consultar XML de acuses de recibo DIAN de un comprobante](https://developer.loggro.com/reference/get_comprobante-xmlacusesrecibodian.md): **Url Servicio:** Debes reemplazar el valor {urlServicio} por la URL que recibiste en la respuesta del servicio de Autenticación. Ejemplo: Si la URL recibida en el servicio es https://apiprb.loggro.com Entonces, la Url para el consumo del servicio será: https://apiprb.loggro.com/api/v1/comprobante/xmlAcusesReciboDian Permite consultar los archivos XML de los acuses de recibo emitidos por la DIAN para un comprobante de nómina electrónica. Retorna los archivos comprimidos en formato ZIP. - [Consultar historial de procesos de un comprobante](https://developer.loggro.com/reference/get_comprobante-historial.md): **Url Servicio:** Debes reemplazar el valor {urlServicio} por la URL que recibiste en la respuesta del servicio de Autenticación. Ejemplo: Si la URL recibida en el servicio es https://apiprb.loggro.com Entonces, la Url para el consumo del servicio será: https://apiprb.loggro.com/api/v1/comprobante/historial Permite consultar el detalle del historial de procesos generados para un comprobante de nómina electrónica. Incluye información sobre cada etapa del proceso de generación, firma, envío y respuesta de la DIAN. - [Consultar elementos electrónicos de un comprobante](https://developer.loggro.com/reference/get_comprobante-elementoselectronicos.md): **Url Servicio:** Debes reemplazar el valor {urlServicio} por la URL que recibiste en la respuesta del servicio de Autenticación. Ejemplo: Si la URL recibida en el servicio es https://apiprb.loggro.com Entonces, la Url para el consumo del servicio será: https://apiprb.loggro.com/api/v1/comprobante/elementoselectronicos Permite consultar o descargar los elementos electrónicos asociados a un comprobante individual de nómina electrónica. Los elementos incluyen los archivos generados y enviados a la DIAN, como el XML, el PDF representativo y otros anexos relacionados con el comprobante. - [Obtener archivos asociados a un comprobante](https://developer.loggro.com/reference/get_comprobante-archivos.md): **Url Servicio:** Debes reemplazar el valor {urlServicio} por la URL que recibiste en la respuesta del servicio de Autenticación. Ejemplo: Si la URL recibida en el servicio es https://apiprb.loggro.com Entonces, la Url para el consumo del servicio será: https://apiprb.loggro.com/api/v1/comprobante/archivos Permite consultar y descargar los archivos electrónicos asociados a un comprobante individual de nómina electrónica, como el XML, PDF o archivo comprimido ZIP. A través de este servicio, es posible acceder a los elementos digitales generados durante la emisión del comprobante, los cuales son fundamentales para procesos de auditoría, respaldo, o envío al empleado. Los archivos devueltos corresponden exclusivamente al comprobante identificado por su identificador único. - [Consultar acuses de recibo DIAN de un comprobante](https://developer.loggro.com/reference/get_comprobante-acusesrecibodian.md): **Url Servicio:** Debes reemplazar el valor {urlServicio} por la URL que recibiste en la respuesta del servicio de Autenticación. Ejemplo: Si la URL recibida en el servicio es https://apiprb.loggro.com Entonces, la Url para el consumo del servicio será: https://apiprb.loggro.com/api/v1/comprobante/acusesReciboDian Permite consultar los acuses de recibo emitidos por la DIAN para un comprobante de nómina electrónica. Los acuses de recibo confirman la recepción y validación del documento por parte de la entidad. - [Introducción Enterprise](https://developer.loggro.com/reference/introduccion-enterprise.md): Servicios Loggro Enterprise - [Autenticación](https://developer.loggro.com/reference/autenticacion-enterprise.md): Para acceder a los servicios de **LOGGRO Enterprise**, es esencial completar un proceso de autenticación, que incluye la obtención de un **token de acceso**. - [Consultar Cliente](https://developer.loggro.com/reference/consultarcliente.md): Permite consultar la información básica de un cliente a partir de su número de **identificación**. El servicio realiza la búsqueda en dos posibles fuentes de datos: Tablas definitivas (cliente registrado oficialmente) y Tablas de entrada (cliente pendiente de consolidación). En la respuesta, el campo 'ubicacion' indica el origen de los datos obtenidos. También se valida la sesión del usuario mediante autenticación Bearer Token. - [Crear Cliente](https://developer.loggro.com/reference/crearcliente.md): Permite registrar uno o varios clientes. Cada petición puede contener múltiples registros y cada uno será validado individualmente antes de procesarse. El servicio retorna una lista de resultados que indican si cada cliente fue creado exitosamente o si presentó errores. - [Eliminar Cliente](https://developer.loggro.com/reference/eliminartercerocliente.md): Elimina un cliente del sistema a partir de su número de **identificación**, sobre las tablas definitivas. Si se envía el parámetro 'establecimiento' solo se elimina ese establecimiento puntual; en caso contrario se elimina el cliente completo con todos sus establecimientos. También se valida la sesión del usuario mediante autenticación Bearer Token. **Ejemplos de consumo:** - Eliminar el cliente completo (todos sus establecimientos): `DELETE /api/v1/cliente/901361537` - Eliminar únicamente un establecimiento puntual del cliente: `DELETE /api/v1/cliente/901361537?establecimiento=001` - [Consultar Proveedor](https://developer.loggro.com/reference/consultarproveedor.md): Este endpoint permite consultar la información de un tercero proveedor a partir de su número de identificación. Primero se busca en las tablas definitivas y, si no se encuentra allí, se consulta en las tablas de entrada. El resultado incluirá la información del proveedor y el origen donde fue hallado. - [Crear Proveedor](https://developer.loggro.com/reference/crearproveedor.md): Permite registrar uno o varios establecimientos asociados a un proveedor. Cada petición puede contener múltiples proveedores, y cada registro será validado individualmente. El servicio retorna el resultado de la importación con el detalle de las operaciones exitosas y las fallidas. - [Eliminar proveedor](https://developer.loggro.com/reference/eliminarproveedor.md): Marca el proveedor como eliminado (soft delete). **Autenticación requerida:** Bearer Token. - [Consultar Tercero](https://developer.loggro.com/reference/consultartercero.md): Permite consultar la información general de un tercero a partir de su número de **identificación**. El servicio valida la sesión del usuario y retorna los datos básicos del tercero si existe en el sistema. - [Crear Tercero](https://developer.loggro.com/reference/creartercero.md): Permite registrar uno o varios terceros. Cada petición puede contener múltiples terceros, y cada registro será validado individualmente. El servicio retorna el resultado de la importación con el detalle de las operaciones exitosas y las fallidas. - [Eliminar Tercero](https://developer.loggro.com/reference/eliminartercero.md): Elimina un tercero del sistema a partir de su número de identificación. - [Consultar Conceptos Contables](https://developer.loggro.com/reference/consultarconceptocontable.md): Permite consultar la información básica de un concepto contable a partir de su **código**. También se valida la sesión del usuario mediante autenticación Bearer Token. - [Crear Concepto Contable](https://developer.loggro.com/reference/crearconceptocontable.md): Permite registrar uno o varios conceptos contables. Cada petición puede contener múltiples registros y cada uno será validado individualmente antes de procesarse. El código del concepto contable debe ser único por compañía: si ya existe (dentro del mismo lote enviado o previamente creado), el registro se reporta como error y no se guarda, sin afectar el resto del lote. Los campos identificador, división y contabilizaDivision no se reciben en la petición: se asignan internamente (identificador = 2, división y contabilizaDivision = compañía de la sesión). El estado se asigna automáticamente como AC (Activo). - [Eliminar Concepto Contable](https://developer.loggro.com/reference/eliminarconceptocontable.md): Elimina un concepto contable del sistema a partir de su código. Si el concepto tiene información asociada en co_infadielem (mismo código, compañía de la sesión e identificador de concepto contable), se elimina lógicamente (estado Suspendido, sin borrar el registro); si no tiene información asociada, se elimina físicamente el registro. - [Consultar Cuentas Contables](https://developer.loggro.com/reference/consultarcuentacontable.md): Permite consultar la información básica de una cuenta contable a partir de su **código**. También se valida la sesión del usuario mediante autenticación Bearer Token. - [Crear Cuenta Contable](https://developer.loggro.com/reference/crearcuentacontable.md): Permite registrar una o varias cuentas contables. Cada petición puede contener múltiples registros y cada uno será validado individualmente antes de procesarse. La información no se guarda directamente en las tablas definitivas de cuentas contables, sino en una tabla de importación intermedia que permite su posterior revisión y procesamiento. El servicio retorna una lista de resultados que indican si cada cuenta contable fue creada exitosamente o si presentó errores. - [Eliminar Cuenta Contable](https://developer.loggro.com/reference/eliminarcuentacontable.md): Elimina una cuenta contable del sistema a partir de su código. - [Consultar Fuentes Contables](https://developer.loggro.com/reference/consultarfuentecontable.md): Permite consultar la información básica de una fuente contable a partir de su **código**. También se valida la sesión del usuario mediante autenticación Bearer Token. - [Crear Fuente Contable](https://developer.loggro.com/reference/crearfuentecontable.md): Permite registrar una o varias fuentes contables. Cada petición puede contener múltiples fuentes contables, y cada registro será validado individualmente. El servicio retorna el resultado de la creación con el detalle de las operaciones exitosas y las fallidas. - [Eliminar Fuente Contable](https://developer.loggro.com/reference/eliminarfuentecontable.md): Elimina físicamente una fuente contable del sistema a partir de su código (DELETE real sobre co_fuentes, no un retiro lógico). - [Crear Comprobante](https://developer.loggro.com/reference/crearcomprobante.md): El servicio está diseñado para recibir información destinada a la generación de comprobantes, ya sea de manera individual o en lote. Se permite enviar **un único comprobante** o **varios en un array**. Si alguno de los documentos falla en la validación, el sistema continuará procesando los demás y reportará los errores individualmente en la respuesta. - [Consultar Comprobante Contable](https://developer.loggro.com/reference/consultarcomprobantecontable.md): Permite consultar el encabezado y el detalle de un comprobante contable a partir de su clave primaria: **comprobante**, **fuente**, **lote**, **división**, **periodo** y **año**. La compañía se determina a partir de la sesión del usuario autenticado mediante Bearer Token. Si se omite el parámetro `division`, se asume igual al código de la compañía. - [Crear Ítem](https://developer.loggro.com/reference/crearitem.md): Permite registrar uno o varios ítems en el sistema. Cada petición puede contener múltiples ítems, y cada registro será validado individualmente. El servicio retorna el resultado de la importación con el detalle de las operaciones exitosas y fallidas. - [Consultar Ítem](https://developer.loggro.com/reference/consultaritem.md): Retorna la información completa de un ítem (tabla IN_ITEMS) a partir de su **código**. La compañía se obtiene automáticamente de la sesión del usuario autenticado. - [Retirar Ítem](https://developer.loggro.com/reference/eliminaritem.md): Elimina físicamente un ítem del sistema (tabla IN_ITEMS) a partir de su código. La compañía se obtiene automáticamente de la sesión del usuario autenticado. Internamente invoca el procedimiento almacenado sp_inv_retirar_item, el cual valida que el ítem no tenga registros relacionados en otras tablas transaccionales antes de eliminarlo. - [Consultar ítems asociados a un control](https://developer.loggro.com/reference/consultaritemcontrol.md): Obtiene la lista de ítems asociados a un control específico dentro de la compañía indicada. Permite consultar detalles de cada ítem importado relacionado al control. - [Consultar Precios de Ítem por Proveedor](https://developer.loggro.com/reference/consultaritemsprove.md): Retorna la información de precios y condiciones de compra de un ítem por proveedor (in_itemsprove) para la compañía de la sesión activa. Si se envían **proveedor** y **establecimiento** retorna el registro específico; si se envía solo **proveedor** retorna sus establecimientos; si se omiten ambos retorna todos los proveedores registrados para el ítem (máx. 1 000 registros). - [Eliminar ítems asociados a un control](https://developer.loggro.com/reference/eliminarcontrol.md): Elimina un Registro del sistema a partir del control. - [Consultar Impuestos de Compra de Ítem](https://developer.loggro.com/reference/consultaritemimptocompra.md): Retorna, para el ítem indicado, su información básica, el concepto de compra asociado, la línea de impuesto de dicho concepto y las tarifas vigentes de IVA y retefuente. La compañía se obtiene automáticamente de la sesión del usuario autenticado. - [Consultar Lotes](https://developer.loggro.com/reference/consultarlote.md): Permite consultar la información completa de un lote a partir de su **código de lote**. Incluye la descripción del ítem asociado y la descripción del tipo de ítem. La compañía se obtiene automáticamente de la sesión del usuario autenticado. - [Crear Lotes](https://developer.loggro.com/reference/crearlotes.md): Permite registrar uno o varios lotes en el sistema. Cada petición puede contener múltiples lotes y cada registro será validado individualmente. La compañía se obtiene automáticamente de la sesión del usuario autenticado. - [Crear Pedido](https://developer.loggro.com/reference/crearpedido.md): Permite registrar uno o varios pedidos (comerciales o de consumo) en el sistema. Cada petición puede contener múltiples pedidos, y cada registro será validado individualmente. El servicio retorna el resultado de la importación con el detalle de las operaciones exitosas y fallidas. - [Consultar Pedido por Código](https://developer.loggro.com/reference/consultarpedido.md): Permite consultar la información de un pedido a partir de su **código único**. El servicio valida la sesión del usuario y retorna la información del pedido si existe. - [Consultar Pedido por Control](https://developer.loggro.com/reference/consultarpedidocontrol.md): Permite consultar la información de un pedido a partir del campo **control**. El servicio valida la sesión del usuario y retorna la información del pedido si existe. - [Crear requisición](https://developer.loggro.com/reference/crearrequisicion.md): Recibe uno o varios documentos de requisición para su importación al ERP. Se permite enviar **un único documento** o **varios en un array**. Si alguno falla, el sistema continúa con los demás e informa los errores individualmente. - [Consultar requisición](https://developer.loggro.com/reference/consultarrequisicion.md): Permite consultar una requisición de Inventarios a partir del tipo de consecutivo y su número, retornando la información del encabezado junto con su detalle. - [Crear orden de compra](https://developer.loggro.com/reference/crearordencompra.md): Recibe uno o varios documentos de orden de compra para su importación al ERP. Se permite enviar **un único documento** o **varios en un array**. Si alguno falla, el sistema continúa con los demás e informa los errores individualmente. - [Consultar orden de compra](https://developer.loggro.com/reference/consultarordencompra.md): Permite consultar una orden de compra de Inventarios a partir del tipo de consecutivo y su número, retornando la información del encabezado junto con su detalle. - [Crear Entrada de Inventario con Costo](https://developer.loggro.com/reference/crearentradacostoinventario.md): Permite registrar una o varias entradas de inventario con costo en el sistema. Cada petición puede contener múltiples entradas, y cada registro será validado individualmente. El servicio retorna el resultado de la importación con el detalle de las operaciones exitosas y fallidas. - [Crear Entrada de Inventario](https://developer.loggro.com/reference/crearentradainventario.md): Permite registrar una o varias entradas de inventario en el sistema. Cada petición puede contener múltiples entradas, y cada registro será validado individualmente. El servicio retorna el resultado de la importación con el detalle de las operaciones exitosas y fallidas. - [Despachos](https://developer.loggro.com/reference/despacho.md) - [Consultar despacho](https://developer.loggro.com/reference/consultardespacho.md): Permite consultar un despacho de Inventarios a partir del tipo de consecutivo y su número, retornando la información del encabezado junto con sus movimientos, localizaciones y series. - [Crear Despacho](https://developer.loggro.com/reference/creardespachoinventario.md): Permite registrar uno o varios despachos de inventario en el sistema. Cada petición puede contener múltiples despachos, y cada registro será validado individualmente. Cada detalle debe informar los campos de relación 'tipoConsRelacionado', 'consecutivoRelacionado' y 'lineaDocuRelacionado', obligatorios para despachos. El servicio retorna el resultado de la importación con el detalle de las operaciones exitosas y fallidas. - [Crear Salida de Inventario](https://developer.loggro.com/reference/crearsalidainventario.md): Permite registrar una o varias salidas de inventario en el sistema. Cada petición puede contener múltiples salidas, y cada registro será validado individualmente. El servicio retorna el resultado de la importación con el detalle de las operaciones exitosas y fallidas. - [Consultar Tipo(s) de Ítem](https://developer.loggro.com/reference/consultartipositemtodos.md): Retorna la información de un tipo de ítem cuando se indica su **código**, o la lista completa de tipos de ítem de la compañía cuando el código se omite. La compañía se obtiene automáticamente de la sesión del usuario autenticado. - [Consultar Tipo(s) de Ítem](https://developer.loggro.com/reference/consultartipositemcodigo.md): Retorna la información de un tipo de ítem cuando se indica su **código**, o la lista completa de tipos de ítem de la compañía cuando el código se omite. La compañía se obtiene automáticamente de la sesión del usuario autenticado. - [Consultar Roles de Usuario por Filtro](https://developer.loggro.com/reference/consultarrolesporfiltro.md): Retorna los roles de usuario registrados en la compañía de la sesión activa. Permite filtrar por tipo de rol (**R**=requisitor, **C**=comprador, **P**=planeador, **A**=administrador de órdenes de proceso) y/o por bodega asociada. Debe indicarse al menos uno de los parámetros: **rol** o **bodega**. - [Consultar Roles de Usuario por Código de Usuario](https://developer.loggro.com/reference/consultarrolesusuario.md): Retorna los roles del usuario indicado en la compañía de la sesión activa. Opcionalmente, permite afinar la búsqueda por tipo de rol (**R**=requisitor, **C**=comprador, **P**=planeador, **A**=administrador de órdenes de proceso) o por bodega asociada. Cuando se combinan, el tipo de rol tiene precedencia sobre la bodega como filtro secundario. - [Consultar Bodega(s)](https://developer.loggro.com/reference/consultarbodega.md): Retorna la información de una bodega cuando se indica su **código** mediante el parámetro de consulta, o la lista completa de bodegas de la compañía cuando el parámetro se omite (máx. 1 000 registros). La compañía se obtiene automáticamente de la sesión del usuario autenticado. - [Crear Entrada de Inventario por Orden de Compra](https://developer.loggro.com/reference/crearentradaoc.md): Permite registrar una entrada de inventario referenciando una orden de compra. El encabezado identifica el documento de entrada mediante tipoConsecutivo y consecutivo. Cada detalle debe referenciar la línea de la OC origen mediante tipoConsDocuOrigen, consecutivoDocuOrigen y lineaDocuOrigen. Se permite enviar **un único documento** o **varios en un array**. Si alguno falla, el sistema continúa con los demás e informa los errores individualmente. - [Consultar Actividad Económica](https://developer.loggro.com/reference/consultaractividadeconomica.md): Permite consultar la información básica de una actividad económica a partir de su **código**. También se valida la sesión del usuario mediante autenticación Bearer Token. - [Consultar Caja](https://developer.loggro.com/reference/consultarcaja.md): Permite consultar la información de una caja a partir de su **código**. También se valida la sesión del usuario mediante autenticación Bearer Token. - [Consultar Centros de Responsabilidad](https://developer.loggro.com/reference/consultarcentroresponsabilidad.md): Retorna la información de un centro de responsabilidad cuando se indica su **código** mediante el parámetro de consulta, o la lista completa de centros de responsabilidad de la compañía cuando el parámetro se omite (máx. 1 000 registros). La compañía se obtiene automáticamente de la sesión del usuario autenticado. **Ejemplo con código:** `GET /centroResponsabilidad?codigo=620` retorna únicamente el centro de responsabilidad 620. **Ejemplo sin código:** `GET /centroResponsabilidad` retorna todos los centros de responsabilidad registrados para la compañía del usuario autenticado. - [Consultar Ciudad](https://developer.loggro.com/reference/consultarciudad.md): Permite consultar la información de una ciudad a partir de su código. La búsqueda se realiza en la tabla de ciudades del ERP. - [Consultar Cuenta Bancaria](https://developer.loggro.com/reference/consultarcuentabancaria.md): Permite consultar la información de una cuenta bancaria a partir de su **código**. También se valida la sesión del usuario mediante autenticación Bearer Token. - [Consultar Departamento](https://developer.loggro.com/reference/consultardepartamento.md): Permite consultar la información de un departamento a partir de su código. La búsqueda se realiza en la tabla de departamentos del ERP. - [Consultar División(es)](https://developer.loggro.com/reference/consultardivision.md): Retorna la información de una división cuando se indica su **código** mediante el parámetro de consulta, o la lista completa de divisiones de la compañía cuando el parámetro se omite (máx. 1 000 registros). La compañía se obtiene automáticamente de la sesión del usuario autenticado. - [Consultar Niveles de División](https://developer.loggro.com/reference/consultarnivelesdivision.md): Retorna todos los niveles de división (un_division) registrados en la compañía de la sesión activa (máx. 1 000 registros). No recibe parámetros; la compañía se obtiene automáticamente del token del usuario autenticado. - [Consultar Formas de Pago](https://developer.loggro.com/reference/consultarformapago.md): Permite consultar la información básica de una forma de pago a partir de su **código**. También se valida la sesión del usuario mediante autenticación Bearer Token. - [Consultar Moneda(s)](https://developer.loggro.com/reference/consultarmoneda.md): Retorna la información de una moneda cuando se indica su **código** mediante el parámetro de consulta, o la lista completa de monedas de la compañía cuando el parámetro se omite (máx. 1 000 registros). La compañía se obtiene automáticamente de la sesión del usuario autenticado. **Ejemplo con código:** `GET /moneda?codigo=PESOC` retorna únicamente la moneda PESOC. **Ejemplo sin código:** `GET /moneda` retorna todas las monedas registradas para la compañía del usuario autenticado. - [Consultar Pais](https://developer.loggro.com/reference/consultarpaises.md): Permite consultar la información de un pais a partir de su código. La búsqueda se realiza en la tabla de paises del ERP. - [Consultar Tipo de Documento](https://developer.loggro.com/reference/consultartipodocumento.md): Consulta los tipos de documento de la compañía del usuario autenticado. Si se proporciona el código del tipo de documento, retorna únicamente ese registro (ejemplo: `GET /tipoDocumento?codigo=FAVE`). Si no se proporciona, retorna todos los tipos de documento de la compañía (ejemplo: `GET /tipoDocumento`). También se valida la sesión del usuario mediante autenticación Bearer Token. - [Consultar Transacción(es) de Tesorería](https://developer.loggro.com/reference/consultartransacciontesoreria.md): Consulta las transacciones de tesorería de la compañía del usuario autenticado. Si se proporciona el **código**, retorna únicamente esa transacción; si se omite, retorna todas las transacciones de tesorería de la compañía. También se valida la sesión del usuario mediante autenticación Bearer Token. - [Consultar Conceptos de Documento](https://developer.loggro.com/reference/consultarconceptodocumento.md): Retorna la información de un concepto de documento cuando se indica su **código** mediante el parámetro de consulta `conceptoDocumento`, o la lista completa de conceptos de documento de la compañía cuando el parámetro se omite (máx. 1 000 registros). La compañía se obtiene automáticamente de la sesión del usuario autenticado. - [Crear Ingreso](https://developer.loggro.com/reference/crearingresos.md): Servicio diseñado para recibir información destinada a la **creación de ingresos en el modulo de Tesoreria**. Se permite enviar **un único ingreso** o **varios en un array**. Si alguno de los documentos falla en la validación o en la importación, el sistema continuará procesando los demás y reportará los errores individualmente. - [Consultar documento CXP](https://developer.loggro.com/reference/consultardocumentocxp.md): Permite consultar un documento de Cuentas por Pagar (CXP) a partir del tipo de consecutivo y su número. - [Crear documento CXP](https://developer.loggro.com/reference/creardocumentocxp.md): El servicio está diseñado para recibir información destinada a la generación de documentos del proveedor, ya sea de manera individual o en lote. Se permite enviar **un único documento** o **varios en un array**. Si alguno de los documentos falla en la validación, el sistema continuará procesando los demás y reportará los errores individualmente en la respuesta. - [Consultar Tipos de Proveedor](https://developer.loggro.com/reference/consultartipoproveedor.md): Permite consultar la información básica de un tipo de proveedor a partir de su **código**. También se valida la sesión del usuario mediante autenticación Bearer Token. - [Crear aplicación CXP](https://developer.loggro.com/reference/crearaplicacion.md): El servicio recibe información destinada a la creación de aplicaciones de CxP, ya sea de manera individual o en lote. Se permite enviar **una única aplicación** o **varios en un array**. Si alguna de las aplicaciones falla la validación, el sistema continuará procesando los demás y reportará los errores individualmente en la respuesta. - [Crear documento CXC](https://developer.loggro.com/reference/creardocumentocxc.md): El servicio está diseñado para recibir información destinada a la generación de documentos de cuentas por cobrar (CXC), ya sea de manera individual o en lote. Se permite enviar **un único documento** o **varios en un array**. Si alguno de los documentos falla en la validación, el sistema continuará procesando los demás y reportará los errores individualmente en la respuesta. - [Consultar Tipos de Cliente](https://developer.loggro.com/reference/consultartipocliente.md): Consulta la parametrización contable asociada a un tipo de cliente. - [Consultar Estudio de Vacaciones](https://developer.loggro.com/reference/consultarestudiovacaciones.md): Calcula e informa los días pendientes de vacaciones de un empleado a la fecha de corte indicada. La compañía se obtiene automáticamente de la sesión del usuario autenticado. También se valida la sesión del usuario mediante autenticación Bearer Token. - [Crear Reporte de Labores](https://developer.loggro.com/reference/reportelabores.md): Permite registrar, para uno o varios empleados, una o varias novedades de reporte de labores (vacaciones, incapacidad, día libre/permiso, licencia o suspensión) en el sistema. Cada petición puede contener un único empleado o un arreglo de empleados, cada uno con su lista de novedades. Si una novedad presenta un error, no se guardará ninguna de las novedades asociadas al empleado. Sin embargo, el proceso continuará con el siguiente empleado. La compañía se obtiene automáticamente de la sesión del usuario autenticado. - [Obtener documentos electrónicos por rango de fecha](https://developer.loggro.com/reference/documentosexternosfe.md): Servicio que permite consultar facturas electrónicas, notas crédito y documentos asociados a una compañía en una fecha y hora específica. - [Introducción Nómina](https://developer.loggro.com/reference/introduccion-nomina.md): Servicios del módulo de nómina - [Autenticación](https://developer.loggro.com/reference/autenticacion-nomina.md) - [Actualizar una novedad.](https://developer.loggro.com/reference/actualizarnovedad.md): Actualizar una novedad para un empleado. - [Crear una novedad.](https://developer.loggro.com/reference/guardarnovedad.md): Crear una nueva novedad para un empleado. - [Crear una novedad de libranza.](https://developer.loggro.com/reference/guardarlibranzaexterna.md): Crea una nueva novedad de libranza para un empleado. Una libranza es un descuento que se realiza directamente de la nómina del empleado para pagar una deuda o compromiso financiero. El endpoint requiere un payload JSON con los datos necesarios para registrar la libranza. - [Consultar una novedad.](https://developer.loggro.com/reference/getnovedad.md): Consultar una novedad. Las novedades son eventos que afectan el salario o las deducciones de un empleado. Por ejemplo, una novedad puede ser una incapacidad, un permiso o una licencia. - [Eliminar una novedad.](https://developer.loggro.com/reference/deletenovedad.md): Eliminar una novedad para un empleado. Si la novedad ya ha sido pagada, se inactiva la novedad, de lo contrario se elimina de la nómina. - [Consultar las novedades de un empleado que aplican en un rango de fechas de un periodo.](https://developer.loggro.com/reference/getnovedadesempleado.md): Consultar las novedades de un empleado que aplican en un rango de fechas de un periodo. - [Calcular días hábiles](https://developer.loggro.com/reference/getdiashabiles.md): Calcular el número de días hábiles en un periodo. - [Prórrogas de novedades](https://developer.loggro.com/reference/getprorrogasnovedades.md): Listar las prórrogas registradas para novedades. - [Días totales con prórroga](https://developer.loggro.com/reference/getdiastotalesnovedadconprorroga.md): Calcular los días totales de una novedad incluyendo prórrogas. - [Diagnosticos de novedades](https://developer.loggro.com/reference/getdiagnosticosnovedades.md): Consultar los diagnosticos disponibles para novedades. - [Novedades de empleado por estado](https://developer.loggro.com/reference/getnovedadesempleadoporestado.md): Consultar las novedades de un empleado filtradas por estado. - [Novedad específica de empleado](https://developer.loggro.com/reference/getnovedadempleado.md): Consultar el detalle de una novedad específica de un empleado. - [Actualizar novedad de empleado](https://developer.loggro.com/reference/actualizarnovedadempleado.md): Actualizar los datos de una novedad de un empleado. - [Novedades pendientes de pago](https://developer.loggro.com/reference/getnovedadespendientesdepago.md): Consultar las novedades activas que no han sido pagadas. - [Consultar información de un empleado con vinculación vigente.](https://developer.loggro.com/reference/getconsultaexternaempleado.md): Consultar información de un empleado con vinculación vigente en la nómina. La búsqueda se hace mediante un tipo de documento y un número de identificación en los parámetros de entrada del servicio. - [Consultar la lista de vinculados vigentes para el próximo pago de nómina](https://developer.loggro.com/reference/getvinculadosvigentes.md): Consultar la lista de empleados vinculados. - [Vinculados a término fijo](https://developer.loggro.com/reference/getvinculadosterminofijo.md): Listar todos los empleados vinculados a término fijo. - [Desvinculados](https://developer.loggro.com/reference/getdesvinculados.md): Listar empleados con contratos finalizados. - [Vinculados en proceso](https://developer.loggro.com/reference/getvinculadosenproceso.md): Listar empleados con vinculación en proceso. - [Detalle de vinculado](https://developer.loggro.com/reference/getvinculadoporid.md): Consultar el detalle de un vinculado por su ID. - [Actualizar vinculado](https://developer.loggro.com/reference/actualizarvinculado.md): Actualizar la información contractual de un vinculado. - [Registrar cambio de salario](https://developer.loggro.com/reference/registrarcambiosalario.md): Registrar un cambio de salario para un vinculado. - [Eliminar salario de un vinculado](https://developer.loggro.com/reference/eliminareventovinculado.md): Elimina un cambio de salario del historial de un vinculado. No es posible eliminar si es el único salario registrado o si ya fue incluido en un pago definitivo. - [Vinculados con cuenta para desembolso](https://developer.loggro.com/reference/getvinculadosconcuentaparadesembolso.md): Listar empleados que tienen cuenta bancaria para desembolso. - [Tipos de contrato](https://developer.loggro.com/reference/gettiposcontrato.md): Consultar el catálogo de tipos de contrato disponibles. - [Tipos de cotizante](https://developer.loggro.com/reference/gettiposcotizante.md): Consultar el catálogo de tipos de cotizante. - [Clases de riesgo ARL](https://developer.loggro.com/reference/getclaseriesgos.md): Consultar las clases de riesgo disponibles para ARL. - [Centros de trabajo](https://developer.loggro.com/reference/getcentrodetrabajovinculado.md): Consultar los centros de trabajo disponibles. - [Catálogo de cargos](https://developer.loggro.com/reference/getcargos.md): Consultar el catálogo de cargos disponibles. - [Catálogo de dependencias](https://developer.loggro.com/reference/getdependencias.md): Consultar el catálogo de dependencias de la empresa. - [Centros de costo](https://developer.loggro.com/reference/getcentrosvinculado.md): Consultar los centros de costo disponibles. - [Areas disponibles](https://developer.loggro.com/reference/getareasvinculado.md): Consultar las areas disponibles en la organización. - [Procedimientos de retencion](https://developer.loggro.com/reference/getprocedimientosretencion.md): Consultar los procedimientos de retencion en la fuente. - [Salarios minimos vigentes](https://developer.loggro.com/reference/getsalariosminimos.md): Consultar los salarios minimos legales vigentes. - [Vinculado por empleado](https://developer.loggro.com/reference/getvinculadoporempleado.md): Consultar el vinculado asociado a un empleado por UUID. - [Verificar empleado activo](https://developer.loggro.com/reference/getempleadoactivo.md): Verificar si un empleado tiene una vinculación activa. - [Total de días de vacaciones](https://developer.loggro.com/reference/gettotalvacaciones.md): Consultar el total de días de vacaciones de un vinculado. - [Contratos de empleado](https://developer.loggro.com/reference/getcontratosempleado.md): Consultar el historial de contratos de un empleado. - [Historial de salarios](https://developer.loggro.com/reference/getsalariosempleado.md): Consultar el historial de salarios de un empleado. - [Estudio de liquidación de vacaciones](https://developer.loggro.com/reference/getestudiovacaciones.md): Calcular el estudio de liquidación de vacaciones. - [Historial de vacaciones](https://developer.loggro.com/reference/gethistorialvacacionesvinculado.md): Consultar el historial de vacaciones de un vinculado. - [Historial de ausentismos](https://developer.loggro.com/reference/gethistorialausentismosvinculado.md): Consultar el historial de ausentismos de un vinculado. - [Prórrogas de contratos](https://developer.loggro.com/reference/getprorrogasvinculados.md): Listar las prórrogas de contratos registradas. - [Último pago de nómina](https://developer.loggro.com/reference/getultimopagonomina.md): Consultar el último pago de nómina realizado. - [Último día pagado](https://developer.loggro.com/reference/getultimodiapagado.md): Consultar el último día pagado a un empleado. - [Finalizar contratos masivamente](https://developer.loggro.com/reference/finalizarcontratosmasivamente.md): Finalizar de forma masiva los contratos seleccionados. - [Prorrogar contratos masivamente](https://developer.loggro.com/reference/prorrogarcontratosmasivamente.md): Prorrogar de forma masiva contratos a término fijo. - [Actualizar salario mínimo masivamente](https://developer.loggro.com/reference/actualizarsalariominimomasivamente.md): Actualizar masivamente los salarios según el salario mínimo del año. - [Asignar cuenta para desembolso](https://developer.loggro.com/reference/asignarcuentaparadesembolso.md): Asignar una cuenta bancaria para el desembolso de nómina. - [Asociar empleados a grupo de distribución](https://developer.loggro.com/reference/asociarempleadosagrupo.md): Asociar empleados a un grupo de distribución de costos. - [Asociar empleados a grupo de pago](https://developer.loggro.com/reference/asociarempleadosgrupopago.md): Asociar empleados a un grupo de pago. - [Asociar empleados a grupo contabilización](https://developer.loggro.com/reference/asociarempleadosgrupocontabilizacion.md): Asociar empleados a un grupo de contabilización. - [Listar empleados](https://developer.loggro.com/reference/getempleados.md): Consultar la lista de todos los empleados registrados. - [Crear empleado](https://developer.loggro.com/reference/crearempleado.md): Registrar un nuevo empleado en el sistema. - [Detalle de empleado](https://developer.loggro.com/reference/getempleadoporuuid.md): Consultar el detalle de un empleado por su UUID. - [Actualizar empleado](https://developer.loggro.com/reference/actualizarempleado.md): Actualizar los datos de un empleado. - [Eliminar empleado](https://developer.loggro.com/reference/eliminarempleado.md): Elimina un empleado. No es posible eliminar si tiene pagos sin anular o transmisiones activas a nómina electrónica. - [Empleado por documento](https://developer.loggro.com/reference/getempleadopordocumento.md): Consultar un empleado por tipo y número de documento. - [Información laboral](https://developer.loggro.com/reference/getinformacionlaboral.md): Consultar la información laboral de un empleado. - [Actualizar información laboral](https://developer.loggro.com/reference/actualizarinformacionlaboral.md): Actualizar la información laboral de un empleado. - [Información salarial](https://developer.loggro.com/reference/getinformacionsalarial.md): Consultar la información salarial de un empleado. - [Actualizar información salarial](https://developer.loggro.com/reference/actualizarinformacionsalarial.md): Actualizar la información salarial de un empleado. - [Vigencias de alivios salariales](https://developer.loggro.com/reference/getvigenciasaliviossalariales.md): Consultar las vigencias de alivios salariales del empleado. - [Crear vigencia de alivio salarial](https://developer.loggro.com/reference/crearvigenciaaliviosalarial.md): Registrar una nueva vigencia de alivio salarial. - [Actualizar vigencia de alivio salarial](https://developer.loggro.com/reference/actualizarvigenciaaliviosalarial.md): Actualizar una vigencia de alivio salarial existente. - [Vigencia actual de alivio salarial](https://developer.loggro.com/reference/getvigenciaactualaliviosalarial.md): Consultar la vigencia actual de un alivio salarial específico. - [Información adicional del empleado](https://developer.loggro.com/reference/getinformacionadicionalempleado.md): Consultar la información adicional registrada para el empleado. - [Actualizar información adicional](https://developer.loggro.com/reference/actualizarinformacionadicional.md): Actualizar la información adicional del empleado. - [Último salario del empleado](https://developer.loggro.com/reference/getinformacionultimosalario.md): Consultar la información del último salario del empleado. - [Tipos de parientes](https://developer.loggro.com/reference/gettiposparientes.md): Consultar el catálogo de tipos de parientes disponibles. - [Revincular empleado](https://developer.loggro.com/reference/revincularempleado.md): Crear una nueva vinculación para un empleado. - [Reactivar última vinculación](https://developer.loggro.com/reference/reactivarultimavinculacion.md): Reactivar la última vinculación contractual de un empleado. - [Eliminar vigencia de alivio salarial](https://developer.loggro.com/reference/eliminarvigenciaaliviosalarial.md): Eliminar una vigencia de alivio salarial de un vinculado. - [Vigencias de entidad SS](https://developer.loggro.com/reference/getvigenciasentidadss.md): Listar las vigencias de una entidad de seguridad social del empleado. - [Vigencia actual de entidad SS](https://developer.loggro.com/reference/getvigenciaactualentidadss.md): Consultar la vigencia actual de una entidad de seguridad social. - [Crear vigencia de entidad SS](https://developer.loggro.com/reference/crearvigenciaentidadss.md): Registrar una nueva vigencia de entidad de seguridad social. - [Actualizar vigencia de seguridad social](https://developer.loggro.com/reference/actualizarvigenciaentidadss.md): Actualizar una vigencia de una entidad de seguridad social. - [Eliminar vigencia de seguridad social](https://developer.loggro.com/reference/eliminarvigenciaentidadss.md): Eliminar una vigencia de una entidad de seguridad social. - [Pagos de Nómina](https://developer.loggro.com/reference/pagos.md): Consulta y gestión de pagos de nómina. - [Listar todos los pagos de nómina.](https://developer.loggro.com/reference/get-pagos.md): Consultar la lista de pagos de nómina registrados. - [Detalle de un pago por ID](https://developer.loggro.com/reference/getpagoporid.md): Consultar el detalle de un pago de nómina específico. - [Actualizar pago de nómina](https://developer.loggro.com/reference/actualizarpago.md): Actualizar los datos de un pago de nómina. - [Comprobantes anulados de un pago](https://developer.loggro.com/reference/getcomprobantesanulados.md): Consultar los comprobantes anulados de un pago. - [Consultar comprobantes pendientes](https://developer.loggro.com/reference/getcomprobantespendientes.md): Consultar los comprobantes pendientes de contabilización de un pago. - [Anular pago de nómina](https://developer.loggro.com/reference/anularpago.md): Anular un pago de nómina indicando la razón de la anulación. - [Calcular nómina periódica](https://developer.loggro.com/reference/calcularnominaperiodica.md): Generar el calculo de la nómina periódica. - [Calcular pagos especiales](https://developer.loggro.com/reference/getpagosespeciales.md): Generar el calculo de pagos especiales. - [Calcular prima de servicios](https://developer.loggro.com/reference/calcularprima.md): Generar el calculo de prima de servicios. - [Calcular intereses de cesantías](https://developer.loggro.com/reference/calcularinteresescesantias.md): Generar el calculo de intereses de cesantías. - [Calcular cesantías](https://developer.loggro.com/reference/calcularcesantias.md): Generar el calculo de cesantías. - [Adelantar pago de nómina](https://developer.loggro.com/reference/adelantarpagonomina.md): Generar un adelanto del pago de nómina. - [Calcular liquidación definitiva](https://developer.loggro.com/reference/calcularliquidaciondefinitiva.md): Generar el calculo de la liquidación definitiva. - [Enviar comprobantes de pago](https://developer.loggro.com/reference/enviarcomprobantespagonomina.md): Enviar comprobantes de pago por correo electrónico. - [Próximo periodo de pago](https://developer.loggro.com/reference/getproximoperiodopago.md): Consultar el próximo periodo de pago configurado. - [Estado nómina electrónica del periodo](https://developer.loggro.com/reference/getnominaelectronicaperiodo.md): Genera los comprobantes de nómina electrónica individual pendientes de un periodo (no es una consulta pura). - [Cuentas bancarias para pago](https://developer.loggro.com/reference/getlistacuentasbancarias.md): Consultar las cuentas bancarias disponibles para pago. - [Agregar cuenta a pago multicuenta](https://developer.loggro.com/reference/agregarcuentapagomulticuenta.md): Agregar una cuenta bancaria a un pago multicuenta. - [Actualizar cuenta en pago multicuenta](https://developer.loggro.com/reference/actualizarcuentapagomulticuenta.md): Actualizar los datos de una cuenta en un pago multicuenta. - [Actualizar fecha en pago multicuenta](https://developer.loggro.com/reference/actualizarfechapagomulticuenta.md): Actualizar la fecha de pago en un pago multicuenta. - [Detalles de pago multicuenta](https://developer.loggro.com/reference/getpagodetallesmulticuenta.md): Consultar los detalles de un pago multicuenta. - [Detalle por cuenta asociada](https://developer.loggro.com/reference/getpagodetallescuentaasociada.md): Regenera y consulta el detalle de pago agrupado por cuenta bancaria asociada de cada empleado (no es una consulta pura). - [Cuentas bancarias asociadas al pago](https://developer.loggro.com/reference/getcuentasasociadaspago.md): Retorna las cuentas bancarias asociadas a un pago multi-cuenta. - [Bancos sin plano disponible](https://developer.loggro.com/reference/getbancossinplano.md): Consultar los bancos que no tienen plano disponible. - [Eliminar cuenta en pago multi-cuenta](https://developer.loggro.com/reference/eliminarcuentapagomulticuenta.md): Elimina una cuenta bancaria asociada a un pago multi-cuenta. No es posible eliminar si el pago ya está en estado definitivo (Por Pagar, Pagada o Anulada). - [Listar comprobantes de pago](https://developer.loggro.com/reference/getpagoempleados.md): Consultar la lista de comprobantes de pago de empleados. - [Recalcular comprobante de pago de empleado](https://developer.loggro.com/reference/actualizarpagoempleado.md): Recalcula el comprobante de pago de un empleado para el período activo. - [Información adicional de comprobantes](https://developer.loggro.com/reference/getinformacionadicionalcomprobantes.md): Consultar información adicional de los comprobantes. - [Información adicional de un comprobante](https://developer.loggro.com/reference/getinformacionadicionalcomprobante.md): Consultar información adicional de un comprobante específico. - [Comprobante de pago de empleado](https://developer.loggro.com/reference/getcomprobanteempleado.md): Consultar el comprobante de pago de un empleado. - [Enviar comprobante al empleado](https://developer.loggro.com/reference/enviarcomprobantepagonominaempleado.md): Enviar el comprobante de pago por correo al empleado. - [Historial de pagos de empleado](https://developer.loggro.com/reference/gethistorialpagosempleado.md): Consultar el historial completo de pagos de un empleado. - [Ultimos comprobantes de empleado](https://developer.loggro.com/reference/getultimoscomprobantesempleado.md): Consultar los ultimos comprobantes de pago de un empleado. - [Razones de anulación](https://developer.loggro.com/reference/getrazonesanulacion.md): Consultar las razones de anulación usadas anteriormente (no es un catálogo fijo). - [Anular comprobante de pago](https://developer.loggro.com/reference/anularcomprobantepago.md): Anular el comprobante de pago de un empleado. - [Pago de novedad específica](https://developer.loggro.com/reference/getpagonovedad.md): Consultar el pago correspondiente a una novedad específica. - [Detalle de comprobante por empleado](https://developer.loggro.com/reference/getdetallepagoempleado.md): Consultar el detalle de un comprobante de pago por empleado. - [Detalle de un pago específico](https://developer.loggro.com/reference/getdetallespago.md): Consultar el detalle de los conceptos de un pago. - [Conceptos acumulados](https://developer.loggro.com/reference/getconceptosacumulados.md): Consultar los conceptos acumulados en un rango de fechas. - [Explorador de acumulados por concepto](https://developer.loggro.com/reference/getexploradoracumuladosporconcepto.md): Consultar el detalle completo de conceptos acumulados por empleado en un rango de fechas. - [Detalle de pagos por concepto](https://developer.loggro.com/reference/getdetallepagoporconcepto.md): Consultar el detalle completo de conceptos pagados por empleado en un pago específico. - [Listar anticipos de cesantías](https://developer.loggro.com/reference/getanticiposcesantias.md): Consultar la lista de anticipos de cesantías registrados. - [Calcular valores del anticipo](https://developer.loggro.com/reference/calcularvaloresanticipo.md): Calcular los valores disponibles para un anticipo de cesantías. - [Generar pago de anticipo](https://developer.loggro.com/reference/generarpagoanticipo.md): Generar el pago de todos los anticipos de cesantías pendientes. - [Crear anticipo de cesantías](https://developer.loggro.com/reference/agregaranticipocesantias.md): Registrar un nuevo anticipo de cesantías. - [Actualizar anticipo de cesantías](https://developer.loggro.com/reference/actualizaranticipocesantias.md): Actualiza un anticipo de cesantías existente. No es posible actualizar un anticipo ya pagado. - [Eliminar anticipo de cesantías](https://developer.loggro.com/reference/eliminaranticipocesantias.md): Elimina un anticipo de cesantías existente. No es posible eliminar un anticipo ya pagado. - [Eliminar pago de nómina](https://developer.loggro.com/reference/eliminarpagonomina.md): Eliminar un pago de nómina que no esté en estado definitivo. El UUID del pago se obtiene desde el endpoint de listar pagos. - [Listar grupos de pago](https://developer.loggro.com/reference/getgrupospagos.md): Consultar la lista de grupos de pago configurados. - [Crear grupo de pago](https://developer.loggro.com/reference/creargrupopago.md): Crear un nuevo grupo de pago. - [Actualizar grupo de pago](https://developer.loggro.com/reference/actualizargrupopago.md): Actualizar los datos de un grupo de pago. - [Eliminar grupo de pago confirmado](https://developer.loggro.com/reference/eliminargrupopagaconfirmado.md): Elimina un grupo de pago de forma forzada, desasociando automáticamente a sus empleados si los tiene. - [Detalle de grupo de pago](https://developer.loggro.com/reference/getgrupopago.md): Consultar el detalle de un grupo de pago específico. - [Lista simplificada de grupos](https://developer.loggro.com/reference/getlistagrupospagos.md): Consultar la lista simplificada de grupos de pago. - [Empleados de grupo de pago](https://developer.loggro.com/reference/getempleadosgrupopago.md): Consultar los empleados asignados a un grupo de pago. - [Consultar observaciones de pago](https://developer.loggro.com/reference/getobservaciones.md): Consultar la observación global vigente actualmente (no es por pago específico). - [Actualizar observaciones de pago](https://developer.loggro.com/reference/actualizarobservaciones.md): Actualizar el texto de la observación global vigente (con versionado automático). - [Listar pagos de aportes](https://developer.loggro.com/reference/getpagoaportes.md): Consultar la lista de pagos de aportes registrados. - [Detalle de pago de aportes](https://developer.loggro.com/reference/getpagoaporteporid.md): Consultar el detalle de un pago de aportes específico. - [Acumulados del periodo](https://developer.loggro.com/reference/getacumuladosperiodo.md): Consultar los acumulados de aportes de un periodo. - [Periodos disponibles de aportes](https://developer.loggro.com/reference/getaniosmesesdisponiblesaportes.md): Consultar los periodos disponibles para consulta de acumulados. - [Actualizar pago de aportes](https://developer.loggro.com/reference/actualizarpagoaportes.md): Actualizar la información y el estado de un pago de aportes. - [Listar transmisiones](https://developer.loggro.com/reference/getnominaelectronica.md): Consultar la lista de transmisiones de nómina electrónica. - [Detalle de transmision](https://developer.loggro.com/reference/getnominaelectronicaporuuid.md): Consultar el detalle de una transmision de nómina electrónica. - [Detalles de transmision](https://developer.loggro.com/reference/getdetallesnominaelectronica.md): Consultar los detalles de una transmision de nómina electrónica. - [Listar detalles de transmision](https://developer.loggro.com/reference/getnominaelectronicadetalle.md): Consultar la lista de detalles de transmisiones. - [Consultar estado de detalle](https://developer.loggro.com/reference/consultarestadonominaelectronica.md): Consultar el estado actual de un detalle de transmision. - [Errores del detalle](https://developer.loggro.com/reference/geterroresnominaelectronica.md): Consultar los errores de un detalle de transmision. - [Historial del detalle](https://developer.loggro.com/reference/gethistorialnominaelectronica.md): Consultar el historial de eventos de un detalle de transmision. - [Ver documentos del detalle](https://developer.loggro.com/reference/getdocumentosnominaelectronica.md): Consultar los documentos asociados a un detalle de transmision. - [Empleados de grupo de distribución](https://developer.loggro.com/reference/getempleadosgrupocontabilizacion.md): Consultar empleados asignados a un grupo de distribución. - [Clasificaciones contables](https://developer.loggro.com/reference/getclasificacionescontables.md): Consultar clasificaciones contables por pestana. - [Actualizar clasificaciones contables](https://developer.loggro.com/reference/actualizarclasificacionescontables.md): Actualizar las cuentas asociadas a las clasificaciones contables. - [Actualizar clasificación contable](https://developer.loggro.com/reference/actualizarclasificacioncontable.md): Actualizar la cuenta contable asociada a una clasificación contable específica dentro de un grupo de contabilización. - [Subir definición contable](https://developer.loggro.com/reference/subirdefinicioncontable.md): Mover una definición contable una posición hacia arriba en su orden. - [Bajar definición contable](https://developer.loggro.com/reference/bajardefinicioncontable.md): Mover una definición contable una posición hacia abajo en su orden. - [Detalles de partida contable](https://developer.loggro.com/reference/getdetallespartida.md): Consultar detalles de partida por pestana contable. - [Definiciones contables](https://developer.loggro.com/reference/getdefinicionescontables.md): Consultar las definiciones contables configuradas. - [Listar grupos de contabilización](https://developer.loggro.com/reference/getgruposcontabilizacion.md): Consultar la lista de grupos de contabilización. - [Crear grupo de contabilización](https://developer.loggro.com/reference/creargrupocontabilizacion.md): Crear un grupo de contabilización para asociar empleados. - [Eliminar grupo de contabilización](https://developer.loggro.com/reference/eliminargrupocontabilizacion.md): Elimina un grupo de contabilización que no esté en uso. - [Eliminar grupo de contabilización confirmado](https://developer.loggro.com/reference/eliminargrupocontabilizacionconfirmado.md): Elimina un grupo de contabilización que ya fue confirmado. - [Detalle de grupo de contabilización](https://developer.loggro.com/reference/getgrupocontabilizacion.md): Consultar el detalle de un grupo de contabilización. - [Lista de grupos de contabilización](https://developer.loggro.com/reference/getlistagruposcontabilizacion.md): Consultar la lista simplificada de grupos de contabilización. - [Empleados de grupo contabilización](https://developer.loggro.com/reference/getempleadosgrupoelementoscontabilidad.md): Consultar empleados de un grupo de elementos contables. - [Grupos de distribución por centro](https://developer.loggro.com/reference/getgruposdistribucioncentro.md): Listar grupos de distribución por centro de costo. - [Crear grupo de distribución](https://developer.loggro.com/reference/creargrupodistribucioncentro.md): Crear un nuevo grupo de distribución por centro. - [Eliminar grupo de distribución por centro](https://developer.loggro.com/reference/eliminargrupodistribucioncentro.md): Elimina un grupo de distribución por centro de trabajo. No es posible eliminar si el grupo tiene empleados asociados. - [Detalle de grupo de distribución](https://developer.loggro.com/reference/getgrupodistribucioncentro.md): Consultar el detalle de un grupo de distribución. - [Eliminar grupo de distribución por uuid](https://developer.loggro.com/reference/eliminargrupodistribucioncentroporuuid.md): Elimina un grupo de distribución por centro de trabajo indicando su uuid en la ruta. No es posible eliminar si el grupo tiene empleados asociados. - [Reglas de distribución](https://developer.loggro.com/reference/getreglasdistribucion.md): Consultar las reglas de distribución de un grupo. - [Crear regla de distribución](https://developer.loggro.com/reference/crearregladistribucion.md): Crear una nueva regla de distribución de costos. - [Eliminar regla de distribución](https://developer.loggro.com/reference/eliminarregladistribucion.md): Elimina una regla de distribución por centro de trabajo. - [Elementos de pasivo laboral](https://developer.loggro.com/reference/getelementospasivolaboral.md): Consultar los elementos de pasivo laboral configurados. - [Guardar elemento de pasivo laboral](https://developer.loggro.com/reference/guardarelementopasivolaboral.md): Crear o actualizar un elemento de pasivo laboral. - [Datos de la organización](https://developer.loggro.com/reference/getorganizacion.md): Consultar los datos generales de la organización. - [Actualizar consecutivos de nómina electrónica](https://developer.loggro.com/reference/actualizarconsecutivos.md): Actualiza los consecutivos de transmisión de nómina electrónica (soporte, eliminación y ajuste). No es posible actualizar si existen documentos en proceso de validación con la DIAN. - [Listar contactos](https://developer.loggro.com/reference/getcontactos.md): Consultar la lista de contactos registrados. - [Crear contacto](https://developer.loggro.com/reference/crearcontacto.md): Registrar un nuevo contacto en el sistema. - [Lista de EPS](https://developer.loggro.com/reference/geteps.md): Consultar las Entidades Promotoras de Salud disponibles. - [Lista de ARL](https://developer.loggro.com/reference/getarl.md): Consultar las Administradoras de Riesgos Laborales disponibles. - [Cajas de compensacion](https://developer.loggro.com/reference/getcajascompensacion.md): Consultar las cajas de compensacion familiar disponibles. - [Fondos de pension](https://developer.loggro.com/reference/getfondospension.md): Consultar los fondos de pension AFP disponibles. - [Fondos de cesantías](https://developer.loggro.com/reference/getfondoscesantias.md): Consultar los fondos de cesantías disponibles. - [Operadores de seguridad social](https://developer.loggro.com/reference/getoperadores.md): Consultar los operadores de seguridad social disponibles. - [Contactos por tipo](https://developer.loggro.com/reference/getcontactosportipo.md): Consultar contactos filtrados por tipo. - [Tipos de contacto](https://developer.loggro.com/reference/gettiposcontactos.md): Consultar el catálogo de tipos de contacto. - [Detalle de contacto](https://developer.loggro.com/reference/getcontactoporuuid.md): Consultar el detalle de un contacto por su UUID. - [Contacto por documento](https://developer.loggro.com/reference/getcontactopordocumento.md): Consultar un contacto por tipo y número de documento. - [Contactos por número de documento](https://developer.loggro.com/reference/getcontactospordocumento.md): Consultar contactos que coincidan con un número de documento. - [Listar cuentas bancarias](https://developer.loggro.com/reference/getcuentasbancarias.md): Consultar las cuentas bancarias configuradas. - [Catálogo de bancos](https://developer.loggro.com/reference/getbancos.md): Consultar el catálogo de bancos disponibles en el sistema. - [Ciudades](https://developer.loggro.com/reference/getciudades.md): Consultar ciudades con código departamento y código postal. - [Tipos de documento](https://developer.loggro.com/reference/gettiposdocumentos.md): Consultar todos los tipos de documento disponibles. - [Catálogo de géneros](https://developer.loggro.com/reference/getgeneros.md): Consultar el catálogo de géneros disponibles. - [Sectores economicos](https://developer.loggro.com/reference/getsectoreseconomicos.md): Consultar los sectores economicos disponibles. - [Actividades economicas](https://developer.loggro.com/reference/getactividadeseconomicas.md): Consultar las actividades economicas disponibles. - [Listar areas activas](https://developer.loggro.com/reference/getareas.md): Consultar la lista de areas activas de la organización. - [Crear area](https://developer.loggro.com/reference/creararea.md): Crear una nueva area en la organización. - [Actualizar área](https://developer.loggro.com/reference/actualizararea.md): Actualizar la información de un área organizacional. No aplica a áreas sembradas por el sistema. - [Eliminar área](https://developer.loggro.com/reference/eliminararea.md): Eliminar un área organizacional. No aplica a áreas sembradas por el sistema. - [Todas las areas](https://developer.loggro.com/reference/getallareas.md): Consultar todas las areas incluyendo las inactivas. - [Conceptos de novedades](https://developer.loggro.com/reference/getconceptosnovedad.md): Consultar los conceptos de novedades disponibles. - [Tipos de conceptos](https://developer.loggro.com/reference/gettiposconceptos.md): Consultar los tipos de conceptos de nómina. - [Listar conceptos de nómina](https://developer.loggro.com/reference/getconceptos.md): Consultar la lista de conceptos de nómina configurados. - [Crear concepto de nómina](https://developer.loggro.com/reference/crearconcepto.md): Crear un nuevo concepto de nómina. - [Actualizar concepto de nómina](https://developer.loggro.com/reference/actualizarconcepto.md): Actualizar la información de un concepto de nómina. No aplica a conceptos base del sistema. - [Eliminar concepto de nómina](https://developer.loggro.com/reference/eliminarconcepto.md): Eliminar un concepto de nómina. No aplica a conceptos base del sistema. - [Listar centros de costo activos](https://developer.loggro.com/reference/getcentros.md): Consultar la lista de centros de costo activos. - [Crear centro de costo](https://developer.loggro.com/reference/crearcentro.md): Crear un nuevo centro de costo. - [Actualizar centro de costo](https://developer.loggro.com/reference/actualizarcentro.md): Actualizar la información de un centro de costo. - [Eliminar centro de costo](https://developer.loggro.com/reference/eliminarcentro.md): Eliminar un centro de costo que no se encuentre en uso. - [Lista simplificada de centros](https://developer.loggro.com/reference/getlistacentros.md): Consultar la lista simplificada de centros de costo. - [Listar centros de trabajo](https://developer.loggro.com/reference/getcentrosdetrabajo.md): Consultar la lista de centros de trabajo configurados. - [Crear centro de trabajo](https://developer.loggro.com/reference/crearcentrodetrabajo.md): Crea un centro de trabajo para la organización. No es posible crear si ya existe otro centro con el mismo nombre o con el mismo código. - [Actualizar centro de trabajo](https://developer.loggro.com/reference/actualizarcentrodetrabajo.md): Actualiza la información de un centro de trabajo existente. No es posible modificar el código del centro de trabajo. No es posible actualizar si el nuevo nombre ya está en uso por otro centro de trabajo. - [Eliminar centro de trabajo](https://developer.loggro.com/reference/eliminarcentrodetrabajo.md): Eliminar un centro de trabajo que no se encuentre en uso. - [Motivos de terminación de contratos](https://developer.loggro.com/reference/getmotivosfinalizacioncontrato.md): Consultar el catálogo de motivos de terminación de contratos. - [Consultar el histórico de vacaciones](https://developer.loggro.com/reference/gethistoricovacaciones.md): Consultar el histórico de vacaciones de los empleados en un rango de fechas especificado. - [Consultar el histórico de salarios](https://developer.loggro.com/reference/gethistoricosalarios.md): Consultar el histórico de salarios de los empleados en un rango de fechas especificado. - [Consultar el histórico de incapacidades](https://developer.loggro.com/reference/gethistoricoincapacidades.md): Consultar el histórico de incapacidades de los empleados en un rango de fechas especificado. - [Consultar el histórico de entidades de seguridad social](https://developer.loggro.com/reference/gethistoricoentidadesseguridadsocial.md): Consultar el histórico de entidades de seguridad social de los empleados. - [Consultar el histórico de ausentismos](https://developer.loggro.com/reference/gethistoricoausentismos.md): Consultar el histórico de ausentismos de los empleados en un rango de fechas especificado. - [Obtiene el histórico de anticipos de cesantías](https://developer.loggro.com/reference/gethistoricoanticiposcesantias.md): Devuelve el histórico anticipos de cesantías de los empleados en un rango de fechas especificado. - [Consultar el histórico de alivios tributarios](https://developer.loggro.com/reference/gethistoricoaliviostributarios.md): Consultar el histórico de alivios tributarios de los empleados. - [Consultar el detalle base de vacaciones disfrutadas salario variable](https://developer.loggro.com/reference/getdetallebasevacacionesdisfrutadassalariovariable.md): Consultar el detalle base de vacaciones disfrutadas salario variable para una fecha fin de acumulados. - [Consultar el detalle base de vacaciones disfrutadas salario fijo](https://developer.loggro.com/reference/getdetallebasevacacionesdisfrutadassalariofijo.md): Consultar el detalle base de vacaciones disfrutadas salario fijo para una fecha fin de acumulados. - [Consultar el detalle base de prima salario fijo mes a mes](https://developer.loggro.com/reference/getdetallebaseprimamesames.md): Consultar el detalle base de prima salario fijo mes a mes para una fecha fin de acumulados. - [Consultar los acumulados para el calculo de la prima de servicios](https://developer.loggro.com/reference/getdetallebaseprima.md): Consultar los valores tenidos en cuenta para el cálculo de la prima de servicios. - [Consultar los acumulados para el calculo de Indemnizacion](https://developer.loggro.com/reference/getdetallebaseindemnizacion.md): Consultar los valores tenidos en cuenta para el cálculo de Indemnizacion. - [Consultar el detalle base de cesantías salario variable mes a mes](https://developer.loggro.com/reference/getdetallebasecesantiassalariovariablemesames.md): Consultar el detalle base de cesantías salario variable mes a mes para una fecha fin de acumulados. - [Consultar el detalle base de cesantías salario fijo mes a mes](https://developer.loggro.com/reference/getdetallebasecesantiassalariofijomesames.md): Consultar el detalle base de cesantías salario fijo mes a mes para una fecha fin de acumulados. - [Consultar el detalle base de cesantías salario fijo](https://developer.loggro.com/reference/getdetallebasecesantiassalariofijo.md): Consultar el detalle base de cesantías salario fijo para una fecha fin de acumulados. - [Consultar los acumulados para el calculo de Cesantias](https://developer.loggro.com/reference/getdetallebasecesantias.md): Consultar los valores tenidos en cuenta para el cálculo de Cesantias. - [Prestaciones y vacaciones del periodo](https://developer.loggro.com/reference/getprestacionesvacaciones.md): Reporte de prestaciones y vacaciones para un periodo. - [Prestaciones y vacaciones mensual](https://developer.loggro.com/reference/getprestacionesvacacionesmensual.md): Reporte mensual de prestaciones y vacaciones. - [Consolidado de vacaciones](https://developer.loggro.com/reference/getconsolidadovacaciones.md): Reporte consolidado de vacaciones del periodo. - [Exportar consolidado de vacaciones](https://developer.loggro.com/reference/exportarconsolidadovacaciones.md): Genera y descarga el archivo Excel del consolidado de vacaciones del periodo. - [Consolidado de cesantías](https://developer.loggro.com/reference/getconsolidadocesantias.md): Reporte consolidado de cesantías del periodo. - [Consolidado de prima](https://developer.loggro.com/reference/getconsolidadoprima.md): Reporte consolidado de prima de servicios del periodo. - [Días disponibles de vacaciones](https://developer.loggro.com/reference/getdiasdisponiblesvacaciones.md): Consultar los días disponibles de vacaciones a una fecha. - [Depuración de retefuente](https://developer.loggro.com/reference/getdepuracionretefuente.md): Reporte de depuración de retencion en la fuente del periodo. - [Años válidos para retefuente](https://developer.loggro.com/reference/getaniosvalidosretefuente.md): Consultar los años válidos disponibles para depuración de retefuente. - [Depuración retefuente semestral](https://developer.loggro.com/reference/getdepuracionretefuentesemestre.md): Reporte de depuración de retencion en la fuente semestral. - [Historial de cambios](https://developer.loggro.com/reference/gethistorialcambiosgeneral.md): Reporte del historial de cambios en un rango de fechas. - [Deducciones no aplicadas](https://developer.loggro.com/reference/getdeduccionesnoaplicadas.md): Reporte de deducciones no aplicadas en el periodo. - [Periodos disponibles de deducciones](https://developer.loggro.com/reference/getaniosmesesdisponiblesdeduciones.md): Consultar los periodos disponibles para el reporte de deducciones. - [Último aumento salarial](https://developer.loggro.com/reference/getultimoaumentosalario.md): Reporte del último aumento salarial por empleado. - [Información adicional para acumulados](https://developer.loggro.com/reference/getdatosinicialesinformacionadicional.md): Consultar información adicional de empleados para calculo de acumulados iniciales. - [Años para certificado de ingresos](https://developer.loggro.com/reference/getanoscertificadoingresos.md): Consultar los años disponibles para generar certificados de ingresos. - [Certificados de ingresos del ano](https://developer.loggro.com/reference/getcertificadoingresosporano.md): Consultar los certificados de ingresos y retenciones de un ano. - [Retefuente semestral del ano](https://developer.loggro.com/reference/getretencionsemestral.md): Consultar la retencion en la fuente semestral de un ano. - [Detalles de retefuente semestral](https://developer.loggro.com/reference/getdetallesretencionsemestral.md): Consultar los detalles de una retencion semestral. - [Listar certificados laborales](https://developer.loggro.com/reference/getcertificadoslaborales.md): Consultar la lista de certificados laborales generados. - [Verificación de sumatoria](https://developer.loggro.com/reference/verificarsumatoria.md): Exportar el detalle de las bases que componen la sumatoria de un concepto para un empleado en un periodo de pago. - [Listar cuentas contables](https://developer.loggro.com/reference/getcuentascontabilidad.md): Consultar el listado paginado de cuentas contables de la organización. - [Listar cuentas imputables](https://developer.loggro.com/reference/getcuentasimputablescontabilidad.md): Consultar el listado paginado de cuentas contables imputables de la organización. - [Detalle de cuenta por código o uuid](https://developer.loggro.com/reference/getcuentaporcodigocontabilidad.md): Consultar el detalle de una cuenta contable. El parámetro acepta el código numérico de la cuenta o su uuid. - [Detalle de cuenta imputable por código](https://developer.loggro.com/reference/getcuentaimputableporcodigocontabilidad.md): Consultar el detalle de una cuenta contable imputable por su código. - [Listar detalles de comprobantes contables](https://developer.loggro.com/reference/getdetallescomprobantescontables.md): Consultar el listado paginado de detalles de comprobantes contables. - [Detalle de comprobante contable por número y fuente](https://developer.loggro.com/reference/getcomprobantecontablepornumeroyfuente.md): Consultar el detalle de un comprobante contable por su número y fuente. - [Leer parámetros de configuración de Loggro Enterprise](https://developer.loggro.com/reference/getparametrosloggroenterprise.md): Consultar los parámetros de configuración de Loggro Enterprise para contabilidad. Solo disponible para organizaciones con plan Enterprise. - [Introducción Pymes](https://developer.loggro.com/reference/introduccion-pymes.md): Servicios del producto Loggro Pymes - [Autenticación](https://developer.loggro.com/reference/autenticacion-pymes.md) - [Consultar cuentas bancarias](https://developer.loggro.com/reference/consultarcuentasbancariaspymes.md): Retorna las cuentas bancarias registradas en Pymes. - [Obtiene el listado de centros de responsabilidad.](https://developer.loggro.com/reference/consultarcentrospymes.md): Obtiene todos los centros de responsabilidad disponibles en el Pymes, incluyendo información básica de la unidad de negocio a la que pertenecen. El resultado es paginado; por defecto retorna la página 1 con 20 registros. El límite máximo por página es 100. - [Obtiene un centro de responsabilidad por su identificador.](https://developer.loggro.com/reference/consultarcentroporuuidpymes.md): Obtiene la información de un centro de responsabilidad específico dado su uuid. - [Consultar formas de pago](https://developer.loggro.com/reference/consultarformasdepagopymes.md): Retorna las formas de pago disponibles en Pymes. Se puede filtrar por estado. - [Consultar vigencias de tarifas de impuesto](https://developer.loggro.com/reference/consultarvigenciatarivaimpuestopymes.md): Retorna las vigencias de tarifas de impuesto (IVA, INC, RTF, etc.) configuradas en Pymes. Se puede filtrar por código de impuesto usando el parámetro `impuesto`. - [Consultar Impuestos y Retenciones](https://developer.loggro.com/reference/consultarimpuestoretencionpymes.md): Retorna las vigencias de tarifas de impuestos y retenciones (IVA, ICO, RTF, ICA, etc.) configuradas en Pymes, filtradas por tipo de transacción. Se puede filtrar adicionalmente por código de impuesto usando el parámetro `impuesto`. - [Consultar medios de pago](https://developer.loggro.com/reference/consultarmediosdepagopymes.md): Retorna los medios de pago disponibles en Pymes. Se puede filtrar por integración. - [Listar establecimientos](https://developer.loggro.com/reference/listarestablecimientospymes.md): Retorna los nodos de tipo EST y EPP activos. Se puede filtrar por compañía padre usando el parámetro `padre`. Incluye información de contacto de la tabla de terceros. - [Consultar establecimiento](https://developer.loggro.com/reference/consultarestablecimientopymes.md): Obtiene un establecimiento activo por su UUID o código completo (ej: `COM001.EST001`). - [Buscar establecimiento por ID](https://developer.loggro.com/reference/buscarestablecimientoporidpymes.md): Busca un establecimiento activo (tipo EST o EPP) por su UUID o código completo (ej: `COM001.EST001`). - [Listar agrupadores](https://developer.loggro.com/reference/listaragrupadorespymes.md): Retorna los agrupadores activos. Se puede filtrar por establecimiento padre usando el parámetro `padre`. - [Consultar agrupador](https://developer.loggro.com/reference/consultaragrupadorpymes.md): Obtiene un agrupador activo por su UUID o código completo. - [Buscar agrupador por ID](https://developer.loggro.com/reference/buscaragrupadorporidpymes.md): Busca un agrupador activo (tipo VIR) por su UUID o código completo. - [Listar bodegas](https://developer.loggro.com/reference/listarbodegaspymes.md): Retorna las bodegas activas de la estructura empresarial. Se puede filtrar por establecimiento usando el parámetro `establecimiento`. Sin filtro, retorna las bodegas cuyo `codTipNiv` sea BOD. Incluye información de contacto de la tabla IN_BODEGA. - [Consultar bodega](https://developer.loggro.com/reference/consultarbodegapymes.md): Obtiene una bodega por su UUID. Incluye información de contacto de la tabla IN_BODEGA. - [Listar unidades de negocio](https://developer.loggro.com/reference/get-unidades-negocio.md): Retorna el listado paginado de las unidades de negocio de la compañía. Los parámetros `page` y `limit` son opcionales; cuando no se envían se consulta la página 1 con un tamaño de página de 20 registros. El tamaño máximo de página permitido es de 100 registros. - [Consultar unidad de negocio por UUID](https://developer.loggro.com/reference/get-unidad-negocio-por-uuid.md): Obtiene la información de una unidad de negocio a partir de su identificación única (uuid). - [Consultar unidad de negocio por código completo](https://developer.loggro.com/reference/get-unidad-negocio-por-codigo-completo.md): Obtiene la información de una unidad de negocio a partir de su código completo. - [Consultar unidades de negocio hijas de una unidad de negocio padre](https://developer.loggro.com/reference/get-unidades-negocio-por-padre.md): Retorna el listado de las unidades de negocio cuyo padre corresponde al uuid enviado. Si no existen unidades de negocio asociadas al padre indicado, retorna un listado vacío. - [Listar monedas](https://developer.loggro.com/reference/listarmonedaspymes.md): Retorna una lista paginada del catálogo de monedas disponibles en Pymes. El parámetro `limit` no puede superar 100 registros por página. - [Buscar moneda por código](https://developer.loggro.com/reference/buscarmonedaporcodigopymes.md): Busca y retorna una moneda por su código (ej. COP, USD). - [Buscar moneda por UUID](https://developer.loggro.com/reference/buscarmonedaporuuidpymes.md): Busca y retorna una moneda por su UUID interno de Loggro. - [Consultar vigencias de consecutivos](https://developer.loggro.com/reference/consultarvigenciasconsecutivospymes.md): Retorna las vigencias activas de los consecutivos de facturación configurados en Pymes para ventas Externas POS y ventas Externas NO POS. - [Consultar consecutivos NO POS de un establecimiento](https://developer.loggro.com/reference/consultarconsecutivosnoposestablecimientopymes.md): Retorna los tipos de consecutivo de facturación parametrizados como NO POS para un establecimiento específico. Si el establecimiento no tiene parametrizaciones NO POS, retorna una lista vacía. - [Consultar consecutivos NO POS de la compañía](https://developer.loggro.com/reference/consultarconsecutivosnoposcompaniapymes.md): Retorna los tipos de consecutivos de facturación NO POS que se encuentren activos y con bodega asociada para un establecimiento específico. Si el establecimiento no tiene configurado ningún consecutivo de facturación NO POS, retorna una lista vacía. - [Listar clientes](https://developer.loggro.com/reference/listarclientespymes.md): Retorna la lista de clientes registrados en Pymes. Soporta paginación y ordenamiento. - [Crear cliente](https://developer.loggro.com/reference/crearclientepymes.md): Crea un nuevo cliente en Pymes. ## Campos del body | Campo | Tipo | Obligatorio | Descripción | |---|---|---|---| | `uuid` | string | No | UUID del cliente (32 chars hex). Si se envía, se realiza un upsert con ese identificador. | | `id` | string | **Sí** (si no hay `uuid`) | Número de identificación del cliente. Máx. 30 caracteres. | | `tipoId` | string | No | Tipo de identificación: `CC`, `NIT`, `PS`, `DE`, etc. Por defecto `CC`. | | `dv` | string | No | Dígito de verificación. Se valida automáticamente para `CC` y `NIT`. Máx. 2 caracteres. | | `nombres` | string | **Sí** (si `tipoId` ≠ NIT) | Nombres del cliente. Máx. 150 caracteres. | | `apellidos` | string | **Sí** (si `tipoId` ≠ NIT) | Apellidos del cliente. Máx. 100 caracteres. | | `nombresCompletos` | string | **Sí** (si `tipoId` = NIT) | Razón social o nombre completo. Máx. 510 caracteres. | | `direccion` | string | No | Dirección del cliente. Máx. 60 caracteres. | | `telefono` | string | No | Teléfono (solo dígitos). Máx. 12 caracteres. | | `email` | string | No | Correo electrónico. Máx. 60 caracteres. | | `ciudad_codigo` | string | No | Código DANE de la ciudad. Máx. 5 caracteres. | ## Reglas de negocio - Para personas **naturales** (`tipoId` distinto de `NIT`): son obligatorios `nombres` y `apellidos`. - Para personas **jurídicas** (`tipoId = NIT`): es obligatorio `nombresCompletos`. - El `dv` se valida automáticamente para `CC` y `NIT`. Si no coincide con el calculado, retorna `400`. - Para `tipoId = PS` o `DE` el campo `id` admite caracteres alfanuméricos (`[A-Z0-9]`, entre 3 y 32 chars). - Si el cliente ya existe pero está **inactivo o suspendido**, el servicio lo **reactiva** con los datos enviados y retorna `201`. - Si el cliente ya existe y está **activo**, retorna `400` con código `cliente.crear.ya-existe`. - [Actualizar cliente](https://developer.loggro.com/reference/actualizarclientepymes.md): Actualiza los datos de un cliente existente en Pymes. ## Identificación del cliente Se debe proporcionar **al menos uno** de los siguientes identificadores: - `uuid` del cliente, **o** - La combinación `tipoId` + `id` (ambos son obligatorios si se usa esta opción). ## Campos del body | Campo | Tipo | Obligatorio | Descripción | |---|---|---|---| | `uuid` | string | Condicional | UUID del cliente (32 chars hex). Requerido si no se envía `tipoId` + `id`. | | `tipoId` | string | Condicional | Tipo de identificación. Requerido junto con `id` si no se envía `uuid`. | | `id` | string | Condicional | Número de identificación. Requerido junto con `tipoId` si no se envía `uuid`. Máx. 30 caracteres. | | `primerNombre` | string | No | Primer nombre del cliente. Máx. 150 caracteres. | | `segundoNombre` | string | No | Segundo nombre del cliente. Máx. 100 caracteres. | | `primerApellido` | string | No | Primer apellido del cliente. Máx. 100 caracteres. | | `segundoApellido` | string | No | Segundo apellido del cliente. Máx. 100 caracteres. | | `nombresCompletos` | string | No | Nombre completo o razón social. Máx. 510 caracteres. | | `direccion` | string | No | Dirección del cliente. Máx. 60 caracteres. | | `ciudad_codigo` | string | No | Código DANE de la ciudad. Máx. 5 caracteres. | | `telefono` | string | No | Teléfono (solo dígitos). Máx. 12 caracteres. | | `email` | string | No | Correo electrónico. Máx. 60 caracteres. | ## Reglas de negocio - Si no se envía ningún identificador (`uuid` o `tipoId` + `id`), retorna `400`. - Si se envía `tipoId` sin `id` (o viceversa), retorna `400`. - Si el cliente no existe, retorna `404`. - Solo se actualizan los campos enviados en el body; los demás se conservan. - [Consultar cliente por UUID](https://developer.loggro.com/reference/consultarclienteporuuidpymes.md): Retorna los datos de un cliente a partir de su UUID. - [Consultar cliente por identificación](https://developer.loggro.com/reference/consultarclienteportipoidpymes.md): Busca un cliente por su tipo y número de identificación usando el endpoint `GET /v1/clientes` con los parámetros `tipoId` e `id` como query params. Cuando ambos parámetros están presentes, el servicio retorna el cliente específico en lugar del listado paginado. ## Parámetros requeridos | Parámetro | Tipo | Descripción | |---|---|---| | `tipoId` | string | Tipo de identificación: `CC`, `NIT`, `PS`, `DE`, etc. | | `id` | string | Número de identificación del cliente. Máx. 30 caracteres. | ## Ejemplo de solicitud ``` GET /v1/clientes?tipoId=CC&id=1234567890 ``` ## Reglas de negocio - `tipoId` e `id` deben enviarse juntos; si solo se envía uno, el servicio ignora el filtro y retorna el listado paginado. - Si no se encuentra el cliente, retorna `404`. - [Suspender cliente](https://developer.loggro.com/reference/eliminarclientepymes.md): Suspende un cliente para venta a partir de su UUID. El cliente no se elimina físicamente. - [Anular factura de venta](https://developer.loggro.com/reference/anularfacturaventa.md): Anula una factura de venta existente indicando la razón y fecha de anulación. - [Crear factura de venta](https://developer.loggro.com/reference/crearfacturaventa.md): Crea una nueva factura de venta. Incluye los detalles del cliente, productos, impuestos y formas de pago. - [Verificar si existe factura](https://developer.loggro.com/reference/existefacturaventa.md): Verifica si existe una factura a partir de su identificador externo (`externalId`). Retorna `404` si no existe. - [Registrar pago de factura](https://developer.loggro.com/reference/pagarfacturaventa.md): Registra un pago sobre una factura de venta con saldo pendiente. - [Consultar producto en lista de precios](https://developer.loggro.com/reference/consultarproductolistaprecio.md): Consulta un producto específico dentro de una lista de precios. Retorna `404` si el producto no existe en la lista indicada. - [Crear o modificar producto en lista de precios](https://developer.loggro.com/reference/crearmodificarproductolistaprecio.md): Crea o modifica un producto dentro de una lista de precios específica. - Si el cuerpo **no incluye** el campo `uuid`, se interpreta como **creación**. - Si el cuerpo **incluye** el campo `uuid`, se interpreta como **modificación**. - [Crear vendedor](https://developer.loggro.com/reference/crearvendedorpymes.md): Crea un nuevo vendedor en Pymes. - [Listar vendedores](https://developer.loggro.com/reference/listarvendedorespymes.md): Retorna una lista paginada de vendedores. Admite paginación con los parámetros limit, offset o page, y ordenamiento con sort. - [Buscar vendedores por número de identificación](https://developer.loggro.com/reference/buscarvendedoresporidpymes.md): Retorna los vendedores que coinciden con el número de identificación indicado. - [Consultar vendedor por UUID](https://developer.loggro.com/reference/consultarvendedorporuuidpymes.md): Retorna la información de un vendedor por su UUID. - [Actualizar vendedor](https://developer.loggro.com/reference/actualizarvendedorpymes.md): Actualiza los datos de contacto de un vendedor. Solo se modifican los campos enviados (los campos nulos no se actualizan). El campo `celular` es obligatorio. - [Eliminar vendedor](https://developer.loggro.com/reference/eliminarvendedorpymes.md): Elimina un vendedor del sistema. No es posible eliminar si tiene documentos asociados. - [Consultar análisis de edades CxC consolidado](https://developer.loggro.com/reference/consultaredadescxcpymes.md): Retorna el análisis de edades de cuentas por cobrar (CxC) consolidado por cliente, agrupando los saldos pendientes en rangos de vencimiento. Solo incluye clientes con saldo pendiente mayor a cero. ## Parámetros | Parámetro | Tipo | Obligatorio | Descripción | |---|---|---|---| | `establecimientoUuidOCodigo` | string | No | UUID o código del establecimiento a filtrar. Si no se envía, retorna la consolidación de toda la compañía. | | `fechaUltimaModificacion` | string | No | Filtra documentos cuyo saldo fue modificado a partir de esta fecha. Formato `dd/MM/yyyy`. No puede ser fecha futura. | | `page` | integer | No | Número de página (base 1). No puede ser negativo. Por defecto `1`. | | `limit` | integer | No | Máximo de registros por página. No puede ser negativo ni superar `100`. Por defecto `20`. | ## Reglas de negocio - Si no se envía `establecimientoUuidOCodigo`, se retorna la consolidación de **toda la compañía**. - Si se envía `establecimientoUuidOCodigo` y existe (por UUID o código), se filtra por ese establecimiento. - Si se envía `establecimientoUuidOCodigo` y **no existe**, retorna `404`. - `fechaUltimaModificacion` filtra documentos cuyo **saldo fue modificado a partir de esa fecha** (inclusive). - `fechaUltimaModificacion` debe tener el formato `dd/MM/yyyy`; de lo contrario retorna `400`. - `fechaUltimaModificacion` no puede ser una fecha futura; de lo contrario retorna `400`. - `page` no puede ser negativo; de lo contrario retorna `400`. - `limit` no puede ser negativo ni superar `100`; de lo contrario retorna `400`. - Solo se retornan clientes cuyo **saldo pendiente es mayor a cero**. - [Consultar análisis de edades CxC por cliente](https://developer.loggro.com/reference/consultardetalleedadescxcpymes.md): Retorna el detalle del análisis de edades de cuentas por cobrar (CxC) para un cliente específico, desglosado por documento (factura, nota débito, etc.). Solo incluye documentos con saldo pendiente mayor a cero. ## Parámetros de identificación del cliente Se debe enviar **uno** de los siguientes identificadores (son excluyentes): | Parámetro | Tipo | Descripción | |---|---|---| | `uuid` | string | UUID del cliente en Loggro (32 chars hex). No enviar junto con `tipoId` o `id`. | | `tipoId` + `id` | string | Tipo y número de identificación del cliente. Deben enviarse **juntos**. | ## Parámetros de filtro y paginación | Parámetro | Tipo | Obligatorio | Descripción | |---|---|---|---| | `establecimientoUuidOCodigo` | string | No | UUID o código del establecimiento a filtrar. Si no se envía, retorna datos de toda la compañía. | | `fechaUltimaModificacion` | string | No | Filtra documentos cuyo saldo fue modificado a partir de esta fecha. Formato `dd/MM/yyyy`. No puede ser fecha futura. | | `page` | integer | No | Número de página (base 1). No puede ser negativo. Por defecto `1`. | | `limit` | integer | No | Máximo de registros por página. No puede ser negativo ni superar `100`. Por defecto `20`. | ## Reglas de negocio - Al menos uno de los identificadores (`uuid` o `tipoId`+`id`) es **obligatorio**; si no se envía ninguno, retorna `400`. - No se puede enviar `uuid` junto con `tipoId` o `id`; retorna `400`. - `tipoId` e `id` deben enviarse **juntos**; si solo se envía uno, retorna `400`. - Si el `tipoId` no existe en el sistema, retorna `400`. - Si el cliente no existe, retorna `404`. - Si se envía `establecimientoUuidOCodigo` y no existe, retorna `404`. - `fechaUltimaModificacion` filtra documentos cuyo **saldo fue modificado a partir de esa fecha** (inclusive). - `fechaUltimaModificacion` debe tener el formato `dd/MM/yyyy`; de lo contrario retorna `400`. - `fechaUltimaModificacion` no puede ser una fecha futura; de lo contrario retorna `400`. - `page` no puede ser negativo; de lo contrario retorna `400`. - `limit` no puede ser negativo ni superar `100`; de lo contrario retorna `400`. - Solo se retornan documentos cuyo **saldo pendiente es mayor a cero**. - [Consultar detalle de ventas](https://developer.loggro.com/reference/consultarventasdetalladaspymes.md): Retorna el detalle de ventas de Pymes desglosado por línea de documento (una fila por ítem facturado). Incluye facturas de venta y notas crédito. Solo se incluyen documentos cuyo estado no sea `EP` (en proceso). Adicionalmente, permite consultar los impuestos y retenciones aplicados a cada línea del detalle enviando `embedded=impuestos` junto con el cliente (`clienteUuid` o `clienteId`) o el `numero` del documento. ## Parámetros | Parámetro | Tipo | Obligatorio | Descripción | |---|---|---|---| | `establecimiento` | string | No | UUID o código del establecimiento a filtrar. Si no se envía, o si corresponde a un nodo de tipo compañía, retorna la consolidación de toda la compañía. | | `clienteUuid` | string | No | UUID del cliente en Loggro a filtrar. | | `clienteId` | string | No | Número de identificación del cliente a filtrar. | | `tipoDocumento` | string | No | Tipo de documento a filtrar. Valores permitidos: `FAVE` (factura de venta), `NCVE` (nota crédito de venta). | | `numero` | string | No | Número del documento a filtrar. Si se envía y no se indican `fechaDesde` ni `fechaHasta`, la consulta se realiza sin restricción de rango de fechas. | | `fechaDesde` | string | Condicional | Fecha inicial del rango a consultar. Formato `dd/MM/yyyy`. Obligatorio, salvo que se envíe `numero` sin indicar ninguna fecha. | | `fechaHasta` | string | Condicional | Fecha final del rango a consultar. Formato `dd/MM/yyyy`. Obligatorio, salvo que se envíe `numero` sin indicar ninguna fecha. | | `embedded` | string | No | Permite incluir información adicional en la respuesta. Único valor soportado: `impuestos`. Requiere indicar `clienteUuid`, `clienteId` o `numero`. | | `page` | integer | No | Número de página (base 1). Debe ser mayor o igual a 1. Por defecto `1`. | | `limit` | integer | No | Máximo de registros por página. Debe ser mayor o igual a 1 y no puede superar `100`. Por defecto `20`. | ## Reglas de negocio - `fechaDesde` y `fechaHasta` son **obligatorios**, a menos que se envíe `numero` sin indicar ninguna de las dos fechas. - Si se envía únicamente `fechaDesde` o únicamente `fechaHasta` (sin la otra), la fecha faltante sigue siendo **obligatoria**, incluso si se envía `numero`. - `fechaDesde` y `fechaHasta` deben tener el formato `dd/MM/yyyy`; de lo contrario retorna `400`. - `fechaDesde` debe ser **anterior** a `fechaHasta`; de lo contrario retorna `400`. - `fechaHasta` no puede ser una **fecha futura**; de lo contrario retorna `400`. - El rango entre `fechaDesde` y `fechaHasta` no puede superar **31 días**; de lo contrario retorna `400`. - Si se envía `tipoDocumento`, debe ser `FAVE` o `NCVE`; de lo contrario retorna `400`. - Si se envía `embedded`, su único valor permitido es `impuestos`; de lo contrario retorna `400`. - Si se envía `embedded=impuestos`, es obligatorio indicar `clienteUuid`, `clienteId` o `numero`; de lo contrario retorna `400`. - Si se envía `establecimiento` y no existe (por UUID o código), retorna `404`. - `page` debe ser mayor o igual a 1; de lo contrario retorna `400`. - `limit` debe ser mayor o igual a 1 y no puede superar `100`; de lo contrario retorna `400`. - [Crear ingreso](https://developer.loggro.com/reference/crearingresopymes.md): Crea un ingreso externo en el módulo financiero de Pymes. Si el ingreso no pudo ser procesado completamente, la respuesta retorna `procesado: false` junto con el error `ingreso-externo.crear.reprocesar`. - [Crear concepto comercial](https://developer.loggro.com/reference/crearconceptocomercialpymes.md): Crea un nuevo concepto comercial (ingreso/egreso) en Pymes, asociado a la compañía del tenant. Requiere un código de cuenta contable activa e imputable, y una clasificación existente. Adicionalmente, registra la contabilización fija (cuenta contable) asociada al concepto en el plan de cuentas LIBRO-BASE de la compañía. El campo `defecto` no es asignable desde este servicio: siempre se crea en `false`. El campo `orden` no se recibe en la creación: se calcula automáticamente a partir de la `clasificacion` enviada. - [Listar conceptos comerciales](https://developer.loggro.com/reference/listarconceptoscomercialespymes.md): Retorna una lista paginada de conceptos comerciales (ingreso/egreso) registrados en Pymes. El parámetro `limit` no puede superar 100 registros por página. - [Consultar concepto comercial por UUID](https://developer.loggro.com/reference/consultarconceptocomercialporuuidpymes.md): Retorna los datos de un concepto comercial a partir de su UUID. - [Consultar concepto comercial por código](https://developer.loggro.com/reference/consultarconceptocomercialporcodigopymes.md): Busca un concepto comercial por su código, dentro de la compañía del tenant. - [Listar conceptos comerciales por cuenta contable](https://developer.loggro.com/reference/consultarconceptoscomercialesporcuentacontablepymes.md): Retorna, de forma paginada, los conceptos comerciales que tienen asociada la cuenta contable indicada. El parámetro `limit` no puede superar 100 registros por página. - [Actualizar concepto comercial](https://developer.loggro.com/reference/actualizarconceptocomercialpymes.md): Actualiza los datos de un concepto comercial existente. Solo se actualizan los campos enviados: `descripcion`, `codigoCuenta`, `estado` y `porcentaje`. Si se envía `codigoCuenta` y corresponde a una cuenta diferente a la ya asociada, también se actualiza el registro de contabilización fija correspondiente. - [Inactivar concepto comercial](https://developer.loggro.com/reference/eliminarconceptocomercialpymes.md): Marca el concepto comercial como inactivo (`estado = INA`). No lo elimina físicamente. No es posible inactivar un concepto comercial marcado como `defecto = true` (`concepto-comercial.eliminar.es-defecto`). - [Crear caja](https://developer.loggro.com/reference/crearcajapymes.md): Crea una nueva caja en el sistema, asociada a la compañía de la cuenta Pymes. Requiere que la estructura empresarial, el responsable y el empleado asignado existan. La cuenta contable es opcional: si se envía, debe existir, pertenecer al plan de cuentas base de la compañía (que debe tener dicho libro base configurado), estar activa, ser imputable y no manejar moneda extranjera; si NO se envía, la caja se crea igual, pero en estado `SUSP` en vez de `ACTI` (ver `estadoCaja` más abajo). Los campos `tipoCaja`, `estadoCajaVentaMostrador`, `base`, `usoExclusivoEstructura`, `numeroCuadreCaja`, `fechaApertura` y `moneda` no se reciben en la creación: siempre se guardan con su valor fijo (`RECA`, `CER`, `0`, `false` y `null` respectivamente), salvo `moneda`, que se resuelve automáticamente a partir de la moneda base de la compañía o, si esta no tiene una configurada, de la moneda por defecto del sistema (COP). Enviar cualquiera de estos campos en el cuerpo de la petición produce un error `campo.no-reconocido`. `estadoCaja` tampoco se recibe en la creación, pero no es fijo: es `ACTI` si se envió una cuenta válida, o si la compañía no maneja contabilidad activa (en ese caso la cuenta no es requerida y la caja siempre queda `ACTI`, se envíe cuenta o no). Si la compañía sí maneja contabilidad y no se envió cuenta, la caja queda `SUSP`. La caja siempre se crea con saldo y saldo en efectivo en 0. - [Listar cajas](https://developer.loggro.com/reference/listarcajaspymes.md): Retorna una lista paginada de las cajas de la compañía. Por defecto solo muestra las cajas activas (`estadoCaja` = `ACTI`); para ver cajas suspendidas u otro estado, filtre explícitamente por `estadoCaja`. El parámetro `limit` no puede superar 100 registros por página. Si se envía `offset`, este tiene prioridad sobre el desplazamiento calculado a partir de `page`. - [Actualizar caja](https://developer.loggro.com/reference/actualizarcajapymes.md): Actualiza los campos editables de una caja existente. Se debe enviar al menos un campo. El código, la moneda y la compañía no se pueden modificar luego de la creación. Si se envía `cuenta`, se valida y se actualiza también la contabilización asociada de la caja; además, si la caja estaba suspendida (`SUSP`) y no se envía `estadoCaja` explícitamente en la misma petición, pasa a `ACTI` automáticamente. Enviar `cuenta` como cadena vacía (`""`) quita la cuenta contable asociada a la caja; si la caja estaba activa (`ACTI`) y no se envía `estadoCaja` explícitamente, pasa a `SUSP` automáticamente. En ambos casos, un `estadoCaja` explícito en la misma petición siempre prevalece sobre esta activación o suspensión implícita. El campo `estadoCaja` también permite suspender la caja (`SUSP`) directamente desde este servicio, con el mismo efecto que la baja lógica (`DELETE`). **Campos actualizables:** `descripcion`, `cuenta`, `estrucEmpre`, `responsable`, `asignado`, `estadoCaja`. Ningún otro campo (por ejemplo `tipoCaja`, `base`, `usoExclusivoEstructura`, `fechaApertura` o `numeroCuadreCaja`) es modificable desde este servicio. - [Eliminar caja](https://developer.loggro.com/reference/eliminarcajapymes.md): Realiza una baja lógica de la caja: actualiza su `estadoCaja` a `SUSP` (suspendida), sin eliminar físicamente el registro ni el de contabilización asociado. - [Consultar caja por UUID](https://developer.loggro.com/reference/consultarcajaporuuidpymes.md): Consulta una caja por su UUID, dentro de la compañía de la cuenta Pymes. - [Consultar caja por código](https://developer.loggro.com/reference/consultarcajaporcodigopymes.md): Consulta una caja por su código, dentro de la compañía de la cuenta Pymes. - [Listar cuentas contables](https://developer.loggro.com/reference/listarcuentascontablespymes.md): Retorna, de forma paginada, las cuentas del plan de cuentas contables de Pymes. Si se envía el parámetro `tipo`, filtra por cuentas de Mayor (agrupadoras) o Imputables (de detalle, contabilizables). Las cuentas Imputables incluyen además información de impuestos, retención y manejo de saldos; en las cuentas Mayor esos campos se retornan en `null`. - [Consultar cuenta contable por código](https://developer.loggro.com/reference/consultarcuentacontableporcodigopymes.md): Busca y retorna una cuenta contable del plan de cuentas por su código. - [Listar cuentas hijas](https://developer.loggro.com/reference/listarcuentascontableshijaspymes.md): Retorna, de forma paginada, las cuentas contables cuya cuenta padre es la identificada por `codigoPadre`. - [Listar cuentas por rango](https://developer.loggro.com/reference/listarcuentascontablesporrangopymes.md): Retorna, de forma paginada, las cuentas contables cuyo código está entre `desde` y `hasta` (comparación lexicográfica sobre el código, ambos límites inclusive). - [Consultar unidades de medida](https://developer.loggro.com/reference/consultarunidadesmedidapymes.md): Retorna las unidades de medida disponibles en el módulo de inventario. - [Disponibilidad de productos](https://developer.loggro.com/reference/disponibilidadproductospymes.md): Consulta la disponibilidad de uno o varios productos en un establecimiento. - [Crear o modificar ítem](https://developer.loggro.com/reference/crearmodificaritempymes.md): Crea o modifica un ítem en el módulo de inventario de Pymes. - Si el cuerpo **no incluye** `uuid`, se interpreta como **creación**. - Si el cuerpo **incluye** `uuid`, se interpreta como **modificación**. - El campo `tipoItem` determina la clase del ítem: `INVENTARIABLE`, `NO_INVENTARIABLE` o `SERVICIO`. - [Consultar ítem](https://developer.loggro.com/reference/consultaritempymes.md): Consulta un ítem por su UUID. Retorna `404` si no existe. - [Listar ítems](https://developer.loggro.com/reference/listaritempymes.md): Retorna una lista paginada de ítems. Se puede filtrar por tipo de ítem. - [Inactivar ítem](https://developer.loggro.com/reference/inactivaritempymes.md): Inactiva un ítem por su UUID. El ítem no se elimina físicamente, su estado pasa a `INA`. - [Consultar salida con detalle de inventario](https://developer.loggro.com/reference/consultarsalidainventariopymes.md): Consulta una salida con su información de inventario asociada. - [Consultar salida de inventario](https://developer.loggro.com/reference/consultarsalidapymes.md): Consulta una salida de inventario por su UUID. Retorna `404` si no existe. - [Crear salida de inventario](https://developer.loggro.com/reference/crearsalidainventariopymes.md): Crea una nueva salida de inventario con sus detalles de ítems. - [Registrar entrada de costo](https://developer.loggro.com/reference/entradacostoinventariopymes.md): Registra la entrada de costo asociada a una salida de inventario externa. - [Actualizar estado de pedido de consumo](https://developer.loggro.com/reference/estadopedidoconsumopymes.md): Actualiza el estado de un pedido de consumo asociado a una salida de inventario. - [Introducción Restobar](https://developer.loggro.com/reference/introduccion-restobar.md): Servicios del módulo de Restobar - [Inicio de sesión de usuario](https://developer.loggro.com/reference/iniciarsesion.md): Autentica un usuario registrado y devuelve la información del usuario con token JWT. El usuario debe estar previamente registrado en el sistema. **Caso de uso:** 1. El mesero o administrador del restaurante abre la aplicación Restobar 2. Ingresa su correo electrónico y contraseña registrados 3. El sistema valida las credenciales y retorna los datos del usuario 4. Se obtiene el token JWT (`tokenCurrent`) que debe incluirse en el header `Authorization: Bearer {token}` para todas las siguientes solicitudes API 5. Con este token, el usuario puede acceder a funciones como gestionar productos, tomar pedidos, generar facturas, etc. **Importante:** Guarde el valor `tokenCurrent` de la respuesta para autenticación en futuras solicitudes. - [Consultar todas las categorías](https://developer.loggro.com/reference/consultarcategorias.md): Consulta todas las categorías activas del negocio del usuario autenticado. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Ejemplos de uso:** - Consultar todas las categorías: `GET /categories` - [Crear o editar una categoría](https://developer.loggro.com/reference/guardarcategoria.md): Crea una nueva categoría o actualiza una existente si se envía `_id`. Permite subir imagen por multipart (campo `avatar`) o enviar `urlImage`. **Autenticación requerida:** Bearer Token. - [Consultar categoría por ID](https://developer.loggro.com/reference/consultarcategoriaporid.md): Obtiene el detalle de una categoría por su ID. **Autenticación requerida:** Bearer Token. - [Eliminar categoría](https://developer.loggro.com/reference/eliminarcategoria.md): Marca la categoría como eliminada (soft delete). **Autenticación requerida:** Bearer Token. - [Consultar categorías con productos](https://developer.loggro.com/reference/consultarcategoriasconproductos.md): Retorna todas las categorías activas con sus productos (no ingredientes ni subproductos). **Autenticación requerida:** Bearer Token. - [Consultar ingredientes](https://developer.loggro.com/reference/consultaringredientes.md): Consulta ingredientes y productos con inventario según configuración del negocio. Soporta filtros y paginación. **Autenticación requerida:** Bearer Token. - [Crear o editar ingrediente](https://developer.loggro.com/reference/guardaringrediente.md): Crea o actualiza un ingrediente. Si se envía `_id`, se actualiza el registro. **Autenticación requerida:** Bearer Token. - [Consultar solo ingredientes](https://developer.loggro.com/reference/consultarsoloingredientes.md): Retorna únicamente ingredientes activos del negocio (no productos). **Autenticación requerida:** Bearer Token. - [Consultar ingrediente por ID](https://developer.loggro.com/reference/consultaringredienteporid.md): Obtiene el detalle de un ingrediente por su ID. **Autenticación requerida:** Bearer Token. - [Eliminar ingrediente](https://developer.loggro.com/reference/eliminaringrediente.md): Marca un ingrediente como eliminado (soft delete). **Autenticación requerida:** Bearer Token. - [Consultar movimientos de inventario](https://developer.loggro.com/reference/consultarmovimientosinventario.md): Consulta los movimientos de inventario del negocio con filtros y paginación. **Autenticación requerida:** Bearer Token. - [Crear o editar movimiento de inventario](https://developer.loggro.com/reference/guardarmovimientoinventario.md): Crea un movimiento de inventario o lo actualiza si se envía `_id`. Soporta facturas, pagos y movimientos entre ubicaciones. **Autenticación requerida:** Bearer Token. - [Consultar tipos de inventario](https://developer.loggro.com/reference/consultartiposinventario.md): Retorna los tipos de inventario disponibles según permisos. **Autenticación requerida:** Bearer Token. - [Consultar movimiento por ID](https://developer.loggro.com/reference/consultarmovimientoporid.md): Obtiene el detalle de un movimiento de inventario. **Autenticación requerida:** Bearer Token. - [Eliminar movimiento de inventario](https://developer.loggro.com/reference/eliminarmovimientoinventario.md): Elimina un movimiento de inventario y revierte afectaciones de stock. **Autenticación requerida:** Bearer Token. - [Reporte de compras de ingredientes](https://developer.loggro.com/reference/reportecomprasingredientes.md): Genera el reporte de compras de ingredientes por rango de fechas. **Autenticación requerida:** Bearer Token (admin). - [Reporte de producción de ingredientes](https://developer.loggro.com/reference/reporteproduccioningredientes.md): Genera el reporte de producción por rango de fechas. **Autenticación requerida:** Bearer Token (admin). - [Reporte de traslados de ingredientes](https://developer.loggro.com/reference/reportetrasladosingredientes.md): Genera el reporte de traslados entre ubicaciones por rango de fechas. **Autenticación requerida:** Bearer Token (admin). - [Consultar lista de clientes](https://developer.loggro.com/reference/consultarclientes.md): Consulta una lista paginada de clientes del negocio actual. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Características:** - Soporta paginación para manejo eficiente de grandes listas - Incluye filtros de búsqueda por nombre, teléfono, documento, email - Búsqueda flexible con múltiples palabras clave - Ordenación automática por nombre - Respeta configuración de compartir clientes con negocio padre **Limitaciones plan trial:** Las cuentas en periodo de prueba solo pueden ver clientes de las últimas 24 horas. ## Ejemplos de Uso ### 1. Consultar todos los clientes (primera página) ``` GET /clients?pagination=true&limit=10&page=0 Authorization: Bearer tu_token_aqui ``` Consulta los primeros 10 clientes ordenados por nombre. ### 2. Buscar cliente por nombre ``` GET /clients?filter=Juan&pagination=true&limit=10&page=0 Authorization: Bearer tu_token_aqui ``` Busca clientes que contengan "Juan" en nombre o apellido. ### 3. Búsqueda por múltiples palabras ``` GET /clients?filter=Maria Lopez&pagination=true&limit=10&page=0 Authorization: Bearer tu_token_aqui ``` Busca clientes que contengan tanto "Maria" como "Lopez". ### 4. Búsqueda por teléfono ``` GET /clients?filter=300123&pagination=true&limit=10&page=0 Authorization: Bearer tu_token_aqui ``` Busca clientes por número de teléfono (búsqueda flexible con espacios). ### 5. Búsqueda avanzada por datos generales ``` GET /clients?clientData=empresa@email.com&pagination=true&limit=10&page=0 Authorization: Bearer tu_token_aqui ``` Busca en todos los campos del cliente (nombre, apellido, documento, email, teléfono, dirección). - [Crear o editar un cliente](https://developer.loggro.com/reference/guardarcliente.md): Crea un nuevo cliente o edita uno existente para el negocio actual. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Permiso requerido:** `CL_POST` (Crear/Editar) **Comportamiento:** - Si se envía `_id`, se busca el cliente existente y se actualiza con los datos del body. - Si no se envía `_id` (o no existe), se crea un nuevo cliente con `points: 0`. - Respeta la configuración de compartir clientes con negocio padre. - Registra el historial de cambios (creación o actualización). - Notifica via WebSocket a todos los usuarios del negocio. ## Ejemplos de Uso ### 1. Crear nuevo cliente ```json POST /clients Authorization: Bearer tu_token_aqui Content-Type: application/json { "name": "Juan", "lastName": "Pérez", "document": "12345678", "idDocumentType": "CC", "phone": "+57 300 123 4567", "email": "juan@email.com", "address": "Calle 123 #45-67" } ``` ### 2. Editar cliente existente ```json POST /clients Authorization: Bearer tu_token_aqui Content-Type: application/json { "_id": "507f1f77bcf86cd799439021", "name": "Juan", "lastName": "García", "phone": "+57 300 999 8888" } ``` - [Obtener un cliente por ID](https://developer.loggro.com/reference/consultarclienteporid.md): Devuelve el detalle completo de un cliente específico del negocio actual. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Permiso requerido:** `CL_POST` (Crear/Editar) **Comportamiento:** - El cliente debe pertenecer al negocio autenticado. - Si el negocio tiene configurado compartir clientes con el negocio padre, también se busca en el negocio padre. - Retorna `null` si el cliente no existe (sin error 404). ## Ejemplo de Uso ``` GET /clients/507f1f77bcf86cd799439021 Authorization: Bearer tu_token_aqui ``` - [Eliminar un cliente](https://developer.loggro.com/reference/eliminarcliente.md): Realiza una eliminación lógica del cliente (marca el campo `deleted: true`). El cliente no se borra físicamente de la base de datos. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Permiso requerido:** `CL_DELETE` (Eliminar) **Comportamiento:** - Marca el campo `deleted: true` y actualiza `modifiedOn` con la fecha actual. - El cliente ya no aparecerá en las búsquedas (`getAll` filtra `deleted: { $ne: true }`). - Registra el evento en el historial de cambios. - Notifica via WebSocket a todos los usuarios del negocio. - El cliente debe pertenecer al negocio autenticado. ## Ejemplo de Uso ``` DELETE /clients/507f1f77bcf86cd799439021 Authorization: Bearer tu_token_aqui ``` - [Registrar abono a crédito de un cliente](https://developer.loggro.com/reference/registrarabonocreditocliente.md): Registra un movimiento de abono al crédito de un cliente y aplica el pago automáticamente a las facturas pendientes (`Por Pagar`) ordenadas de más antigua a más reciente. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Permiso requerido:** `CL_POST_PAID` (Realizar abonos) **Requisito adicional:** Requiere una caja activa (middleware `cashBoxController.middlewareCurrent`). El usuario debe tener una caja registradora abierta en su turno actual. **Comportamiento:** - Agrega el movimiento de crédito al historial `creditMovement` del cliente. - Busca todas las facturas `Por Pagar` del cliente, ordenadas por fecha de creación (más antigua primero). - Aplica el abono secuencialmente: si el abono supera el saldo de una factura, la marca como `Pagada` y continúa con la siguiente. - Registra en cada factura el método de pago y la caja registradora activa. - Notifica via WebSocket a todos los usuarios del negocio. ## Ejemplo de Uso ### Registrar abono en efectivo ```json POST /clients/savePaidCredit Authorization: Bearer tu_token_aqui Content-Type: application/json { "client": "507f1f77bcf86cd799439021", "total": 50000, "paymentMethod": { "internalId": "507f1f77bcf86cd799439030", "name": "Efectivo" }, "date": "2025-08-05T10:30:00.000Z", "notes": "Abono parcial" } ``` - [Obtener todos los proveedores de domicilio](https://developer.loggro.com/reference/consultarproveedoresdomicilio.md): Retorna la lista de proveedores de domicilio activos del negocio autenticado. Se puede filtrar por estado activo mediante el parámetro `active`. Requiere autenticación con Bearer Token. - [Crear o editar un proveedor de domicilio](https://developer.loggro.com/reference/guardarproveedordomicilio.md): Crea un nuevo proveedor de domicilio o actualiza uno existente. - Si se envía `_id` en el body, se **actualiza** el proveedor existente. - Si no se envía `_id`, se **crea** un nuevo proveedor. - Se puede adjuntar una imagen (campo `avatar`) como `multipart/form-data`. - Requiere el permiso **DP_POST** (Crear/Editar). - [Obtener un proveedor de domicilio por ID](https://developer.loggro.com/reference/consultarproveedordomicilioporid.md): Retorna el detalle de un proveedor de domicilio específico del negocio autenticado. Requiere el permiso **DP_POST** (Crear/Editar). - [Eliminar un proveedor de domicilio](https://developer.loggro.com/reference/eliminarproveedordomicilio.md): Realiza una eliminación lógica (soft delete) del proveedor de domicilio. El registro no se borra físicamente de la base de datos, solo se marca como eliminado. Requiere el permiso **DP_DELETE** (Eliminar). - [Obtener todos los eventos del negocio](https://developer.loggro.com/reference/consultareventos.md): Retorna la lista de eventos activos del negocio autenticado. Si el negocio hereda productos del padre y tiene `inheritParentsProducts` activo, también incluye los eventos del negocio padre. - [Crear o editar un evento](https://developer.loggro.com/reference/guardarevento.md): Si se envía `_id` en el cuerpo, actualiza el nombre y la fecha del evento existente. Si no se envía `_id`, crea un nuevo evento. Requiere el permiso **EV_POST**. - [Obtener un evento por ID](https://developer.loggro.com/reference/consultareventoporid.md): Retorna el detalle de un evento específico perteneciente al negocio autenticado. Requiere el permiso **EV_POST**. - [Eliminar un evento (borrado lógico)](https://developer.loggro.com/reference/eliminarevento.md): Marca el evento como eliminado (`deleted: true`) sin borrarlo físicamente de la base de datos. Solo se pueden eliminar eventos que pertenezcan al negocio autenticado. Requiere el permiso **EV_DELETE**. - [Consultar todas las facturas](https://developer.loggro.com/reference/consultarfacturas.md): Consulta una lista paginada de todas las facturas del negocio actual. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` Soporta múltiples filtros para búsqueda específica y paginación para manejo eficiente de grandes volúmenes de datos. **Limitaciones plan trial:** Las cuentas en periodo de prueba solo pueden ver facturas de las últimas 24 horas. ## Ejemplos de Uso ### 1. Consultar todas las facturas (primera página) ``` GET /invoices?pagination=true&limit=10&page=0 Authorization: Bearer tu_token_aqui ``` Consulta las primeras 10 facturas ordenadas por fecha de creación. ### 2. Buscar facturas pagadas de hoy ``` GET /invoices?status=Pagada&dateInit=2025-08-05T00:00:00.000Z&dateEnd=2025-08-05T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` Filtra facturas con estado 'Pagada' creadas en el día actual. ### 3. Facturas de entrega a domicilio ``` GET /invoices?onlyDelivery=true&deliveryProvider=RAPPI Authorization: Bearer tu_token_aqui ``` Consulta solo facturas que incluyen entrega a domicilio con Rappi. ### 4. Facturas por método de pago ``` GET /invoices?paymentMethodName=Efectivo&pagination=true&limit=20&page=1 Authorization: Bearer tu_token_aqui ``` Filtra facturas pagadas con efectivo, página 2 (20 elementos por página). ### 5. Facturas electrónicas exitosas ``` GET /invoices?type=FacturaElectronica&statusFE=00&statusSiigo=200 Authorization: Bearer tu_token_aqui ``` Consulta facturas electrónicas aceptadas por DIAN e integradas exitosamente con Siigo. - [Crear nueva factura](https://developer.loggro.com/reference/crearfactura.md): Crea una nueva factura a partir de pedidos existentes u órdenes específicas. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Proceso de facturación:** - Convierte pedidos en factura oficial - Calcula impuestos y totales automáticamente - Soporta facturación electrónica (DIAN) - Integra con sistemas contables (Siigo, Loggro) - Actualiza inventario y caja registradora **Requisitos de caja:** Requiere caja registradora activa para el usuario. ## Casos de Uso y Ejemplos ### Caso de Uso: Facturar mesa de restaurante **Escenario:** Un mesero ha tomado varios pedidos en una mesa y necesita generar la factura final. **Proceso:** 1. Los pedidos se han creado previamente con estado "Espera" o "Entregado" 2. Se seleccionan todos los pedidos de la mesa para facturar 3. Se especifica método de pago y cliente (opcional) 4. Se genera factura con cálculo automático de impuestos ### 1. Factura básica de mesa ```json { "_id": "507f1f77bcf86cd799439020", "orderProducts": [ { "order": "507f1f77bcf86cd799439011" }, { "order": "507f1f77bcf86cd799439012" } ], "table": "507f1f77bcf86cd799439014", "client": { "name": "Juan Pérez", "phone": "+57 300 123 4567", "email": "juan@email.com" }, "paymentMethod": "507f1f77bcf86cd799439018", "isPaid": true, "total": 45000, "discountAdditionalTotal": 5000 } ``` ### 2. Factura electrónica con DIAN ```json { "_id": "507f1f77bcf86cd799439021", "isEInvoice": true, "orderProducts": [ { "order": "507f1f77bcf86cd799439013" } ], "client": { "name": "María González", "idType": "CC", "idNumber": "123456789", "email": "maria@empresa.com" }, "isPaid": true, "total": 30000, "sendInvoiceEmail": true } ``` ### 3. Factura a crédito ```json { "_id": "507f1f77bcf86cd799439022", "orderProducts": [ { "order": "507f1f77bcf86cd799439014" }, { "order": "507f1f77bcf86cd799439015" } ], "client": { "name": "Empresa ABC", "idType": "NIT", "idNumber": "900123456-1" }, "isCredit": true, "creditDays": 30, "total": 75000, "status": "Pendiente" } ``` ### 4. Factura con entrega a domicilio ```json { "_id": "507f1f77bcf86cd799439023", "orderProducts": [ { "order": "507f1f77bcf86cd799439016" } ], "delivery": { "isDelivery": true, "deliveryProvider": "507f1f77bcf86cd799439017", "deliveryGuy": { "internalId": "507f1f77bcf86cd799439025" }, "address": "Calle 123 #45-67, Bogotá" }, "deliveryCost": 8000, "isPaid": true, "total": 38000 } ``` - [Validar estado de factura electrónica](https://developer.loggro.com/reference/validarfacturaelectronica.md): Consulta el estado de validación de facturas electrónicas ante la DIAN. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` Permite revisar si una factura electrónica fue aceptada o rechazada por la DIAN. - [Contar facturas electrónicas](https://developer.loggro.com/reference/contarfacturaselectronicas.md): Retorna el conteo de facturas electrónicas generadas por el negocio actual. Útil para conocer cuántas facturas electrónicas se han emitido sin cargar el detalle completo. - [Obtener la última factura del negocio](https://developer.loggro.com/reference/obtenerultimafactura.md): Retorna la última factura registrada del negocio actual. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` Útil para verificar el último número de factura generado o continuar una secuencia de facturación. - [Obtener facturas en estado Facturada](https://developer.loggro.com/reference/obtenerfacturadas.md): Retorna todas las facturas del negocio actual que se encuentran en estado "Facturada" (pendientes de pago). **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` Permite identificar rápidamente facturas generadas que aún no han sido cobradas. - [Obtener factura por ID](https://developer.loggro.com/reference/obtenerfacturaporid.md): Retorna el detalle completo de una factura específica según su ID. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` Incluye todos los datos de la factura: productos, cliente, métodos de pago, estado electrónico, etc. - [Verificar validación de factura electrónica por ID](https://developer.loggro.com/reference/verificarvalidacionfacturaelectronica.md): Verifica si una factura electrónica específica ha sido validada y aceptada por la DIAN. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` Retorna el estado actual de validación ante la DIAN para la factura indicada. - [Marcar factura como pagada](https://developer.loggro.com/reference/marcarfacturacomopagada.md): Cambia el estado de una factura de "Facturada" a "Pagada" y registra los métodos de pago utilizados. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Requisitos:** - La factura debe estar en estado "Facturada" - Requiere caja registradora activa - El usuario debe tener permisos para crear facturas **Proceso:** - Actualiza el estado de la factura a "Pagada" - Registra métodos de pago con timestamp - Actualiza estado de órdenes asociadas - Envía a integraciones contables (Siigo, Loggro) - Registra propinas y costos de entrega ## Ejemplos de Uso ### 1. Pago en efectivo ```json { "_id": "507f1f77bcf86cd799439020", "paymentMethodValue": [ { "paymentMethod": "507f1f77bcf86cd799439018", "value": 45000 } ], "tip": 5000 } ``` ### 2. Pago mixto (efectivo + tarjeta) ```json { "_id": "507f1f77bcf86cd799439021", "paymentMethodValue": [ { "paymentMethod": "507f1f77bcf86cd799439018", "value": 20000 }, { "paymentMethod": "507f1f77bcf86cd799439019", "value": 25000 } ] } ``` ### 3. Actualizar información del cliente ```json { "_id": "507f1f77bcf86cd799439022", "paymentMethodValue": [ { "paymentMethod": "507f1f77bcf86cd799439018", "value": 30000 } ], "client": { "name": "Juan Pérez Actualizado", "phone": "+57 300 123 4567", "email": "juan.nuevo@email.com" } } ``` - [Pagar facturas de proveedores de domicilio](https://developer.loggro.com/reference/pagarfacturasproveedoresdomicilio.md): Marca como pagadas las facturas de pedidos a domicilio (Rappi, Uber Eats, Didi Food, etc.). **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Requisitos:** - Requiere caja registradora activa - El usuario debe tener el permiso `IE_PUT_PAID_DELIVERY` Permite registrar el pago de facturas provenientes de plataformas de entrega a domicilio de forma masiva. - [Reenviar factura por correo electrónico](https://developer.loggro.com/reference/reenviarfacturaemail.md): Reenvía la factura al correo electrónico del cliente asociado. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Requisitos:** - La factura debe existir y estar en estado "Pagada" - El cliente debe tener un correo registrado Útil para reenviar facturas que no llegaron al cliente o cuando solicitan un duplicado. - [Anular factura](https://developer.loggro.com/reference/anularfactura.md): Cambia el estado de una factura a "Anulada" y revierte sus efectos en inventario y caja. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Requisitos:** - Requiere caja registradora activa - El usuario debe tener el permiso de anular facturas (`IE_POST_CANCELED`) - La factura debe estar en un estado que permita anulación **Efectos de la anulación:** - Revierte el movimiento en la caja registradora - Restaura el inventario de productos - Para facturas electrónicas, inicia proceso de anulación ante la DIAN - Notifica al sistema contable integrado (Siigo/Loggro) ## Ejemplos de Uso ### Anular factura con motivo ```json { "reason": "Error en los productos facturados" } ``` - [Finalizar proceso de anulación de factura electrónica](https://developer.loggro.com/reference/finalizaranulacionfacturaelectronica.md): Completa el proceso de anulación de una factura electrónica ante la DIAN. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Requisitos:** - Requiere caja registradora activa - La factura debe estar en proceso de anulación iniciado previamente - El usuario debe tener el permiso de anular facturas (`IE_POST_CANCELED`) **Proceso:** - Confirma la anulación ante la DIAN - Actualiza el estado final de la factura - Notifica a sistemas contables integrados - [Obtener domicilios asignados al repartidor actual](https://developer.loggro.com/reference/obtenermisdomicilios.md): Retorna la lista de facturas de domicilio asignadas al repartidor que realiza la petición. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` Este endpoint es exclusivo para usuarios con rol de repartidor. Retorna únicamente los domicilios pendientes o en curso asignados al repartidor autenticado. - [Obtener domicilios pendientes de asignación](https://developer.loggro.com/reference/obtenerdomiciliospendientes.md): Retorna la lista de facturas de domicilio que aún no tienen repartidor asignado. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` Permite al administrador o coordinador visualizar los domicilios que requieren ser asignados a un repartidor. - [Cambiar estado de un domicilio](https://developer.loggro.com/reference/cambiarestadodomicilio.md): Permite al repartidor actualizar el estado de su domicilio asignado. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Estados disponibles:** - `EnCamino` - El repartidor salió con el pedido - `Entregado` - El pedido fue entregado al cliente - `NoEntregado` - No se pudo entregar el pedido ## Ejemplos de Uso ``` PUT /invoices/507f1f77bcf86cd799439011/deliveryGuy/changeStatus/EnCamino Authorization: Bearer tu_token_aqui ``` - [Forzar reenvío de factura a integración contable](https://developer.loggro.com/reference/forzarenviointegracion.md): Fuerza el reenvío de una factura a los sistemas contables integrados (Siigo, Loggro) cuando el envío automático falló. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Requisitos:** - El usuario debe tener el permiso de forzar envío (`IF_FORCE_SEND`) - La factura debe existir en el sistema **Cuándo usarlo:** - Cuando una factura tiene `statusSiigo: 400` o `statusLoggro: 400` - Cuando la integración automática falló por errores de conectividad - Para resincronizar facturas con el sistema contable ## Ejemplos de Uso ``` PATCH /invoices/forceSendToIntegration/507f1f77bcf86cd799439011 Authorization: Bearer tu_token_aqui ``` - [Crear nuevos pedidos](https://developer.loggro.com/reference/crearpedidos.md): Crea uno o múltiples pedidos para una mesa o grupo específico. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Proceso de creación:** - Los pedidos se agrupan automáticamente por mesa/grupo - Se calculan totales incluyendo productos extras - Se actualiza inventario según configuración - Se notifica via WebSocket para actualizaciones en tiempo real **Limitaciones plan extracción:** Los negocios en plan de extracción no pueden crear nuevos pedidos. ## Ejemplos de Uso ### 1. Pedido simple para mesa ```json { "table": "507f1f77bcf86cd799439014", "group": "507f1f77bcf86cd799439015", "groupName": "Mesa 5 - Orden 1", "orders": [ { "product": "507f1f77bcf86cd799439013", "quantity": 2, "unit_price": 15000, "notes": ["Sin cebolla", "Extra queso"] } ] } ``` ### 2. Pedido con productos extras ```json { "table": "507f1f77bcf86cd799439014", "group": "507f1f77bcf86cd799439015", "groupName": "Mesa 5 - Orden 2", "orders": [ { "product": "507f1f77bcf86cd799439013", "quantity": 1, "unit_price": 15000, "productsExtra": [ { "product": "507f1f77bcf86cd799439020", "quantity": 1, "price": 3000 } ] } ] } ``` ### 3. Pedido cortesía (gratuito) ```json { "table": "507f1f77bcf86cd799439014", "group": "507f1f77bcf86cd799439015", "groupName": "Mesa 5 - Cortesía", "orders": [ { "product": "507f1f77bcf86cd799439013", "quantity": 1, "complementary": { "isComplementary": true, "note": "Cortesía del chef" } } ] } ``` ### 4. Pedido para entrega (sin mesa) ```json { "group": "507f1f77bcf86cd799439015", "groupName": "Entrega - Cliente Juan", "seller": "507f1f77bcf86cd799439016", "orders": [ { "product": "507f1f77bcf86cd799439013", "quantity": 1, "delivery": { "isDelivery": true, "deliveryProvider": "507f1f77bcf86cd799439017" } } ] } ``` ### 5. Múltiples pedidos en una sola petición ```json { "table": "507f1f77bcf86cd799439014", "group": "507f1f77bcf86cd799439015", "groupName": "Mesa 8 - Familia González", "orders": [ { "product": "507f1f77bcf86cd799439013", "quantity": 2, "unit_price": 15000, "notes": ["Término medio", "Sin mostaza"] }, { "product": "507f1f77bcf86cd799439021", "quantity": 3, "unit_price": 8000, "notes": ["Extra hielo"] }, { "product": "507f1f77bcf86cd799439022", "quantity": 1, "unit_price": 12000, "productsExtra": [ { "product": "507f1f77bcf86cd799439023", "quantity": 2, "price": 2000 } ] }, { "product": "507f1f77bcf86cd799439024", "quantity": 1, "complementary": { "isComplementary": true, "note": "Postre de cumpleaños" } } ] } ``` - [Cancelar o actualizar un pedido](https://developer.loggro.com/reference/actualizarpedido.md): Actualiza los datos de un pedido existente: estado, notas, causa de cancelación, cortesía, cantidad, comensales, entre otros. Este es el endpoint utilizado para **cancelar o anular un pedido**. ## 🚫 Cómo cancelar (o anular) un pedido Cancelar un pedido **no es una ruta aparte**: se hace con este mismo `PUT /orders` cambiando el estado del pedido. Sigue estos pasos: 1. **Obtén el `_id` del pedido** que deseas cancelar (por ejemplo desde `GET /orders`). 2. **Envía el cuerpo de la petición** con: - `_id`: el ID del pedido a cancelar (**obligatorio**). - `status`: `"Cancelada"` (también se acepta el valor equivalente `"Anulada"`). - `causeCancel`: el motivo de la cancelación (opcional pero **recomendado**). 3. **Resultado:** el pedido queda con el nuevo estado y se emite una notificación WebSocket con el evento `orderCancelled` que incluye el producto cancelado, la cantidad, la mesa y el motivo (`causeCancel`) cuando están disponibles. Ejemplo mínimo del cuerpo para cancelar: ```json { "_id": "507f1f77bcf86cd799439011", "status": "Cancelada", "causeCancel": "El cliente cambió de opinión" } ``` > **Nota:** `"Cancelada"` y `"Anulada"` son equivalentes: ambos valores cancelan el > pedido siguiendo exactamente el mismo flujo. Si el `_id` no corresponde a un pedido > del negocio, la respuesta será `404`. **Otros comportamientos:** - Si el pedido se marca como cortesía (`complementary.isComplementary = true`) el precio y total se establecen en 0. - Si `updateDiners` es `true` se actualiza la cantidad de comensales (validada entre 1 y 999) y se registra en el historial. - Si `updateQuantity` es `true` se recalculan los totales de `productsExtra` y `productsCombo` según la nueva cantidad. - Si el estado cambia a "Entregado" se descuenta del inventario. - Cualquier cambio notifica al negocio via WebSocket (`ordersUpdated`). **Autenticación requerida:** Bearer Token en header `Authorization: Bearer {tokenCurrent}` **Permiso requerido:** `OR_PUT` - "Cancelar Pedidos" - [Consultar todos los pedidos](https://developer.loggro.com/reference/consultarpedidos.md): Consulta una lista paginada de todos los pedidos del negocio actual. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` Soporta múltiples filtros para búsqueda específica y paginación para manejo eficiente de grandes volúmenes de datos. **Limitaciones plan trial:** Las cuentas en periodo de prueba solo pueden ver pedidos de las últimas 24 horas. ## Ejemplos de Uso ### 1. Consultar todos los pedidos (primera página) ``` GET /orders?pagination=true&limit=10&page=0 Authorization: Bearer tu_token_aqui ``` Consulta los primeros 10 pedidos ordenados por fecha de creación (más recientes primero). ### 2. Buscar pedidos en espera ``` GET /orders?status=Espera&limit=20 Authorization: Bearer tu_token_aqui ``` Filtra pedidos con estado 'Espera' para procesamiento en cocina. ### 3. Pedidos de una mesa específica ``` GET /orders?tableId=507f1f77bcf86cd799439014&pagination=true Authorization: Bearer tu_token_aqui ``` Consulta todos los pedidos de una mesa específica con paginación. ### 4. Mis pedidos como vendedor ``` GET /orders?onlyMine=true&status=Entregado&limit=50 Authorization: Bearer tu_token_aqui ``` Filtra solo los pedidos del vendedor autenticado que han sido entregados. ### 5. Pedidos por rango de fechas ``` GET /orders?dateInit=2025-08-05T00:00:00.000Z&dateEnd=2025-08-05T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` Consulta pedidos creados en un rango específico de fechas. - [Obtener pedidos en espera del negocio actual](https://developer.loggro.com/reference/obtenerpedidosenespera.md): Retorna todos los pedidos con estado "Espera" del negocio autenticado. Es un alias del endpoint GET /orders con filtro de estado interno para uso en vistas de cocina o pantallas de espera. **Autenticación requerida:** Bearer Token en header `Authorization: Bearer {tokenCurrent}` - [Obtener pedidos de una mesa](https://developer.loggro.com/reference/obtenerpedidospormesa.md): Retorna todos los pedidos asociados a una mesa específica del negocio. Incluye información completa del producto (taxes, stock por ubicación, promos), vendedor e items extras. **Autenticación requerida:** Bearer Token en header `Authorization: Bearer {tokenCurrent}` - [Obtener mesas agrupadas por estado de pedido](https://developer.loggro.com/reference/obtenermesasporestadopedido.md): Retorna una lista de mesas con su total acumulado de pedidos que coinciden con el estado indicado en los últimos 6 meses. Útil para visualizar el resumen de consumo por mesa en un estado específico. **Autenticación requerida:** Bearer Token en header `Authorization: Bearer {tokenCurrent}` - [Obtener grupos de pedidos por estado](https://developer.loggro.com/reference/obtenergruposporestadopedido.md): Retorna los grupos de pedidos (agrupados por `group` y `groupName`) con su total acumulado filtrando por el estado especificado. Solo incluye pedidos de los últimos 6 meses. Opcionalmente se puede filtrar también por mesa. **Autenticación requerida:** Bearer Token en header `Authorization: Bearer {tokenCurrent}` - [Obtener un pedido por ID](https://developer.loggro.com/reference/consultarpedidoporid.md): Retorna el detalle completo de un pedido específico del negocio autenticado. **Autenticación requerida:** Bearer Token en header `Authorization: Bearer {tokenCurrent}` **Permiso requerido:** `OR_GET_ALL` - "Ver todos" - [Mover pedidos a otra mesa](https://developer.loggro.com/reference/moverpedidosamesa.md): Mueve una lista de pedidos existentes a una mesa diferente, asignándoles un nuevo grupo automáticamente. Registra el cambio en el historial y notifica via WebSocket. **Autenticación requerida:** Bearer Token en header `Authorization: Bearer {tokenCurrent}` **Permiso requerido:** `OR_POST_MOVE` - "Mover entre mesas" - [Actualizar múltiples pedidos (cortesías e internos)](https://developer.loggro.com/reference/actualizarpedidosmasivo.md): Actualiza masivamente el estado y datos de una lista de pedidos. Si un pedido se marca como cortesía (`complementary.isComplementary = true`) o interno (`internal.isInternal = true`), su precio y total se establecen en 0 y se descuenta del inventario. Notifica via WebSocket al finalizar. **Autenticación requerida:** Bearer Token en header `Authorization: Bearer {tokenCurrent}` **Permiso requerido:** `OR_PUT_ALL` - "Crear cortesías/Internos" - [Dividir pedidos en unidades individuales](https://developer.loggro.com/reference/dividirpedidos.md): Divide pedidos con cantidad mayor a 1 en pedidos individuales (uno por unidad). El proceso es: 1. Busca los pedidos indicados con cantidad entre 2 y 20 2. Cancela los pedidos originales con causa `"Pedido dividido por: {nombre}"` 3. Crea nuevos pedidos con `quantity: 1` y el total proporcional 4. Los productos extra también se dividen proporcionalmente **Autenticación requerida:** Bearer Token en header `Authorization: Bearer {tokenCurrent}` **Permiso requerido:** `OR_SPLIT` - "Dividir pedidos" - [Obtener pedidos para la pantalla de cocina](https://developer.loggro.com/reference/obtenerpedidosparacocina.md): Retorna los pedidos que deben mostrarse en la pantalla de cocina. Incluye pedidos con estado "Espera" (que no estén terminados en cocina) y pedidos "Cancelada" que estén en estado "Preparando" en cocina. Solo retorna pedidos del último mes. Opcionalmente filtra por área de despacho (`waiterOrderArea`). **Autenticación requerida:** Bearer Token en header `Authorization: Bearer {tokenCurrent}` **Permiso requerido:** `OR_PUT_KITCHEN` - "Pedidos RT" (sin validación explícita de permiso en este endpoint) - [Obtener pedidos en espera para cocina](https://developer.loggro.com/reference/obtenerpedidosenesperacocina.md): Alias del endpoint GET /orders para uso interno desde la pantalla de cocina. Soporta los mismos parámetros de filtrado y paginación que el endpoint principal. No requiere validación de permiso explícita en este endpoint. **Autenticación requerida:** Bearer Token en header `Authorization: Bearer {tokenCurrent}` - [Cambiar estado de cocina de pedidos](https://developer.loggro.com/reference/cambiarestadococinapedidos.md): Actualiza el `statusKitchen` de una lista de pedidos, registrando el historial de cambios de estado con su fecha. Al finalizar todos los cambios, notifica via WebSocket. No requiere validación de permiso explícita; el middleware de autenticación es suficiente. **Autenticación requerida:** Bearer Token en header `Authorization: Bearer {tokenCurrent}` **Permiso requerido:** `OR_PUT_KITCHEN` - "Pedidos RT" (implícito por autenticación) - [Obtener todos los pagos de facturas de inventario](https://developer.loggro.com/reference/consultarpagosinventario.md): Retorna todos los pagos de facturas de inventario del negocio autenticado. Los resultados se ordenan por fecha de creación y tienen un límite de 2000 registros. Incluye información del cuadre de caja (isClosed) de cada pago. **Permiso requerido:** `IY_GET_ALL` - [Crear o actualizar un pago de factura de inventario](https://developer.loggro.com/reference/guardarpagoinventario.md): Registra un pago sobre una factura de inventario. Si el cuerpo contiene `_id`, se actualiza el pago existente; de lo contrario, se crea uno nuevo. **Requisitos:** - El negocio debe tener un **cuadre de caja abierto** al momento de realizar la operación. - Si el cuadre de caja asociado al pago existente está cerrado (`isClosed: true`), la actualización será rechazada. - El sistema valida automáticamente si la factura queda totalmente pagada y actualiza el campo `invoice.isPaid` del movimiento de inventario. **Permiso requerido:** `IY_POST` - [Obtener pagos por movimiento de inventario](https://developer.loggro.com/reference/consultarpagosinventariopormovimiento.md): Retorna todos los pagos de facturas asociados a un movimiento de inventario específico. Los pagos incluyen información del cuadre de caja (estado de cierre y nombre de caja registradora). Solo retorna registros no eliminados (`deleted != true`). **Permiso requerido:** `IY_POST` - [Obtener un pago de factura de inventario por ID](https://developer.loggro.com/reference/consultarpagoinventarioporid.md): Retorna el detalle de un pago de factura de inventario específico, filtrando por el negocio autenticado para garantizar el aislamiento de datos. **Permiso requerido:** `IY_POST` - [Eliminar un pago de factura de inventario](https://developer.loggro.com/reference/eliminarpagoinventario.md): Realiza un borrado lógico (`deleted: true`) del pago de factura de inventario. Después de eliminar, el sistema recalcula automáticamente si la factura del movimiento de inventario queda pagada o no, actualizando el campo `invoice.isPaid`. **Restricciones:** - Si el cuadre de caja asociado al pago está cerrado (`isClosed: true`), la eliminación será rechazada. - Si el pago no existe o no pertenece al negocio autenticado, retorna error 400. **Permiso requerido:** `IY_DELETE` - [Consultar todos los métodos de pago](https://developer.loggro.com/reference/consultarmetodospago.md): Consulta todos los métodos de pago activos del negocio del usuario autenticado. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Ejemplos de uso:** - Consultar todos los métodos de pago: `GET /paymentMethods` - [Crear o actualizar un método de pago](https://developer.loggro.com/reference/guardarmetodopago.md): Crea un nuevo método de pago o actualiza uno existente en el negocio del usuario autenticado. - Si el body **no incluye `_id`**, se **crea** un nuevo método de pago. - Si el body **incluye `_id`**, se **actualiza** el método de pago existente con ese ID. **Permisos requeridos:** `BU_POST` **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` - [Consultar un método de pago por ID](https://developer.loggro.com/reference/consultarmetodopagoporid.md): Retorna un método de pago específico del negocio del usuario autenticado, buscado por su ID. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` - [Eliminar un método de pago](https://developer.loggro.com/reference/eliminarmetodopago.md): Realiza una eliminación lógica (soft delete) del método de pago indicado en el negocio del usuario autenticado. El registro no se borra físicamente de la base de datos, sino que se marca con `deleted: true`. **Permisos requeridos:** `BU_POST` **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` - [Consultar todos los impuestos](https://developer.loggro.com/reference/consultarimpuestos.md): Retorna todos los impuestos activos (no eliminados) del negocio del usuario autenticado, ordenados por nombre. Si el negocio hereda productos del padre, también incluye los impuestos del negocio padre. **Autenticación requerida:** Bearer Token obtenido del campo `tokenCurrent` en el servicio de login. `Authorization: Bearer {tokenCurrent}` - [Crear o editar un impuesto](https://developer.loggro.com/reference/guardarimpuesto.md): Crea un nuevo impuesto o actualiza uno existente según la presencia del campo `_id` en el body. - **Sin `_id`:** Se crea un nuevo impuesto asociado al negocio del usuario autenticado. - **Con `_id`:** Se actualiza el impuesto existente (nombre, porcentaje e integración externa). Solo se puede modificar un impuesto que pertenezca al negocio propio o al negocio padre. **Permiso requerido:** `TX_POST` (Crear/Editar) **Autenticación requerida:** Bearer Token obtenido del campo `tokenCurrent` en el servicio de login. `Authorization: Bearer {tokenCurrent}` - [Consultar un impuesto por ID](https://developer.loggro.com/reference/consultarimpuestoporid.md): Retorna el detalle de un impuesto específico por su ID. Si el negocio hereda productos del padre, también busca en los impuestos del negocio padre. **Permiso requerido:** `TX_POST` (Crear/Editar) **Autenticación requerida:** Bearer Token obtenido del campo `tokenCurrent` en el servicio de login. `Authorization: Bearer {tokenCurrent}` - [Eliminar un impuesto](https://developer.loggro.com/reference/eliminarimpuesto.md): Realiza una eliminación lógica del impuesto (marca el campo `deleted` como `true`). **Restricciones:** - No se puede eliminar un impuesto si hay productos asociados a él (en `locationsStock.tax` o `locationsStock.taxes.tax`). - Solo se puede eliminar un impuesto que pertenezca al negocio propio del usuario. **Permiso requerido:** `TX_DELETE` (Eliminar) **Autenticación requerida:** Bearer Token obtenido del campo `tokenCurrent` en el servicio de login. `Authorization: Bearer {tokenCurrent}` - [Consultar todos los productos](https://developer.loggro.com/reference/consultarproductos.md): Consulta todos los productos activos del negocio del usuario autenticado. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Ejemplos de uso:** - Consultar todos los productos: `GET /products` - Con paginación: `GET /products?pagination=true&limit=10&page=0` - Filtrar por categoría: `GET /products?categoryId=507f1f77bcf86cd799439013` - Buscar por nombre: `GET /products?name=Hamburguesa` - Incluir ingredientes: `GET /products?includeIngredients=true` - Productos para Rappi: `GET /products?useInRappi=true` - Tipos específicos: `GET /products?types=Combo,Subproducto` - Combinado: `GET /products?pagination=true&limit=20&page=1&categoryId=123&name=Pizza&useInRappi=true` - [Crear o editar un producto](https://developer.loggro.com/reference/guardarproducto.md): Crea un nuevo producto o actualiza uno existente si se envía `_id`. Puede incluir subproductos, ingredientes, configuración de combo y configuración por ubicación. **Autenticación requerida:** Bearer Token. - [Consultar productos por categoría](https://developer.loggro.com/reference/consultarproductosporcategoria.md): Consulta los productos activos de una categoría específica del negocio del usuario autenticado. Excluye ingredientes y subproductos. **Autenticación requerida:** Bearer Token. - [Consultar productos y subproductos](https://developer.loggro.com/reference/consultarproductosysubproductos.md): Consulta productos (y opcionalmente subproductos) con filtros por tipo, categoría o datos del producto. Soporta paginación. **Autenticación requerida:** Bearer Token. - [Guardar menú de proveedor externo](https://developer.loggro.com/reference/guardarmenuproveedorexterno.md): Guarda el menú de un proveedor externo (por ejemplo, DomiPirPos o UberEats). Si el `source` es UberEats, intenta sincronizar con mipOS. **Autenticación requerida:** Bearer Token. - [Consultar menú de proveedor externo](https://developer.loggro.com/reference/consultarmenuproveedorexterno.md): Obtiene el menú configurado para un proveedor externo específico. **Autenticación requerida:** Bearer Token. - [Guardar configuración por ubicación de stock](https://developer.loggro.com/reference/guardarconfiguracionubicacionstock.md): Actualiza la configuración específica de un producto en una ubicación de stock. **Autenticación requerida:** Bearer Token. - [Subir imagen de producto](https://developer.loggro.com/reference/subirimagenproducto.md): Sube una imagen para un producto y actualiza el campo `urlImage`. **Autenticación requerida:** Bearer Token. - [Cargar productos desde Excel](https://developer.loggro.com/reference/cargarproductosexcel.md): Carga masiva de productos a partir de un archivo Excel. El proceso es asíncrono y se notifica por correo al finalizar. **Autenticación requerida:** Bearer Token. - [Convertir producto en subproducto](https://developer.loggro.com/reference/convertirproductoasubproducto.md): Convierte un producto existente en subproducto de otro producto. **Autenticación requerida:** Bearer Token. - [Consultar producto por ID](https://developer.loggro.com/reference/consultarproductoporid.md): Consulta el detalle de un producto por su ID. **Autenticación requerida:** Bearer Token. - [Eliminar un producto](https://developer.loggro.com/reference/eliminarproducto.md): Marca un producto como eliminado (soft delete). Si es subproducto, también actualiza el padre. **Autenticación requerida:** Bearer Token. - [Guardar precios/configuración por ubicación de stock](https://developer.loggro.com/reference/guardarpreciosconfiguracionubicacionstock.md): Actualiza precios, impuestos, promociones y configuración por ubicación de stock. **Autenticación requerida:** Bearer Token. - [Verificar herencia de productos en negocios hijos](https://developer.loggro.com/reference/verificarherenciaproductos.md): Verifica y actualiza la herencia de productos en negocios hijos cuando aplica. **Autenticación requerida:** Bearer Token. - [Consultar las ventas por facturas](https://developer.loggro.com/reference/reporteventasporfacturas.md): Consulta un reporte detallado de ventas basado en las facturas generadas en un período específico. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Suscripción Premium requerida:** Este endpoint requiere una suscripción premium activa. **Características del reporte:** - Lista todas las facturas en estado "Pagada" - Soporta filtrado por fechas, métodos de pago, clientes, etc. - Incluye información detallada de productos, impuestos y descuentos - Datos de entrega a domicilio y repartidores - Información de facturación electrónica (DIAN) - Integración con sistemas contables (Siigo, Loggro) **Uso típico para reportes:** - Análisis de ventas diarias, semanales o mensuales - Seguimiento de performance por método de pago - Análisis de entrega a domicilio vs mesa - Reportes para contabilidad y auditoría - Control de facturación electrónica * ## Ejemplos de uso: ### 1. Reporte de ventas del día actual Consultar todas las ventas (facturas pagadas) del día actual: ``` GET /reports/reportSalesInvoices?dateInit=2025-08-06T00:00:00.000Z&dateEnd=2025-08-06T23:59:59.999Z&status=Pagada Authorization: Bearer tu_token_aqui ``` ### 2. Reporte básico con parámetros mínimos requeridos Ejemplo mínimo funcional para Consultar facturas pagadas del último mes: ``` GET /reports/reportSalesInvoices?status=Pagada Authorization: Bearer tu_token_aqui ``` ### 3. Reporte con paginación limitada Consultar las primeras 50 facturas de la semana actual con paginación: ``` GET /reports/reportSalesInvoices?limit=50&page=0&dateInit=2025-08-01T00:00:00.000Z&dateEnd=2025-08-07T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` ### 4. Reporte de ventas por método de pago Analizar ventas por método de pago específico en el último mes: ``` GET /reports/reportSalesInvoices?paymentMethodName=Efectivo&dateInit=2025-07-06T00:00:00.000Z&dateEnd=2025-08-06T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` ### 5. Reporte de ventas a domicilio Analizar performance de entrega a domicilio en la última semana: ``` GET /reports/reportSalesInvoices?onlyDelivery=true&dateInit=2025-07-30T00:00:00.000Z&dateEnd=2025-08-06T23:59:59.999Z&limit=200 Authorization: Bearer tu_token_aqui ``` ### 6. Reporte de facturación electrónica Revisar estado de facturas electrónicas para contabilidad: ``` GET /reports/reportSalesInvoices?type=FacturaElectronica&statusFE=00&dateInit=2025-08-01T00:00:00.000Z&dateEnd=2025-08-06T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` ### 7. Reporte de ventas por cajero Evaluar performance de ventas por cajero específico: ``` GET /reports/reportSalesInvoices?cashierId=507f1f77bcf86cd799439015&dateInit=2025-08-01T00:00:00.000Z&dateEnd=2025-08-06T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` - [Consultar las ventas agrupadas por categorías](https://developer.loggro.com/reference/reporteventasporcategoria.md): Genera un reporte agregado de ventas organizadas por categorías de productos en un período específico. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Suscripción Premium requerida:** Este endpoint requiere una suscripción premium activa. **Características del reporte:** - Agrupa ventas por categorías de productos - Calcula totales brutos, descuentos e impuestos por categoría - Incluye desglose detallado de impuestos por tipo - Solo incluye facturas en estado "Pagada" - Excluye facturas eliminadas - Resultados ordenados alfabéticamente por nombre de categoría **Métricas incluidas:** - Total bruto por categoría - Total de descuentos aplicados - Total de impuestos por tipo - Total neto final - Desglose detallado de cada impuesto **Casos de uso:** - Análisis de performance por categoría de producto - Identificación de categorías más rentables - Reportes de impuestos por categoría - Análisis de tendencias de venta por tipo de producto - Toma de decisiones sobre mix de productos ## Ejemplos de uso: ### 1. Reporte básico de categorías con parámetros requeridos Ejemplo mínimo funcional con solo los parámetros obligatorios: ``` GET /reports/reportSalesByCategory?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` ### 2. Reporte de categorías del mes actual Analizar performance de categorías en el mes de agosto: ``` GET /reports/reportSalesByCategory?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` ### 3. Reporte de categorías de la última semana Análisis semanal de performance por categoría: ``` GET /reports/reportSalesByCategory?dateInitISO=2025-07-30T00:00:00.000Z&dateEndISO=2025-08-06T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` ### 4. Reporte de categorías del día actual Análisis diario de ventas por categoría: ``` GET /reports/reportSalesByCategory?dateInitISO=2025-08-06T00:00:00.000Z&dateEndISO=2025-08-06T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` ### 5. Análisis trimestral por categorías Reporte consolidado de tres meses para análisis de tendencias: ``` GET /reports/reportSalesByCategory?dateInitISO=2025-05-01T00:00:00.000Z&dateEndISO=2025-08-06T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` ### 6. Reporte de categorías para período específico de negocio Análisis de fin de semana (viernes a domingo) para categorías de productos: ``` GET /reports/reportSalesByCategory?dateInitISO=2025-08-02T00:00:00.000Z&dateEndISO=2025-08-04T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` - [Consultar las ventas detallado por productos](https://developer.loggro.com/reference/reporteventasporproducto.md): Genera un reporte detallado de ventas organizadas por productos individuales en un período específico. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Suscripción Premium requerida:** Este endpoint requiere una suscripción premium activa. **Características del reporte:** - Desglose detallado por producto individual - Información de cantidades vendidas y precios - Datos financieros completos (bruto, descuentos, impuestos, total) - Información de vendedores y cajeros - Datos de facturación y métodos de pago - Información de entrega a domicilio cuando aplique - Cálculo de costos promedio y promociones aplicadas **Opciones de agrupación:** - Vista detallada: Cada línea de producto por factura - Vista agrupada: Totales consolidados por producto (usar groupResult=true) **Casos de uso:** - Análisis de performance de productos específicos - Seguimiento de vendedores por producto - Control de inventario basado en ventas - Análisis de rentabilidad por producto - Reportes de comisiones por vendedor - Optimización de mix de productos ## Ejemplos de uso: ### 1. Reporte básico de productos con parámetros requeridos Ejemplo mínimo funcional con solo los parámetros obligatorios: ``` GET /reports/reportSalesByProduct?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` ### 2. Reporte detallado de productos del mes Vista línea por línea de todas las ventas de productos en agosto: ``` GET /reports/reportSalesByProduct?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z&status=Pagada Authorization: Bearer tu_token_aqui ``` ### 3. Reporte consolidado por productos Vista agrupada con totales por producto para análisis de performance: ``` GET /reports/reportSalesByProduct?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-06T23:59:59.999Z&groupResult=true Authorization: Bearer tu_token_aqui ``` ### 4. Análisis de productos con combos incluidos Reporte incluyendo productos que forman parte de combos: ``` GET /reports/reportSalesByProduct?dateInitISO=2025-08-06T00:00:00.000Z&dateEndISO=2025-08-06T23:59:59.999Z&showProductCombo=true Authorization: Bearer tu_token_aqui ``` ### 5. Reporte de productos por vendedor Análisis detallado para evaluación de comisiones y performance: ``` GET /reports/reportSalesByProduct?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-06T23:59:59.999Z&status=Pagada Authorization: Bearer tu_token_aqui ``` ### 6. Análisis multi-negocio Reporte consolidado de productos para usuarios con múltiples negocios: ``` GET /reports/reportSalesByProduct?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-06T23:59:59.999Z&allBusiness=true&groupResult=true Authorization: Bearer tu_token_aqui ``` ### 7. Reporte de productos del día para análisis rápido Vista diaria consolidada para revisión rápida de performance: ``` GET /reports/reportSalesByProduct?dateInitISO=2025-08-22T00:00:00.000Z&dateEndISO=2025-08-22T23:59:59.999Z&groupResult=true&status=Pagada Authorization: Bearer tu_token_aqui ``` - [Reporte de compras de inventario](https://developer.loggro.com/reference/reportecomprasinventario.md): Genera un reporte de todas las compras de inventario (entradas de tipo 1) realizadas en un período específico. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Suscripción Premium requerida:** Este endpoint requiere una suscripción premium activa. **Características del reporte:** - Lista los movimientos de inventario de tipo "Compra" (type: 1) - Incluye información del proveedor asociado - Detalle de ingredientes/insumos comprados con cantidad y precio - Información del negocio y datos de factura - Pagos de facturas de compra (ivp) - Soporte para usuarios con múltiples negocios **Casos de uso:** - Control de compras a proveedores - Análisis de costos de inventario - Cuentas por pagar a proveedores - Auditoría de movimientos de inventario entrantes ## Ejemplos de uso: ### 1. Compras del mes actual ``` GET /reports/reportPurchase?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` ### 2. Compras de todos los negocios del usuario ``` GET /reports/reportPurchase?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z&allBusiness=true Authorization: Bearer tu_token_aqui ``` - [Reporte de producciones de inventario](https://developer.loggro.com/reference/reporteproducciones.md): Genera un reporte de los movimientos de producción realizados sobre el inventario en un período específico. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Suscripción Premium requerida:** Este endpoint requiere una suscripción premium activa. **Características del reporte:** - Lista los movimientos de inventario de tipo "Producción" - Detalle de ingredientes/insumos utilizados con cantidades - Agrupación opcional por ingrediente (vista consolidada) - Soporte para usuarios con múltiples negocios **Casos de uso:** - Control de consumo de insumos en producción - Análisis de eficiencia productiva - Seguimiento de recetas y procesos de elaboración ## Ejemplos de uso: ### 1. Producciones del mes ``` GET /reports/reportProduction?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` ### 2. Producciones agrupadas por ingrediente ``` GET /reports/reportProduction?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z&groupResult=true Authorization: Bearer tu_token_aqui ``` - [Reporte de traslados de inventario entre ubicaciones](https://developer.loggro.com/reference/reportetraslados.md): Genera un reporte de los movimientos de traslado de inventario (tipo 8) entre ubicaciones de stock en un período específico. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Suscripción Premium requerida:** Este endpoint requiere una suscripción premium activa. **Características del reporte:** - Lista traslados entre ubicaciones de stock (type: 8) - Detalle de ingrediente trasladado, cantidad, ubicación origen y destino - Información del usuario que realizó el traslado - Agrupación opcional por ingrediente y usuario (vista consolidada) - Soporte para usuarios con múltiples negocios **Casos de uso:** - Control de movimientos entre sedes o puntos de venta - Auditoría de traslados de inventario - Análisis de flujo de insumos entre ubicaciones ## Ejemplos de uso: ### 1. Traslados del mes ``` GET /reports/reportTransfers?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` ### 2. Traslados agrupados por ingrediente ``` GET /reports/reportTransfers?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z&groupResult=true Authorization: Bearer tu_token_aqui ``` - [Reporte de mermas de inventario](https://developer.loggro.com/reference/reportemermas.md): Genera un reporte de las mermas (pérdidas o desperdicios) registradas en el inventario durante un período específico. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Suscripción Premium requerida:** Este endpoint requiere una suscripción premium activa. **Características del reporte:** - Lista los movimientos de inventario clasificados como merma - Detalle de ingrediente/insumo, cantidad perdida y precio - Notas explicativas de la merma - Agrupación opcional por ingrediente con totales de cantidad y valor - Soporte para usuarios con múltiples negocios **Casos de uso:** - Control de pérdidas de inventario - Análisis de desperdicios por ingrediente - Auditoría de mermas para ajuste de costos - Identificación de insumos con mayor desperdicio ## Ejemplos de uso: ### 1. Mermas del mes actual ``` GET /reports/reportShrinkage?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` ### 2. Mermas agrupadas por ingrediente ``` GET /reports/reportShrinkage?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z&groupResult=true Authorization: Bearer tu_token_aqui ``` - [Reporte de gastos del negocio](https://developer.loggro.com/reference/reportegastos.md): Consulta todos los gastos registrados en el negocio para un período específico. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Suscripción Premium requerida:** Este endpoint requiere una suscripción premium activa. **Características del reporte:** - Lista todos los gastos no eliminados del negocio - Incluye información del tipo de gasto, usuario pagado y proveedor - Detalle de subtotal, impuestos y totales - Información de caja registradora asociada - Límite de 2000 registros por consulta - Soporte para usuarios con múltiples negocios **Casos de uso:** - Control de gastos operativos del negocio - Análisis de egresos por período - Reportes de pagos a proveedores - Revisión de gastos por tipo para contabilidad ## Ejemplos de uso: ### 1. Gastos del mes actual ``` GET /reports/reportExpenses?dateInit=2025-08-01T00:00:00.000Z&dateEnd=2025-08-31T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` ### 2. Gastos de todos los negocios ``` GET /reports/reportExpenses?dateInit=2025-08-01T00:00:00.000Z&dateEnd=2025-08-31T23:59:59.999Z&allBusiness=true Authorization: Bearer tu_token_aqui ``` - [Reporte de utilidad (ventas con costos)](https://developer.loggro.com/reference/reporteutilidad.md): Genera un reporte detallado de ventas por producto incluyendo costos promedios para calcular utilidad. Combina información de ventas con costos de inventario para análisis de rentabilidad. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Suscripción Premium requerida:** Este endpoint requiere una suscripción premium activa. **Características del reporte:** - Misma estructura que el reporte de ventas por producto - Incluye costo promedio (avgCost) por producto para calcular margen - Permite calcular utilidad bruta = totalBruto - (avgCost × quantity) - Agrupación opcional por producto para análisis consolidado - Soporte para usuarios con múltiples negocios **Casos de uso:** - Análisis de rentabilidad por producto - Identificación de productos con mayor y menor margen - Toma de decisiones sobre precios y mix de productos - Reportes financieros para gerencia ## Ejemplos de uso: ### 1. Utilidad del mes agrupada por producto ``` GET /reports/reportUtility?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z&groupResult=true Authorization: Bearer tu_token_aqui ``` ### 2. Utilidad detallada por producto ``` GET /reports/reportUtility?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` - [Reporte de utilidad agrupado por tipos de gasto](https://developer.loggro.com/reference/reporteutilidadportiposgasto.md): Genera un reporte de gastos agrupados por tipo de gasto para el análisis de utilidad del negocio. Se utiliza junto con el reporte de ventas para calcular la utilidad neta del período. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Características del reporte:** - Agrupa los gastos del período por tipo de gasto - Calcula subtotales e impuestos por tipo - Soporte para usuarios con múltiples negocios - Permite identificar los tipos de gasto más representativos **Casos de uso:** - Cálculo de utilidad neta (Ventas - Costos - Gastos) - Análisis de estructura de costos operativos - Comparación de gastos por categoría entre períodos ## Ejemplos de uso: ### 1. Gastos agrupados por tipo del mes ``` GET /reports/reportUtilityGroupTypes?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` ### 2. Gastos de todos los negocios agrupados por tipo ``` GET /reports/reportUtilityGroupTypes?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z&allBusiness=true Authorization: Bearer tu_token_aqui ``` - [Reporte de utilidad agrupado por proveedor de entrega](https://developer.loggro.com/reference/reporteutilidadporproveedorentrega.md): Genera un reporte de ventas a domicilio agrupadas y totalizadas por proveedor de entrega (RAPPI, Uber Eats, Didi Food, Interno, etc.). **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Características del reporte:** - Solo incluye facturas con entrega a domicilio (`delivery.isDelivery: true`) - Solo facturas en estado "Pagada" - Agrupa y totaliza por proveedor de entrega - Útil para comparar performance entre canales de delivery - Soporte para usuarios con múltiples negocios **Casos de uso:** - Análisis de rentabilidad por canal de delivery - Comparación de comisiones vs ingresos por proveedor - Decisiones sobre alianzas con plataformas de entrega - Reporte de ventas por canal para gerencia ## Ejemplos de uso: ### 1. Utilidad por proveedor de entrega del mes ``` GET /reports/reportUtilityDeliveryProvider?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` ### 2. Utilidad multi-negocio por proveedor de entrega ``` GET /reports/reportUtilityDeliveryProvider?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z&allBusiness=true Authorization: Bearer tu_token_aqui ``` - [Dashboard completo de estadísticas](https://developer.loggro.com/reference/getdashboard.md): Retorna un resumen completo del dashboard de estadísticas del negocio. **Permiso requerido:** `ST_GET_DASHBOARD` **Autenticación requerida:** Bearer Token obtenido del servicio `/login` (`Authorization: Bearer {tokenCurrent}`) Para cuentas **gratuitas** devuelve: total facturas caja actual, últimos pedidos, total facturas hoy y últimos 7 días. Para cuentas **premium** devuelve adicionalmente: últimos 30 días, año actual, pedidos de hoy por horas, últimos 7 días por días, mes por productos, año por mes, mes por vendedor y últimas 24h por horas. - [Dashboard completo de estadísticas v2](https://developer.loggro.com/reference/getdashboardv2.md): Igual que `/stats/admin` pero utiliza el controlador v2 para el total de facturas del año actual y el total de facturas del año por mes. **Permiso requerido:** `ST_GET_DASHBOARD` **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Total de facturas en la caja actual](https://developer.loggro.com/reference/gettotalinvoicescurrentcashbox.md): Obtiene el total de ventas/facturas registradas en la caja registradora actualmente abierta por el usuario autenticado. **Permiso requerido:** `ST_GET_DASHBOARD` **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Últimos pedidos del negocio](https://developer.loggro.com/reference/getlastorders.md): Retorna los últimos pedidos realizados en el negocio del usuario autenticado. **Permiso requerido:** `ST_GET_DASHBOARD` **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Total de facturas del día de hoy](https://developer.loggro.com/reference/gettotalinvoicestoday.md): Retorna el total de ventas/facturas generadas en el día de hoy para el negocio del usuario autenticado. **Permiso requerido:** `ST_GET_DASHBOARD` **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Total de facturas de los últimos 7 días](https://developer.loggro.com/reference/gettotalinvoiceslast7days.md): Retorna el total de ventas/facturas generadas en los últimos 7 días para el negocio del usuario autenticado. **Permiso requerido:** `ST_GET_DASHBOARD` **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Total de facturas de los últimos 30 días (premium)](https://developer.loggro.com/reference/gettotalinvoiceslast30days.md): Retorna el total de ventas/facturas de los últimos 30 días. **Permiso requerido:** `ST_GET_DASHBOARD` **Requiere plan premium.** Las cuentas gratuitas no tendrán acceso a este endpoint. **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Total de facturas del año actual (premium)](https://developer.loggro.com/reference/gettotalinvoicescurrentyear.md): Retorna el total de ventas/facturas acumuladas en el año en curso. **Permiso requerido:** `ST_GET_DASHBOARD` **Requiere plan premium.** **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Total de facturas del año actual v2 (premium)](https://developer.loggro.com/reference/gettotalinvoicescurrentyearv2.md): Versión 2 del cálculo del total de facturas del año actual. Utiliza el controlador v2 de estadísticas para un cálculo optimizado. **Permiso requerido:** `ST_GET_DASHBOARD` **Requiere plan premium.** **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Pedidos de hoy agrupados por hora (premium)](https://developer.loggro.com/reference/gettotalorderstodaybyhours.md): Retorna el total de pedidos del día de hoy agrupados por cada hora del día. útil para identificar los picos de demanda durante el día. **Permiso requerido:** `ST_GET_DASHBOARD` **Requiere plan premium.** **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Facturas de los últimos 7 días agrupadas por día (premium)](https://developer.loggro.com/reference/gettotalinvoiceslast7daysbydays.md): Retorna el total de ventas/facturas de los últimos 7 días, agrupadas por cada día. Útil para visualizar la tendencia de ventas de la semana. **Permiso requerido:** `ST_GET_DASHBOARD` **Requiere plan premium.** **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Pedidos del mes actual agrupados por producto (premium)](https://developer.loggro.com/reference/gettotalorderscurrentmonthbyproducts.md): Retorna el total de pedidos del mes actual agrupados por producto. Útil para identificar los productos más vendidos del mes. **Permiso requerido:** `ST_GET_DASHBOARD` **Requiere plan premium.** **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Facturas del año actual agrupadas por mes (premium)](https://developer.loggro.com/reference/gettotalinvoicescurrentyearbymonth.md): Retorna el total de ventas/facturas del año actual agrupadas por mes. Útil para visualizar la tendencia mensual de ventas en el año. **Permiso requerido:** `ST_GET_DASHBOARD` **Requiere plan premium.** **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Facturas del año actual agrupadas por mes v2 (premium)](https://developer.loggro.com/reference/gettotalinvoicescurrentyearbymonthv2.md): Versión 2 del cálculo de facturas del año actual agrupadas por mes. Utiliza el controlador v2 para un cálculo optimizado. **Permiso requerido:** `ST_GET_DASHBOARD` **Requiere plan premium.** **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Pedidos del mes actual agrupados por vendedor (premium)](https://developer.loggro.com/reference/gettotalorderscurrentmonthbyseller.md): Retorna el total de pedidos del mes actual agrupados por vendedor/usuario. Útil para evaluar el rendimiento del equipo de ventas en el mes. **Permiso requerido:** `ST_GET_DASHBOARD` **Requiere plan premium.** **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Pedidos de las últimas 24 horas agrupados por hora (premium)](https://developer.loggro.com/reference/gettotalorderslast24hoursbyhours.md): Retorna el total de pedidos de las últimas 24 horas agrupados por cada hora. Útil para monitorear la actividad reciente del negocio. **Permiso requerido:** `ST_GET_DASHBOARD` **Requiere plan premium.** **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Total de facturas agrupadas por meses (premium)](https://developer.loggro.com/reference/gettotalinvoicesbymonths.md): Retorna el total de ventas/facturas agrupadas por mes en un rango de fechas dado. **Permiso requerido:** `ST_GET_SALES` **Requiere plan premium.** Las cuentas gratuitas recibirán error 401. **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Total de facturas agrupadas por días](https://developer.loggro.com/reference/gettotalinvoicesbydays.md): Retorna el total de ventas/facturas agrupadas por día en un rango de fechas dado. **Permiso requerido:** `ST_GET_SALES` Las cuentas **gratuitas** solo pueden consultar los últimos 30 días. Si `dateInitISO` es anterior a 30 días atrás se retorna error 401. **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Total de facturas agrupadas por mesa (premium)](https://developer.loggro.com/reference/gettotalinvoicesbytables.md): Retorna el total de ventas/facturas agrupadas por mesa en un rango de fechas dado. Útil para analizar qué mesas generan más ventas. **Permiso requerido:** `ST_GET_TABLES` **Requiere plan premium.** **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Total de facturas agrupadas por método de pago (premium)](https://developer.loggro.com/reference/gettotalinvoicesbypaymentmethodpaid.md): Retorna el total de ventas/facturas agrupadas por método de pago en un rango de fechas. Útil para analizar qué formas de pago prefieren los clientes. **Permiso requerido:** `ST_GET_PAYMENT_METHOD` **Requiere plan premium.** **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Total de facturas agrupadas por producto (premium)](https://developer.loggro.com/reference/gettotalinvoicesbyproducts.md): Retorna el total de ventas/facturas agrupadas por producto en un rango de fechas. Útil para identificar los productos más vendidos en un periodo. **Permiso requerido:** `ST_GET_PRODUCTS` **Requiere plan premium.** **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Total de facturas agrupadas por vendedor (premium)](https://developer.loggro.com/reference/gettotalinvoicesbysellers.md): Retorna el total de ventas/facturas agrupadas por vendedor/usuario en un rango de fechas. Útil para medir el rendimiento de cada miembro del equipo de ventas. **Permiso requerido:** `ST_GET_SELLERS` **Requiere plan premium.** **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Pedidos agrupados por hora del día (premium)](https://developer.loggro.com/reference/gettotalordersgroupbyhours.md): Retorna el total de pedidos agrupados por hora del día en un rango de fechas. Útil para identificar las horas pico de demanda del negocio. **Permiso requerido:** `ST_GET_ORDERS_HOURS` **Requiere plan premium.** **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Pedidos agrupados por día de la semana (premium)](https://developer.loggro.com/reference/gettotalordersgroupbydays.md): Retorna el total de pedidos agrupados por día de la semana en un rango de fechas. Útil para identificar qué días de la semana son más concurridos. **Permiso requerido:** `ST_GET_ORDERS_DAYS` **Requiere plan premium.** **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Total de facturas agrupadas por proveedor de domicilio (premium)](https://developer.loggro.com/reference/gettotalinvoicesbydeliveryproviders.md): Retorna el total de ventas/facturas agrupadas por proveedor de domicilio en un rango de fechas. Útil para comparar el rendimiento de cada plataforma de delivery (Rappi, iFood, etc.). **Permiso requerido:** `ST_GET_DELIVERY_PROVIDER` **Requiere plan premium.** **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Tiempo promedio de entrega de repartidores (premium)](https://developer.loggro.com/reference/getavgtimedeliveryguydelivered.md): Retorna el tiempo promedio de entrega de los repartidores en un rango de fechas. Útil para medir la eficiencia del servicio de domicilios. **Permiso requerido:** `ST_GET_AVG_DG` **Requiere plan premium.** **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [(PirPos SuperAdmin) Total de facturas por mes de toda la plataforma](https://developer.loggro.com/reference/getpptotalinvoicesbymonths.md): Retorna el total de ventas/facturas de toda la plataforma PirPos agrupadas por mes. **Acceso exclusivo:** Solo SuperAdmins de PirPos. Requiere el middleware `middlewarePirPosSuperAdmin`. **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [(PirPos SuperAdmin) Total de facturas por día de toda la plataforma](https://developer.loggro.com/reference/getpptotalinvoicesbydays.md): Retorna el total de ventas/facturas de toda la plataforma PirPos agrupadas por día. **Acceso exclusivo:** Solo SuperAdmins de PirPos. Requiere el middleware `middlewarePirPosSuperAdmin`. **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Total de ventas agrupadas por facturador](https://developer.loggro.com/reference/gettotalsalesbybiller.md): Retorna el total de ventas agrupadas por el usuario que realizó la facturación en un rango de fechas dado. **Permiso requerido:** `ST_GET_SALES` **Autenticación requerida:** Bearer Token obtenido del servicio `/login` - [Obtiene todas las mesas activas del negocio](https://developer.loggro.com/reference/consultarmesas.md) - [Crea o edita una mesa](https://developer.loggro.com/reference/guardarmesa.md): Si se envía `_id` en el cuerpo, actualiza la mesa existente. Si no se envía `_id`, crea una nueva mesa. Requiere el permiso **TA_POST** (Crear/Editar). - [Obtiene mesas activas con sus órdenes en espera y facturas pendientes](https://developer.loggro.com/reference/consultarmesasconordenes.md): Retorna todas las mesas activas (`isActive: true`, `deleted != true`) del negocio, incluyendo las órdenes en estado "Espera" con su total acumulado y las facturas en estado "Facturada" asociadas a cada mesa. - [Obtiene una mesa por su ID](https://developer.loggro.com/reference/consultarmesaporid.md) - [Elimina (soft delete) una mesa por su ID](https://developer.loggro.com/reference/eliminarmesa.md): Marca la mesa como eliminada (`deleted: true`) sin borrarla de la base de datos. Requiere el permiso **TA_DELETE** (Eliminar). - [Consultar unidades](https://developer.loggro.com/reference/consultarunidades.md): Retorna todas las unidades activas del negocio (incluye negocio padre si aplica). **Autenticación requerida:** Bearer Token. - [Crear o editar una unidad](https://developer.loggro.com/reference/guardarunidad.md): Crea una nueva unidad o actualiza una existente si se envía `_id`. **Autenticación requerida:** Bearer Token. - [Consultar unidad por ID](https://developer.loggro.com/reference/consultarunidadporid.md): Obtiene el detalle de una unidad por su ID. **Autenticación requerida:** Bearer Token. - [Eliminar unidad](https://developer.loggro.com/reference/eliminarunidad.md): Marca la unidad como eliminada (soft delete). **Autenticación requerida:** Bearer Token. - [Consultar proveedores](https://developer.loggro.com/reference/consultarproveedores.md): Retorna todos los proveedores activos del negocio. **Autenticación requerida:** Bearer Token. - [Crear o editar proveedor](https://developer.loggro.com/reference/guardarproveedor.md): Crea un proveedor o actualiza uno existente si se envía `_id`. **Autenticación requerida:** Bearer Token. - [Consultar proveedor por ID](https://developer.loggro.com/reference/consultarproveedorporid.md): Obtiene el detalle de un proveedor por su ID. **Autenticación requerida:** Bearer Token. - [Eliminar proveedor](https://developer.loggro.com/reference/eliminarproveedor.md): Marca el proveedor como eliminado (soft delete). **Autenticación requerida:** Bearer Token. - [Consultar gastos](https://developer.loggro.com/reference/consultargastos.md): Consulta los gastos del negocio con filtros por fecha y negocio. **Autenticación requerida:** Bearer Token. - [Crear o editar gasto](https://developer.loggro.com/reference/guardargasto.md): Crea un gasto o actualiza uno existente si se envía `_id`. Requiere caja activa. **Autenticación requerida:** Bearer Token. - [Eliminar gasto](https://developer.loggro.com/reference/eliminargasto.md): Marca el gasto como eliminado (soft delete). **Autenticación requerida:** Bearer Token. - [Consultar tipos de gasto](https://developer.loggro.com/reference/consultartiposgasto.md): Retorna todos los tipos de gasto activos del negocio. **Autenticación requerida:** Bearer Token. - [Crear o editar tipo de gasto](https://developer.loggro.com/reference/guardartipogasto.md): Crea un tipo de gasto o actualiza uno existente si se envía `_id`. **Autenticación requerida:** Bearer Token. - [Consultar tipo de gasto por ID](https://developer.loggro.com/reference/consultartipogastoporid.md): Obtiene el detalle de un tipo de gasto por su ID. **Autenticación requerida:** Bearer Token. - [Eliminar tipo de gasto](https://developer.loggro.com/reference/eliminartipogasto.md): Marca el tipo de gasto como eliminado (soft delete). **Autenticación requerida:** Bearer Token. - [Consultar cajas registradoras](https://developer.loggro.com/reference/consultarcajasregistradoras.md): Retorna todas las cajas registradoras activas (no eliminadas) del negocio del usuario autenticado. El límite de resultados es de 2000 registros. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Ejemplos de uso:** - Consultar todas las cajas: `GET /cashRegisters` - [Crear o editar caja registradora](https://developer.loggro.com/reference/guardarcajaregistradora.md): Crea una nueva caja registradora o actualiza una existente. Si el cuerpo incluye el campo `_id` con un ID válido del negocio, se actualizan los campos `serial` y `cashLocation`. De lo contrario, se crea un nuevo registro. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` - [Consultar caja registradora por ID](https://developer.loggro.com/reference/consultarcajaregistradoraporid.md): Retorna los detalles de una caja registradora específica a partir de su ID, siempre que pertenezca al negocio del usuario autenticado. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Ejemplos de uso:** - Consultar caja por ID: `GET /cashRegisters/507f1f77bcf86cd799439011` - [Eliminar caja registradora](https://developer.loggro.com/reference/eliminarcajaregistradora.md): Realiza un borrado lógico de la caja registradora (marca el campo `deleted` en `true`). La caja debe pertenecer al negocio del usuario autenticado. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` - [Consultar cuadres de caja](https://developer.loggro.com/reference/consultarcuadrescaja.md): Consulta la lista de cuadres de caja del negocio actual, con soporte de filtros y paginación. **Autenticación requerida:** Este endpoint requiere autenticación Bearer Token. Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header: `Authorization: Bearer {tokenCurrent}` **Permiso requerido:** `CB_GET_ALL` - "Listar todos" **Reglas de negocio según el plan:** - **Negocios no premium:** solo se retorna el último cuadre de caja (limit forzado a 1, count = 1). - **Cuentas en periodo de prueba (trial):** solo se muestran cuadres de las últimas 24 horas. - **Negocios premium:** acceso completo a todos los cuadres con filtros y paginación. Los resultados se ordenan por fecha de apertura descendente (`-dateStart`, los más recientes primero). ## Ejemplos de Uso ### 1. Listar cuadres con paginación ``` GET /cashbox?pagination=true&limit=20&page=0 Authorization: Bearer tu_token_aqui ``` Retorna un objeto `{ data, count }` con los primeros 20 cuadres. ### 2. Listar solo cuadres abiertos ``` GET /cashbox?status=open Authorization: Bearer tu_token_aqui ``` ### 3. Cuadres de un cajero en un rango de fechas ``` GET /cashbox?cashierId=507f1f77bcf86cd799439014&dateInit=2025-08-01T00:00:00.000Z&dateEnd=2025-08-31T23:59:59.999Z Authorization: Bearer tu_token_aqui ``` - [Consultar promociones](https://developer.loggro.com/reference/consultarpromociones.md): Retorna todas las promociones activas (no eliminadas) del negocio del usuario autenticado, ordenadas por nombre. Si el negocio hereda productos del padre y tiene `inheritParentsProducts` habilitado, también incluye las promociones del negocio padre. **Autenticación requerida:** Bearer Token obtenido del campo `tokenCurrent` en el servicio de login. `Authorization: Bearer {tokenCurrent}` - [Crear o editar promoción](https://developer.loggro.com/reference/guardarpromocion.md): Crea una nueva promoción o actualiza una existente según la presencia del campo `_id` en el body. - **Sin `_id`:** Se crea una nueva promoción asociada al negocio del usuario autenticado. - **Con `_id`:** Se actualiza la promoción existente (nombre, tipo, dateSettings, data, isActive). Tras guardar, se emite un evento de socket `connected` con `productsUpdated: true` a todos los clientes conectados al negocio. **Permiso requerido:** `PM_POST` (Crear/Editar) **Autenticación requerida:** Bearer Token obtenido del campo `tokenCurrent` en el servicio de login. `Authorization: Bearer {tokenCurrent}` - [Consultar promoción por ID](https://developer.loggro.com/reference/consultarpromocionporid.md): Retorna el detalle de una promoción específica por su ID. Si el negocio hereda productos del padre y tiene `inheritParentsProducts` habilitado, también busca en las promociones del negocio padre. **Permiso requerido:** `PM_POST` (Crear/Editar) **Autenticación requerida:** Bearer Token obtenido del campo `tokenCurrent` en el servicio de login. `Authorization: Bearer {tokenCurrent}` - [Eliminar promoción](https://developer.loggro.com/reference/eliminarpromocion.md): Realiza un **borrado lógico** (soft delete) de la promoción: establece `deleted: true` y actualiza `modifiedOn`. Adicionalmente, desvincula la promoción de todos los productos que la tenían asignada (`promo: null`). Solo se puede eliminar una promoción que pertenezca al negocio propio del usuario autenticado. Tras eliminar, se emite un evento de socket `connected` con `productsUpdated: true` a todos los clientes conectados al negocio. **Permiso requerido:** `PM_DELETE` (Eliminar) **Autenticación requerida:** Bearer Token obtenido del campo `tokenCurrent` en el servicio de login. `Authorization: Bearer {tokenCurrent}` - [Consultar roles](https://developer.loggro.com/reference/consultarroles.md): Retorna la lista de todos los roles activos asociados al negocio del usuario autenticado, ordenados alfabéticamente por nombre. Los roles eliminados (deleted: true) no se incluyen. **Permiso requerido:** `RO_GET_ALL` - [Crear o editar rol](https://developer.loggro.com/reference/guardarrol.md): Crea un nuevo rol o actualiza uno existente según el negocio del usuario autenticado. - Si el body incluye un campo `_id` válido que coincide con un rol del negocio, **actualiza** el rol. - Si no se proporciona `_id`, **crea** un nuevo rol. El campo `business` se asigna automáticamente desde el token del usuario; no es necesario enviarlo. Se registra historial del cambio (creación o actualización) y se notifica por WebSocket a los usuarios conectados del negocio. **Permiso requerido:** `RO_POST` - [Consultar rol por ID](https://developer.loggro.com/reference/consultarrolporid.md): Retorna un rol específico del negocio autenticado buscado por su ID. Solo se retorna el rol si pertenece al negocio del usuario. **Permiso requerido:** `RO_POST` - [Eliminar rol](https://developer.loggro.com/reference/eliminarrol.md): Realiza una eliminación lógica (soft delete) del rol especificado. El rol no se borra físicamente de la base de datos; se marca con `deleted: true` y se actualiza `modifiedOn` a la fecha actual. Solo se puede eliminar un rol que pertenezca al negocio del usuario autenticado. Tras la eliminación se notifica por WebSocket a los usuarios conectados del negocio y se registra el historial del cambio. **Permiso requerido:** `RO_DELETE` - [Consultar áreas de pedido](https://developer.loggro.com/reference/consultarareaspedido.md): Retorna todas las áreas de pedido activas (no eliminadas) del negocio del usuario autenticado, ordenadas por nombre. Si el negocio está en período de prueba (trial), solo retorna las áreas creadas en las últimas 24 horas. **Autenticación requerida:** Bearer Token obtenido del campo `tokenCurrent` en el servicio de login. `Authorization: Bearer {tokenCurrent}` - [Crear o editar área de pedido](https://developer.loggro.com/reference/guardarareapedido.md): Crea un nueva área de pedido o actualiza una existente según la presencia del campo `_id` en el body. - **Sin `_id`:** Se crea un nueva área de pedido asociada al negocio del usuario autenticado. - **Con `_id`:** Se actualiza el nombre del área de pedido existente. **Permiso requerido:** `WO_POST` (Crear/Editar) **Planes con acceso:** `TRIAL`, `LITE_PLUS_MENSUAL`, `LITE_PLUS_ANUAL`, `GOURMET_MENSUAL`, `GOURMET_ANUAL`, `GOURMET_PLUS_MENSUAL`, `GOURMET_PLUS_ANUAL` **Autenticación requerida:** Bearer Token obtenido del campo `tokenCurrent` en el servicio de login. `Authorization: Bearer {tokenCurrent}` - [Consultar área de pedido por ID](https://developer.loggro.com/reference/consultarareapedidoporid.md): Retorna el detalle de un área de pedido específica por su ID, validando que pertenezca al negocio del usuario autenticado. **Permiso requerido:** `WO_POST` (Crear/Editar) **Planes con acceso:** `TRIAL`, `LITE_PLUS_MENSUAL`, `LITE_PLUS_ANUAL`, `GOURMET_MENSUAL`, `GOURMET_ANUAL`, `GOURMET_PLUS_MENSUAL`, `GOURMET_PLUS_ANUAL` **Autenticación requerida:** Bearer Token obtenido del campo `tokenCurrent` en el servicio de login. `Authorization: Bearer {tokenCurrent}` - [Eliminar área de pedido](https://developer.loggro.com/reference/eliminarareapedido.md): Realiza una eliminación lógica del área de pedido (marca el campo `deleted` como `true` y actualiza `modifiedOn`). **Permiso requerido:** `WO_DELETE` (Eliminar) **Autenticación requerida:** Bearer Token obtenido del campo `tokenCurrent` en el servicio de login. `Authorization: Bearer {tokenCurrent}` - [Introducción](https://developer.loggro.com/reference/introduccion-alojamientos.md) - [Introducción](https://developer.loggro.com/reference/autenticacion-alojamientos.md) - [Iniciar sesión con OTP](https://developer.loggro.com/reference/post_api-v1-sessions.md): Valida el OTP y retorna un Bearer token válido por **1 hora**. El OTP en sí mismo es válido durante **1 hora** desde que fue enviado. Cada inicio de sesión genera un nuevo token e invalida el anterior. - [Cerrar sesión](https://developer.loggro.com/reference/delete_api-v1-sessions.md) - [Enviar OTP](https://developer.loggro.com/reference/post_api-v1-sessions-send-otp.md): Envía un código OTP por SMS y WhatsApp. Retorna `200` independientemente de si el teléfono está registrado o no (diseño anti-enumeración). Un tiempo de espera de 2 minutos omite el envío silenciosamente sin cambiar el código de estado — los códigos ya recibidos siguen siendo válidos por 1 hora. Las respuestas de error indican condiciones excepcionales: `401` si el teléfono está en lista negra permanente, `429` si se supera el límite de intentos de inicio de sesión (5/hora), `503` si el proveedor de OTP falla. - [Health check del servidor](https://developer.loggro.com/reference/get_api-status.md): Endpoint público invocado por monitores externos (UptimeRobot, Pingdom, etc.) para verificar que el servidor está activo. Retorna el estado y la hora del servidor. No requiere autenticación. - [Diagnóstico de conectividad Booking.com](https://developer.loggro.com/reference/post_api-otas-booking-diagnostics.md): Endpoint invocado por Booking.com para verificar que la integración responde correctamente. El procesamiento es **asíncrono**: encola el job `Otas::Booking::CreatePropertyDiagnosticJob` con el `property_id` recibido y responde `201` inmediatamente. Booking.com solo espera confirmación de recepción. No requiere autenticación. - [Listar reservas del hotel](https://developer.loggro.com/reference/get_api-v1-hotels-reservations.md) - [Registrar consumo del huésped](https://developer.loggro.com/reference/post_api-v1-external-consumptions.md) - [Consultar reservas activas por documento](https://developer.loggro.com/reference/get_api-v1-reservations-find-by.md) - [Consultar hotel por número de documento](https://developer.loggro.com/reference/get_api-v1-hotels-find-by.md)