[Melhoria] Vendas: Novos Campos de Venda Combustível e Impostos Monofásicos na Integração de Cupom Fiscal via API

Agora no Bluesoft ERP, é possível receber e persistir dados técnicos detalhados de itens de combustíveis e tributação monofásica de ICMS diretamente através da API de cupons fiscais.

Como Irá Funcionar a Partir de Agora?

Agora, o endpoint POST /api/fiscal/cupomfiscal/lote foi atualizado para aceitar dois novos objetos dentro da estrutura de itens:

• detalhamentoCombustivel: Recebe os dados técnicos do combustível exigidos pela ANP, preenchendo o grupo <comb> da nota. Inclui campos como codigoAnp, descricaoAnp, ufConsumo, percentualGlp, percentualGNNacional, percentualGNImportado, quantidadeTempAmbiente, valorPartida, percentualBioDiesel e origemCombustivel.
• impostoMonofasico: Recebe os dados de tributação monofásica para itens com CST 061, preenchendo o grupo <ICMS61>. Inclui os campos quantidadeBCMonoRetido, aliquotaAdRemRetido e valorIcmsMonoRetido.

Exemplo de JSON:

{
            "data": "11/05/2026 15:23:00",
            "ecf": 1,
            "numeroDoCupom": 22347,
            "codigoDoOperador": 23,
            "valorTotal": 328.68,
            "valorDesconto": 0,
            "valorAcrescimo": 0,
            "cancelado": false,
            "valorTroco": 0,
            "coo": 22347,
            "chave": "352605677506790001075900000000022347544956",
            "serie": 0,
            "dataAutorizacao": "11/05/2026 15:23:00",
            "sat": true,
            "tipo": "VENDA",
            "itens": [
                {
                    "valorTotal": 149.4,
                    "codigoDeBarras": 1009,
                    "quantidadeTotal": 5,
                    "codigoIcms": "T00.61",
                    "cancelado": false,
                    "sequenciaDoItem": 1,
                    "descontoPackVirtual": 0,
                    "codigoPedidoVenda": 0,
                    "impostoNFCe": null,
                    "icms": {
                        "aliquota": 0,
                        "reducao": 0,
                        "codigoOrigem": 0,
                        "codigoTributacao": 60,
                        "percentualDiferido": 0,
                        "baseCalculo": 149.4,
                        "valor": 0
                    },
                    "pis": null,
                    "cofins": null
                },
                {
                    "valorTotal": 179.28,
                    "codigoDeBarras": 1001,
                    "quantidadeTotal": 6,
                    "codigoIcms": "T00.60",
                    "cancelado": false,
                    "sequenciaDoItem": 2,
                    "descontoPackVirtual": 0,
                    "codigoPedidoVenda": 0,
                    "impostoNFCe": null,
                    "combustivel": {
                        "tanque": 1,
                        "bico": 2,
                        "numeroDoAbastecimento": 0,
                        "numeroDaSequenciaDoAbastecimento": 0,
                        "placa": "string",
                        "quilometragem": 0
                    },
                    "detalhamentoCombustivel": {
                        "codigoAnp": "0123",
                        "descricaoAnp": "TESTE",
                        "ufConsumo": "SP",
                        "percentualGlp": 0.2534,
                        "percentualGNNacional": 0.1234,
                        "percentualGNImportado": 0.1234,
                        "codigoSideCodif": 12,
                        "quantidadeTempAmbiente": 40,
                        "valorPartida": 0.2,
                        "percentualBioDiesel": 0.1233,
                        "origemCombustivel": "BM"
                    },
                    "impostoMonofasico": {
                        "quantidadeBCMonoRetido": 0.2133,
                        "aliquotaAdRemRetido": 0.1233,
                        "valorIcmsMonoRetido": 0.1233
                    },
                    "icms": {
                        "aliquota": 0,
                        "reducao": 0,
                        "codigoOrigem": 0,
                        "codigoTributacao": 60,
                        "percentualDiferido": 0,
                        "baseCalculo": 179.28,
                        "valor": 0
                    },
                    "pis": null,
                    "cofins": null
                }
            ],
            "finalizadoras": [
                {
                    "finalizadora": "011",
                    "valorTroco": 0,
                    "valor": 328.68,
                    "cpfCnpj": 77777777777,
                    "codigoConvenio": 0,
                    "cpfCnpjConveniado": 0,
                    "valorAcrescimoFinalizadora": 0,
                    "taxaServico": 0,
                    "nsu": 0,
                    "tipoTef": 1,
                    "tefBin": 0,
                    "tefBandeira": 0,
                    "tefParcelas": 0,
                    "tefTipoCartao": "CARTAO_CREDITO",
                    "trocoCheque": null,
                    "valorTrocoServico": 0
                }
            ],
            "cpfCnpj": 77777777777,
            "tipoModeloDocumento": 59,
            "tipoModelo": "SAT",
            "falha": false
        }

Observações / Validações

• Dados Históricos: O novo comportamento aplica-se apenas a cupons integrados após a implementação desta melhoria; dados antigos não serão atualizados retroativamente.

Para conhecer mais sobre como é a utilização dessa ferramenta, clique aqui.

Para saber mais sobre a utilização das APIs do ERP, clique aqui.