Primeros pasos

Entornos

URL base de la Open API de TF Fiscal y el modelo de entorno de prueba / producción por empresa.

URL base

Entorno	URL base
Producción	`https://api.v2.tffiscal.com`

URL completa = URL base + ruta. El path usado en la firma de la solicitud incluye el prefijo /openapi (sin host, sin query string), vea Autenticación. Todos los ejemplos de esta documentación usan esta URL base.

Entorno de la empresa (emisión)

La emisión de documentos fiscales en Brasil se realiza contra dos entornos de la SEFAZ, y la plataforma modela esa división por empresa, no por host de la API:

Entorno de la empresa	Valor de `ambienteEmissao`	Finalidad	Validez fiscal
Prueba	`Homologacao`	Pruebas de integración y homologación	Ninguna, los documentos no tienen valor fiscal
Producción	`Producao`	Emisión real de documentos fiscales	Completa

Toda empresa registrada mediante Registrar empresa tiene un entorno actual. Las empresas recién registradas empiezan en prueba; el cambio a producción es una acción operativa del equipo de TF Fiscal.
El ambienteEmissao de una solicitud de emisión debe coincidir con el entorno actual de la empresa. Una discrepancia se rechaza con codigo 10004030, una protección estricta contra documentos de prueba emitidos en producción.
En ambos entornos se usan el mismo app_secret, los mismos endpoints y el mismo esquema de firma; solo cambian el estado de la empresa y el valor de ambienteEmissao.
La secuencia numérica y la serie enviadas en el registro son las que se usan en la emisión; a partir de ahí la plataforma gestiona la secuencia.

Endpoints de verificación y consulta de registro

Los endpoints de Verificación de NF-e y de consulta de registro no tienen conmutador de entorno: operan contra fuentes de datos oficiales. En las respuestas de verificación, ambienteEmissao (Producao / Homologacao) describe el documento enviado, no al llamador.

Camino a producción

Registre la empresa y vincule su certificado. La empresa entra en la cola de aprobación; emitir antes de la aprobación devuelve 10004004.
Integre en prueba: emita con ambienteEmissao=Homologacao, reciba el callback de autorización, consulte el documento y descargue linkDanfe / linkDownloadXml. Recorra la lista de verificación de integración de cada tipo de documento, incluidos los casos negativos y una cancelación.
Confirme lo básico operativo: servidores sincronizados por NTP (la ventana de ±300 s del timestamp aplica en todas partes), URL de webhook accesible públicamente y respondiendo 2xx, deduplicación implementada.
Pida a operaciones que cambie la empresa a producción y luego emita con ambienteEmissao=Producao. Hasta el cambio, una solicitud Producao devuelve 10004030.

Nota: todas las horas producidas por la plataforma son UTC, independientemente del entorno.

Notas operativas

Mientras una empresa está en el entorno de prueba, la latencia de emisión depende de la disponibilidad del entorno de prueba de la SEFAZ. Si un documento permanece en AguardandoAutorizacao más de unos minutos, contacte a la plataforma con el empresaId y el id del documento.
Las entregas de webhook de documentos de prueba siguen el mismo contrato, firma y calendario de reintentos que producción, vea Webhooks.