TF Fiscal
Documentación

NFS-e

Emitir NFS-e

Acepta la solicitud de inmediato y declara al emisor de forma asíncrona.

POST/openapi/v2/empresas/{empresaId}/nfse
Requiere las cabeceras de firma token, timestamp y sign, vea Autenticación.

La aceptación devuelve HTTP 200 sin cuerpo y la declaración al emisor es asíncrona; el resultado llega por webhook o por la consulta. Reenviar el mismo id reutiliza la tarea original y nunca emite un segundo documento.

La clave de acceso de 50 dígitos la genera el emisor, por lo que un documento que falló no tiene chaveAcesso y solo puede localizarse por identificacaoDps, el identificador de 45 caracteres que genera la plataforma. La plataforma enruta por el municipio de la empresa y el canal aparece como padraoMunicipal en la consulta; un municipio aún no admitido se rechaza en la aceptación (10018010).

Parámetros de ruta

empresaId*
stringIdentificador de la empresa

* Campo obligatorio

Cuerpo de la petición

id*
stringIdentificador de la solicitud
ambienteEmissao*
stringAmbiente
dataCompetencia
stringMes de competencia
objectEmisor
*
obligatorio cuando `emitente.tipo` no es `Prestador`
objectPrestador del servicio
objectTomador
objectIntermediario
*
objectServicio
objectSustitución
observacoes
stringObservaciones

* Campo obligatorio

200
Solicitud aceptada; sin cuerpo. El documento pasa a la declaración asíncrona al emisor.

Sin cuerpo de respuesta

  • La empresa debe estar aprobada y con certificado utilizable (10018004).
  • La empresa necesita su perfil de NFS-e (serie, encuadre en el Simples, régimen especial), procedente de la sección emissaoNFSe de Registrar empresa o mantenido por la operación; si falta, 10018005. Código de servicio, CNAE, NBS, alícuota de ISS y los códigos de PIS/COFINS e IBS/CBS no tienen valor por defecto en la empresa: van en cada solicitud.
  • ambienteEmissao debe ser el ambiente actual de la empresa. Tras el registro la empresa queda en Homologacao; el paso a producción lo hace la operación.
  • La plataforma enruta por el municipio de la empresa. Una empresa de São Paulo (padraoMunicipal Paulistana) necesita la inscripción municipal CCM; si falta en el perfil, la plataforma la consulta por CNPJ en la aceptación y solo rechaza 10018005 cuando no encuentra nada. En ese canal: solo emitente.tipo Prestador, sin substituicao, sin descuentos, sin pagamentosVinculados, sin NaoIncidencia, CNPJ solo numérico, codigoTributacaoMunicipal de 5 dígitos. ibsCbs es opcional y decide el diseño municipal: con ibsCbs + codigoNbs la nota sale en el diseño 2 (con IBS/CBS); sin él, en el diseño 1 (solo ISS). Tomador extranjero (NIF) solo en el diseño 2.
  • Tomador CNPJ: envíe los importes retenidos en servico.retencoes, u omítalos y la plataforma calcula por la clasificación oficial de retención del servicio y por cliente.orgaoPublico y cliente.optanteSimplesNacional; si falta información, 10018023 lista de una vez todo lo que falta. Un prestador ME/EPP con servicio sujeto a retención de INSS informa el anexo del Simples de ese servicio en servico.retencoes.anexoSimples.