Saltar al contenido principal

NDD — Integración Brasil

Gosocket integra con NDD Space como middleware fiscal para Brasil. NDD es el intermediario autorizado que valida, transforma y remite los documentos electrónicos a las entidades tributarias brasileñas (SEFAZ y municipalidades).

¿Qué hace la integración Gosocket + NDD?​

Emite
NF-e, CT-e, MDF-e, NFS-e y NFCom hacia SEFAZ o Prefeituras
Recibe
Documentos de proveedores por casilla de recepción o sincronización periódica
Transforma
GUF/DTE → RPS → formato exigido por cada municipalidad
Genera
Representaciones gráficas PDF con JasperReports

¿Para quién es esta documentación?​

Esta documentación está dirigida a:

  • Equipos de desarrollo que integran sistemas del cliente con la plataforma Gosocket para Brasil
  • Equipos de operaciones que configuran y activan los TaxIDs en NDD Space
  • Partners que canalizan documentos fiscales brasileños a través de Gosocket + NDD

Mecanismo de integración​

La integración opera vía API REST con autenticación OAuth 2.0. Gosocket recibe el documento en formato GUF/DTE y lo envía a NDD Space mediante SendDocumentToAuthority. NDD transforma el documento, lo valida ante SEFAZ o la Prefeitura correspondiente y retorna el XML aprobado con el estado tributario. El estado se puede consultar posteriormente con GetDocument; eventos como cancelación o carta de corrección se ejecutan con ChangeDocumentStatus.

Consulta Cómo funciona para la arquitectura completa y el detalle de la cadena de transformación.

Por dónde empezar​

Nuevo en la integración NDD

Si es la primera vez que trabajas con esta integración, te recomendamos seguir este orden:

  1. Lee Cómo funciona para entender la arquitectura y el rol de NDD Space como middleware
  2. Revisa Portal de NDD y confirma que el TaxID esté activo en NDD Space (requisito previo)
  3. Consulta los Flujos de Proceso para la secuencia de llamadas de emisión y recepción
  4. Explora las APIs para los detalles técnicos de cada método

Secciones de esta documentación​

Cómo funcionaGuíaArquitectura, cadena de transformación y ciclo de vida del documento.Portal de NDDReferenciaAcceso al portal NDD Space: módulos de Documentos y Configurações.Flujos de ProcesoFlujosFlujos de emisión (AR) y recepción (AP) para NF-e, CT-e, NFS-e y más.APIsAPI RESTMétodos SendDocumentToAuthority, GetDocument y ChangeDocumentStatus.Tipos de DocumentosReferenciaCatálogo de documentos fiscales electrónicos soportados para Brasil.Representaciones Gráficas (PDF)ReferenciaGeneración de PDFs con JasperReports para NF-e, CT-e y NFS-e.Disponibilidad de MunicipalidadesReferenciaEstado de implementación NFS-e por municipalidad brasileña.