Documentação de Integração

POST https://ianfe.com.br/functions/operacaoFiscal
Content-Type: application/json

Body: {
  "secret_key": "...",
  "api_key": "...",
  "action": "transmitir" | "cancelar" | "corrigir" | "danfe",
  "modelo": "nfe",
  ...
}

// ✅ CORRETO - Backend (Node.js)
const SECRET_KEY = process.env.IANFE_SECRET_KEY;
const API_KEY = process.env.IANFE_API_KEY;

// ❌ ERRADO - Frontend (React, Vue, etc.)
const SECRET_KEY = "sellerx_Ahot8B9MXuoy2R$W"; // NUNCA faça isso!

// Node.js (axios)
axios.post(URL, payload, { timeout: 70000 })

// Python (requests)
requests.post(URL, json=payload, timeout=70)

// PHP (cURL)
curl_setopt($ch, CURLOPT_TIMEOUT, 70);

✓ secret_key e api_key estão no body
✓ modelo: "nfe" (ou omitido — padrão é nfe)
✓ cnpj_emitente tem 14 dígitos, só números
✓ nota.serie sem zeros à esquerda ("10" não "010")
✓ nota.numero é sequencial e não foi usado antes
✓ nota.ambiente: "1" produção, "2" homologação
✓ destinatario: preenchido cpf OU cnpj, não os dois
✓ itens[].unidade em MAIÚSCULO ("UN" não "un")
✓ itens[].ncm com 8 dígitos numéricos
✓ itens[].quantidade e valorUnitario com 4 casas decimais
✓ itens[].valorTotal com 2 casas decimais
✓ total.vNF igual à soma dos valorTotal dos itens
✓ pagamento.detPag[].vPag = "0.00" se tPag = "90"
✓ Em homologação (ambiente="2"): destinatario.xNome = "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO"
✓ PIS/COFINS CST 07: enviar apenas { "CST": "07" } (sem vBC/pPIS/vPIS)
✓ Não enviar indPag dentro de detPag (depreciado)
✓ tPag "99" (Outros): enviar "xPag" com a descrição real do meio de pagamento (ex: "PIX", "TRANSFERENCIA")
✓ transporte.transportadora só com modFrete 0, 1 ou 2, e com xNome + cnpj (ou cpf)
✓ Texto adicional da nota em nota.infAdic.infCpl (não em observacao/obs)
✓ Devolução (finNFe=4): nItemOriginal em todos os itens (obrigatório na prática a partir de 16/11/2026)
✓ Ler o campo "avisos" da resposta e corrigir o que for apontado
✓ Timeout da chamada HTTP configurado para 70 segundos

{
  "secret_key": "sellerx_Ahot8B9MXuoy2R$W",
  "api_key":    "yzV3C1hYWO",
  "modelo":     "nfe",
  ...
}

{
  "evento":       "transmitir",
  "timestamp":    "2026-05-16T14:30:00.000Z",
  "sucesso":      true,
  "cStat":        "100",
  "xMotivo":      "Autorizado o uso da NF-e",
  "nProt":        "135260000123456",
  "chNFe":        "35260512345678000199550010000001231234567890",
  "dhRecbto":     "2026-05-16T14:30:00-03:00",
  "xmlProtocolo": "<?xml version="1.0"...>",
  "detalhe":      ""
}

{
  "nItem": 1,
  "codigo": "266",
  "descricao": "TIRANTE",
  "ncm": "84529099",
  "cfop": "5102",
  "unidade": "UN",
  "quantidade": "4.0000",
  "valorUnitario": "47.0000",
  "valorTotal": "188.00",
  "observacao": "Lote 2026-A — garantia 90 dias",
  "icms": { "CSOSN": "102", "orig": "0" }
}

"total": {
  "vFrete": "50.00",
  "vDesc": "10.00"
}

"itens": [
  {
    "nItem": 1,
    "codigo": "266",
    "descricao": "TIRANTE",
    "valorTotal": "188.00",
    "frete": "15.00",
    "desconto": "2.50"
  }
]

"transporte": {
  "modFrete": "1",
  "transportadora": {
    "xNome": "TRANSPORTES EXEMPLO LTDA",
    "cnpj": "00000000000191",
    "ie": "123456789",
    "xEnder": "RUA A, 100",
    "xMun": "FRANCA",
    "uf": "SP"
  },
  "veiculo": { "placa": "ABC1D23", "uf": "SP" },
  "volumes": [
    {
      "quantidade": 1,
      "especie": "CAIXA",
      "marca": "SUA_MARCA",
      "numeracao": "123456",
      "pesoBruto": 1.500,
      "pesoLiquido": 1.200
    }
  ]
}

"infAdic": { "infCpl": "Pedido nº 9988 - entregar no periodo da manha", "infAdFisco": "" }

