Saltar al contenido principal

Representaciones Gráficas (PDF)

📝 Generación de PDFs con JasperReports

Gosocket genera los PDFs de documentos fiscales brasileños a partir del XML aprobado que retorna NDD, renderizando con JasperReports según las notas técnicas y MOC vigentes para cada tipo de documento.

NDD sigue siendo el intermediario fiscal: valida, transforma y remite a SEFAZ o Prefeituras. La generación del PDF es responsabilidad de Gosocket.

Aplica a: NF-e (tipo 55) · CT-e (tipo 57) · NFS-e (tipo 551)

NF-e (tipo 55) y CT-e (tipo 57) — modelos nacionales​

CT-e y NF-e operan exclusivamente en el modelo nacional (SEFAZ). Las plantillas JasperReports siguen las notas técnicas y MOC vigentes.

Orden de prioridad para la generación del PDF:

  1. Plantilla personalizada (si existe en Inbox) → se aplica directamente.
  2. Plantilla estándar Gosocket (JasperReports) → generada a partir del XML aprobado retornado por NDD.

💡 Plantillas disponibles en Inbox

Las plantillas están disponibles en el portal de Inbox, sección “Plantillas de Visualización”. Pueden personalizarse mediante el proceso de aprobación comercial estándar, igual que en el resto de los países.

NFS-e (tipo 551)​

NFS-e tiene mayor complejidad porque no existe un esquema único: cada municipalidad puede operar en ambiente nacional (SEFAZ) o en su propio sistema legado (ambiente local). Gosocket aplica la plantilla JasperReports nacional a ambos tipos de municipio.

📝 Nota Técnica NT-008/SE-CGNFSE-DANFSE-20260505 — ver documento oficial

Define los requisitos de contenido del DANFSE, incluyendo los nuevos impuestos de la reforma tributaria brasileña (CBS e IBS). La visualización correcta de estos impuestos es obligatoria desde el 01/08/2026. La plantilla Gosocket es NT-008 compliant y aplica tanto a municipios en ambiente nacional como local.

Orden de prioridad para la generación del PDF:

  1. Plantilla personalizada (si existe en Inbox) → se aplica directamente.
  2. Plantilla estándar Gosocket (JasperReports) → NT-008 compliant. Input: XML aprobado retornado por NDD (DPS en ambiente nacional / RPS procesado en ambiente local).

⚠️ Personalización de plantillas NFS-e

Dado el nivel de complejidad técnica, no se recomienda personalizar plantillas para NFS-e. En Sandbox se recomienda emitir un lote amplio que cubra la mayor cantidad de casuísticas posibles, con énfasis en la correcta visualización de CBS e IBS.

MDF-e (tipo 58)​

📝 La plantilla JasperReports para MDF-e está en desarrollo. Se comunicará cuando esté disponible.

Comportamiento de campos clave (NFS-e)​

CampoComportamiento
Chave de Acesso da NFS-ePuede estar vacío si la Prefeitura no proporciona la clave en la respuesta de aprobación. Frecuente en municipios en ambiente local.
Código QRPrioridad: (1) clave de acceso válida → portal nacional SEFAZ; (2) URL de PDF local de la Prefeitura → enlace a esa URL; (3) ninguna condición → campo en blanco.
Código de Tributação MunicipalLa descripción no se incluye por defecto; varía por municipio y no forma parte del XML normalizado de la NT-008.
Municipios en ambiente localLa plantilla es idéntica a la nacional. Los PDFs incluyen comentarios embebidos que destacan las limitaciones derivadas del formato RPS.
Plantilla personalizadaEstándar NT-compliant aplicada por defecto. Cualquier personalización debe gestionarse como requerimiento formal vía equipo comercial y Account Manager.
Títulos en negrita (compilación local)Limitación conocida: pueden no renderizarse en negrita al compilar fuera del renderizador Gosocket/Inbox. En Inbox se generan correctamente.