Conectar eNotas (Nota Gateway)

Con eNotas (hoy Nota Gateway) conectado, Vipter envía cada pedido pagado a eNotas, que emite la factura (nota fiscal, el documento fiscal brasileño) en nombre de tu empresa. Cuando el pedido se reembolsa por completo o sufre un contracargo, Vipter pide la cancelación. Para entender las reglas de emisión, mira Facturas: cómo funcionan.

Paso 1: copiar la API Key y el ID de la empresa en eNotasCopiar enlace de la sección

1. En el panel de eNotas, copia la API Key de tu cuenta.
2. En Empresas, busca la empresa que va a emitir las facturas y copia su ID.

Paso 2: pegar los datos en VipterCopiar enlace de la sección

1. En el panel de Vipter, abre General›Integraciones›Facturas›eNotas (Nota Gateway).
2. En Conexión, completa los campos numerados.

3. En Entorno, elige Sandbox / homologación para las primeras pruebas. La homologación usa el entorno de pruebas del municipio (no todos lo tienen).
4. Elige el Tipo de factura por defecto. Vale para los productos sin envío. Los productos con envío siempre generan NF-e.
5. Revisa los interruptores:
   • Emitir al pagar: emite en cuanto se paga el pedido.
   • Cancelar en el reembolso: pide la cancelación en el reembolso total y en el contracargo.
   • Enviar por correo al cliente: eNotas envía la factura al correo del comprador.

Paso 3: completar los valores fiscalesCopiar enlace de la sección

En las tarjetas Valores NFS-e y Valores NF-e, justo debajo, completa los códigos que valen para todos los productos. Lo que pide cada campo está en Valores fiscales de la integración. Los códigos completados en el producto se usan en lugar de estos.

Después, haz clic en Guardar, debajo de las dos tarjetas.

Paso 4: probarCopiar enlace de la sección

1. Haz clic en Probar credenciales. Vipter consulta la empresa en eNotas con la clave y el ID guardados. Esta consulta no emite factura.
2. Con el entorno en Sandbox / homologación, haz una compra de prueba y sigue la factura en la tarjeta Facturas del pedido. Mira Probar tu tienda.

Si el mensaje de éxito viene con "(cadastro incompleto)" (registro incompleto), la clave y el ID están bien, pero faltan datos obligatorios de la empresa en eNotas. Completa el registro allí antes de emitir.

Cuando la factura de prueba esté correcta, vuelve a la integración, cambia el Entorno a Producción y guarda. A partir de ahí, cada pedido pagado genera una factura real.

Cómo funciona despuésCopiar enlace de la sección

• Pedido pagado: el ID del pedido va como identificador externo de la factura en eNotas.
• NFS-e: van el cliente con dirección, la descripción, el ítem de la LC 116, el código municipal, el CNAE (código brasileño de actividad económica), la alícuota del ISS, si el ISS es retenido, el descuento y el valor. El número del pedido va en las observaciones.
• NF-e: van la naturaleza de la operación, un ítem por producto (principal y order bumps) con CFOP, NCM, unidad, origen, envío y descuento, la modalidad del flete y la forma de pago. El comprador va como consumidor final, no contribuyente del ICMS (impuesto estatal sobre la circulación de mercancías), en una venta por internet.
• Impuestos de la NF-e: Vipter envía el ICMS con situación tributaria 102 y el PIS y la COFINS con situación 07. Son los códigos que usan las empresas del Simples Nacional (el régimen tributario simplificado de Brasil para pequeñas empresas). Si tu empresa está en otro régimen, habla con tu contador antes de emitir NF-e.
• Reembolso total o contracargo: Vipter pide la cancelación. El plazo para cancelar es el del municipio (NFS-e) o el de la SEFAZ, la autoridad tributaria del estado (NF-e).

Problemas comunesCopiar enlace de la sección

• Fallo en la prueba

  La API Key o el ID de la empresa están mal. El ID debe ser el de la empresa emisora, no el de tu cuenta. Cópialos de nuevo, guarda y prueba otra vez.

• La factura quedó como Falló con "el cliente no tiene dirección completa"

  Falta la calle, el CEP (código postal de Brasil), la ciudad o el estado. Abre el cliente en Ventas›Clientes, haz clic en Editar, completa la dirección y emite de nuevo desde el pedido. Si el propio pedido ya tiene una dirección incompleta, Vipter usa la del pedido: emite esa factura directamente en eNotas.

• La factura quedó como Falló con "el cliente no tiene CPF/CNPJ"

  La NF-e exige el documento del comprador, el CPF o el CNPJ (número de contribuyente de Brasil, de persona o de empresa). Abre el cliente en Ventas›Clientes, haz clic en Editar, completa el CPF o el CNPJ y emite de nuevo desde el pedido.

• La factura quedó como Falló o Rechazada con un mensaje de eNotas

  El motivo aparece debajo del estado. La mayoría de las veces es un código fiscal o un dato de la empresa. Corrígelo en los valores predeterminados, en el producto o en el registro de eNotas y emite de nuevo desde el pedido.

Qué hacer despuésCopiar enlace de la sección

• Mira Facturas: cómo funcionan para lo que va en cada factura y los valores fiscales.
• Completa los datos fiscales de cada producto cuando los códigos cambian de un producto a otro.