{
  "secret_key":    "sellerx_Ahot8B9MXuoy2R$W",
  "api_key":       "yzV3C1hYWO",
  "action":        "transmitir",
  "modelo":        "nfe",
  "invoice_id":    "SEU-ID-INTERNO-001",
  "cnpj_emitente": "37850573000114",
  "url_logotipo":  "https://cdn.suaempresa.com/logo.png",

  "nota": {
    "naturezaOperacao": "VENDA DE MERCADORIA",
    "serie": "1",
    "numero": "123",
    "ambiente": "1",

    "destinatario": {
      "cpf": "25063007830",
      "cnpj": "",
      "xNome": "João da Silva",
      "indIEDest": "9",
      "IE": "",
      "telefone": "1133334444",
      "cMun": "3550308",
      "xMun": "SAO PAULO",
      "uf": "SP",
      "cep": "01310100",
      "logradouro": "Rua Augusta",
      "numero": "500",
      "complemento": "",
      "bairro": "Consolação"
    },

    "itens": [
      {
        "nItem": 1,
        "codigo": "PROD001",
        "descricao": "Camiseta Masculina Algodão",
        "ncm": "61091000",
        "cfop": "5102",
        "unidade": "UN",
        "quantidade": "2.0000",
        "valorUnitario": "75.0000",
        "valorTotal": "150.00",
        "icms": { "CSOSN": "102", "orig": "0" },
        "pis":    { "CST": "07" },
        "cofins": { "CST": "07" }
      }
    ],

    "total": {
      "vBC": "0.00", "vICMS": "0.00", "vICMSDeson": "0.00",
      "vFCP": "0.00", "vBCST": "0.00", "vST": "0.00",
      "vFCPST": "0.00", "vFCPSTRet": "0.00",
      "vProd": "150.00", "vFrete": "0.00", "vSeg": "0.00",
      "vDesc": "0.00", "vII": "0.00", "vIPI": "0.00",
      "vIPIDevol": "0.00", "vPIS": "0.00", "vCOFINS": "0.00",
      "vOutro": "0.00", "vNF": "150.00"
    },

    "transporte": { "modFrete": "9" },

    "pagamento": {
      "detPag": [
        { "tPag": "01", "vPag": "150.00" }
      ]
    },

    "infAdic": {
      "infCpl": "Pedido nº 9988",
      "infAdFisco": ""
    }
  }
}

{
  "secret_key":    "sellerx_Ahot8B9MXuoy2R$W",
  "api_key":       "yzV3C1hYWO",
  "action":        "transmitir",
  "modelo":        "nfe",
  "cnpj_emitente": "37850573000114",
  "nota": {
    "naturezaOperacao": "VENDA DE MERCADORIA",
    "serie": "1",
    "numero": "123",
    "ambiente": "1",
    "destinatario": {
      "cpf": "25063007830",
      "xNome": "João da Silva",
      "uf": "SP"
    },
    "itens": [
      {
        "nItem": 1,
        "codigo": "PROD001",
        "descricao": "Camiseta",
        "ncm": "61091000",
        "cfop": "5102",
        "unidade": "UN",
        "quantidade": "2.0000",
        "valorUnitario": "75.0000",
        "valorTotal": "150.00"
      }
    ],
    "total": { "vNF": "150.00", "vProd": "150.00" },
    "pagamento": {
      "detPag": [
        { "tPag": "01", "vPag": "150.00" }
      ]
    }
  }
}

{
  "itens": [
    {
      "nItem": 1,
      "descricao": "Item COM tributo calculado por você",
      "cfop": "5405",
      "icms": { "CSOSN": "500", "orig": "0" },
      "valorTotal": "100.00"
    },
    {
      "nItem": 2,
      "descricao": "Item SEM tributo (ianfe vai calcular para você)",
      "cfop": "5102",
      "valorTotal": "50.00"
    }
  ]
}

{
  "codigo": "CAM01",
  "descricao": "CAMARAO CONGELADO",
  "ncm": "03061700",
  "cest": "1706400",
  "cfop": "6102",
  "unidade": "KG",
  "quantidade": "100.0000",
  "valorUnitario": "30.0000",
  "valorTotal": "3000.00",
  "icms": {
    "CST": "20",
    "orig": "0",
    "modBC": "3",
    "pRedBC": "41.18",
    "vBC": "1764.60",
    "pICMS": "17.00",
    "vICMS": "300.00",
    "cBenef": "SC830001"
  }
}

{
  "nota": { "...": "..." },
  "emitente": { "...": "..." },
  "empresa": { "...": "..." },
  "infRespTec": {
    "cnpj": "11222333000181",
    "xContato": "NOME DO CONTATO TECNICO",
    "email": "contato@suaempresa.com.br",
    "fone": "4700000000"
  }
}

{
              "sucesso":      true,
              "autorizada":   true,
              "cStat":        "100",
              "xMotivo":      "Autorizado o uso da NF-e",
              "nProt":        "135260000123456",
              "chNFe":        "35260512345678000199550010000001231234567890",
              "dhRecbto":     "2026-05-16T14:30:00-03:00",
              "tpEmis":       "1",
              "contingencia": false,
              "svc":          null,
              "motivoContingencia": null,
              "jobId":        "nfe_12345678000199_1716825600000",
              "xmlProtocolo": "<?xml version="1.0"...>"
              }

{
               "secret_key":    "sellerx_Ahot8B9MXuoy2R$W",
               "api_key":       "yzV3C1hYWO",
               "action":        "cancelar",
               "modelo":        "nfe",
               "invoice_id":    "SEU-ID-INTERNO-001",
               "cnpj_emitente": "37850573000114",
               "ambiente":      "1",

               "cancelamento": {
               "chave":  "35260512345678000199550010000001231234567890",
               "numero": 123,
               "nProt":  "135260000123456",
               "xJust":  "Cancelamento a pedido do cliente por duplicidade de pedido"
               }
               }

{
  "sucesso":      true,
  "autorizada":   true,
  "cStat":        "135",
  "xMotivo":      "Evento registrado e vinculado a NF-e",
  "nProt":        "135260000654321",
  "dhRecbto":     "2026-05-16T15:00:00-03:00",
  "jobId":        "cancel_12345678000199_1716825600000",
  "xmlProtocolo": "<?xml version="1.0"...>"
}

