API/Tutoriais


API para Emitir Nota pela API Transparente:
  • Endpoints
    POST https://tffiscal.com.br/api/emitir_transparente
    •             POST https://tffiscal.com.br/api/emitir_transparente
    
         const data = {

                        "token_empresa": "xxxxxxxxxxxxxxxxxxxxxb1n7054xxjgavfueunws",
                        "excluir_clientes_produtos_pos_emissao":false,
                        "is_transparente":true,
                        "name_dev":"Seu zee a9128a2",
                        "email_dev":"[email protected]",
                        "itens":[
                            {"name":"aaa aa","quantity":1,"unit_price":10.00,"perc_icms":"0.00","cfop_interno":"1102","cfop_externo":"6102","ncm":"4407.11.00","cst_pis":"49","cst_cofins":"49","cst_ipi":"99","sku":"1234567890123","co_ped_cliente_api":"1234567890"},
                            {"name":"aaa aa","quantity":1,"unit_price":10.00,"perc_icms":"0.00","cfop_interno":"1102","cfop_externo":"6102","ncm":"4407.11.00","cst_pis":"49","cst_cofins":"49","cst_ipi":"99","sku":"1234567890123","co_ped_cliente_api":"1234567890"}
                            ],
                         "cliente":{
                            "name":"Seu zee a9128a2",
                            "cpf_cnpj":"01433802902",
                            "ie_rg":"01433802902",
                            "email":"[email protected]",
                            "mobile":"15996000000",
                            "rua":"Rua das flores",
                            "numero":"123",
                            "country":"Brasil",
                            "bairro":"asdas",
                            "cep":"2222-000",
                            "state":"SP",
                            "city_id":"Sorocaba"
                            },
                          "payment": [{
                                    "amount": 100.00,
                                    "method": "cash",
                                    "note": "",
                                    "vencimento": "10/08/2024",
                                    "card_type": "credit",
                                    "card_number":"xxx-xxx-xxx-xxx",
                                    "card_holder_nam":"XXXXXXXXX",
                                    "card_transaction_numbe":"011",
                                    "card_security":"01",
                                                                    }],
                          "valor_total": 10.00,
                          "final_total": 10.00
                        }
                

             -token_empresa: O token da empresa para autenticação. 
             -excluir_clientes_produtos_pos_emissao: É para excluir clientes e produtos após a emissão da nfe(Nota fiscal eletrônica) por completa. 
             -is_transparente: É para emitir nota fiscal transparente. 
             -name_dev: Nome do desenvolvedor. 
             -email_dev: Email do desenvolvedor. 
             -itens: Lista de itens da nota fiscal. 
                 -name: Nome do produto. 
                 -co_ped_cliente_api: É o número do pedido do cliente. 
                 -sku: SKU do produto. 
                 -quantity: Quantidade do produto. 
                 -unit_price: Preço unitário do produto. 
                 -perc_icms: Percentual de ICMS do produto. 
                 -cfop_interno: CFOP interno do produto. 
                 -cfop_externo: CFOP externo do produto. 
                 -ncm: NCM do produto. 
                 -cst_pis: CST PIS do produto. 
                 -cst_cofins: CST COFINS do produto. 
                 -cst_ipi: CST IPI do produto. 
             -cliente: Informações do cliente. 
                 -name: Nome do cliente. 
                 -cpf_cnpj: CPF ou CNPJ do cliente. 
                 -ie_rg: IE ou RG do cliente. 
                 -email: Email do cliente. 
                 -telefone: Telefone do cliente. 
                 -rua: Rua do cliente. 
                 -numero: Número do cliente. 
                 -country: País do cliente. 
                 -bairro: Bairro do cliente. 
                 -cep: CEP do cliente. 
                 -estado: Estado do cliente. 
                 -uf: UF do estado do cliente exemplo SP. 
                 -city_id: Cidade do cliente. 
             -payment: Lista de pagamentos. 
                 -amount: Valor do pagamento. 
                 -method: Método de pagamento(cash, card, debit,pix). 
                 -note: Observação. 
                 -vencimento: Data de vencimento. 
                 -card_type: Tipo de cartão. 
                 -card_number: Número do cartão(01,02,03,04,05,06,07,08,09,99). 
                 -card_holder_name: Nome do titular do cartão. 
                 -card_transaction_number: Número da transação do cartão. 
                 -card_security: Código de segurança do cartão. 
             -valor_total: Valor total da nota fiscal. 
             -final_total: Valor total da nota fiscal.
    API para Listar Notas:
  • Endpoints
    POST https://tffiscal.com.br/api/listarnotas
    •             POST https://tffiscal.com.br/api/listarnotas
    
         const data = {                
                
                                        "token_empresa": "xxxxxxxxxxxxxxxxxxxxxb1n7054xxjgavfueunws",
                        "data_inicio":"2020-06-05",
                        "data_final":"2024-06-05"
                        }
                                    
                    
                                 -token_empresa: O token da empresa para autenticação. 
             -data_inicio: Data de início da pesquisa. 
             -data_final: Data final da pesquisa.
    API para Cancelar Nota:
  • Endpoints
    POST https://tffiscal.com.br/api/cancelar_nota
    •             POST https://tffiscal.com.br/api/cancelar_nota
    
         const data = {                
                
                                            "transaction_id": 182,
                            "justificativa": "Nãão quis mais essa nota gerada",

                            "token_empresa": "xxxxxxxxxxxxxxxxxxxxxb1n7054xxjgavfueunws",
                            "enviar_email_para_cliente":true
                        }
                                    
                    
                                 -transaction_id: O ID da transação da nota fiscal a ser cancelada. 
             -justificativa: A justificativa para o cancelamento da nota fiscal. 
             -token_empresa: O token da empresa para autenticação. 
             -enviar_email_para_cliente: É para enviar email ao cliente.
    API para Corrigir Nota com CCE:
  • Endpoints
    POST https://tffiscal.com.br/api/corrigir_cce
    • POST https://tffiscal.com.br/api/corrigirCce_api
    
