--- updatedAt: 2026-06-04T18:14:11.000Z agentTools: projectIndex: https://developer.alanube.co/llms.txt --- # Obtener total de documentos emitidos Obtiene el total de documentos electrónicos emitidos por el usuario autenticado en un rango de fechas y estados legales determinados. A su vez, el total es desglosado por cada compañía que posea el usuario. ### NOTAS - Por defecto se consultan los últimos 30 días si no se especifican fechas - El rango maximo a consultar es de 90 días - Se incluyen todas las compañías que posee el usuario, incluyendo la compañía principal (si la tuviese) # OpenAPI definition ```json { "openapi": "3.0.3", "info": { "title": "API FE DOM", "description": "API Alanube Proveedor Electrónico República Dominicana", "version": "1.0.0" }, "servers": [ { "url": "https://sandbox.alanube.co/dom/v1/", "description": "Sandbox Server" }, { "url": "https://api.alanube.co/dom/v1/", "description": "Production Server" } ], "tags": [ { "name": "Empresas", "description": "Endpoints para la gestión de Empresas", "externalDocs": { "url": "https//e-dom.alanube.com/empresas" } }, { "name": "Reportes", "description": "Endpoints para obtener reportes y estadísticas de documentos electrónicos" } ], "paths": { "/company": { "get": { "summary": "Consultar la información de la empresa asociada al token", "description": "Retorna la información de la empresa asociada al token", "operationId": "getSelfCompany", "tags": [ "Empresas" ], "responses": { "200": { "description": "Objeto que representa la respuesta que contiene la información de una empresa", "content": { "application/json": { "schema": { "type": "object", "properties": { "company": { "allOf": [ { "type": "object", "properties": { "id": { "type": "string", "example": "01FVK1KD4581EF7CCK7TX55420" } } }, { "type": "object", "properties": { "name": { "type": "string", "description": "Nombre/Razón social de la empresa", "example": "Mi compañía" }, "tradeName": { "type": "string", "description": "Nombre comercial", "example": "Mi compañía S.A" }, "identification": { "type": "string", "description": "Identificación de la empresa", "example": 12345678, "pattern": "^[0-9]{9}$|^[0-9]{11}$" }, "type": { "type": "string", "description": "Tipo de empresa", "enum": [ "main", "associated" ] }, "address": { "type": "string", "description": "Dirección de la compañía", "example": "30 De Marzo 9 Sd" }, "province": { "type": "string", "description": "Provincia donde está situada la compañía", "example": "Santo domingo" }, "municipality": { "type": "string", "description": "Municipio donde está situada la compañía", "example": "30 De Marzo 9 Sd" }, "email": { "type": "string", "format": "email", "maxLength": 80, "description": "Correo electrónico de la compañía", "example": "alanube@example.com" }, "companyUrls": { "type": "object", "description": "Urls necesarias para el proceso de certificación y las cuales serán registradas en la DGII para la recepción de documentos", "properties": { "reception": { "type": "string", "description": "Url de reception", "example": "https://almost.alanube.co/dom/v1/01FVJ1528AQRBC7D6K2TGVE5S5" }, "approval": { "type": "string", "description": "URL de aprobación comercial", "example": "https://almost.alanube.co/dom/v1/01FVJ1528AQRBC7D6K2TGVE5S5" }, "authentication": { "type": "string", "description": "URL de autenticación", "example": "https://almost.alanube.co/dom/v1/01FVJ1528AQRBC7D6K2TGVE5S5" } } }, "certificate": { "type": "object", "description": "Objeto que contiene la información del certificado en respuestas", "properties": { "name": { "type": "string", "description": "Nombre del archivo", "example": "certificado digital" }, "extension": { "type": "string", "description": "Extensión del archivo", "example": "pfx" }, "issuerName": { "type": "string", "description": "Información del proveedor del certificado", "example": "emailAddress = info@andesscd.com.co, CN = CA ANDES SCD S.A. Clase II, OU = Division de certificacion entidad final, O = Andes SCD.," }, "startDate": { "type": "string", "format": "date-time", "example": "2019-05-28 15:36:00" }, "endDate": { "type": "string", "format": "date-time", "example": "2019-05-28 15:36:00" } } }, "webhooks": { "$ref": "#/paths/~1company/post/requestBody/content/application~1json/schema/properties/webhooks" }, "notificationByEmail": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Indica si la compañía tiene habilitada o no la notificación por mail hacia el receptor de un comprobante electrónico (cuando es aceptado por DGII). Por defecto, no se encuentra habilitada." }, "message": { "type": "string", "maxLength": 300, "description": "Cuando la notificación por mail esté habilitada, se añadirá el mensaje configurado al final del correo enviado. No es obligatorio configurar mensaje extra alguno." } }, "required": [ "enabled" ] } } } ] } } } } } }, "400": { "description": "Objeto que representa una respuesta de error por validaciones", "content": { "application/json": { "schema": { "type": "object", "description": "Array que contiene N errores generados en el sistema", "properties": { "code": { "type": "string", "description": "Código de error" }, "message": { "type": "string", "description": "Mensajes de error" } }, "example": { "message": [ "instance.identification is not of a type(s) string" ], "code": 400 } } } } }, "404": { "description": "Objeto que representa una respuesta de error debido a que no se ha encontrado el recurso al que se intenta acceder", "content": { "application/json": { "schema": { "type": "object", "description": "Array que contiene N errores generados en el sistema", "properties": { "code": { "type": "string", "description": "Código de error" }, "message": { "type": "string", "description": "Mensaje de error" } }, "example": { "message": "No se ha encontrado el recurso", "code": 404 } } } } }, "500": { "description": "Objeto que representa una respuesta de error por qué ha ocurrido un error interno en el sistema", "content": { "application/json": { "schema": { "type": "object", "description": "Array que contiene N errores generados en el sistema", "properties": { "code": { "type": "string", "description": "Código de error" }, "message": { "type": "string", "description": "Mensaje de error" } }, "example": { "message": "An unexpected error has occurred", "code": "EPR500" } } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/reports/users/documents/total": { "get": { "summary": "Obtener total de documentos emitidos", "description": "Obtiene el total de documentos electrónicos emitidos por el usuario autenticado en un rango de fechas y estados legales determinados. A su vez, el total es desglosado por cada compañía que posea el usuario.\n\n### NOTAS\n\n- Por defecto se consultan los últimos 30 días si no se especifican fechas\n- El rango maximo a consultar es de 90 días\n- Se incluyen todas las compañías que posee el usuario, incluyendo la compañía principal (si la tuviese)\n", "operationId": "getTotalDocumentsByUser", "tags": [ "Reportes" ], "parameters": [ { "name": "legalStatus", "required": true, "in": "query", "description": "Lista de estados legales de los documentos emitidos separados por comas", "schema": { "type": "string", "pattern": "^[A-Z_]+(,[A-Z_]+)*$", "example": "REJECTED,ACCEPTED,ACCEPTED_WITH_OBSERVATIONS" } }, { "name": "dateFrom", "required": false, "in": "query", "description": "Fecha de inicio del rango de fechas. Si no se especifica, se toma la fecha actual menos 30 días", "schema": { "type": "string", "format": "date", "example": "2025-01-01" } }, { "name": "dateUntil", "required": false, "in": "query", "description": "Fecha de fin del rango de fechas. Si no se especifica, se toma la fecha actual", "schema": { "type": "string", "format": "date", "example": "2025-01-31" } } ], "responses": { "200": { "description": "Total de documentos emitidos por usuario", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "description": "Datos del reporte de totales por usuario", "properties": { "totalEmittedDocuments": { "type": "number", "example": 520 }, "companies": { "type": "object", "description": "Objeto clave valor donde la clave es el id de la compañía y el valor es el reporte de totales", "properties": { "1234567XXXXXXXXXXXXXXX": { "type": "object", "description": "Datos de la compañía 1234567XXXXXXXXXXXXXXX", "properties": { "rnc": { "type": "string", "description": "Identificación (RNC) de la compañía", "example": "131793916" }, "name": { "type": "string", "description": "Razón social de la compañía", "example": "Alegra SRL" }, "tradeName": { "type": "string", "description": "Nombre comercial de la compañía", "example": "Alegra" }, "email": { "type": "string", "description": "Correo electrónico de la compañía", "example": "contacto@alegra.com" }, "totalEmittedDocuments": { "type": "number", "example": 520 }, "fiscalInvoices": { "type": "number", "example": 239 }, "invoices": { "type": "number", "example": 235 }, "creditNotes": { "type": "number", "example": 21 }, "debitNotes": { "type": "number", "example": 0 }, "exportSupports": { "type": "number", "example": 0 }, "gubernamentals": { "type": "number", "example": 0 }, "minorExpenses": { "type": "number", "example": 31 }, "paymentAbroadSupports": { "type": "number", "example": 0 }, "purchases": { "type": "number", "example": 1 }, "specialRegimes": { "type": "number", "example": 1 } } } } } } } } } } } }, "400": { "$ref": "#/paths/~1company/get/responses/400" }, "404": { "$ref": "#/paths/~1company/get/responses/404" }, "500": { "$ref": "#/paths/~1company/get/responses/500" } }, "security": [ { "BearerAuth": [] } ] } } }, "components": { "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer" } } } } ```