{
  "sucesso":    false,
  "autorizada": false,
  "erro":       "Evento não permitido",
  "cStat":      "242",
  "xMotivo":    "Cancelamento fora do prazo",
  "detalhe":    "Cancelamento permitido apenas em até 24 horas após a autorização",
  "chNFe":      "35260512345678000199550010000001231234567890",
  "dhRecbto":   "2026-05-16T14:30:00-03:00"
}

{
              "secret_key":    "sellerx_Ahot8B9MXuoy2R$W",
              "api_key":       "yzV3C1hYWO",
              "action":        "corrigir",
              "modelo":        "nfe",
              "cnpj_emitente": "37850573000114",
              "ambiente":      "1",

              "correcao": {
              "chave":      "35260512345678000199550010000001231234567890",
              "nSeqEvento": 1,
              "xCorrecao":  "Correcao no campo de observacoes da nota fiscal"
              }
              }

{
              "ambiente": "1",
              "emitente": {
              "cnpj": "37850573000114",
              "certificadoBase64": "MIIKX...",
              "senhaCertificado": "1234"
              },
              "correcao": {
              "chave":      "35260512345678000199550010000001231234567890",
              "nSeqEvento": 1,
              "xCorrecao":  "Correcao no campo de observacoes da nota fiscal"
              }
              }

{
  "sucesso":      true,
  "autorizada":   true,
  "cStat":        "135",
  "xMotivo":      "Evento registrado e vinculado a NF-e",
  "nProt":        "135260000789012",
  "dhRecbto":     "2026-05-16T16:00:00-03:00",
  "jobId":        "cce_12345678000199_1716825600000",
  "xmlProtocolo": "<?xml version="1.0"...>"
}

{
  "sucesso":    false,
  "autorizada": false,
  "erro":       "Evento não permitido",
  "cStat":      "242",
  "xMotivo":    "Cancelamento fora do prazo",
  "detalhe":    "A CC-e deve ser enviada enquanto a nota ainda estiver dentro do prazo de validade"
}

{
  "secret_key":    "sellerx_Ahot8B9MXuoy2R$W",
  "api_key":       "yzV3C1hYWO",
  "action":        "inutilizar",
  "modelo":        "nfe",
  "invoice_id":    "SEU-ID-INTERNO-001",
  "cnpj_emitente": "04395449000157",

  "inutilizacao": {
    "cnpj":     "04395449000157",
    "uf":       "SP",
    "serie":    1,
    "nNFIni":   50,
    "nNFFin":   55,
    "xJust":    "Numeração inutilizada por erro no sistema de emissão",
    "ambiente": 1,
    "ano":      "26"
  }
}

{
  "sucesso":      true,
  "autorizada":   true,
  "jobId":        "inut_04395449000157_1716820000000",
  "cStat":        "102",
  "xMotivo":      "Inutilização de número homologado",
  "nProt":        "135260000000001",
  "dhRecbto":     "2026-05-28T10:30:00-03:00",
  "xmlProtocolo": "<?xml version="1.0"...inutNFeProc..."
}

{
  "sucesso":    false,
  "autorizada": false,
  "jobId":      "inut_04395449000157_1716820000000",
  "cStat":      "227",
  "xMotivo":    "Rejeição: Número inicial maior que final",
  "detalhe":    "Rejeição SEFAZ: Número inicial maior que final (cStat 227)"
}

{
  "sucesso": false,
  "erro":    "inutilizacao.nNFIni e nNFFin são obrigatórios.",
  "jobId":   "inut_..."
}

const axios = require('axios');

async function inutilizarNumeracao(serie, nNFIni, nNFFin, justificativa) {
  const { data } = await axios.post('https://ianfe.com.br/functions/operacaoFiscal', {
    secret_key: 'sellerx_Ahot8B9MXuoy2R$W',
    api_key:    'yzV3C1hYWO',
    action:     'inutilizar',
    modelo:     'nfe',
    cnpj_emitente: '04395449000157',
    inutilizacao: {
      cnpj:   '04395449000157',
      uf:     'SP',
      serie:  serie,
      nNFIni: nNFIni,
      nNFFin: nNFFin,
      xJust:  justificativa,
    }
  }, { timeout: 70000 });

  if (data.sucesso) {
    console.log('Inutilização homologada:', data.nProt);
    // Salvar data.xmlProtocolo no banco (5 anos)
    return data;
  } else {
    throw new Error(data.xMotivo || data.erro);
  }
}

// Inutilizar uma única nota:
await inutilizarNumeracao(1, 50, 50, 'Número pulado por erro no sistema de emissão');

// Inutilizar faixa de números (50 até 55):
await inutilizarNumeracao(1, 50, 55, 'Numeração inutilizada por erro no sistema de emissão');

{
  "sucesso":    false,
  "autorizada": false,
  "cStat":      "225",
  "xMotivo":    "Rejeição: Falha no Schema XML",
  "detalhe":    "Verifique se os campos obrigatórios estão presentes e no formato correto (ex: notasReferenciadas como array de objetos para finNFe=4)"
}

{
  "sucesso": false,
  "erro":    "XML inválido ou mal formado",
  "detalhe": "XML não contém elemento nfeProc ou está corrompido"
}

GET https://ianfe.com.br/xml/35260512345678000199550010000001231234567890
x-api-key: yzV3C1hYWO

// Ou via query string (links diretos no browser):
GET https://ianfe.com.br/xml/35260512345678000199550010000001231234567890?api_key=yzV3C1hYWO

