FISCALISTO / API / REFERENCIA
Ver una cotización
Su última versión.
bearerAuthAutorizaciónBearer <llave>Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.
id*stringEl id del objeto.
Correcto.
application/json- response
Una cotización: su cliente la ve en una liga, la acepta, pide cambios o la rechaza, y se factura.
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_…).
number*stringSu serie y folio, como lo ve el cliente (COT-12).
version*integerCambiar una ya enviada hace una versión nueva con el mismo número; el id contesta siempre la última.
-9007199254740991 <= value <= 9007199254740991status*stringdraft, sent, viewed (el cliente abrió la liga), accepted, rejected, expired (pasó valid_until) o invoiced.
"draft""sent""viewed""accepted""rejected""expired""invoiced"url*|La liga donde el cliente la ve, descarga su PDF, la acepta, pide cambios o la rechaza; null mientras sea borrador.
customer*A quién va: tax_id null si aún no tiene sus datos fiscales; catalog_id es su cliente (cus_…) en su catálogo, o null.
currency*stringLa moneda.
items*array<>Los conceptos, como los de una factura.
total*|El total con impuestos.
valid_until*stringSu último día de validez (AAAA-MM-DD).
terms*|Las condiciones impresas: entrega, anticipo, garantía…
notes*|Las notas, como las de una factura.
auto_invoice*booleanSi al aceptarla se timbra la factura sola.
customer_comment*|Lo que escribió el cliente al pedir cambios o al rechazarla, o null.
sent_at*|Cuándo se envió.
viewed_at*|Cuándo el cliente abrió la liga por primera vez.
decided_at*|Cuándo se aceptó o rechazó.
decided_by*|customer (en su liga) o user (usted, con POST /v1/quotes/{id}/accept o desde la app).
invoice*|La factura (inv_…) que se timbró de ella, o null.
created_at*|Cuándo se creó.
curl -X GET 'https://api.fiscalisto.com/v1/quotes/string' \ -H 'Authorization: Bearer fk_test_…'{ "id": "quo_OufpKqnrvx9p3Kd8wQm2XyT5uBcW8sKdLx", "object": "quote", "livemode": false, "issuer": "iss_OufpKqnrvx9p", "number": "COT-12", "version": 1, "status": "sent", "url": "https://fiscalisto.com/cotizacion/7Hq2mZr1XyT5uBcW8sKdLx0VeNOufpKq", "customer": { "tax_id": "ICV060329BY0", "name": "INMOBILIARIA CVA", "email": "compras@cva.example", "catalog_id": "cus_OufpKqnrvx9p42" }, "currency": "MXN", "items": [ { "description": "Desarrollo del sitio web", "product_key": "81112103", "quantity": 1, "unit_key": "E48", "unit_price": 45000 } ], "total": 52200, "valid_until": "2026-11-09", "terms": "50% de anticipo, entrega en 4 semanas.", "notes": null, "auto_invoice": true, "customer_comment": null, "sent_at": "2026-10-25T10:12:00-06:00", "viewed_at": null, "decided_at": null, "decided_by": null, "invoice": null, "created_at": "2026-10-25T10:05:00-06:00"}Crear una cotización POST
Una cotización en borrador, con los conceptos y las condiciones de pago de una factura (se revisan con las mismas reglas, así que siempre se puede facturar). customer es un cliente de su catálogo, uno con sus datos fiscales (se agrega a sus clientes) o solo name y email si aún no los tiene. Se manda con POST /v1/quotes/{id}/send.
Cambiar una cotización POST
Solo lo que mande cambia. Un borrador cambia ahí mismo; una que ya se envió se vuelve una versión nueva en borrador (mismo número, version + 1) que el cliente ve al mandarla; mientras, su liga muestra la anterior. Una aceptada, rechazada o facturada ya no cambia.