const data = {
    "id": 123,
    "justificativa": "Correção na descrição do produto para incluir mais detalhes.",
    "token_empresa": "xxxxxxxxxxxxxxxxxxxxxb1n7054xxjgavfueunws",
"name_dev": "dev",
    "email_dev": "[email protected]"
    "descricao_produto": "Nova descrição com detalhamento técnico conforme cliente",
    "dados_complementares": "Observação importante incluída na nota fiscal",
    "codigo_interno_produto": "REF-8891B",
    "placa_veiculo": "ABC1234",
    "transportadora_nome": "Transportadora Sul Minas",
    "transportadora_uf": "SP",
    "transportadora_cidade": "Campinas",
    "transportadora_ie": "111111111111",
    "transportadora_cpf_cnpj": "12345678000199",
    "razao_social_destinatario": "Cliente XPTO Ltda",
    "telefone_destinatario": "(11) 99999-8888",
    "email_destinatario": "[email protected]",
    "endereco_numero": "456",
    "endereco_complemento": "Fundos",
    "endereco_cep": "13025-120",
    "numero_fatura": "FAT-2025-003",
    "duplicata_numero": "DUP123456"
}
    

 -id: O ID da nota fiscal (transação) que será corrigida. 
 -justificativa: Texto com a correção a ser registrada na CCE. 
 -token_empresa: Token da empresa para autenticação. 
 -name_dev: (opcional) Nome do desenvolvedor que está integrando. 
 -email_dev: (opcional) E-mail para registro de log e rastreabilidade. 

 -descricao_produto: Novo texto descritivo do produto (sem alterar valores). 
 -dados_complementares: Texto adicional a ser incluído na nota. 
 -codigo_interno_produto: Referência interna do produto para ajustes cadastrais. 
 -placa_veiculo: Placa do veículo de transporte. 
 -transportadora_nome: Nome da transportadora. 
 -transportadora_uf: UF da transportadora. 
 -transportadora_cidade: Cidade da transportadora. 
 -transportadora_ie: Inscrição estadual da transportadora. 
 -transportadora_cpf_cnpj: CPF ou CNPJ da transportadora. 
 -razao_social_destinatario: Correção leve no nome da empresa do destinatário. 
 -telefone_destinatario: Correção no telefone de contato. 
 -email_destinatario: Correção no e-mail de contato. 
 -endereco_numero: Correção no número do endereço. 
 -endereco_complemento: Correção no complemento do endereço. 
 -endereco_cep: Correção no CEP, desde que não altere cidade ou UF. 
 -numero_fatura: Número da fatura vinculada à nota. 
 -duplicata_numero: Número de duplicata para cobrança.
    API para Inutilizar Numeração de Nota Fiscal:
  • Endpoints
    POST https://tffiscal.com.br/api/inutilizar_nfe
    • POST https://tffiscal.com.br/api/inutilizar_nfe