GET https://ianfe.com.br/danfe/35260512345678000199550010000001231234567890
x-api-key: yzV3C1hYWO

// Abrir em nova aba (link direto):
window.open('https://ianfe.com.br/danfe/' + chNFe + '?api_key=' + API_KEY, '_blank');

POST https://ianfe.com.br/danfe
x-api-key: yzV3C1hYWO
Content-Type: application/json

{
  "xmlProtocolo": "<?xml version="1.0"...>",
  "url_logotipo": "https://cdn.suaempresa.com/logo.png"
}

{
  "secret_key":    "sellerx_Ahot8B9MXuoy2R$W",
  "api_key":       "yzV3C1hYWO",
  "action":        "transmitir",
  "modelo":        "nfe",
  "cnpj_emitente": "37850573000114",
  "url_logotipo":  "https://cdn.suaempresa.com/logo.png",
  "nota": { ... }
}

{
  "secret_key":    "sellerx_Ahot8B9MXuoy2R$W",
  "api_key":       "yzV3C1hYWO",
  "action":        "danfe",
  "modelo":        "nfe",
  "invoice_id":    "SEU-ID-INTERNO-001",
  "cnpj_emitente": "37850573000114",
  "url_logotipo":  "https://cdn.suaempresa.com/logo.png",
  "imprimir_marca_dagua": false,
  
  "xmlProtocolo": "<?xml version="1.0" encoding="UTF-8"?>
<nfeProc xmlns="http://www.portalfiscal.inf.br/nfe" versao="4.00">
  <NFe>...</NFe>
  <protNFe>...</protNFe>
</nfeProc>"
}

{
  "secret_key":    "sellerx_Ahot8B9MXuoy2R$W",
  "api_key":       "yzV3C1hYWO",
  "action":        "pre_danfe",
  "modelo":        "nfe",
  "cnpj_emitente": "37850573000114",
  "nota": { ...mesmo payload da transmissão... }
}

{
  "sucesso":     true,
  "danfe_url":   "https://www.ianfe.com.br/danfe/pdf/abc123xyz...",
  "pdf_base64":  "JVBERi0xLjQKJeLjz9MKMyAwIG9iago8PC9UeXBlL1BhZ2UvUGFyZW50IDIgMCBS...",
  "chNFe":       "35260512345678000199550010000001231234567890",
  "modelo":      "nfe",
  "formato":     "A4",
  "mensagem":    "DANFE gerado com sucesso"
}

1. Transmite a nota → recebe { chNFe, nProt, xmlProtocolo }
2. Salva xmlProtocolo no seu banco (obrigatório por 5 anos)
3. Para imprimir: 
   → Opção A: POST https://ianfe.com.br/functions/operacaoFiscal com action="danfe" (RECOMENDADO)
   → Opção B: GET api.ianfe.com.br/danfe/{chNFe} (alternativa — link direto)
4. Para backup / reimpressão: Use o xmlProtocolo salvo com action="danfe"

{
  "sucesso":             true,
  "autorizada":          true,
  "cStat":               "100",
  "xMotivo":             "Autorizado o uso da NF-e",
  "nProt":               "135260000123456",
  "chNFe":               "35260512345678000199550010000001231234567890",
  "dhRecbto":            "2026-05-16T14:30:00-03:00",
  "tpEmis":              "4",
  "contingencia":        true,
  "svc":                 "svc-rs",
  "motivoContingencia":  "SEFAZ SP indisponível",
  "xmlProtocolo":        "<?xml version="1.0"...>"
}

{
              "sucesso":             true,
              "autorizada":          true,
              "cStat":               "100",
              "xMotivo":             "Autorizado o uso da NF-e",
              "nProt":               "135260000123456",
              "chNFe":               "35260512345678000199550010000001231234567890",
              "dhRecbto":            "2026-05-16T14:30:00-03:00",
              "xmlProtocolo":        "<?xml version="1.0"...>",
              "contingencia":        true,
              "svc":                 "SVC-AN",
              "tpEmis":              "6",
              "motivoContingencia":  "TIMEOUT_SEFAZ:nfe.fazenda.sp.gov.br"
              }

1. Salvar a nota normalmente — chNFe, nProt, xmlProtocolo são válidos
              2. Registrar no seu banco que tpEmis = "6" ou "7"
              3. Guardar o flag contingencia = true
              4. Quando a SEFAZ estadual voltar:
              → Retransmitir o lote para a SEFAZ estadual (exigência legal)
              → Prazo: até 168 horas (7 dias)
              5. Após retransmitir: atualizar o registro da nota com tpEmis = "1"

const resposta = await emitirNFe(nota);

              if (resposta.sucesso) {
              // Salva sempre — válido em qualquer caso
              await salvarNota({
              chNFe:        resposta.chNFe,
              nProt:        resposta.nProt,
              xmlProtocolo: resposta.xmlProtocolo,
              tpEmis:       resposta.tpEmis || '1',
              contingencia: resposta.contingencia || false,
              svc:          resposta.svc || null,
              });

              // Alerta se foi em contingência
              if (resposta.contingencia) {
              console.warn(`Nota emitida em contingência (${resposta.svc}).`);
              console.warn('Retransmitir para SEFAZ estadual quando voltar.');
              }
              }

const axios = require('axios');

const IANFE_URL     = 'https://ianfe.com.br/functions/operacaoFiscal';
const SECRET_KEY    = process.env.IANFE_SECRET_KEY;
const API_KEY       = process.env.IANFE_API_KEY;
const CNPJ_EMITENTE = '37850573000114';

