Confira alguns exemplos JSON para saber como emitir NF-e de Produto, Conjugada (produto/serviço juntos) e NF-e de Devolução.


Exemplo #1 - Simples Nacional + Transporte


Esse JSON exemplifica como emitir uma NF-e para uma empresa optante pelo Simples Nacional informando os dados de transporte.



{
    "id": "string", //identificador único da NF-e
    "ambienteEmissao": "Homologacao", //"Producao" ou "Homologacao"
    "naturezaOperacao": "Venda",
    "finalidade": "Normal",
    "consumidorFinal": true,
    "indicadorPresencaConsumidor": "OperacaoPelaInternet",
 
    "cliente": {
        "tipoPessoa": "F",
        "indicadorContribuinteICMS": "NaoContribuinte",
 
        "nome": "string",
        "email": "string",
        "telefone": "string",
        "cpfCnpj": "string",
        "inscricaoMunicipal": "string",
        "inscricaoEstadual": "string",
 
        "endereco": {
            "pais": "string",
            "uf": "string",
            "cidade": "string",
            "logradouro": "string",
            "numero": "string",
            "complemento": "string",
            "bairro": "string",
            "cep": "string"
        }
    },
    "enviarPorEmail": true,
    "itens": [
        {
            "cfop": "5101",
            "codigo": "1",
            "descricao": "string",
            "ncm": "38151210",
            "quantidade": 1,
            "unidadeMedida": "UN",
            "valorUnitario": 1.00,
 
            "impostos": {
                "icms": {
                    "situacaoTributaria": "102", //CSOSN 102 - Tributada pelo Simples Nacional sem permissão de crédito
                    "origem": 0 //0 - Nacional
                },
                "pis": {
                    "situacaoTributaria": "07" //07 - Operação isenta da contribuição
                },
                "cofins": {
                    "situacaoTributaria": "07" //07 - Operação isenta da contribuição
                }
            }
        }
    ],
    "transporte": {
        "frete": {
            "modalidade": "PorContaDoEmitente",
            "valor": null
        },
        "enderecoEntrega": {
            "tipoPessoaDestinatario": "F",
            "cpfCnpjDestinatario": "10330557270",
            "pais": null,
            "uf": "MG",
            "cidade": "Belo Horizonte",
            "logradouro": "Rua 01",
            "numero": "112",
            "complemento": "AP 402",
            "bairro": "Savassi",
            "cep": "32323111"
        },
        "transportadora": {
            "usarDadosEmitente": false,
            "tipoPessoa": "J",
            "CpfCnpj": "99999999999999",
            "nome": "Tranportador LTDA",
            "inscricaoEstadual": "0000000",
            "endereco": "Rua 01, N 12, Bairro",
            "cidade": "Belo Horizonte",
            "uf": "MG"
        },
        "veiculo": {
            "placa": "XYZ0000",
            "uf": "MG",
            "rntc": null
        },
        "volume": {
            "quantidade": 0.0000,
            "especie": null,
            "marca": null,
            "numeracao": "0",
            "pesoLiquido": 0.0,
            "pesoBruto": 0.0
        }
    },
    "informacoesAdicionais": "I - Documento emitido por ME ou EPP optante pelo Simples Nacional.\r\n II - Não gera direito a crédito fiscal de ICMS, de ISS e de IPI." //opcional
}


Exemplo #2 - NF-e Conjugada - Produto + Serviço


Esse JSON exemplifica como lançar um produto e prestação de serviço na mesma nota fiscal.


