Factuarea API
Informes fiscales (130/303/347)

Vista previa de un informe de impuestos

Calcula el desglose de un informe fiscal sin persistir una generación ni escribir ficheros. Ideal para UIs interactivas que confirman los totales antes de consolidar.

POST
/tax_reports/preview

Authorization

AuthorizationBearer <token>

En: header

Cuerpo de la petición

application/json

Definiciones de TypeScript

Usa el tipo request body en TypeScript.

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

application/json

application/json

application/json

{
  "data": {
    "object": "tax_report_preview",
    "type": "modelo_303",
    "period": {
      "year": 2026,
      "quarter": 2,
      "label": "2026 Q2"
    },
    "breakdown_303": {
      "4": {
        "base": 50000,
        "cuota": 2000
      },
      "10": {
        "base": 250000,
        "cuota": 25000
      },
      "21": {
        "base": 1000000,
        "cuota": 210000
      }
    },
    "totals": {
      "baseDevengada": 1300000,
      "cuotaDevengada": 237000,
      "baseSoportado": 400000,
      "cuotaSoportado": 84000,
      "resultadoLiquidacion": 153000
    },
    "clients_347": [],
    "suppliers_347": [],
    "invoice_count": 42,
    "purchase_invoice_count": 18,
    "warnings": []
  }
}

{
  "error": {
    "type": "authentication_error",
    "code": "missing_api_key",
    "message": "No se ha proporcionado una API key válida en el header Authorization.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#missing_api_key",
    "request_id": "req_01HKQS5N8VR7QXJ9K3T6BWPMZA"
  }
}

{
  "error": {
    "type": "authorization_error",
    "code": "insufficient_scope",
    "message": "Esta API key no tiene el scope requerido para esta operación.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#insufficient_scope",
    "request_id": "req_01HKQS5NBC3P8M1KX4V7SLNHQD"
  }
}

{
  "error": {
    "type": "idempotency_error",
    "code": "idempotency_key_reused",
    "message": "La cabecera `Idempotency-Key` ya se usó con un body distinto. Usa una clave nueva o reenvía exactamente el mismo body.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#idempotency_key_reused",
    "request_id": "req_01HKQS5NHT9A4U7R2E3F8GZWTJ"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_invalid",
    "message": "El campo `name` es obligatorio y no puede estar vacío.",
    "param": "name",
    "doc_url": "https://docs.factuarea.com/guides/errors#parameter_invalid",
    "request_id": "req_01HKQS5NGS8Z3T6Q1D2E7FYVSI"
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Has excedido el rate limit de 60 peticiones por minuto. Reintenta tras 30 segundos.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#rate_limit_exceeded",
    "request_id": "req_01HKQS5NKW1C6W9T4G5H0JBZVL"
  }
}

{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "Ha ocurrido un error inesperado. Si persiste, contacta con soporte adjuntando el request_id.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#internal_error",
    "request_id": "req_01HKQS5NLX2D7X0U5H6J1KCAWM"
  }
}

Lista el historial de informes de impuestos

Devuelve el histórico paginado de informes fiscales generados de la empresa. Filtros opcionales: type, year.

Recupera las estadísticas del informe de impuestos

Devuelve KPIs agregados del histórico de informes fiscales generados: totales por tipo y formato, tamaño de fichero acumulado, y el trimestre/año fiscal actual.