// Emitir NF-e — repassa transporte e infAdic como o ERP montou
async function emitirNFe(nota) {
  const { data } = await axios.post(IANFE_URL, {
    secret_key: SECRET_KEY, api_key: API_KEY,
    action: 'transmitir', modelo: 'nfe',
    invoice_id: nota.id, cnpj_emitente: CNPJ_EMITENTE,
    nota: {
      naturezaOperacao: nota.natureza || 'VENDA DE MERCADORIA',
      serie: nota.serie, numero: String(nota.numero), ambiente: '1',
      destinatario: nota.destinatario, itens: nota.itens,
      total: nota.total,
      transporte: nota.transporte || { modFrete: '9' },
      pagamento: nota.pagamento,
      infAdic: nota.infAdic || { infCpl: nota.infCpl || '' },
    },
  }, { timeout: 70000 });
  if (data.avisos && data.avisos.length) console.warn('Avisos ianfe:', data.avisos);
  return data;
}

// Cancelar NF-e (ambiente deve ser o mesmo da emissão)
async function cancelar(chNFe, numero, nProt, motivo) {
  const { data } = await axios.post(IANFE_URL, {
    secret_key: SECRET_KEY, api_key: API_KEY,
    action: 'cancelar', modelo: 'nfe', cnpj_emitente: CNPJ_EMITENTE,
    ambiente: '1',
    cancelamento: { chave: chNFe, numero, nProt, xJust: motivo },
  }, { timeout: 70000 });
  return data;
}

// Carta de Correção
async function corrigirNFe(chNFe, nSeqEvento, textoCorrecao) {
  const { data } = await axios.post(IANFE_URL, {
    secret_key: SECRET_KEY, api_key: API_KEY,
    action: 'corrigir', modelo: 'nfe', cnpj_emitente: CNPJ_EMITENTE,
    ambiente: '1',
    correcao: { chave: chNFe, nSeqEvento, xCorrecao: textoCorrecao },
  }, { timeout: 70000 });
  return data;
}

// Gerar DANFE a partir do XML já autorizado (xmlProtocolo na raiz)
async function gerarDanfe(xmlProtocolo, invoiceId, urlLogo, marcaDagua = false) {
  const { data } = await axios.post(IANFE_URL, {
    secret_key: SECRET_KEY, api_key: API_KEY,
    action: 'danfe', modelo: 'nfe',
    invoice_id: invoiceId, cnpj_emitente: CNPJ_EMITENTE,
    url_logotipo: urlLogo,
    imprimir_marca_dagua: marcaDagua,
    xmlProtocolo,
  }, { timeout: 70000 });
  return data; // data.danfe_url, data.pdf_base64
}

import requests

IANFE_URL      = 'https://ianfe.com.br/functions/operacaoFiscal'
SECRET_KEY    = 'sellerx_Ahot8B9MXuoy2R$W'
API_KEY       = 'yzV3C1hYWO'
CNPJ_EMITENTE = '37850573000114'

def emitir_nfe(nota: dict) -> dict:
    payload = {
        'secret_key': SECRET_KEY, 'api_key': API_KEY,
        'action': 'transmitir', 'modelo': 'nfe',
        'invoice_id': nota.get('id'), 'cnpj_emitente': CNPJ_EMITENTE,
        'nota': {
            'naturezaOperacao': nota.get('natureza', 'VENDA DE MERCADORIA'),
            'serie': nota['serie'], 'numero': str(nota['numero']),
            'ambiente': '1', 'destinatario': nota['destinatario'],
            'itens': nota['itens'], 'total': nota['total'],
            'transporte': nota.get('transporte', {'modFrete': '9'}),
            'pagamento': nota['pagamento'],
            'infAdic': nota.get('infAdic', {'infCpl': nota.get('infCpl', '')}),
        }
    }
    resp = requests.post(IANFE_URL, json=payload, timeout=70).json()
    if resp.get('avisos'):
        print('Avisos ianfe:', resp['avisos'])
    return resp

def cancelar(ch_nfe: str, numero: int, n_prot: str, motivo: str) -> dict:
    payload = {
        'secret_key': SECRET_KEY, 'api_key': API_KEY,
        'action': 'cancelar', 'modelo': 'nfe',
        'cnpj_emitente': CNPJ_EMITENTE, 'ambiente': '1',
        'cancelamento': {'chave': ch_nfe, 'numero': numero, 'nProt': n_prot, 'xJust': motivo}
    }
    return requests.post(IANFE_URL, json=payload, timeout=70).json()

def corrigir_nfe(ch_nfe: str, n_seq_evento: int, texto_correcao: str) -> dict:
    payload = {
        'secret_key': SECRET_KEY, 'api_key': API_KEY,
        'action': 'corrigir', 'modelo': 'nfe',
        'cnpj_emitente': CNPJ_EMITENTE, 'ambiente': '1',
        'correcao': {'chave': ch_nfe, 'nSeqEvento': n_seq_evento, 'xCorrecao': texto_correcao},
    }
    return requests.post(IANFE_URL, json=payload, timeout=70).json()

def gerar_danfe(xml_protocolo: str, invoice_id: str, url_logo: str = None, marca_dagua: bool = False) -> dict:
    payload = {
        'secret_key': SECRET_KEY, 'api_key': API_KEY,
        'action': 'danfe', 'modelo': 'nfe',
        'invoice_id': invoice_id, 'cnpj_emitente': CNPJ_EMITENTE,
        'imprimir_marca_dagua': marca_dagua,
        'xmlProtocolo': xml_protocolo,
    }
    if url_logo:
        payload['url_logotipo'] = url_logo
    return requests.post(IANFE_URL, json=payload, timeout=70).json()