{
    "id": "{id de mapeamento no sistema de origem}",
    "ambienteEmissao": "Homologacao",
    "naturezaOperacao": "Venda",
    "consumidorFinal": true,
 
    "cliente": {
        "tipoPessoa": "F",
 
        "nome": "string",
        "email": "string",
        "telefone": "string",
        "cpfCnpj": "string",
 
        "endereco": {
            "pais": "string",
            "uf": "string",
            "cidade": "string",
            "logradouro": "string",
            "numero": "string",
            "complemento": "string",
            "bairro": "string",
            "cep": "string"
        }
    },
    "enviarPorEmail": true,
 
    "itens": [
        {
            "cfop": "5101", //OBS: Deve ser utilizado o CFOP 6101 quando for venda para fora do estado.
            "codigo": "BD1440",
            "descricao": "DISCO FREIO DIANTEI",
            "ncm": "87083090",
            "quantidade": 2,
            "unidadeMedida": "PC",
            "valorUnitario": 76.25,
 
            "impostos": {
                "icms": {
                    "situacaoTributaria": "500",
                    "origem": 0
                },
                "pis": {
                    "situacaoTributaria": "08"
                },
                "cofins": {
                    "situacaoTributaria": "08"
                }
            }
        },
        {
            "cfop": "5933", //OBS: Deve ser utilizado o CFOP 6933 quando for serviço realizado fora do estado.
            "codigo": "S001",
            "descricao": "Serviço de Troca de Disco de Freio (dianteiro ou traseiro)",
            "ncm": "00",
            "quantidade": 1,
            "unidadeMedida": "UN",
            "valorUnitario": 180.00,
 
            "impostos": {
                "issqn": {
                    "itemListaServicoLC116": "1401",
                    "aliquotaIss":  5.00
                },
                "pis": {
                    "situacaoTributaria": "08"
                },
                "cofins": {
                    "situacaoTributaria": "08"
                }
            }
        }
    ],
    "informacoesAdicionais": "Documento emitido por ME ou EPP optante pelo Simples Nacional. Não gera direito a crédito fiscal de IPI."


Exemplo #3 - Simples Nacional


Esse JSON exemplifica como emitir uma nota fiscal de produto para uma empresa do Simples Nacional.


{
    "id": "string", //identificador único da NF-e
    "ambienteEmissao": "Homologacao", //"Producao" ou "Homologacao"
    "naturezaOperacao": "Venda",
    "finalidade": "Normal",
    "consumidorFinal": true,
    "indicadorPresencaConsumidor": "OperacaoPelaInternet",
 
    "cliente": {
        "tipoPessoa": "F",
        "indicadorContribuinteICMS": "NaoContribuinte",
 
        "nome": "string",
        "email": "string",
        "telefone": "string",
        "cpfCnpj": "string",
        "inscricaoMunicipal": "string",
        "inscricaoEstadual": "string",
 
        "endereco": {
            "pais": "string",
            "uf": "string",
            "cidade": "string",
            "logradouro": "string",
            "numero": "string",
            "complemento": "string",
            "bairro": "string",
            "cep": "string"
        }
    },
    "enviarPorEmail": true,
    "itens": [
        {
            "cfop": "5101",
            "codigo": "1",
            "descricao": "string",
            "ncm": "38151210",
            "quantidade": 1,
            "unidadeMedida": "UN",
            "valorUnitario": 1.00,
 
            "impostos": {
                "icms": {
                    "situacaoTributaria": "102", //CSOSN 102 - Tributada pelo Simples Nacional sem permissão de crédito
                    "origem": 0 //0 - Nacional
                },
                "pis": {
                    "situacaoTributaria": "07" //07 - Operação isenta da contribuição
                },
                "cofins": {
                    "situacaoTributaria": "07" //07 - Operação isenta da contribuição
                }
            }
        }
    ],
    "informacoesAdicionais": "I - Documento emitido por ME ou EPP optante pelo Simples Nacional.\r\n II - Não gera direito a crédito fiscal de ICMS, de ISS e de IPI." //opcional
}


Exemplo #4 - NF-e de Devolução


Esse JSON exemplifica como emitir uma nota fiscal eletrônica de devolução.


{
    "id": "3088282",
    "ambienteEmissao": "Homologacao",
    "naturezaOperacao": "Devolução",
    "tipoOperacao": "Entrada",
    "nfeReferenciada": [{
        "chaveAcesso": "000121111999005183450010000028881000025656"
    }],
    "finalidade": "DevolucaoMercadoria",
    "consumidorFinal": true,
    "indicadorPresencaConsumidor": "OperacaoPresencial",
 
    "cliente": {
        "tipoPessoa": "F",
        "indicadorContribuinteICMS": "NaoContribuinte",
 
        "nome": "Jonathan Souza",
        "email": "[email protected]",
        "telefone": "31987897898",
        "cpfCnpj": "10330557270",
 
        "endereco": {
            "uf": "MG",
            "cidade": "Belo Horizonte",
            "logradouro": "Rua 01",
            "numero": "112",
            "complemento": "AP 402",
            "bairro": "Savassi",
            "cep": "32323111"
        }
    },
    "enviarPorEmail": true,
    "itens": [{
        "cfop": "5101",
        "codigo": "1",
        "descricao": "Produto XYZ",
        "ncm": "49019900",
        "quantidade": 1,
        "unidadeMedida": "UN",
        "valorUnitario": 1.00,
 
        "impostos": {
            "percentualAproximadoTributos": {
                "simplificado": {
                    "percentual": 31.45
                },
                "fonte": "IBPT"
            },
 
            "icms": {
                "situacaoTributaria": "102", //102 – Tributada pelo Simples Nacional sem permissão de crédito
                "origem": 0 //0 - Nacional
            },
            "pis": {
                "situacaoTributaria": "08" //08 - Operação Sem Incidência da Contribuição
            },
            "cofins": {
                "situacaoTributaria": "08" //08 - Operação Sem Incidência da Contribuição
            }
        }
    }],
    "informacoesAdicionais": "Documento emitido por ME ou EPP optante pelo Simples Nacional. Não gera direito a crédito fiscal de IPI." //opcional
}


Exemplo #5 - Transporte + Não Simples Nacional


Esse JSON exemplifica como emitir uma nota fiscal eletrônica de produto especificando informações de transporte para empresa não optante do simples nacional.


{
    "id": "3088290",
    "ambienteEmissao": "Homologacao",
    "tipoOperacao": "Saida",
    "naturezaOperacao": "Remessa para utilização na prestação de serviço",
    "finalidade": null,
    "consumidorFinal": true,
    "indicadorPresencaConsumidor": "NaoSeAplica",
    "cliente": {
        "tipoPessoa": "F",
        "indicadorContribuinteICMS": "NaoContribuinte",
        "nome": "Jonathan Souza",
        "email": "[email protected]",
        "telefone": null,
        "cpfCnpj": "10330557270",
        "inscricaoMunicipal": null,
        "inscricaoEstadual": null,
        "endereco": {
            "uf": "MG",
            "cidade": "Belo Horizonte",
            "logradouro": "Rua 01",
            "numero": "112",
            "complemento": "AP 402",
            "bairro": "Savassi",
            "cep": "32323111"
        }
    },
    "enviarPorEmail": true,
    "itens": [{
        "cfop": "5949",
        "codigo": "03.34.0112",
        "descricao": "CIMENTOS,BRITAS,AREIAS,ADITIVOS MISTURADOS DOSAGEM DO TRACO CANH4 FCK 20,0 MPA BRITA 01 SLUMP 15+-2 CONST",
        "ncm": "25309090",
        "quantidade": 7.0000,
        "unidadeMedida": "M3",
        "valorUnitario": 111.45,
        "impostos": {
            "percentualAproximadoTributos": null,
            "icms": {
                "situacaoTributaria": "41",
                "origem": 0,
                "baseCalculo": 780.12,
                "percentualReducaoBaseCalculo": 0.00,
                "aliquota": 0.00,
                "percentualReducaoBaseCalculoST": 0.0000
            },
            "pis": {
                "situacaoTributaria": "08"
            },
            "cofins": {
                "situacaoTributaria": "08"
            },
            "ipi": null
        },
        "informacoesAdicionais": "NAO INCIDENCIA DO ICMS ART. 40 INCISO XVIII DA LEI 2657 DE 261296. ISENTO DE IPI ART. 45 INCISO VIII DO DECRETO 87.981.82."
    }],
    "transporte": {
        "frete": {
            "modalidade": "PorContaDoEmitente",
            "valor": null
        },
        "enderecoEntrega": {
            "tipoPessoaDestinatario": "F",
            "cpfCnpjDestinatario": "10330557270",
            "pais": null,
            "uf": "MG",
            "cidade": "Belo Horizonte",
            "logradouro": "Rua 01",
            "numero": "112",
            "complemento": "AP 402",
            "bairro": "Savassi",
            "cep": "32323111"
        },
        "transportadora": {
            "usarDadosEmitente": false,
            "tipoPessoa": "J",
            "CpfCnpj": "99999999999999",
            "nome": "Tranportador LTDA",
            "inscricaoEstadual": "0000000",
            "endereco": "Rua 01, N 12, Bairro",
            "cidade": "Belo Horizonte",
            "uf": "MG"
        },
        "veiculo": {
            "placa": "XYZ0000",
            "uf": "MG",
            "rntc": null
        },
        "volume": {
            "quantidade": 0.0000,
            "especie": null,
            "marca": null,
            "numeracao": "0",
            "pesoLiquido": 0.0,
            "pesoBruto": 0.0
        }
    },
    "informacoesAdicionais": null
}


Exemplo #6 - Com retenção de PIS e COFINS (por alíquota)


Esse JSON exemplifica como emitir uma nota fiscal eletrônica de produto especificando o percentual do PIS e COFINS por item.


{
    "id": "3088294",
    "ambienteEmissao": "Homologacao",
    "naturezaOperacao": "Venda",
    "tipoOperacao": "Saida",
    "finalidade": "Normal",
    "consumidorFinal": true,
    "indicadorPresencaConsumidor": "OperacaoPresencial",
 
    "cliente": {
        "tipoPessoa": "F",
        "indicadorContribuinteICMS": "NaoContribuinte",
 
        "nome": "Jonathan Souza",
        "email": "[email protected]",
        "telefone": "31987897898",
        "cpfCnpj": "10330557270",
 
        "endereco": {
            "uf": "MG",
            "cidade": "Belo Horizonte",
            "logradouro": "Rua 01",
            "numero": "112",
            "complemento": "AP 402",
            "bairro": "Savassi",
            "cep": "32323111"
        }
    },
    "enviarPorEmail": true,
    "itens": [
        {
            "cfop": "5101",
            "codigo": "1",
            "descricao": "Produto XYZ",
            "ncm": "49019900",
            "cest": "1234", //Campo CEST
            "quantidade": 1,
            "unidadeMedida": "UN",
            "valorUnitario": 1.00,
            "descontos": 0.50,
 
            "impostos": {
                "percentualAproximadoTributos": {
                    "simplificado": {
                        "percentual": 31.45
                    },
                    "fonte": "IBPT"
                },
 
                "icms": {
                    "situacaoTributaria": "102", //Também conhecido como CST/CSOSN. 102 – Tributada pelo Simples Nacional sem permissão de crédito
                    "origem": 0 //0 - Nacional
                },
                "pis": {
                    "situacaoTributaria": "01", //Também conhecido como CST. 01 - Operação Tributável com Alíquota Básica
                    "porAliquota": {
                        "aliquota": 0.65
                    }
                },
                "cofins": {
                    "situacaoTributaria": "01", //Também conhecido como CST. 01 - Operação Tributável com Alíquota Básica
                    "porAliquota": {
                        "aliquota": 3.00
                    }
                }
            }
        }
    ],
    "informacoesAdicionais": "Documento emitido por ME ou EPP optante pelo Simples Nacional. Não gera direito a crédito fiscal de IPI." //opcional
}


Exemplo #7 - Com retenção de PIS e COFINS (por valor unidade)


Esse JSON exemplifica como emitir uma nota fiscal eletrônica de produto especificando o valor por unidade do PIS e COFINS por item.


{
    "id": "3088294",
    "ambienteEmissao": "Homologacao",
    "naturezaOperacao": "Venda",
    "tipoOperacao": "Saida",
    "finalidade": "Normal",
    "consumidorFinal": true,
    "indicadorPresencaConsumidor": "OperacaoPresencial",
 
    "cliente": {
        "tipoPessoa": "F",
        "indicadorContribuinteICMS": "NaoContribuinte",
 
        "nome": "Jonathan Souza",
        "email": "[email protected]",
        "telefone": "31987897898",
        "cpfCnpj": "10330557270",
 
        "endereco": {
            "uf": "MG",
            "cidade": "Belo Horizonte",
            "logradouro": "Rua 01",
            "numero": "112",
            "complemento": "AP 402",
            "bairro": "Savassi",
            "cep": "32323111"
        }
    },
    "enviarPorEmail": true,
    "itens": [
        {
            "cfop": "5101",
            "codigo": "1",
            "descricao": "Produto XYZ",
            "ncm": "49019900",
            "cest": "1234", //Campo CEST
            "quantidade": 1,
            "unidadeMedida": "UN",
            "valorUnitario": 1.00,
            "descontos": 0.50,
 
            "impostos": {
                "percentualAproximadoTributos": {
                    "simplificado": {
                        "percentual": 31.45
                    },
                    "fonte": "IBPT"
                },
 
                "icms": {
                    "situacaoTributaria": "102", //Também conhecido como CST/CSOSN. 102 – Tributada pelo Simples Nacional sem permissão de crédito
                    "origem": 0 //0 - Nacional
                },
                "pis": {
                    "situacaoTributaria": "01", //Também conhecido como CST. 01 - Operação Tributável com Alíquota Básica
                    "porValor": {
                        "valorPorUnidade": 0.30
                    }
                },
                "cofins": {
                    "situacaoTributaria": "01", //Também conhecido como CST. 01 - Operação Tributável com Alíquota Básica
                    "porValor": {
                        "valorPorUnidade": 0.0076
                    }
                }
            }
        }
    ],
    "informacoesAdicionais": "Documento emitido por ME ou EPP optante pelo Simples Nacional. Não gera direito a crédito fiscal de IPI." //opcional
}


Exemplo #8 - Nota fiscal de combustível


Esse JSON exemplifica como emitir uma nota fiscal eletrônica de produto que tem como item (produto) um combustível.


{
            "id": "201804",
            "ambienteEmissao": "Homologacao",
            "naturezaOperacao": "VENDA MERC.ADQ.REC.TERC",
            "tipoOperacao": "Saida",
            "finalidade": "Normal",
            "consumidorFinal": true,
            "indicadorPresencaConsumidor": "NaoSeAplica",
       
            "cliente": {
                "tipoPessoa": "F",
                "indicadorContribuinteICMS": "NaoContribuinte",
       
                "nome": "Jonathan Souza",
                "email": "[email protected]",
                "telefone": "31987897898",
                "cpfCnpj": "10330557270",
       
                "endereco": {
                    "uf": "MG",
                    "cidade": "Belo Horizonte",
                    "logradouro": "Rua 01",
                    "numero": "112",
                    "complemento": "AP 402",
                    "bairro": "Savassi",
                    "cep": "32323111"
                }
            },
            "enviarPorEmail": true,
            "itens": [
                {
                    "cfop": "5656",
                    "codigo": "2217",
                    "descricao": "OLEO 5W40 6100 FLEXMAX",
                    "ncm": "27101932",
                    "quantidade": 4.00,
                    "unidadeMedida": "LT",
                    "valorUnitario": 40.00,
                    "frete": 0.00,
                    "outrasDespesas": 0.00,
       
                    "combustivel": {
                        "codigoProdutoANP": "620505001",
                        "percentualGasNatural": null,
                        "codif": null,
                        "quantidadeFaturadaTempAmbiente": 4.0000,
                        "ufConsumo": "PR",
                       
                        "cide": {
                            "quantidadeBaseCalculo": 4.000,
                            "valorAliquota": 0.0000,
                            "valor": 160.00
                        }
                    },
       
                    "impostos": {
                        "percentualAproximadoTributos": {
                            "simplificado": {
                                "percentual": 31.45
                            },
                            "fonte": "IBPT"
                        },
                        "icms": {
                            "situacaoTributaria": "40",
                            "origem": 0
                        },
                        "pis": {
                            "situacaoTributaria": "99"
                        },
                        "cofins": {
                            "situacaoTributaria": "99"
                        }
                    }
                }
            ],
            "informacoesAdicionais": "Documento emitido por ME ou EPP optante pelo Simples Nacional. Não gera direito a crédito fiscal de IPI."
        }


Exemplo #9 - Nota fiscal de importação


Esse JSON exemplifica como emitir uma nota fiscal eletrônica de produto de importação.


{
            "id": "201802",
            "ambienteEmissao": "Homologacao",
            "naturezaOperacao": "Compra para Comercializacao",
            "tipoOperacao": "Entrada",
            "finalidade": "Normal",
            "consumidorFinal": true,
            "indicadorPresencaConsumidor": "NaoSeAplica",
       
            "cliente": {
                "tipoPessoa": "F",
                "indicadorContribuinteICMS": "NaoContribuinte",
       
                "nome": "UNIVERGOMMA S.P.A.",
                "telefone": "3957173751",
                "cpfCnpj": null,
       
                "endereco": {
                    "pais": "Itália",
                    "logradouro": "VIA PISANA",
                    "numero": "541/g",
                    "complemento": null,
                    "bairro": "TOSCANA",
                    "cep": null
                }
            },
            "enviarPorEmail": true,
            "itens": [
                {
                    "cfop": "3102",
                    "codigo": "0101218",
                    "descricao": "PNEU 205/60R15 TL 95H OUTRUN M2 MOMO",
                    "ncm": "49019900",
                    "quantidade": 120,
                    "unidadeMedida": "PC",
                    "valorUnitario": 82.73,
                    "frete": 994.63,
                    "outrasDespesas": 109.35,
       
                    "declaracaoImportacao": {
                        "numero": "1613211505",
                        "data": "2016-08-25T03:00:00Z",
                        "localDesembaraco": "TZQ COTEINERES",
                        "ufDesembaraco": "RJ",
                        "dataDesembaraco": "2016-08-25T03:00:00Z",
                        "tipoViaTransporte": "Maritima",
                        "valorAFRMM": 0.00,
                        "tipoIntermedio": "ImportacaoPorContaPropria",
                        "cnpj": "03114949000887",
                        "ufTerceiro": "PR",
                        "codigoExportador": "324",
                        "adicoes": [
                            {
                                "numero": 1,
                                "codigoFabricante": "324",
                                "numeroDrawback": "000",
                                "descontos":  null
                            }
                        ]
                    },
       
                    "impostos": {
                        "percentualAproximadoTributos": {
                            "simplificado": {
                                "percentual": 31.45
                            },
                            "fonte": "IBPT"
                        },
       
                        "icms": {
                            "situacaoTributaria": "50",
                            "origem": 0
                        },
                        "pis": {
                            "situacaoTributaria": "08"
                        },
                        "cofins": {
                            "situacaoTributaria": "08"
                        },
                        "ipi": {
                            "situacaoTributaria": "00",
                            "porAliquota": {
                                "aliquota": 15.00
                            }
                        },
                        "ii": {
                            "despesasAduaneiras": 0.00,
                            "valor": 1761.50,
                            "iof": 0.00
                        }
                    }
                }
            ],
            "informacoesAdicionais": "Documento emitido por ME ou EPP optante pelo Simples Nacional. Não gera direito a crédito fiscal de IPI."
        }