const data = {
    "serie": 1,
    "numero_inicial": 101,
    "numero_final": 105,
    "justificativa": "Documentos não emitidos por erro operacional",
    "token_empresa": "xxxxxxxxxxxxxxxxxxxxxb1n7054xxjgavfueunws"
}


- serie: Número da série da nota fiscal a ser inutilizada. 
- numero_inicial: Número inicial da faixa a ser inutilizada. 
- numero_final: Número final da faixa a ser inutilizada. 
- justificativa: Motivo da inutilização (mínimo 15, máximo 90 caracteres). 
- token_empresa: O token da empresa para autenticação.
    API para Registrar Evento de Insucesso na Entrega (NF-e):
  • Endpoints
    POST https://tffiscal.com.br/api/registrar_insucesso_entrega
    • POST https://tffiscal.com.br/api/registrar_insucesso_entrega
    
const data = {
    "chave_nfe": "35190112345678000123550010000000011234567890",
    "motivo": "Destinatário ausente no local de entrega",
    "token_empresa": "xxxxxxxxxxxxxxxxxxxxxb1n7054xxjgavfueunws"
}
    
- chave_nfe: A chave de acesso da nota fiscal eletrônica (44 dígitos). 
- motivo: Motivo pelo qual a entrega da carga não foi concluída. 
- token_empresa: O token da empresa para autenticação.
    API para Consultar Nota:
  • Endpoints
    POST https://tffiscal.com.br/api/consultar_nota
    •             POST https://tffiscal.com.br/api/consultar_nota
    
         const data = {

                                
                
                                            "co_ped_cliente_api": "xxxxxxxxxx",
                            "token_empresa": "xxxxxxxxxxxxxxxxxxxxxb1n7054xxjgavfueunws"
                        }
                                    
                    
                                  -co_ped_cliente_api: O número do pedido do cliente associado à nota fiscal. 
              -token_empresa: O token da empresa para autenticação.
    Modelos Fiscais:
    ATENÇÃO: Os modelos fiscais são baseados em IA do uso comum de várias empresas e projetos. Por favor confira com seu contador ou time administrativo contábil o uso do mesmo. Não nos responsabilizamos pelo uso imperito de um modelo. Att. TFfiscal
    Id Descrição CFOP Saída Estadual CFOP Entrada Estadual CFOP Saída Interestadual CFOP Entrada Interestadual
    1 Venda Fisica 5199 1199 6100 2100
    10 Venda Fisica 5102 5102 6108 6108
    18 Venda interestadual Juridica 5102 1102 6102 1102
    Feedbacks de Erros:
    Descrição Solução
    Rejeição:Inscrição estadual do emitente invalida! Por favor consulte via API ou pelo console Consulte via API ou pelo console
    Rejeição: Emissor não habilitado para emissão da NF-e, com o CNPJ consulte no Sintegra a situação da empresa com a Recieta Federal ou se possui alguma pendencia no Sefaz Consulte no Sintegra a situação da empresa com a Recieta Federal ou se possui alguma pendencia no Sefaz
    Duplicidade de NF-e, mude o ultimo numero de nota emitida Mude o ultimo numero de nota emitida via console ou API
    Token invalido Token invalido, por favor verifique o token da empresa
    Resposta vazia Resposta vazia, por favor verifique os dados enviados se esta no formato certo o json, se a codificação esta utf8 ou entre em contato com o Suporte