Ir al contenido
Cotizaciones

FISCALISTO / API / REFERENCIA

Listar cotizaciones

Abrir en ChatGPTAbrir en Claude
GET
/v1/quotes

Las más recientes primero, cada una en su última versión.

Autorización

bearerAuth
headerAutorizaciónBearer <llave>

Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.

Parámetros de consulta

limit?integer

Cuántos por página, de 1 a 100. Por omisión 10.

Rango1 <= value <= 100
Por omisión10
starting_after?string

El id del último de la página anterior, para la siguiente.

issuer?string

El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo.

status?string

Solo las que estén en este estado.

Uno de"draft""sent""viewed""accepted""rejected""expired""invoiced"

Cuerpo de la respuesta

Correcto.

application/json
  1. response
object*string

Qué tipo de objeto es («invoice», «customer»…).

data*array<>

Los objetos de esta página.

has_more*boolean

true si hay más: pida la siguiente con starting_after igual al id del último.

url*string

La ruta de esta lista.

curl -X GET 'https://api.fiscalisto.com/v1/quotes' \  -H 'Authorization: Bearer fk_test_…'
{  "object": "list",  "data": [    {      "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"    }  ],  "has_more": false,  "url": "/v1/quotes"}

Timbrar ahora la que toca POST

Timbra el periodo que ya toca (next_invoice_on es hoy o antes) sin esperar su hora. Si no toca aún, 409 recurring_not_due. Si la hora llega mientras tanto, no se timbra dos veces: es el mismo periodo.

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.