--- title: "Obtener reporte fiscal" description: "Devuelve totales fiscales declarados, pagados y pendientes provenientes de declaraciones sincronizadas del SAT." language: es-MX canonical_url: "https://exac.mx/docs/api/tax-reports/reports/get-tax-report" md_url: "https://exac.mx/docs/api/tax-reports/reports/get-tax-report.md" --- # Obtener reporte fiscal Devuelve totales fiscales declarados, pagados y pendientes provenientes de declaraciones sincronizadas del SAT. ## Solicitud `GET /v1/reports/taxes` - **Autorización:** Permiso requerido: `sat:read`. - **Entornos:** Solo producción - **Idempotencia:** No requerida ## Contrato canónico para máquinas Este fragmento se genera desde la operación canónica y los contratos Zod que utiliza la ruta. ```json { "method": "GET", "path": "/v1/reports/taxes", "operation": { "operationId": "getTaxReport", "tags": [ "Reports" ], "summary": "Obtener reporte fiscal", "description": "Devuelve totales fiscales declarados, pagados y pendientes provenientes de declaraciones sincronizadas del SAT.", "security": [ { "bearerAuth": [] } ], "servers": [ { "url": "https://adventurous-moose-616.convex.site", "description": "Despliegue actual de producción de la API de Exac" } ], "parameters": [ { "name": "fiscalYear", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 2000, "maximum": 2100 } }, { "name": "period", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 12 } }, { "name": "contributorLimit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 10 } } ], "responses": { "200": { "description": "Operación completada.", "headers": { "Request-Id": { "$ref": "#/components/headers/RequestId" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "source": { "type": "string", "const": "sat_declarations" }, "currency": { "type": "string", "const": "MXN" }, "fiscalYear": { "type": "number" }, "selectedPeriod": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "declarationCoverage": { "type": "string", "enum": [ "none", "partial", "complete" ] }, "filedPeriods": { "type": "array", "items": { "type": "number" } }, "missingPeriods": { "type": "array", "items": { "type": "number" } }, "totals": { "anyOf": [ { "type": "object", "properties": { "declaredTaxTotal": { "type": "number" }, "paidTaxTotal": { "type": "number" }, "pendingTaxTotal": { "type": "number" }, "breakdown": { "type": "object", "properties": { "isr": { "type": "number" }, "iva": { "type": "number" }, "withholdings": { "type": "number" }, "unclassified": { "type": "number" } }, "required": [ "isr", "iva", "withholdings", "unclassified" ], "additionalProperties": false } }, "required": [ "declaredTaxTotal", "paidTaxTotal", "pendingTaxTotal", "breakdown" ], "additionalProperties": false }, { "type": "null" } ] }, "periods": { "type": "array", "items": { "type": "object", "properties": { "period": { "type": "number" }, "filingCount": { "type": "number" }, "declaredTaxTotal": { "type": "number" }, "paidTaxTotal": { "type": "number" }, "pendingTaxTotal": { "type": "number" }, "paymentStatus": { "type": "string", "enum": [ "no_obligation", "pending", "partially_paid", "paid" ] }, "breakdown": { "type": "object", "properties": { "isr": { "type": "number" }, "iva": { "type": "number" }, "withholdings": { "type": "number" }, "unclassified": { "type": "number" } }, "required": [ "isr", "iva", "withholdings", "unclassified" ], "additionalProperties": false }, "withholdingDetails": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "amount": { "type": "number" } }, "required": [ "name", "amount" ], "additionalProperties": false } } }, "required": [ "period", "filingCount", "declaredTaxTotal", "paidTaxTotal", "pendingTaxTotal", "paymentStatus", "breakdown", "withholdingDetails" ], "additionalProperties": false } }, "cfdiContext": { "anyOf": [ { "type": "object", "properties": { "usedForTaxAmounts": { "type": "boolean", "const": false }, "contributors": { "type": "object", "properties": { "source": { "type": "string", "const": "cfdi_activity" }, "income": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "amount": { "type": "number" }, "isOther": { "type": "boolean" } }, "required": [ "name", "amount", "isOther" ], "additionalProperties": false } }, "expenses": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "amount": { "type": "number" }, "isOther": { "type": "boolean" } }, "required": [ "name", "amount", "isOther" ], "additionalProperties": false } }, "payroll": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "amount": { "type": "number" }, "isOther": { "type": "boolean" }, "direction": { "type": "string", "enum": [ "paid", "received" ] } }, "required": [ "name", "amount", "isOther", "direction" ], "additionalProperties": false } } }, "required": [ "source", "income", "expenses", "payroll" ], "additionalProperties": false } }, "required": [ "usedForTaxAmounts", "contributors" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "source", "currency", "fiscalYear", "selectedPeriod", "declarationCoverage", "filedPeriods", "missingPeriods", "totals", "periods", "cfdiContext" ], "additionalProperties": false } }, "required": [ "data" ], "additionalProperties": false }, "examples": { "default": { "value": { "data": { "source": "sat_declarations", "currency": "MXN", "fiscalYear": 2026, "selectedPeriod": null, "declarationCoverage": "none", "filedPeriods": [], "missingPeriods": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ], "totals": null, "periods": [], "cfdiContext": null } } }, "juneFiled": { "summary": "June declaration recorded, payment not yet recorded", "value": { "data": { "source": "sat_declarations", "currency": "MXN", "fiscalYear": 2026, "selectedPeriod": 6, "declarationCoverage": "partial", "filedPeriods": [ 6 ], "missingPeriods": [ 1, 2, 3, 4, 5, 7, 8, 9, 10, 11, 12 ], "totals": { "declaredTaxTotal": 12800, "paidTaxTotal": 0, "pendingTaxTotal": 12800, "breakdown": { "isr": 7800, "iva": 5000, "withholdings": 0, "unclassified": 0 } }, "periods": [ { "period": 6, "filingCount": 1, "declaredTaxTotal": 12800, "paidTaxTotal": 0, "pendingTaxTotal": 12800, "paymentStatus": "pending", "breakdown": { "isr": 7800, "iva": 5000, "withholdings": 0, "unclassified": 0 }, "withholdingDetails": [] } ], "cfdiContext": { "usedForTaxAmounts": false, "contributors": { "source": "cfdi_activity", "income": [ { "name": "Taller Nopal", "amount": 50000, "isOther": false }, { "name": "Estudio Jacaranda", "amount": 30000, "isOther": false }, { "name": "Otros", "amount": 45000, "isOther": true } ], "expenses": [ { "name": "Servicios del Bosque", "amount": 42000, "isOther": false } ], "payroll": [ { "name": "Equipo Bruma", "amount": 18000, "isOther": true, "direction": "paid" } ] } } } } } } } } }, "400": { "description": "Solicitud inválida.\n\n`validation_error`", "headers": { "Request-Id": { "$ref": "#/components/headers/RequestId" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Credencial inválida o ausente.\n\n`unauthenticated`", "headers": { "Request-Id": { "$ref": "#/components/headers/RequestId" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWWAuthenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "La credencial no incluye el permiso `sat:read`.\n\n`forbidden`", "headers": { "Request-Id": { "$ref": "#/components/headers/RequestId" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWWAuthenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Recurso no encontrado.\n\n`not_found`", "headers": { "Request-Id": { "$ref": "#/components/headers/RequestId" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "405": { "description": "Método no permitido.\n\n`method_not_allowed`", "headers": { "Request-Id": { "$ref": "#/components/headers/RequestId" }, "Allow": { "$ref": "#/components/headers/Allow" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Demasiadas solicitudes.\n\n`rate_limited`", "headers": { "Request-Id": { "$ref": "#/components/headers/RequestId" }, "Retry-After": { "$ref": "#/components/headers/RetryAfter" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Error interno del servidor.\n\n`internal`", "headers": { "Request-Id": { "$ref": "#/components/headers/RequestId" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Servicio temporalmente no disponible.\n\n`provider_unavailable`", "headers": { "Request-Id": { "$ref": "#/components/headers/RequestId" }, "Retry-After": { "$ref": "#/components/headers/RetryAfter" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-exac-environments": [ "production" ] }, "components": { "schemas": { "ApiError": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ProgrammaticError" } }, "required": [ "error" ], "additionalProperties": false }, "ProgrammaticError": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "validation_error", "unauthenticated", "forbidden", "not_found", "method_not_allowed", "conflict", "idempotency_conflict", "operation_in_progress", "recovery_required", "rate_limited", "provider_unavailable", "internal" ], "description": "Acción recomendada por código:\n\n- `validation_error` — Corrige cada elemento de details.issues usando su path y código estable.\n- `unauthenticated` — Proporciona una API key o un token de acceso OAuth válido.\n- `forbidden` — Usa una credencial con el permiso requerido.\n- `not_found` — Verifica el identificador del recurso dentro de la organización.\n- `method_not_allowed` — Usa el método HTTP documentado.\n- `conflict` — Actualiza el recurso y resuelve su estado actual.\n- `idempotency_conflict` — Usa otra clave de idempotencia para una solicitud modificada.\n- `operation_in_progress` — Espera el tiempo de Retry-After y repite la misma solicitud.\n- `recovery_required` — No reintentes automáticamente; reconcilia el resultado del proveedor.\n- `rate_limited` — Espera el tiempo de Retry-After antes de reintentar.\n- `provider_unavailable` — Reintenta solo cuando la respuesta marque la falla como reintentable.\n- `internal` — Reintenta después y contacta a soporte si el error persiste." }, "message": { "type": "string" }, "details": { "type": "object", "properties": { "issues": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "array", "items": { "anyOf": [ { "type": "string" }, { "type": "number" } ] } }, "message": { "type": "string" }, "code": { "type": "string" } }, "required": [ "path", "message" ], "additionalProperties": false } }, "retryable": { "type": "boolean" }, "retryAfterSeconds": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "additionalProperties": false }, "status": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "code", "message", "status" ], "additionalProperties": false } } } } ``` [OpenAPI 3.1](/openapi.json) ## Herramientas MCP equivalentes - [`get_tax_summary`](/docs/mcp/tools/get_tax_summary.md) Documentación completa: https://exac.mx/docs.md Índice para agentes: https://exac.mx/docs/llms.txt