# Exemplos de Payloads - NF-e API

Coleção de payloads prontos para uso em diferentes cenários.

---

## Índice

1. [NF-e Simples (Venda Interna)](#1-nf-e-simples-venda-interna)
2. [NF-e com Múltiplos Itens](#2-nf-e-com-múltiplos-itens)
3. [NF-e Interestadual (DIFAL)](#3-nf-e-interestadual-difal)
4. [NF-e Simples Nacional](#4-nf-e-simples-nacional)
5. [NF-e com ICMS-ST](#5-nf-e-com-icms-st)
6. [NF-e de Devolução](#6-nf-e-de-devolução)
7. [NF-e com IPI](#7-nf-e-com-ipi)
8. [NF-e Reforma Tributária (IBS/CBS)](#8-nf-e-reforma-tributária-ibscbs)
9. [NF-e para Consumidor Final](#9-nf-e-para-consumidor-final)
10. [NF-e de Remessa](#10-nf-e-de-remessa)

---

## 1. NF-e Simples (Venda Interna)

**Cenário:** Venda de mercadoria dentro do mesmo estado, regime normal de tributação.

```json
{
  "config": {
    "certificado": "{{CERTIFICADO_BASE64}}",
    "senha": "{{SENHA}}",
    "cnpj": "99999999000191",
    "ambiente": 2,
    "uf": "SP"
  },
  "payload": {
    "ide": {
      "cUF": 35,
      "natOp": "VENDA DE MERCADORIA",
      "mod": 55,
      "serie": 1,
      "nNF": 1,
      "dhEmi": "2024-06-05T10:00:00-03:00",
      "tpNF": 1,
      "idDest": 1,
      "cMunFG": 3550308,
      "tpImp": 1,
      "tpEmis": 1,
      "tpAmb": 2,
      "finNFe": 1,
      "indFinal": 0,
      "indPres": 1,
      "procEmi": 0,
      "verProc": "1.0"
    },
    "emit": {
      "CNPJ": "99999999000191",
      "xNome": "EMPRESA EMITENTE LTDA",
      "xFant": "EMPRESA EMITENTE",
      "IE": "123456789012",
      "CRT": 3
    },
    "enderEmit": {
      "xLgr": "RUA EXEMPLO",
      "nro": "100",
      "xBairro": "CENTRO",
      "cMun": 3550308,
      "xMun": "SAO PAULO",
      "UF": "SP",
      "CEP": "01000000",
      "cPais": 1058,
      "xPais": "BRASIL",
      "fone": "1133334444"
    },
    "dest": {
      "CNPJ": "88888888000188",
      "xNome": "CLIENTE DESTINATARIO LTDA",
      "indIEDest": 1,
      "IE": "987654321098",
      "email": "cliente@exemplo.com.br"
    },
    "enderDest": {
      "xLgr": "AVENIDA EXEMPLO",
      "nro": "200",
      "xBairro": "JARDIM EXEMPLO",
      "cMun": 3550308,
      "xMun": "SAO PAULO",
      "UF": "SP",
      "CEP": "02000000",
      "cPais": 1058,
      "xPais": "BRASIL",
      "fone": "1144445555"
    },
    "det": [
      {
        "prod": {
          "cProd": "PROD001",
          "cEAN": "SEM GTIN",
          "xProd": "PRODUTO EXEMPLO",
          "NCM": "84713012",
          "CFOP": "5102",
          "uCom": "UN",
          "qCom": 10.0,
          "vUnCom": 100.00,
          "vProd": 1000.00,
          "cEANTrib": "SEM GTIN",
          "uTrib": "UN",
          "qTrib": 10.0,
          "vUnTrib": 100.00,
          "indTot": 1
        },
        "imposto": {
          "vTotTrib": 272.50
        }
      }
    ],
    "total": {
      "icmstot": {
        "vBC": 1000.00,
        "vICMS": 180.00,
        "vICMSDeson": 0.00,
        "vFCP": 0.00,
        "vBCST": 0.00,
        "vST": 0.00,
        "vFCPST": 0.00,
        "vFCPSTRet": 0.00,
        "vProd": 1000.00,
        "vFrete": 0.00,
        "vSeg": 0.00,
        "vDesc": 0.00,
        "vII": 0.00,
        "vIPI": 0.00,
        "vIPIDevol": 0.00,
        "vPIS": 16.50,
        "vCOFINS": 76.00,
        "vOutro": 0.00,
        "vNF": 1000.00,
        "vTotTrib": 272.50
      }
    },
    "transp": {
      "modFrete": 9
    },
    "pag": {
      "detPag": [
        {
          "indPag": 0,
          "tPag": "01",
          "vPag": 1000.00
        }
      ]
    },
    "infAdic": {
      "infCpl": "Informacoes complementares da nota fiscal"
    }
  },
  "tributacao": {
    "icms": {
      "orig": 0,
      "CST": "00",
      "modBC": 0,
      "vBC": 100.00,
      "pICMS": 18.00,
      "vICMS": 18.00
    },
    "pis": {
      "CST": "01",
      "vBC": 100.00,
      "pPIS": 1.65,
      "vPIS": 1.65
    },
    "cofins": {
      "CST": "01",
      "vBC": 100.00,
      "pCOFINS": 7.60,
      "vCOFINS": 7.60
    }
  }
}
```

---

## 2. NF-e com Múltiplos Itens

**Cenário:** Venda com vários produtos, tributações diferentes por item.

```json
{
  "config": {
    "certificado": "{{CERTIFICADO_BASE64}}",
    "senha": "{{SENHA}}",
    "cnpj": "99999999000191",
    "ambiente": 2,
    "uf": "SP"
  },
  "payload": {
    "ide": {
      "cUF": 35,
      "natOp": "VENDA DE MERCADORIA",
      "mod": 55,
      "serie": 1,
      "nNF": 2,
      "dhEmi": "2024-06-05T11:00:00-03:00",
      "tpNF": 1,
      "idDest": 1,
      "cMunFG": 3550308,
      "tpImp": 1,
      "tpEmis": 1,
      "tpAmb": 2,
      "finNFe": 1,
      "indFinal": 0,
      "indPres": 1,
      "procEmi": 0,
      "verProc": "1.0"
    },
    "emit": {
      "CNPJ": "99999999000191",
      "xNome": "EMPRESA EMITENTE LTDA",
      "IE": "123456789012",
      "CRT": 3
    },
    "enderEmit": {
      "xLgr": "RUA EXEMPLO",
      "nro": "100",
      "xBairro": "CENTRO",
      "cMun": 3550308,
      "xMun": "SAO PAULO",
      "UF": "SP",
      "CEP": "01000000",
      "cPais": 1058,
      "xPais": "BRASIL"
    },
    "dest": {
      "CNPJ": "88888888000188",
      "xNome": "CLIENTE DESTINATARIO LTDA",
      "indIEDest": 1,
      "IE": "987654321098"
    },
    "enderDest": {
      "xLgr": "AVENIDA EXEMPLO",
      "nro": "200",
      "xBairro": "JARDIM",
      "cMun": 3550308,
      "xMun": "SAO PAULO",
      "UF": "SP",
      "CEP": "02000000",
      "cPais": 1058,
      "xPais": "BRASIL"
    },
    "det": [
      {
        "prod": {
          "cProd": "PROD001",
          "cEAN": "SEM GTIN",
          "xProd": "NOTEBOOK DELL INSPIRON",
          "NCM": "84713012",
          "CFOP": "5102",
          "uCom": "UN",
          "qCom": 2,
          "vUnCom": 2500.00,
          "vProd": 5000.00,
          "cEANTrib": "SEM GTIN",
          "uTrib": "UN",
          "qTrib": 2,
          "vUnTrib": 2500.00,
          "indTot": 1
        },
        "imposto": {
          "vTotTrib": 1362.50
        },
        "icms": {
          "orig": 0,
          "CST": "00",
          "modBC": 0,
          "vBC": 5000.00,
          "pICMS": 18.00,
          "vICMS": 900.00
        },
        "pis": {
          "CST": "01",
          "vBC": 5000.00,
          "pPIS": 1.65,
          "vPIS": 82.50
        },
        "cofins": {
          "CST": "01",
          "vBC": 5000.00,
          "pCOFINS": 7.60,
          "vCOFINS": 380.00
        }
      },
      {
        "prod": {
          "cProd": "PROD002",
          "cEAN": "SEM GTIN",
          "xProd": "MOUSE LOGITECH MX MASTER",
          "NCM": "84716060",
          "CFOP": "5102",
          "uCom": "UN",
          "qCom": 5,
          "vUnCom": 300.00,
          "vProd": 1500.00,
          "cEANTrib": "SEM GTIN",
          "uTrib": "UN",
          "qTrib": 5,
          "vUnTrib": 300.00,
          "indTot": 1
        },
        "imposto": {
          "vTotTrib": 408.75
        },
        "icms": {
          "orig": 0,
          "CST": "00",
          "modBC": 0,
          "vBC": 1500.00,
          "pICMS": 18.00,
          "vICMS": 270.00
        },
        "pis": {
          "CST": "01",
          "vBC": 1500.00,
          "pPIS": 1.65,
          "vPIS": 24.75
        },
        "cofins": {
          "CST": "01",
          "vBC": 1500.00,
          "pCOFINS": 7.60,
          "vCOFINS": 114.00
        }
      },
      {
        "prod": {
          "cProd": "PROD003",
          "cEAN": "SEM GTIN",
          "xProd": "TECLADO MECANICO RGB",
          "NCM": "84716060",
          "CFOP": "5102",
          "uCom": "UN",
          "qCom": 3,
          "vUnCom": 500.00,
          "vProd": 1500.00,
          "cEANTrib": "SEM GTIN",
          "uTrib": "UN",
          "qTrib": 3,
          "vUnTrib": 500.00,
          "indTot": 1
        },
        "imposto": {
          "vTotTrib": 408.75
        },
        "icms": {
          "orig": 0,
          "CST": "00",
          "modBC": 0,
          "vBC": 1500.00,
          "pICMS": 18.00,
          "vICMS": 270.00
        },
        "pis": {
          "CST": "01",
          "vBC": 1500.00,
          "pPIS": 1.65,
          "vPIS": 24.75
        },
        "cofins": {
          "CST": "01",
          "vBC": 1500.00,
          "pCOFINS": 7.60,
          "vCOFINS": 114.00
        }
      }
    ],
    "total": {
      "icmstot": {
        "vBC": 8000.00,
        "vICMS": 1440.00,
        "vICMSDeson": 0.00,
        "vProd": 8000.00,
        "vNF": 8000.00,
        "vPIS": 132.00,
        "vCOFINS": 608.00,
        "vTotTrib": 2180.00
      }
    },
    "transp": {
      "modFrete": 0,
      "transporta": {
        "CNPJ": "77777777000177",
        "xNome": "TRANSPORTADORA EXEMPLO LTDA",
        "IE": "111222333444",
        "xEnder": "RUA DA TRANSPORTADORA, 500",
        "xMun": "SAO PAULO",
        "UF": "SP"
      },
      "vol": [
        {
          "qVol": 3,
          "esp": "CAIXA",
          "marca": "DELL",
          "pesoL": 15.000,
          "pesoB": 18.000
        }
      ]
    },
    "pag": {
      "detPag": [
        {
          "indPag": 0,
          "tPag": "03",
          "vPag": 8000.00
        }
      ]
    }
  }
}
```

---

## 3. NF-e Interestadual (DIFAL)

**Cenário:** Venda para outro estado, consumidor final, com DIFAL.

```json
{
  "config": {
    "certificado": "{{CERTIFICADO_BASE64}}",
    "senha": "{{SENHA}}",
    "cnpj": "99999999000191",
    "ambiente": 2,
    "uf": "SP"
  },
  "payload": {
    "ide": {
      "cUF": 35,
      "natOp": "VENDA INTERESTADUAL",
      "mod": 55,
      "serie": 1,
      "nNF": 3,
      "dhEmi": "2024-06-05T12:00:00-03:00",
      "tpNF": 1,
      "idDest": 2,
      "cMunFG": 3550308,
      "tpImp": 1,
      "tpEmis": 1,
      "tpAmb": 2,
      "finNFe": 1,
      "indFinal": 1,
      "indPres": 2,
      "procEmi": 0,
      "verProc": "1.0"
    },
    "emit": {
      "CNPJ": "99999999000191",
      "xNome": "EMPRESA EMITENTE LTDA",
      "IE": "123456789012",
      "CRT": 3
    },
    "enderEmit": {
      "xLgr": "RUA EXEMPLO",
      "nro": "100",
      "xBairro": "CENTRO",
      "cMun": 3550308,
      "xMun": "SAO PAULO",
      "UF": "SP",
      "CEP": "01000000",
      "cPais": 1058,
      "xPais": "BRASIL"
    },
    "dest": {
      "CNPJ": "77777777000177",
      "xNome": "CLIENTE RIO DE JANEIRO LTDA",
      "indIEDest": 1,
      "IE": "111222333",
      "email": "cliente@rj.com.br"
    },
    "enderDest": {
      "xLgr": "AVENIDA ATLANTICA",
      "nro": "1000",
      "xBairro": "COPACABANA",
      "cMun": 3304557,
      "xMun": "RIO DE JANEIRO",
      "UF": "RJ",
      "CEP": "22010000",
      "cPais": 1058,
      "xPais": "BRASIL"
    },
    "det": [
      {
        "prod": {
          "cProd": "PROD001",
          "cEAN": "SEM GTIN",
          "xProd": "PRODUTO EXEMPLO",
          "NCM": "84713012",
          "CFOP": "6108",
          "uCom": "UN",
          "qCom": 1,
          "vUnCom": 1000.00,
          "vProd": 1000.00,
          "cEANTrib": "SEM GTIN",
          "uTrib": "UN",
          "qTrib": 1,
          "vUnTrib": 1000.00,
          "indTot": 1
        },
        "imposto": {
          "vTotTrib": 272.50
        },
        "icms": {
          "orig": 0,
          "CST": "00",
          "modBC": 0,
          "vBC": 1000.00,
          "pICMS": 12.00,
          "vICMS": 120.00
        },
        "icmsufdest": {
          "vBCUFDest": 1000.00,
          "vBCFCPUFDest": 0.00,
          "pFCPUFDest": 0.00,
          "pICMSUFDest": 18.00,
          "pICMSInter": 12.00,
          "pICMSInterPart": 100.00,
          "vFCPUFDest": 0.00,
          "vICMSUFDest": 60.00,
          "vICMSUFRemet": 0.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": {
      "icmstot": {
        "vBC": 1000.00,
        "vICMS": 120.00,
        "vICMSDeson": 0.00,
        "vFCPUFDest": 0.00,
        "vICMSUFDest": 60.00,
        "vICMSUFRemet": 0.00,
        "vProd": 1000.00,
        "vNF": 1000.00,
        "vPIS": 16.50,
        "vCOFINS": 76.00,
        "vTotTrib": 272.50
      }
    },
    "transp": {
      "modFrete": 0
    },
    "pag": {
      "detPag": [
        {
          "indPag": 0,
          "tPag": "01",
          "vPag": 1000.00
        }
      ]
    }
  }
}
```

---

## 4. NF-e Simples Nacional

**Cenário:** Empresa optante pelo Simples Nacional.

```json
{
  "config": {
    "certificado": "{{CERTIFICADO_BASE64}}",
    "senha": "{{SENHA}}",
    "cnpj": "99999999000191",
    "ambiente": 2,
    "uf": "SP"
  },
  "payload": {
    "ide": {
      "cUF": 35,
      "natOp": "VENDA DE MERCADORIA",
      "mod": 55,
      "serie": 1,
      "nNF": 4,
      "dhEmi": "2024-06-05T13:00:00-03:00",
      "tpNF": 1,
      "idDest": 1,
      "cMunFG": 3550308,
      "tpImp": 1,
      "tpEmis": 1,
      "tpAmb": 2,
      "finNFe": 1,
      "indFinal": 0,
      "indPres": 1,
      "procEmi": 0,
      "verProc": "1.0"
    },
    "emit": {
      "CNPJ": "99999999000191",
      "xNome": "EMPRESA SIMPLES NACIONAL LTDA",
      "xFant": "EMPRESA SN",
      "IE": "123456789012",
      "CRT": 1
    },
    "enderEmit": {
      "xLgr": "RUA EXEMPLO",
      "nro": "100",
      "xBairro": "CENTRO",
      "cMun": 3550308,
      "xMun": "SAO PAULO",
      "UF": "SP",
      "CEP": "01000000",
      "cPais": 1058,
      "xPais": "BRASIL"
    },
    "dest": {
      "CNPJ": "88888888000188",
      "xNome": "CLIENTE DESTINATARIO LTDA",
      "indIEDest": 1,
      "IE": "987654321098"
    },
    "enderDest": {
      "xLgr": "AVENIDA EXEMPLO",
      "nro": "200",
      "xBairro": "JARDIM",
      "cMun": 3550308,
      "xMun": "SAO PAULO",
      "UF": "SP",
      "CEP": "02000000",
      "cPais": 1058,
      "xPais": "BRASIL"
    },
    "det": [
      {
        "prod": {
          "cProd": "PROD001",
          "cEAN": "SEM GTIN",
          "xProd": "PRODUTO EXEMPLO",
          "NCM": "84713012",
          "CFOP": "5102",
          "uCom": "UN",
          "qCom": 10,
          "vUnCom": 100.00,
          "vProd": 1000.00,
          "cEANTrib": "SEM GTIN",
          "uTrib": "UN",
          "qTrib": 10,
          "vUnTrib": 100.00,
          "indTot": 1
        },
        "imposto": {
          "vTotTrib": 92.50
        }
      }
    ],
    "total": {
      "icmstot": {
        "vBC": 0.00,
        "vICMS": 0.00,
        "vICMSDeson": 0.00,
        "vProd": 1000.00,
        "vNF": 1000.00,
        "vTotTrib": 92.50
      }
    },
    "transp": {
      "modFrete": 9
    },
    "pag": {
      "detPag": [
        {
          "indPag": 0,
          "tPag": "01",
          "vPag": 1000.00
        }
      ]
    },
    "infAdic": {
      "infCpl": "DOCUMENTO EMITIDO POR ME OU EPP OPTANTE PELO SIMPLES NACIONAL. NAO GERA DIREITO A CREDITO FISCAL DE IPI."
    }
  },
  "tributacao": {
    "icmssn": {
      "orig": 0,
      "CSOSN": "102"
    }
  }
}
```

---

## 5. NF-e com ICMS-ST

**Cenário:** Venda com Substituição Tributária.

```json
{
  "config": {
    "certificado": "{{CERTIFICADO_BASE64}}",
    "senha": "{{SENHA}}",
    "cnpj": "99999999000191",
    "ambiente": 2,
    "uf": "SP"
  },
  "payload": {
    "ide": {
      "cUF": 35,
      "natOp": "VENDA COM ICMS-ST",
      "mod": 55,
      "serie": 1,
      "nNF": 5,
      "dhEmi": "2024-06-05T14:00:00-03:00",
      "tpNF": 1,
      "idDest": 1,
      "cMunFG": 3550308,
      "tpImp": 1,
      "tpEmis": 1,
      "tpAmb": 2,
      "finNFe": 1,
      "indFinal": 0,
      "indPres": 1,
      "procEmi": 0,
      "verProc": "1.0"
    },
    "emit": {
      "CNPJ": "99999999000191",
      "xNome": "EMPRESA EMITENTE LTDA",
      "IE": "123456789012",
      "CRT": 3
    },
    "enderEmit": {
      "xLgr": "RUA EXEMPLO",
      "nro": "100",
      "xBairro": "CENTRO",
      "cMun": 3550308,
      "xMun": "SAO PAULO",
      "UF": "SP",
      "CEP": "01000000",
      "cPais": 1058,
      "xPais": "BRASIL"
    },
    "dest": {
      "CNPJ": "88888888000188",
      "xNome": "CLIENTE DESTINATARIO LTDA",
      "indIEDest": 1,
      "IE": "987654321098"
    },
    "enderDest": {
      "xLgr": "AVENIDA EXEMPLO",
      "nro": "200",
      "xBairro": "JARDIM",
      "cMun": 3550308,
      "xMun": "SAO PAULO",
      "UF": "SP",
      "CEP": "02000000",
      "cPais": 1058,
      "xPais": "BRASIL"
    },
    "det": [
      {
        "prod": {
          "cProd": "PROD001",
          "cEAN": "7891234567890",
          "xProd": "BEBIDA ENERGETICA 250ML",
          "NCM": "22029900",
          "CFOP": "5405",
          "uCom": "UN",
          "qCom": 24,
          "vUnCom": 5.00,
          "vProd": 120.00,
          "cEANTrib": "7891234567890",
          "uTrib": "UN",
          "qTrib": 24,
          "vUnTrib": 5.00,
          "indTot": 1
        },
        "imposto": {
          "vTotTrib": 45.60
        },
        "icms": {
          "orig": 0,
          "CST": "10",
          "modBC": 3,
          "vBC": 120.00,
          "pICMS": 18.00,
          "vICMS": 21.60,
          "modBCST": 4,
          "pMVAST": 50.00,
          "vBCST": 180.00,
          "pICMSST": 18.00,
          "vICMSST": 10.80
        },
        "pis": {
          "CST": "01",
          "vBC": 120.00,
          "pPIS": 1.65,
          "vPIS": 1.98
        },
        "cofins": {
          "CST": "01",
          "vBC": 120.00,
          "pCOFINS": 7.60,
          "vCOFINS": 9.12
        }
      }
    ],
    "total": {
      "icmstot": {
        "vBC": 120.00,
        "vICMS": 21.60,
        "vICMSDeson": 0.00,
        "vBCST": 180.00,
        "vST": 10.80,
        "vProd": 120.00,
        "vNF": 120.00,
        "vPIS": 1.98,
        "vCOFINS": 9.12,
        "vTotTrib": 45.60
      }
    },
    "transp": {
      "modFrete": 9
    },
    "pag": {
      "detPag": [
        {
          "indPag": 0,
          "tPag": "01",
          "vPag": 120.00
        }
      ]
    }
  }
}
```

---

## 6. NF-e de Devolução

**Cenário:** Devolução de mercadoria.

```json
{
  "config": {
    "certificado": "{{CERTIFICADO_BASE64}}",
    "senha": "{{SENHA}}",
    "cnpj": "99999999000191",
    "ambiente": 2,
    "uf": "SP"
  },
  "payload": {
    "ide": {
      "cUF": 35,
      "natOp": "DEVOLUCAO DE MERCADORIA",
      "mod": 55,
      "serie": 1,
      "nNF": 6,
      "dhEmi": "2024-06-05T15:00:00-03:00",
      "tpNF": 1,
      "idDest": 1,
      "cMunFG": 3550308,
      "tpImp": 1,
      "tpEmis": 1,
      "tpAmb": 2,
      "finNFe": 4,
      "indFinal": 0,
      "indPres": 1,
      "procEmi": 0,
      "verProc": "1.0"
    },
    "emit": {
      "CNPJ": "99999999000191",
      "xNome": "EMPRESA EMITENTE LTDA",
      "IE": "123456789012",
      "CRT": 3
    },
    "enderEmit": {
      "xLgr": "RUA EXEMPLO",
      "nro": "100",
      "xBairro": "CENTRO",
      "cMun": 3550308,
      "xMun": "SAO PAULO",
      "UF": "SP",
      "CEP": "01000000",
      "cPais": 1058,
      "xPais": "BRASIL"
    },
    "dest": {
      "CNPJ": "88888888000188",
      "xNome": "FORNECEDOR ORIGINAL LTDA",
      "indIEDest": 1,
      "IE": "987654321098"
    },
    "enderDest": {
      "xLgr": "AVENIDA EXEMPLO",
      "nro": "200",
      "xBairro": "JARDIM",
      "cMun": 3550308,
      "xMun": "SAO PAULO",
      "UF": "SP",
      "CEP": "02000000",
      "cPais": 1058,
      "xPais": "BRASIL"
    },
    "refNFe": [
      {
        "refNFe": "35240888888888000188550010000000011234567890"
      }
    ],
    "det": [
      {
        "prod": {
          "cProd": "PROD001",
          "cEAN": "SEM GTIN",
          "xProd": "PRODUTO DEVOLVIDO",
          "NCM": "84713012",
          "CFOP": "5202",
          "uCom": "UN",
          "qCom": 1,
          "vUnCom": 500.00,
          "vProd": 500.00,
          "cEANTrib": "SEM GTIN",
          "uTrib": "UN",
          "qTrib": 1,
          "vUnTrib": 500.00,
          "indTot": 1
        },
        "imposto": {
          "vTotTrib": 136.25
        }
      }
    ],
    "total": {
      "icmstot": {
        "vBC": 500.00,
        "vICMS": 90.00,
        "vICMSDeson": 0.00,
        "vProd": 500.00,
        "vNF": 500.00,
        "vPIS": 8.25,
        "vCOFINS": 38.00,
        "vTotTrib": 136.25
      }
    },
    "transp": {
      "modFrete": 9
    },
    "pag": {
      "detPag": [
        {
          "indPag": 0,
          "tPag": "90",
          "vPag": 0.00
        }
      ]
    },
    "infAdic": {
      "infCpl": "Devolucao referente a NF-e 35240888888888000188550010000000011234567890"
    }
  },
  "tributacao": {
    "icms": {
      "orig": 0,
      "CST": "00",
      "modBC": 0,
      "vBC": 500.00,
      "pICMS": 18.00,
      "vICMS": 90.00
    },
    "pis": {
      "CST": "01",
      "vBC": 500.00,
      "pPIS": 1.65,
      "vPIS": 8.25
    },
    "cofins": {
      "CST": "01",
      "vBC": 500.00,
      "pCOFINS": 7.60,
      "vCOFINS": 38.00
    }
  }
}
```

---

## 7. NF-e com IPI

**Cenário:** Venda de produto industrializado com IPI.

```json
{
  "config": {
    "certificado": "{{CERTIFICADO_BASE64}}",
    "senha": "{{SENHA}}",
    "cnpj": "99999999000191",
    "ambiente": 2,
    "uf": "SP"
  },
  "payload": {
    "ide": {
      "cUF": 35,
      "natOp": "VENDA DE PRODUTO INDUSTRIALIZADO",
      "mod": 55,
      "serie": 1,
      "nNF": 7,
      "dhEmi": "2024-06-05T16:00:00-03:00",
      "tpNF": 1,
      "idDest": 1,
      "cMunFG": 3550308,
      "tpImp": 1,
      "tpEmis": 1,
      "tpAmb": 2,
      "finNFe": 1,
      "indFinal": 0,
      "indPres": 1,
      "procEmi": 0,
      "verProc": "1.0"
    },
    "emit": {
      "CNPJ": "99999999000191",
      "xNome": "INDUSTRIA EXEMPLO LTDA",
      "IE": "123456789012",
      "CRT": 3
    },
    "enderEmit": {
      "xLgr": "RUA EXEMPLO",
      "nro": "100",
      "xBairro": "CENTRO",
      "cMun": 3550308,
      "xMun": "SAO PAULO",
      "UF": "SP",
      "CEP": "01000000",
      "cPais": 1058,
      "xPais": "BRASIL"
    },
    "dest": {
      "CNPJ": "88888888000188",
      "xNome": "CLIENTE DESTINATARIO LTDA",
      "indIEDest": 1,
      "IE": "987654321098"
    },
    "enderDest": {
      "xLgr": "AVENIDA EXEMPLO",
      "nro": "200",
      "xBairro": "JARDIM",
      "cMun": 3550308,
      "xMun": "SAO PAULO",
      "UF": "SP",
      "CEP": "02000000",
      "cPais": 1058,
      "xPais": "BRASIL"
    },
    "det": [
      {
        "prod": {
          "cProd": "PROD001",
          "cEAN": "SEM GTIN",
          "xProd": "MAQUINA INDUSTRIAL MODELO X",
          "NCM": "84798200",
          "CFOP": "5101",
          "uCom": "UN",
          "qCom": 1,
          "vUnCom": 10000.00,
          "vProd": 10000.00,
          "cEANTrib": "SEM GTIN",
          "uTrib": "UN",
          "qTrib": 1,
          "vUnTrib": 10000.00,
          "indTot": 1
        },
        "imposto": {
          "vTotTrib": 3225.00
        },
        "icms": {
          "orig": 0,
          "CST": "00",
          "modBC": 0,
          "vBC": 10000.00,
          "pICMS": 18.00,
          "vICMS": 1800.00
        },
        "ipi": {
          "cEnq": "999",
          "CST": "50",
          "vBC": 10000.00,
          "pIPI": 10.00,
          "vIPI": 1000.00
        },
        "pis": {
          "CST": "01",
          "vBC": 10000.00,
          "pPIS": 1.65,
          "vPIS": 165.00
        },
        "cofins": {
          "CST": "01",
          "vBC": 10000.00,
          "pCOFINS": 7.60,
          "vCOFINS": 760.00
        }
      }
    ],
    "total": {
      "icmstot": {
        "vBC": 10000.00,
        "vICMS": 1800.00,
        "vICMSDeson": 0.00,
        "vProd": 10000.00,
        "vIPI": 1000.00,
        "vNF": 11000.00,
        "vPIS": 165.00,
        "vCOFINS": 760.00,
        "vTotTrib": 3225.00
      }
    },
    "transp": {
      "modFrete": 0
    },
    "pag": {
      "detPag": [
        {
          "indPag": 1,
          "tPag": "15",
          "vPag": 11000.00
        }
      ]
    }
  }
}
```

---

## 8. NF-e Reforma Tributária (IBS/CBS)

**Cenário:** NF-e com os novos impostos da Reforma Tributária.

```json
{
  "config": {
    "certificado": "{{CERTIFICADO_BASE64}}",
    "senha": "{{SENHA}}",
    "cnpj": "99999999000191",
    "ambiente": 2,
    "uf": "SP",
    "schemes": "PL_010_V1.30"
  },
  "payload": {
    "ide": {
      "cUF": 35,
      "natOp": "VENDA COM IBS/CBS",
      "mod": 55,
      "serie": 1,
      "nNF": 8,
      "dhEmi": "2024-06-05T17:00:00-03:00",
      "tpNF": 1,
      "idDest": 1,
      "cMunFG": 3550308,
      "tpImp": 1,
      "tpEmis": 1,
      "tpAmb": 2,
      "finNFe": 1,
      "indFinal": 0,
      "indPres": 1,
      "procEmi": 0,
      "verProc": "1.0"
    },
    "emit": {
      "CNPJ": "99999999000191",
      "xNome": "EMPRESA EMITENTE LTDA",
      "IE": "123456789012",
      "CRT": 3
    },
    "enderEmit": {
      "xLgr": "RUA EXEMPLO",
      "nro": "100",
      "xBairro": "CENTRO",
      "cMun": 3550308,
      "xMun": "SAO PAULO",
      "UF": "SP",
      "CEP": "01000000",
      "cPais": 1058,
      "xPais": "BRASIL"
    },
    "dest": {
      "CNPJ": "88888888000188",
      "xNome": "CLIENTE DESTINATARIO LTDA",
      "indIEDest": 1,
      "IE": "987654321098"
    },
    "enderDest": {
      "xLgr": "AVENIDA EXEMPLO",
      "nro": "200",
      "xBairro": "JARDIM",
      "cMun": 3550308,
      "xMun": "SAO PAULO",
      "UF": "SP",
      "CEP": "02000000",
      "cPais": 1058,
      "xPais": "BRASIL"
    },
    "det": [
      {
        "prod": {
          "cProd": "PROD001",
          "cEAN": "SEM GTIN",
          "xProd": "PRODUTO EXEMPLO",
          "NCM": "84713012",
          "CFOP": "5102",
          "uCom": "UN",
          "qCom": 1,
          "vUnCom": 1000.00,
          "vProd": 1000.00,
          "cEANTrib": "SEM GTIN",
          "uTrib": "UN",
          "qTrib": 1,
          "vUnTrib": 1000.00,
          "indTot": 1
        },
        "imposto": {
          "vTotTrib": 272.50
        },
        "icms": {
          "orig": 0,
          "CST": "00",
          "modBC": 0,
          "vBC": 1000.00,
          "pICMS": 18.00,
          "vICMS": 180.00
        },
        "ibscbs": {
          "vBC": 1000.00,
          "pAliqIBS": 5.00,
          "vIBS": 50.00,
          "pAliqCBS": 3.00,
          "vCBS": 30.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": {
      "icmstot": {
        "vBC": 1000.00,
        "vICMS": 180.00,
        "vICMSDeson": 0.00,
        "vProd": 1000.00,
        "vNF": 1000.00,
        "vPIS": 16.50,
        "vCOFINS": 76.00,
        "vTotTrib": 352.50
      },
      "ibscbstot": {
        "vBC": 1000.00,
        "vIBS": 50.00,
        "vCBS": 30.00
      }
    },
    "transp": {
      "modFrete": 9
    },
    "pag": {
      "detPag": [
        {
          "indPag": 0,
          "tPag": "01",
          "vPag": 1000.00
        }
      ]
    }
  }
}
```

---

## 9. NF-e para Consumidor Final

**Cenário:** Venda para pessoa física (CPF).

```json
{
  "config": {
    "certificado": "{{CERTIFICADO_BASE64}}",
    "senha": "{{SENHA}}",
    "cnpj": "99999999000191",
    "ambiente": 2,
    "uf": "SP"
  },
  "payload": {
    "ide": {
      "cUF": 35,
      "natOp": "VENDA A CONSUMIDOR FINAL",
      "mod": 55,
      "serie": 1,
      "nNF": 9,
      "dhEmi": "2024-06-05T18:00:00-03:00",
      "tpNF": 1,
      "idDest": 1,
      "cMunFG": 3550308,
      "tpImp": 1,
      "tpEmis": 1,
      "tpAmb": 2,
      "finNFe": 1,
      "indFinal": 1,
      "indPres": 1,
      "procEmi": 0,
      "verProc": "1.0"
    },
    "emit": {
      "CNPJ": "99999999000191",
      "xNome": "EMPRESA EMITENTE LTDA",
      "IE": "123456789012",
      "CRT": 3
    },
    "enderEmit": {
      "xLgr": "RUA EXEMPLO",
      "nro": "100",
      "xBairro": "CENTRO",
      "cMun": 3550308,
      "xMun": "SAO PAULO",
      "UF": "SP",
      "CEP": "01000000",
      "cPais": 1058,
      "xPais": "BRASIL"
    },
    "dest": {
      "CPF": "12345678901",
      "xNome": "JOAO DA SILVA",
      "indIEDest": 9,
      "email": "joao@email.com"
    },
    "enderDest": {
      "xLgr": "RUA DO CONSUMIDOR",
      "nro": "50",
      "xBairro": "VILA EXEMPLO",
      "cMun": 3550308,
      "xMun": "SAO PAULO",
      "UF": "SP",
      "CEP": "03000000",
      "cPais": 1058,
      "xPais": "BRASIL"
    },
    "det": [
      {
        "prod": {
          "cProd": "PROD001",
          "cEAN": "SEM GTIN",
          "xProd": "SMARTPHONE SAMSUNG GALAXY",
          "NCM": "85171231",
          "CFOP": "5102",
          "uCom": "UN",
          "qCom": 1,
          "vUnCom": 1500.00,
          "vProd": 1500.00,
          "cEANTrib": "SEM GTIN",
          "uTrib": "UN",
          "qTrib": 1,
          "vUnTrib": 1500.00,
          "indTot": 1
        },
        "imposto": {
          "vTotTrib": 408.75
        }
      }
    ],
    "total": {
      "icmstot": {
        "vBC": 1500.00,
        "vICMS": 270.00,
        "vICMSDeson": 0.00,
        "vProd": 1500.00,
        "vNF": 1500.00,
        "vPIS": 24.75,
        "vCOFINS": 114.00,
        "vTotTrib": 408.75
      }
    },
    "transp": {
      "modFrete": 9
    },
    "pag": {
      "detPag": [
        {
          "indPag": 0,
          "tPag": "03",
          "vPag": 1500.00
        }
      ]
    }
  },
  "tributacao": {
    "icms": {
      "orig": 0,
      "CST": "00",
      "modBC": 0,
      "vBC": 1500.00,
      "pICMS": 18.00,
      "vICMS": 270.00
    },
    "pis": {
      "CST": "01",
      "vBC": 1500.00,
      "pPIS": 1.65,
      "vPIS": 24.75
    },
    "cofins": {
      "CST": "01",
      "vBC": 1500.00,
      "pCOFINS": 7.60,
      "vCOFINS": 114.00
    }
  }
}
```

---

## 10. NF-e de Remessa

**Cenário:** Remessa para conserto/demonstração.

```json
{
  "config": {
    "certificado": "{{CERTIFICADO_BASE64}}",
    "senha": "{{SENHA}}",
    "cnpj": "99999999000191",
    "ambiente": 2,
    "uf": "SP"
  },
  "payload": {
    "ide": {
      "cUF": 35,
      "natOp": "REMESSA PARA CONSERTO",
      "mod": 55,
      "serie": 1,
      "nNF": 10,
      "dhEmi": "2024-06-05T19:00:00-03:00",
      "tpNF": 1,
      "idDest": 1,
      "cMunFG": 3550308,
      "tpImp": 1,
      "tpEmis": 1,
      "tpAmb": 2,
      "finNFe": 1,
      "indFinal": 0,
      "indPres": 1,
      "procEmi": 0,
      "verProc": "1.0"
    },
    "emit": {
      "CNPJ": "99999999000191",
      "xNome": "EMPRESA EMITENTE LTDA",
      "IE": "123456789012",
      "CRT": 3
    },
    "enderEmit": {
      "xLgr": "RUA EXEMPLO",
      "nro": "100",
      "xBairro": "CENTRO",
      "cMun": 3550308,
      "xMun": "SAO PAULO",
      "UF": "SP",
      "CEP": "01000000",
      "cPais": 1058,
      "xPais": "BRASIL"
    },
    "dest": {
      "CNPJ": "88888888000188",
      "xNome": "ASSISTENCIA TECNICA LTDA",
      "indIEDest": 1,
      "IE": "987654321098"
    },
    "enderDest": {
      "xLgr": "AVENIDA EXEMPLO",
      "nro": "200",
      "xBairro": "JARDIM",
      "cMun": 3550308,
      "xMun": "SAO PAULO",
      "UF": "SP",
      "CEP": "02000000",
      "cPais": 1058,
      "xPais": "BRASIL"
    },
    "det": [
      {
        "prod": {
          "cProd": "PROD001",
          "cEAN": "SEM GTIN",
          "xProd": "NOTEBOOK PARA CONSERTO",
          "NCM": "84713012",
          "CFOP": "5915",
          "uCom": "UN",
          "qCom": 1,
          "vUnCom": 2000.00,
          "vProd": 2000.00,
          "cEANTrib": "SEM GTIN",
          "uTrib": "UN",
          "qTrib": 1,
          "vUnTrib": 2000.00,
          "indTot": 1
        },
        "imposto": {
          "vTotTrib": 0.00
        }
      }
    ],
    "total": {
      "icmstot": {
        "vBC": 0.00,
        "vICMS": 0.00,
        "vICMSDeson": 0.00,
        "vProd": 2000.00,
        "vNF": 2000.00,
        "vTotTrib": 0.00
      }
    },
    "transp": {
      "modFrete": 1
    },
    "pag": {
      "detPag": [
        {
          "indPag": 0,
          "tPag": "90",
          "vPag": 0.00
        }
      ]
    },
    "infAdic": {
      "infCpl": "Remessa para conserto - Retornar em ate 30 dias"
    }
  },
  "tributacao": {
    "icms": {
      "orig": 0,
      "CST": "41"
    },
    "pis": {
      "CST": "08"
    },
    "cofins": {
      "CST": "08"
    }
  }
}
```

---

## Notas Importantes

### Variáveis a Substituir

Em todos os exemplos, substitua:
- `{{CERTIFICADO_BASE64}}`: Conteúdo do certificado em Base64
- `{{SENHA}}`: Senha do certificado digital
- `{{CNPJ_EMITENTE}}`: CNPJ da empresa emitente
- `{{DATA_HORA_EMISSAO}}`: Data/hora no formato ISO 8601

### Campos Dinâmicos

- `nNF`: Sempre incremente para evitar duplicidade
- `dhEmi`: Use a data/hora atual
- `chave`: Gerada automaticamente pela API

### Ambiente de Testes

- Sempre use `"ambiente": 2` para homologação
- Altere para `"ambiente": 1` apenas em produção
- Em homologação, a DANFE terá marca d'água "SEM VALOR FISCAL"

### CFOP Comuns

| CFOP | Descrição |
|------|-----------|
| 5101 | Venda de produção do estabelecimento |
| 5102 | Venda de mercadoria adquirida ou recebida de terceiros |
| 5202 | Devolução de compra para comercialização |
| 5405 | Venda de mercadoria com ICMS-ST |
| 5915 | Remessa para conserto |
| 6108 | Venda interestadual para consumidor final |

---

## Como Usar

1. Escolha o exemplo mais próximo do seu cenário
2. Copie o JSON
3. Substitua as variáveis `{{...}}`
4. Ajuste valores conforme necessário
5. Envie para o endpoint apropriado

```bash
curl -X POST http://localhost:8080/nfe/emitir \
  -H "Content-Type: application/json" \
  -d @payload-exemplo.json
```

---

**Dica**: Salve estes exemplos como templates e crie variações conforme necessário!