<?php
define('IANFE_URL',      'https://ianfe.com.br/functions/operacaoFiscal');
define('SECRET_KEY',    'sellerx_Ahot8B9MXuoy2R$W');
define('API_KEY',       'yzV3C1hYWO');
define('CNPJ_EMITENTE', '37850573000114');

function ianfe_post(array $payload): array {
    $ch = curl_init(IANFE_URL);
    curl_setopt_array($ch, [
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => json_encode($payload),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 70,
        CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
    ]);
    $resp = curl_exec($ch);
    curl_close($ch);
    return json_decode($resp, true);
}

function emitir_nfe(array $nota): array {
    $resp = ianfe_post([
        'secret_key' => SECRET_KEY, 'api_key' => API_KEY,
        'action' => 'transmitir', 'modelo' => 'nfe',
        'invoice_id' => $nota['id'] ?? '', 'cnpj_emitente' => CNPJ_EMITENTE,
        'nota' => [
            'naturezaOperacao' => $nota['natureza'] ?? 'VENDA DE MERCADORIA',
            'serie'  => $nota['serie'], 'numero' => (string)$nota['numero'],
            'ambiente' => '1', 'destinatario' => $nota['destinatario'],
            'itens' => $nota['itens'], 'total' => $nota['total'],
            'transporte' => $nota['transporte'] ?? ['modFrete' => '9'],
            'pagamento' => $nota['pagamento'],
            'infAdic' => $nota['infAdic'] ?? ['infCpl' => $nota['infCpl'] ?? ''],
        ],
    ]);
    if (!empty($resp['avisos'])) { error_log('Avisos ianfe: ' . json_encode($resp['avisos'])); }
    return $resp;
}

function cancelar(string $chNFe, int $numero, string $nProt, string $motivo): array {
    return ianfe_post([
        'secret_key' => SECRET_KEY, 'api_key' => API_KEY,
        'action' => 'cancelar', 'modelo' => 'nfe',
        'cnpj_emitente' => CNPJ_EMITENTE, 'ambiente' => '1',
        'cancelamento' => ['chave' => $chNFe, 'numero' => $numero, 'nProt' => $nProt, 'xJust' => $motivo],
    ]);
}

function corrigir_nfe(string $chNFe, int $nSeqEvento, string $textoCorrecao): array {
    return ianfe_post([
        'secret_key' => SECRET_KEY, 'api_key' => API_KEY,
        'action' => 'corrigir', 'modelo' => 'nfe',
        'cnpj_emitente' => CNPJ_EMITENTE, 'ambiente' => '1',
        'correcao' => ['chave' => $chNFe, 'nSeqEvento' => $nSeqEvento, 'xCorrecao' => $textoCorrecao],
    ]);
}

function gerar_danfe(string $xmlProtocolo, string $invoiceId, string $urlLogo = null, bool $marcaDagua = false): array {
    $payload = [
        'secret_key' => SECRET_KEY, 'api_key' => API_KEY,
        'action' => 'danfe', 'modelo' => 'nfe',
        'invoice_id' => $invoiceId, 'cnpj_emitente' => CNPJ_EMITENTE,
        'imprimir_marca_dagua' => $marcaDagua,
        'xmlProtocolo' => $xmlProtocolo,
    ];
    if ($urlLogo) { $payload['url_logotipo'] = $urlLogo; }
    return ianfe_post($payload);
}

{
  "emitente": {
    "cnpj": "12.345.678/0001-99",
    "razaoSocial": "MINHA EMPRESA LTDA",
    "CRT": "3",
    "ie": "123456789",
    "uf": "SC",
    "cMun": "4208203",
    "xMun": "ITAJAI",
    "cep": "88317180",
    "logradouro": "RUA EXEMPLO",
    "numero": "125",
    "bairro": "CENTRO",
    "telefone": "4799216645",
    "email": "contato@minhaempresa.com.br",
    "certificadoBase64": "MIIKX...",
    "senhaCertificado": "1234",
    "cIdToken": ""
  }
}

{
  "secret_key": "sua_secret_key",
  "api_key": "sua_api_key",
  "action": "transmitir",
  "modelo": "nfe",
  "cnpj_emitente": "12345678000199",

  "nota": {
    "naturezaOperacao": "DEVOLUCAO DE COMPRA",
    "finNFe": 4,
    "serie": "1",
    "numero": "200",
    "ambiente": "1",

    "chaveReferenciada": "35260598765432000100550010000001231234567890",

    "destinatario": {
      "cnpj": "98765432000100",
      "xNome": "FORNECEDOR LTDA",
      "indIEDest": "1",
      "ie": "987654321",
      "logradouro": "Avenida do Fornecedor",
      "numero": "500",
      "bairro": "Industrial",
      "cMun": "3550308",
      "xMun": "SAO PAULO",
      "uf": "SP",
      "cep": "04001000"
    },

    "itens": [
      {
        "nItem": 1,
        "nItemOriginal": 3,
        "codigo": "001",
        "descricao": "Camiseta Masculina Algodao",
        "ncm": "61091000",
        "cfop": "5202",
        "unidade": "UN",
        "quantidade": "1.0000",
        "valorUnitario": "150.0000",
        "valorTotal": "150.00",
        "icms": { "CSOSN": "102", "orig": "0" },
        "pis": { "CST": "07" },
        "cofins": { "CST": "07" }
      },
      {
        "nItem": 2,
        "nItemOriginal": 1,
        "codigo": "002",
        "descricao": "Bermuda Masculina",
        "ncm": "62034200",
        "cfop": "5202",
        "unidade": "UN",
        "quantidade": "2.0000",
        "valorUnitario": "80.0000",
        "valorTotal": "160.00",
        "icms": { "CSOSN": "102", "orig": "0" },
        "pis": { "CST": "07" },
        "cofins": { "CST": "07" }
      }
    ],

    "total": { "vProd": "310.00", "vNF": "310.00" },
    "transporte": { "modFrete": "9" },
    "pagamento": { "detPag": [{ "tPag": "90", "vPag": "0.00" }] },
    "infAdic": { "infCpl": "Devolucao referente NF-e 123 de 01/06/2026" }
  }
}

