TF Fiscal

APIs principais

CFOP

2 endpoints

POST/api/cfop/get

Consultar CFOP

Devolve um código da tabela oficial de CFOP publicada pelo Portal da NF-e (Informe Técnico 2023.002), com todas as colunas: título e nota explicativa do Fisco, vigência, os nove indicadores da tabela, além de tipo (entrada ou saída), abrangência e grupo. A tabela é mantida pela plataforma: quando o Fisco publica versão nova, a atualização entra sem mudança na integração, e o campo versao indica a versão em uso. Parâmetro passado no body em JSON. Códigos extintos continuam consultáveis, com ativo = false. Consulta gratuita.

Headers obrigatórios

HeaderTipoDescrição
tokenstringToken da empresa emissora
signstringAssinatura MD5
timestampstringUnix timestamp em segundos

Body

CampoTipoDescrição
cfop *stringCódigo com 4 dígitos, com ou sem ponto ("5101" ou "5.101")

* Campo obrigatório.

Campos da resposta

CampoTipoDescrição
cfopstringCódigo com 4 dígitos, sem ponto
descricaostring"Título do CFOP" da tabela oficial, em português
nota_explicativastring"Descrição (nota explicativa)" da tabela oficial: o que se classifica no código
serieintPrimeiro dígito: 1, 2, 3 (entradas) ou 5, 6, 7 (saídas)
tipostringentrada ou saida
abrangenciastringintraestadual (séries 1 e 5), interestadual (2 e 6) ou exterior (3 e 7)
grupostringGrupo da tabela oficial (5.100, 5.200, 5.400...)
grupo_descricaostringTítulo oficial do grupo
vigencia_iniciostringInício de vigência do código (aaaa-mm-dd)
vigencia_fimstringFim de vigência (aaaa-mm-dd); vazio = sem fim previsto
ind_nfeint1 = código admitido na NF-e (modelo 55)
ind_comunicaint1 = prestação de serviço de comunicação
ind_transpint1 = prestação de serviço de transporte
ind_devolint1 = devolução de mercadoria
ind_retorint1 = retorno de mercadoria remetida anteriormente
ind_anulaint1 = anulação de valor
ind_remesint1 = remessa de mercadoria
ind_combintIndicador de combustíveis e lubrificantes da tabela oficial (0 = não; 1 e 2 conforme o Informe Técnico)
ind_exc_ibscbsintIndicador IBS/CBS da tabela oficial (0 ou 1), repassado como publicado
ativoboolfalse = código extinto (fim de vigência no passado ou retirado da tabela); mantido para documentos antigos
versaostringVersão da tabela em uso (versão do Informe Técnico)
fontestringNome da fonte oficial
POST/api/cfop/list

Listar CFOP

Devolve a tabela oficial de CFOP, com filtros opcionais por série (primeiro dígito), tipo e abrangência, passados no body em JSON. Todos os filtros são opcionais e combináveis; body vazio ({}) devolve a tabela inteira (cerca de 620 códigos, com todas as colunas), adequada para montar um dropdown ou um cache local, atualizado quando versao mudar. Os itens saem sempre em ordem crescente de CFOP. A série já determina tipo e abrangência (série 5 é sempre saída dentro do estado), então os três filtros se sobrepõem; uma combinação contraditória devolve lista vazia. Por padrão só códigos ativos. Consulta gratuita.

Headers obrigatórios

HeaderTipoDescrição
tokenstringToken da empresa emissora
signstringAssinatura MD5
timestampstringUnix timestamp em segundos

Body

CampoTipoDescrição
seriestringPrimeiro dígito: "1", "2", "3", "5", "6" ou "7"
tipostring"entrada" ou "saida"
abrangenciastring"intraestadual", "interestadual" ou "exterior"
incluir_inativosstring"1" para devolver também os códigos extintos (ativo = false)

Todos os campos são opcionais. Sem nenhum deles, envie {}.

Cada item tem os mesmos campos de /api/cfop/get, com a nota explicativa completa, sempre em ordem crescente de CFOP. versao e fonte identificam a versão da tabela em uso; total é a quantidade de itens devolvidos.