Productos
FISCALISTO / API / REFERENCIA
FISCALISTO / API / REFERENCIA
Cambia solo los campos que manda. Las facturas ya timbradas no cambian.
bearerAuthAutorizaciónBearer <llave>Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.
id*stringEl id del objeto.
Idempotency-Key?stringOpcional (los SDK la mandan solos). Si la respuesta se pierde, repita la solicitud con el mismo valor durante 24 horas: contesta lo mismo, con idempotent-replayed: true, y no lo hace dos veces (ni crea, ni manda correos, ni cobra).
1 <= length <= 255application/jsonname?|Nombre corto para encontrarlo, solo para usted; en el CFDI va description.
description?stringDescripción.
1 <= length <= 1000product_key?stringClave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=…
^\d{8}$unit_key?stringClave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio (por omisión), H87 pieza, ACT actividad…
1 <= length <= 5unit_name?|Nombre de la unidad (Unidad), hasta 20 caracteres.
sku?|Número de identificación o SKU (NoIdentificacion).
unit_price?numberPrecio unitario antes de impuestos (ValorUnitario).
0 <= value <= 1000000000000open_price?booleanPrecio abierto: sin precio fijo (una noche de hotel que cambia cada día); cada factura manda su unit_price.
taxability?stringObjeto de impuesto (ObjetoImp), c_ObjetoImp: 01 no objeto, 02 sí objeto (por omisión), 03 sin desglose, 04 no causa…
"01""02""03""04""05""06""07""08"iva?stringTasa de IVA trasladado: 0.16 (por omisión), 0.08 (región fronteriza), 0 o exento.
"0""0.16""0.08""exento"ieps?|IEPS trasladado: tasa (0.265…) o cuota en pesos por unidad, según ieps_factor.
ieps_factor?stringTasa o Cuota (TipoFactor del IEPS).
"Tasa""Cuota"iva_retention?numberTasa de IVA retenido (por ejemplo 0.106667, dos terceras partes del 16%).
0 <= value <= 0.16isr_retention?numberTasa de ISR retenido (por ejemplo 0.10 honorarios, 0.0125 RESICO).
0 <= value <= 0.35local_taxes?array<>Impuestos locales que lleva, como el ISH 3% de hospedaje: van en cada factura con él, sobre sus conceptos.
items <= 20track_stock?booleanLleva existencias (Inventario): cada factura que lo vende las saca del almacén de su sucursal, y una cancelada las regresa. Ver GET /v1/products/{id}/stock.
cost?|Su costo por unidad en pesos sin IVA, hasta que sus compras den otro: vale las existencias que entran sin unit_cost.
barcode?|Código de barras (EAN, UPC o el suyo). Una factura cuyo concepto lo trae como NoIdentificacion saca existencias de este producto.
min_stock?|Existencia mínima: por debajo, el aviso de existencias bajas lo incluye.
Correcto.
application/jsonUn producto o servicio del catálogo de un emisor.
id*stringIdentificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_).
livemode*booleantrue en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.
object*stringQué tipo de objeto es («invoice», «customer»…).
issuer*stringEl emisor (iss_…).
name*|Nombre corto para encontrarlo, solo para usted.
description*stringDescripción que va en el CFDI (Descripcion).
product_key*stringClave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=…
unit_key*stringClave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio (por omisión), H87 pieza, ACT actividad…
unit_name*|Nombre de la unidad (Unidad), hasta 20 caracteres.
sku*|Número de identificación o SKU (NoIdentificacion).
unit_price*numberPrecio unitario antes de impuestos (ValorUnitario).
open_price*booleanPrecio abierto: el producto no tiene precio fijo y cada concepto con él manda su unit_price.
taxability*stringObjeto de impuesto (ObjetoImp), c_ObjetoImp: 01 no objeto, 02 sí objeto (por omisión), 03 sin desglose, 04 no causa…
iva*stringTasa de IVA trasladado: 0.16 (por omisión), 0.08 (región fronteriza), 0 o exento.
ieps*|IEPS trasladado: tasa (0.265…) o cuota en pesos por unidad, según ieps_factor.
ieps_factor*|Tasa o Cuota (TipoFactor del IEPS).
iva_retention*numberTasa de IVA retenido (por ejemplo 0.106667, dos terceras partes del 16%).
isr_retention*numberTasa de ISR retenido (por ejemplo 0.10 honorarios, 0.0125 RESICO).
local_taxes*array<>Impuestos locales (complemento implocal): traslados y retenciones estatales.
track_stock*booleantrue si lleva existencias (Inventario).
cost*|Su costo por unidad en pesos sin IVA, o null.
barcode*|Su código de barras, o null.
min_stock*|Su existencia mínima, o null.
created_at*stringCuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00).
date-timeupdated_at*|Cuándo cambió por última vez, ISO 8601 (-06:00).
curl -X POST 'https://api.fiscalisto.com/v1/products/string' \ -H 'Authorization: Bearer fk_test_…' \ -H 'Idempotency-Key: 8f14e45f-ceea-467a-9575-6a1b0e5f3c21' \ -H 'Content-Type: application/json' \ -d '{ "unit_price": 2600}'{ "id": "prd_OufpKqnrvx9p1", "object": "product", "livemode": false, "issuer": "iss_OufpKqnrvx9p", "name": null, "description": "Mensualidad", "product_key": "86121700", "unit_key": "E48", "unit_name": "Unidad de servicio", "sku": "MEN-1", "unit_price": 2500, "open_price": false, "taxability": "02", "iva": "0.16", "ieps": null, "ieps_factor": null, "iva_retention": 0, "isr_retention": 0, "local_taxes": [], "track_stock": false, "cost": null, "barcode": null, "min_stock": null, "created_at": "2026-10-20T09:02:11-06:00", "updated_at": "2026-10-24T10:15:42-06:00"}