{ "nItem": 2, "nItemOriginal": 1, "chaveReferenciada": "35260598765432000100550010000001241234567891", "...": "..." }

{
  "itens": [{
    "nItem": 1,
    "codigo": "IMP-001",
    "descricao": "PECA IMPORTADA",
    "ncm": "84139190",
    "cfop": "3102",
    "unidade": "UN",
    "quantidade": "10.0000",
    "valorUnitario": "50.0000",
    "valorTotal": "500.00",
    "icms": { "CSOSN": "900", "orig": "1", "modBC": "3", "vBC": "500.00", "pICMS": "18.00", "vICMS": "90.00" },

    "declaracoesImportacao": [{
      "numero": "2326123456",
      "data": "2026-07-01",
      "localDesembaraco": "PORTO DE SANTOS",
      "ufDesembaraco": "SP",
      "dataDesembaraco": "2026-07-05",
      "viaTransporte": "1",
      "valorAFRMM": 350.00,
      "tipoIntermediacao": "1",
      "exportador": "SUPPLIER INTERNATIONAL LTD",
      "adicoes": [{
        "numeroAdicao": 1,
        "numeroSequencialItem": 1,
        "fabricante": "MANUFACTURER CO",
        "valorDesconto": 0,
        "numeroDrawback": null
      }]
    }],

    "ii":  { "vBC": "500.00", "vII": "60.00", "vDespAdu": "15.00" },
    "ipi": { "CST": "50", "vBC": "500.00", "pIPI": "10.00", "vIPI": "50.00" }
  }]
}

{
  "secret_key": "sua_secret_key",
  "api_key": "sua_api_key",
  "action": "transmitir",
  "modelo": "nfe",
  "cnpj_emitente": "12345678000199",
  "nota": {
    "naturezaOperacao": "COMPRA PARA COMERCIALIZACAO",
    "serie": "1",
    "numero": "234",
    "ambiente": "1",
    "tpNF": "0",
    "idDest": "3",

    "destinatario": {
      "idEstrangeiro": "",
      "xNome": "DONGGUAN KAIDI MACHINERY TECHNOLOGY CO. LTD.",
      "indIEDest": "9",
      "endereco": {
        "logradouro": "HOUJIE AVENUE EAST",
        "numero": "51",
        "bairro": "EXTERIOR",
        "cMun": "9999999",
        "xMun": "EXTERIOR",
        "uf": "EX",
        "cPais": "1600",
        "xPais": "CHINA"
      }
    },

    "itens": [{
      "nItem": 1,
      "codigo": "DL-992",
      "descricao": "MAQUINA DE COSTURA RETA DE DUPLA AGULHA",
      "ncm": "84532000",
      "cfop": "3102",
      "unidade": "UN",
      "quantidade": "2.0000",
      "valorUnitario": "3776.9006",
      "valorTotal": "7553.80",
      "icms": { "CSOSN": "900", "orig": "1", "modBC": "3", "vBC": "9207.28", "pICMS": "8.80", "vICMS": "810.24" },

      "declaracoesImportacao": [{
        "numero": "2608878970",
        "data": "2026-10-01",
        "localDesembaraco": "PORTO DE SANTOS",
        "ufDesembaraco": "SP",
        "dataDesembaraco": "2026-10-01",
        "viaTransporte": "1",
        "valorAFRMM": 227.58,
        "tipoIntermediacao": "1",
        "exportador": "0902",
        "adicoes": [{
          "numeroAdicao": 1,
          "numeroSequencialItem": 1,
          "fabricante": "0902",
          "valorDesconto": 0
        }]
      }],

      "ii":  { "vBC": "6294.83", "vDespAdu": "0.00", "vII": "1258.97", "vIOF": "0.00" },
      "ipi": { "cEnq": "999", "CST": "53" }
    }],

    "total": {
      "vProd": "240311.03",
      "vII": "40051.85",
      "vOutro": "26826.37",
      "vNF": "307189.25"
    },

    "transporte": {
      "modFrete": "0",
      "transportadora": {
        "cnpj": "47973689000102",
        "xNome": "RACE TRANSPORTE FRANCA LTDA",
        "ie": "137002114114",
        "endereco": "R ANDRE GARCIA GOMES, 260",
        "xMun": "FRANCA",
        "uf": "SP"
      },
      "volumes": [{
        "qVol": "36",
        "esp": "OUTROS",
        "pesoL": "10495.000",
        "pesoB": "12395.000"
      }]
    },

    "pagamento": {
      "detPag": [{ "indPag": "0", "tPag": "99", "xPag": "OUTROS", "vPag": "307189.25" }]
    },

    "infAdic": {
      "infCpl": "DI 26/0887897-0 Data DI 01/10/26 - LOCAL DE DESEMBARACO: UF SP, PORTO DE SANTOS - A.F.R.M.M. R$ 1.869,48 - Taxa Siscomex R$ 224,88 - Valor II R$ 40.051,84 - CONTAINER: ONEU 514.424-4"
    }
  }
}

