Configuración de Facturación con Focus NFe (Brasil)

Esta guía explica cómo conectar tu cuenta de Focus NFe para emitir NFS-e, NF-e y NFC-e directamente desde EzGYM, con envío automático a la SEFAZ o a la prefectura municipal.

1. ¿Qué necesitas?

  • Empresa activa con CNPJ y situación regular ante la Receita Federal (fisco federal brasileño).
  • Para NFS-e: inscripción municipal como prestador de servicios activa en la prefectura.
  • Para NF-e / NFC-e: Inscripción Estadual activa y certificado digital A1 o A3 configurado en Focus NFe.
  • Una cuenta en Focus NFe. El registro se hace en su sitio; EzGYM actúa como integrador.
  • Tu Token de API de Focus NFe.

2. Dónde encontrar tu Token en Focus NFe

  1. Ingresa en app.focusnfe.com.br.
  2. En el menú superior haz clic en el nombre de tu empresa y luego en Minha conta o Tokens de acesso.
  3. Copia el token generado; es una cadena alfanumérica que se usará como contraseña en la autenticación.

Si todavía no registraste tu empresa en Focus NFe, hacélo antes de configurar EzGYM. Focus NFe necesita tus datos fiscales y el certificado digital para emitir documentos válidos.

3. Configurar en EzGYM

Ir a Configuración → Facturación en el panel de administración y completar los campos del bloque Focus NFe.

Campos obligatorios para todos los tipos

Campo Descripción
Habilitar Focus NFe Activar para habilitar la emisión.
Ambiente Focus NFe Usar Homologación para pruebas, Producción para emisión real.
Token Focus NFe El token copiado en el paso anterior.
CNPJ emisor Focus NFe CNPJ de la empresa (solo números, 14 dígitos).

Campos para NFS-e (servicios — el más común en gimnasios)

Campo Descripción
Inscripción municipal Número de inscripción municipal como prestador de servicios.
Código IBGE del municipio Código IBGE del municipio (ej.: 3550308 para São Paulo). Se consulta en ibge.gov.br.
Optante Simples Nacional Marcar si la empresa es optante.
Item lista servicio NFS-e Código LC 116/2003 que describe el servicio (ej.: 0107 para actividades de acondicionamiento físico).
Código tributario municipal NFS-e Código interno de la prefectura, a menudo igual al código LC 116.
Alícuota ISS NFS-e Alícuota del ISS aplicable (ej.: 5 para 5 %). Si se deja vacío, Focus NFe usa la alícuota cargada en la empresa.
Naturaleza NFS-e 1 = Tributación en el municipio (por defecto). Cambiar solo si el contador lo indica.

Campos para NF-e / NFC-e (venta de productos)

Campo Descripción
Inscripción estadual Focus NFe IE de la empresa en el estado (solo números).
Régimen tributario Focus NFe 1 = Simples Nacional, 2 = Simples Nacional — excedente, 3 = Régimen Normal.
CFOP NF-e/NFC-e Código de operación fiscal (ej.: 5102 para venta dentro del estado).
NCM por defecto NF-e/NFC-e Código de Nomenclatura Común del Mercosur del producto (ej.: 49111090).
Situación tributaria ICMS Código de tributación ICMS (ej.: 102 para Simples sin permiso de crédito).
Modalidad de flete 9 = Sin flete (por defecto para gimnasio).

4. Probar antes de producción

Emitir documentos en Homologación antes de pasar a Producción. Los documentos de homologación no tienen valor fiscal y no se envían a la prefectura/SEFAZ real.

Lista de verificación antes de pasar a producción:

  • [ ] Declaró al menos un documento en homologación sin errores.
  • [ ] El nombre y CNPJ del emisor aparecen correctamente en el PDF.
  • [ ] Alícuota ISS confirmada con el contador (para NFS-e).
  • [ ] Certificado digital vigente cargado en Focus NFe (para NF-e / NFC-e).

Preguntas frecuentes

  • ¿Qué tipo de comprobante necesita un gimnasio?
    Normalmente NFS-e (Nota Fiscal de Servicios Electrónica). Si además vende productos, puede necesitar NFC-e para venta al consumidor.

  • ¿EzGYM cobra algo extra por la integración?
    No. EzGYM actúa como integrador tecnológico gratuito. El costo es el plan de emisión de Focus NFe.

  • La alícuota ISS varía según municipio
    Sí, cada prefectura define la alícuota entre el 2 % y el 5 % (límites de LC 116). Consultar con el contador.