Emitir NF-e

Todos los parámetros tributarios son opcionales (nullable); las solicitudes que solo llevan códigos tributarios siguen funcionando. Cada parámetro se resuelve como valor de la solicitud > perfil de la empresa > tabla de alícuotas de la plataforma (empresas CRT=3) > rechazo nombrando la ruta del campo (itens[n].impostos..., n desde 1). Los porcentajes se escriben como 18 para 18 %; los importes en BRL. La plataforma nunca infiere una reducción de base, un MVA de ST, un porcentaje de diferimiento ni un importe de tributo por unidad: envíelos siempre que el código tributario los exija.

Reglas estrictas (aplicadas por el motor tributario, devueltas como 10005000):

• los vendedores CRT 1/4 deben usar CSOSN de 3 dígitos y los vendedores CRT 2/3 CST de 2 dígitos; la discrepancia se rechaza en la aceptación con 10004046;
• los compradores no contribuyentes (personas físicas / sin IE) no pueden usar CSOSN 101, la familia de ST retenida ni percentualCreditoSimples; se rechaza en la aceptación con 10004047; los vendedores MEI (CRT 4) no pueden usar 101;
• los códigos de ST (10/30/70, 201/202/203) se rechazan para compradores no contribuyentes (SEFAZ cStat 600): la ST anticipa la cadena de reventa y el consumidor es su final. Las ventas B2C de mercancías con ST usan CST 60 / CSOSN 500 (retenida anteriormente) y, entre estados, DIFAL;
• código de beneficio estatal (cBenef): CST 20/30/40/41/50/51/70/90 deben llevar codigoBeneficioFiscal; su ausencia se rechaza en el envío con 10004020. La SEFAZ-SP valida el mismo conjunto con 930 (CST 90 sin código también se rechaza) y rechaza el literal SEM CBENEF con 946;
• los códigos que no son de ST no deben llevar substituicaoTributaria (10004044);
• los ítems con códigos de ST (10/30/60/70, 201/202/203/500) deben llevar cest; un CEST ausente se rechaza en la aceptación con 10004043 (itens[n].cest);
• CST 90 / CSOSN 900 son compuestos: envíe al menos uno de los grupos de tributación propia, ST o crédito.

cliente.inscricaoEstadual es la inscripción estatal del comprador (NF-e dest/IE). Obligatoria para compradores CNPJ: define indIEDest=1; un comprador CNPJ sin ella se rechaza con 10004034 antes de consumir numeración (la SEFAZ rechazaría con 232 después de la numeración). No permitida para compradores CPF (10004031). Se eliminan los caracteres de formato. Ejemplo: "123.456.789.012".

El escenario B2B (comprador contribuyente de ICMS) depende de este campo: CSOSN 101 / 201 y CST 10 / 30 / 70 solo son válidos para compradores contribuyentes.

Reglas: línea de devolución sin referencia → 10004021; referencia en una factura que no es de devolución → 10004022; factura original no encontrada o no perteneciente a esta empresa → 10004023; factura original no autorizada → 10004024; ítem no encontrado en la original → 10004025; cantidad superior a la línea original (sumada entre las líneas que referencian el mismo ítem original) → 10004026. Use CFOP de entrada (1xxx / 2xxx) y códigos de PIS/COFINS de entrada (50–75 / 98, aliquota obligatoria); los parámetros tributarios de la factura original se reflejan por línea.

{
  "id": "DEV-000014553",
  "ambienteEmissao": "Producao",
  "finalidade": "Devolucao",
  "notaReferenciada": { "chaveAcesso": "35241204893402000113650010000117691017244265" },
  "pedido": { "presencaConsumidor": "OperacaoPelaInternet", "pagamento": { "formas": [ { "tipo": "SemPagamento", "valor": 0 } ] } },
  "cliente": { "tipoPessoa": "F", "nome": "Demo Client", "cpfCnpj": "88533234775", "endereco": { "uf": "PR", "cidade": "4106902", "logradouro": "Rua Presidente Wilson", "numero": "911", "bairro": "Uberaba", "cep": "81570440" } },
  "itens": [
    {
      "cfop": "2202", "codigo": "000068", "descricao": "Pendrive Kingston 16GB", "ncm": "85235190",
      "quantidade": 1, "unidadeMedida": "UN", "valorUnitario": 28.47,
      "notaReferenciada": { "numeroItem": 1 },
      "impostos": {
        "icms": { "situacaoTributaria": "102" },
        "pis": { "situacaoTributaria": "70", "aliquota": 0 },
        "cofins": { "situacaoTributaria": "70", "aliquota": 0 }
      }
    }
  ]
}

Opcionales; combustibles, energía, operaciones interestatales específicas y las sobrescrituras de IBS/CBS de 2026.

Las reglas de pareamiento, los códigos aplicables y las exigencias ad rem por CST de estos grupos las valida el motor tributario, que devuelve 10005000 con el nombre interno del campo.