TF Fiscal
Documentación

Clases de impuesto

Crear clase de impuesto

Guarda los impuestos de ítem por escenario; la plataforma genera el código que las líneas de la NF-e o de la NFC-e pasan a referenciar.

POST/openapi/v2/empresas/{empresaId}/classes-imposto
Requiere las cabeceras de firma token, timestamp y sign, vea Autenticación.

La clase pertenece a la empresa de la ruta. No envíe codigo: la plataforma genera el código (TF y 10 dígitos) y lo devuelve en la respuesta; guárdelo para la emisión y los demás endpoints. Cada grupo es una lista de filas, una por escenario; en la emisión la plataforma elige la fila que sirve para la factura. Escenarios, elección de fila y sobrescritura están en Clases de impuesto.

Parámetros de ruta

empresaId*
stringIdentificador de la empresa

* Campo obligatorio

Cuerpo de la petición

tipo*
stringTipo de la clase
descricao
stringNombre de la clase
*
icms e issqn suman al menos 1 fila
arrayFilas de ICMS
arrayFilas de IPI
*
al menos 1 fila
arrayFilas de PIS
*
al menos 1 fila
arrayFilas de COFINS
*
icms e issqn suman al menos 1 fila
arrayFilas de ISSQN
arrayFilas de IBS y CBS
arrayICMS por estado de destino

* Campo obligatorio

200
Clase creada, versión 1.
codigo
stringCódigo de la clase
tipo
stringTipo de la clase
descricao
stringNombre de la clase
situacao
stringSituación de la clase
arrayMotivos de la incompatibilidad
versao
intVersión
icms
arrayFilas del grupo
ipi
arrayFilas del grupo
pis
arrayFilas del grupo
cofins
arrayFilas del grupo
issqn
arrayFilas del grupo
ibsCbs
arrayFilas del grupo
icmsPorEstado
arrayICMS por estado de destino
dataCriacao
stringFecha de creación
dataUltimaAlteracao
stringÚltima modificación

Cada fila se valida con las reglas del grupo correspondiente de la emisión, más las reglas de la clase:

ValidaciónError
codigo en el cuerpo: el código lo genera la plataforma10005208
Campo desconocido en cualquier nivel; el mensaje señala la ruta, como icms[0].aliquotaX10005210
Número o booleano enviado como texto, como "aliquota": "18"10005213
Obligatorios, formato, rango, Padrao en el ICMS, pis / cofins con al menos 1 fila, icms e issqn sumando al menos 1 fila, como máximo 50 filas por grupo10001001
Misma combinación de cenario, tipoPessoa y naoContribuinte repetida en el grupo10005211
Primer dígito del cfop distinto del escenario; la fila Padrao de ISSQN no se verifica10005212
Fila de ISSQN con cfop distinto de 5933, incluso Padrao; fila de ICMS con 593310005214
tipo distinto del actual en la actualización10005216
Grupo que el tipo no admite: issqn en NFe, ipi en NFCe10005218
Clase NFCe con escenario fuera de SaidaDentroEstado / Padrao10005219
Clase NFCe con un campo que la emisión de NFC-e no tiene, como icms[0].difal10005217
Fila de ICMS con naoContribuinte = true o tipoPessoa = Fisica usando CST / CSOSN 10, 30, 70, 101, 201, 202, 203 o percentualCreditoSimples10004047
PIS / COFINS 01 con aliquota distinta de la alícuota legal del régimen de PIS/COFINS configurado en la empresa10005008
CST o CSOSN según el CRT de la empresa: CRT 1 / 4 solo CSOSN, CRT 2 / 3 solo CST10004046
Código de tributación existente (ICMS, PIS, COFINS, IPI, IBS/CBS)10005203
Clasificación IBS/CBS perteneciente al CST10005204
Campos que el código exige; percentualCreditoSimples en los CSOSN 101 / 201 puede venir del registro de la empresa10004043
Campos que no se aplican al código10004044

Quedan para la emisión: CEST en los códigos con ST y todos los cálculos del motor de impuestos. Los números se guardan y devuelven como se envían: 18.00 vuelve 18.00.