Primeros pasos
Visión general de la Open API de TF Fiscal, sus capacidades, los tres pasos de integración y por dónde seguir leyendo.
TF Fiscal es una plataforma de documentos fiscales para Brasil. A través de una única API HTTP firmada, su aplicación emite NF-e, CT-e y DC-e en nombre de las empresas que registra, verifica NF-e de terceros ante la SEFAZ, consulta datos registrales de CNPJ y CPF y recibe todos los resultados asíncronos mediante webhooks.
Capacidades
| Capacidad | Qué hace | Documentación |
|---|---|---|
| NF-e | Emitir, consultar y cancelar NF-e (modelo 55) para las empresas registradas; registrar y listar cartas de corrección (CC-e) | NF-e |
| CT-e | Emitir, consultar y cancelar CT-e (modelo 57, modal carretero) y registrar eventos posteriores a la autorización | CT-e |
| DC-e | Emitir, consultar y cancelar DC-e (modelo 99) para marketplaces y empresas que emiten para sí mismas | DC-e |
| Verificación de NF-e | Verificación en dos niveles de archivos XML de NF-e de terceros, además de consulta por clave de acceso (chave) | Verificación de NF-e |
| Consulta de registro | Datos registrales oficiales de un CNPJ, o de un CPF junto con su fecha de nacimiento | Consulta de registro |
| Webhooks | Callbacks firmados con resultados de emisión, eventos posteriores a la autorización y veredictos de verificación | Webhooks |
Las empresas, los certificados y la configuración de webhook se comparten entre todos los tipos de documento emitidos: una empresa registrada una sola vez puede emitir NF-e, CT-e y DC-e. Vea Empresas.
Cómo funciona una integración
- Obtenga credenciales y suscríbase. Solicite una aplicación y reciba su
app_secret. Se muestra una sola vez; consérvelo en el servidor. La plataforma suscribe luego la aplicación a los endpoints que necesite; llamar a un endpoint no suscrito devuelve HTTP 403 con el código10009005. - Verifique su firma. Cada solicitud se firma con
MD5(token + path + body + timestamp)y lleva las cabecerastoken,timestampysign. Haga del Echo de prueba su primera llamada: valida toda la cadena de firma y devuelve la identidad de su aplicación. - Integre por dominio. Las integraciones de emisión registran una empresa, vinculan su certificado, registran un webhook y luego emiten documentos. Las integraciones de verificación y de consulta de registro solo necesitan la llamada firmada, más un webhook para recibir los veredictos de verificación.
Por dónde empezar
- Inicio rápido: las cinco llamadas de una integración de emisión, con ejemplos curl ejecutables.
- Autenticación: modelo de credenciales, reglas de firma, vectores de firma conocidos e implementaciones de referencia en cinco lenguajes.
- Convenciones generales: formas de respuesta, tipificación de errores, idempotencia, límites de tasa, localización y tipos de datos.
- Entornos: URL base y cómo una empresa pasa del entorno de prueba a producción.
Nota: todos los endpoints están bajo
https://api.v2.tffiscal.com/openapi/.