TF Fiscal

APIs principales

CFOP

2 endpoints

POST/api/cfop/get

Consultar CFOP

Devuelve un código de la tabla oficial de CFOP publicada por el Portal de la NF-e (Informe Técnico 2023.002), con todas las columnas: título y nota explicativa de la autoridad fiscal, vigencia, los nueve indicadores de la tabla, además de tipo (entrada o salida), alcance y grupo. La plataforma mantiene la tabla: cuando la autoridad fiscal publica una versión nueva, la actualización se aplica sin cambios en la integración, y el campo versao indica la versión en uso. Parámetro enviado en el body en JSON. Los códigos extintos siguen consultables, con ativo = false. Consulta gratuita.

Headers obligatorios

HeaderTipoDescripción
tokenstringToken de la empresa emisora
signstringFirma MD5
timestampstringUnix timestamp en segundos

Body

CampoTipoDescripción
cfop *stringCódigo de 4 dígitos, con o sin punto ("5101" o "5.101")

* Campo obligatorio.

Campos de la respuesta

CampoTipoDescripción
cfopstringCódigo de 4 dígitos, sin punto
descricaostring"Título do CFOP" de la tabla oficial (portugués)
nota_explicativastring"Descrição (nota explicativa)" de la tabla oficial: qué se clasifica en el código (portugués)
serieintPrimer dígito: 1, 2, 3 (entradas) o 5, 6, 7 (salidas)
tipostringentrada o saida (salida)
abrangenciastringintraestadual (mismo estado; series 1 y 5), interestadual (2 y 6) o exterior (3 y 7)
grupostringGrupo de la tabla oficial (5.100, 5.200, 5.400...)
grupo_descricaostringTítulo oficial del grupo (portugués)
vigencia_iniciostringInicio de vigencia (aaaa-mm-dd)
vigencia_fimstringFin de vigencia (aaaa-mm-dd); vacío = sin fin previsto
ind_nfeint1 = código admitido en la NF-e (modelo 55)
ind_comunicaint1 = prestación de servicio de comunicación
ind_transpint1 = prestación de servicio de transporte
ind_devolint1 = devolución de mercancía
ind_retorint1 = retorno de mercancía enviada anteriormente
ind_anulaint1 = anulación de valor
ind_remesint1 = remesa de mercancía
ind_combintIndicador de combustibles y lubricantes de la tabla oficial (0 = no; 1 y 2 según el Informe Técnico)
ind_exc_ibscbsintIndicador IBS/CBS de la tabla oficial (0 o 1), tal como fue publicado
ativoboolfalse = código extinto (vigencia terminada o retirado de la tabla); se mantiene para documentos antiguos
versaostringVersión de la tabla en uso (versión del Informe Técnico)
fontestringNombre de la fuente oficial
POST/api/cfop/list

Listar CFOP

Devuelve la tabla oficial de CFOP, con filtros opcionales por serie (primer dígito), tipo y alcance, enviados en el body en JSON. Todos los filtros son opcionales y combinables; body vacío ({}) devuelve la tabla completa (unos 620 códigos, con todas las columnas), adecuada para poblar un desplegable o una caché local, actualizada cuando cambie versao. Los items salen siempre en orden creciente de CFOP. La serie ya determina tipo y alcance (la serie 5 es siempre salida dentro del estado), por lo que los tres filtros se superponen; una combinación contradictoria devuelve lista vacía. Por defecto solo códigos activos. Consulta gratuita.

Headers obligatorios

HeaderTipoDescripción
tokenstringToken de la empresa emisora
signstringFirma MD5
timestampstringUnix timestamp en segundos

Body

CampoTipoDescripción
seriestringPrimer dígito: "1", "2", "3", "5", "6" o "7"
tipostring"entrada" o "saida" (salida)
abrangenciastring"intraestadual", "interestadual" o "exterior"
incluir_inativosstring"1" para devolver también los códigos extintos (ativo = false)

Todos los campos son opcionales. Sin ninguno de ellos, envíe {}.

Cada item tiene los mismos campos que /api/cfop/get, incluida la nota explicativa completa, siempre en orden creciente de CFOP. versao y fonte identifican la versión de la tabla en uso; total es la cantidad de items devueltos.