Emitir NFS-e

NFS-e (Nota Fiscal de Serviços Eletrônica) es la factura electrónica de servicios. A diferencia de NF-e, un servicio no tiene código de clasificación fiscal — un ítem de NFS-e solo necesita descripción y monto.

stackin emite a través del sistema nacional de NFS-e (ADN), así que la misma integración funciona sin importar en qué municipio esté registrado el emisor — sin webservice por ciudad que integrar por separado.

Cancelación, consulta e historial funcionan igual que NF-e: una clave de acceso, un dashboard, una línea de tiempo de envío.

Esa capa nacional es la razón por la que las integraciones de NFS-e suelen ser más difíciles de construir que las de NF-e: históricamente, cada ciudad operaba su propio webservice, su propio esquema XML y sus propias particularidades, lo que significaba que una empresa vendiendo servicios a nivel nacional necesitaba una integración separada por cada municipio en el que operaba.

El trabajo de stackin es absorber esa variación por completo — la solicitud que envías no cambia según la ciudad del emisor, y la forma de la respuesta es idéntica a la de NF-e siempre que es posible, así que un equipo ya integrado con facturas de producto puede agregar facturas de servicio sin aprender un segundo modelo mental.

El impuesto sobre servicio (ISS) es municipal, no federal, y a diferencia de los grupos de impuesto de NF-e, normalmente se retiene o declara fuera de la propia llamada de emisión — por eso un ítem de NFS-e se mantiene intencionalmente mínimo, en lugar de cargar el mismo peso de clasificación fiscal que un ítem de producto.

Igual que en NF-e, el certificado digital y los datos de registro del emisor se resuelven desde la configuración de la empresa, no se pasan en la llamada — la única decisión por ítem es cuál fue el servicio y cuánto costó.

Ver Emisión de NFSe para cómo esa superficie de la API encaja en el resto de stackin.