{
  "exportacao": {
    "ufSaidaPais": "SP",
    "localExporta": "PORTO DE SANTOS",
    "localDespacho": "ALFANDEGA SANTOS"
  }
}

{
  "itens": [{
    "...": "...",
    "detExport": [{
      "registroExportacao": "26SP0012345",
      "quantidadeExportada": 10
    }]
  }]
}

{
  "nItem": 1,
  "codigo": "P01",
  "descricao": "PRODUTO EXEMPLO",
  "ncm": "84529099",
  "cfop": "5102",
  "unidade": "UN",
  "quantidade": "1.0000",
  "valorUnitario": "1000.0000",
  "valorTotal": "1000.00",
  "icms": { "CST": "00", "orig": "0", "modBC": "3", "vBC": "1000.00", "pICMS": "12.00", "vICMS": "120.00" },
  "pis":    { "CST": "01", "vBC": "1000.00", "pPIS": "1.65", "vPIS": "16.50" },
  "cofins": { "CST": "01", "vBC": "1000.00", "pCOFINS": "7.60", "vCOFINS": "76.00" }
}

{
  "nItem": 1,
  "codigo": "P01",
  "descricao": "PRODUTO EXEMPLO",
  "ncm": "84529099",
  "cfop": "5102",
  "unidade": "UN",
  "quantidade": "1.0000",
  "valorUnitario": "1000.0000",
  "valorTotal": "1000.00",
  "icms": { "CST": "00", "orig": "0", "modBC": "3", "vBC": "1000.00", "pICMS": "12.00", "vICMS": "120.00" },
  "pis":    { "CST": "01", "vBC": "1000.00", "pPIS": "1.65", "vPIS": "16.50" },
  "cofins": { "CST": "01", "vBC": "1000.00", "pCOFINS": "7.60", "vCOFINS": "76.00" },
  "ibscbs": {
    "CST": "000",
    "cClassTrib": "000001",
    "vBC": "1000.00",
    "pCBS": 0.90,
    "vCBS": "9.00",
    "pIBSUF": 0.10,
    "vIBSUF": "1.00",
    "pIBSMun": 0,
    "vIBSMun": "0.00",
    "vIBS": "1.00"
  }
}

POST https://ianfe.com.br/functions/operacaoFiscal

{
  "secret_key": "sua_secret_key",
  "api_key": "sua_api_key",
  "action": "transmitir",
  "modelo": "nfe",
  "cnpj_emitente": "12345678000199",
  "nota": {
    "naturezaOperacao": "VENDA DE MERCADORIA",
    "serie": "1",
    "numero": "500",
    "ambiente": "1",
    "crt": "3",

    "destinatario": {
      "cnpj": "98765432000100",
      "xNome": "EMPRESA COMPRADORA LTDA",
      "indIEDest": "1",
      "ie": "111222333444",
      "logradouro": "Avenida Principal",
      "numero": "200",
      "bairro": "Centro",
      "cMun": "3550308",
      "xMun": "SAO PAULO",
      "uf": "SP",
      "cep": "01310100"
    },

    "itens": [
      {
        "nItem": 1,
        "codigo": "PROD-001",
        "descricao": "PRODUTO EXEMPLO REGIME NORMAL",
        "ncm": "84529099",
        "cfop": "5102",
        "unidade": "UN",
        "quantidade": "10.0000",
        "valorUnitario": "100.0000",
        "valorTotal": "1000.00",
        "icms": { "CST": "00", "orig": "0", "modBC": "3", "vBC": "1000.00", "pICMS": "12.00", "vICMS": "120.00" },
        "pis":    { "CST": "01", "vBC": "1000.00", "pPIS": "1.65",  "vPIS": "16.50" },
        "cofins": { "CST": "01", "vBC": "1000.00", "pCOFINS": "7.60", "vCOFINS": "76.00" }
      }
    ],

    "total": {
      "vProd":  "1000.00",
      "vBC":    "1000.00",
      "vICMS":  "120.00",
      "vPIS":   "16.50",
      "vCOFINS":"76.00",
      "vNF":    "1010.00"
    },

    "transporte": { "modFrete": "9" },

    "pagamento": {
      "detPag": [{ "tPag": "01", "vPag": "1010.00" }]
    }
  }
}

<IBSCBSTot>
  <vBCIBSCBS>6300.00</vBCIBSCBS>
  <gIBS>
    <gIBSUF>
      <vDif>0.00</vDif>
      <vDevTrib>0.00</vDevTrib>
      <vIBSUF>3.15</vIBSUF>
    </gIBSUF>
    <gIBSMun>
      <vDif>0.00</vDif>
      <vDevTrib>0.00</vDevTrib>
      <vIBSMun>3.15</vIBSMun>
    </gIBSMun>
    <vIBS>6.30</vIBS>
    <vCredPres>0.00</vCredPres>
    <vCredPresCondSus>0.00</vCredPresCondSus>
  </gIBS>
  <gCBS>
    <vDif>0.00</vDif>
    <vDevTrib>0.00</vDevTrib>
    <vCBS>56.70</vCBS>
    <vCredPres>0.00</vCredPres>
    <vCredPresCondSus>0.00</vCredPresCondSus>
  </gCBS>
</IBSCBSTot>