Brasil: AP — Recepción
La recepción de documentos tributarios en Brasil se realiza a través de NDD como intermediario ante la entidad tributaria (SEFAZ / Prefeituras). NDD es responsable de las validaciones de esquema, firma y estado; Gosocket almacena y gestiona los documentos con el estado que entrega NDD.
⚠️ Activación obligatoria en NDD Space
En Brasil, cada cliente (TaxID) debe estar activado en el portal NDD Space para que la recepción funcione correctamente. Esta habilitación es un requisito previo indispensable; sin ella el flujo se detiene.
En la mayoría de países la recepción opera directamente por casilla. Brasil agrega esta capa de activación adicional.
Las dos rutas de entrada
| Casilla / Upload | Sincronización periódica | |
|---|---|---|
| Activación | Proveedor envía XML o carga manual | Automática, según cadencia por tipo |
| Requisito | Email de reenvío en el TaxID | TaxID activo en NDD Space |
| Sin requisito | Estado 5 (Error) — flujo detenido | No aplica |
| Reintentos | Hasta 10 en 30 minutos | N/A |
| Marca en Inbox | Sin nota especial | "Sincronizado desde NDD" |
Responsabilidades por equipo
Para el detalle de configuración en NDD Space consulta Portal de NDD.
CT-e y NF-e
Existen dos rutas independientes. La primera se activa cuando llega un documento; la segunda opera en paralelo de forma autónoma.
Flujo 1 — Casilla de recepción o Upload
Se activa cuando un proveedor envía directamente el XML a la casilla de recepción, o cuando se usa la opción "Upload" de Inbox:
- El documento llega a la casilla de recepción de Gosocket (o se carga por Upload) y se almacena en Inbox.
- Gosocket verifica si el TaxID receptor tiene configuración activa y email de reenvío.
- Sin email de reenvío o TaxID no configurado → el documento se marca en Estado 5 (Error) y el flujo se detiene.
- Con email configurado → Gosocket envía el XML a NDD y realiza hasta 10 reintentos durante 30 minutos para obtener el estado.
- Si tras los 10 reintentos NDD no tiene el documento → se marca en Estado 6 (No disponible en entidad tributaria).
- Si NDD responde → Gosocket actualiza el estado en Inbox.
📝 Este flujo depende del email de reenvío configurado en el receptor. Sin este email, el flujo se detiene en Estado 5 (Error) y no puede avanzar hasta que se active la configuración.
Flujo 2 — Sincronización periódica (cada 4 horas)
Opera de forma autónoma, independientemente del Flujo 1:
- Gosocket ejecuta la sincronización automática con NDD cada 4 horas.
- Detecta todos los documentos disponibles en NDD para los TaxID configurados.
- Documento ya existente en Inbox → se actualiza el estado según corresponda.
- Documento no existente en Inbox → se almacena con una nota indicando que fue sincronizado desde NDD (no recibido por casilla).
📝 La nota "Sincronizado desde NDD" permite identificar rápidamente si un documento llegó por casilla o fue descargado proactivamente por Gosocket.
Estados del documento (AuthorityStatus)
| Código | Estado | Descripción y acción |
|---|---|---|
| 1 | Pendiente | Esperando respuesta de NDD. Si el estado no cambia en más de 24 h, contacta a Soporte. |
| 2 | Autorizado | Flujo completado |
| 3 | Rechazado | Permite reenvío desde Inbox |
| 4 | Cancelado | Evento Cancelamento (110111) procesado |
| 5 | Error | Permite reenvío — activar TaxID en NDD Space, esperar 24 h y usar Re-Procesar documentos |
| 6 | No disponible en ET | Esperar sincronización (4 h) o reprocesar desde Inbox |
Procesamiento de eventos
Los eventos se reciben por casilla de recepción y se procesan únicamente si el documento relacionado ya existe en Inbox. Gosocket los almacena como adjuntos al XML original. Los eventos no pasan por validaciones de firma, estructura o estado.
NFS-e
Participantes
| Actor | Rol |
|---|---|
| Proveedores | Envían documentos en formato XML a la casilla de correo de Inbox |
| Gosocket | Plataforma de intercambio de documentos electrónicos |
| NDD | Intermediario entre Gosocket y las Prefeituras municipales |
| Prefeituras | Entidades gubernamentales locales encargadas de validar las NFS-e |
Pasos del flujo
-
Envío por proveedores — Los proveedores envían XML a la casilla de correo de Inbox. El procesamiento de PDF no está implementado actualmente (depende de la activación de OCR por NDD; se considerará a futuro).
-
Recepción por Gosocket — Gosocket recibe los XML. Los documentos no se procesan en Inbox en esta instancia.
-
Remisión a NDD — Gosocket envía los XML a la casilla NFS-e de NDD para su procesamiento. Esta casilla está configurada en Inbox para cada TaxID receptor.
-
Procesamiento en NDD — NDD convierte el XML a formato NFS-e. (La conversión de PDF vía OCR es implementación futura.)
-
Almacenamiento y procesamiento en NDD — NDD almacena los documentos y los envía a las Prefeituras locales para validación. El tiempo de procesamiento varía entre 8 y 72 horas.
-
Consulta periódica de Gosocket — Gosocket consulta a NDD cada hora. Los documentos disponibles se almacenan en Inbox y se confirma su recepción a NDD.
⚠️ Diferencias críticas respecto a CT-e y NF-e
- Solo se almacenan en Inbox los documentos con estado Aprobado o Cancelado/Anulado. Los en estado Error no se guardan.
- No existe reprocesamiento manual desde Inbox para NFS-e (CT-e y NF-e sí lo permiten).
- La cadencia de consulta es cada hora (CT-e/NF-e sincronizan cada 4 horas).